@dsh-enhanced/assistant-skills 0.1.30

package/lib/repair-agent.js

@@ -0,0 +1,241 @@
+import { createHash } from 'node:crypto';
+import { acceptanceDigest } from '@dsh-enhanced/task-acceptance-contract';
+import { installModelSelection } from '@deepseek-ai/dsh-agent';
+import {} from '@deepseek-ai/dsh-llm';
+import { SessionId } from '@deepseek-ai/dsh-session';
+const validText = (value, max = 4_096) => typeof value === 'string' && value.length > 0 && value.length <= max;
+const validCount = (value, min = 1) => typeof value === 'number' && Number.isSafeInteger(value) && value >= min && value <= 1_000_000_000;
+const sessionIdFor = (authorizationId) => SessionId(`owner-repair-${createHash('sha256').update(authorizationId).digest('hex').slice(0, 40)}`);
+function validate(input) {
+    if (!validText(input.id) || !validText(input.authorizationDigest) || !validText(input.ownerRouteId)
+        || !validText(input.objective, 16_384) || !validText(input.provider) || !validText(input.model)
+        || !validCount(input.maxGoalRounds) || !validCount(input.maxModelCalls) || !validCount(input.maxToolCalls, 0)
+        || !validCount(input.maxOutputTokens) || !validCount(input.maxDurationMs) || !Number.isSafeInteger(input.expiresAt)
+        || input.expiresAt <= Date.now() || typeof input.assertCurrent !== 'function'
+        || !Array.isArray(input.allowedTools) || input.allowedTools.length > 256 || input.allowedTools.some(tool => !validText(tool, 256))
+        || input.iteration !== undefined && (!validCount(input.iteration) || input.iteration > 4)
+        || input.initialModelCalls !== undefined && (!validCount(input.initialModelCalls, 0) || input.initialModelCalls > input.maxModelCalls)
+        || input.initialToolCalls !== undefined && (!validCount(input.initialToolCalls, 0) || input.initialToolCalls > input.maxToolCalls)
+        || input.recordUsage !== undefined && typeof input.recordUsage !== 'function'
+        || new Set(input.allowedTools).size !== input.allowedTools.length)
+        throw new Error('assistant-skills: invalid owner repair Agent input');
+}
+/**
+ * Owns short-lived Agents for already-authorized repair Goals.  It deliberately
+ * does not submit a user message: the mounted native goal-round driver is the
+ * only continuation producer after Goals creates the armed native goal.
+ */
+export class OwnerRepairAgentRuntime {
+    ctx;
+    #handles = new Map();
+    #attempted = new Set();
+    #toolSchemaDigests = new Map();
+    #controllers = new Map();
+    #authorizationSessions = new Map();
+    #inflight = new Map();
+    #disposeFlight;
+    #disposed = false;
+    constructor(ctx) {
+        this.ctx = ctx;
+        ctx.effect(() => () => this.dispose(), 'assistant-skills.owner-repair-agents');
+    }
+    get(sessionId) { return this.#handles.get(sessionId)?.agent; }
+    async create(input, signal) {
+        if (this.#disposed)
+            throw new Error('assistant-skills: owner repair Agent runtime disposed');
+        validate(input);
+        input.assertCurrent();
+        const sessionId = sessionIdFor(`${input.id}:${input.iteration ?? 1}`);
+        const key = String(sessionId);
+        if (this.#attempted.has(key))
+            throw new Error('assistant-skills: owner repair Agent creation is not retry-safe');
+        this.#attempted.add(key);
+        const sessions = this.#authorizationSessions.get(input.id) ?? new Set();
+        sessions.add(key);
+        this.#authorizationSessions.set(input.id, sessions);
+        const creation = this.#create(sessionId, key, input, signal);
+        this.#inflight.set(key, creation);
+        try {
+            return await creation;
+        }
+        finally {
+            this.#inflight.delete(key);
+        }
+    }
+    async #create(sessionId, key, input, signal) {
+        const deadline = new AbortController();
+        this.#controllers.set(key, deadline);
+        const timer = setTimeout(() => deadline.abort(new Error('assistant-skills: owner repair Agent deadline exceeded')), Math.min(input.maxDurationMs, input.expiresAt - Date.now()));
+        timer.unref?.();
+        const combined = signal === undefined ? deadline.signal : AbortSignal.any([signal, deadline.signal]);
+        let handle;
+        let retained = false;
+        try {
+            const agents = this.ctx.get('agents');
+            const goals = this.ctx.get('assistantGoals', false);
+            const policy = this.ctx.get('assistantPolicy', false);
+            if (agents === undefined || goals === undefined || policy === undefined)
+                throw new Error('assistant-skills: repair Agent dependencies unavailable');
+            handle = await agents.create({ sessionId, meta: { cwd: input.scope.workspace, agentPreset: input.scope.preset },
+                agentOptions: { provider: input.provider, model: input.model, maxTokens: input.maxOutputTokens }, signal: combined,
+                setup: async (agentCtx) => {
+                    const agent = agentCtx.agent;
+                    if (agent === undefined)
+                        throw new Error('assistant-skills: unpublished repair Agent is unavailable');
+                    input.assertCurrent();
+                    combined.throwIfAborted();
+                    // Establish background authority and cancellation before mounting preset effects.
+                    this.#setupRepairAgent(agentCtx, agent, input, combined, timer);
+                    const presets = this.ctx.get('agentPresets', false);
+                    if (presets !== undefined) {
+                        const preset = await presets.resolve(input.scope.preset);
+                        input.assertCurrent();
+                        combined.throwIfAborted();
+                        if (preset.id !== input.scope.preset)
+                            throw new Error('assistant-skills: repair preset changed');
+                        await presets.mount(agentCtx, preset.id);
+                    }
+                    input.assertCurrent();
+                    combined.throwIfAborted();
+                    this.#checkRepairTools(agentCtx, agent, input);
+                },
+            });
+            input.assertCurrent();
+            combined.throwIfAborted();
+            this.#handles.set(key, handle);
+            const repair = { authorizationId: input.id, authorizationDigest: input.authorizationDigest,
+                ownerRouteId: input.ownerRouteId, scope: input.scope, trigger: input.trigger, objective: input.objective,
+                maxGoalRounds: input.maxGoalRounds, expiresAt: input.expiresAt };
+            const currentGoals = this.ctx.get('assistantGoals', false);
+            if (currentGoals === undefined)
+                throw new Error('assistant-skills: repair Goals service changed');
+            const record = await currentGoals.startOwnerAuthorizedRepair(handle.agent, repair, input.assertCurrent);
+            retained = true;
+            return { sessionId: key, goalId: record.id };
+        }
+        catch (error) {
+            deadline.abort(new Error('assistant-skills: repair Agent creation failed'));
+            this.#handles.delete(key);
+            this.#toolSchemaDigests.delete(key);
+            if (handle !== undefined)
+                await handle.dispose();
+            throw error;
+        }
+        finally {
+            if (!retained) {
+                this.#controllers.delete(key);
+                clearTimeout(timer);
+            }
+        }
+    }
+    #checkRepairTools(agentCtx, agent, input) {
+        const allowed = new Set(input.allowedTools);
+        const globalNames = agentCtx.tools.schemas().map(schema => schema.name);
+        const mountedNames = agentCtx.tools.schemas(agent).map(schema => schema.name);
+        for (const name of allowed) {
+            if (!mountedNames.includes(name))
+                throw new Error(`assistant-skills: unknown repair allowlist tool: ${name}`);
+        }
+        const denied = globalNames.filter(name => !allowed.has(name));
+        if (denied.length > 0)
+            agentCtx.tools.restrict({ deny: denied });
+        this.#toolSchemaDigests.set(String(agent.session.id), acceptanceDigest(agentCtx.tools.schemas(agent).filter(tool => allowed.has(tool.name)).sort((a, b) => a.name.localeCompare(b.name))));
+        // Pinned DSH restrict() masks globals only. Preset-local registrations stay
+        // in their owning scope; model presentation and the monotonic execution
+        // guard below enforce the frozen allowlist for both kinds of tool.
+    }
+    #setupRepairAgent(agentCtx, agent, input, combined, timer) {
+        const policy = this.ctx.get('assistantPolicy', false);
+        if (policy === undefined)
+            throw new Error('assistant-skills: repair policy changed');
+        agentCtx.effect(() => policy.bindInitiator(agent, 'background', input.scope.principalId), 'assistant-skills.owner-repair-initiator');
+        agentCtx.effect(() => installModelSelection(agentCtx, { current: { provider: input.provider, model: input.model }, assembled: undefined }), 'assistant-skills.owner-repair-model');
+        const allowed = new Set(input.allowedTools);
+        const schemaDigests = this.#toolSchemaDigests;
+        agentCtx.on('system-prompt/assemble', async (_assembly, context, next) => {
+            const assembly = await next();
+            if (context.agent !== agent)
+                return assembly;
+            return { ...assembly, tools: assembly.tools.filter(tool => allowed.has(tool.name)).sort((a, b) => a.name.localeCompare(b.name)) };
+        });
+        let calls = input.initialModelCalls ?? 0;
+        let toolCalls = input.initialToolCalls ?? 0;
+        agentCtx.on('llm/stream', async function* (options, next) {
+            // Cordis service event filtering follows service realms, not Agent identity.
+            // The native loop stamps this immutable Session id on every request.
+            if (options.sessionId !== agent.session.id) {
+                yield* next();
+                return;
+            }
+            input.assertCurrent();
+            combined.throwIfAborted();
+            if (options.provider !== input.provider || options.model !== input.model || options.maxTokens === undefined || options.maxTokens > input.maxOutputTokens || acceptanceDigest(options.tools ?? []) !== schemaDigests.get(String(agent.session.id)) || calls++ >= input.maxModelCalls) {
+                agent.cancel({ kind: 'hook', reason: 'assistant-skills-owner-repair-model-limit' });
+                throw new Error('assistant-skills: owner repair model request rejected');
+            }
+            input.recordUsage?.('model');
+            for await (const chunk of next()) {
+                combined.throwIfAborted();
+                yield chunk;
+            }
+        });
+        agentCtx.tools.guard(execution => {
+            input.assertCurrent();
+            combined.throwIfAborted();
+            if (!allowed.has(execution.name) || toolCalls >= input.maxToolCalls) {
+                agent.cancel({ kind: 'hook', reason: 'assistant-skills-owner-repair-tool-limit' });
+                return 'assistant-skills: owner repair tool request rejected';
+            }
+            toolCalls += 1;
+            input.recordUsage?.('tool');
+            return undefined;
+        });
+        const abort = () => agent.cancel({ kind: 'hook', reason: 'assistant-skills-owner-repair-expired' });
+        combined.addEventListener('abort', abort, { once: true });
+        agentCtx.effect(() => () => { clearTimeout(timer); combined.removeEventListener('abort', abort); }, 'assistant-skills.owner-repair-deadline');
+    }
+    async closeSession(sessionId) {
+        this.#controllers.get(sessionId)?.abort(new Error('assistant-skills: repair Agent closed'));
+        const creation = this.#inflight.get(sessionId);
+        if (creation !== undefined)
+            await creation.catch(() => undefined);
+        const handle = this.#handles.get(sessionId);
+        if (handle === undefined) {
+            this.#controllers.delete(sessionId);
+            this.#toolSchemaDigests.delete(sessionId);
+            return;
+        }
+        this.#handles.delete(sessionId);
+        this.#controllers.delete(sessionId);
+        await handle.dispose();
+        this.#toolSchemaDigests.delete(sessionId);
+    }
+    async closeAuthorization(authorizationId) {
+        if (!validText(authorizationId))
+            throw new Error('assistant-skills: invalid owner repair authorization id');
+        await Promise.all([...this.#authorizationSessions.get(authorizationId) ?? []].map(sessionId => this.closeSession(sessionId)));
+        this.#authorizationSessions.delete(authorizationId);
+    }
+    async dispose() {
+        return this.#disposeFlight ??= this.#dispose();
+    }
+    async #dispose() {
+        this.#disposed = true;
+        for (const controller of this.#controllers.values())
+            controller.abort(new Error('assistant-skills: repair runtime disposed'));
+        const creations = [...this.#inflight.values()];
+        // A creation rejected because this disposer revoked its signal is already
+        // observable by its caller.  It has no published handle to dispose here.
+        await Promise.allSettled(creations);
+        this.#controllers.clear();
+        this.#toolSchemaDigests.clear();
+        this.#authorizationSessions.clear();
+        const handles = [...this.#handles.entries()];
+        this.#handles.clear();
+        const disposalResults = await Promise.allSettled(handles.map(([, handle]) => handle.dispose()));
+        const errors = disposalResults.flatMap(result => result.status === 'rejected' ? [result.reason] : []);
+        if (errors.length)
+            throw new AggregateError(errors, 'assistant-skills: repair Agent disposal failed');
+    }
+}
+//# sourceMappingURL=repair-agent.js.map

package/lib/repair-agent.js.map

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

package/lib/repair-feedback.d.ts

@@ -0,0 +1,70 @@
+/** Frozen at repair arm time; it never grants a new notification window. */
+export interface RepairFeedbackAuthority {
+    sessionId: string;
+    expiresAt: number;
+    routeReceipt: unknown;
+}
+export interface RepairFeedbackScope {
+    principalId: string;
+    principalRecordId: string;
+    principalVersion: number;
+    workspace: string;
+    preset: string;
+}
+export interface RepairFeedbackRecord {
+    id: string;
+    scope: RepairFeedbackScope;
+    authorization: {
+        ownerRouteId: string;
+    };
+    routeReceipt: unknown;
+    feedbackAuthority: RepairFeedbackAuthority;
+}
+/**
+ * Callers provide only durable repair facts.  Text deliberately excludes
+ * source prompts, model output, paths, and identifiers from the repair work.
+ */
+export type RepairFeedbackMilestone = 'independent-acceptance' | 'candidate-staged' | 'finite-canary' | 'iteration-success' | 'final-success' | 'successor-failed' | 'interrupted' | 'budget-exhausted';
+export interface RepairIterationOutcome {
+    iteration: number;
+    maxIterations: number;
+    state: string;
+    milestone: RepairFeedbackMilestone;
+    candidateId?: string;
+    deploymentId?: string;
+    goalId?: string;
+}
+export interface RepairFeedbackDelivery {
+    validateOwnerRoute(input: {
+        authorityId: string;
+        principalId: string;
+        workspace: string;
+        agentPreset: string;
+    }): unknown;
+    enqueueOwnerNotification(input: {
+        sourceId: string;
+        ownerRouteId: string;
+        scope: RepairFeedbackScope;
+        sessionId: string;
+        idempotencyKey: string;
+        text: string;
+        expiresAt: number;
+    }): unknown;
+}
+export type RepairFeedbackResult = {
+    outcome: 'queued';
+    idempotencyKey: string;
+    text: string;
+} | {
+    outcome: 'not-queued';
+    reason: 'expired' | 'route-not-current' | 'delivery-rejected';
+};
+/** Deterministic, private status text. It never says the original goal is complete or that a person read it. */
+export declare function renderRepairFeedback(outcome: RepairIterationOutcome): string;
+export declare function repairFeedbackIdempotencyKey(record: Pick<RepairFeedbackRecord, 'id'>, outcome: Pick<RepairIterationOutcome, 'iteration' | 'milestone'>): string;
+/**
+ * Queue one already-authorized owner notice. Delivery owns the final send-Policy
+ * check; route, lineage, receipt, session, and expiry are fenced before queueing.
+ */
+export declare function enqueueRepairFeedback(delivery: RepairFeedbackDelivery, record: RepairFeedbackRecord, outcome: RepairIterationOutcome): RepairFeedbackResult;
+//# sourceMappingURL=repair-feedback.d.ts.map

package/lib/repair-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-feedback.d.ts","sourceRoot":"","sources":["../src/repair-feedback.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,mBAAmB,CAAA;IAC1B,aAAa,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,YAAY,EAAE,OAAO,CAAA;IACrB,iBAAiB,EAAE,uBAAuB,CAAA;CAC3C;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAC/B,wBAAwB,GACxB,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,aAAa,GACb,kBAAkB,CAAA;AAEtB,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,uBAAuB,CAAA;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,kBAAkB,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IACxH,wBAAwB,CAAC,KAAK,EAAE;QAC9B,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,mBAAmB,CAAA;QAC1B,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;KAClB,GAAG,OAAO,CAAA;CACZ;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,mBAAmB,GAAG,mBAAmB,CAAA;CAAE,CAAA;AAsC5F,gHAAgH;AAChH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAM5E;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,MAAM,CAG/J;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,sBAAsB,GAAG,oBAAoB,CAkB3J"}

package/lib/repair-feedback.js

@@ -0,0 +1,79 @@
+import { acceptanceDigest } from '@dsh-enhanced/task-acceptance-contract';
+const sourceId = 'dsh-enhanced-assistant-skills';
+const milestones = {
+    'independent-acceptance': 'The repair result received independent acceptance.',
+    'candidate-staged': 'An independently accepted repair candidate was staged.',
+    'finite-canary': 'The staged candidate entered its finite canary evaluation.',
+    'iteration-success': 'The repair iteration completed its independently accepted finite-canary path.',
+    'final-success': 'The finite repair sequence ended with an independently accepted successor after its finite canary path.',
+    'successor-failed': 'The proposed successor did not pass the finite repair sequence.',
+    interrupted: 'The repair sequence stopped after an interruption; its result is unknown.',
+    'budget-exhausted': 'The finite repair budget ended without another authorized successor.',
+};
+function validText(value, max = 512) {
+    return typeof value === 'string' && value.length > 0 && value.length <= max;
+}
+function validPositive(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+}
+function validScope(scope) {
+    return validText(scope.principalId, 1_024) && validText(scope.principalRecordId, 1_024)
+        && validPositive(scope.principalVersion) && validText(scope.workspace, 4_096) && validText(scope.preset, 200);
+}
+function validRecord(record) {
+    return validText(record.id, 512) && validText(record.authorization.ownerRouteId, 512) && validScope(record.scope)
+        && validText(record.feedbackAuthority.sessionId, 512) && Number.isSafeInteger(record.feedbackAuthority.expiresAt)
+        && record.feedbackAuthority.routeReceipt !== undefined && record.routeReceipt !== undefined;
+}
+function validOutcome(outcome) {
+    return validPositive(outcome.iteration) && validPositive(outcome.maxIterations) && outcome.iteration <= outcome.maxIterations
+        && validText(outcome.state, 128) && Object.hasOwn(milestones, outcome.milestone);
+}
+/** Deterministic, private status text. It never says the original goal is complete or that a person read it. */
+export function renderRepairFeedback(outcome) {
+    if (!validOutcome(outcome))
+        throw new Error('assistant-skills: invalid repair feedback outcome');
+    const round = `Repair iteration ${outcome.iteration} of ${outcome.maxIterations}.`;
+    const terminal = outcome.milestone === 'final-success' || outcome.milestone === 'successor-failed'
+        || outcome.milestone === 'interrupted' || outcome.milestone === 'budget-exhausted';
+    return `${round} ${milestones[outcome.milestone]}${terminal ? ' This update reports the bounded repair sequence only; it does not establish that the original objective is complete or that this notice was read.' : ''}`;
+}
+export function repairFeedbackIdempotencyKey(record, outcome) {
+    if (!validText(record.id, 512) || !validPositive(outcome.iteration) || !Object.hasOwn(milestones, outcome.milestone))
+        throw new Error('assistant-skills: invalid repair feedback idempotency input');
+    return `repair-feedback:${record.id}:${outcome.iteration}:${outcome.milestone}`;
+}
+/**
+ * Queue one already-authorized owner notice. Delivery owns the final send-Policy
+ * check; route, lineage, receipt, session, and expiry are fenced before queueing.
+ */
+export function enqueueRepairFeedback(delivery, record, outcome) {
+    if (!validRecord(record) || !validOutcome(outcome))
+        throw new Error('assistant-skills: invalid repair feedback input');
+    if (Date.now() >= record.feedbackAuthority.expiresAt)
+        return { outcome: 'not-queued', reason: 'expired' };
+    // The arm-time receipt and the record receipt must describe the same exact route.
+    if (acceptanceDigest(record.routeReceipt) !== acceptanceDigest(record.feedbackAuthority.routeReceipt))
+        return { outcome: 'not-queued', reason: 'route-not-current' };
+    let receipt;
+    try {
+        receipt = delivery.validateOwnerRoute({ authorityId: record.authorization.ownerRouteId, principalId: record.scope.principalId,
+            workspace: record.scope.workspace, agentPreset: record.scope.preset });
+    }
+    catch {
+        return { outcome: 'not-queued', reason: 'route-not-current' };
+    }
+    if (acceptanceDigest(receipt) !== acceptanceDigest(record.routeReceipt))
+        return { outcome: 'not-queued', reason: 'route-not-current' };
+    const idempotencyKey = repairFeedbackIdempotencyKey(record, outcome);
+    const text = renderRepairFeedback(outcome);
+    try {
+        delivery.enqueueOwnerNotification({ sourceId, ownerRouteId: record.authorization.ownerRouteId, scope: record.scope,
+            sessionId: record.feedbackAuthority.sessionId, idempotencyKey, text, expiresAt: record.feedbackAuthority.expiresAt });
+    }
+    catch {
+        return { outcome: 'not-queued', reason: 'delivery-rejected' };
+    }
+    return { outcome: 'queued', idempotencyKey, text };
+}
+//# sourceMappingURL=repair-feedback.js.map

package/lib/repair-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-feedback.js","sourceRoot":"","sources":["../src/repair-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAkEzE,MAAM,QAAQ,GAAG,+BAA+B,CAAA;AAChD,MAAM,UAAU,GAAsD;IACpE,wBAAwB,EAAE,oDAAoD;IAC9E,kBAAkB,EAAE,wDAAwD;IAC5E,eAAe,EAAE,4DAA4D;IAC7E,mBAAmB,EAAE,+EAA+E;IACpG,eAAe,EAAE,yGAAyG;IAC1H,kBAAkB,EAAE,iEAAiE;IACrF,WAAW,EAAE,2EAA2E;IACxF,kBAAkB,EAAE,sEAAsE;CAC3F,CAAA;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,GAAG,GAAG,GAAG;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAA;AAC7E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAA;AAC9E,CAAC;AAED,SAAS,UAAU,CAAC,KAA0B;IAC5C,OAAO,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC;WAClF,aAAa,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACjH,CAAC;AAED,SAAS,WAAW,CAAC,MAA4B;IAC/C,OAAO,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;WAC5G,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC;WAC9G,MAAM,CAAC,iBAAiB,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,CAAA;AAC/F,CAAC;AAED,SAAS,YAAY,CAAC,OAA+B;IACnD,OAAO,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,aAAa;WACxH,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;AACpF,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IAChG,MAAM,KAAK,GAAG,oBAAoB,OAAO,CAAC,SAAS,OAAO,OAAO,CAAC,aAAa,GAAG,CAAA;IAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,KAAK,eAAe,IAAI,OAAO,CAAC,SAAS,KAAK,kBAAkB;WAC7F,OAAO,CAAC,SAAS,KAAK,aAAa,IAAI,OAAO,CAAC,SAAS,KAAK,kBAAkB,CAAA;IACpF,OAAO,GAAG,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,oJAAoJ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AAC3N,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAwC,EAAE,OAAgE;IACrJ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;IACpM,OAAO,mBAAmB,MAAM,CAAC,EAAE,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAA;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgC,EAAE,MAA4B,EAAE,OAA+B;IACnI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACtH,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,iBAAiB,CAAC,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IACzG,kFAAkF;IAClF,IAAI,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,gBAAgB,CAAC,MAAM,CAAC,iBAAiB,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;IACpK,IAAI,OAAgB,CAAA;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,kBAAkB,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;YAC3H,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1E,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;IAAC,CAAC;IACzE,IAAI,gBAAgB,CAAC,OAAO,CAAC,KAAK,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;IACtI,MAAM,cAAc,GAAG,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpE,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;IAC1C,IAAI,CAAC;QACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK;YAChH,SAAS,EAAE,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC,CAAA;IACzH,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;IAAC,CAAC;IACzE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,CAAA;AACpD,CAAC"}

package/lib/repair-profile.d.ts

@@ -0,0 +1,27 @@
+import type { GoalScope } from '@dsh-enhanced/assistant-goals';
+import type { ExternalHoldoutProfile } from './external-holdout.js';
+import type { SkillBinding } from './definition.js';
+/** Operator configuration. Owner tools select an id; they cannot supply code or evaluator inputs. */
+export interface RepairContinuationProfile {
+    id: string;
+    scope: GoalScope;
+    skillName: string;
+    taskFamilyId: string;
+    description: string;
+    bindings?: readonly SkillBinding[];
+    externalHoldoutProfileId: string;
+    provider: string;
+    model: string;
+    allowedTools: readonly string[];
+    maxGoalRounds: number;
+    maxModelCalls: number;
+    maxToolCalls: number;
+    maxOutputTokens: number;
+    maxDurationMs: number;
+    canaryRuns: number;
+    maxCanaryRuns: number;
+    maxIterations?: number;
+    followupProfileIds?: readonly string[];
+}
+export declare function validateRepairProfiles(values: unknown, holdouts: readonly ExternalHoldoutProfile[]): readonly RepairContinuationProfile[];
+//# sourceMappingURL=repair-profile.d.ts.map

package/lib/repair-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-profile.d.ts","sourceRoot":"","sources":["../src/repair-profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,qGAAqG;AACrG,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAClC,wBAAwB,EAAE,MAAM,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAQD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,yBAAyB,EAAE,CAkCzI"}

package/lib/repair-profile.js

@@ -0,0 +1,51 @@
+import { isAbsolute } from 'node:path';
+import { acceptanceDigest } from '@dsh-enhanced/task-acceptance-contract';
+const plain = (value) => value !== null && typeof value === 'object'
+    && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype && Object.getOwnPropertySymbols(value).length === 0
+    && Object.values(Object.getOwnPropertyDescriptors(value)).every(item => item.enumerable && 'value' in item);
+const bounded = (value, max) => typeof value === 'string' && value.length > 0 && value.length <= max && !value.includes('\0');
+const integer = (value, min, max) => Number.isSafeInteger(value) && Number(value) >= min && Number(value) <= max;
+export function validateRepairProfiles(values, holdouts) {
+    if (!Array.isArray(values) || values.length > 32)
+        throw new Error('assistant-skills: invalid repair profiles');
+    const allowed = ['id', 'scope', 'skillName', 'taskFamilyId', 'description', 'bindings', 'externalHoldoutProfileId', 'provider', 'model', 'allowedTools', 'maxGoalRounds', 'maxModelCalls', 'maxToolCalls', 'maxOutputTokens', 'maxDurationMs', 'canaryRuns', 'maxCanaryRuns', 'maxIterations', 'followupProfileIds'];
+    const profiles = values.map((value) => {
+        if (!plain(value) || Object.keys(value).some(key => !allowed.includes(key)) || !plain(value.scope)
+            || Object.keys(value.scope).sort().join(',') !== 'preset,principalId,principalRecordId,principalVersion,workspace'
+            || !bounded(value.scope.principalId, 4096) || !bounded(value.scope.principalRecordId, 4096) || !integer(value.scope.principalVersion, 1, Number.MAX_SAFE_INTEGER)
+            || !bounded(value.scope.workspace, 4096) || !isAbsolute(value.scope.workspace) || !bounded(value.scope.preset, 4096)
+            || !bounded(value.id, 128) || !bounded(value.taskFamilyId, 128) || !bounded(value.description, 4096)
+            || !bounded(value.skillName, 64) || !/^[a-z](?:[a-z0-9-]{0,62}[a-z0-9])?$/u.test(value.skillName)
+            || !bounded(value.provider, 256) || !bounded(value.model, 256) || !bounded(value.externalHoldoutProfileId, 128)
+            || !Array.isArray(value.allowedTools) || value.allowedTools.length < 1 || value.allowedTools.length > 32
+            || value.allowedTools.some(tool => !bounded(tool, 128) || !/^[a-zA-Z][a-zA-Z0-9_-]*$/u.test(tool))
+            || new Set(value.allowedTools).size !== value.allowedTools.length
+            || !integer(value.maxGoalRounds, 1, 32) || !integer(value.maxModelCalls, 1, 128) || !integer(value.maxToolCalls, 1, 512)
+            || !integer(value.maxOutputTokens, 1, 65536) || !integer(value.maxDurationMs, 1000, 300000)
+            || !integer(value.canaryRuns, 1, 32) || !integer(value.maxCanaryRuns, Number(value.canaryRuns), 100)
+            || value.maxIterations !== undefined && !integer(value.maxIterations, 1, 4)
+            || value.followupProfileIds !== undefined && (!Array.isArray(value.followupProfileIds) || value.followupProfileIds.length > (Number(value.maxIterations ?? 1) - 1)
+                || value.followupProfileIds.some(id => !bounded(id, 128)) || new Set(value.followupProfileIds).size !== value.followupProfileIds.length))
+            throw new Error('assistant-skills: invalid repair profile');
+        // The repair model cannot mint goals, authorize continuations, or promote itself.
+        if (value.allowedTools.some(tool => /^(?:skill_|goal_create$|goal_control$|set_goal$|update_goal$)/u.test(tool)))
+            throw new Error('assistant-skills: repair tool authority exceeds fixed scope');
+        if (value.bindings !== undefined && (!Array.isArray(value.bindings) || value.bindings.length > 32 || value.bindings.some(binding => !plain(binding)
+            || Object.keys(binding).sort().join(',') !== 'name,path,stepId' || !bounded(binding.name, 128) || !bounded(binding.stepId, 128) || !bounded(binding.path, 1024))))
+            throw new Error('assistant-skills: invalid repair bindings');
+        const holdout = holdouts.find(item => item.id === value.externalHoldoutProfileId && acceptanceDigest(item.scope) === acceptanceDigest(value.scope));
+        if (!holdout?.authority.generatorDigest || !holdout.canaryAdmissionTemplate || holdout.canaryAdmissionTemplate.skillName !== value.skillName)
+            throw new Error('assistant-skills: repair requires a scoped prospective holdout template');
+        return { ...structuredClone(value), maxIterations: value.maxIterations ?? 1 };
+    });
+    if (new Set(profiles.map(value => acceptanceDigest([value.scope, value.id]))).size !== profiles.length)
+        throw new Error('assistant-skills: duplicate repair profile');
+    for (const profile of profiles)
+        for (const id of profile.followupProfileIds ?? []) {
+            const next = profiles.find(value => value.id === id && acceptanceDigest(value.scope) === acceptanceDigest(profile.scope));
+            if (!next || next.id === profile.id)
+                throw new Error('assistant-skills: invalid repair followup profile');
+        }
+    return Object.freeze(profiles.map(value => Object.freeze(value)));
+}
+//# sourceMappingURL=repair-profile.js.map

package/lib/repair-profile.js.map

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

package/lib/repair-runtime.d.ts

@@ -0,0 +1,35 @@
+import type { SkillRepairContinuation, SkillRepairNextIterationInput } from './store.js';
+import { SkillStore } from './store.js';
+export interface RepairRuntimePorts {
+    inspectTrigger(record: SkillRepairContinuation, signal: AbortSignal): Promise<unknown | undefined>;
+    createRepair(record: SkillRepairContinuation, evidence: unknown, signal: AbortSignal): Promise<{
+        sessionId: string;
+        goalId: string;
+    }>;
+    inspectRepair(record: SkillRepairContinuation, signal: AbortSignal): Promise<'running' | 'achieved' | 'rejected'>;
+    capture(record: SkillRepairContinuation, signal: AbortSignal): Promise<{
+        candidateId: string;
+    }>;
+    compare(record: SkillRepairContinuation, signal: AbortSignal): Promise<{
+        deploymentId: string;
+    }>;
+    inspectDeployment(record: SkillRepairContinuation, signal: AbortSignal): Promise<'watching' | 'complete' | 'rejected'>;
+    inspectNextIteration?(record: SkillRepairContinuation, signal: AbortSignal): Promise<SkillRepairNextIterationInput | undefined>;
+    assertNextIteration?(record: SkillRepairContinuation, input: SkillRepairNextIterationInput): void;
+    assertCurrent(record: SkillRepairContinuation): void;
+}
+/**
+ * Host-owned finite continuation driver. A successor iteration requires a
+ * validated new source and the frozen profile sequence before Store advances it.
+ */
+export declare class RepairContinuationRuntime {
+    #private;
+    readonly store: SkillStore;
+    readonly ports: RepairRuntimePorts;
+    constructor(store: SkillStore, ports: RepairRuntimePorts);
+    recover(scope: object, id: string): SkillRepairContinuation | undefined;
+    tick(scope: object, id: string): Promise<SkillRepairContinuation>;
+    tickAll(): Promise<readonly SkillRepairContinuation[]>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=repair-runtime.d.ts.map

package/lib/repair-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-runtime.d.ts","sourceRoot":"","sources":["../src/repair-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,6BAA6B,EAAoB,MAAM,YAAY,CAAA;AAC1G,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IAClG,YAAY,CAAC,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrI,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC,CAAA;IACjH,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/F,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChG,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC,CAAA;IACtH,oBAAoB,CAAC,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,6BAA6B,GAAG,SAAS,CAAC,CAAA;IAC/H,mBAAmB,CAAC,CAAC,MAAM,EAAE,uBAAuB,EAAE,KAAK,EAAE,6BAA6B,GAAG,IAAI,CAAA;IACjG,aAAa,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAA;CACrD;AAmBD;;;GAGG;AACH,qBAAa,yBAAyB;;IAOxB,QAAQ,CAAC,KAAK,EAAE,UAAU;IAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB;gBAArD,KAAK,EAAE,UAAU,EAAW,KAAK,EAAE,kBAAkB;IAE1E,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAQvE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IASjE,OAAO,IAAI,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC;IAqBtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqFzB"}