@adonis-agora/agent 0.60.1 → 0.62.0

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,47 @@
+import { type TextActionProposalConfig } from './action-proposal-text.js';
+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?;
+    private readonly vocabulary;
+    private readonly replies;
+    constructor(store: ActionProposalStore & ActionProposalScopeStore, policy?: ApprovalPolicy | undefined, text?: TextActionProposalConfig);
+    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;
+    }>;
+    /** The configured reply to a decision the store answered with `result`. */
+    reply(result: import('./spi/action-proposal-store.js').ActionProposalMutationResult, decision: 'approved' | 'rejected'): string;
+    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":"AAAA,OAAO,EAKL,KAAK,wBAAwB,EAI9B,MAAM,2BAA2B,CAAC;AAEnC,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;IAI9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAJ1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,YACmB,KAAK,EAAE,mBAAmB,GAAG,wBAAwB,EACrD,MAAM,CAAC,EAAE,cAAc,YAAA,EACxC,IAAI,GAAE,wBAA6B,EAIpC;YACa,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;;;;;;;;;YAyC7D,MAAM,EAAE,WAAW;YACnB,WAAW;;;OAyBlB;IACD,2EAA2E;IAC3E,KAAK,CACH,MAAM,EAAE,OAAO,gCAAgC,EAAE,4BAA4B,EAC7E,QAAQ,EAAE,UAAU,GAAG,UAAU,UAGlC;IACD,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"}

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

@@ -0,0 +1,136 @@
+import { DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES, DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY, parseTextActionProposalCommand, resolveTextActionProposalDecision, textActionProposalReply, } from './action-proposal-text.js';
+import { validateActionProposalListQuery } from './action-proposal-transitions.js';
+import { mayDecideApproval } from './spi/approval-policy.js';
+export class ActionProposalServiceError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+/** Authenticated decisions live independently of the origin runner and its signals. */
+export class ActionProposalService {
+    store;
+    policy;
+    vocabulary;
+    replies;
+    constructor(store, policy, text = {}) {
+        this.store = store;
+        this.policy = policy;
+        this.vocabulary = { ...DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY, ...text.vocabulary };
+        this.replies = { ...DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES, ...text.replies };
+    }
+    async scope(actor, threadId) {
+        const scope = await this.store.getThreadActionProposalScope(threadId);
+        if (!scope)
+            throw new ActionProposalServiceError(404, 'Unknown thread');
+        if ((actor.tenantRef ?? null) !== scope.tenantRef)
+            throw new ActionProposalServiceError(403, 'Forbidden tenant');
+        return scope;
+    }
+    async list(actor, threadId, after) {
+        return (await this.listPage(actor, threadId, after)).items;
+    }
+    async listPage(actor, threadId, after) {
+        const scope = await this.scope(actor, threadId);
+        const query = { limit: 1000, ...(after !== undefined ? { after } : {}) };
+        validateActionProposalListQuery(query);
+        const raw = await this.store.listActionProposals(scope, query);
+        const last = raw.at(-1);
+        const next = raw.length === 1000 && last ? { createdAt: last.createdAt, id: last.id } : undefined;
+        const permitted = actor.id === scope.actorRef
+            ? raw
+            : (await Promise.all(raw.map(async (proposal) => (await this.canDecide(actor, proposal)) ? proposal : null))).filter((proposal) => proposal !== null);
+        return { items: permitted, ...(next !== undefined ? { next } : {}) };
+    }
+    async handleTextDecision(actor, threadId, text) {
+        const command = parseTextActionProposalCommand(text, this.vocabulary);
+        if (command.status === 'unmatched')
+            return command;
+        if (command.proposalId !== undefined) {
+            // An `#ID` naming no proposal of this thread is an ordinary message, not a failed decision —
+            // the same answer the candidate resolver gives.
+            const scope = await this.scope(actor, threadId);
+            if (!(await this.store.getActionProposal(scope, command.proposalId)))
+                return { status: 'unmatched' };
+            const result = await this.decide(actor, threadId, command.proposalId, command.decision, { remember: command.remember }, 'text');
+            return {
+                threadId,
+                proposalDecision: result,
+                text: this.reply(result, command.decision),
+            };
+        }
+        const scope = await this.scope(actor, threadId);
+        const visible = await this.store.listActionProposals(scope, {
+            decision: 'pending',
+            limit: 1000,
+        });
+        const permitted = await Promise.all(visible.map(async (proposal) => ((await this.canDecide(actor, proposal)) ? proposal : null)));
+        const resolution = resolveTextActionProposalDecision(text, permitted.filter((proposal) => proposal !== null), this.vocabulary);
+        if (resolution.status === 'unmatched')
+            return resolution;
+        if (visible.length === 1000 && resolution.status === 'decision' && !text.includes('#'))
+            return {
+                threadId,
+                proposalDecision: {
+                    status: 'ambiguous',
+                    proposalIds: permitted
+                        .filter((proposal) => proposal !== null)
+                        .map((proposal) => proposal.id),
+                },
+                text: this.replies.tooMany,
+            };
+        if (resolution.status === 'ambiguous')
+            return {
+                threadId,
+                proposalDecision: resolution,
+                text: this.replies.ambiguous(resolution.proposalIds),
+            };
+        const result = await this.decide(actor, threadId, resolution.proposalId, resolution.decision, { remember: resolution.remember }, 'text');
+        return {
+            threadId,
+            proposalDecision: result,
+            text: this.reply(result, resolution.decision),
+        };
+    }
+    /** The configured reply to a decision the store answered with `result`. */
+    reply(result, decision) {
+        return textActionProposalReply(result, decision, this.replies);
+    }
+    canDecide(actor, proposal) {
+        return mayDecideApproval(this.policy, actor, {
+            toolCallId: proposal.originToolCallId,
+            approver: proposal.approver,
+            requesterRef: proposal.actorRef,
+        });
+    }
+    async decide(actor, threadId, proposalId, decision, body, via = 'web') {
+        if (!body || typeof body !== 'object' || Array.isArray(body))
+            throw new ActionProposalServiceError(400, 'Invalid decision body');
+        const fields = Object.keys(body);
+        if (fields.some((field) => !['remember', 'reason'].includes(field)))
+            throw new ActionProposalServiceError(400, 'Invalid decision fields');
+        const { remember, reason } = body;
+        if ((remember !== undefined && typeof remember !== 'boolean') ||
+            (reason !== undefined && typeof reason !== 'string'))
+            throw new ActionProposalServiceError(400, 'Invalid decision values');
+        const scope = await this.scope(actor, threadId);
+        const proposal = await this.store.getActionProposal(scope, proposalId);
+        if (!proposal)
+            throw new ActionProposalServiceError(404, 'Unknown proposal');
+        if (!(await mayDecideApproval(this.policy, actor, {
+            toolCallId: proposal.originToolCallId,
+            approver: proposal.approver,
+            requesterRef: proposal.actorRef,
+        })))
+            throw new ActionProposalServiceError(403, 'Forbidden decision');
+        return this.store.decideActionProposal(scope, proposalId, {
+            decision,
+            actorRef: actor.id,
+            via,
+            ...(typeof remember === 'boolean' ? { remember } : {}),
+            ...(typeof reason === 'string' ? { reason } : {}),
+        });
+    }
+}
+//# sourceMappingURL=action-proposal-service.js.map

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

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

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

@@ -0,0 +1,72 @@
+import type { ActionProposalDecision, ActionProposalMutationResult } from './spi/action-proposal-store.js';
+export interface TextActionProposalCandidate {
+    id: string;
+    decision: ActionProposalDecision;
+}
+export type TextActionProposalResolution = {
+    status: 'unmatched';
+} | {
+    status: 'ambiguous';
+    proposalIds: string[];
+} | {
+    status: 'decision';
+    proposalId: string;
+    decision: 'approved' | 'rejected';
+    remember: boolean;
+};
+/**
+ * Recognizes complete, explicit decision messages. This grants no authority: callers must
+ * resolve the authenticated actor and use the normal scoped decision service with via=text.
+ * Never feed model output here or consume an unmatched message as an approval.
+ */
+export declare function resolveTextActionProposalDecision(text: string, proposals: readonly TextActionProposalCandidate[], vocabulary?: TextActionProposalVocabulary): TextActionProposalResolution;
+export type TextActionProposalCommand = {
+    status: 'unmatched';
+} | {
+    status: 'command';
+    decision: 'approved' | 'rejected';
+    remember: boolean;
+    proposalId?: string;
+};
+/**
+ * The words a whole chat message must consist of to decide a proposal by text. Matched
+ * case-insensitively, as the complete message (an optional trailing `.`/`!`, an optional `#ID`).
+ */
+export interface TextActionProposalVocabulary {
+    /** Approve, e.g. `sim`, `yes`. */
+    approve: readonly string[];
+    /** Reject, e.g. `não`, `no`. */
+    reject: readonly string[];
+    /** The phrase after an approve word that also approves later calls of the tool in this thread. */
+    remember: readonly string[];
+}
+/** English. Portuguese ships as {@link ptBrActionProposalText}; any other language via config. */
+export declare const DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY: TextActionProposalVocabulary;
+/** What the agent answers to a text decision. Every field has an English default. */
+export interface TextActionProposalReplies {
+    approved: string;
+    rejected: string;
+    expired: string;
+    /** The proposal could not change (already decided by someone else, superseded, …). */
+    unchanged: string;
+    /** More than one pending proposal could be meant: ask for the `#ID`. */
+    ambiguous(proposalIds: readonly string[]): string;
+    /** Too many pending proposals to pick one without an explicit `#ID`. */
+    tooMany: string;
+}
+export declare const DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES: TextActionProposalReplies;
+/** `config/agent.ts`'s `actionProposalText`: either part replaces the default it names. */
+export interface TextActionProposalConfig {
+    vocabulary?: Partial<TextActionProposalVocabulary>;
+    replies?: Partial<TextActionProposalReplies>;
+}
+/** The reply to a decision the store answered with `result`. */
+export declare function textActionProposalReply(result: ActionProposalMutationResult, decision: 'approved' | 'rejected', replies?: TextActionProposalReplies): string;
+/** Parse exact consent syntax only. Authentication and target lookup remain the caller's responsibility. */
+export declare function parseTextActionProposalCommand(text: string, vocabulary?: TextActionProposalVocabulary): TextActionProposalCommand;
+/**
+ * Brazilian Portuguese text decisions — `config/agent.ts`: `actionProposalText: ptBrActionProposalText`.
+ * Commands in Portuguese (English ones still work), replies in Portuguese.
+ */
+export declare const ptBrActionProposalText: Required<TextActionProposalConfig>;
+//# sourceMappingURL=action-proposal-text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-text.d.ts","sourceRoot":"","sources":["../../src/action-proposal-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AACD,MAAM,MAAM,4BAA4B,GACpC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9C;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEN;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,2BAA2B,EAAE,EACjD,UAAU,CAAC,EAAE,4BAA4B,GACxC,4BAA4B,CAe9B;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kCAAkC;IAClC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,gCAAgC;IAChC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,kGAAkG;IAClG,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,kGAAkG;AAClG,eAAO,MAAM,uCAAuC,EAAE,4BAIrD,CAAC;AAEF,qFAAqF;AACrF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC;IAClD,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,oCAAoC,EAAE,yBAOlD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC9C;AAED,gEAAgE;AAChE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,4BAA4B,EACpC,QAAQ,EAAE,UAAU,GAAG,UAAU,EACjC,OAAO,GAAE,yBAAgE,GACxE,MAAM,CAQR;AAWD,4GAA4G;AAC5G,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,4BAAsE,GACjF,yBAAyB,CAsB3B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,wBAAwB,CA+BrE,CAAC"}

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

@@ -0,0 +1,119 @@
+/**
+ * Recognizes complete, explicit decision messages. This grants no authority: callers must
+ * resolve the authenticated actor and use the normal scoped decision service with via=text.
+ * Never feed model output here or consume an unmatched message as an approval.
+ */
+export function resolveTextActionProposalDecision(text, proposals, vocabulary) {
+    const command = parseTextActionProposalCommand(text, vocabulary);
+    if (command.status === 'unmatched')
+        return command;
+    const { decision, remember } = command;
+    const pending = proposals.filter((proposal) => proposal.decision === 'pending');
+    const explicitId = command.proposalId;
+    if (explicitId !== undefined) {
+        if (!pending.some((proposal) => proposal.id === explicitId))
+            return { status: 'unmatched' };
+        return { status: 'decision', proposalId: explicitId, decision, remember };
+    }
+    if (pending.length === 0)
+        return { status: 'unmatched' };
+    if (pending.length > 1)
+        return { status: 'ambiguous', proposalIds: pending.map(({ id }) => id) };
+    const candidate = pending[0];
+    if (!candidate)
+        return { status: 'unmatched' };
+    return { status: 'decision', proposalId: candidate.id, decision, remember };
+}
+/** English. Portuguese ships as {@link ptBrActionProposalText}; any other language via config. */
+export const DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY = {
+    approve: ['yes', 'confirm', 'approve', 'approved', 'ok'],
+    reject: ['no', 'cancel', 'reject', 'deny'],
+    remember: ['always in this conversation'],
+};
+export const DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES = {
+    approved: 'Proposal approved and queued to run.',
+    rejected: 'Proposal rejected; nothing was run.',
+    expired: 'The proposal expired; nothing was run.',
+    unchanged: 'This proposal could not be changed; refresh the list to see where it stands.',
+    ambiguous: (ids) => `Which proposal? Reply confirm #ID or cancel #ID: ${ids.join(', ')}`,
+    tooMany: 'There are several proposals. Confirm or reject one with an explicit #ID.',
+};
+/** The reply to a decision the store answered with `result`. */
+export function textActionProposalReply(result, decision, replies = DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES) {
+    return result.status === 'expired' || result.proposal?.decision === 'expired'
+        ? replies.expired
+        : result.status === 'applied' || result.status === 'unchanged'
+            ? decision === 'approved'
+                ? replies.approved
+                : replies.rejected
+            : replies.unchanged;
+}
+const escapeRegExp = (word) => word.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const alternatives = (words) => words
+    .map((word) => word.trim())
+    .filter((word) => word.length > 0)
+    .map((word) => escapeRegExp(word).replace(/\s+/g, '\\s+'))
+    .join('|');
+const fold = (word) => word.trim().toLowerCase();
+/** Parse exact consent syntax only. Authentication and target lookup remain the caller's responsibility. */
+export function parseTextActionProposalCommand(text, vocabulary = DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY) {
+    if (/[\r\n]/u.test(text))
+        return { status: 'unmatched' };
+    const verbs = alternatives([...vocabulary.approve, ...vocabulary.reject]);
+    if (verbs.length === 0)
+        return { status: 'unmatched' };
+    const remember = alternatives(vocabulary.remember);
+    const match = new RegExp(`^(${verbs})${remember.length > 0 ? `(?: (${remember}))?` : '()'}(?: #([^\\s]+?))?[.!]?$`, 'iu').exec(text.trim());
+    if (!match)
+        return { status: 'unmatched' };
+    const verb = match[1] === undefined ? undefined : fold(match[1]);
+    if (verb === undefined)
+        return { status: 'unmatched' };
+    // A word on both lists is read as a refusal: never infer consent from an ambiguous word.
+    const decision = vocabulary.reject.some((word) => fold(word) === verb) ? 'rejected' : 'approved';
+    const remembers = match[2] !== undefined && match[2] !== '';
+    if (remembers && decision !== 'approved')
+        return { status: 'unmatched' };
+    return {
+        status: 'command',
+        decision,
+        remember: remembers,
+        ...(match[3] !== undefined ? { proposalId: match[3] } : {}),
+    };
+}
+/**
+ * Brazilian Portuguese text decisions — `config/agent.ts`: `actionProposalText: ptBrActionProposalText`.
+ * Commands in Portuguese (English ones still work), replies in Portuguese.
+ */
+export const ptBrActionProposalText = {
+    vocabulary: {
+        approve: [
+            'sim',
+            'confirmo',
+            'confirmar',
+            'aprovar',
+            'aprovo',
+            'pode',
+            ...DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY.approve,
+        ],
+        reject: [
+            'não',
+            'nao',
+            'cancelar',
+            'cancela',
+            'rejeitar',
+            'rejeito',
+            ...DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY.reject,
+        ],
+        remember: ['sempre nesta conversa', ...DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY.remember],
+    },
+    replies: {
+        approved: 'Proposta aprovada e enfileirada para execução.',
+        rejected: 'Proposta rejeitada; nenhuma ação foi executada.',
+        expired: 'A proposta expirou; nenhuma ação foi executada.',
+        unchanged: 'Não foi possível alterar esta proposta; atualize a lista para consultar seu estado.',
+        ambiguous: (ids) => `Qual proposta? Responda confirmar #ID ou cancelar #ID: ${ids.join(', ')}`,
+        tooMany: 'Há várias propostas. Confirme ou rejeite usando #ID explícito.',
+    },
+};
+//# sourceMappingURL=action-proposal-text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-text.js","sourceRoot":"","sources":["../../src/action-proposal-text.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAC/C,IAAY,EACZ,SAAiD,EACjD,UAAyC;IAEzC,MAAM,OAAO,GAAG,8BAA8B,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,OAAO,CAAC;IACnD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAChF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,UAAU,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC5F,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACjG,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC/C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC9E,CAAC;AAwBD,kGAAkG;AAClG,MAAM,CAAC,MAAM,uCAAuC,GAAiC;IACnF,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC;IACxD,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,6BAA6B,CAAC;CAC1C,CAAC;AAeF,MAAM,CAAC,MAAM,oCAAoC,GAA8B;IAC7E,QAAQ,EAAE,sCAAsC;IAChD,QAAQ,EAAE,qCAAqC;IAC/C,OAAO,EAAE,wCAAwC;IACjD,SAAS,EAAE,8EAA8E;IACzF,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,oDAAoD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IACxF,OAAO,EAAE,0EAA0E;CACpF,CAAC;AAQF,gEAAgE;AAChE,MAAM,UAAU,uBAAuB,CACrC,MAAoC,EACpC,QAAiC,EACjC,OAAO,GAA8B,oCAAoC;IAEzE,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,KAAK,SAAS;QAC3E,CAAC,CAAC,OAAO,CAAC,OAAO;QACjB,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;YAC5D,CAAC,CAAC,QAAQ,KAAK,UAAU;gBACvB,CAAC,CAAC,OAAO,CAAC,QAAQ;gBAClB,CAAC,CAAC,OAAO,CAAC,QAAQ;YACpB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;AAC1B,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACnF,MAAM,YAAY,GAAG,CAAC,KAAwB,EAAE,EAAE,CAChD,KAAK;KACF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;KACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAEzD,4GAA4G;AAC5G,MAAM,UAAU,8BAA8B,CAC5C,IAAY,EACZ,UAAU,GAAiC,uCAAuC;IAElF,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,MAAM,CACtB,KAAK,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,QAAQ,KAAK,CAAC,CAAC,CAAC,IAAI,yBAAyB,EACzF,IAAI,CACL,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpB,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACvD,yFAAyF;IACzF,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IACjG,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;IAC5D,IAAI,SAAS,IAAI,QAAQ,KAAK,UAAU;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACzE,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,QAAQ;QACR,QAAQ,EAAE,SAAS;QACnB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACxE,UAAU,EAAE;QACV,OAAO,EAAE;YACP,KAAK;YACL,UAAU;YACV,WAAW;YACX,SAAS;YACT,QAAQ;YACR,MAAM;YACN,GAAG,uCAAuC,CAAC,OAAO;SACnD;QACD,MAAM,EAAE;YACN,KAAK;YACL,KAAK;YACL,UAAU;YACV,SAAS;YACT,UAAU;YACV,SAAS;YACT,GAAG,uCAAuC,CAAC,MAAM;SAClD;QACD,QAAQ,EAAE,CAAC,uBAAuB,EAAE,GAAG,uCAAuC,CAAC,QAAQ,CAAC;KACzF;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,gDAAgD;QAC1D,QAAQ,EAAE,iDAAiD;QAC3D,OAAO,EAAE,iDAAiD;QAC1D,SAAS,EACP,qFAAqF;QACvF,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,0DAA0D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC9F,OAAO,EAAE,gEAAgE;KAC1E;CACF,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { ActionProposal, ActionProposalDecisionCommand, ActionProposalMutationResult, ActionProposalScope, ClaimActionProposal, CreateActionProposal, ExtendActionProposalLease, ListActionProposals, SettleActionProposal } from './spi/action-proposal-store.js';
+export declare function validateActionProposalCreation(input: CreateActionProposal): void;
+export declare function validateActionProposalListQuery(query?: ListActionProposals): number;
+/** Canonical JSON snapshots keep replay equality independent of object key insertion order. */
+export declare function canonicalActionProposalJson(value: unknown): string;
+export declare function snapshotActionProposal<T>(value: T): T;
+export declare function actionProposalScopeMatches(row: ActionProposalScope, scope: ActionProposalScope): boolean;
+export declare function initialActionProposal(input: CreateActionProposal, now: number): ActionProposal;
+export declare function actionProposalCreationMatches(row: ActionProposal, input: CreateActionProposal): boolean;
+export declare function transitionActionProposalDecision(row: ActionProposal, command: ActionProposalDecisionCommand, now: number): ActionProposalMutationResult;
+export declare function transitionActionProposalClaim(row: ActionProposal, command: ClaimActionProposal, now: number, token: string): ActionProposalMutationResult;
+export declare function transitionActionProposalLease(row: ActionProposal, command: ExtendActionProposalLease, now: number): ActionProposalMutationResult;
+export declare function transitionActionProposalSettlement(row: ActionProposal, command: SettleActionProposal, now: number): ActionProposalMutationResult;
+/** Caller must obtain the replacement through the same full scope and persistence authority. */
+export declare function transitionActionProposalSupersession(row: ActionProposal, replacement: ActionProposal, command: {
+    replacementProposalId: string;
+    actorRef: string;
+    via: string;
+}, now: number): ActionProposalMutationResult;
+//# sourceMappingURL=action-proposal-transitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-transitions.d.ts","sourceRoot":"","sources":["../../src/action-proposal-transitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAWxC,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAmEhF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,GAAE,mBAAwB,GAAG,MAAM,CAuBvF;AAED,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsBlE;AACD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAErD;AACD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAMT;AACD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAW9F;AACD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAcT;AAOD,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,6BAA6B,EACtC,GAAG,EAAE,MAAM,GACV,4BAA4B,CA2C9B;AAMD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,mBAAmB,EAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,4BAA4B,CAqB9B;AAsBD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,yBAAyB,EAClC,GAAG,EAAE,MAAM,GACV,4BAA4B,CAY9B;AACD,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,MAAM,GACV,4BAA4B,CA2B9B;AAED,gGAAgG;AAChG,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE;IAAE,qBAAqB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACzE,GAAG,EAAE,MAAM,GACV,4BAA4B,CAuC9B"}