@dsh-enhanced/assistant-automations 0.1.3

package/lib/coordinator.js

@@ -0,0 +1,374 @@
+import { AutomationStoreError } from './store.js';
+export class AutomationRunnerAmbiguousError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AutomationRunnerAmbiguousError';
+    }
+}
+function sessionId(task) {
+    return `automation-${task.occurrenceId}-${task.attemptCount + 1}`;
+}
+function preview(value, maximumBytes = 8_192) {
+    const bytes = Buffer.from(value, 'utf8');
+    if (bytes.byteLength <= maximumBytes)
+        return value;
+    return bytes.subarray(0, maximumBytes).toString('utf8').replace(/\uFFFD$/u, '');
+}
+function boundedText(value, maximumBytes) {
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.normalize('NFC').trim();
+    if (normalized === '' || Buffer.byteLength(normalized, 'utf8') > maximumBytes)
+        return undefined;
+    return normalized;
+}
+const exposureReceiptTimeoutMs = 2_000;
+export class AutomationCoordinator {
+    store;
+    artifacts;
+    runner;
+    ownerId;
+    now;
+    dutyLeaseMs;
+    taskLeaseMs;
+    misfireGraceMs;
+    maxCatchUp;
+    maxConcurrency;
+    tickIntervalMs;
+    active = new Map();
+    delivery;
+    outcomeRecorder;
+    fencingToken;
+    timer;
+    stopped = false;
+    constructor(options) {
+        if (!Number.isSafeInteger(options.maxConcurrency) || options.maxConcurrency <= 0 || options.maxConcurrency > 100) {
+            throw new Error('assistant-automations: maxConcurrency must be between 1 and 100');
+        }
+        this.store = options.store;
+        this.artifacts = options.artifacts;
+        this.runner = options.runner;
+        this.ownerId = options.ownerId;
+        this.now = options.now ?? Date.now;
+        this.dutyLeaseMs = options.dutyLeaseMs;
+        this.taskLeaseMs = options.taskLeaseMs;
+        this.misfireGraceMs = options.misfireGraceMs;
+        this.maxCatchUp = options.maxCatchUp;
+        this.maxConcurrency = options.maxConcurrency;
+        this.tickIntervalMs = options.tickIntervalMs ?? Math.max(1_000, Math.floor(options.dutyLeaseMs / 3));
+    }
+    start() {
+        if (this.stopped)
+            throw new Error('assistant-automations coordinator is stopped');
+        if (this.timer !== undefined)
+            return;
+        this.timer = setInterval(() => void this.tick().catch(() => { }), this.tickIntervalMs);
+        this.timer.unref?.();
+        void this.tick().catch(() => { });
+    }
+    async tick() {
+        if (this.stopped)
+            throw new Error('assistant-automations coordinator is stopped');
+        const now = this.now();
+        if (!this.ensureDuty(now))
+            return;
+        this.dispatchPendingEvidence();
+        this.dispatchPendingDeliveries();
+        this.store.recoverExpiredTasks({ now, limit: this.maxCatchUp });
+        this.store.materializeDue({ now, misfireGraceMs: this.misfireGraceMs, maxCatchUp: this.maxCatchUp });
+        while (this.active.size < this.maxConcurrency) {
+            const claimed = this.store.claimNextTask({
+                ownerId: this.ownerId,
+                fencingToken: this.fencingToken,
+                now,
+                leaseMs: this.taskLeaseMs,
+            });
+            if (claimed === undefined)
+                break;
+            if (claimed.status !== 'claimed')
+                continue;
+            this.abortRequestedActive();
+            this.launch(claimed);
+        }
+    }
+    setDeliveryDispatcher(delivery) {
+        this.delivery = delivery;
+    }
+    /**
+     * Attach an optional sink for finished-run outcomes.
+     *
+     * Kept optional and one-way so the scheduler never depends on a learning
+     * plugin: if no recorder is attached, or the recorder throws, runs proceed
+     * unchanged. Evidence collection must never be able to break execution.
+     */
+    setOutcomeRecorder(recorder) {
+        this.outcomeRecorder = recorder;
+    }
+    async whenIdle() {
+        while (this.active.size > 0) {
+            await Promise.all([...this.active.values()].map(value => value.promise));
+        }
+    }
+    async cancel(taskId) {
+        this.store.requestCancellation({ taskId, now: this.now() });
+        this.active.get(taskId)?.controller.abort('cancel-requested');
+    }
+    async stop() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        if (this.timer !== undefined) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        for (const value of this.active.values())
+            value.controller.abort('coordinator-stop');
+        await this.whenIdle();
+    }
+    ensureDuty(now) {
+        if (this.fencingToken !== undefined) {
+            try {
+                const renewed = this.store.renewDuty({
+                    ownerId: this.ownerId,
+                    fencingToken: this.fencingToken,
+                    now,
+                    leaseMs: this.dutyLeaseMs,
+                });
+                return renewed.acquired;
+            }
+            catch (error) {
+                if (!(error instanceof AutomationStoreError) || error.code !== 'stale-fence')
+                    throw error;
+                this.fencingToken = undefined;
+            }
+        }
+        const acquired = this.store.acquireDuty({ ownerId: this.ownerId, now, leaseMs: this.dutyLeaseMs });
+        if (acquired.acquired)
+            this.fencingToken = acquired.fencingToken;
+        return acquired.acquired;
+    }
+    launch(claimed) {
+        const controller = new AbortController();
+        const promise = this.execute(claimed, controller).finally(() => this.active.delete(claimed.id));
+        this.active.set(claimed.id, { controller, promise });
+        void promise.catch(() => { });
+    }
+    abortRequestedActive() {
+        for (const [taskId, value] of this.active) {
+            if (this.store.getTaskRecord(taskId)?.cancelRequested === true)
+                value.controller.abort('cancel-previous');
+        }
+    }
+    async execute(claimed, controller) {
+        const automation = this.store.get(claimed.automationId);
+        const occurrence = this.store.getOccurrence(claimed.occurrenceId);
+        if (automation === undefined || occurrence === undefined || this.fencingToken === undefined) {
+            throw new Error('assistant-automations: claimed task snapshot is missing');
+        }
+        const fence = this.fencingToken;
+        const freshSessionId = sessionId(claimed);
+        const started = this.store.startTask({
+            taskId: claimed.id,
+            ownerId: this.ownerId,
+            fencingToken: fence,
+            now: this.now(),
+            leaseMs: this.taskLeaseMs,
+            sessionId: freshSessionId,
+        });
+        let timedOut = false;
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            controller.abort('timeout');
+        }, automation.definition.timeoutMs);
+        timeout.unref?.();
+        const heartbeat = setInterval(() => {
+            try {
+                const now = this.now();
+                this.store.renewDuty({
+                    ownerId: this.ownerId,
+                    fencingToken: fence,
+                    now,
+                    leaseMs: this.dutyLeaseMs,
+                });
+                this.store.heartbeatTask({
+                    taskId: started.id,
+                    ownerId: this.ownerId,
+                    fencingToken: fence,
+                    now,
+                    leaseMs: this.taskLeaseMs,
+                });
+            }
+            catch {
+                controller.abort('lease-lost');
+            }
+        }, Math.max(250, Math.floor(Math.min(this.dutyLeaseMs, this.taskLeaseMs) / 3)));
+        heartbeat.unref?.();
+        let result;
+        try {
+            result = await this.runner.run({
+                automation,
+                occurrence,
+                task: started,
+                sessionId: freshSessionId,
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            result = {
+                outcome: controller.signal.aborted
+                    ? 'cancelled'
+                    : error instanceof AutomationRunnerAmbiguousError ? 'unknown' : 'failed',
+                output: error instanceof Error ? error.message : String(error),
+                usage: {},
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        try {
+            const evidenceSessionId = result.sessionId === freshSessionId ? freshSessionId : undefined;
+            const exposure = evidenceSessionId === undefined
+                ? undefined
+                : await this.getExposure(automation, evidenceSessionId);
+            const outcome = timedOut
+                ? 'timed_out'
+                : controller.signal.aborted ? 'cancelled' : result.outcome;
+            const outputPreview = preview(result.output);
+            const artifactRef = this.artifacts.write(occurrence.id, {
+                occurrenceId: occurrence.id,
+                automationId: automation.id,
+                taskId: started.id,
+                outcome,
+                sessionId: result.sessionId ?? freshSessionId,
+                output: result.output,
+                usage: result.usage,
+            });
+            const run = this.store.completeTask({
+                taskId: started.id,
+                ownerId: this.ownerId,
+                fencingToken: fence,
+                now: this.now(),
+                outcome,
+                sessionId: result.sessionId ?? freshSessionId,
+                artifactRef,
+                outputPreview,
+                usage: result.usage,
+                ...(evidenceSessionId === undefined
+                    ? {}
+                    : {
+                        evidenceAttribution: {
+                            sessionId: evidenceSessionId,
+                            ...(exposure === undefined ? {} : exposure),
+                        },
+                    }),
+            });
+            this.dispatchRunDelivery(run);
+            this.dispatchRunEvidence(run);
+        }
+        finally {
+            clearInterval(heartbeat);
+        }
+    }
+    async getExposure(automation, actualSessionId) {
+        const recorder = this.outcomeRecorder;
+        if (recorder?.captureAutomationExposure === undefined)
+            return undefined;
+        let timeout;
+        try {
+            const captured = await Promise.race([
+                Promise.resolve(recorder.captureAutomationExposure({
+                    workspace: automation.definition.workspace,
+                    agentPreset: automation.definition.agentPreset,
+                    automationId: automation.id,
+                    sessionId: actualSessionId,
+                })),
+                new Promise(resolve => {
+                    timeout = setTimeout(() => resolve(undefined), exposureReceiptTimeoutMs);
+                }),
+            ]);
+            if (captured === undefined)
+                return undefined;
+            const ruleId = boundedText(captured.ruleId, 200);
+            if (ruleId === undefined
+                || !Number.isSafeInteger(captured.guidanceVersion)
+                || captured.guidanceVersion < 1
+                || captured.guidanceVersion > 1_000_000_000) {
+                return undefined;
+            }
+            return { ruleId, guidanceVersion: captured.guidanceVersion };
+        }
+        catch {
+            return undefined;
+        }
+        finally {
+            if (timeout !== undefined)
+                clearTimeout(timeout);
+        }
+    }
+    dispatchPendingEvidence() {
+        if (this.outcomeRecorder === undefined)
+            return;
+        for (const run of this.store.listPendingEvidence(100))
+            this.dispatchRunEvidence(run);
+    }
+    dispatchRunEvidence(run) {
+        const recorder = this.outcomeRecorder;
+        if (recorder === undefined || run.evidenceStatus !== 'pending' || run.evidence === undefined)
+            return;
+        try {
+            recorder.recordAutomationOutcome(run.evidence);
+            this.store.completeRunEvidence({ runId: run.id, expectedStatus: 'pending', now: this.now() });
+        }
+        catch {
+            // Evidence is an outbox lane: the run remains terminal and a later leader
+            // tick repeats the same recorder idempotency key. Move a poison row behind
+            // its peers so a bounded batch cannot starve newer evidence indefinitely.
+            try {
+                this.store.deferRunEvidence({ runId: run.id, expectedStatus: 'pending', now: this.now() });
+            }
+            catch {
+                // A concurrent settlement or store shutdown already owns the next step.
+            }
+        }
+    }
+    dispatchPendingDeliveries() {
+        for (const run of this.store.listPendingDeliveries(100))
+            this.dispatchRunDelivery(run);
+    }
+    dispatchRunDelivery(run) {
+        if (run.deliveryStatus !== 'pending')
+            return;
+        const automation = this.store.get(run.automationId);
+        const bindingId = automation?.definition.deliveryBindingId;
+        if (automation === undefined || bindingId === undefined)
+            return;
+        const normalizedOutput = run.outputPreview.normalize('NFC').trim();
+        if (normalizedOutput === '' || automation.definition.deliverySuppressExact?.includes(normalizedOutput) === true) {
+            this.store.suppressRunDelivery({ runId: run.id, expectedStatus: 'pending', now: this.now() });
+            return;
+        }
+        if (this.delivery === undefined)
+            return;
+        try {
+            const outbox = this.delivery.enqueueBackground({
+                sourceId: automation.id,
+                workspace: automation.definition.workspace,
+                bindingId,
+                idempotencyKey: `automation:${run.occurrenceId}:${bindingId}`,
+                text: run.outputPreview,
+                format: 'markdown',
+            });
+            this.store.completeRunDelivery({
+                runId: run.id,
+                expectedStatus: 'pending',
+                deliveryRef: outbox.id,
+                now: this.now(),
+            });
+        }
+        catch {
+            // The successful execution remains authoritative. A later tick repeats the
+            // same Delivery idempotency key and cannot create a second outbound intent.
+        }
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/lib/coordinator.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { AssistantAutomationsService, Config } from './service.js';
+import { version } from './version.js';
+export declare const name = "dsh-enhanced-assistant-automations";
+export { AssistantAutomationsService, Config, version };
+export type { PendingAutomationProposal, SystemAutomationReconcileInput } from './service.js';
+export * from './types.js';
+export { listActiveAutomationsLocally } from './operator.js';
+export declare function apply(ctx: Context, config: import('./service.js').Config): void;
+export default AssistantAutomationsService;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,eAAO,MAAM,IAAI,uCAAuC,CAAA;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AACvD,YAAY,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAA;AAC7F,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAA;AAE5D,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,cAAc,EAAE,MAAM,GAAG,IAAI,CAE/E;AAED,eAAe,2BAA2B,CAAA"}

package/lib/index.js

@@ -0,0 +1,11 @@
+import { AssistantAutomationsService, Config } from './service.js';
+import { version } from './version.js';
+export const name = 'dsh-enhanced-assistant-automations';
+export { AssistantAutomationsService, Config, version };
+export * from './types.js';
+export { listActiveAutomationsLocally } from './operator.js';
+export function apply(ctx, config) {
+    new AssistantAutomationsService(ctx, config);
+}
+export default AssistantAutomationsService;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,IAAI,GAAG,oCAAoC,CAAA;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAEvD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAA;AAE5D,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,MAAqC;IACvE,IAAI,2BAA2B,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AAC9C,CAAC;AAED,eAAe,2BAA2B,CAAA"}

package/lib/operator.d.ts

@@ -0,0 +1,4 @@
+import type { AutomationRecord } from './types.js';
+/** Read-only local inspection for setup tools; never starts the scheduler. */
+export declare function listActiveAutomationsLocally(databasePath: string): AutomationRecord[];
+//# sourceMappingURL=operator.d.ts.map

package/lib/operator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../src/operator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGlD,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAOrF"}

package/lib/operator.js

@@ -0,0 +1,12 @@
+import { AutomationStore } from './store.js';
+/** Read-only local inspection for setup tools; never starts the scheduler. */
+export function listActiveAutomationsLocally(databasePath) {
+    const store = new AutomationStore({ path: databasePath });
+    try {
+        return store.list().filter(record => record.status === 'active');
+    }
+    finally {
+        store.close();
+    }
+}
+//# sourceMappingURL=operator.js.map

package/lib/operator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.js","sourceRoot":"","sources":["../src/operator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,8EAA8E;AAC9E,MAAM,UAAU,4BAA4B,CAAC,YAAoB;IAC/D,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;IACzD,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAA;IAClE,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAA;IACf,CAAC;AACH,CAAC"}

package/lib/proposals.d.ts

@@ -0,0 +1,89 @@
+import type { ApprovalDecisionInput, ApprovalDispatchRoute, ApprovalProposalRecoveryInput, ApprovalProposalRecoveryResult, ApprovalProposalResult, ApprovalProposalSnapshot } from '@dsh-enhanced/assistant-policy';
+import { type AutomationStore } from './store.js';
+import type { AutomationMutation, AutomationProposalDecisionInput, AutomationProposalInput, AutomationProposalResult, AutomationProposalStatus, StoredAutomationProposal } from './types.js';
+export type AutomationProposalStoreErrorCode = 'idempotency-conflict' | 'invalid-input' | 'invalid-path' | 'invalid-state' | 'not-found' | 'schema-too-new' | 'unauthorized';
+export declare class AutomationProposalStoreError extends Error {
+    readonly code: AutomationProposalStoreErrorCode;
+    constructor(code: AutomationProposalStoreErrorCode, message: string);
+}
+export interface AutomationApprovalPolicy {
+    recoverOrCreateProposal(input: ApprovalProposalRecoveryInput): ApprovalProposalRecoveryResult;
+    decideProposal(input: ApprovalDecisionInput): ApprovalProposalResult;
+    getProposal(proposalId: string): ApprovalProposalSnapshot | undefined;
+}
+export declare class AutomationProposalStore {
+    private readonly database;
+    private readonly now;
+    private closed;
+    constructor(options: {
+        path: string;
+        now?: () => number;
+    });
+    close(): void;
+    get(proposalId: string): StoredAutomationProposal | undefined;
+    /**
+     * List proposals still pending locally, oldest first, so a reconciler can pair
+     * them with their policy decision.
+     */
+    listPending(limit: number): StoredAutomationProposal[];
+    prepare(input: {
+        proposalId: string;
+        idempotencyKey: string;
+        requester: string;
+        principal: string;
+        dispatch?: Readonly<ApprovalDispatchRoute>;
+        requestHash: string;
+        mutation: AutomationMutation;
+        expiresAt: number;
+        ttlMs: number;
+    }): {
+        proposal: StoredAutomationProposal;
+        replayed: boolean;
+    };
+    /** Move an inspected, still-pending row behind older peers using a durable monotonic timestamp. */
+    deferPending(proposalId: string): void;
+    attachPolicy(proposalId: string, policyProposalId: string, expiresAt: number): StoredAutomationProposal;
+    settle(input: {
+        proposalId: string;
+        status: Exclude<AutomationProposalStatus, 'pending'>;
+        version: number;
+        resultAutomationId?: string;
+    }): {
+        proposal: StoredAutomationProposal;
+        replayed: boolean;
+    };
+}
+export declare class AutomationProposalManager {
+    private readonly automations;
+    private readonly proposals;
+    private readonly policy;
+    private readonly now;
+    constructor(automations: AutomationStore, proposals: AutomationProposalStore, policy: AutomationApprovalPolicy, now?: () => number);
+    propose(input: AutomationProposalInput): AutomationProposalResult;
+    decide(input: AutomationProposalDecisionInput): AutomationProposalResult;
+    /**
+     * Commit locally pending proposals whose policy decision already settled
+     * elsewhere, for example on an approval card minutes after the turn ended.
+     *
+     * Approval is never inferred: the terminal status is read back from the policy
+     * ledger and applied through the same settle path `decide()` uses, so repeated
+     * reconciles are idempotent.
+     */
+    reconcile(limit: number): AutomationProposalResult[];
+    private policyIdentity;
+    /**
+     * Atomically recover or create the Policy half under the locally frozen
+     * deadline. An abandoned result is terminal and must never be resurrected.
+     */
+    private recoverOrCreatePolicyProposal;
+    private settleValidated;
+    private settleSecurityConflict;
+    /**
+     * Apply one already-terminal policy status to a pending automation proposal. A
+     * store conflict downgrades the proposal to `conflicted` instead of losing the
+     * decision, matching the rule that a decision is never re-asked.
+     */
+    private settleDecided;
+    get(proposalId: string): AutomationProposalResult | undefined;
+}
+//# sourceMappingURL=proposals.d.ts.map

package/lib/proposals.d.ts.map

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