@dsh-enhanced/assistant-proactive 0.1.30

package/lib/index.js

@@ -0,0 +1,138 @@
+import { Context, Service } from '@deepseek-ai/cordis';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import Schema from '@deepseek-ai/schemastery';
+import { acceptanceDigest } from '@dsh-enhanced/task-acceptance-contract';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { OpportunityEngine, validateProfile } from './engine.js';
+import { reminderText, reminderExpiresAt } from './reminder.js';
+import { PreparationRuntime } from './preparation.js';
+import { PreparationStore } from './preparation-store.js';
+import { version } from './version.js';
+export const name = 'dsh-enhanced-assistant-proactive';
+export { version, OpportunityEngine, validateProfile };
+const integer = (max = 1_000_000_000) => Schema.number().step(1).min(0).max(max).required();
+export const Config = Schema.object({
+    databasePath: Schema.string().default(join(homedir(), '.dsh', 'assistant-proactive.sqlite')),
+    profiles: Schema.array(Schema.object({
+        preparation: Schema.union([Schema.object({ provider: Schema.string().required(), model: Schema.string().required(), budgetId: Schema.string().required(), maxOutputTokens: Schema.number().step(1).min(1).max(32_768).required(), timeoutMs: Schema.number().step(1).min(1_000).max(300_000).required() })]),
+        id: Schema.string().required(), mode: Schema.union(['prepare', 'remind', 'execute']).required(),
+        expectedBenefit: integer(), successPpm: integer(1_000_000), executionCost: integer(), interruptionCost: integer(), possibleLoss: integer(),
+        minimumUtility: integer(),
+        mergeWindowMs: integer(), cooldownMs: integer(), rejectionCooldownMs: integer(),
+        quietHours: Schema.union([Schema.object({ timezone: Schema.string().required(), startMinute: integer(1439), endMinute: integer(1439) })]),
+        maxDecisionsPerGoal: integer(), maxExecutionsPerGoal: integer(), maxRemindersPerGoal: integer(),
+    })).default([]),
+});
+/** This optional decision gate cannot resume a goal or grant tool/route authority. */
+export class AssistantProactiveService extends Service {
+    static Config = Config;
+    #preparations;
+    #engine;
+    #profiles = new Map();
+    #active = true;
+    constructor(ctx, config = {}) {
+        super(ctx, 'assistantProactive');
+        for (const input of config.profiles ?? []) {
+            const profile = validateProfile(input);
+            if (this.#profiles.has(profile.id))
+                throw new Error('assistant-proactive: duplicate profile');
+            this.#profiles.set(profile.id, profile);
+        }
+        this.#engine = new OpportunityEngine(config.databasePath ?? join(homedir(), '.dsh', 'assistant-proactive.sqlite'), [...this.#profiles.values()]);
+        ctx.effect(() => () => { this.#active = false; this.#engine.close(); }, 'assistant-proactive.store');
+        const preparationPath = config.databasePath === ':memory:' ? ':memory:' : `${config.databasePath ?? join(homedir(), '.dsh', 'assistant-proactive.sqlite')}.preparations`;
+        this.#preparations = new PreparationRuntime(ctx, new PreparationStore(preparationPath));
+        ctx.inject(['tools', 'agents', 'assistantDelivery', 'assistantPolicy'], runtime => {
+            const output = {
+                schema: { type: 'object', additionalProperties: false, properties: { context: { type: 'string', required: true } } },
+                render: (_args, value) => [{ type: 'text', text: value.context }],
+            };
+            runtime.tools.register(defineTool({
+                name: 'proactive_status',
+                description: 'Inspect owner-scoped event opportunity decisions and operator utility estimates. Preparation may include a persisted model draft when explicitly configured. Drafts are unverified and do not mean the original goal was executed.',
+                parameters: { goal_id: { type: 'string' } }, output,
+                execute: async (args, execution) => { return { context: JSON.stringify(this.inspect(execution.agent, args.goal_id)) }; },
+            }));
+            runtime.tools.register(defineTool({
+                name: 'proactive_feedback',
+                description: 'Record current authenticated owner feedback on an opportunity. Rejection starts a durable cooldown for subsequent decisions. Feedback grants no execution permission and does not undo an already dispatched goal.',
+                parameters: { decision_id: { type: 'string', required: true }, feedback: { type: 'string', enum: ['accepted', 'rejected'], required: true } }, output,
+                execute: async (args, execution) => { return { context: JSON.stringify(this.feedback(execution.agent, args.decision_id, args.feedback)) }; },
+            }));
+        });
+    }
+    assertProfile = (profileId) => {
+        if (!this.#active || !this.#profiles.has(profileId))
+            throw new Error('assistant-proactive: configured active opportunity profile required');
+        if (this.#profiles.get(profileId).preparation && !this.#preparations.available())
+            throw new Error('assistant-proactive: preparation services unavailable');
+        if (this.#profiles.get(profileId).mode === 'remind' && !this.#notificationPort())
+            throw new Error('assistant-proactive: reminder delivery service unavailable');
+    };
+    evaluate = (input) => {
+        this.assertProfile(input.profileId);
+        const evaluation = this.#engine.evaluate(input);
+        const decision = evaluation.decision;
+        if (evaluation.disposition === 'consume' && decision.mode === 'remind' && decision.state === 'decided') {
+            const delivery = this.#notificationPort();
+            if (!delivery)
+                throw new Error('assistant-proactive: reminder delivery service unavailable');
+            const profile = this.#engine.profileSnapshot(decision.scope, decision.goalId, decision.profileId);
+            const expiresAt = reminderExpiresAt(decision, profile);
+            if (Date.now() < expiresAt)
+                delivery.enqueueOwnerNotification({ sourceId: 'assistant-proactive/v1', ownerRouteId: decision.ownerRouteId, scope: decision.scope, sessionId: decision.sessionId, idempotencyKey: `proactive-reminder:${decision.id}`, text: reminderText(decision, profile), expiresAt });
+        }
+        if (evaluation.disposition === 'consume' && decision.mode === 'prepare' && decision.state === 'decided') {
+            const profile = this.#engine.profileSnapshot(decision.scope, decision.goalId, decision.profileId);
+            if (profile.preparation) {
+                this.#preparations.store.enqueue(decision, profile.preparation, reminderExpiresAt(decision, profile));
+                void this.#preparations.tick().catch(() => { });
+            }
+        }
+        return evaluation;
+    };
+    #notificationPort() {
+        const delivery = this.ctx.get('assistantDelivery');
+        return typeof delivery?.enqueueOwnerNotification === 'function' ? delivery : undefined;
+    }
+    closeWait = (waitId, scope, reason) => {
+        if (!this.#active)
+            throw new Error('assistant-proactive: disposed');
+        this.#engine.closeWait(waitId, scope, reason);
+        this.#preparations.store.cancelWait(waitId, scope);
+    };
+    #scope(agent, feedback) {
+        if (!this.#active)
+            throw new Error('assistant-proactive: disposed');
+        if (!agent || this.ctx.get('agents')?.get(agent.id) !== agent)
+            throw new Error('assistant-proactive: exact live agent required');
+        const delivery = this.ctx.get('assistantDelivery');
+        const owner = delivery?.preferencePrincipalForAgent(agent);
+        if (!owner || owner.scope.workspace !== agent.session.header.cwd || owner.scope.preset !== agent.session.header.agentPreset)
+            throw new Error('assistant-proactive: authenticated owner required');
+        const scope = { principalId: owner.principalId, ...owner.principalLineage, workspace: owner.scope.workspace, preset: owner.scope.preset };
+        if (feedback) {
+            const turn = delivery?.currentPreferenceTurn(agent);
+            if (!turn || acceptanceDigest({ principalId: turn.principalId, ...turn.principalLineage, workspace: turn.scope.workspace, preset: turn.scope.preset }) !== acceptanceDigest(scope))
+                throw new Error('assistant-proactive: current authenticated owner turn required');
+        }
+        const policy = this.ctx.get('assistantPolicy');
+        if (policy?.authorizeAgent(agent, feedback ? 'feedback' : 'inspect', { kind: 'goal', id: 'proactive-opportunities' }).effect !== 'allow')
+            throw new Error('assistant-proactive: policy denied');
+        return scope;
+    }
+    inspect = (agent, goalId) => {
+        return this.#engine.list(this.#scope(agent, false), goalId).map(decision => {
+            const preparation = this.#preparations.store.get(decision.id);
+            return preparation ? { ...decision, preparation: { state: preparation.state, reason: preparation.reason, updatedAt: preparation.updatedAt,
+                    ...(preparation.result ? { output: preparation.result.output, sessionId: preparation.result.sessionId, usage: preparation.result.usage, diagnostic: preparation.result.diagnostic, verified: false } : {}) } } : decision;
+        });
+    };
+    reconcilePreparations = () => this.#preparations.tick();
+    feedback = (agent, id, feedback) => { const decision = this.#engine.feedback(id, this.#scope(agent, true), feedback); if (feedback === 'rejected')
+        this.#preparations.store.cancel(id); return decision; };
+}
+export function apply(ctx, config = {}) { new AssistantProactiveService(ctx, config); }
+export default { name, Config, apply };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/preparation-store.d.ts

@@ -0,0 +1,39 @@
+import type { OpportunityDecision, OpportunityScope, PreparationSettings } from './types.js';
+export interface PreparationResult {
+    outcome: string;
+    output: string;
+    usage: Readonly<Record<string, unknown>>;
+    sessionId?: string;
+    quiescent?: boolean;
+    diagnostic?: Readonly<{
+        failureClass: string;
+        failurePhase: string;
+        failureCode: string;
+    }>;
+}
+export interface PreparationRecord {
+    id: string;
+    decision: OpportunityDecision;
+    settings: PreparationSettings;
+    state: 'queued' | 'running' | 'draft' | 'failed' | 'cancelled' | 'unknown';
+    createdAt: number;
+    updatedAt: number;
+    deadlineAt: number;
+    token?: string;
+    result?: PreparationResult;
+    reason?: string;
+}
+/** The preparation intent and result are private, durable data; neither is goal completion evidence. */
+export declare class PreparationStore {
+    #private;
+    constructor(path: string);
+    enqueue(decision: OpportunityDecision, settings: PreparationSettings, deadlineAt?: number): PreparationRecord;
+    get(id: string): PreparationRecord | undefined;
+    pending(): PreparationRecord[];
+    claim(id: string): PreparationRecord | undefined;
+    finish(value: PreparationRecord, state: PreparationRecord['state'], result?: PreparationResult, reason?: string): void;
+    cancel(id: string): void;
+    cancelWait(waitId: string, scope: OpportunityScope): void;
+    close(): void;
+}
+//# sourceMappingURL=preparation-store.d.ts.map

package/lib/preparation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation-store.d.ts","sourceRoot":"","sources":["../src/preparation-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAE5F,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAClH,UAAU,CAAC,EAAE,QAAQ,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC3F;AACD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;IACxE,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;IAC1E,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACtH;AAED,wGAAwG;AACxG,qBAAa,gBAAgB;;gBAEf,IAAI,EAAE,MAAM;IAaxB,OAAO,CAAC,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,UAAU,SAAqB,GAAG,iBAAiB;IAYzH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C,OAAO,IAAI,iBAAiB,EAAE;IAG9B,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAMhD,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAUzD,KAAK,IAAI,IAAI;CACd"}

package/lib/preparation-store.js

@@ -0,0 +1,74 @@
+import { DatabaseSync } from 'node:sqlite';
+import { randomUUID } from 'node:crypto';
+import { acceptanceDigest } from '@dsh-enhanced/task-acceptance-contract';
+import { privatePath } from './engine.js';
+/** The preparation intent and result are private, durable data; neither is goal completion evidence. */
+export class PreparationStore {
+    #db;
+    constructor(path) {
+        if (path !== ':memory:')
+            privatePath(path);
+        this.#db = new DatabaseSync(path);
+        this.#db.exec(`PRAGMA journal_mode=WAL; PRAGMA synchronous=FULL; PRAGMA busy_timeout=250;
+      CREATE TABLE IF NOT EXISTS proactive_preparations(id TEXT PRIMARY KEY, scope_key TEXT NOT NULL, goal_id TEXT NOT NULL, state TEXT NOT NULL, token TEXT, payload_json TEXT NOT NULL) STRICT;
+      CREATE INDEX IF NOT EXISTS proactive_preparations_scope ON proactive_preparations(scope_key,goal_id);`);
+        // A previous process may have dispatched a paid request. Never retry that
+        // uncertain call automatically; a concurrent opener fences its late result.
+        for (const row of this.#db.prepare("SELECT id FROM proactive_preparations WHERE state='running'").all()) {
+            const value = this.get(row.id);
+            this.#write({ ...value, state: 'unknown', reason: 'process-interrupted', updatedAt: Date.now() }, 'running');
+        }
+    }
+    enqueue(decision, settings, deadlineAt = decision.expiresAt) {
+        const existing = this.get(decision.id);
+        if (existing) {
+            if (acceptanceDigest([existing.decision, existing.settings, existing.deadlineAt]) !== acceptanceDigest([decision, settings, deadlineAt]))
+                throw new Error('assistant-proactive: preparation identity conflict');
+            return existing;
+        }
+        const value = { id: decision.id, decision, settings, deadlineAt, state: 'queued', createdAt: Date.now(), updatedAt: Date.now() };
+        this.#db.prepare('INSERT OR IGNORE INTO proactive_preparations VALUES(?,?,?,?,?,?)').run(value.id, acceptanceDigest(decision.scope), decision.goalId, value.state, null, JSON.stringify(value));
+        const saved = this.get(value.id);
+        if (acceptanceDigest([saved.decision, saved.settings, saved.deadlineAt]) !== acceptanceDigest([decision, settings, deadlineAt]))
+            throw new Error('assistant-proactive: preparation identity conflict');
+        return saved;
+    }
+    get(id) {
+        const row = this.#db.prepare('SELECT payload_json FROM proactive_preparations WHERE id=?').get(id);
+        return row === undefined ? undefined : JSON.parse(row.payload_json);
+    }
+    pending() {
+        return this.#db.prepare("SELECT payload_json FROM proactive_preparations WHERE state='queued' ORDER BY rowid LIMIT 32").all().map(row => JSON.parse(row.payload_json));
+    }
+    claim(id) {
+        const value = this.get(id);
+        if (!value || value.state !== 'queued')
+            return undefined;
+        const claimed = { ...value, state: 'running', token: randomUUID(), updatedAt: Date.now() };
+        return this.#write(claimed, 'queued') ? claimed : undefined;
+    }
+    finish(value, state, result, reason) {
+        const current = this.get(value.id);
+        if (current?.state !== 'running' || current.token !== value.token)
+            return;
+        this.#write({ ...current, state, updatedAt: Date.now(), ...(result ? { result } : {}), ...(reason ? { reason } : {}) }, 'running', value.token);
+    }
+    cancel(id) {
+        const value = this.get(id);
+        if (value && (value.state === 'queued' || value.state === 'running'))
+            this.#write({ ...value, state: 'cancelled', reason: 'owner-rejected', updatedAt: Date.now() }, value.state);
+    }
+    cancelWait(waitId, scope) {
+        for (const row of this.#db.prepare("SELECT payload_json FROM proactive_preparations WHERE scope_key=? AND state IN ('queued','running')").all(acceptanceDigest(scope))) {
+            const value = JSON.parse(row.payload_json);
+            if (value.decision.waitId === waitId)
+                this.#write({ ...value, state: 'cancelled', reason: 'wait-ended', updatedAt: Date.now() }, value.state);
+        }
+    }
+    #write(value, expected, token) {
+        return this.#db.prepare(`UPDATE proactive_preparations SET state=?,token=?,payload_json=? WHERE id=? AND state=?${token === undefined ? '' : ' AND token=?'}`)
+            .run(value.state, value.token ?? null, JSON.stringify(value), value.id, expected, ...(token === undefined ? [] : [token])).changes === 1;
+    }
+    close() { this.#db.close(); }
+}
+//# sourceMappingURL=preparation-store.js.map

package/lib/preparation-store.js.map

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

package/lib/preparation.d.ts

@@ -0,0 +1,12 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { PreparationStore, type PreparationRecord } from './preparation-store.js';
+export declare class PreparationRuntime {
+    #private;
+    private readonly ctx;
+    readonly store: PreparationStore;
+    constructor(ctx: Context, store: PreparationStore);
+    available(): boolean;
+    current(record: PreparationRecord): void;
+    tick(): Promise<void>;
+}
+//# sourceMappingURL=preparation.d.ts.map

package/lib/preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation.d.ts","sourceRoot":"","sources":["../src/preparation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAA0B,MAAM,wBAAwB,CAAA;AAOzG,qBAAa,kBAAkB;;IAIjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAW,QAAQ,CAAC,KAAK,EAAE,gBAAgB;gBAA9C,GAAG,EAAE,OAAO,EAAW,KAAK,EAAE,gBAAgB;IAY3E,SAAS,IAAI,OAAO;IAEpB,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAQxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA2BtB"}

package/lib/preparation.js

@@ -0,0 +1,86 @@
+import { PreparationStore } from './preparation-store.js';
+export class PreparationRuntime {
+    ctx;
+    store;
+    #abort = new AbortController();
+    #operation;
+    #closed = false;
+    constructor(ctx, store) {
+        this.ctx = ctx;
+        this.store = store;
+        ctx.effect(() => {
+            const timer = setInterval(() => { void this.tick().catch(() => { }); }, 500);
+            timer.unref?.();
+            return async () => {
+                this.#closed = true;
+                clearInterval(timer);
+                this.#abort.abort();
+                // The Automation runner owns cancellation and joins its Agent before returning.
+                await this.#operation?.catch(() => { });
+                this.store.close();
+            };
+        }, 'assistant-proactive.preparations');
+    }
+    available() { const ports = this.#ports(); return typeof ports.automation?.runPreparation === 'function' && typeof ports.goals?.assertPreparationCurrent === 'function'; }
+    #ports() { return { automation: this.ctx.get('assistantAutomations', false), goals: this.ctx.get('assistantGoals', false) }; }
+    current(record) {
+        if (this.#closed || this.#abort.signal.aborted)
+            throw new Error('assistant-proactive: preparation disposed');
+        const stored = this.store.get(record.id);
+        if (stored?.state !== 'running' || stored.token !== record.token || Date.now() >= Math.min(record.decision.expiresAt, record.deadlineAt))
+            throw new Error('assistant-proactive: preparation authority ended');
+        const goals = this.#ports().goals;
+        if (typeof goals?.assertPreparationCurrent !== 'function')
+            throw new Error('assistant-proactive: preparation goal service unavailable');
+        goals.assertPreparationCurrent(record.decision);
+    }
+    tick() {
+        if (this.#closed || !this.available())
+            return Promise.resolve();
+        if (this.#operation)
+            return this.#operation;
+        const operation = this.#run();
+        this.#operation = operation;
+        void operation.finally(() => { if (this.#operation === operation)
+            this.#operation = undefined; }).catch(() => { });
+        return operation;
+    }
+    async #run() {
+        const pending = this.store.pending()[0];
+        if (!pending)
+            return;
+        const record = this.store.claim(pending.id);
+        if (!record)
+            return;
+        try {
+            this.current(record);
+        }
+        catch {
+            this.store.finish(record, 'cancelled', undefined, 'authority-unavailable');
+            return;
+        }
+        const auto = this.#ports().automation;
+        const decision = record.decision;
+        try {
+            const result = await auto.runPreparation({ id: record.id, goalId: decision.goalId, scope: decision.scope, sessionId: decision.sessionId, ownerRouteId: decision.ownerRouteId,
+                objective: decision.objective, ...record.settings, expiresAt: Math.min(decision.expiresAt, record.deadlineAt) }, this.#abort.signal, () => this.current(record));
+            try {
+                this.current(record);
+            }
+            catch {
+                this.store.finish(record, 'cancelled', undefined, 'authority-ended');
+                return;
+            }
+            if (result.outcome === 'succeeded' && result.quiescent === true && result.output.trim().length > 0 && Buffer.byteLength(result.output) <= 262_144) {
+                this.store.finish(record, 'draft', result, 'unverified-draft');
+            }
+            else {
+                this.store.finish(record, result.quiescent === true ? 'failed' : 'unknown', Buffer.byteLength(result.output) <= 262_144 ? result : undefined, 'generation-not-completed');
+            }
+        }
+        catch {
+            this.store.finish(record, 'unknown', undefined, 'generation-unconfirmed');
+        }
+    }
+}
+//# sourceMappingURL=preparation.js.map

package/lib/preparation.js.map

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

package/lib/reminder.d.ts

@@ -0,0 +1,6 @@
+import type { OpportunityDecision, OpportunityProfile } from './types.js';
+/** Plain text only. The event supplies identifiers, never new instructions or authority. */
+export declare function reminderText(decision: Readonly<OpportunityDecision>, profile: Readonly<OpportunityProfile>): string;
+/** A queued reminder expires at the next quiet interval; it cannot arrive during a later silent period. */
+export declare function reminderExpiresAt(decision: Readonly<OpportunityDecision>, profile: Readonly<OpportunityProfile>): number;
+//# sourceMappingURL=reminder.d.ts.map

package/lib/reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder.d.ts","sourceRoot":"","sources":["../src/reminder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEzE,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAGnH;AAED,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAexH"}

package/lib/reminder.js

@@ -0,0 +1,27 @@
+/** Plain text only. The event supplies identifiers, never new instructions or authority. */
+export function reminderText(decision, profile) {
+    const objective = decision.objective.length > 500 ? `${decision.objective.slice(0, 500)}…` : decision.objective;
+    return `主动提醒：目标有新的相关事件\n\n目标：${objective}\n来源：${decision.sourceId}\n事件：${decision.eventId}\n\n配置估值：预期收益 ${profile.expectedBenefit}，成功系数 ${profile.successPpm / 10_000}%，执行成本 ${profile.executionCost}，打扰成本 ${profile.interruptionCost}，潜在损失 ${profile.possibleLoss}；净收益分值 ${decision.utility}。这些是配置估计，未经实际效果验证。\n\n目标仍在等待。本次仅提醒，未执行目标任务。可查看 proactive_status，并用 proactive_feedback 接受或拒绝这条机会。\n机会：${decision.id}`;
+}
+/** A queued reminder expires at the next quiet interval; it cannot arrive during a later silent period. */
+export function reminderExpiresAt(decision, profile) {
+    const quiet = profile.quietHours;
+    if (!quiet)
+        return decision.expiresAt;
+    const formatter = new Intl.DateTimeFormat('en-US', { timeZone: quiet.timezone, hour: '2-digit', minute: '2-digit', hourCycle: 'h23' });
+    const isQuiet = (at) => {
+        const parts = formatter.formatToParts(new Date(at));
+        const minute = Number(parts.find(part => part.type === 'hour')?.value) * 60 + Number(parts.find(part => part.type === 'minute')?.value);
+        return quiet.startMinute < quiet.endMinute ? minute >= quiet.startMinute && minute < quiet.endMinute : minute >= quiet.startMinute || minute < quiet.endMinute;
+    };
+    const start = decision.updatedAt;
+    if (isQuiet(start))
+        return start;
+    // Minute boundaries match the configured granularity; include the extra DST hour.
+    const bound = Math.min(decision.expiresAt, start + 26 * 3_600_000);
+    for (let at = Math.floor(start / 60_000) * 60_000 + 60_000; at < bound; at += 60_000)
+        if (isQuiet(at))
+            return at;
+    return bound;
+}
+//# sourceMappingURL=reminder.js.map

package/lib/reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder.js","sourceRoot":"","sources":["../src/reminder.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,QAAuC,EAAE,OAAqC;IACzG,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAA;IAC/G,OAAO,wBAAwB,SAAS,QAAQ,QAAQ,CAAC,QAAQ,QAAQ,QAAQ,CAAC,OAAO,iBAAiB,OAAO,CAAC,eAAe,SAAS,OAAO,CAAC,UAAU,GAAG,MAAM,UAAU,OAAO,CAAC,aAAa,SAAS,OAAO,CAAC,gBAAgB,SAAS,OAAO,CAAC,YAAY,UAAU,QAAQ,CAAC,OAAO,wGAAwG,QAAQ,CAAC,EAAE,EAAE,CAAA;AACnZ,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,iBAAiB,CAAC,QAAuC,EAAE,OAAqC;IAC9G,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAA;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAA;IACrC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;IACtI,MAAM,OAAO,GAAG,CAAC,EAAU,EAAW,EAAE;QACtC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAA;QACvI,OAAO,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,MAAM,GAAG,KAAK,CAAC,SAAS,CAAA;IAChK,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAA;IAChC,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAChC,kFAAkF;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,EAAE,GAAG,SAAS,CAAC,CAAA;IAClE,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,IAAI,MAAM;QAAE,IAAI,OAAO,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,CAAA;IAChH,OAAO,KAAK,CAAA;AACd,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,95 @@
+export interface OpportunityScope {
+    principalId: string;
+    principalRecordId: string;
+    principalVersion: number;
+    workspace: string;
+    preset: string;
+}
+/** Operator estimates in utility units; neither probabilities nor money are independently verified. */
+export interface PreparationSettings {
+    provider: string;
+    model: string;
+    budgetId: string;
+    maxOutputTokens: number;
+    timeoutMs: number;
+}
+export interface OpportunityProfile {
+    /** Explicit opt-in to paid, tool-free generation; omitted prepare keeps metadata-only behavior. */
+    preparation?: PreparationSettings;
+    id: string;
+    mode: 'prepare' | 'remind' | 'execute';
+    expectedBenefit: number;
+    successPpm: number;
+    executionCost: number;
+    interruptionCost: number;
+    possibleLoss: number;
+    minimumUtility: number;
+    mergeWindowMs: number;
+    cooldownMs: number;
+    rejectionCooldownMs: number;
+    quietHours?: {
+        timezone: string;
+        startMinute: number;
+        endMinute: number;
+    };
+    maxDecisionsPerGoal: number;
+    maxExecutionsPerGoal: number;
+    maxRemindersPerGoal: number;
+}
+/** Supplied by the live Goals service from an already owner-authorized wait; never by an event body. */
+export interface OpportunityInput {
+    waitId: string;
+    profileId: string;
+    scope: OpportunityScope;
+    goalId: string;
+    sessionId: string;
+    definitionDigest: string;
+    objective: string;
+    nativeGoalId: string;
+    nativeRevision: number;
+    ownerRouteId: string;
+    sourceDigest: string;
+    sourceId: string;
+    event: {
+        id: string;
+        sequence: number;
+        digest: string;
+        occurredAt: number;
+    };
+    expiresAt: number;
+}
+export type OpportunityReason = 'cancelled' | 'coalescing' | 'quiet-hours' | 'cooldown' | 'rejected-cooldown' | 'below-threshold' | 'budget' | 'expired' | 'prepared' | 'reminder' | 'execution';
+export interface OpportunityDecision {
+    id: string;
+    waitId: string;
+    profileId: string;
+    scope: OpportunityScope;
+    goalId: string;
+    sessionId: string;
+    ownerRouteId: string;
+    sourceId: string;
+    eventId: string;
+    eventSequence: number;
+    eventDigest: string;
+    sourceDigest: string;
+    objective: string;
+    definitionDigest: string;
+    nativeGoalId: string;
+    nativeRevision: number;
+    mode: 'prepare' | 'remind' | 'execute' | 'suppress';
+    state: 'pending' | 'decided' | 'closed';
+    reason: OpportunityReason;
+    utility: number;
+    firstObservedAt: number;
+    updatedAt: number;
+    eligibleAt: number;
+    expiresAt: number;
+    observations: number;
+    feedback?: 'accepted' | 'rejected';
+}
+export interface OpportunityEvaluation {
+    /** consume advances this wait's source cursor; execute still goes through the original GoalWake authority. */
+    disposition: 'defer' | 'consume' | 'execute';
+    decision: Readonly<OpportunityDecision>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAC5G;AACD,uGAAuG;AACvG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAC9F;AACD,MAAM,WAAW,kBAAkB;IACjC,mGAAmG;IACnG,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;IACtC,eAAe,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;IAC1I,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;IACtE,UAAU,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACzE,mBAAmB,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CACvF;AACD,wGAAwG;AACxG,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;IAC7F,gBAAgB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;IAC/G,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;IACtC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3E,SAAS,EAAE,MAAM,CAAA;CAClB;AACD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;AAChM,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;IAC/H,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;IACnG,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;IACzF,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;IACnD,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;IACnF,eAAe,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;IACvG,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;CACnC;AACD,MAAM,WAAW,qBAAqB;IACpC,8GAA8G;IAC9G,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;IAC5C,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;CACxC"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare const version = "0.1.30";
+//# sourceMappingURL=version.d.ts.map

package/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAA"}

package/lib/version.js

@@ -0,0 +1,2 @@
+export const version = '0.1.30';
+//# sourceMappingURL=version.js.map

package/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAA"}