@adonis-agora/agent 0.60.1 → 0.61.0

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,37 @@
+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 { 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;
+}
+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,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;CACzC;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,CAyE9E;CACF"}

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

@@ -0,0 +1,70 @@
+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 } : {}),
+                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

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-preparation.js","sourceRoot":"","sources":["../../src/action-proposal-preparation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAK1E,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAsB,EACtB,IAAY,EACZ,KAAc,EACd,GAAc,EACd,MAAmB,EACnB,OAAO,GAAkB,EAAE;IAE3B,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAC9C,IAAI,EACJ,sBAAsB,CAAC,gBAAgB,CAAC,EACxC,GAAG,EACH,MAAM,EACN,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CACpC,CAAC;IACF,IAAI,cAAkC,CAAC;IACvC,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IACxD,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,KAAK,OAAO,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QACvE,cAAc;YACZ,OAAO,WAAW,KAAK,QAAQ;gBAC7B,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,MAAM,WAAW,CAAC,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QACrE,IACE,cAAc,KAAK,SAAS;YAC5B,CAAC,OAAO,cAAc,KAAK,QAAQ,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,GAAG,CAAC;YAEtF,MAAM,IAAI,SAAS,CACjB,2EAA2E,CAC5E,CAAC;IACN,CAAC;IACD,OAAO;QACL,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,gBAAgB;QAChB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,sFAAsF;QACtF,SAAS,EACP,QAAQ,CAAC,SAAS,CAAC,MAAM,KAAK,OAAO;YACnC,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC5C,CAAC,CAAC,QAAQ,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+export type ActionApprovalMode = 'blocking' | 'independent';
+export type ActionProposalTarget = {
+    kind: 'proposal';
+    proposalId: string;
+};
+export interface ActionProposalReceipt {
+    proposalId: string;
+    status: 'pending';
+    executed: false;
+}
+export declare function actionProposalReceipt(proposalId: string): ActionProposalReceipt;
+//# sourceMappingURL=action-proposal-receipt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-receipt.d.ts","sourceRoot":"","sources":["../../src/action-proposal-receipt.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,aAAa,CAAC;AAC5D,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5E,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC;CACjB;AACD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,CAE/E"}

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

@@ -0,0 +1,4 @@
+export function actionProposalReceipt(proposalId) {
+    return { proposalId, status: 'pending', executed: false };
+}
+//# sourceMappingURL=action-proposal-receipt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-receipt.js","sourceRoot":"","sources":["../../src/action-proposal-receipt.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { ActionApprovalMode } from './action-proposal-receipt.js';
+import type { ActionProposalOutcomeStore } from './spi/action-proposal-outcome-store.js';
+import type { ActionProposalStore, ActionProposalSupersessionStore } from './spi/action-proposal-store.js';
+import type { ActionProposalWorkerStore } from './spi/action-proposal-worker-store.js';
+import type { AgentStore } from './spi/agent-store.js';
+import type { BackgroundActorResolver } from './spi/background-actor-resolver.js';
+export type IndependentActionStore = AgentStore & ActionProposalStore & ActionProposalWorkerStore & ActionProposalOutcomeStore & ActionProposalSupersessionStore;
+export declare function assertIndependentActionRuntime(mode: ActionApprovalMode | undefined, store: unknown, resolver: BackgroundActorResolver | undefined, queuedAdmission: boolean): asserts store is IndependentActionStore;
+//# sourceMappingURL=action-proposal-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-runtime.d.ts","sourceRoot":"","sources":["../../src/action-proposal-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACzF,OAAO,KAAK,EACV,mBAAmB,EACnB,+BAA+B,EAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAElF,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAC7C,mBAAmB,GACnB,yBAAyB,GACzB,0BAA0B,GAC1B,+BAA+B,CAAC;AAClC,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,uBAAuB,GAAG,SAAS,EAC7C,eAAe,EAAE,OAAO,GACvB,OAAO,CAAC,KAAK,IAAI,sBAAsB,CAgCzC"}

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

@@ -0,0 +1,34 @@
+import { isChatQueueStore } from './spi/chat-queue.js';
+export function assertIndependentActionRuntime(mode, store, resolver, queuedAdmission) {
+    if (mode !== undefined && mode !== 'blocking' && mode !== 'independent')
+        throw new TypeError('Invalid actionApprovalMode');
+    if (mode !== 'independent')
+        return;
+    if (!resolver || typeof resolver.resolve !== 'function')
+        throw new Error('Independent actions require a background actor resolver');
+    const methods = [
+        'createActionProposal',
+        'getActionProposal',
+        'listActionProposals',
+        'decideActionProposal',
+        'claimActionProposal',
+        'extendActionProposalLease',
+        'settleActionProposal',
+        'claimNextActionProposal',
+        'expireActionProposals',
+        'claimNextActionProposalOutcome',
+        'admitActionProposalOutcome',
+        'getThreadActionProposalScope',
+        'createReplacingActionProposal',
+        'supersedeActionProposal',
+    ];
+    if (!store ||
+        typeof store !== 'object' ||
+        methods.some((method) => typeof Reflect.get(store, method) !== 'function'))
+        throw new Error('Independent actions require atomic proposal/outcome capabilities');
+    if (Reflect.get(store, 'actionProposalAdmissionSupported') === false)
+        throw new Error('Independent actions require atomic outcome admission');
+    if (!queuedAdmission || !isChatQueueStore(store))
+        throw new Error('Independent actions require actual queued admission');
+}
+//# sourceMappingURL=action-proposal-runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-runtime.js","sourceRoot":"","sources":["../../src/action-proposal-runtime.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAMvD,MAAM,UAAU,8BAA8B,CAC5C,IAAoC,EACpC,KAAc,EACd,QAA6C,EAC7C,eAAwB;IAExB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,aAAa;QACrE,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO;IACnC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU;QACrD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG;QACd,sBAAsB;QACtB,mBAAmB;QACnB,qBAAqB;QACrB,sBAAsB;QACtB,qBAAqB;QACrB,2BAA2B;QAC3B,sBAAsB;QACtB,yBAAyB;QACzB,uBAAuB;QACvB,gCAAgC;QAChC,4BAA4B;QAC5B,8BAA8B;QAC9B,+BAA+B;QAC/B,yBAAyB;KAC1B,CAAC;IACF,IACE,CAAC,KAAK;QACN,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,UAAU,CAAC;QAE1E,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,kCAAkC,CAAC,KAAK,KAAK;QAClE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,IAAI,CAAC,eAAe,IAAI,CAAC,gBAAgB,CAAC,KAAmB,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;AAC3E,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { ActionProposalScope, ActionProposalStore, ListActionProposals } from './spi/action-proposal-store.js';
+import { type ApprovalPolicy } from './spi/approval-policy.js';
+import type { Actor } from './types.js';
+export interface ActionProposalScopeStore {
+    getThreadActionProposalScope(threadId: string): Promise<ActionProposalScope | null>;
+}
+export declare class ActionProposalServiceError extends Error {
+    readonly status: 400 | 403 | 404 | 501;
+    constructor(status: 400 | 403 | 404 | 501, message: string);
+}
+/** Authenticated decisions live independently of the origin runner and its signals. */
+export declare class ActionProposalService {
+    private readonly store;
+    private readonly policy?;
+    constructor(store: ActionProposalStore & ActionProposalScopeStore, policy?: ApprovalPolicy | undefined);
+    private scope;
+    list(actor: Actor, threadId: string, after?: ListActionProposals['after']): Promise<import("./spi/action-proposal-store.js").ActionProposal[]>;
+    listPage(actor: Actor, threadId: string, after?: ListActionProposals['after']): Promise<{
+        items: import("./spi/action-proposal-store.js").ActionProposal[];
+        next?: {
+            createdAt: number;
+            id: string;
+        };
+    }>;
+    handleTextDecision(actor: Actor, threadId: string, text: string): Promise<{
+        status: 'unmatched';
+    } | {
+        threadId: string;
+        proposalDecision: import("./spi/action-proposal-store.js").ActionProposalMutationResult;
+        text: string;
+    } | {
+        threadId: string;
+        proposalDecision: {
+            status: 'ambiguous';
+            proposalIds: string[];
+        };
+        text: string;
+    }>;
+    private decisionText;
+    private canDecide;
+    decide(actor: Actor, threadId: string, proposalId: string, decision: 'approved' | 'rejected', body: unknown, via?: string): Promise<import("./spi/action-proposal-store.js").ActionProposalMutationResult>;
+}
+//# sourceMappingURL=action-proposal-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-service.d.ts","sourceRoot":"","sources":["../../src/action-proposal-service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,wBAAwB;IACvC,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CACrF;AACD,qBAAa,0BAA2B,SAAQ,KAAK;IAEjD,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG;IADxC,YACW,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EACtC,OAAO,EAAE,MAAM,EAGhB;CACF;AAED,uFAAuF;AACvF,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAF1B,YACmB,KAAK,EAAE,mBAAmB,GAAG,wBAAwB,EACrD,MAAM,CAAC,EAAE,cAAc,YAAA,EACtC;YACU,KAAK;IAOb,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,sEAE9E;IACK,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC;;;;;;OAmBlF;IACK,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;;;;;YAmC7D,MAAM,EAAE,WAAW;YACnB,WAAW;;;OAyBlB;IACD,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,SAAS;IAUX,MAAM,CACV,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,UAAU,GAAG,UAAU,EACjC,IAAI,EAAE,OAAO,EACb,GAAG,SAAQ,kFA+BZ;CACF"}