@dsh-enhanced/assistant-growth-driver 0.1.34

package/lib/index.d.ts

@@ -0,0 +1,73 @@
+import { Context, Service } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { Config, normalizeConfig, type AssistantGrowthDriverConfig } from './config.js';
+import { type GrowthAgentRunResult } from './growth-agent.js';
+import { version } from './version.js';
+export declare const name = "dsh-enhanced-assistant-growth-driver";
+export { version, Config, normalizeConfig };
+export type { AssistantGrowthDriverConfig } from './config.js';
+export type { GrowthAuthority } from './deposit.js';
+/**
+ * Outcome of the owner-anchored workflow track in one wake. This track is
+ * purely Host-local (Delivery re-reads Goals and writes a paused candidate; no
+ * model call), so it is reported separately from the model-driven skill track.
+ * `stopped` is non-null when a fail-closed Delivery/Goals condition halted the
+ * track before the rate limit was reached.
+ */
+export interface OwnerAnchoredWakeSummary {
+    readonly considered: number;
+    readonly attempted: number;
+    readonly recorded: number;
+    readonly replayed: number;
+    readonly abstained: number;
+    readonly stopped: string | null;
+}
+export interface GrowthWakeHealth {
+    readonly lastWakeAt: number | null;
+    readonly outcome: 'never-run' | 'ran' | 'skipped' | 'failed';
+    readonly reason: string | null;
+    readonly run: GrowthAgentRunResult | null;
+    readonly ownerAnchored?: OwnerAnchoredWakeSummary | undefined;
+}
+/**
+ * Opt-in, fail-closed periodic growth driver.  Every wake:
+ *   1. re-anchors the frozen configured owner scope against Delivery;
+ *   2. freezes the conversation's model (or explicit fixed override), applying
+ *      supplier-specific credential/contract checks only to that supplier;
+ *   3. optionally reserves an owner-configured background budget;
+ *   4. runs ONE bounded background agent that may only read history and
+ *      propose a paused skill candidate through Host re-verification.
+ * Any failed precondition skips the wake with a health reason: the driver
+ * never changes route, never falls back to another model and never self-enables.
+ */
+export declare class AssistantGrowthDriverService extends Service {
+    #private;
+    static Config: import("@deepseek-ai/schemastery").default<AssistantGrowthDriverConfig>;
+    static inject: string[];
+    constructor(ctx: Context, input?: AssistantGrowthDriverConfig);
+    health: () => GrowthWakeHealth;
+    usageHealth: () => {
+        enabled: boolean;
+        connected: boolean;
+        lastScanAt: number | null;
+        lastError: string | null;
+        counts: Readonly<Record<string, number>>;
+    } | {
+        enabled: boolean;
+        connected: false;
+    };
+    /** Run one wake immediately (also used by tests / an explicit Host trigger). */
+    wake: (input?: {
+        sourceAgent?: Agent;
+    }) => Promise<void>;
+}
+export declare function apply(ctx: Context, input?: AssistantGrowthDriverConfig): void;
+declare const _default: {
+    name: string;
+    Config: import("@deepseek-ai/schemastery").default<AssistantGrowthDriverConfig>;
+    inject: string[];
+    apply: typeof apply;
+    version: string;
+};
+export default _default;
+//# 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":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,wBAAwB,CAAA;AAMnE,OAAO,EAAE,MAAM,EAAuB,eAAe,EAAE,KAAK,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAE5G,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAItC,eAAO,MAAM,IAAI,yCAAyC,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;AAC3C,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAA;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAIzC,QAAQ,CAAC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAA;CAC9D;AAuBD;;;;;;;;;;GAUG;AACH,qBAAa,4BAA6B,SAAQ,OAAO;;IACvD,MAAM,CAAC,MAAM,0EAAS;IACtB,MAAM,CAAC,MAAM,WAAsH;gBAUvH,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,2BAAgC;IAuGjE,MAAM,QAAO,gBAAgB,CAAgB;IAC7C,WAAW;;;;;;;;;MAAmG;IAgB9G,gFAAgF;IAChF,IAAI,GAAI,QAAO;QAAE,WAAW,CAAC,EAAE,KAAK,CAAA;KAAO,KAAG,OAAO,CAAC,IAAI,CAAC,CAQ1D;CAsOF;AAMD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,2BAAgC,GAAG,IAAI,CAEjF;;;;;;;;AAED,wBAA4F"}

package/lib/index.js

@@ -0,0 +1,427 @@
+import { randomUUID } from 'node:crypto';
+import { Context, Service } from '@deepseek-ai/cordis';
+import { credentialRef } from '@deepseek-ai/dsh-credentials';
+import { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+import { Config, DEFAULT_API_KEY_ENV, normalizeConfig } from './config.js';
+import { mintGrowthAuthority } from './deposit.js';
+import { runGrowthAgent } from './growth-agent.js';
+import { version } from './version.js';
+import { UsageLearningRuntime } from './usage-runtime.js';
+export const name = 'dsh-enhanced-assistant-growth-driver';
+export { version, Config, normalizeConfig };
+/**
+ * cordis 4.0.2 hands cross-plugin service consumers a traceable Proxy whose
+ * shadow-method trap rebinds `this` to a second Proxy; ES #private brand
+ * checks then throw ("Cannot read private member … from an object whose class
+ * did not declare it").  The library exposes the raw instance through
+ * Symbol.for('cordis.original') on every traceable Proxy; plain-object mocks
+ * have no such marker and pass through unchanged.
+ */
+const CORDIS_ORIGINAL = Symbol.for('cordis.original');
+function unwrapService(service) {
+    return service?.[CORDIS_ORIGINAL] ?? service;
+}
+/**
+ * Opt-in, fail-closed periodic growth driver.  Every wake:
+ *   1. re-anchors the frozen configured owner scope against Delivery;
+ *   2. freezes the conversation's model (or explicit fixed override), applying
+ *      supplier-specific credential/contract checks only to that supplier;
+ *   3. optionally reserves an owner-configured background budget;
+ *   4. runs ONE bounded background agent that may only read history and
+ *      propose a paused skill candidate through Host re-verification.
+ * Any failed precondition skips the wake with a health reason: the driver
+ * never changes route, never falls back to another model and never self-enables.
+ */
+export class AssistantGrowthDriverService extends Service {
+    static Config = Config;
+    static inject = ['assistantGoals', 'assistantSkills', 'assistantPolicy', 'assistantDelivery', 'agents', 'sessions', 'tools', 'llm'];
+    #config;
+    #flight;
+    #active = true;
+    #abort = new AbortController();
+    #sourceBinding;
+    #health = { lastWakeAt: null, outcome: 'never-run', reason: null, run: null };
+    #usage;
+    constructor(ctx, input = {}) {
+        super(ctx, 'assistantGrowthDriver');
+        this.#config = normalizeConfig(input);
+        ctx.effect(() => {
+            const timer = this.#config.enabled && this.#config.intervalMs > 0
+                ? setInterval(() => { void this.wake().catch(() => undefined); }, this.#config.intervalMs) : undefined;
+            timer?.unref?.();
+            return async () => {
+                this.#active = false;
+                if (timer !== undefined)
+                    clearInterval(timer);
+                this.#abort.abort(new Error('assistant-growth-driver: disposed'));
+                await this.#flight;
+            };
+        }, 'assistant-growth-driver.runtime');
+        if (this.#config.usageLearning.enabled) {
+            ctx.inject(['assistantEvaluation', 'assistantAutomations'], usageCtx => {
+                const usage = new UsageLearningRuntime(this.#config, {
+                    evaluation: usageCtx.assistantEvaluation, automations: usageCtx.assistantAutomations,
+                    delivery: usageCtx.assistantDelivery, review: input => this.#reviewUsage(input),
+                });
+                usageCtx.effect(() => async () => {
+                    if (this.#usage === usage)
+                        this.#usage = undefined;
+                    await usage.close();
+                }, 'assistant-growth-driver.usage-learning');
+                this.#usage = usage;
+                usage.start();
+            });
+        }
+        if (this.#config.pluginSourceProposals.enabled) {
+            // Optional provider lives in a nested injection. Its generation owns the
+            // source capability and cancellation; the outer driver remains usable
+            // when the control plane is absent or is being replaced.
+            ctx.inject(['pluginControlPlane'], sourceCtx => {
+                const abort = new AbortController();
+                const current = () => {
+                    abort.signal.throwIfAborted();
+                    return sourceCtx.get('pluginControlPlane');
+                };
+                const provider = current();
+                const durable = this.#config.pluginSourceProposals.preparationMode === 'durable';
+                // Bind API seams, not this generation's availability. Automations can
+                // appear after the control plane: canEnqueueSource then changes from
+                // false to true without a control-plane reload.
+                const seamsPresent = durable
+                    ? typeof provider.canEnqueueSource === 'function' && typeof provider.enqueueSourceJob === 'function' && typeof provider.inspectSourceJob === 'function'
+                    : typeof provider.canPrepareSource === 'function' && typeof provider.prepareModifySourcePlan === 'function';
+                if (!seamsPresent || typeof provider.inspectSource !== 'function')
+                    return;
+                const binding = {
+                    signal: abort.signal,
+                    recordTaskFailure: (source) => {
+                        const live = current();
+                        if (typeof live.recordOwnerTaskFailureGap !== 'function')
+                            throw new Error('control plane owner task gap API unavailable');
+                        return live.recordOwnerTaskFailureGap(source);
+                    },
+                    available: () => {
+                        try {
+                            const live = current();
+                            return durable ? live.canEnqueueSource?.() === true : live.canPrepareSource?.() === true;
+                        }
+                        catch {
+                            return false;
+                        }
+                    },
+                    port: {
+                        listOpenGaps: () => current().gaps(50),
+                        inspectSource: async (input) => {
+                            const signal = AbortSignal.any([input.signal, abort.signal, this.#abort.signal]);
+                            return current().inspectSource({ ...input, signal,
+                                assertCurrent: () => { signal.throwIfAborted(); current(); input.assertCurrent(); },
+                            });
+                        },
+                        prepareModifySourcePlan: async (input) => {
+                            const signal = AbortSignal.any([input.signal, abort.signal, this.#abort.signal]);
+                            return current().prepareModifySourcePlan({ ...input, signal,
+                                assertCurrent: () => { signal.throwIfAborted(); current(); input.assertCurrent(); },
+                            });
+                        },
+                        enqueueSourceJob: async (input) => {
+                            const signal = AbortSignal.any([input.signal, abort.signal, this.#abort.signal]);
+                            // Do not add route/configuration/timeout fields here. The
+                            // control-plane durable authority owns those independently.
+                            return current().enqueueSourceJob({ ...input, signal,
+                                assertCurrent: () => { signal.throwIfAborted(); current(); input.assertCurrent(); },
+                            });
+                        },
+                        inspectSourceJob: (input) => current().inspectSourceJob(input),
+                    },
+                };
+                this.#sourceBinding = binding;
+                sourceCtx.effect(() => () => {
+                    abort.abort(new Error('assistant-growth-driver: source provider changed'));
+                    if (this.#sourceBinding === binding)
+                        this.#sourceBinding = undefined;
+                }, 'assistant-growth-driver.source-provider');
+            });
+        }
+    }
+    // Cordis traces public service calls through a proxy. Bind these entry points
+    // to the owning instance so private state and the wake's Fiber stay intact.
+    health = () => this.#health;
+    usageHealth = () => this.#usage?.health() ?? { enabled: this.#config.usageLearning.enabled, connected: false };
+    async #reviewUsage(input) {
+        // Unlike timer nudges, a durable job must run its own frozen source, never
+        // coalesce onto an unrelated manual wake and report that wake as its result.
+        while (this.#flight !== undefined) {
+            await this.#flight;
+            input.assertCurrent();
+        }
+        input.assertCurrent();
+        let outcome = 'unknown';
+        const flight = this.#runWake({ usage: input }).then(() => {
+            outcome = this.#health.outcome === 'ran' && this.#health.run?.outcome === 'succeeded' ? 'reviewed' : 'unknown';
+        }).finally(() => { if (this.#flight === flight)
+            this.#flight = undefined; });
+        this.#flight = flight;
+        await flight;
+        return outcome;
+    }
+    /** Run one wake immediately (also used by tests / an explicit Host trigger). */
+    wake = (input = {}) => {
+        if (!this.#active || !this.#config.enabled)
+            return Promise.resolve();
+        // Coalesce explicit and timer wakes onto the same bounded run. Queueing
+        // timer ticks would build an unbounded backlog when a build is slow.
+        if (this.#flight !== undefined)
+            return this.#flight;
+        const flight = this.#runWake(input).finally(() => { if (this.#flight === flight)
+            this.#flight = undefined; });
+        this.#flight = flight;
+        return flight;
+    };
+    async #resolveCredential(provider) {
+        const env = this.#config.apiKeyEnv ?? (provider === 'super-relay' ? DEFAULT_API_KEY_ENV : null);
+        // Other adapters own their credentials; do not require a Super Relay key
+        // merely because the growth plugin happens to be installed.
+        if (env === null)
+            return true;
+        const credentials = this.ctx.get('credentials', false);
+        const resolved = credentials === undefined ? undefined : (await credentials.resolve(credentialRef(env)))?.value;
+        const key = resolved ?? process.env[env];
+        return typeof key === 'string' && key.length > 0;
+    }
+    async #runWake(input) {
+        const wakeId = input.usage?.id ?? `growth-wake-${Date.now()}-${randomUUID()}`;
+        const startedAt = Date.now();
+        const config = this.#config;
+        if (!config.scope) {
+            this.#health = { lastWakeAt: startedAt, outcome: 'skipped', reason: 'missing-scope', run: null };
+            return;
+        }
+        const delivery = unwrapService(this.ctx.get('assistantDelivery'));
+        const policy = unwrapService(this.ctx.get('assistantPolicy', false));
+        const goals = unwrapService(this.ctx.get('assistantGoals'));
+        const skills = unwrapService(this.ctx.get('assistantSkills'));
+        // ---- preflight (no network, no agent) ----
+        let authority;
+        try {
+            authority = mintGrowthAuthority(delivery, config.scope, startedAt + config.maxDurationMs);
+            if (input.usage) {
+                const base = authority, usage = input.usage;
+                authority = Object.freeze({ ...base, assertCurrent() { base.assertCurrent(); usage.assertCurrent(); } });
+                authority.assertCurrent();
+            }
+        }
+        catch (error) {
+            this.#health = { lastWakeAt: startedAt, outcome: 'skipped', reason: `missing-binding:${errorMessage(error)}`, run: null };
+            return;
+        }
+        let model;
+        let modelFailure;
+        try {
+            const selected = input.usage?.model ?? (config.provider !== null && config.model !== null
+                ? { provider: config.provider, model: config.model,
+                    ...(config.reasoningEffort === null ? {} : { reasoningEffort: config.reasoningEffort }) }
+                : delivery.inspectOwnerModelSelection({ authorityId: config.scope.ownerRouteId,
+                    principalId: config.scope.principalId, workspace: config.scope.workspace,
+                    agentPreset: config.scope.preset,
+                    ...(input.sourceAgent === undefined ? {} : { sourceAgent: input.sourceAgent }) }));
+            if (!selected.provider || !selected.model)
+                throw new Error('owner model selection is unavailable');
+            model = Object.freeze({ provider: selected.provider, model: selected.model,
+                ...(selected.reasoningEffort === undefined ? {} : { reasoningEffort: ReasoningEffortId(selected.reasoningEffort) }) });
+            authority.assertCurrent();
+        }
+        catch (error) {
+            modelFailure = errorMessage(error);
+        }
+        // Owner-anchored workflow learning is a separate, purely Host-local track.
+        // It needs only the anchored owner authority and performs no model/network
+        // call, so it runs before the super-relay credential/budget gates. Failure
+        // here never blocks the model-driven skill track below.
+        let ownerAnchored;
+        if (config.workflowOwnerAnchored.enabled) {
+            ownerAnchored = await this.#runOwnerAnchoredTrack({
+                startedAt, authority, goals, delivery: delivery,
+            });
+        }
+        if (model === undefined || modelFailure !== undefined) {
+            this.#health = { lastWakeAt: startedAt, outcome: 'skipped', reason: `missing-model:${modelFailure ?? 'unavailable'}`, run: null, ownerAnchored };
+            return;
+        }
+        try {
+            if (model.provider === 'super-relay') {
+                const { assertCurrentContract } = await import('@dsh-enhanced/assistant-super-relay-budget');
+                assertCurrentContract();
+            }
+        }
+        catch (error) {
+            this.#health = { lastWakeAt: startedAt, outcome: 'skipped', reason: `contract-expired:${errorMessage(error)}`, run: null, ownerAnchored };
+            return;
+        }
+        if (!await this.#resolveCredential(model.provider)) {
+            this.#health = { lastWakeAt: startedAt, outcome: 'skipped', reason: 'missing-credential', run: null, ownerAnchored };
+            return;
+        }
+        if (policy === undefined) {
+            this.#health = { lastWakeAt: startedAt, outcome: 'skipped', reason: 'missing-policy', run: null, ownerAnchored };
+            return;
+        }
+        let reservationId;
+        let reservationSettled = false;
+        let agentSubmitted = false;
+        if (input.usage === undefined && config.budgetId !== null && config.budgetAmount !== null) {
+            try {
+                const reservation = policy.reserve({
+                    budgetId: config.budgetId,
+                    subject: { kind: 'background', id: wakeId, workspace: config.scope.workspace, principal: config.scope.principalId },
+                    amount: config.budgetAmount,
+                    idempotencyKey: `growth-budget:${wakeId}`,
+                });
+                if (reservation.status !== 'reserved') {
+                    this.#health = { lastWakeAt: startedAt, outcome: 'skipped', reason: `budget:${reservation.status}`, run: null, ownerAnchored };
+                    return;
+                }
+                reservationId = reservation.reservationId;
+            }
+            catch (error) {
+                this.#health = { lastWakeAt: startedAt, outcome: 'skipped', reason: `budget:${errorMessage(error)}`, run: null, ownerAnchored };
+                return;
+            }
+        }
+        try {
+            agentSubmitted = true;
+            const bound = this.#sourceBinding;
+            const source = bound !== undefined && bound.available() ? bound : undefined;
+            let sourcePort = source?.port;
+            if (source && input.usage) {
+                const usage = input.usage;
+                const ownGaps = () => {
+                    usage.assertCurrent();
+                    return usage.source.canonical.objective?.status === 'not-achieved'
+                        ? [source.recordTaskFailure(usage.source)] : [];
+                };
+                // Persist the exact failure before submitting the model; neither a
+                // model assertion nor an operator's global gap is a prerequisite.
+                ownGaps();
+                const assertGap = (gapId) => {
+                    if (!ownGaps().some(gap => gap.id === gapId && gap.status === 'open' && gap.candidateId === undefined)) {
+                        throw new Error('source gap is not the current task failure');
+                    }
+                };
+                sourcePort = { ...source.port, listOpenGaps: ownGaps,
+                    prepareModifySourcePlan: request => { assertGap(request.gapId); return source.port.prepareModifySourcePlan(request); },
+                    enqueueSourceJob: request => { assertGap(request.gapId); return source.port.enqueueSourceJob(request); },
+                };
+            }
+            const run = await runGrowthAgent(this.ctx, { wakeId, authority, config, model, goals, skills,
+                ...(sourcePort === undefined ? {} : { sourcePlane: sourcePort }),
+                ...(input.usage === undefined ? {} : { feedback: input.usage.source }),
+                signal: AbortSignal.any([this.#abort.signal, ...(source === undefined ? [] : [source.signal]),
+                    ...(input.usage === undefined ? [] : [input.usage.signal])]),
+            });
+            if (reservationId !== undefined) {
+                policy.finalize(reservationId, config.budgetAmount);
+                reservationSettled = true;
+            }
+            this.#health = { lastWakeAt: startedAt, outcome: 'ran', reason: run.outcome, run, ownerAnchored };
+        }
+        catch (error) {
+            if (reservationId !== undefined && !reservationSettled) {
+                // The agent factory may already have submitted a request: charge the
+                // reservation conservatively rather than release potentially-spent budget.
+                try {
+                    if (agentSubmitted)
+                        policy.finalize(reservationId, config.budgetAmount);
+                    else
+                        policy.release(reservationId);
+                }
+                catch { /* leave the reservation ledger state visible for the owner */ }
+            }
+            this.#health = { lastWakeAt: startedAt, outcome: 'failed', reason: errorMessage(error), run: null, ownerAnchored };
+            this.ctx.logger.warn(`assistant-growth-driver: wake ${wakeId} failed: ${errorMessage(error)}`);
+        }
+    }
+    /**
+     * The owner-anchored workflow track. It only enumerates recently completed
+     * owner goals and asks Delivery to independently re-verify and (if the goal
+     * honestly reduces to one no-tool agent turn) record a paused candidate. The
+     * driver passes ONLY a locator plus the bounded authority — never a prompt,
+     * steps or an acceptance verdict — and it never approves, activates or
+     * installs anything. A goal that fails the owner-root/achieved evidence bar
+     * is skipped; an infrastructure, policy, authority or live-route mismatch
+     * fails closed and halts the track for this wake.
+     */
+    async #runOwnerAnchoredTrack(input) {
+        const trackConfig = this.#config.workflowOwnerAnchored;
+        const summary = {
+            considered: 0, attempted: 0, recorded: 0, replayed: 0, abstained: 0, stopped: null,
+        };
+        let records;
+        try {
+            records = input.goals.inspectOwnerGoals(input.authority.scope, 50);
+        }
+        catch (error) {
+            return { ...summary, stopped: `inspect:${errorMessage(error)}` };
+        }
+        const cutoff = input.startedAt - trackConfig.lookbackMs;
+        // Coarse discovery filter only; the whole-goal succeeded/quiescent/achieved
+        // and owner-root checks are Delivery's single source of truth at commit.
+        const candidates = records.filter(record => record.native.phase === 'complete' && record.updatedAt >= cutoff);
+        const mutable = { ...summary };
+        mutable.considered = candidates.length;
+        for (const record of candidates) {
+            if (mutable.attempted >= trackConfig.maxCommitsPerWake)
+                break;
+            try {
+                // Re-anchor before every commit: a revoked/rebound owner route or a
+                // principal generation change aborts the rest of the track.
+                input.authority.assertCurrent();
+            }
+            catch (error) {
+                mutable.stopped = `authority:${errorMessage(error)}`;
+                break;
+            }
+            // Every locator field comes from the anchored authority (never from the
+            // enumerated record or a caller-supplied prompt); only the per-goal
+            // sessionId/goalId identify which owner success to re-verify.
+            const { principalId, workspace, preset } = input.authority.scope;
+            const locator = {
+                ownerRouteId: input.authority.ownerRouteId,
+                principalId,
+                workspace,
+                preset,
+                sessionId: record.native.sessionId,
+                goalId: record.id,
+            };
+            mutable.attempted += 1;
+            try {
+                const result = await input.delivery.commitOwnerAnchoredWorkflowTrace({ locator, authority: input.authority });
+                if (result.outcome === 'abstained')
+                    mutable.abstained += 1;
+                else if (result.replayed)
+                    mutable.replayed += 1;
+                else
+                    mutable.recorded += 1;
+            }
+            catch (error) {
+                const code = error?.code;
+                const message = errorMessage(error);
+                if (code === 'runtime-unavailable' || code === 'policy-denied' || code === 'runtime-conflict'
+                    || /live owner route|owner route changed|authority expired/u.test(message)) {
+                    mutable.stopped = `${typeof code === 'string' ? code : 'error'}:${message}`;
+                    break;
+                }
+                // Otherwise this completed goal is merely not learnable right now
+                // (no current achieved receipt, not owner-root, etc.); keep scanning.
+            }
+        }
+        return Object.freeze(mutable);
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function apply(ctx, input = {}) {
+    new AssistantGrowthDriverService(ctx, input);
+}
+export default { name, Config, inject: AssistantGrowthDriverService.inject, apply, version };
+//# 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/source-edits.d.ts

@@ -0,0 +1,22 @@
+import type { GrowthSourcePreparedFile } from './source-port.js';
+export declare const MAX_SOURCE_FILES = 64;
+export declare const MAX_SOURCE_FILE_BYTES = 65536;
+export declare const MAX_SOURCE_TOTAL_BYTES = 262144;
+export interface SourceEdit {
+    readonly path: string;
+    readonly before: string;
+    readonly after: string;
+}
+export interface SourceEditSnapshot {
+    readonly paths: ReadonlySet<string>;
+    readonly read: ReadonlyMap<string, string>;
+}
+/**
+ * Expand bounded exact-literal edits against the original committed read cache.
+ * The returned files remain the control-plane's existing full-file contract.
+ */
+export declare function resolveSourcePreparation(input: {
+    readonly files?: readonly GrowthSourcePreparedFile[];
+    readonly edits?: readonly SourceEdit[];
+}, snapshot: SourceEditSnapshot, validPath: (path: string) => boolean): readonly GrowthSourcePreparedFile[];
+//# sourceMappingURL=source-edits.d.ts.map

package/lib/source-edits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-edits.d.ts","sourceRoot":"","sources":["../src/source-edits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAEhE,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAC3C,eAAO,MAAM,sBAAsB,SAAU,CAAA;AAE7C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3C;AAYD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,EACvG,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACnC,SAAS,wBAAwB,EAAE,CAoDrC"}

package/lib/source-edits.js

@@ -0,0 +1,77 @@
+export const MAX_SOURCE_FILES = 64;
+export const MAX_SOURCE_FILE_BYTES = 65_536;
+export const MAX_SOURCE_TOTAL_BYTES = 262_144;
+function bytes(value) {
+    return Buffer.byteLength(value, 'utf8');
+}
+function soleOccurrence(text, needle) {
+    const first = text.indexOf(needle);
+    if (first < 0 || text.indexOf(needle, first + 1) >= 0)
+        return -1;
+    return first;
+}
+/**
+ * Expand bounded exact-literal edits against the original committed read cache.
+ * The returned files remain the control-plane's existing full-file contract.
+ */
+export function resolveSourcePreparation(input, snapshot, validPath) {
+    const { files, edits } = input;
+    if ((files !== undefined && !Array.isArray(files)) || (edits !== undefined && !Array.isArray(edits))) {
+        throw new Error('source preparation files and edits must be arrays');
+    }
+    if ((files?.length ?? 0) + (edits?.length ?? 0) === 0) {
+        throw new Error('source preparation requires nonempty files or edits');
+    }
+    const fullFiles = files ?? [];
+    const exactEdits = edits ?? [];
+    if (fullFiles.length + exactEdits.length > MAX_SOURCE_FILES)
+        throw new Error('source proposal operations exceed bounds');
+    const fullPaths = new Set();
+    for (const file of fullFiles) {
+        if (file === null || typeof file.path !== 'string' || typeof file.content !== 'string'
+            || !validPath(file.path) || bytes(file.content) > MAX_SOURCE_FILE_BYTES)
+            throw new Error('source files exceed proposal bounds');
+        if (fullPaths.has(file.path))
+            throw new Error('source preparation has duplicate full-file paths');
+        fullPaths.add(file.path);
+        if (snapshot.paths.has(file.path) && !snapshot.read.has(file.path))
+            throw new Error('existing source files must be read before replacement');
+    }
+    const byPath = new Map();
+    for (const edit of exactEdits) {
+        if (edit === null || typeof edit.path !== 'string' || typeof edit.before !== 'string' || typeof edit.after !== 'string'
+            || !validPath(edit.path) || edit.before.length === 0 || bytes(edit.before) > MAX_SOURCE_FILE_BYTES || bytes(edit.after) > MAX_SOURCE_FILE_BYTES) {
+            throw new Error('source edits exceed proposal bounds');
+        }
+        if (fullPaths.has(edit.path))
+            throw new Error('source preparation files and edits must target disjoint paths');
+        const original = snapshot.read.get(edit.path);
+        if (original === undefined || !snapshot.paths.has(edit.path))
+            throw new Error('source edits require an already-read existing source file');
+        const start = soleOccurrence(original, edit.before);
+        if (start < 0)
+            throw new Error('source edit anchor must have one exact literal occurrence in the original read content');
+        const intervals = byPath.get(edit.path) ?? [];
+        intervals.push({ start, end: start + edit.before.length, after: edit.after });
+        byPath.set(edit.path, intervals);
+    }
+    const resolved = [...fullFiles];
+    for (const [path, intervals] of byPath) {
+        const ascending = [...intervals].sort((left, right) => left.start - right.start);
+        for (let index = 1; index < ascending.length; index += 1) {
+            if (ascending[index - 1].end > ascending[index].start)
+                throw new Error('source edits overlap in the original read content');
+        }
+        let content = snapshot.read.get(path);
+        for (const interval of ascending.reverse())
+            content = content.slice(0, interval.start) + interval.after + content.slice(interval.end);
+        if (bytes(content) > MAX_SOURCE_FILE_BYTES)
+            throw new Error('resolved source file exceeds proposal bounds');
+        resolved.push({ path, content });
+    }
+    if (resolved.length === 0 || resolved.length > MAX_SOURCE_FILES || resolved.reduce((sum, file) => sum + bytes(file.content), 0) > MAX_SOURCE_TOTAL_BYTES) {
+        throw new Error('resolved source files exceed proposal bounds');
+    }
+    return resolved;
+}
+//# sourceMappingURL=source-edits.js.map