@adonis-agora/agent 0.60.1 → 0.62.0

package/dist/src/a2a/turn.js

@@ -0,0 +1,211 @@
+import { createHash } from 'node:crypto';
+import { SCOPE_ROLE_PREFIX, scopeRole } from './gate.js';
+import { PERMISSION_COMPONENT } from './permission-tool.js';
+/** How often a turn looks at an approved proposal while it waits for it to execute. */
+const PROPOSAL_POLL_MS = 250;
+function argsHash(input) {
+    return createHash('sha256')
+        .update(JSON.stringify(input ?? null))
+        .digest('base64url');
+}
+/**
+ * Run one A2A turn to completion and read its outcome off the stream. A2A's `message:send` is
+ * synchronous (PACT §4.2), so the run's frames are consumed here until the stream ends: text is the
+ * reply, an approval is decided on the spot by {@link A2aActionPolicy}, a question set is skipped
+ * (there is no human on this side to answer it — the agent proceeds on its own assumptions), and a
+ * `request_permission` call becomes a step-up.
+ */
+export async function runA2aTurn(service, 
+/** The roles a tool declares (see {@link A2aTurnService.toolRoles}). */
+toolRoles, input) {
+    const { runId, threadId } = await service.chat({
+        actor: input.actor,
+        message: input.text,
+        agentName: input.agentName,
+        // A prompt can tell it is answering a personal agent, not the person in the app.
+        pageContext: { channel: 'a2a' },
+        ...(input.threadId !== undefined ? { threadId: input.threadId } : { transient: true }),
+    });
+    const result = {
+        threadId,
+        text: '',
+        permission: null,
+        actions: [],
+        outcomes: [],
+        error: null,
+    };
+    const delegated = input.delegatedScopes ?? [];
+    // The delegated scopes a tool's roles name (as `scope:<id>` roles).
+    const scopesOf = (tool) => {
+        const roles = toolRoles(tool) ?? [];
+        return delegated.filter((scope) => roles.includes(scopeRole(scope)));
+    };
+    // Announced calls, by id, until their output says they ran.
+    const calls = new Map();
+    // Independent proposals the run left behind, decided once it ends.
+    const proposals = [];
+    // Set once the turn answered (or gave up): a wait still polling stops there.
+    let finished = false;
+    const cancel = () => service.cancel(runId).catch(() => { });
+    /**
+     * Decide the proposals by {@link A2aActionPolicy} and wait for the approved ones to execute. One
+     * the caller may not decide (another approver) stays with the app, and is not reported as done.
+     */
+    const settleProposals = async () => {
+        const { decideActionProposal, listActionProposals } = service;
+        if (!decideActionProposal || !listActionProposals)
+            return;
+        for (const proposal of proposals) {
+            const scopes = scopesOf(proposal.toolName);
+            const approve = input.actions === 'approve-delegated' && scopes.length > 0;
+            try {
+                await decideActionProposal.call(service, input.actor, threadId, proposal.id, approve ? 'approved' : 'rejected', approve
+                    ? {}
+                    : {
+                        reason: 'A personal agent may not run this action without a delegated permission for it.',
+                    }, 'a2a');
+            }
+            catch {
+                continue;
+            }
+            if (!approve)
+                continue;
+            while (!finished) {
+                const listed = await listActionProposals.call(service, input.actor, threadId);
+                const current = listed.find((p) => p.id === proposal.id);
+                const status = current?.execution?.status;
+                if (current?.decision !== 'approved' || status === 'failed') {
+                    result.error = current?.execution?.error ?? `${proposal.toolName} did not run`;
+                    return;
+                }
+                if (status === 'succeeded') {
+                    result.actions.push({
+                        tool: proposal.toolName,
+                        argsHash: argsHash(calls.get(proposal.toolCallId)?.input ?? current.input),
+                        scopes,
+                    });
+                    // The model never sees an independent proposal's result: the app's own summary and the
+                    // tool's output go back as data, whatever the model wrote before calling it.
+                    result.outcomes.push({
+                        tool: proposal.toolName,
+                        status: 'succeeded',
+                        summary: {
+                            title: current.confirmation.title,
+                            ...(current.confirmation.detail ? { detail: current.confirmation.detail } : {}),
+                        },
+                        ...(current.execution?.result !== undefined
+                            ? { result: current.execution.result }
+                            : {}),
+                    });
+                    const said = current.outcome?.text?.trim();
+                    if (said)
+                        result.text = result.text ? `${result.text}\n\n${said}` : said;
+                    break;
+                }
+                await new Promise((resolve) => setTimeout(resolve, PROPOSAL_POLL_MS));
+            }
+        }
+    };
+    let timer;
+    // A HARD deadline: if cancelling does not end the stream, the request still answers.
+    const deadline = new Promise((resolve) => {
+        timer = setTimeout(() => resolve('timeout'), input.timeoutMs);
+    });
+    const stream = service.subscribe(runId)[Symbol.asyncIterator]();
+    try {
+        await input.onStarted?.(threadId);
+        for (;;) {
+            const next = await Promise.race([stream.next(), deadline]);
+            if (next === 'timeout') {
+                result.error = 'timeout';
+                await cancel();
+                break;
+            }
+            if (next.done)
+                break;
+            const frame = next.value;
+            if (frame.t === 'text') {
+                result.text += frame.v;
+            }
+            else if (frame.t === 'component' && frame.name === PERMISSION_COMPONENT) {
+                const scopes = frame.data?.scopes;
+                if (Array.isArray(scopes)) {
+                    result.permission = [...new Set([...(result.permission ?? []), ...scopes.map(String)])];
+                }
+            }
+            else if (frame.t === 'event') {
+                const event = frame.event;
+                if (event.kind === 'tool-input-available') {
+                    calls.set(event.id, { name: event.name, input: event.input });
+                }
+                else if (event.kind === 'tool-output-error') {
+                    // A tool behind a scope the caller did not delegate is offered but not run
+                    // (`personalAgentGate`): its denied call IS the request for that scope.
+                    const call = calls.get(event.id);
+                    const missing = (call ? (toolRoles(call.name) ?? []) : [])
+                        .filter((role) => role.startsWith(SCOPE_ROLE_PREFIX))
+                        .map((role) => role.slice(SCOPE_ROLE_PREFIX.length))
+                        .filter((scope) => !delegated.includes(scope));
+                    if (missing.length > 0) {
+                        result.permission = [...new Set([...(result.permission ?? []), ...missing])];
+                    }
+                }
+                else if (event.kind === 'tool-output') {
+                    const call = calls.get(event.id);
+                    const scopes = call ? scopesOf(call.name) : [];
+                    if (call && scopes.length > 0) {
+                        result.actions.push({ tool: call.name, argsHash: argsHash(call.input), scopes });
+                    }
+                }
+            }
+            else if (frame.t === 'approval') {
+                if (frame.target?.kind === 'proposal') {
+                    proposals.push({
+                        id: frame.target.proposalId,
+                        toolName: frame.toolName,
+                        toolCallId: frame.id,
+                    });
+                    continue;
+                }
+                if (input.actions === 'approve-delegated' && scopesOf(frame.toolName).length > 0) {
+                    await service.approve(frame.runId, frame.id, {
+                        executedByRef: input.actor.id,
+                        via: 'a2a',
+                    });
+                }
+                else {
+                    await service.reject(frame.runId, frame.id, 'A personal agent may not run this action without a delegated permission for it.', { executedByRef: input.actor.id, via: 'a2a' });
+                }
+            }
+            else if (frame.t === 'elicitation') {
+                await service.skip({
+                    runId: frame.runId,
+                    toolCallId: frame.id,
+                    answeredByRef: input.actor.id,
+                    answeredVia: 'a2a',
+                });
+            }
+            else if (frame.t === 'error') {
+                result.error = frame.message;
+            }
+        }
+        if (result.error === null && proposals.length > 0) {
+            const settled = await Promise.race([settleProposals(), deadline]);
+            if (settled === 'timeout')
+                result.error = 'timeout';
+        }
+    }
+    catch (error) {
+        // Nobody will read this run's stream any more: leaving it parked would hold the thread's
+        // active stream, and every later message to this context would be refused as busy.
+        await cancel();
+        throw error;
+    }
+    finally {
+        finished = true;
+        clearTimeout(timer);
+        void stream.return?.();
+    }
+    return result;
+}
+//# sourceMappingURL=turn.js.map

package/dist/src/a2a/turn.js.map

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

package/dist/src/action-proposal-approval.d.ts

@@ -0,0 +1,26 @@
+import type { ApprovalPolicy, ApprovalThreadRef, ApprovalToolRef } from './spi/approval-policy.js';
+import type { Actor } from './types.js';
+export type ClaimedActionApproval = {
+    mode: 'auto';
+} | {
+    mode: 'remembered';
+    approver: string;
+} | {
+    mode: 'ask';
+    approver: string;
+    ttlMs?: number;
+    expiresAt?: string;
+};
+export interface ResolveActionProposalApprovalInput {
+    actor: Actor;
+    thread: ApprovalThreadRef;
+    tool: ApprovalToolRef;
+    store: {
+        rememberedApprovals?(threadId: string): Promise<string[]>;
+    };
+    policy?: ApprovalPolicy;
+    clock?: () => number;
+}
+/** Journal this result on the trusted producer before choosing strict proposal preparation. */
+export declare function resolveActionProposalApproval(input: ResolveActionProposalApprovalInput): Promise<ClaimedActionApproval>;
+//# sourceMappingURL=action-proposal-approval.d.ts.map

package/dist/src/action-proposal-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-approval.d.ts","sourceRoot":"","sources":["../../src/action-proposal-approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEnG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1E,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE;QAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC;IACrE,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AACD,+FAA+F;AAC/F,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAyBhC"}

package/dist/src/action-proposal-approval.js

@@ -0,0 +1,28 @@
+import { DefaultApprovalPolicy } from './spi/approval-policy.js';
+/** Journal this result on the trusted producer before choosing strict proposal preparation. */
+export async function resolveActionProposalApproval(input) {
+    const policy = input.policy ?? new DefaultApprovalPolicy();
+    const requirement = await policy.requirementFor(input.tool, input.actor, input.thread);
+    if (!requirement.required)
+        return { mode: 'auto' };
+    const remembered = (await input.store.rememberedApprovals?.(input.thread.threadId)) ?? [];
+    if (remembered.includes(input.tool.name))
+        return { mode: 'remembered', approver: requirement.approver };
+    const roundedTtl = requirement.ttlMs !== undefined && Number.isFinite(requirement.ttlMs)
+        ? Math.floor(requirement.ttlMs)
+        : 0;
+    if (roundedTtl <= 0)
+        return { mode: 'ask', approver: requirement.approver };
+    const now = (input.clock ?? Date.now)();
+    if (!Number.isSafeInteger(now) ||
+        !Number.isSafeInteger(roundedTtl) ||
+        !Number.isSafeInteger(now + roundedTtl))
+        throw new RangeError('Invalid action approval deadline');
+    return {
+        mode: 'ask',
+        approver: requirement.approver,
+        ttlMs: roundedTtl,
+        expiresAt: new Date(now + roundedTtl).toISOString(),
+    };
+}
+//# sourceMappingURL=action-proposal-approval.js.map

package/dist/src/action-proposal-approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-approval.js","sourceRoot":"","sources":["../../src/action-proposal-approval.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAcjE,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAyC;IAEzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAC3D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvF,IAAI,CAAC,WAAW,CAAC,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1F,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC;IAChE,MAAM,UAAU,GACd,WAAW,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;QACnE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC;QAC/B,CAAC,CAAC,CAAC,CAAC;IACR,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACxC,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC;QAC1B,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC;QACjC,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,GAAG,UAAU,CAAC;QAEvC,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC;IAC3D,OAAO;QACL,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE;KACpD,CAAC;AACJ,CAAC"}

package/dist/src/action-proposal-discovery.d.ts

@@ -0,0 +1,9 @@
+import type { ClaimActionProposal } from './spi/action-proposal-store.js';
+export declare function validateActionProposalWorkerClaim(command: ClaimActionProposal, now: number): void;
+export declare function validateActionProposalExpiryBatch(command: {
+    limit: number;
+}, now: number): void;
+export declare function validateActionProposalDiscoveryIndexBatch(command: {
+    limit: number;
+}): void;
+//# sourceMappingURL=action-proposal-discovery.d.ts.map

package/dist/src/action-proposal-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-discovery.d.ts","sourceRoot":"","sources":["../../src/action-proposal-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAUjG;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAG/F;AAED,wBAAgB,yCAAyC,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG1F"}

package/dist/src/action-proposal-discovery.js

@@ -0,0 +1,20 @@
+export function validateActionProposalWorkerClaim(command, now) {
+    if (!Number.isSafeInteger(now))
+        throw new RangeError('Invalid action proposal clock');
+    if (typeof command.workerId !== 'string' || command.workerId.length === 0)
+        throw new TypeError('workerId must be a nonempty string');
+    if (!Number.isSafeInteger(command.leaseMs) ||
+        command.leaseMs <= 0 ||
+        !Number.isSafeInteger(now + command.leaseMs))
+        throw new RangeError('leaseMs must be positive safe integer milliseconds');
+}
+export function validateActionProposalExpiryBatch(command, now) {
+    if (!Number.isSafeInteger(now))
+        throw new RangeError('Invalid action proposal clock');
+    validateActionProposalDiscoveryIndexBatch(command);
+}
+export function validateActionProposalDiscoveryIndexBatch(command) {
+    if (!Number.isInteger(command.limit) || command.limit < 1 || command.limit > 1000)
+        throw new RangeError('limit must be an integer from 1 to 1000');
+}
+//# sourceMappingURL=action-proposal-discovery.js.map

package/dist/src/action-proposal-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-discovery.js","sourceRoot":"","sources":["../../src/action-proposal-discovery.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iCAAiC,CAAC,OAA4B,EAAE,GAAW;IACzF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;IACtF,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QACvE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC;QACtC,OAAO,CAAC,OAAO,IAAI,CAAC;QACpB,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;QAE5C,MAAM,IAAI,UAAU,CAAC,oDAAoD,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,OAA0B,EAAE,GAAW;IACvF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;IACtF,yCAAyC,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,OAA0B;IAClF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI;QAC/E,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;AACpE,CAAC"}

package/dist/src/action-proposal-executor.d.ts

@@ -0,0 +1,40 @@
+import { type ResolveToolUiCatalog } from './negotiated-tool-ui.js';
+import type { ActionProposal } from './spi/action-proposal-store.js';
+import type { BackgroundActorResolver } from './spi/background-actor-resolver.js';
+import type { RolesPolicy } from './spi/roles-policy.js';
+import type { PresentationErrorHandler } from './spi/tool.js';
+import type { AgentUiComponent } from './stream-events.js';
+import type { ToolRegistry } from './tool-registry.js';
+import type { Actor, Persona } from './types.js';
+export interface ActionProposalExecutionDeps {
+    registry: ToolRegistry;
+    rolesPolicy: RolesPolicy;
+    allowedTools?: string[];
+    host?: unknown;
+    persona?: Persona;
+    resolveUiCatalog?: ResolveToolUiCatalog;
+    /** Where a tool's failed `present` is reported. Undefined → a console warning. */
+    onPresentationError?: PresentationErrorHandler;
+}
+export interface ActionProposalExecutorOptions {
+    resolver: BackgroundActorResolver;
+    /** Resolve exact recorded agent/persona against current configuration; throw if it disappeared. */
+    resolveExecution(proposal: ActionProposal, actor: Actor): Promise<ActionProposalExecutionDeps>;
+}
+export type ActionProposalExecutionResult = {
+    status: 'succeeded';
+    result?: unknown;
+    ui: AgentUiComponent[];
+    text?: string;
+} | {
+    status: 'failed';
+    error: string;
+    ui: AgentUiComponent[];
+    text?: string;
+};
+export declare class ActionProposalExecutor {
+    private readonly options;
+    constructor(options: ActionProposalExecutorOptions);
+    execute(proposal: ActionProposal): Promise<ActionProposalExecutionResult>;
+}
+//# sourceMappingURL=action-proposal-executor.d.ts.map

package/dist/src/action-proposal-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-executor.d.ts","sourceRoot":"","sources":["../../src/action-proposal-executor.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAA4B,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;CAChD;AACD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,uBAAuB,CAAC;IAClC,mGAAmG;IACnG,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAChG;AACD,MAAM,MAAM,6BAA6B,GACrC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,gBAAgB,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,gBAAgB,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/E,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,6BAA6B,EAAI;IACjE,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAoF9E;CACF"}

package/dist/src/action-proposal-executor.js

@@ -0,0 +1,80 @@
+import { snapshotActionProposal } from './action-proposal-transitions.js';
+import { createNegotiatedUiCollector } from './negotiated-tool-ui.js';
+export class ActionProposalExecutor {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async execute(proposal) {
+        let ui = createNegotiatedUiCollector(proposal.originToolCallId, {
+            actor: { id: proposal.actorRef },
+            threadId: proposal.threadId,
+        });
+        try {
+            const actor = await this.options.resolver.resolve({
+                actorRef: proposal.actorRef,
+                tenantRef: proposal.tenantRef,
+            });
+            if (!actor ||
+                actor.id !== proposal.actorRef ||
+                (actor.tenantRef ?? null) !== proposal.tenantRef)
+                throw new Error('Action proposal requester no longer exists or scope changed');
+            const deps = await this.options.resolveExecution(proposal, actor);
+            if (deps.registry.spec(proposal.toolName)?.kind !== 'action')
+                throw new Error('Action proposal tool no longer exists as an action');
+            const context = proposal.executionContext;
+            ui = createNegotiatedUiCollector(proposal.originToolCallId, {
+                actor,
+                threadId: proposal.threadId,
+                ...(context?.agentName !== undefined ? { agentName: context.agentName } : {}),
+                ...(context?.uiCapabilities !== undefined
+                    ? { uiCapabilities: context.uiCapabilities }
+                    : {}),
+            }, deps.resolveUiCatalog);
+            const output = await deps.registry.invoke(proposal.toolName, snapshotActionProposal(Object.hasOwn(proposal, 'preparationInput') ? proposal.preparationInput : proposal.input), {
+                actor,
+                threadId: proposal.threadId,
+                runId: proposal.originRunId,
+                requestId: context?.requestId ?? proposal.originRunId,
+                toolCallId: proposal.originToolCallId,
+                idempotencyKey: proposal.idempotencyKey,
+                ...(context?.agentName !== undefined ? { agentName: context.agentName } : {}),
+                ...(deps.persona !== undefined ? { persona: deps.persona } : {}),
+                ...(context?.pageContext !== undefined ? { pageContext: context.pageContext } : {}),
+                ...(context?.uiCapabilities !== undefined
+                    ? { uiCapabilities: context.uiCapabilities }
+                    : {}),
+                ...(deps.host !== undefined ? { host: deps.host } : {}),
+                ...(deps.onPresentationError !== undefined
+                    ? {
+                        onPresentationError: (error, details) => deps.onPresentationError(error, {
+                            ...details,
+                            toolCallId: proposal.originToolCallId,
+                            runId: proposal.originRunId,
+                            threadId: proposal.threadId,
+                        }),
+                    }
+                    : {}),
+                emitUi: ui.emit,
+            }, deps.rolesPolicy, {
+                approvedInput: proposal.input,
+                ...(deps.allowedTools !== undefined ? { allowedTools: deps.allowedTools } : {}),
+            });
+            return snapshotActionProposal({
+                status: 'succeeded',
+                ...(output !== undefined ? { result: output } : {}),
+                ui: ui.components(),
+                ...(ui.text() ? { text: ui.text() } : {}),
+            });
+        }
+        catch (error) {
+            return {
+                status: 'failed',
+                error: error instanceof Error ? error.message : String(error),
+                ui: ui.components(),
+                ...(ui.text() ? { text: ui.text() } : {}),
+            };
+        }
+    }
+}
+//# sourceMappingURL=action-proposal-executor.js.map

package/dist/src/action-proposal-executor.js.map

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

package/dist/src/action-proposal-outcome.d.ts

@@ -0,0 +1,12 @@
+import type { ActionProposalOutcome, ActionProposalOutcomeLease } from './spi/action-proposal-outcome-store.js';
+import type { ActionProposal, ActionProposalScope } from './spi/action-proposal-store.js';
+import type { AgentUiComponent } from './stream-events.js';
+export declare function attachActionProposalOutcome(row: ActionProposal, now: number, ui?: AgentUiComponent[], text?: string): ActionProposal;
+export declare function claimActionProposalOutcome(row: ActionProposal, command: {
+    workerId: string;
+    leaseMs: number;
+}, now: number, token: string): ActionProposal | null;
+export declare function actionProposalOutcomeFenceValid(row: ActionProposal, command: ActionProposalOutcomeLease, now: number): boolean;
+export declare function actionProposalOutcomeScope(outcome: ActionProposalOutcome): ActionProposalScope;
+export declare function actionProposalOutcomeText(outcome: ActionProposalOutcome): string;
+//# sourceMappingURL=action-proposal-outcome.d.ts.map

package/dist/src/action-proposal-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-outcome.d.ts","sourceRoot":"","sources":["../../src/action-proposal-outcome.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,MAAM,EACX,EAAE,GAAE,gBAAgB,EAAO,EAC3B,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAgChB;AACD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,IAAI,CAmBvB;AACD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,0BAA0B,EACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAoBT;AAQD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,qBAAqB,GAAG,mBAAmB,CAE9F;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAEhF"}

package/dist/src/action-proposal-outcome.js

@@ -0,0 +1,86 @@
+import { validateActionProposalWorkerClaim } from './action-proposal-discovery.js';
+import { snapshotActionProposal } from './action-proposal-transitions.js';
+export function attachActionProposalOutcome(row, now, ui = [], text) {
+    if (row.outcome)
+        return row;
+    const execution = row.execution;
+    const outcome = {
+        id: `${row.id}:outcome:1`,
+        proposalId: row.id,
+        outcomeVersion: 1,
+        tenantRef: row.tenantRef,
+        actorRef: row.actorRef,
+        threadId: row.threadId,
+        originRunId: row.originRunId,
+        originToolCallId: row.originToolCallId,
+        toolName: row.toolName,
+        decision: row.decision,
+        ui,
+        createdAt: now,
+        ...(text !== undefined ? { text } : {}),
+        ...(execution?.status === 'succeeded' || execution?.status === 'failed'
+            ? { executionStatus: execution.status }
+            : {}),
+        ...(execution && Object.hasOwn(execution, 'result') ? { result: execution.result } : {}),
+        ...(execution?.error !== undefined
+            ? { error: execution.error }
+            : row.decisionAudit?.reason !== undefined
+                ? { error: row.decisionAudit.reason }
+                : {}),
+    };
+    return snapshotActionProposal({
+        ...row,
+        outcome,
+        outcomeDelivery: { status: 'pending', generation: 0, lease: null },
+    });
+}
+export function claimActionProposalOutcome(row, command, now, token) {
+    validateActionProposalWorkerClaim(command, now);
+    const delivery = row.outcomeDelivery;
+    if (!row.outcome ||
+        !delivery ||
+        delivery.status !== 'pending' ||
+        (delivery.lease && now < delivery.lease.expiresAt))
+        return null;
+    const generation = delivery.generation + 1;
+    return snapshotActionProposal({
+        ...row,
+        outcomeDelivery: {
+            ...delivery,
+            generation,
+            lease: { token, generation, workerId: command.workerId, expiresAt: now + command.leaseMs },
+        },
+    });
+}
+export function actionProposalOutcomeFenceValid(row, command, now) {
+    if (!Number.isSafeInteger(now))
+        throw new RangeError('Invalid server clock');
+    if (typeof command.token !== 'string' ||
+        !command.token ||
+        !Number.isSafeInteger(command.generation) ||
+        command.generation < 1 ||
+        typeof command.outcomeId !== 'string' ||
+        !command.outcomeId)
+        throw new TypeError('Invalid outcome fence');
+    const delivery = row.outcomeDelivery;
+    return (row.outcome?.id === command.outcomeId &&
+        delivery?.status === 'pending' &&
+        delivery.generation === command.generation &&
+        delivery.lease?.token === command.token &&
+        delivery.lease.generation === command.generation &&
+        now < delivery.lease.expiresAt);
+}
+function outcomeSummary(outcome) {
+    if (outcome.executionStatus === 'succeeded')
+        return `Action ${JSON.stringify(outcome.toolName)} completed (proposal ${JSON.stringify(outcome.proposalId)}).${Object.hasOwn(outcome, 'result') ? ` Result: ${JSON.stringify(outcome.result)}` : ''}`;
+    if (outcome.executionStatus === 'failed')
+        return `Action ${JSON.stringify(outcome.toolName)} failed (proposal ${JSON.stringify(outcome.proposalId)}): ${JSON.stringify(outcome.error ?? 'Execution failed')}`;
+    return `Action ${JSON.stringify(outcome.toolName)} was ${outcome.decision} (proposal ${JSON.stringify(outcome.proposalId)}) and was not executed.${outcome.error ? ` Reason: ${JSON.stringify(outcome.error)}` : ''}`;
+}
+export function actionProposalOutcomeScope(outcome) {
+    return { tenantRef: outcome.tenantRef, actorRef: outcome.actorRef, threadId: outcome.threadId };
+}
+export function actionProposalOutcomeText(outcome) {
+    return outcomeSummary(outcome) + (outcome.text ? ` UI: ${JSON.stringify(outcome.text)}` : '');
+}
+//# sourceMappingURL=action-proposal-outcome.js.map

package/dist/src/action-proposal-outcome.js.map

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

package/dist/src/action-proposal-preparation.d.ts

@@ -0,0 +1,20 @@
+import type { RolesPolicy } from './spi/roles-policy.js';
+import type { AiToolCtx } from './spi/tool.js';
+import type { InvokeOptions, ToolRegistry } from './tool-registry.js';
+/** Trusted producer path: retain the original JSON and the exact data shown for approval. */
+export declare function prepareActionProposal(registry: ToolRegistry, name: string, input: unknown, ctx: AiToolCtx, policy: RolesPolicy, options?: InvokeOptions): Promise<{
+    replacementKey?: string;
+    preparationInput: unknown;
+    input: unknown;
+    preflight: {
+        status: 'ready';
+        confirmation?: import("./tool-presentation.js").ToolConfirmation;
+    } | {
+        status: 'denied';
+        reason: string;
+    } | {
+        status: 'completed';
+        output: unknown;
+    };
+}>;
+//# sourceMappingURL=action-proposal-preparation.d.ts.map

package/dist/src/action-proposal-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-preparation.d.ts","sourceRoot":"","sources":["../../src/action-proposal-preparation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,6FAA6F;AAC7F,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,aAAkB;;;;;;;;;;;;;;GAmC5B"}

package/dist/src/action-proposal-preparation.js

@@ -0,0 +1,27 @@
+import { snapshotActionProposal } from './action-proposal-transitions.js';
+/** Trusted producer path: retain the original JSON and the exact data shown for approval. */
+export async function prepareActionProposal(registry, name, input, ctx, policy, options = {}) {
+    const preparationInput = snapshotActionProposal(input);
+    const prepared = await registry.prepareValidated(name, snapshotActionProposal(preparationInput), ctx, policy, { ...options, snapshotInput: true });
+    let replacementKey;
+    const replacement = registry.spec(name)?.replacementKey;
+    if (prepared.preflight.status === 'ready' && replacement !== undefined) {
+        replacementKey =
+            typeof replacement === 'string'
+                ? replacement
+                : await replacement(snapshotActionProposal(prepared.input), ctx);
+        if (replacementKey !== undefined &&
+            (typeof replacementKey !== 'string' || !replacementKey || replacementKey.length > 255))
+            throw new TypeError('replacementKey must be a nonempty string of at most 255 UTF-16 code units');
+    }
+    return {
+        ...(replacementKey !== undefined ? { replacementKey } : {}),
+        preparationInput,
+        input: prepared.input,
+        // Completed results keep their normal handler contract; they never create a proposal.
+        preflight: prepared.preflight.status === 'ready'
+            ? snapshotActionProposal(prepared.preflight)
+            : prepared.preflight,
+    };
+}
+//# sourceMappingURL=action-proposal-preparation.js.map