@framers/agentos 0.10.40 → 0.11.1

package/dist/api/runtime/approval-gate.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @file approval-gate.ts
+ * The tool-approval gate `agency()` installs when `hitl.approvals.beforeTool`
+ * is listed. It rides the per-call options as `__approvalGate`; the native
+ * tool loops of `generateText` and `streamText` and the prompt-tool shim call
+ * it after `onBeforeToolExecution`, on the arguments that hook left. It never
+ * throws: a rejection, a handler error, a timeout, a guardrail block and a
+ * received gate that threw all skip the tool. A handler error or an
+ * `onTimeout: 'error'` timeout is stored in the owner's slot, which `agency()`
+ * checks when its strategy settles.
+ */
+import type { AgencyOptions, ApprovalDecision, ApprovalRequest } from '../types.js';
+/**
+ * The only value that approves a tool call. A registered symbol, so a gate
+ * received from a parent agency loaded from another copy of this module
+ * compares equal.
+ */
+export declare const APPROVAL_GRANTED: unique symbol;
+/** What a gate receives: the tool call as the hook left it. */
+export interface ApprovalGateInfo {
+    /** Tool name. */
+    name: string;
+    /** Arguments the tool will run with. */
+    args: Record<string, unknown>;
+    /** Tool call ID from the model (`''` on the prompt-tool path). */
+    id: string;
+    /** Current step index of the tool loop. */
+    step: number;
+}
+/** A refusal: the tool is skipped and the model is told why. */
+export interface ApprovalRefusal {
+    skipped: true;
+    reason: string;
+}
+/** The per-call gate function. */
+export type ApprovalGateFn = (info: ApprovalGateInfo) => Promise<typeof APPROVAL_GRANTED | ApprovalRefusal>;
+/** The first handler error or `'error'` timeout of a call, a seat or a chair, and whether its owner settled. */
+export interface ApprovalSlot {
+    error?: unknown;
+    settled: boolean;
+}
+/** Creates an empty slot for one call, seat or chair. */
+export declare function createApprovalSlot(): ApprovalSlot;
+/**
+ * The gate a call received from a parent agency: `undefined` when none was
+ * passed (the key absent or holding `undefined`, which a forwarding strategy
+ * may pass); the function when one was; and, for a value that is present but
+ * not a function, a gate that refuses every tool and asks no handler. Fail
+ * closed: a forwarded gate can only skip tools, never approve one.
+ */
+export declare function composeReceivedGate(value: unknown): ApprovalGateFn | undefined;
+/**
+ * Applies `timeoutMs` and `onTimeout` to the HITL handler: resolves with the
+ * handler's decision, with an auto-decision on `'approve'` / `'reject'`
+ * timeouts, and rejects on `'error'` timeouts or when the handler throws.
+ */
+export declare function resolveApprovalDecision(hitlConfig: NonNullable<AgencyOptions['hitl']>, request: ApprovalRequest): Promise<ApprovalDecision>;
+/** Options of {@link createApprovalGate}. */
+export interface CreateApprovalGateOptions {
+    /** The agency's HITL config; `approvals.beforeTool` lists the tools it covers. */
+    hitl: NonNullable<AgencyOptions['hitl']>;
+    /** The name the approval request carries as `agent` (the agency, or a panel seat). */
+    agentName: string;
+    /** The agency's callbacks; a callback that throws is logged. */
+    on: AgencyOptions['on'];
+    /** The slot of the call, seat or chair that owns this gate. */
+    slot: ApprovalSlot;
+    /** A parent agency's gate: it decides first; its refusal is final and its handler is asked first. */
+    received?: ApprovalGateFn;
+}
+/**
+ * Builds the gate for one call (or one panel seat or chair). The received
+ * gate, if any, decides first; only its exact {@link APPROVAL_GRANTED}
+ * approves, anything else (a throw, a refusal, a string) is a refusal and
+ * nothing is stored in this slot. Then, for a tool listed in `beforeTool`
+ * (or every tool, for `'*'`), the handler is asked through
+ * {@link resolveApprovalDecision}; an approved decision runs the post-approval
+ * guardrails over the arguments unless `hitl.guardrailOverride` is `false`.
+ * A `modifications.toolArgs` on the decision is not applied: argument
+ * rewriting belongs to `onBeforeToolExecution`, which ran first. Once the
+ * slot holds an error (the call will reject) or its owner has settled, the
+ * gate skips every tool without asking the handler or firing approval
+ * events; after settlement it also drops any later error.
+ */
+export declare function createApprovalGate(o: CreateApprovalGateOptions): ApprovalGateFn;
+/**
+ * Calls a gate from a tool loop. A gate that throws is a refusal, never a
+ * rejected call, and any result but the exact approval is a refusal with a
+ * string reason, so a gate passed through unchanged cannot break the loop.
+ */
+export declare function askApprovalGate(gate: ApprovalGateFn, info: ApprovalGateInfo): Promise<typeof APPROVAL_GRANTED | ApprovalRefusal>;
+//# sourceMappingURL=approval-gate.d.ts.map

package/dist/api/runtime/approval-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-gate.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/approval-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGpF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,MAAoD,CAAC;AAE3F,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,gBAAgB,GAAG,eAAe,CAAC,CAAC;AAE5G,gHAAgH;AAChH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAI9E;AAqBD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAC9C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAED,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACxB,+DAA+D;IAC/D,IAAI,EAAE,YAAY,CAAC;IACnB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,yBAAyB,GAAG,cAAc,CAqE/E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,gBAAgB,GAAG,eAAe,CAAC,CAOtI"}

package/dist/api/runtime/approval-gate.js

@@ -0,0 +1,182 @@
+import { AgencyConfigError } from '../types.js';
+/**
+ * The only value that approves a tool call. A registered symbol, so a gate
+ * received from a parent agency loaded from another copy of this module
+ * compares equal.
+ */
+export const APPROVAL_GRANTED = Symbol.for('agentos.approvalGate.approved');
+/** Creates an empty slot for one call, seat or chair. */
+export function createApprovalSlot() {
+    return { settled: false };
+}
+/**
+ * The gate a call received from a parent agency: `undefined` when none was
+ * passed (the key absent or holding `undefined`, which a forwarding strategy
+ * may pass); the function when one was; and, for a value that is present but
+ * not a function, a gate that refuses every tool and asks no handler. Fail
+ * closed: a forwarded gate can only skip tools, never approve one.
+ */
+export function composeReceivedGate(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'function')
+        return value;
+    return async () => refusal('the received approval gate is not a function');
+}
+const refusal = (reason) => ({ skipped: true, reason });
+/** Anything but the exact approval is a refusal; a refusal keeps its own string reason. */
+function asVerdict(verdict, fallback) {
+    if (verdict === APPROVAL_GRANTED)
+        return APPROVAL_GRANTED;
+    const reason = verdict !== null && typeof verdict === 'object' && typeof verdict.reason === 'string'
+        ? verdict.reason
+        : fallback;
+    return refusal(reason);
+}
+function safeCall(fn, event) {
+    try {
+        fn?.(event);
+    }
+    catch (err) {
+        console.warn('[agentos] agency callback threw:', err);
+    }
+}
+/**
+ * Applies `timeoutMs` and `onTimeout` to the HITL handler: resolves with the
+ * handler's decision, with an auto-decision on `'approve'` / `'reject'`
+ * timeouts, and rejects on `'error'` timeouts or when the handler throws.
+ */
+export async function resolveApprovalDecision(hitlConfig, request) {
+    const timeoutMs = hitlConfig.timeoutMs ?? 30000;
+    const onTimeout = hitlConfig.onTimeout ?? 'reject';
+    return await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            if (onTimeout === 'approve') {
+                resolve({ approved: true, reason: 'Auto-approved after HITL timeout' });
+                return;
+            }
+            if (onTimeout === 'error') {
+                reject(new AgencyConfigError('HITL approval timed out'));
+                return;
+            }
+            resolve({ approved: false, reason: 'Auto-rejected after HITL timeout' });
+        }, timeoutMs);
+        // A handler that throws before returning a promise rejects here too, and
+        // the timer is cleared either way.
+        Promise.resolve()
+            .then(() => hitlConfig.handler(request))
+            .then((decision) => {
+            clearTimeout(timer);
+            resolve(decision);
+        })
+            .catch((error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+/**
+ * Builds the gate for one call (or one panel seat or chair). The received
+ * gate, if any, decides first; only its exact {@link APPROVAL_GRANTED}
+ * approves, anything else (a throw, a refusal, a string) is a refusal and
+ * nothing is stored in this slot. Then, for a tool listed in `beforeTool`
+ * (or every tool, for `'*'`), the handler is asked through
+ * {@link resolveApprovalDecision}; an approved decision runs the post-approval
+ * guardrails over the arguments unless `hitl.guardrailOverride` is `false`.
+ * A `modifications.toolArgs` on the decision is not applied: argument
+ * rewriting belongs to `onBeforeToolExecution`, which ran first. Once the
+ * slot holds an error (the call will reject) or its owner has settled, the
+ * gate skips every tool without asking the handler or firing approval
+ * events; after settlement it also drops any later error.
+ */
+export function createApprovalGate(o) {
+    const listed = o.hitl.approvals?.beforeTool ?? [];
+    const covers = (name) => listed.includes('*') || listed.includes(name);
+    /** The refusal of a gate whose call is over: its owner settled, or an earlier approval failed. */
+    const stopped = () => {
+        if (o.slot.settled)
+            return refusal('the run has settled');
+        if (o.slot.error !== undefined)
+            return refusal('an earlier tool approval failed');
+        return undefined;
+    };
+    return async (info) => {
+        const early = stopped();
+        if (early)
+            return early;
+        if (o.received) {
+            let verdict;
+            try {
+                verdict = await o.received(info);
+            }
+            catch (err) {
+                console.warn('[agentos] the approval gate received from the parent agency threw:', err);
+                return refusal('not approved by the parent agency');
+            }
+            const parent = asVerdict(verdict, 'not approved by the parent agency');
+            if (parent !== APPROVAL_GRANTED)
+                return parent;
+        }
+        if (!covers(info.name))
+            return APPROVAL_GRANTED;
+        const request = {
+            id: crypto.randomUUID(),
+            type: 'tool',
+            agent: o.agentName,
+            action: info.name,
+            description: `Tool "${info.name}" is about to run`,
+            details: { tool: info.name, args: info.args, step: info.step, callId: info.id },
+            context: { agentCalls: [], totalTokens: 0, totalCostUSD: 0, elapsedMs: 0 },
+        };
+        safeCall(o.on?.approvalRequested, request);
+        let decision;
+        try {
+            decision = await resolveApprovalDecision(o.hitl, request);
+        }
+        catch (err) {
+            if (!o.slot.settled) {
+                // A rejection with no reason still fails the call.
+                if (o.slot.error === undefined)
+                    o.slot.error = err === undefined ? new AgencyConfigError('HITL approval failed') : err;
+                safeCall(o.on?.error, { agent: o.agentName, error: err instanceof Error ? err : new Error(String(err)), timestamp: Date.now() });
+            }
+            return refusal(err instanceof Error ? err.message : 'approval failed');
+        }
+        // A decision that arrives after the call ended (a concurrent approval
+        // failed, or the owner settled) fires nothing and runs nothing.
+        const late = stopped();
+        if (late)
+            return late;
+        safeCall(o.on?.approvalDecided, decision);
+        if (!decision.approved)
+            return refusal(decision.reason ?? 'rejected by the approval handler');
+        if (o.hitl.guardrailOverride !== false) {
+            const { runPostApprovalGuardrails } = await import('../agency.js');
+            const result = await runPostApprovalGuardrails(info.name, info.args, o.hitl.postApprovalGuardrails ?? ['pii-redaction', 'code-safety'], o.on);
+            // The guardrail check is awaited: a call that ended meanwhile fires nothing.
+            const afterGuardrails = stopped();
+            if (afterGuardrails)
+                return afterGuardrails;
+            if (!result.passed) {
+                safeCall(o.on?.guardrailHitlOverride, { guardrailId: result.guardrailId, reason: result.reason, toolName: info.name, timestamp: Date.now() });
+                return refusal(`guardrail ${result.guardrailId}: ${result.reason}`);
+            }
+        }
+        return stopped() ?? APPROVAL_GRANTED;
+    };
+}
+/**
+ * Calls a gate from a tool loop. A gate that throws is a refusal, never a
+ * rejected call, and any result but the exact approval is a refusal with a
+ * string reason, so a gate passed through unchanged cannot break the loop.
+ */
+export async function askApprovalGate(gate, info) {
+    try {
+        return asVerdict(await gate(info), 'not approved by the approval gate');
+    }
+    catch (err) {
+        console.warn('[agentos] approval gate threw:', err);
+        return refusal('the approval gate threw');
+    }
+}
+//# sourceMappingURL=approval-gate.js.map

package/dist/api/runtime/approval-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-gate.js","sourceRoot":"","sources":["../../../src/api/runtime/approval-gate.ts"],"names":[],"mappings":"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"}

package/dist/api/runtime/strategies/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/api/runtime/strategies/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/api/runtime/strategies/shared.ts"],"names":[],"mappings":"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"}

package/dist/api/runtime/strategies/shared.js

@@ -12,6 +12,7 @@
  */
 import { agent as createAgent } from '../agent.js';
 import { mergeAdaptableTools } from '../toolAdapter.js';
+import { knownProviderPrefixOf, routedProviderOf } from '../../model.js';
 import { AgencyQuorumError } from '../types.js';
 /**
  * Type guard that checks whether a value is a pre-built {@link Agent} instance
@@ -161,14 +162,30 @@ export function buildAgentCallUsage(resultUsage) {
  * @see {@link resolveAgent} -- calls this internally before creating an agent.
  */
 export function mergeDefaults(agentConfig, agencyConfig) {
+    // A seat whose own model names a provider (`anthropic:claude-opus-5-5`) does
+    // not inherit the agency's provider, so the prefix never meets an inherited
+    // `ollama`, under which a colon is never split.
+    const seatPrefix = agentConfig.provider === 'ollama' ? undefined : knownProviderPrefixOf(agentConfig.model);
+    const model = agentConfig.model ?? agencyConfig.model;
+    const provider = agentConfig.provider ?? (seatPrefix !== undefined ? undefined : agencyConfig.provider);
+    // The agency's key and URL belong to the provider the agency's own calls go
+    // to. A seat inherits them only when its calls go to that same provider: a
+    // seat whose calls go to another provider (named by a model prefix in either
+    // form, or by its own `provider`), or to auto-detection, which may pick any
+    // vendor, does not, since sending them there would leak the key to another
+    // vendor. When the agency's provider comes from auto-detection, it is
+    // unknown and the seat inherits them.
+    const seatRouted = routedProviderOf({ provider, model });
+    const agencyRouted = routedProviderOf(agencyConfig);
+    const otherVendor = agencyRouted !== undefined && seatRouted !== agencyRouted;
     return {
         // Agency-level model/provider/apiKey/baseUrl serve as defaults.
         // They are placed BEFORE the spread of agentConfig so that agent-level
         // values override them when present.
-        model: agentConfig.model ?? agencyConfig.model,
-        provider: agentConfig.provider ?? agencyConfig.provider,
-        apiKey: agentConfig.apiKey ?? agencyConfig.apiKey,
-        baseUrl: agentConfig.baseUrl ?? agencyConfig.baseUrl,
+        model,
+        provider,
+        apiKey: agentConfig.apiKey ?? (otherVendor ? undefined : agencyConfig.apiKey),
+        baseUrl: agentConfig.baseUrl ?? (otherVendor ? undefined : agencyConfig.baseUrl),
         ...agentConfig,
         // Tools are merged separately because we want additive merging
         // (agency tools + agent tools) rather than wholesale replacement.

package/dist/api/runtime/strategies/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../src/api/runtime/strategies/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../src/api/runtime/strategies/shared.ts"],"names":[],"mappings":"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"}

package/dist/api/runtime/tool-emulation/loop.d.ts

@@ -1,4 +1,5 @@
 import type { ITool, ToolExecutionContext } from '../../../core/tools/ITool';
+import { type ApprovalGateFn } from '../approval-gate';
 export interface EmulatedLoopMessage {
     role: string;
     content: string;
@@ -27,6 +28,21 @@ export interface RunEmulatedToolLoopOptions {
      * refuse a failover that would run the call again.
      */
     onToolExecute?: (toolName: string) => void;
+    /**
+     * Called before each parsed call runs, on `{ name, args, id: '', step }`.
+     * The returned `args` replace the call's; `null` skips the tool. A hook
+     * that throws is logged and the tool runs.
+     */
+    onBeforeToolExecution?: (info: {
+        name: string;
+        args: Record<string, unknown>;
+        id: string;
+        step: number;
+    }) => Promise<{
+        args: Record<string, unknown>;
+    } | null>;
+    /** The agency approval gate, called after the hook: anything but its exact approval skips the tool. */
+    approvalGate?: ApprovalGateFn;
 }
 export interface EmulatedToolLoopResult {
     text: string;

package/dist/api/runtime/tool-emulation/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../../src/api/runtime/tool-emulation/loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAK7E,MAAM,WAAW,mBAAmB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAAE;AAEvE,MAAM,WAAW,sBAAsB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAAE;AAExG,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,oEAAoE;IACpE,SAAS,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC5G,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAiDjC"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../../src/api/runtime/tool-emulation/loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAK1F,MAAM,WAAW,mBAAmB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAAE;AAEvE,MAAM,WAAW,sBAAsB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAAE;AAExG,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,oEAAoE;IACpE,SAAS,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC5G,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC/J,uGAAuG;IACvG,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAqEjC"}

package/dist/api/runtime/tool-emulation/loop.js

@@ -1,3 +1,4 @@
+import { APPROVAL_GRANTED, askApprovalGate } from '../approval-gate.js';
 import { renderToolSystemBlock } from './renderer.js';
 import { parseToolCalls } from './parser.js';
 import { formatToolResponse } from './activation.js';
@@ -33,14 +34,35 @@ export async function runEmulatedToolLoop(opts) {
             if (!tool) {
                 return formatToolResponse(call.name, { success: false, error: `unknown tool "${call.name}"` });
             }
+            let args = call.arguments;
+            if (opts.onBeforeToolExecution) {
+                try {
+                    const hooked = await opts.onBeforeToolExecution({ name: call.name, args, id: '', step });
+                    if (hooked === null) {
+                        toolCalls.push({ name: call.name, args, error: 'Skipped by onBeforeToolExecution hook' });
+                        return formatToolResponse(call.name, { success: false, error: 'skipped by onBeforeToolExecution hook' });
+                    }
+                    args = hooked.args;
+                }
+                catch (hookErr) {
+                    console.warn('[agentos] onBeforeToolExecution hook error:', hookErr);
+                }
+            }
+            if (opts.approvalGate) {
+                const verdict = await askApprovalGate(opts.approvalGate, { name: call.name, args: args ?? {}, id: '', step });
+                if (verdict !== APPROVAL_GRANTED) {
+                    toolCalls.push({ name: call.name, args, error: `Skipped: ${verdict.reason}` });
+                    return formatToolResponse(call.name, { success: false, error: `skipped: ${verdict.reason}` });
+                }
+            }
             try {
                 opts.onToolExecute?.(call.name);
-                const result = await tool.execute(call.arguments, opts.toolContext);
-                toolCalls.push({ name: call.name, args: call.arguments });
+                const result = await tool.execute(args, opts.toolContext);
+                toolCalls.push({ name: call.name, args });
                 return formatToolResponse(call.name, result);
             }
             catch (err) {
-                toolCalls.push({ name: call.name, args: call.arguments, error: String(err) });
+                toolCalls.push({ name: call.name, args, error: String(err) });
                 return formatToolResponse(call.name, { success: false, error: String(err) });
             }
         }));

package/dist/api/runtime/tool-emulation/loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../../../src/api/runtime/tool-emulation/loop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../../../src/api/runtime/tool-emulation/loop.ts"],"names":[],"mappings":"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"}

package/dist/api/streamText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamText.d.ts","sourceRoot":"","sources":["../../src/api/streamText.ts"],"names":[],"mappings":"AAgBA,OAAO,EAaL,KAAK,mBAAmB,EAIxB,KAAK,UAAU,EAEf,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAwE3E;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,kBAAkB,CAiBpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,yEAAyE;IACzE,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC;;;;;OAKG;IACH,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B;;;;;;OAMG;IACH,aAAa,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC;;;;;;;;;OASG;IACH,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1C;;;;;;;OAOG;IACH,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD;;;;;;OAMG;IACH,iBAAiB,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3C;AAgCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,CAs0CtE"}
+{"version":3,"file":"streamText.d.ts","sourceRoot":"","sources":["../../src/api/streamText.ts"],"names":[],"mappings":"AAiBA,OAAO,EAaL,KAAK,mBAAmB,EAIxB,KAAK,UAAU,EAEf,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAwE3E;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,kBAAkB,CAiBpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,yEAAyE;IACzE,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC;;;;;OAKG;IACH,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B;;;;;;OAMG;IACH,aAAa,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC;;;;;;;;;OASG;IACH,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1C;;;;;;;OAOG;IACH,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD;;;;;;OAMG;IACH,iBAAiB,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3C;AAgCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,CAu2CtE"}

package/dist/api/streamText.js

@@ -14,6 +14,7 @@ import { fireLlmUsageObserver } from './observers.js';
 import { hostPolicyToRouteParams, mergeRequiredCapabilities } from './runtime/hostPolicy.js';
 import { adaptTools } from './runtime/toolAdapter.js';
 import { runEmulatedToolLoop, toShimMessages } from './runtime/tool-emulation/index.js';
+import { APPROVAL_GRANTED, askApprovalGate } from './runtime/approval-gate.js';
 import { buildPolicyAwareFallbackChain, createPlan, fallbackHopOverrides, addModelUsage, hasBillableUsage, isRetryableError, markChainWalked, markToolsRan, chainWalkedBefore, toolsRanBefore, usageOfError, resolveChainOfThought, } from './generateText.js';
 import { toProviderReplayMessage } from './sessionTranscript.js';
 import { resolveDynamicToolCalls } from './runtime/dynamicToolCalling.js';
@@ -423,6 +424,10 @@ export function streamText(opts) {
                     onToolExecute: () => {
                         shimRanTool = true;
                     },
+                    // The hook, then the approval gate, before each parsed call runs,
+                    // as on the native loop below.
+                    onBeforeToolExecution: opts.onBeforeToolExecution,
+                    approvalGate: opts.__approvalGate,
                     // Native tool turns in the history become the shim's own
                     // <tool_call> / <tool_response> text.
                     messages: toShimMessages(messages),
@@ -931,6 +936,34 @@ export function streamText(opts) {
                                 console.warn('[agentos] onBeforeToolExecution hook error:', hookErr);
                             }
                         }
+                        // --- approval gate (agency hitl.approvals.beforeTool) ---
+                        // Runs after the hook, on the arguments the hook left. Anything but
+                        // the exact approval skips the tool and tells the model.
+                        if (opts.__approvalGate) {
+                            const verdict = await askApprovalGate(opts.__approvalGate, {
+                                name: fnName,
+                                args: (parsedArgs ?? {}),
+                                id: toolCallId || '',
+                                step,
+                            });
+                            if (verdict !== APPROVAL_GRANTED) {
+                                toolCallRecord.error = `Skipped: ${verdict.reason}`;
+                                const resultPart = {
+                                    type: 'tool-result',
+                                    toolName: fnName,
+                                    result: { skipped: true, reason: verdict.reason },
+                                };
+                                parts.push(resultPart);
+                                yield resultPart;
+                                messages.push({
+                                    role: 'tool',
+                                    tool_call_id: toolCallId,
+                                    content: JSON.stringify({ skipped: true, reason: verdict.reason }),
+                                });
+                                allToolCalls.push(toolCallRecord);
+                                continue;
+                            }
+                        }
                         try {
                             const result = await tool.execute(parsedArgs, buildHelperToolExecutionContext('streamText', helperToolRunId, step, toolCallId || undefined));
                             toolCallRecord.result = result.output;