@dsh-cc/subagent-resume-pins 0.5.0

package/lib/gate.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pinned resume descriptors for continuable background subagents.
+ *
+ * This unit ships the pin schema + tolerant reader/writer, the per-child
+ * {@link PinStore}, the definition fingerprint utilities, the pure gate and
+ * overlay layers, the `subagents-resume` policy namespace, and the cordis
+ * plugin (gate + overlay + notices + settings). The spawn capture lives in
+ * `@dsh-cc/subagent-task` (it is cordis-facing on the Task tool side).
+ *
+ * @module @dsh-cc/subagent-resume-pins
+ */
+export { PinParseError, parsePin, writePin, canonicalJson, PIN_VERSION } from './pin.ts';
+export type { ResumePin, ResumePinDraft, PinDefinition, PinDefinitionSource, PinEffective, PinModelSelector, PinMode, PinResume, PinToolFilter, PinWorkspace, ModelSelectorVia, } from './pin.ts';
+export { PinStore, type CorruptPin } from './store.ts';
+export { definitionFingerprint, personaHash, sha256Prefixed } from './fingerprint.ts';
+export { RESUME_POLICY_DEFAULTS, RESUME_POLICY_NAMESPACE, readResumePolicy, type OnDefinitionChanged, type OnUnavailableModel, type OnWorkspaceChanged, type ResumePolicy, } from './policy.ts';
+export { evaluateGate, type DenyCode, type GateDecision, type GateDetailedRoute, type GateEnv, type GateResolvedConfig, } from './gate.ts';
+export { PinBlockedError, applyPinOverlay } from './overlay.ts';
+export { RESUME_PIN_STORE, ResumePolicySchema, apply as applyResumePinsPlugin, name as resumePinsPluginName, type ResumePinsPluginConfig, } from './plugin.ts';
+export { apply, name } from './plugin.ts';
+export type { OverlayTuple } from './pin.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACxF,YAAY,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,IAAI,qBAAqB,EAC9B,IAAI,IAAI,oBAAoB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}

package/lib/index.js

@@ -0,0 +1,22 @@
+/**
+ * Pinned resume descriptors for continuable background subagents.
+ *
+ * This unit ships the pin schema + tolerant reader/writer, the per-child
+ * {@link PinStore}, the definition fingerprint utilities, the pure gate and
+ * overlay layers, the `subagents-resume` policy namespace, and the cordis
+ * plugin (gate + overlay + notices + settings). The spawn capture lives in
+ * `@dsh-cc/subagent-task` (it is cordis-facing on the Task tool side).
+ *
+ * @module @dsh-cc/subagent-resume-pins
+ */
+export { PinParseError, parsePin, writePin, canonicalJson, PIN_VERSION } from "./pin.js";
+export { PinStore } from "./store.js";
+export { definitionFingerprint, personaHash, sha256Prefixed } from "./fingerprint.js";
+export { RESUME_POLICY_DEFAULTS, RESUME_POLICY_NAMESPACE, readResumePolicy, } from "./policy.js";
+export { evaluateGate, } from "./gate.js";
+export { PinBlockedError, applyPinOverlay } from "./overlay.js";
+export { RESUME_PIN_STORE, ResumePolicySchema, apply as applyResumePinsPlugin, name as resumePinsPluginName, } from "./plugin.js";
+// cordis-plugin-loader unwrapExports mounts the package root: it needs the
+// canonical `apply`/`name`, not just the aliases above.
+export { apply, name } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAcxF,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,GAKjB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,GAMb,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,IAAI,qBAAqB,EAC9B,IAAI,IAAI,oBAAoB,GAE7B,MAAM,aAAa,CAAA;AACpB,2EAA2E;AAC3E,wDAAwD;AACxD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA"}

package/lib/overlay.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Request-time overlay (plan §4.8): apply one pin's pinned runtime tuple onto
+ * a resolved request config AFTER the waterfall's `next()`, with explicit
+ * presence semantics — a pinned non-`null` field is SET, a pinned `null`
+ * field's key is REMOVED (assigning `null` is not absence: `prepareCall`
+ * would keep filling its adapter default), and a degraded pin touches only
+ * explicitly-present fields.
+ *
+ * Pure: no cordis, no IO. The `agent/request` listener calls this per turn of
+ * a pinned child, so options cannot revert to current defaults on any resume
+ * path, including ones that bypass the gate.
+ *
+ * @module @dsh-cc/subagent-resume-pins/overlay
+ */
+import type { ResumePin } from './pin.ts';
+/** Thrown when a request is built for a blocked child (defense-in-depth). */
+export declare class PinBlockedError extends Error {
+    constructor(reason: string);
+}
+/**
+ * Overlay the pin onto one resolved request config.
+ * - `resume.state === 'blocked'` → throws {@link PinBlockedError}: an
+ *   unmonitored resume of a blocked child fails visibly instead of silently
+ *   substituting.
+ * - `resume.overlay` present (gate-evaluated route-current) → applied with
+ *   the same presence semantics; it is a cache recomputed on every gate
+ *   evaluation, never authoritative on its own.
+ * - Complete pin → the whole pinned tuple, absence included (a pinned-`null`
+ *   key is removed, not nulled).
+ * - Degraded pin (`complete:false`) → only explicitly-present pinned fields.
+ * @param resolved - the resolved request config.
+ * @param pin - the child's pin.
+ * @returns a shallow copy carrying the pin (input untouched — the seed may be
+ *   frozen), or the input object when the pin contributes nothing.
+ */
+export declare function applyPinOverlay<T extends Record<string, unknown>>(resolved: T, pin: ResumePin): T;
+//# sourceMappingURL=overlay.d.ts.map

package/lib/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,UAAU,CAAA;AAEvD,6EAA6E;AAC7E,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,MAAM,EAAE,MAAM;CAI3B;AA0BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,CAAC,CAajG"}

package/lib/overlay.js

@@ -0,0 +1,80 @@
+/**
+ * Request-time overlay (plan §4.8): apply one pin's pinned runtime tuple onto
+ * a resolved request config AFTER the waterfall's `next()`, with explicit
+ * presence semantics — a pinned non-`null` field is SET, a pinned `null`
+ * field's key is REMOVED (assigning `null` is not absence: `prepareCall`
+ * would keep filling its adapter default), and a degraded pin touches only
+ * explicitly-present fields.
+ *
+ * Pure: no cordis, no IO. The `agent/request` listener calls this per turn of
+ * a pinned child, so options cannot revert to current defaults on any resume
+ * path, including ones that bypass the gate.
+ *
+ * @module @dsh-cc/subagent-resume-pins/overlay
+ */
+/** Thrown when a request is built for a blocked child (defense-in-depth). */
+export class PinBlockedError extends Error {
+    constructor(reason) {
+        super(`resume pin blocked: ${reason}`);
+        this.name = 'PinBlockedError';
+    }
+}
+/**
+ * Apply one tuple with presence semantics onto a shallow copy of `resolved`.
+ * @param resolved - the config produced by the `agent/request` waterfall.
+ * @param tuple - the pinned (or gate-evaluated route-current) tuple.
+ */
+function applyTuple(resolved, tuple) {
+    const out = { ...resolved };
+    for (const [key, value] of Object.entries(tuple)) {
+        if (value === null)
+            delete out[key];
+        else
+            out[key] = value;
+    }
+    return out;
+}
+/** The pinned tuple a complete pin contributes (its `effective`, verbatim). */
+function pinnedTuple(pin) {
+    return {
+        provider: pin.effective.provider,
+        model: pin.effective.model,
+        reasoningEffort: pin.effective.reasoningEffort,
+        maxTokens: pin.effective.maxTokens,
+    };
+}
+/**
+ * Overlay the pin onto one resolved request config.
+ * - `resume.state === 'blocked'` → throws {@link PinBlockedError}: an
+ *   unmonitored resume of a blocked child fails visibly instead of silently
+ *   substituting.
+ * - `resume.overlay` present (gate-evaluated route-current) → applied with
+ *   the same presence semantics; it is a cache recomputed on every gate
+ *   evaluation, never authoritative on its own.
+ * - Complete pin → the whole pinned tuple, absence included (a pinned-`null`
+ *   key is removed, not nulled).
+ * - Degraded pin (`complete:false`) → only explicitly-present pinned fields.
+ * @param resolved - the resolved request config.
+ * @param pin - the child's pin.
+ * @returns a shallow copy carrying the pin (input untouched — the seed may be
+ *   frozen), or the input object when the pin contributes nothing.
+ */
+export function applyPinOverlay(resolved, pin) {
+    if (pin.resume.state === 'blocked') {
+        throw new PinBlockedError(pin.resume.reason ?? 'blocked by the resume gate');
+    }
+    if (pin.resume.overlay !== undefined)
+        return applyTuple(resolved, pin.resume.overlay);
+    if (pin.effective.complete)
+        return applyTuple(resolved, pinnedTuple(pin));
+    // Degraded: set only the fields the spawn explicitly carried.
+    const out = { ...resolved };
+    out['provider'] = pin.effective.provider;
+    out['model'] = pin.effective.model;
+    if (pin.effective.reasoningEffort !== null)
+        out['reasoningEffort'] = pin.effective.reasoningEffort;
+    if (pin.effective.maxTokens !== null)
+        out['maxTokens'] = pin.effective.maxTokens;
+    return out;
+}
+//# sourceMappingURL=overlay.js.map

package/lib/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,6EAA6E;AAC7E,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,MAAc;QACxB,KAAK,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAA;QACtC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAoC,QAAW,EAAE,KAAmB;IACrF,MAAM,GAAG,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAA;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;;YAC9B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACvB,CAAC;IACD,OAAO,GAAQ,CAAA;AACjB,CAAC;AAED,+EAA+E;AAC/E,SAAS,WAAW,CAAC,GAAc;IACjC,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,QAAQ;QAChC,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK;QAC1B,eAAe,EAAE,GAAG,CAAC,SAAS,CAAC,eAAe;QAC9C,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,SAAS;KACnC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAoC,QAAW,EAAE,GAAc;IAC5F,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,4BAA4B,CAAC,CAAA;IAC9E,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACrF,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;IACzE,8DAA8D;IAC9D,MAAM,GAAG,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAA;IACpD,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAA;IACxC,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAA;IAClC,IAAI,GAAG,CAAC,SAAS,CAAC,eAAe,KAAK,IAAI;QAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,eAAe,CAAA;IAClG,IAAI,GAAG,CAAC,SAAS,CAAC,SAAS,KAAK,IAAI;QAAE,GAAG,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,SAAS,CAAA;IAChF,OAAO,GAAQ,CAAA;AACjB,CAAC"}

package/lib/pin.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Resume-pin schema v1: the descriptor persisted per continuable background
+ * child, plus a tolerant reader and a canonical writer.
+ *
+ * The pin lives outside the harness's closed descriptor schema and records
+ * exactly what a cold resume must restore instead of re-guessing: definition
+ * identity, the complete effective request tuple (with explicit `null`
+ * presence semantics — a pinned `null` means ABSENT, and absence must be
+ * preserved), the model selector provenance, workspace identity, and the
+ * derived resume state.
+ *
+ * Reader contract: unknown fields are ignored (forward compatibility);
+ * an unsupported `version`, malformed JSON, or a missing required field
+ * throws {@link PinParseError} — callers treat that as fail-closed.
+ *
+ * @module @dsh-cc/subagent-resume-pins/pin
+ */
+/** The only pin schema version this reader accepts. */
+export declare const PIN_VERSION = 1;
+/** Error thrown for a malformed, incomplete, or unsupported-version pin. */
+export declare class PinParseError extends Error {
+    constructor(message: string);
+}
+/** The layer a named definition was discovered under. */
+export type PinDefinitionSource = 'project' | 'user' | 'bundled';
+/** How the spawn-time model selector was resolved. */
+export type ModelSelectorVia = 'alias' | 'literal' | 'inherit';
+/** Background mode of the pinned child; constant `continuable-background` today. */
+export type PinMode = 'continuable-background';
+/** Deriving, non-authoritative resume state persisted for the overlay listener. */
+export interface PinResume {
+    readonly state: 'ok' | 'blocked';
+    readonly reason?: string | undefined;
+    /**
+     * Gate-evaluated route-current tuple (§4.6 step 5): present only while the
+     * latest gate evaluation routed the child to a current default route per
+     * policy. A cache, never authoritative on its own — every gate evaluation
+     * recomputes or clears it.
+     */
+    readonly overlay?: OverlayTuple | undefined;
+}
+/** A complete resolved request tuple; `null` means explicitly ABSENT. */
+export interface OverlayTuple {
+    readonly provider: string;
+    readonly model: string;
+    readonly reasoningEffort: string | null;
+    readonly maxTokens: number | null;
+}
+/** Discriminated definition identity: `plain` for general-purpose spawns. */
+export type PinDefinition = {
+    readonly kind: 'plain';
+} | {
+    readonly kind: 'named';
+    readonly agentType: string;
+    readonly source: PinDefinitionSource;
+    /** Canonical fingerprint over parsed frontmatter + persona (§4.4). */
+    readonly fingerprint: string;
+    /** sha256 of the persona string forwarded at spawn. */
+    readonly personaHash: string;
+    /** Discovery location for gate-time re-fingerprinting, when file-backed. */
+    readonly baseDir?: string | undefined;
+    readonly filename?: string | undefined;
+};
+/** Provenance of the spawn-time model selector, atomically resolved. */
+export interface PinModelSelector {
+    readonly raw: string;
+    readonly via: ModelSelectorVia;
+}
+/**
+ * The complete resolved request config. `null` means explicitly ABSENT and
+ * absence must be preserved on resume; `complete: false` degrades the pin to
+ * explicit-fields-only mode (spawn-time preflight could not resolve the route).
+ */
+export interface PinEffective {
+    readonly provider: string;
+    readonly model: string;
+    readonly reasoningEffort: string | null;
+    readonly maxTokens: number | null;
+    readonly complete: boolean;
+}
+/** Sanitized tool filter as forwarded at spawn. */
+export interface PinToolFilter {
+    readonly allow: readonly string[];
+    readonly deny: readonly string[];
+}
+/** Workspace/worktree identity captured at spawn. */
+export interface PinWorkspace {
+    readonly cwd: string;
+    readonly gitDir: string;
+    readonly gitCommonDir: string;
+    readonly branch: string;
+}
+/** A persisted resume pin, schema version 1. */
+export interface ResumePin {
+    readonly version: typeof PIN_VERSION;
+    /** Preallocated child id; becomes the child's session id. */
+    readonly childId: string;
+    readonly parentSessionId: string;
+    readonly label: string;
+    readonly mode: PinMode;
+    readonly createdAt: string;
+    readonly definition: PinDefinition;
+    readonly modelSelector: PinModelSelector;
+    readonly effective: PinEffective;
+    readonly toolFilter: PinToolFilter;
+    /** Audit metadata only — never enforced at spawn or resume. */
+    readonly maxTurns?: number | undefined;
+    readonly workspace: PinWorkspace;
+    readonly resume: PinResume;
+    readonly lastNotice?: string | undefined;
+}
+/** A structural clone of a pin draft mutable by {@link PinStore.update}. */
+export type ResumePinDraft = {
+    -readonly [K in keyof ResumePin]: ResumePin[K];
+};
+/**
+ * Parse a pin from its JSON text. Tolerant of unknown fields on the pin and
+ * its nested objects; throws {@link PinParseError} for malformed JSON, an
+ * unsupported `version`, or a missing required field.
+ */
+export declare function parsePin(text: string): ResumePin;
+/** Stable JSON.stringify: object keys in sorted order, recursively. */
+export declare function canonicalJson(value: unknown): string;
+/**
+ * Serialize a pin to its canonical JSON form (sorted keys), matching what the
+ * store writes atomically to `<pinsRoot>/<childId>.json`.
+ */
+export declare function writePin(pin: ResumePin): string;
+//# sourceMappingURL=pin.d.ts.map

package/lib/pin.d.ts.map

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

package/lib/pin.js

@@ -0,0 +1,211 @@
+/**
+ * Resume-pin schema v1: the descriptor persisted per continuable background
+ * child, plus a tolerant reader and a canonical writer.
+ *
+ * The pin lives outside the harness's closed descriptor schema and records
+ * exactly what a cold resume must restore instead of re-guessing: definition
+ * identity, the complete effective request tuple (with explicit `null`
+ * presence semantics — a pinned `null` means ABSENT, and absence must be
+ * preserved), the model selector provenance, workspace identity, and the
+ * derived resume state.
+ *
+ * Reader contract: unknown fields are ignored (forward compatibility);
+ * an unsupported `version`, malformed JSON, or a missing required field
+ * throws {@link PinParseError} — callers treat that as fail-closed.
+ *
+ * @module @dsh-cc/subagent-resume-pins/pin
+ */
+/** The only pin schema version this reader accepts. */
+export const PIN_VERSION = 1;
+/** Error thrown for a malformed, incomplete, or unsupported-version pin. */
+export class PinParseError extends Error {
+    constructor(message) {
+        super(`resume pin parse error: ${message}`);
+        this.name = 'PinParseError';
+    }
+}
+function asRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new PinParseError('expected an object');
+    }
+    return value;
+}
+function requiredString(record, field) {
+    const value = record[field];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new PinParseError(`missing required string field "${field}"`);
+    }
+    return value;
+}
+function requiredNumber(record, field) {
+    const value = record[field];
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new PinParseError(`missing required number field "${field}"`);
+    }
+    return value;
+}
+function optionalString(record, field) {
+    const value = record[field];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        throw new PinParseError(`field "${field}" must be a string`);
+    return value;
+}
+function requiredEnum(record, field, values) {
+    const value = record[field];
+    if (typeof value !== 'string' || !values.includes(value)) {
+        throw new PinParseError(`field "${field}" must be one of ${values.join('|')}`);
+    }
+    return value;
+}
+function stringArray(record, field) {
+    const value = record[field];
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.some(entry => typeof entry !== 'string')) {
+        throw new PinParseError(`field "${field}" must be an array of strings`);
+    }
+    return value;
+}
+function parseDefinition(value) {
+    const record = asRecord(value);
+    const kind = requiredEnum(record, 'kind', ['plain', 'named']);
+    if (kind === 'plain')
+        return { kind: 'plain' };
+    const source = requiredEnum(record, 'source', ['project', 'user', 'bundled']);
+    return {
+        kind: 'named',
+        agentType: requiredString(record, 'agentType'),
+        source,
+        fingerprint: requiredString(record, 'fingerprint'),
+        personaHash: requiredString(record, 'personaHash'),
+        baseDir: optionalString(record, 'baseDir'),
+        filename: optionalString(record, 'filename'),
+    };
+}
+function requiredBoolean(record, field) {
+    const value = record[field];
+    if (typeof value !== 'boolean') {
+        throw new PinParseError(`missing required boolean field "${field}"`);
+    }
+    return value;
+}
+function parseEffective(value) {
+    const record = asRecord(value);
+    // Presence is contractual (plan §4.2): a missing knob is a parse error,
+    // only an explicit `null` records absence.
+    if (!('reasoningEffort' in record))
+        throw new PinParseError('missing required field "reasoningEffort"');
+    if (!('maxTokens' in record))
+        throw new PinParseError('missing required field "maxTokens"');
+    return {
+        provider: requiredString(record, 'provider'),
+        model: requiredString(record, 'model'),
+        reasoningEffort: record.reasoningEffort === null ? null : requiredString(record, 'reasoningEffort'),
+        maxTokens: record.maxTokens === null ? null : requiredNumber(record, 'maxTokens'),
+        complete: requiredBoolean(record, 'complete'),
+    };
+}
+function parseModelSelector(value) {
+    const record = asRecord(value);
+    return {
+        raw: requiredString(record, 'raw'),
+        via: requiredEnum(record, 'via', ['alias', 'literal', 'inherit']),
+    };
+}
+function parseToolFilter(value) {
+    const record = asRecord(value);
+    return { allow: stringArray(record, 'allow'), deny: stringArray(record, 'deny') };
+}
+function parseWorkspace(value) {
+    const record = asRecord(value);
+    return {
+        cwd: requiredString(record, 'cwd'),
+        gitDir: requiredString(record, 'gitDir'),
+        gitCommonDir: requiredString(record, 'gitCommonDir'),
+        branch: requiredString(record, 'branch'),
+    };
+}
+function parseOverlayTuple(value) {
+    if (value === undefined)
+        return undefined;
+    const record = asRecord(value);
+    if (!('reasoningEffort' in record))
+        throw new PinParseError('missing required field "reasoningEffort"');
+    if (!('maxTokens' in record))
+        throw new PinParseError('missing required field "maxTokens"');
+    return {
+        provider: requiredString(record, 'provider'),
+        model: requiredString(record, 'model'),
+        reasoningEffort: record.reasoningEffort === null ? null : requiredString(record, 'reasoningEffort'),
+        maxTokens: record.maxTokens === null ? null : requiredNumber(record, 'maxTokens'),
+    };
+}
+function parseResume(value) {
+    const record = asRecord(value);
+    const state = requiredEnum(record, 'state', ['ok', 'blocked']);
+    const overlay = parseOverlayTuple(record['overlay']);
+    if (state === 'blocked') {
+        return { state, reason: requiredString(record, 'reason'), overlay };
+    }
+    return { state, overlay };
+}
+/**
+ * Parse a pin from its JSON text. Tolerant of unknown fields on the pin and
+ * its nested objects; throws {@link PinParseError} for malformed JSON, an
+ * unsupported `version`, or a missing required field.
+ */
+export function parsePin(text) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (cause) {
+        throw new PinParseError(`invalid JSON (${String(cause)})`);
+    }
+    const record = asRecord(raw);
+    const version = record['version'];
+    if (version !== PIN_VERSION) {
+        throw new PinParseError(`unsupported pin version ${JSON.stringify(version)}`);
+    }
+    const pin = {
+        version: PIN_VERSION,
+        childId: requiredString(record, 'childId'),
+        parentSessionId: requiredString(record, 'parentSessionId'),
+        label: requiredString(record, 'label'),
+        mode: requiredEnum(record, 'mode', ['continuable-background']),
+        createdAt: requiredString(record, 'createdAt'),
+        definition: parseDefinition(record['definition']),
+        modelSelector: parseModelSelector(record['modelSelector']),
+        effective: parseEffective(record['effective']),
+        toolFilter: parseToolFilter(record['toolFilter']),
+        maxTurns: record['maxTurns'] === undefined ? undefined : requiredNumber(record, 'maxTurns'),
+        workspace: parseWorkspace(record['workspace']),
+        resume: parseResume(record['resume']),
+        lastNotice: optionalString(record, 'lastNotice'),
+    };
+    return pin;
+}
+/** Stable JSON.stringify: object keys in sorted order, recursively. */
+export function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(entry => canonicalJson(entry)).join(',')}]`;
+    if (typeof value === 'object' && value !== null) {
+        const keys = Object.keys(value).sort();
+        const body = keys
+            .filter(key => value[key] !== undefined)
+            .map(key => `${JSON.stringify(key)}:${canonicalJson(value[key])}`)
+            .join(',');
+        return `{${body}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+}
+/**
+ * Serialize a pin to its canonical JSON form (sorted keys), matching what the
+ * store writes atomically to `<pinsRoot>/<childId>.json`.
+ */
+export function writePin(pin) {
+    return `${canonicalJson(pin)}\n`;
+}
+//# sourceMappingURL=pin.js.map

package/lib/pin.js.map

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

package/lib/plugin.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The resume-pins cordis plugin (plan §4.6-§4.10): one `PinStore`, the
+ * `subagents-resume` settings namespace, the `tools/pre-execute` resume gate,
+ * the `tools/post-execute` notice/annotation listeners, and the
+ * `agent/request` runtime overlay.
+ *
+ * Zero-op when unmounted: pins are simply unread and behavior is today's
+ * legacy behavior. When mounted, only pinned children are affected — a
+ * missing pin is a legacy/foreign child (pass-through), and a same-epoch
+ * followup to a live Activation is untouched.
+ *
+ * Durability ordering: every deny persists `resume.state='blocked'` (reason)
+ * through the shared store — an atomic disk rewrite plus synchronous cache
+ * publication — BEFORE the deny decision returns, so the overlay listener
+ * fails any unmonitored resume of that child visibly. An all-passing gate
+ * clears the stored blocked state. Gate and overlay share the ONE store
+ * exposed as the `resumePinStore` service (spawn capture prefers it too).
+ *
+ * @module @dsh-cc/subagent-resume-pins/plugin
+ */
+import z from '@deepseek-ai/schemastery';
+import type { Context } from '@deepseek-ai/cordis';
+import { PinStore } from './store.ts';
+import type { ResumePin } from './pin.ts';
+/** Plugin configuration. */
+export interface ResumePinsPluginConfig {
+    /** Directory holding one `<childId>.json` pin file per child. */
+    readonly pinsRoot: string;
+    /** Test seam / shared-store injection: use this store instead of a new one. */
+    readonly store?: PinStore;
+}
+/**
+ * The settings section schema (plan §4.9): one constrained enum field per
+ * knob with explicit defaults, mirroring how `cc-model-aliases` registers its
+ * schema — invalid spellings are rejected at write time by the settings
+ * service; `readResumePolicy` keeps tolerating hand-edited documents.
+ */
+export declare const ResumePolicySchema: z<Schemastery.ObjectS<{
+    onUnavailableModel: z<"block" | "route-current", "block" | "route-current">;
+    onDefinitionChanged: z<"block" | "resume-with-notice", "block" | "resume-with-notice">;
+    onWorkspaceChanged: z<"block" | "resume-with-notice", "block" | "resume-with-notice">;
+}>, Schemastery.ObjectT<{
+    onUnavailableModel: z<"block" | "route-current", "block" | "route-current">;
+    onDefinitionChanged: z<"block" | "resume-with-notice", "block" | "resume-with-notice">;
+    onWorkspaceChanged: z<"block" | "resume-with-notice", "block" | "resume-with-notice">;
+}>>;
+/** Cordis plugin id. */
+export declare const name = "cc-subagent-resume-pins";
+/** The service key the spawn capture resolves to share the store. */
+export declare const RESUME_PIN_STORE = "resumePinStore";
+/**
+ * Re-fingerprint a named definition OUTSIDE the registry cache (§4.4).
+ * Bundled pins re-fingerprint from the CURRENT in-package bundled registry.
+ * Project/user pins re-read the EXACT recorded `baseDir`+`filename`, falling
+ * back to an `agentType` lookup only when the recorded file is gone (that is
+ * the changed-by-replacement class). `'missing'` for a gone/unreadable
+ * definition; `null` when no current information exists (a pin without a
+ * file location).
+ */
+export declare function refingerprintDefinition(pin: ResumePin): Promise<string | 'missing' | null>;
+/**
+ * Mount the resume-pin gate, overlay, notices, and policy namespace.
+ * @param ctx - the plug context.
+ * @param config - pins root (or an injected store).
+ */
+export declare function apply(ctx: Context, config: ResumePinsPluginConfig): void;
+//# sourceMappingURL=plugin.d.ts.map

package/lib/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAoBlD,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,4BAA4B;AAC5B,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;GAI7B,CAAA;AAEF,wBAAwB;AACxB,eAAO,MAAM,IAAI,4BAA4B,CAAA;AAE7C,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,mBAAmB,CAAA;AA8ChD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAoBhG;AAOD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAsNxE"}