wunderland 0.91.0 → 0.92.0

package/dist/cli/commands/start/remote-approvals.d.ts

@@ -0,0 +1,163 @@
+import { APPROVAL_UNAVAILABLE } from '../../../runtime/tools/tool-helpers.js';
+import { type ReportedTurn } from './hosted-events.js';
+export { APPROVAL_UNAVAILABLE };
+/** The `hitl.mode` that chooses this handler. */
+export declare const HITL_MODE_REMOTE = "remote";
+/** How long an outward tool waits for its answer. */
+export declare const REMOTE_APPROVAL_WAIT_MS: number;
+/** How long the handler waits between one poll's answer and the next poll. */
+export declare const REMOTE_APPROVAL_POLL_MS = 5000;
+/** The most characters of a tool's arguments a request carries. */
+export declare const REMOTE_APPROVAL_TEXT_LIMIT = 1800;
+/** Why a tool did not run: the server's word, or {@link APPROVAL_UNAVAILABLE}. */
+export type RemoteApprovalWord = 'declined' | 'expired' | 'withdrawn' | typeof APPROVAL_UNAVAILABLE;
+/** What a person is asked to approve. */
+export interface RemoteApprovalAction {
+    /** One line: the tool and, when it names one, its target. */
+    summary: string;
+    /** The tool's arguments, with secrets masked, up to {@link REMOTE_APPROVAL_TEXT_LIMIT} characters. */
+    text: string;
+}
+/** The body of `POST <url>/approvals`. */
+export interface RemoteApprovalRequest {
+    toolName: string;
+    action: RemoteApprovalAction;
+    /** The turn's operation id; it also goes in the header `AGENTOS_OPERATION_ID_HEADER` names. */
+    operationId: string;
+}
+/** The handler's answer: `approve` runs the tool, `abort` ends the turn with the word. */
+export type RemoteApprovalDecision = {
+    decision: 'approve';
+    approved: true;
+} | {
+    decision: 'abort';
+    approved: false;
+    reason: RemoteApprovalWord;
+};
+/** Asks the server and waits for its answer. Never rejects. */
+export type RemoteApprovalHandler = (request: RemoteApprovalRequest, hooks?: {
+    /** Called once the server holds the request, before the first poll. */
+    onWaiting?: () => void;
+}) => Promise<RemoteApprovalDecision>;
+/** Options for {@link createRemoteApprovalHandler}. */
+export interface RemoteApprovalHandlerOptions {
+    /** The API root, without `/approvals`. */
+    url: string;
+    /** The bearer token. */
+    token: string;
+    /** How long to wait for the answer; {@link REMOTE_APPROVAL_WAIT_MS} by default. */
+    waitMs?: number;
+    /** The pause between polls; {@link REMOTE_APPROVAL_POLL_MS} by default. */
+    pollMs?: number;
+}
+/**
+ * Creates the handler for one server.
+ *
+ * It posts `{ toolName, action, operationId }` to `<url>/approvals` with
+ * `Authorization: Bearer <token>`, then reads `{ state }` from `GET
+ * <url>/approvals/:id` until the state is `approved`, `declined`, `expired` or
+ * `withdrawn`, or `waitMs` has passed since the server took the request. A last
+ * poll at the deadline reads a yes that came just before it.
+ *
+ * A request the server does not take answers {@link APPROVAL_UNAVAILABLE}, and
+ * so does a poll answered with any 4xx but 408, 425 or 429: the token or the row
+ * is gone. A poll with no answer, a 408, 425, 429 or 5xx, or a state this module
+ * does not know keeps waiting.
+ *
+ * Warnings go to `console.warn`, one line a minute at most, and hold a status or
+ * an error's name, never the token and never the action.
+ *
+ * @param options - The server, the token and the timings.
+ * @returns The handler.
+ */
+export declare function createRemoteApprovalHandler(options: RemoteApprovalHandlerOptions): RemoteApprovalHandler;
+/**
+ * The handler an agent's `hitl.mode` asks for. Any mode but `remote` gets none.
+ * `remote` gets a handler on `WUNDERLAND_EVENTS_URL` and
+ * `WUNDERLAND_EVENTS_TOKEN`; with either unset, blank or not a URL it gets one
+ * that refuses every request, with one warning line.
+ *
+ * @param mode - `hitl.mode` from the agent config.
+ * @param env - The environment to read; `process.env` by default.
+ * @returns The handler, or `undefined` when the mode is not `remote`.
+ */
+export declare function remoteApprovalHandlerForMode(mode: unknown, env?: Record<string, string | undefined>): RemoteApprovalHandler | undefined;
+/** A tool as the marking reads it. */
+export interface MarkedTool {
+    name?: string;
+    category?: string;
+    hasSideEffects?: boolean;
+}
+/** The conversation a turn answers. A turn with none (`POST /chat`, a webhook) has no channel of its own. */
+export interface TurnConversation {
+    platform: string;
+    conversationId: string;
+}
+/**
+ * Whether a tool call is an outward action that asks first.
+ *
+ * It is when the tool's name has a write verb and the tool either sits in an
+ * outward category or does not declare itself free of side effects; and when a
+ * tool that declares side effects aims at a channel other than the
+ * conversation's own. A send to the conversation's own channel through a
+ * channel tool still asks, by its category and verb: the plain reply of a turn
+ * reaches the channel without a tool.
+ *
+ * @param tool - The tool's name, category and side-effect flag.
+ * @param args - The call's arguments.
+ * @param conversation - The conversation the turn answers, if it answers one.
+ * @returns Whether the call asks.
+ */
+export declare function isOutwardAction(tool: MarkedTool, args: Record<string, unknown>, conversation?: TurnConversation): boolean;
+/**
+ * What a person reads before answering: the tool and its target in one line, and
+ * its arguments, with any field named like a secret masked.
+ *
+ * @param tool - The tool.
+ * @param args - The call's arguments.
+ * @returns The action a request carries.
+ */
+export declare function describeAction(tool: MarkedTool, args: Record<string, unknown>): RemoteApprovalAction;
+/**
+ * The line a turn ends with when a tool's approval came back anything but yes.
+ *
+ * @param word - Why the tool did not run.
+ * @param toolName - The tool.
+ * @returns The line, which holds the word.
+ */
+export declare function remoteApprovalLine(word: RemoteApprovalWord, toolName: string): string;
+/** What a turn hands the asking functions. */
+export interface ApprovingTurn {
+    /** The conversation the turn answers, if it answers one. */
+    conversation?: TurnConversation;
+    /** The turn's reporting: its operation id, and the `approval_requested` event. */
+    reportedTurn?: ReportedTurn;
+}
+/**
+ * Asks the handler about one tool call and waits for the answer.
+ *
+ * @param handler - The handler.
+ * @param tool - The tool.
+ * @param args - The call's arguments.
+ * @param turn - The turn asking.
+ * @returns The decision. A handler that throws counts as {@link APPROVAL_UNAVAILABLE}.
+ */
+export declare function askRemoteApproval(handler: RemoteApprovalHandler, tool: MarkedTool, args: Record<string, unknown>, turn?: ApprovingTurn): Promise<RemoteApprovalDecision>;
+/** The answer of the hook {@link outwardApprovalFor} builds, as `runToolCallingTurn` reads it. */
+export type OutwardApprovalVerdict = {
+    approved: true;
+} | {
+    approved: false;
+    reason: RemoteApprovalWord;
+    line: string;
+};
+/**
+ * The `outwardApproval` hook of `runToolCallingTurn` for one turn: outward calls
+ * ask the handler, every other call passes through it unasked.
+ *
+ * @param handler - The agent's handler, if it has one.
+ * @param turn - The turn.
+ * @returns The hook, or `undefined` when the agent has no handler.
+ */
+export declare function outwardApprovalFor(handler: RemoteApprovalHandler | undefined, turn: ApprovingTurn): ((tool: MarkedTool, args: Record<string, unknown>) => Promise<OutwardApprovalVerdict | undefined>) | undefined;
+//# sourceMappingURL=remote-approvals.d.ts.map

package/dist/cli/commands/start/remote-approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-approvals.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/start/remote-approvals.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/start/remote-approvals.js

@@ -0,0 +1,439 @@
+/**
+ * @fileoverview The remote approval handler of `wunderland start`.
+ *
+ * With `hitl.mode: "remote"` in the agent config, an outward tool asks a server
+ * before it runs: `POST <url>/approvals` makes the request, `GET
+ * <url>/approvals/:id` reads the answer, on the URL and the token of
+ * `WUNDERLAND_EVENTS_URL` and `WUNDERLAND_EVENTS_TOKEN`. A person's yes on that
+ * server runs the tool. A no, an expiry or a lost server ends the turn with the
+ * word, and the tool never runs.
+ *
+ * It fails closed. With either variable missing, every outward tool is refused
+ * {@link APPROVAL_UNAVAILABLE}, so an agent that lost its token never acts
+ * unasked. Only the literal state `approved` ever counts as a yes.
+ *
+ * Without `hitl.mode: "remote"` no handler exists and nothing here applies.
+ *
+ * The action's text reaches the approvals route alone: never a log line, and
+ * never the events of `hosted-events.ts`.
+ *
+ * @module wunderland/cli/commands/start/remote-approvals
+ */
+import { randomUUID } from 'node:crypto';
+import { resolveOperationIdHeader } from '../../../platform/config/operation-id.js';
+import { APPROVAL_UNAVAILABLE, safeJsonStringify } from '../../../runtime/tools/tool-helpers.js';
+import { EVENTS_TOKEN_ENV, EVENTS_URL_ENV } from './hosted-events.js';
+export { APPROVAL_UNAVAILABLE };
+/** The `hitl.mode` that chooses this handler. */
+export const HITL_MODE_REMOTE = 'remote';
+/** How long an outward tool waits for its answer. */
+export const REMOTE_APPROVAL_WAIT_MS = 10 * 60_000;
+/** How long the handler waits between one poll's answer and the next poll. */
+export const REMOTE_APPROVAL_POLL_MS = 5_000;
+/** The most characters of a tool's arguments a request carries. */
+export const REMOTE_APPROVAL_TEXT_LIMIT = 1_800;
+/** How long the request may take before the tool is refused. */
+const REQUEST_TIMEOUT_MS = 10_000;
+/** How long one poll may take: a server may hold it open until the answer comes. */
+const POLL_TIMEOUT_MS = 35_000;
+/** At most one warning line per this many milliseconds. */
+const WARN_INTERVAL_MS = 60_000;
+const SUMMARY_MAX_LENGTH = 200;
+const MASK_MAX_DEPTH = 8;
+const MASKED = '[REDACTED]';
+const SECRET_ARG = /api[-_]?key|token|secret|password|passwd|authorization|credential|cookie/i;
+const APPROVE = Object.freeze({ decision: 'approve', approved: true });
+function abort(reason) {
+    return { decision: 'abort', approved: false, reason };
+}
+/** The server's words that end the wait with no. */
+const ABORT_STATES = new Set(['declined', 'expired', 'withdrawn']);
+/** What a poll may tell: a state word, or that the token or the request is gone. */
+const GONE = Symbol('gone');
+function sleep(ms) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        timer.unref?.();
+    });
+}
+async function readJson(res) {
+    try {
+        return JSON.parse(await res.text());
+    }
+    catch {
+        return undefined;
+    }
+}
+function fieldOf(body, name) {
+    return body && typeof body === 'object' ? body[name] : undefined;
+}
+/**
+ * Creates the handler for one server.
+ *
+ * It posts `{ toolName, action, operationId }` to `<url>/approvals` with
+ * `Authorization: Bearer <token>`, then reads `{ state }` from `GET
+ * <url>/approvals/:id` until the state is `approved`, `declined`, `expired` or
+ * `withdrawn`, or `waitMs` has passed since the server took the request. A last
+ * poll at the deadline reads a yes that came just before it.
+ *
+ * A request the server does not take answers {@link APPROVAL_UNAVAILABLE}, and
+ * so does a poll answered with any 4xx but 408, 425 or 429: the token or the row
+ * is gone. A poll with no answer, a 408, 425, 429 or 5xx, or a state this module
+ * does not know keeps waiting.
+ *
+ * Warnings go to `console.warn`, one line a minute at most, and hold a status or
+ * an error's name, never the token and never the action.
+ *
+ * @param options - The server, the token and the timings.
+ * @returns The handler.
+ */
+export function createRemoteApprovalHandler(options) {
+    const endpoint = `${options.url.trim().replace(/\/+$/, '')}/approvals`;
+    const token = options.token.trim();
+    const waitMs = options.waitMs ?? REMOTE_APPROVAL_WAIT_MS;
+    const pollMs = options.pollMs ?? REMOTE_APPROVAL_POLL_MS;
+    let lastWarnAt;
+    const warn = (line) => {
+        const now = Date.now();
+        if (lastWarnAt !== undefined && now - lastWarnAt < WARN_INTERVAL_MS)
+            return;
+        lastWarnAt = now;
+        console.warn(`[remote-approvals] ${line}`);
+    };
+    let operationHeader;
+    try {
+        operationHeader = resolveOperationIdHeader();
+    }
+    catch (err) {
+        warn(`${err instanceof Error ? err.message : String(err)} Asking without an operation id header.`);
+    }
+    const headersFor = (operationId) => ({
+        Authorization: `Bearer ${token}`,
+        ...(operationHeader ? { [operationHeader]: operationId } : {}),
+    });
+    /** Makes the request. Returns the server's id for it, or nothing when it did not take it. */
+    const open = async (request) => {
+        let res;
+        try {
+            res = await fetch(endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', ...headersFor(request.operationId) },
+                body: JSON.stringify({
+                    toolName: request.toolName,
+                    action: request.action,
+                    operationId: request.operationId,
+                }),
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch (err) {
+            warn(`The approvals server did not answer (${err instanceof Error ? err.name : 'error'}); refusing the tool.`);
+            return undefined;
+        }
+        const body = await readJson(res);
+        if (!res.ok) {
+            warn(`The approvals server refused the request (${res.status}); refusing the tool.`);
+            return undefined;
+        }
+        const id = fieldOf(body, 'id');
+        if (typeof id !== 'string' || id === '') {
+            warn('The approvals server took the request and gave no id; refusing the tool.');
+            return undefined;
+        }
+        return id;
+    };
+    /** Reads the request's state once: its word, {@link GONE}, or nothing to go on. */
+    const poll = async (id, operationId, timeoutMs) => {
+        let res;
+        try {
+            res = await fetch(`${endpoint}/${encodeURIComponent(id)}`, {
+                method: 'GET',
+                headers: headersFor(operationId),
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+        }
+        catch (err) {
+            warn(`The approvals server did not answer a poll (${err instanceof Error ? err.name : 'error'}); still waiting.`);
+            return undefined;
+        }
+        const body = await readJson(res);
+        if (res.ok)
+            return fieldOf(body, 'state');
+        if (res.status === 408 || res.status === 425 || res.status === 429 || res.status >= 500) {
+            warn(`The approvals server answered a poll with ${res.status}; still waiting.`);
+            return undefined;
+        }
+        warn(`The approvals server answered a poll with ${res.status}; refusing the tool.`);
+        return GONE;
+    };
+    return async (request, hooks) => {
+        const id = await open(request);
+        if (id === undefined)
+            return abort(APPROVAL_UNAVAILABLE);
+        hooks?.onWaiting?.();
+        // Counted from the server's answer, so its own deadline, which starts when
+        // it takes the request, comes first and its word is the one that is read.
+        const deadline = Date.now() + waitMs;
+        for (;;) {
+            const timeoutMs = Math.min(POLL_TIMEOUT_MS, Math.max(deadline - Date.now(), pollMs));
+            const state = await poll(id, request.operationId, timeoutMs);
+            if (state === GONE)
+                return abort(APPROVAL_UNAVAILABLE);
+            if (state === 'approved')
+                return APPROVE;
+            if (typeof state === 'string' && ABORT_STATES.has(state))
+                return abort(state);
+            const left = deadline - Date.now();
+            if (left <= 0)
+                return abort('expired');
+            await sleep(Math.min(pollMs, left));
+        }
+    };
+}
+/** Refuses every request without asking anyone: the handler of an agent with no server to ask. */
+const refuseEveryRequest = async () => abort(APPROVAL_UNAVAILABLE);
+/**
+ * The handler an agent's `hitl.mode` asks for. Any mode but `remote` gets none.
+ * `remote` gets a handler on `WUNDERLAND_EVENTS_URL` and
+ * `WUNDERLAND_EVENTS_TOKEN`; with either unset, blank or not a URL it gets one
+ * that refuses every request, with one warning line.
+ *
+ * @param mode - `hitl.mode` from the agent config.
+ * @param env - The environment to read; `process.env` by default.
+ * @returns The handler, or `undefined` when the mode is not `remote`.
+ */
+export function remoteApprovalHandlerForMode(mode, env = process.env) {
+    if (typeof mode !== 'string' || mode.trim().toLowerCase() !== HITL_MODE_REMOTE)
+        return undefined;
+    const url = env[EVENTS_URL_ENV]?.trim();
+    const token = env[EVENTS_TOKEN_ENV]?.trim();
+    if (!url || !token) {
+        console.warn(`[remote-approvals] hitl.mode is "remote" and ${EVENTS_URL_ENV} or ${EVENTS_TOKEN_ENV} is not set; every outward tool is refused ${APPROVAL_UNAVAILABLE}.`);
+        return refuseEveryRequest;
+    }
+    try {
+        new URL(url);
+    }
+    catch {
+        console.warn(`[remote-approvals] hitl.mode is "remote" and ${EVENTS_URL_ENV} is not a URL; every outward tool is refused ${APPROVAL_UNAVAILABLE}.`);
+        return refuseEveryRequest;
+    }
+    return createRemoteApprovalHandler({ url, token });
+}
+/** The categories whose tools with a write verb ask even if they declare no side effects. */
+const OUTWARD_CATEGORIES = new Set([
+    'channel',
+    'channels',
+    'communication',
+    'communications',
+    'social',
+    'tools',
+]);
+/** The words in a tool's name that make it an outward action: a send, a post, a publish, a purchase, a bulk send, a webhook. */
+const WRITE_VERBS = new Set([
+    'send',
+    'post',
+    'publish',
+    'purchase',
+    'buy',
+    'pay',
+    'broadcast',
+    'bulk',
+    'webhook',
+]);
+/** A word in a tool's name that, coming first, makes the rest of the name its object: `getPost`. */
+const READ_VERBS = new Set([
+    'get',
+    'list',
+    'read',
+    'search',
+    'find',
+    'fetch',
+    'lookup',
+    'query',
+    'check',
+    'view',
+    'show',
+    'describe',
+    'count',
+]);
+/** The arguments that name where a tool's action goes, across the channel packs. */
+const TARGET_ARGS = [
+    'channelId',
+    'channel_id',
+    'channel',
+    'chatId',
+    'chat_id',
+    'conversationId',
+    'conversation_id',
+    'roomId',
+    'room_id',
+    'jid',
+    'recipient',
+    'recipientId',
+    'recipient_id',
+    'to',
+    'target',
+    'targetChannel',
+    'target_channel',
+];
+/** The first read or write verb in a tool's name decides: `sendMessage` writes, `getSendStatus` reads. */
+function hasWriteVerb(name) {
+    if (typeof name !== 'string')
+        return false;
+    const words = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/);
+    for (const word of words) {
+        if (WRITE_VERBS.has(word))
+            return true;
+        if (READ_VERBS.has(word))
+            return false;
+    }
+    return false;
+}
+/** The targets a tool's arguments name, as trimmed strings. */
+function targetsOf(args) {
+    const targets = [];
+    for (const key of TARGET_ARGS) {
+        const value = args?.[key];
+        for (const item of Array.isArray(value) ? value : [value]) {
+            if (typeof item === 'number')
+                targets.push(String(item));
+            else if (typeof item === 'string' && item.trim())
+                targets.push(item.trim());
+        }
+    }
+    return targets;
+}
+/** Whether a tool's arguments aim at a channel other than the turn's own. */
+function aimsElsewhere(args, conversation) {
+    const platform = args?.['platform'];
+    const namesPlatform = typeof platform === 'string' && platform.trim() !== '';
+    const targets = targetsOf(args);
+    if (!conversation)
+        return namesPlatform || targets.length > 0;
+    if (namesPlatform && platform.trim().toLowerCase() !== conversation.platform.toLowerCase())
+        return true;
+    return targets.some((target) => target !== conversation.conversationId);
+}
+/**
+ * Whether a tool call is an outward action that asks first.
+ *
+ * It is when the tool's name has a write verb and the tool either sits in an
+ * outward category or does not declare itself free of side effects; and when a
+ * tool that declares side effects aims at a channel other than the
+ * conversation's own. A send to the conversation's own channel through a
+ * channel tool still asks, by its category and verb: the plain reply of a turn
+ * reaches the channel without a tool.
+ *
+ * @param tool - The tool's name, category and side-effect flag.
+ * @param args - The call's arguments.
+ * @param conversation - The conversation the turn answers, if it answers one.
+ * @returns Whether the call asks.
+ */
+export function isOutwardAction(tool, args, conversation) {
+    if (hasWriteVerb(tool?.name)) {
+        const category = typeof tool?.category === 'string' ? tool.category.trim().toLowerCase() : '';
+        if (OUTWARD_CATEGORIES.has(category) || tool?.hasSideEffects !== false)
+            return true;
+    }
+    return tool?.hasSideEffects === true && aimsElsewhere(args, conversation);
+}
+/** A copy of `value` with the fields named like a secret masked. */
+function maskSecrets(value, depth) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (depth <= 0)
+        return '[truncated]';
+    if (Array.isArray(value))
+        return value.map((item) => maskSecrets(item, depth - 1));
+    const masked = {};
+    for (const [key, item] of Object.entries(value)) {
+        masked[key] = SECRET_ARG.test(key) ? MASKED : maskSecrets(item, depth - 1);
+    }
+    return masked;
+}
+/**
+ * What a person reads before answering: the tool and its target in one line, and
+ * its arguments, with any field named like a secret masked.
+ *
+ * @param tool - The tool.
+ * @param args - The call's arguments.
+ * @returns The action a request carries.
+ */
+export function describeAction(tool, args) {
+    const name = String(tool?.name ?? 'unknown');
+    const [target] = targetsOf(args);
+    const summary = target ? `${name} to ${target}` : name;
+    return {
+        summary: summary.slice(0, SUMMARY_MAX_LENGTH),
+        text: safeJsonStringify(maskSecrets(args, MASK_MAX_DEPTH), REMOTE_APPROVAL_TEXT_LIMIT),
+    };
+}
+/**
+ * The line a turn ends with when a tool's approval came back anything but yes.
+ *
+ * @param word - Why the tool did not run.
+ * @param toolName - The tool.
+ * @returns The line, which holds the word.
+ */
+export function remoteApprovalLine(word, toolName) {
+    switch (word) {
+        case 'declined':
+            return `The request to run ${toolName} was declined, so it did not run.`;
+        case 'expired':
+            return `The request to run ${toolName} expired with no answer, so it did not run. Ask again to try it again.`;
+        case 'withdrawn':
+            return `The request to run ${toolName} was withdrawn, so it did not run.`;
+        default:
+            return `Approvals are not available (${APPROVAL_UNAVAILABLE}), so ${toolName} did not run.`;
+    }
+}
+/**
+ * Asks the handler about one tool call and waits for the answer.
+ *
+ * @param handler - The handler.
+ * @param tool - The tool.
+ * @param args - The call's arguments.
+ * @param turn - The turn asking.
+ * @returns The decision. A handler that throws counts as {@link APPROVAL_UNAVAILABLE}.
+ */
+export async function askRemoteApproval(handler, tool, args, turn = {}) {
+    try {
+        return await handler({
+            toolName: String(tool?.name ?? 'unknown'),
+            action: describeAction(tool, args),
+            operationId: turn.reportedTurn?.operationId ?? randomUUID(),
+        }, { onWaiting: () => turn.reportedTurn?.approvalRequested() });
+    }
+    catch {
+        return abort(APPROVAL_UNAVAILABLE);
+    }
+}
+/**
+ * The `outwardApproval` hook of `runToolCallingTurn` for one turn: outward calls
+ * ask the handler, every other call passes through it unasked.
+ *
+ * @param handler - The agent's handler, if it has one.
+ * @param turn - The turn.
+ * @returns The hook, or `undefined` when the agent has no handler.
+ */
+export function outwardApprovalFor(handler, turn) {
+    if (!handler)
+        return undefined;
+    return async (tool, args) => {
+        if (!isOutwardAction(tool, args, turn.conversation))
+            return undefined;
+        const decision = await askRemoteApproval(handler, tool, args, turn);
+        if (decision.approved)
+            return { approved: true };
+        return {
+            approved: false,
+            reason: decision.reason,
+            line: remoteApprovalLine(decision.reason, String(tool?.name ?? 'unknown')),
+        };
+    };
+}
+//# sourceMappingURL=remote-approvals.js.map

package/dist/cli/commands/start/remote-approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-approvals.js","sourceRoot":"","sources":["../../../../src/cli/commands/start/remote-approvals.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/start/routes/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/start/routes/chat.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAiCjE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAkBpE;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAke7B"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/start/routes/chat.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAkCjE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAkBpE;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA0e7B"}