Agentic AI Atlasby a5c.ai
OverviewWikiGraphFor AgentsEdgesSearchWorkspace
/
GitHubDocsDiscord
iiRecord
Agentic AI Atlas · Process Authoring Updates
page:docs-adapters-babysitter-integrations-process-authoringa5c.ai
Search record views/
Record · tabs

Available views

II.Record viewspp. 1 - 1
overviewarticlejsongraph
III.Related pagespp. 1 - 1
II.
Page reference

page:docs-adapters-babysitter-integrations-process-authoring

Reading · 3 min

Process Authoring Updates reference

Update process creation prompts, templates, and validation to expose external agent capabilities when adapters is detected. The LLM authoring the process should know what agents are available and how to use them.

Pagewiki/docs/adapters-babysitter-integrations/process-authoring.mdOutgoing · 0Incoming · 1

Process Authoring Updates

Summary

Update process creation prompts, templates, and validation to expose external agent capabilities when adapters is detected. The LLM authoring the process should know what agents are available and how to use them.

Prompt Context Injection

Where: `packages/genty/platform/src/harness/internal/createRun/planProcess/phase.ts`

When discoverExternalAgents() returns agents, inject into the plan process prompt:

typescript
// After line 93 (workspaceAssessment):
const externalAgents = await discoverExternalAgents({ timeout: 5000 });

// Build agent availability section for prompt:
if (externalAgents.available && externalAgents.agents.some(a => a.installed)) {
  const agentList = externalAgents.agents
    .filter(a => a.installed)
    .map(a => `- ${a.name} (${a.authenticated ? 'authenticated' : 'not authenticated'})`)
    .join('\n');

  promptContext.externalAgentsSection = [
    '',
    'Available external agents (via adapters):',
    agentList,
    '',
    'You may delegate specialist work to these agents using external agent tasks:',
    '  defineTask("task-id", (args) => ({',
    '    kind: "agent",',
    '    agent: {',
    '      name: "Task Name",',
    '      prompt: "Instructions for the external agent...",',
    '      responderType: "agent",',
    '      adapter: "claude-code",  // or codex, gemini-cli, etc.',
    '    },',
    '  }))',
    '',
    'Use external agents when:',
    '- The task requires file editing, bash execution, or browser access (agent-core cannot do these)',
    '- A specific agent has better capabilities for the task (e.g., codex for code generation)',
    '- The task benefits from a separate workspace or conversation context',
    '',
    'Use internal agent tasks when:',
    '- The task is purely text generation (summarization, analysis, planning)',
    '- Low latency is important (internal is faster than spawning external agents)',
  ].join('\n');
}

Raw Text Session Template (genty path)

In the isRawTextSession branch, append external agent info to the system prompt when available:

typescript
if (externalAgents.available && externalAgents.agents.some(a => a.installed)) {
  processDefinitionSystemPrompt += '\n\n' + promptContext.externalAgentsSection;
}

Validation Updates

`packages/genty/platform/src/harness/internal/createRun/planProcess/validationSource.ts`

Current validation checks for kind: "agent" with agent: { ... } shape. Extend it to accept agent.responderType: "agent" routing metadata:

typescript
// In getDefineTaskKindShapeMismatches():
// Accept agent tasks with responderType routing metadata
if (kind === "agent" && properties.has("agent")) {
  // Valid — both internal and external agent tasks have agent property
  continue;
}

`packages/genty/platform/src/harness/internal/createRun/planProcess/validation.ts`

In validateProcessExport(), don't reject processes that reference external agents even if adapters is not installed at validation time (it may be available at execution time):

typescript
// After existing validation:
// Warn (don't error) about external agent tasks when adapters not detected
if (hasExternalAgentTasks(source) && !externalAgentsAvailable) {
  console.warn('[babysitter] process uses external agent tasks but adapters is not detected');
}

Conformance Repair Prompt

Update packages/genty/platform/src/harness/internal/createRun/planProcess/phase.ts conformance repair prompt to include external agent task format:

Code
- External agent tasks must use kind: "agent" with agent: { responderType: "agent", adapter: "..." }
- The adapter field must be a valid adapters adapter name

Files to Modify

FileChange
packages/genty/platform/src/harness/internal/createRun/planProcess/phase.tsInject external agents into prompt context
packages/genty/platform/src/harness/internal/createRun/planProcess/prompts.tsAdd externalAgentsSection to prompt builder
packages/genty/platform/src/harness/internal/createRun/planProcess/validation.tsAccept external agent tasks
packages/genty/platform/src/harness/internal/createRun/planProcess/validationSource.tsUpdate kind shape matching
packages/babysitter-sdk/src/harness/externalAgentDiscovery.tsNew — discovery API

Documentation Updates

FileChange
docs/agent-reference/process-authoring.mdAdd external agent task section
docs/agent-reference/command-surfaces.mdDocument external agent dispatch
docs/plugins.mdNote adapters integration

Article source

The article body is owned directly by this record.

Related pages

No related wiki pages for this record.

Shortcuts

Open overview
Open JSON
Open graph