DROPGoogle launches Gemini 3.8 Flash TTS and Flash-Lite TTS///DROPGemini Omni brings 1080p generation to Google Vids///BREAKClaude Opus 5.5 is here: 1M context, $4 input / $20 output///BREAKOpenAI adds GPT-6 Sol and Luna to the GPT-6 family///PAPEROpus 5.5's system card documents gains—and evaluation limits///BREAKGrok 4.7 launches at $2 input / $6 output per million tokens///DROPGrok Voice Transcribe 2.0 targets difficult real-world audio///TRENDGoogle steers new Gemini API projects to 3.8 Flash or 3.5 Flash-Lite///DROPGoogle launches Gemini 3.8 Flash TTS and Flash-Lite TTS///DROPGemini Omni brings 1080p generation to Google Vids///BREAKClaude Opus 5.5 is here: 1M context, $4 input / $20 output///BREAKOpenAI adds GPT-6 Sol and Luna to the GPT-6 family///PAPEROpus 5.5's system card documents gains—and evaluation limits///BREAKGrok 4.7 launches at $2 input / $6 output per million tokens///DROPGrok Voice Transcribe 2.0 targets difficult real-world audio///TRENDGoogle steers new Gemini API projects to 3.8 Flash or 3.5 Flash-Lite///
DARC.DEV
All guides
GuideLevel · Start#Agents#TypeScript#Tutorial

Build your first agent around a small, inspectable loop

Plan, act, observe, stop. Use current model APIs without surrendering budgets, logs or human approval.

DCDariusz Czechowicz23 Sept 20263 min readPractical guide
28
Guide
Source-checked Sources & corrections
2 practical sections · checklist · sources

Practical guide. Provider claims are attributed to the sources below. This page does not claim a new independent DARC benchmark.

For: Curious readers and builders getting oriented

⚡ TL;DR — the 30-second version

  • Bound the task, tools, budget and stop condition.
  • Validate current API behavior before choosing a framework.
  • Require human approval for consequential write actions.

A useful first agent needs a bounded task, a small set of tools, a way to inspect tool results and a reliable stop condition. Before selecting a framework, write down the allowed actions, maximum spend and definition of success.

Use exact, supported model IDs from current documentation. For GPT-6, review Responses API tool support and reasoning constraints. For Opus 5.5, review always-on thinking and preserved-context requirements. Google's Antigravity and OpenAI's Agents API offer managed approaches, but they do not change your application's permissions.

“Start with one agent you can explain. Add orchestration only after you understand its failure modes.”
— Editorial interpretation

Give every tool a narrow schema. Treat tool output as untrusted data; an external page must not be allowed to expand the agent's permissions. Separate read operations from write operations, and put approval gates before sends, deletes, payments or production changes.

Log the request, action, observation and cost of every turn, with secrets redacted. A fixed evaluation set makes prompt and model changes reviewable. Stop on repeated failures or budget exhaustion instead of allowing an infinite retry loop.

Field guide / 01

The loop needs explicit exit states

Represent success, budget exhaustion, denied permission, recoverable error and human review as distinct outcomes. A generic 'done' message hides important differences. Give every tool a timeout and every retry a finite limit.

Keep the first agent read-only. It can gather evidence and propose an action without possessing the credentials to execute that action. Add writes only after you can explain every state transition.

pseudocode
while within_budget and not terminal:
  proposal = ask_model(context, allowed_tools)
  validate_structure(proposal)
  authorize(proposal, current_user)
  if approval_needed: pause_with_exact_action()
  observation = execute_with_timeout(proposal)
  append_redacted_trace(observation)
  update_budget_and_stop_state()
Architecture sketch, not a provider SDK. Authorization remains application code.

Field guide / 02

Five tests before adding a second agent

Test a straightforward success, missing source material, a tool timeout, an unauthorized action and budget exhaustion. Verify both the output and the trace. A correct final answer that used an unauthorized tool is still a failed run.

Add another agent only when role separation or parallelism solves a measured problem. Every additional agent introduces more context transfer, cost accounting and failure recovery.

Before you ship

0/5

Use this as a review aid. Checks reset when you leave this page.

Questions that come up

Do I need a multi-agent framework to begin?

No. A small, inspectable loop is often enough. Add orchestration when you need durable state, parallel work or explicit role boundaries.

Put it into practiceDraft your agent's execution contract

Sources & verification

Last checked 23 Sept 2026. Publication dates and access conditions belong to the linked originals.

  1. 01OpenAI API changelogOpenAI↗
  2. 02Claude Platform release notesAnthropic↗
  3. 03Gemini 3.8 Flash model specificationsGoogle↗
  4. 04LangGraph — orchestration, persistence and human reviewLangChain↗
  5. 05MCP — tools, permissions and validationModel Context Protocol↗
Editorial policy and correction log →
#Agents#TypeScript#Tutorial