@nocobase/app-plugin-agents 0.0.0-stage → 0.1.0-beta.1

package/dist/server/online/cli-command.js

@@ -0,0 +1,345 @@
+/**
+ * The application's CLI inside an online run's shell (`sandbox.ts`): `acme` (or whatever the CLI is called) built from
+ * the same command manifest the real CLI reads, each command one request to its route, sent through the application
+ * itself with the run's token. A route checks the run's identity as it would any request, so what the run may do is
+ * exactly what the CLI would let it do.
+ *
+ * Help works offline from the manifest: `acme --help`, `acme <area> --help`, `acme <command> --help`, and
+ * `acme docs [command]`. A command prints what a person reads by default and the cli-envelope with `--json`, and
+ * exits with the CLI's codes. A line is read by the CLI's own parser (`@nocobase/app-cli-client/parse`), over the
+ * shell: `--<flag>-file` and the body's `--file` read the shell's files, and `--from-env` its exported variables.
+ * Commands that upload, stream or download files are refused: an online run has no files of its own to send.
+ */
+import { EXIT_CODES, readErrorBody, } from '@nocobase/agent-protocol';
+import { apiExitCode, CliParseError, commandWords, helpColumns, needsLocalFiles, parseCommandLine, renderCommandHelp, renderTopicHelp, } from '@nocobase/app-cli-client/parse';
+import { fillRequest, requestText } from '@nocobase/app-cli-client/request';
+import { commandFailureJson, commandSuccessJson, } from '@nocobase/cli-envelope';
+import { defineCommand, } from '../vendor/just-bash.js';
+const words = (id) => id.split(':').join(' ');
+class Failure extends Error {
+    error;
+    exit;
+    constructor(error, exit) {
+        super(error.message);
+        this.error = error;
+        this.exit = exit;
+    }
+}
+const usage = (message, code = 'INVALID_USAGE') => new Failure({ code, message, suggestions: [] }, EXIT_CODES.validation);
+/** The flags every command of the shell takes. */
+const SHELL_FLAGS = [
+    ['--json', 'Print the answer as one JSON document.'],
+];
+function commandList(bin, commands, prefix) {
+    const topic = renderTopicHelp(bin, commands, prefix);
+    if (topic === undefined)
+        return null;
+    return `${topic}\n\nRun \`${bin} <command> --help\` for a command's arguments and flags, \`${bin} docs <command>\` for all it does. Add --json to read an answer as JSON.`;
+}
+function commandHelp(bin, command) {
+    return renderCommandHelp(command, {
+        bin,
+        globalFlags: SHELL_FLAGS,
+        localFiles: false,
+    });
+}
+function commandDocs(bin, command) {
+    const output = command.output.kind === 'list'
+        ? 'A list; `--json` has the items in `result.data` and paging in `result.meta`.'
+        : command.output.kind === 'empty'
+            ? 'Nothing: "Done." on success.'
+            : 'One record; `--json` has it in `result.data`.';
+    return [
+        commandHelp(bin, command),
+        '',
+        'OUTPUT',
+        `  ${output}`,
+        '',
+        'REQUEST',
+        `  ${command.method} ${command.path}`,
+        ...(command.action ? ['', 'ACTION', `  ${command.action}`] : []),
+        ...(needsLocalFiles(command)
+            ? [
+                '',
+                'NOTE',
+                '  It needs a file on your machine, or saves one there: not available in this shell.',
+            ]
+            : []),
+    ].join('\n');
+}
+/** The areas of the manifest, with how many commands each has. */
+function areas(bin, commands) {
+    const counts = new Map();
+    for (const command of commands) {
+        const area = command.id.split(':')[0] ?? command.id;
+        counts.set(area, (counts.get(area) ?? 0) + 1);
+    }
+    return [
+        `\`${bin} docs <command words>\` documents one command; \`${bin} <area> --help\` lists an area's commands.`,
+        '',
+        'AREAS',
+        ...helpColumns([...counts].map(([area, count]) => [area, `${count} command${count === 1 ? '' : 's'}`])),
+    ].join('\n');
+}
+/** The command whose words start `args`, the longest one; and the arguments after them. */
+function resolve(commands, args) {
+    const leading = [];
+    for (const word of args) {
+        if (word.startsWith('-'))
+            break;
+        leading.push(word);
+    }
+    for (let length = leading.length; length > 0; length--) {
+        const id = leading.slice(0, length).join(':');
+        const command = commands.find((candidate) => candidate.id === id);
+        if (command)
+            return { command, rest: args.slice(length) };
+    }
+    return null;
+}
+/** The shell, as the parser reads it: its files, and its exported variables. No files to send, and no one to ask. */
+function shellIo(ctx) {
+    return {
+        readText: async (path) => {
+            try {
+                return await ctx.fs.readFile(ctx.fs.resolvePath(ctx.cwd, path));
+            }
+            catch {
+                return undefined;
+            }
+        },
+        env: (name) => ctx.exportedEnv?.[name],
+    };
+}
+/** Whether the line asks for help: `--help` or `-h` before any `--`. */
+function asksHelp(rest) {
+    for (const word of rest) {
+        if (word === '--')
+            return false;
+        if (word === '--help' || word === '-h')
+            return true;
+    }
+    return false;
+}
+function cell(value) {
+    if (value === null || value === undefined)
+        return '';
+    const text = typeof value === 'string'
+        ? value
+        : typeof value === 'number' || typeof value === 'boolean'
+            ? String(value)
+            : JSON.stringify(value);
+    const line = text.replace(/\s+/gu, ' ').trim();
+    return line.length > 80 ? `${line.slice(0, 79)}…` : line;
+}
+function valueAt(row, column) {
+    let current = row;
+    for (const key of column.split('.')) {
+        if (!current || typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+const isScalar = (value) => value === null || ['string', 'number', 'boolean'].includes(typeof value);
+/** What a person reads of an answer: a list as a table, a record field by field, or its message. */
+function render(command, data, meta) {
+    const message = typeof meta?.message === 'string' ? meta.message : undefined;
+    if (Array.isArray(data)) {
+        const first = data[0];
+        const keys = command.output.columns?.length
+            ? [...command.output.columns]
+            : first && typeof first === 'object'
+                ? Object.entries(first)
+                    .filter(([, value]) => isScalar(value))
+                    .map(([key]) => key)
+                    .slice(0, 6)
+                : ['value'];
+        const rows = data.map((row) => keys.map((key) => cell(key === 'value' ? row : valueAt(row, key))));
+        const widths = keys.map((key, at) => Math.max(key.length, ...rows.map((row) => row[at].length)));
+        const line = (cells) => cells
+            .map((value, at) => value.padEnd(widths[at]))
+            .join('  ')
+            .trimEnd();
+        const table = data.length === 0
+            ? '(none)'
+            : [line(keys.map((key) => key.toUpperCase())), ...rows.map(line)].join('\n');
+        const more = typeof meta?.nextPageToken === 'string'
+            ? `\n(more: --page-token ${meta.nextPageToken})`
+            : '';
+        return `${message ? `${message}\n` : ''}${table}${more}`;
+    }
+    if (message)
+        return message;
+    if (data === null || data === undefined)
+        return 'Done.';
+    if (typeof data === 'object')
+        return Object.entries(data)
+            .map(([key, value]) => `${key}: ${isScalar(value) ? String(value) : JSON.stringify(value)}`)
+            .join('\n');
+    return typeof data === 'string' ? data : JSON.stringify(data);
+}
+function suggestionsFor(reason, bin) {
+    return reason === 'PLAN_REQUIRED'
+        ? [
+            {
+                message: `Propose an operation plan instead: write it to a file under /tmp and run \`${bin} plan create --file /tmp/plan.json\`.`,
+            },
+        ]
+        : [];
+}
+/** The request body: JSON, or a form for a `multipart/form-data` command (no files: the shell has none to send). */
+function bodyOf(command, fields) {
+    if (!command.body)
+        return undefined;
+    if (command.body.media !== 'multipart/form-data')
+        return JSON.stringify(fields);
+    const form = new FormData();
+    for (const [field, value] of Object.entries(fields))
+        for (const item of Array.isArray(value) ? value : [value])
+            if (item !== undefined && item !== null)
+                form.append(field, requestText(item));
+    return form;
+}
+async function call(surface, command, parsed) {
+    const filled = fillRequest(command, parsed.values, parsed.bodyFile);
+    const body = bodyOf(command, filled.fields);
+    const response = await surface.send({
+        method: filled.method,
+        path: filled.path,
+        ...(body === undefined ? {} : { body }),
+    });
+    const text = await response.text();
+    let answer;
+    try {
+        answer = text === '' ? undefined : JSON.parse(text);
+    }
+    catch {
+        answer = undefined;
+    }
+    if (!response.ok) {
+        const error = readErrorBody(answer);
+        const reason = error?.reason ?? `HTTP_${response.status}`;
+        throw new Failure({
+            code: reason,
+            message: error?.message ??
+                `${filled.method} ${filled.path.split('?')[0]} answered ${response.status}`,
+            suggestions: suggestionsFor(reason, surface.bin),
+            details: {
+                httpStatus: response.status,
+                ...(error?.status ? { status: error.status } : {}),
+                ...(error?.metadata === undefined
+                    ? {}
+                    : { metadata: error.metadata }),
+            },
+        }, apiExitCode(response.status, reason, error?.status));
+    }
+    const record = answer && typeof answer === 'object'
+        ? answer
+        : {};
+    return {
+        data: record.data ?? null,
+        ...(record.meta && typeof record.meta === 'object'
+            ? { meta: record.meta }
+            : {}),
+    };
+}
+const out = (stdout, exitCode = 0) => ({
+    stdout: stdout.endsWith('\n') ? stdout : `${stdout}\n`,
+    stderr: '',
+    exitCode,
+});
+/** The `acme` command of a run's shell. */
+export function cliCommand(surface) {
+    const { bin, commands } = surface;
+    return defineCommand(bin, async (args, ctx) => {
+        const json = args.includes('--json');
+        const fail = (name, failure) => json
+            ? {
+                stdout: `${JSON.stringify(commandFailureJson(name, failure.error, []))}\n`,
+                stderr: '',
+                exitCode: failure.exit,
+            }
+            : {
+                stdout: '',
+                stderr: `Error: ${failure.error.message} (${failure.error.code})\n${failure.error.suggestions
+                    .map((suggestion) => `  ${suggestion.message}\n`)
+                    .join('')}`,
+                exitCode: failure.exit,
+            };
+        const plain = args.filter((arg) => arg !== '--json');
+        if (plain.length === 0 || plain[0] === '--help' || plain[0] === '-h')
+            return out(commandList(bin, commands, []));
+        if (plain[0] === 'docs') {
+            const target = plain.slice(1).filter((arg) => !arg.startsWith('-'));
+            if (target.length === 0)
+                return out(areas(bin, commands));
+            const found = resolve(commands, target);
+            if (found && found.rest.length === 0)
+                return out(commandDocs(bin, found.command));
+            const list = commandList(bin, commands, target);
+            if (list)
+                return out(list);
+            return fail('docs', new Failure({
+                code: 'COMMAND_UNKNOWN',
+                message: `There is no command ${target.join(' ')}.`,
+                suggestions: [
+                    {
+                        message: 'List the commands.',
+                        run: { command: bin, args: ['--help'] },
+                    },
+                ],
+            }, EXIT_CODES.notFound));
+        }
+        // The line as typed when it starts with the command's words, so `--json` is read where it stands, as the CLI does.
+        const found = resolve(commands, args) ?? resolve(commands, plain);
+        if (!found) {
+            const prefix = plain.filter((arg) => !arg.startsWith('-'));
+            const list = commandList(bin, commands, prefix);
+            if (list)
+                return out(list);
+            return fail(prefix.join(' '), new Failure({
+                code: 'COMMAND_UNKNOWN',
+                message: `There is no command ${prefix.join(' ')} for you. Run \`${bin} --help\` for the ones you may run.`,
+                suggestions: [
+                    {
+                        message: 'List the commands.',
+                        run: { command: bin, args: ['--help'] },
+                    },
+                ],
+            }, EXIT_CODES.notFound));
+        }
+        const { command, rest } = found;
+        const name = words(command.id);
+        try {
+            if (needsLocalFiles(command) && !asksHelp(rest))
+                throw usage(`${bin} ${commandWords(command)} needs a file on your machine, or saves one there; not available to an online agent.`, 'FILES_UNAVAILABLE');
+            const parsed = await parseCommandLine(command, rest.includes('--json') || !json ? rest : [...rest, '--json'], { bin, io: shellIo(ctx) });
+            if (parsed.help)
+                return out(commandHelp(bin, command));
+            const answer = await call(surface, command, parsed);
+            return parsed.json
+                ? out(JSON.stringify(commandSuccessJson(name, 'success', answer, [])))
+                : out(render(command, answer.data, answer.meta));
+        }
+        catch (error) {
+            if (error instanceof Failure)
+                return fail(name, error);
+            if (error instanceof CliParseError)
+                return fail(name, new Failure({
+                    code: error.code,
+                    message: error.message,
+                    suggestions: [...error.suggestions],
+                    ...(error.details === undefined
+                        ? {}
+                        : { details: error.details }),
+                }, error.exit));
+            return fail(name, new Failure({
+                code: 'UNEXPECTED',
+                message: error instanceof Error ? error.message : String(error),
+                suggestions: [],
+            }, EXIT_CODES.general));
+        }
+    });
+}
+//# sourceMappingURL=cli-command.js.map

package/dist/server/online/cli-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.js","sourceRoot":"","sources":["../../../server/online/cli-command.ts"],"names":[],"mappings":"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"}

package/dist/server/online/consult-tool.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `ask_agent`: an online run asks another online agent a question and waits for its answer, as the AI SDK's subagent
+ * pattern does. The consultation is a run of its own (`core/consultations`), which this instance takes at once and
+ * runs within the tool call (`executor.ts`). The tool streams its progress as preliminary results (the card the
+ * conversation shows, with the answer as it is written), and its last result is the outcome. The asking model reads
+ * only the answer, with a note of the plans it proposed (`toModelOutput`); the consulted run keeps its whole
+ * transcript and its usage.
+ */
+import { type Tool } from 'ai';
+import type { ConsultationNotice } from '../../shared/conversations.js';
+import { ASK_AGENT_TOOL, type ConsultRequest, type ConsultationService } from '../core/consultations/index.js';
+import type { ClaimService, ServerClaim } from '../core/runs/index.js';
+/** How a consultation ended, as the consulted run's executor reports it. */
+export interface ConsultOutcome {
+    readonly status: 'completed' | 'failed' | 'cancelled';
+    /** Its answer: the consulted agent's last text. */
+    readonly answer: string;
+    readonly error: string | null;
+    readonly usage: {
+        readonly inputTokens: number;
+        readonly outputTokens: number;
+    };
+    /** Operation plans it proposed. */
+    readonly plans: readonly {
+        readonly id: string;
+        readonly title: string;
+    }[];
+}
+/** One result of `ask_agent`: preliminary while the consultation runs, then its outcome. */
+export interface ConsultOutput {
+    readonly card: ConsultationNotice;
+    /** The titles of the plans it proposed. */
+    readonly planTitles: readonly string[];
+    /** A refusal before it started, as the model reads it (a command's error). */
+    readonly refusal: string | null;
+}
+/** What the tool needs from the executor that runs it. */
+export interface ConsultToolContext {
+    /** The run that asks. */
+    readonly parent: ServerClaim;
+    readonly holder: {
+        readonly id: string;
+    };
+    readonly consultations: Pick<ConsultationService, 'start'>;
+    readonly claims: Pick<ClaimService, 'claimChild'>;
+    /** Runs the consulted run to its end, aborted by `signal`, telling `onDraft` its answer as it is written. */
+    readonly run: (claim: ServerClaim, signal: AbortSignal | undefined, onDraft: (text: string) => void) => Promise<ConsultOutcome>;
+}
+/** What the asking model reads of a consultation's outcome. */
+export declare function consultText(output: ConsultOutput): string;
+/** The `ask_agent` tool of a run that may consult others. */
+export declare function consultTool(context: ConsultToolContext): Tool<ConsultRequest, ConsultOutput, Record<string, never>>;
+export { ASK_AGENT_TOOL };
+//# sourceMappingURL=consult-tool.d.ts.map

package/dist/server/online/consult-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consult-tool.d.ts","sourceRoot":"","sources":["../../../server/online/consult-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAoB,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EACL,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGvE,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACtD,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5E;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAClD,6GAA6G;IAC7G,QAAQ,CAAC,GAAG,EAAE,CACZ,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAC5B,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9B;AAQD,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAgBzD;AAqCD,6DAA6D;AAC7D,wBAAgB,WAAW,CACzB,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAAC,cAAc,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAqH5D;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/server/online/consult-tool.js

@@ -0,0 +1,177 @@
+/**
+ * `ask_agent`: an online run asks another online agent a question and waits for its answer, as the AI SDK's subagent
+ * pattern does. The consultation is a run of its own (`core/consultations`), which this instance takes at once and
+ * runs within the tool call (`executor.ts`). The tool streams its progress as preliminary results (the card the
+ * conversation shows, with the answer as it is written), and its last result is the outcome. The asking model reads
+ * only the answer, with a note of the plans it proposed (`toModelOutput`); the consulted run keeps its whole
+ * transcript and its usage.
+ */
+import { jsonSchema, tool } from 'ai';
+import { ASK_AGENT_TOOL, } from '../core/consultations/index.js';
+import { errorOutput } from './tools.js';
+const text = (value) => typeof value === 'string' ? value : '';
+const messageOf = (error) => error instanceof Error ? error.message : String(error);
+/** What the asking model reads of a consultation's outcome. */
+export function consultText(output) {
+    const { card } = output;
+    if (card.state === 'refused')
+        return output.refusal ?? JSON.stringify({ error: { message: card.error } });
+    if (card.state !== 'completed')
+        return JSON.stringify({
+            error: {
+                code: 'CONSULTATION_FAILED',
+                message: `${card.agentName} could not answer: ${card.error ?? 'it stopped'}. Answer with what you know, or say what is missing.`,
+            },
+        });
+    const plans = output.planTitles.length > 0
+        ? `\n\n(${card.agentName} proposed ${output.planTitles.length === 1 ? 'an operation plan' : `${output.planTitles.length} operation plans`} the person confirms in this conversation: ${output.planTitles.map((title) => `"${title}"`).join(', ')}. Do not propose ${output.planTitles.length === 1 ? 'it' : 'them'} again; tell the person it is waiting for them.)`
+        : '';
+    return `${card.answer.trim() || '(no answer)'}${plans}`;
+}
+/** A queue of progress the tool yields as it comes. */
+function channel() {
+    const values = [];
+    let closed = false;
+    let wake;
+    const notify = () => {
+        wake?.();
+        wake = undefined;
+    };
+    return {
+        push(value) {
+            values.push(value);
+            notify();
+        },
+        close() {
+            closed = true;
+            notify();
+        },
+        async *[Symbol.asyncIterator]() {
+            for (;;) {
+                if (values.length > 0) {
+                    yield values.shift();
+                    continue;
+                }
+                if (closed)
+                    return;
+                await new Promise((resolve) => (wake = resolve));
+            }
+        },
+    };
+}
+/** The `ask_agent` tool of a run that may consult others. */
+export function consultTool(context) {
+    return tool({
+        description: 'Ask another agent a question and wait for its answer. It reads what it needs with its own skills and commands, may propose an operation plan the person confirms, and changes nothing. You get its answer only; use it in your reply.',
+        inputSchema: jsonSchema({
+            type: 'object',
+            properties: {
+                agent: {
+                    type: 'string',
+                    description: 'The agent to ask, by its name (as "Agents you may consult" lists it) or its id.',
+                },
+                question: {
+                    type: 'string',
+                    description: 'What you want to know, as a complete question.',
+                },
+                context: {
+                    type: 'string',
+                    description: 'What it needs to know to answer: it does not see your conversation.',
+                },
+            },
+            required: ['agent', 'question'],
+            additionalProperties: false,
+        }),
+        async *execute(input, { toolCallId, abortSignal }) {
+            const request = {
+                agent: text(input.agent),
+                question: text(input.question),
+                ...(text(input.context) ? { context: text(input.context) } : {}),
+            };
+            let card = {
+                code: 'consultation',
+                callId: toolCallId,
+                runId: null,
+                agentId: null,
+                agentName: request.agent,
+                question: request.question,
+                state: 'running',
+                answer: '',
+                error: null,
+                usage: null,
+                plans: 0,
+            };
+            if (!request.agent.trim() || !request.question.trim()) {
+                const message = 'Name the agent to ask and the question.';
+                yield {
+                    card: { ...card, state: 'refused', error: message },
+                    planTitles: [],
+                    refusal: JSON.stringify({
+                        error: { code: 'INVALID_REQUEST', message },
+                    }),
+                };
+                return;
+            }
+            let started;
+            try {
+                started = await context.consultations.start(context.parent.runId, toolCallId, request);
+            }
+            catch (error) {
+                yield {
+                    card: { ...card, state: 'refused', error: messageOf(error) },
+                    planTitles: [],
+                    refusal: errorOutput(error),
+                };
+                return;
+            }
+            card = {
+                ...card,
+                runId: started.runId,
+                agentId: started.agent.id,
+                agentName: started.agent.name,
+            };
+            yield { card, planTitles: [], refusal: null };
+            let claim;
+            try {
+                claim = await context.claims.claimChild(context.holder, started.runId);
+            }
+            catch (error) {
+                yield {
+                    card: { ...card, state: 'failed', error: messageOf(error) },
+                    planTitles: [],
+                    refusal: null,
+                };
+                return;
+            }
+            const progress = channel();
+            const done = context
+                .run(claim, abortSignal, (draft) => progress.push(draft))
+                .finally(() => progress.close());
+            for await (const draft of progress)
+                yield {
+                    card: { ...card, answer: draft },
+                    planTitles: [],
+                    refusal: null,
+                };
+            const outcome = await done;
+            yield {
+                card: {
+                    ...card,
+                    state: outcome.status === 'completed' ? 'completed' : 'failed',
+                    answer: outcome.answer,
+                    error: outcome.error,
+                    usage: outcome.usage,
+                    plans: outcome.plans.length,
+                },
+                planTitles: outcome.plans.map((plan) => plan.title || plan.id),
+                refusal: null,
+            };
+        },
+        toModelOutput: ({ output }) => ({
+            type: 'text',
+            value: consultText(output),
+        }),
+    });
+}
+export { ASK_AGENT_TOOL };
+//# sourceMappingURL=consult-tool.js.map

package/dist/server/online/consult-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consult-tool.js","sourceRoot":"","sources":["../../../server/online/consult-tool.ts"],"names":[],"mappings":"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"}