@adonis-agora/agent 0.60.1 → 0.62.0

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

@@ -0,0 +1,311 @@
+import { attachActionProposalOutcome } from './action-proposal-outcome.js';
+import { validateUiCapabilities } from './ui-capabilities.js';
+function checkTime(value) {
+    if (!Number.isSafeInteger(value))
+        throw new RangeError('Action proposal timestamps must be safe integer milliseconds');
+}
+function checkString(value) {
+    if (typeof value !== 'string' || value.length === 0)
+        throw new TypeError('Action proposal identifiers must be nonempty strings');
+}
+export function validateActionProposalCreation(input) {
+    const allowed = [
+        'id',
+        'tenantRef',
+        'actorRef',
+        'threadId',
+        'originRunId',
+        'originMessageId',
+        'originToolCallId',
+        'toolName',
+        'input',
+        'preparationInput',
+        'executionContext',
+        'confirmation',
+        'approver',
+        'expiresAt',
+        'idempotencyKey',
+        'replacementKey',
+    ];
+    if (Object.keys(input).some((key) => !allowed.includes(key)))
+        throw new TypeError('Unknown action proposal creation field');
+    for (const key of [
+        'id',
+        'actorRef',
+        'threadId',
+        'originRunId',
+        'originMessageId',
+        'originToolCallId',
+        'toolName',
+        'approver',
+        'idempotencyKey',
+    ])
+        checkString(input[key]);
+    if (input.tenantRef !== null && typeof input.tenantRef !== 'string')
+        throw new TypeError('tenantRef must be an explicit string or null');
+    for (const value of [input.id, input.actorRef, input.threadId, input.tenantRef]) {
+        if (value !== null && value.length > 255)
+            throw new RangeError('Action proposal id and scope must fit 255 UTF-16 code units');
+    }
+    if (input.replacementKey !== undefined) {
+        checkString(input.replacementKey);
+        if (input.replacementKey.length > 255)
+            throw new RangeError('replacementKey must fit 255 UTF-16 code units');
+    }
+    if (Object.hasOwn(input, 'executionContext')) {
+        const context = input.executionContext;
+        if (context === null || typeof context !== 'object' || Array.isArray(context))
+            throw new TypeError('executionContext must be a JSON object');
+        const allowedContext = ['agentName', 'persona', 'requestId', 'pageContext', 'uiCapabilities'];
+        if (Object.keys(context).some((key) => !allowedContext.includes(key)))
+            throw new TypeError('Unknown execution context field');
+        checkString(context.requestId);
+        if (Object.hasOwn(context, 'uiCapabilities'))
+            validateUiCapabilities(context.uiCapabilities);
+        if (Object.hasOwn(context, 'agentName'))
+            checkString(context.agentName);
+        if (Object.hasOwn(context, 'persona'))
+            checkString(context.persona);
+        if (Object.hasOwn(context, 'pageContext')) {
+            const page = context.pageContext;
+            if (page === null || typeof page !== 'object' || Array.isArray(page))
+                throw new TypeError('pageContext must be a JSON object');
+            if (Object.hasOwn(page, 'kind') && typeof page.kind !== 'string')
+                throw new TypeError('pageContext.kind must be a string');
+        }
+    }
+    if (input.expiresAt !== null)
+        checkTime(input.expiresAt);
+    checkString(input.confirmation?.title);
+    checkString(input.confirmation?.verb);
+    canonicalActionProposalJson(input);
+}
+export function validateActionProposalListQuery(query = {}) {
+    const limit = query.limit === undefined ? 100 : query.limit;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 1000)
+        throw new RangeError('limit must be an integer from 1 to 1000');
+    if (query.decision !== undefined &&
+        !['pending', 'approved', 'rejected', 'expired', 'superseded'].includes(query.decision))
+        throw new TypeError('Unsupported action proposal list decision');
+    if (query.after !== undefined) {
+        const after = query.after;
+        if (typeof after !== 'object' ||
+            after === null ||
+            Array.isArray(after) ||
+            Object.keys(after).some((key) => key !== 'createdAt' && key !== 'id'))
+            throw new TypeError('Invalid action proposal cursor');
+        checkTime(after.createdAt);
+        checkString(after.id);
+        if (after.id.length > 255)
+            throw new TypeError('Action proposal cursor id is too long');
+    }
+    return limit;
+}
+/** Canonical JSON snapshots keep replay equality independent of object key insertion order. */
+export function canonicalActionProposalJson(value) {
+    const ancestors = new Set();
+    const sort = (item) => {
+        if (item === null || typeof item === 'string' || typeof item === 'boolean')
+            return item;
+        if (typeof item === 'number' && Number.isFinite(item))
+            return item;
+        if (typeof item !== 'object' || item === null || ancestors.has(item))
+            throw new TypeError('Action proposals require finite, acyclic JSON values');
+        const prototype = Object.getPrototypeOf(item);
+        if (!Array.isArray(item) && prototype !== Object.prototype && prototype !== null)
+            throw new TypeError('Action proposals require plain JSON objects');
+        ancestors.add(item);
+        const sorted = Array.isArray(item)
+            ? Array.from(item, sort)
+            : Object.fromEntries(Object.keys(item)
+                .sort()
+                .map((key) => [key, sort(item[key])]));
+        ancestors.delete(item);
+        return sorted;
+    };
+    return JSON.stringify(sort(value));
+}
+export function snapshotActionProposal(value) {
+    return JSON.parse(canonicalActionProposalJson(value));
+}
+export function actionProposalScopeMatches(row, scope) {
+    return (row.tenantRef === scope.tenantRef &&
+        row.actorRef === scope.actorRef &&
+        row.threadId === scope.threadId);
+}
+export function initialActionProposal(input, now) {
+    validateActionProposalCreation(input);
+    checkTime(now);
+    return snapshotActionProposal({
+        ...input,
+        decision: 'pending',
+        decisionAudit: null,
+        execution: null,
+        createdAt: now,
+        updatedAt: now,
+    });
+}
+export function actionProposalCreationMatches(row, input) {
+    validateActionProposalCreation(input);
+    const { decision: _decision, decisionAudit: _audit, execution: _execution, createdAt: _created, updatedAt: _updated, supersededBy: _supersededBy, outcome: _outcome, outcomeDelivery: _delivery, ...original } = row;
+    return canonicalActionProposalJson(original) === canonicalActionProposalJson(input);
+}
+function result(status, proposal) {
+    return { status, proposal: snapshotActionProposal(proposal) };
+}
+export function transitionActionProposalDecision(row, command, now) {
+    checkTime(now);
+    if (!['approved', 'rejected', 'expired'].includes(command.decision))
+        throw new TypeError('Unsupported action proposal decision');
+    checkString(command.actorRef);
+    checkString(command.via);
+    if (command.reason !== undefined && typeof command.reason !== 'string')
+        throw new TypeError('reason must be a string');
+    if (command.remember !== undefined && typeof command.remember !== 'boolean')
+        throw new TypeError('remember must be a boolean');
+    if (row.decision !== 'pending') {
+        return result(row.decision === command.decision
+            ? 'unchanged'
+            : row.decision === 'expired'
+                ? 'expired'
+                : 'conflict', row);
+    }
+    const next = snapshotActionProposal(row);
+    if (row.expiresAt !== null && now >= row.expiresAt) {
+        next.decision = 'expired';
+        next.decisionAudit = { actorRef: 'system', via: 'expiry', at: now };
+        next.updatedAt = now;
+        return result(command.decision === 'expired' ? 'applied' : 'expired', attachActionProposalOutcome(next, now));
+    }
+    if (command.decision === 'expired')
+        return result('conflict', row);
+    const { decision, ...audit } = command;
+    next.decision = decision;
+    next.decisionAudit = {
+        actorRef: audit.actorRef,
+        via: audit.via,
+        at: now,
+        ...(audit.reason === undefined ? {} : { reason: audit.reason }),
+        ...(audit.remember === undefined ? {} : { remember: audit.remember }),
+    };
+    next.updatedAt = now;
+    if (decision === 'approved')
+        next.execution = { status: 'queued', generation: 0, lease: null };
+    return result('applied', decision === 'approved' ? next : attachActionProposalOutcome(next, now));
+}
+function checkLeaseMs(leaseMs, now) {
+    checkTime(now);
+    if (!Number.isSafeInteger(leaseMs) || leaseMs <= 0 || !Number.isSafeInteger(now + leaseMs))
+        throw new RangeError('leaseMs must be finite and positive');
+}
+export function transitionActionProposalClaim(row, command, now, token) {
+    checkLeaseMs(command.leaseMs, now);
+    checkString(command.workerId);
+    checkString(token);
+    const execution = row.execution;
+    if (row.decision !== 'approved' ||
+        !execution ||
+        (execution.status !== 'queued' &&
+            !(execution.status === 'executing' && execution.lease && now >= execution.lease.expiresAt)))
+        return result('conflict', row);
+    const next = snapshotActionProposal(row);
+    const generation = execution.generation + 1;
+    next.execution = {
+        status: 'executing',
+        generation,
+        lease: { token, generation, workerId: command.workerId, expiresAt: now + command.leaseMs },
+    };
+    next.updatedAt = now;
+    return result('applied', next);
+}
+function leaseStatus(row, command, now) {
+    checkTime(now);
+    checkString(command.token);
+    if (!Number.isSafeInteger(command.generation) || command.generation < 1)
+        throw new RangeError('Invalid lease generation');
+    const work = row.execution;
+    if (row.decision !== 'approved' ||
+        work?.status !== 'executing' ||
+        !work.lease ||
+        work.generation !== command.generation ||
+        work.lease.generation !== command.generation ||
+        work.lease.token !== command.token)
+        return 'conflict';
+    return now >= work.lease.expiresAt ? 'expired' : 'valid';
+}
+export function transitionActionProposalLease(row, command, now) {
+    checkLeaseMs(command.leaseMs, now);
+    const status = leaseStatus(row, command, now);
+    if (status !== 'valid')
+        return result(status, row);
+    const next = snapshotActionProposal(row);
+    if (next.execution?.lease)
+        next.execution.lease.expiresAt = Math.max(next.execution.lease.expiresAt, now + command.leaseMs);
+    next.updatedAt = now;
+    return result('applied', next);
+}
+export function transitionActionProposalSettlement(row, command, now) {
+    checkTime(now);
+    if (command.status !== 'succeeded' && command.status !== 'failed')
+        throw new TypeError('Unsupported settlement status');
+    if ((command.status === 'succeeded' && command.error !== undefined) ||
+        (command.status === 'failed' &&
+            (typeof command.error !== 'string' || command.result !== undefined)))
+        throw new TypeError('Ambiguous action proposal settlement');
+    const status = leaseStatus(row, command, now);
+    if (status !== 'valid')
+        return result(status, row);
+    const next = snapshotActionProposal(row);
+    next.execution =
+        command.status === 'succeeded'
+            ? {
+                status: 'succeeded',
+                generation: command.generation,
+                lease: null,
+                ...(command.result === undefined ? {} : { result: command.result }),
+            }
+            : { status: 'failed', generation: command.generation, lease: null, error: command.error };
+    if (command.ui !== undefined)
+        canonicalActionProposalJson(command.ui);
+    if (command.text !== undefined && typeof command.text !== 'string')
+        throw new TypeError('Outcome text must be a string');
+    next.updatedAt = now;
+    return result('applied', attachActionProposalOutcome(next, now, command.ui, command.text));
+}
+/** Caller must obtain the replacement through the same full scope and persistence authority. */
+export function transitionActionProposalSupersession(row, replacement, command, now) {
+    checkTime(now);
+    checkString(command.replacementProposalId);
+    checkString(command.actorRef);
+    checkString(command.via);
+    if (replacement.id !== command.replacementProposalId ||
+        row.id === replacement.id ||
+        !actionProposalScopeMatches(row, replacement) ||
+        row.toolName !== replacement.toolName ||
+        !row.replacementKey ||
+        row.replacementKey !== replacement.replacementKey)
+        return result('conflict', row);
+    if (row.decision === 'superseded')
+        return result(row.supersededBy === replacement.id ? 'unchanged' : 'conflict', row);
+    if (row.decision !== 'pending')
+        return result('conflict', row);
+    if (row.expiresAt !== null && now >= row.expiresAt)
+        return {
+            ...transitionActionProposalDecision(row, { decision: 'expired', actorRef: 'system', via: 'expiry' }, now),
+            status: 'expired',
+        };
+    const next = snapshotActionProposal({
+        ...row,
+        decision: 'superseded',
+        supersededBy: replacement.id,
+        decisionAudit: {
+            actorRef: command.actorRef,
+            via: command.via,
+            replacementProposalId: replacement.id,
+            at: now,
+        },
+        updatedAt: now,
+    });
+    return result('applied', attachActionProposalOutcome(next, now));
+}
+//# sourceMappingURL=action-proposal-transitions.js.map

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

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

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

@@ -0,0 +1,32 @@
+import type { ActionProposalExecutor } from './action-proposal-executor.js';
+import type { ActionProposalOutcomeStore } from './spi/action-proposal-outcome-store.js';
+import type { ActionProposal, ActionProposalStore } from './spi/action-proposal-store.js';
+import type { ActionProposalWorkerStore } from './spi/action-proposal-worker-store.js';
+export interface ActionProposalWorkerOptions {
+    store: ActionProposalStore & ActionProposalWorkerStore & ActionProposalOutcomeStore;
+    executor: ActionProposalExecutor;
+    workerId: string;
+    pollIntervalMs?: number;
+    leaseMs?: number;
+    maxConcurrency?: number;
+    onError?(error: unknown): void;
+    /** After a proposal's execution settled (succeeded or failed). A throw goes to `onError`. */
+    onSettled?(proposal: ActionProposal): void | Promise<void>;
+}
+export declare class ActionProposalWorker {
+    private readonly options;
+    private readonly leaseMs;
+    private readonly pollIntervalMs;
+    private readonly maxConcurrency;
+    private timer?;
+    private stopped;
+    private readonly renewals;
+    private active;
+    constructor(options: ActionProposalWorkerOptions);
+    start(): void;
+    stop(): Promise<void>;
+    runOnce(): Promise<void>;
+    private tick;
+    private execute;
+}
+//# sourceMappingURL=action-proposal-worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-proposal-worker.d.ts","sourceRoot":"","sources":["../../src/action-proposal-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,mBAAmB,GAAG,yBAAyB,GAAG,0BAA0B,CAAC;IACpF,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,6FAA6F;IAC7F,SAAS,CAAC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AACD,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IACtE,OAAO,CAAC,MAAM,CAA4B;IAC1C,YAA6B,OAAO,EAAE,2BAA2B,EAUhE;IACD,KAAK,IAAI,IAAI,CAYZ;IACK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1B;IACD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvB;YACa,IAAI;YAqBJ,OAAO;CAoDtB"}

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

@@ -0,0 +1,140 @@
+export class ActionProposalWorker {
+    options;
+    leaseMs;
+    pollIntervalMs;
+    maxConcurrency;
+    timer;
+    stopped = false;
+    renewals = new Set();
+    active;
+    constructor(options) {
+        this.options = options;
+        this.leaseMs = options.leaseMs ?? 30000;
+        this.pollIntervalMs = options.pollIntervalMs ?? 1000;
+        this.maxConcurrency = options.maxConcurrency ?? 1;
+        for (const value of [this.leaseMs, this.pollIntervalMs, this.maxConcurrency])
+            if (!Number.isSafeInteger(value) || value <= 0)
+                throw new RangeError('Worker configuration must be positive safe integers');
+        if (this.pollIntervalMs >= this.leaseMs / 3)
+            throw new RangeError('Worker poll interval must be below one third of lease');
+        if (!options.workerId)
+            throw new TypeError('workerId is required');
+    }
+    start() {
+        if (this.timer !== undefined || this.stopped)
+            return;
+        const tick = async () => {
+            if (this.stopped)
+                return;
+            try {
+                await this.runOnce();
+            }
+            catch (error) {
+                this.options.onError?.(error);
+            }
+            if (!this.stopped)
+                this.timer = setTimeout(tick, this.pollIntervalMs);
+        };
+        this.timer = setTimeout(tick, 0);
+    }
+    async stop() {
+        this.stopped = true;
+        for (const timer of this.renewals)
+            clearInterval(timer);
+        this.renewals.clear();
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        await this.active;
+    }
+    runOnce() {
+        if (this.active)
+            return this.active;
+        if (this.stopped)
+            return Promise.resolve();
+        const task = this.tick();
+        this.active = task;
+        return task.finally(() => {
+            if (this.active === task)
+                this.active = undefined;
+        });
+    }
+    async tick() {
+        await this.options.store.expireActionProposals({ limit: 100 });
+        const work = [];
+        for (let index = 0; index < this.maxConcurrency && !this.stopped; index++) {
+            const proposal = await this.options.store.claimNextActionProposal({
+                workerId: this.options.workerId,
+                leaseMs: this.leaseMs,
+            });
+            if (!proposal)
+                break;
+            work.push(this.execute(proposal));
+        }
+        await Promise.all(work);
+        for (let index = 0; index < 32 && !this.stopped; index++) {
+            const delivery = await this.options.store.claimNextActionProposalOutcome({
+                workerId: this.options.workerId,
+                leaseMs: this.leaseMs,
+            });
+            if (!delivery)
+                break;
+            await this.options.store.admitActionProposalOutcome(delivery.lease);
+        }
+    }
+    async execute(proposal) {
+        const lease = proposal.execution?.lease;
+        if (!lease)
+            throw new Error('Claimed action lacks execution lease');
+        let fenced = true;
+        let renewing;
+        const renew = () => {
+            if (renewing || !fenced)
+                return;
+            renewing = this.options.store
+                .extendActionProposalLease(proposal, proposal.id, {
+                token: lease.token,
+                generation: lease.generation,
+                leaseMs: this.leaseMs,
+            })
+                .then((result) => {
+                if (result.status !== 'applied')
+                    fenced = false;
+            }, (error) => {
+                fenced = false;
+                this.options.onError?.(error);
+            })
+                .finally(() => {
+                renewing = undefined;
+            });
+        };
+        const timer = setInterval(renew, this.leaseMs / 3);
+        this.renewals.add(timer);
+        try {
+            const result = await this.options.executor.execute(proposal);
+            clearInterval(timer);
+            await renewing;
+            if (!fenced)
+                return;
+            const settled = await this.options.store.settleActionProposal(proposal, proposal.id, {
+                ...result,
+                token: lease.token,
+                generation: lease.generation,
+            });
+            if (settled.status === 'applied' && settled.proposal) {
+                try {
+                    await this.options.onSettled?.(settled.proposal);
+                }
+                catch (error) {
+                    // The settlement is already committed: a broken listener must not fail the tick.
+                    this.options.onError?.(error);
+                }
+            }
+        }
+        finally {
+            clearInterval(timer);
+            this.renewals.delete(timer);
+            await renewing;
+        }
+    }
+}
+//# sourceMappingURL=action-proposal-worker.js.map

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

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

package/dist/src/ag-ui/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/adapter.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,4BAA4B,CAAC;AAIvF,MAAM,WAAW,kBAAkB;IACjC,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CA+I7E"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,4BAA4B,CAAC;AAiBvF,MAAM,WAAW,kBAAkB;IACjC,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CA0L7E"}