@skillstate/opencode 2.2.2 → 3.0.1

package/dist/session-registry.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Sub-agent session registry for the OpenCode v2 plugin.
+ *
+ * OpenCode spawns a CHILD SESSION for every sub-agent (the `task` tool and
+ * every custom agent). Those child sessions are first-class: they run the
+ * agent loop, call tools, and would otherwise all write to the SAME project
+ * state file — the last writer wins and the main agent's notes are silently
+ * clobbered mid-task.
+ *
+ * The v1 plugin inferred this from an in-process `Map` fed by an `event`
+ * hook. v2 exposes a real event stream (`ctx.event.subscribe()`), so the
+ * registry is an explicit, testable value object instead of module-level
+ * mutable state shared by tests and a single plugin instance.
+ *
+ * PARENT EDGES come from the server's own event stream. In OpenCode v2 the
+ * relevant payloads are:
+ *
+ * ```ts
+ * { type: "session.created", data: { sessionID: string, parentID?: string } }
+ * { type: "session.forked",  data: { sessionID: string, parentID: string } }
+ * { type: "session.deleted", data: { sessionID: string } }
+ * ```
+ *
+ * There is no `session.updated` event in v2, and the parent lives on
+ * `data.parentID` — not on a `properties.info` envelope as it did in v1.
+ * A session with a non-empty `parentID` is a sub-agent; a session with an
+ * absent or empty `parentID` is a root session. The registry never guesses
+ * from the id shape — a session that has not been observed on the stream
+ * yet is treated as a ROOT session (the safe default: it gets the shared
+ * project file, which is what a plain single-session user expects).
+ *
+ * LIFECYCLE: entries are refreshed on every event and evicted after
+ * {@link DEFAULT_SESSION_TTL_MS} of silence, so a long-lived OpenCode
+ * process does not accumulate one entry per session it has ever seen.
+ */
+/** How long a session stays registered after its last event. */
+export declare const DEFAULT_SESSION_TTL_MS: number;
+/** A session as observed on the OpenCode event stream. */
+export interface SessionRecord {
+    /** The host session id, verbatim. */
+    readonly id: string;
+    /** The parent session id, or `null` for a root session. */
+    readonly parentID: string | null;
+    /** Event receive time (epoch ms) — drives TTL eviction. */
+    readonly seenAt: number;
+}
+/**
+ * Options for {@link SessionRegistry}. Tests inject a clock and a TTL so
+ * eviction is deterministic.
+ */
+export interface SessionRegistryOptions {
+    /** Clock in epoch milliseconds. Defaults to `Date.now`. */
+    now?: () => number;
+    /** Idle time after which a session is evicted. Defaults to 6h. */
+    ttlMs?: number;
+    /** Cap on retained sessions; the oldest are evicted first. */
+    maxSessions?: number;
+}
+/**
+ * Tracks the session→parent forest reported by the OpenCode event stream.
+ *
+ * Every method is pure with respect to the plugin's other state: the
+ * registry only ever answers questions about the shape of the session tree.
+ */
+export declare class SessionRegistry {
+    private readonly sessions;
+    private readonly now;
+    private readonly ttlMs;
+    private readonly maxSessions;
+    constructor(options?: SessionRegistryOptions);
+    /**
+     * Fold one server event into the registry.
+     *
+     * `session.created` and `session.forked` register (or re-parent) a
+     * session; `session.deleted` forgets it. Any other event, and any
+     * malformed payload, is ignored — the stream carries far more than
+     * sessions and one odd record must never break the subscription loop.
+     *
+     * Returns the {@link SessionRecord} it wrote, or `null` when nothing was
+     * registered (including a deletion).
+     */
+    ingestEvent(event: unknown): SessionRecord | null;
+    /** The recorded session, or `undefined` when it was never observed. */
+    get(sessionID: string): SessionRecord | undefined;
+    /**
+     * Whether `sessionID` is a sub-agent session (a session with a parent).
+     *
+     * An UNOBSERVED session answers `false`: the plugin then treats it as a
+     * root session, which is the behaviour a single-session user expects and
+     * never creates a surprise `agents/` directory.
+     */
+    isSubAgent(sessionID: string): boolean;
+    /**
+     * The topmost ancestor of `sessionID` (itself when it is a root
+     * session). Follows parent edges with a visited set so a cycle — which a
+     * buggy or hostile event stream could produce — terminates instead of
+     * hanging the agent loop.
+     */
+    rootOf(sessionID: string): string;
+    /**
+     * Every session below `sessionID` in the tree - i.e. every session whose
+     * parent chain passes through `sessionID`, excluding `sessionID` itself.
+     *
+     * "Root ancestor" would be the wrong definition here: asked about a
+     * sub-agent it would also return that sub-agent, because the sub-agent's
+     * root is further up. Walking up to the queried session instead answers
+     * both cases uniformly, and a root session still gets every sub-agent.
+     *
+     * Sorted by id for a stable, testable result.
+     */
+    descendantsOf(sessionID: string): string[];
+    /**
+     * Whether `candidate` sits somewhere below `ancestor`. Cycle-safe: a
+     * parent chain that loops back on itself terminates instead of hanging
+     * the agent loop.
+     */
+    private isDescendantOf;
+    /** Every registered session, oldest-observed first. */
+    list(): readonly SessionRecord[];
+    /** How many sessions are currently registered. */
+    get size(): number;
+    /** Forget every session (test isolation, and a clean reload). */
+    clear(): void;
+    /**
+     * Drop sessions idle for longer than the TTL, then enforce the size cap
+     * by dropping the least-recently-seen entries. Called after every
+     * ingest; also exposed for tests.
+     */
+    evict(): void;
+}
+/**
+ * The on-disk scope name for a session: a stable, filesystem-safe id that
+ * keeps SUB-AGENT sessions in their own directory and root sessions on the
+ * shared project file.
+ *
+ * Returns `''` for a root session (the shared project state) and a
+ * sanitized `<parent>-<session>` id for a sub-agent.
+ *
+ * The child part is the FULL sanitized session id, not a short prefix. The
+ * v1 code truncated to 8 characters, which silently collapses two sibling
+ * sub-agents into one state file whenever their ids share a prefix — they
+ * overwrite each other's notes with no error. `sanitizeAgentId` caps the
+ * result at 64 characters, so the directory name stays bounded. The parent
+ * part is truncated to 8 characters because it only has to disambiguate
+ * which root a sub-agent belongs to.
+ */
+export declare function stateScopeFor(registry: SessionRegistry, sessionID: string): string;
+//# sourceMappingURL=session-registry.d.ts.map

package/dist/session-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../src/session-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,QAAqB,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkCD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,YAAY,OAAO,GAAE,sBAA2B,EAI/C;IAED;;;;;;;;;;OAUG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAehD;IAED,uEAAuE;IACvE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhD;IAED;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAErC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUhC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAQzC;IAED;;;;OAIG;IACH,OAAO,CAAC,cAAc;IActB,uDAAuD;IACvD,IAAI,IAAI,SAAS,aAAa,EAAE,CAE/B;IAED,kDAAkD;IAClD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,iEAAiE;IACjE,KAAK,IAAI,IAAI,CAEZ;IAED;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAYZ;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,GAChB,MAAM,CAQR"}

package/dist/session-registry.js

@@ -0,0 +1,236 @@
+/**
+ * Sub-agent session registry for the OpenCode v2 plugin.
+ *
+ * OpenCode spawns a CHILD SESSION for every sub-agent (the `task` tool and
+ * every custom agent). Those child sessions are first-class: they run the
+ * agent loop, call tools, and would otherwise all write to the SAME project
+ * state file — the last writer wins and the main agent's notes are silently
+ * clobbered mid-task.
+ *
+ * The v1 plugin inferred this from an in-process `Map` fed by an `event`
+ * hook. v2 exposes a real event stream (`ctx.event.subscribe()`), so the
+ * registry is an explicit, testable value object instead of module-level
+ * mutable state shared by tests and a single plugin instance.
+ *
+ * PARENT EDGES come from the server's own event stream. In OpenCode v2 the
+ * relevant payloads are:
+ *
+ * ```ts
+ * { type: "session.created", data: { sessionID: string, parentID?: string } }
+ * { type: "session.forked",  data: { sessionID: string, parentID: string } }
+ * { type: "session.deleted", data: { sessionID: string } }
+ * ```
+ *
+ * There is no `session.updated` event in v2, and the parent lives on
+ * `data.parentID` — not on a `properties.info` envelope as it did in v1.
+ * A session with a non-empty `parentID` is a sub-agent; a session with an
+ * absent or empty `parentID` is a root session. The registry never guesses
+ * from the id shape — a session that has not been observed on the stream
+ * yet is treated as a ROOT session (the safe default: it gets the shared
+ * project file, which is what a plain single-session user expects).
+ *
+ * LIFECYCLE: entries are refreshed on every event and evicted after
+ * {@link DEFAULT_SESSION_TTL_MS} of silence, so a long-lived OpenCode
+ * process does not accumulate one entry per session it has ever seen.
+ */
+import { sanitizeAgentId } from '@skillstate/core';
+/** How long a session stays registered after its last event. */
+export const DEFAULT_SESSION_TTL_MS = 6 * 60 * 60 * 1000;
+const DEFAULT_MAX_SESSIONS = 512;
+function readSessionEvent(event) {
+    if (typeof event !== 'object' || event === null)
+        return null;
+    const type = event.type;
+    if (typeof type !== 'string')
+        return null;
+    if (type !== 'session.created' && type !== 'session.forked' && type !== 'session.deleted') {
+        return null;
+    }
+    const data = event.data;
+    if (typeof data !== 'object' || data === null)
+        return null;
+    const record = data;
+    if (typeof record.sessionID !== 'string' || record.sessionID.length === 0)
+        return null;
+    if (type === 'session.deleted')
+        return { kind: 'delete', id: record.sessionID };
+    const parent = typeof record.parentID === 'string' && record.parentID.length > 0 ? record.parentID : null;
+    return { kind: 'upsert', id: record.sessionID, parentID: parent };
+}
+/**
+ * Tracks the session→parent forest reported by the OpenCode event stream.
+ *
+ * Every method is pure with respect to the plugin's other state: the
+ * registry only ever answers questions about the shape of the session tree.
+ */
+export class SessionRegistry {
+    sessions = new Map();
+    now;
+    ttlMs;
+    maxSessions;
+    constructor(options = {}) {
+        this.now = options.now ?? Date.now;
+        this.ttlMs = options.ttlMs ?? DEFAULT_SESSION_TTL_MS;
+        this.maxSessions = options.maxSessions ?? DEFAULT_MAX_SESSIONS;
+    }
+    /**
+     * Fold one server event into the registry.
+     *
+     * `session.created` and `session.forked` register (or re-parent) a
+     * session; `session.deleted` forgets it. Any other event, and any
+     * malformed payload, is ignored — the stream carries far more than
+     * sessions and one odd record must never break the subscription loop.
+     *
+     * Returns the {@link SessionRecord} it wrote, or `null` when nothing was
+     * registered (including a deletion).
+     */
+    ingestEvent(event) {
+        const parsed = readSessionEvent(event);
+        if (parsed === null)
+            return null;
+        if (parsed.kind === 'delete') {
+            this.sessions.delete(parsed.id);
+            return null;
+        }
+        const record = {
+            id: parsed.id,
+            parentID: parsed.parentID,
+            seenAt: this.now(),
+        };
+        this.sessions.set(record.id, record);
+        this.evict();
+        return record;
+    }
+    /** The recorded session, or `undefined` when it was never observed. */
+    get(sessionID) {
+        return this.sessions.get(sessionID);
+    }
+    /**
+     * Whether `sessionID` is a sub-agent session (a session with a parent).
+     *
+     * An UNOBSERVED session answers `false`: the plugin then treats it as a
+     * root session, which is the behaviour a single-session user expects and
+     * never creates a surprise `agents/` directory.
+     */
+    isSubAgent(sessionID) {
+        return this.sessions.get(sessionID)?.parentID != null;
+    }
+    /**
+     * The topmost ancestor of `sessionID` (itself when it is a root
+     * session). Follows parent edges with a visited set so a cycle — which a
+     * buggy or hostile event stream could produce — terminates instead of
+     * hanging the agent loop.
+     */
+    rootOf(sessionID) {
+        let current = sessionID;
+        const visited = new Set([sessionID]);
+        for (;;) {
+            const record = this.sessions.get(current);
+            const parent = record?.parentID;
+            if (parent === undefined || parent === null || visited.has(parent))
+                return current;
+            visited.add(parent);
+            current = parent;
+        }
+    }
+    /**
+     * Every session below `sessionID` in the tree - i.e. every session whose
+     * parent chain passes through `sessionID`, excluding `sessionID` itself.
+     *
+     * "Root ancestor" would be the wrong definition here: asked about a
+     * sub-agent it would also return that sub-agent, because the sub-agent's
+     * root is further up. Walking up to the queried session instead answers
+     * both cases uniformly, and a root session still gets every sub-agent.
+     *
+     * Sorted by id for a stable, testable result.
+     */
+    descendantsOf(sessionID) {
+        const result = [];
+        for (const record of this.sessions.values()) {
+            if (record.id !== sessionID && this.isDescendantOf(record.id, sessionID)) {
+                result.push(record.id);
+            }
+        }
+        return result.sort();
+    }
+    /**
+     * Whether `candidate` sits somewhere below `ancestor`. Cycle-safe: a
+     * parent chain that loops back on itself terminates instead of hanging
+     * the agent loop.
+     */
+    isDescendantOf(candidate, ancestor) {
+        let current = candidate;
+        const visited = new Set([candidate]);
+        for (;;) {
+            const record = this.sessions.get(current);
+            const parent = record?.parentID ?? null;
+            if (parent === null)
+                return false;
+            if (parent === ancestor)
+                return true;
+            if (visited.has(parent))
+                return false;
+            visited.add(parent);
+            current = parent;
+        }
+    }
+    /** Every registered session, oldest-observed first. */
+    list() {
+        return [...this.sessions.values()].sort((a, b) => a.seenAt - b.seenAt || a.id.localeCompare(b.id));
+    }
+    /** How many sessions are currently registered. */
+    get size() {
+        return this.sessions.size;
+    }
+    /** Forget every session (test isolation, and a clean reload). */
+    clear() {
+        this.sessions.clear();
+    }
+    /**
+     * Drop sessions idle for longer than the TTL, then enforce the size cap
+     * by dropping the least-recently-seen entries. Called after every
+     * ingest; also exposed for tests.
+     */
+    evict() {
+        const cutoff = this.now() - this.ttlMs;
+        for (const [id, record] of this.sessions) {
+            if (record.seenAt < cutoff)
+                this.sessions.delete(id);
+        }
+        if (this.sessions.size <= this.maxSessions)
+            return;
+        const ordered = [...this.sessions.entries()].sort((a, b) => a[1].seenAt - b[1].seenAt || a[0].localeCompare(b[0]));
+        for (const [id] of ordered.slice(0, this.sessions.size - this.maxSessions)) {
+            this.sessions.delete(id);
+        }
+    }
+}
+/**
+ * The on-disk scope name for a session: a stable, filesystem-safe id that
+ * keeps SUB-AGENT sessions in their own directory and root sessions on the
+ * shared project file.
+ *
+ * Returns `''` for a root session (the shared project state) and a
+ * sanitized `<parent>-<session>` id for a sub-agent.
+ *
+ * The child part is the FULL sanitized session id, not a short prefix. The
+ * v1 code truncated to 8 characters, which silently collapses two sibling
+ * sub-agents into one state file whenever their ids share a prefix — they
+ * overwrite each other's notes with no error. `sanitizeAgentId` caps the
+ * result at 64 characters, so the directory name stays bounded. The parent
+ * part is truncated to 8 characters because it only has to disambiguate
+ * which root a sub-agent belongs to.
+ */
+export function stateScopeFor(registry, sessionID) {
+    const record = registry.get(sessionID);
+    if (record === undefined || record.parentID === null)
+        return '';
+    const child = sanitizeAgentId(sessionID);
+    const parentPrefix = sanitizeAgentId(record.parentID).slice(0, 8);
+    if (child.length === 0)
+        return parentPrefix;
+    if (parentPrefix.length === 0)
+        return child;
+    return `${parentPrefix}-${child}`;
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/session-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.js","sourceRoot":"","sources":["../src/session-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAyBzD,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAejC,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,IAAI,KAAK,iBAAiB,IAAI,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC1F,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAmD,CAAC;IACnE,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvF,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAChF,MAAM,MAAM,GACV,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC5C,GAAG,CAAe;IAClB,KAAK,CAAS;IACd,WAAW,CAAS;IAErC,YAAY,OAAO,GAA2B,EAAE;QAC9C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,sBAAsB,CAAC;QACrD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;IACjE,CAAC;IAED;;;;;;;;;;OAUG;IACH,WAAW,CAAC,KAAc;QACxB,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAkB;YAC5B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE;SACnB,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uEAAuE;IACvE,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAiB;QACtB,IAAI,OAAO,GAAG,SAAS,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7C,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC;YAChC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAO,OAAO,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CAAC,SAAiB;QAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC;gBACzE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,SAAiB,EAAE,QAAgB;QACxD,IAAI,OAAO,GAAW,SAAS,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7C,SAAS,CAAC;YACR,MAAM,MAAM,GAA8B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrE,MAAM,MAAM,GAAkB,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC;YACvD,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAClC,IAAI,MAAM,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACrC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrG,CAAC;IAED,kDAAkD;IAClD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,iEAAiE;IACjE,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACvC,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QACnD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAC/C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChE,CAAC;QACF,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3E,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAyB,EACzB,SAAiB;IAEjB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IAC5C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,GAAG,YAAY,IAAI,KAAK,EAAE,CAAC;AACpC,CAAC"}

package/dist/spec-loader.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Resolving P — the procedural specification the paper's prompt is built on.
+ *
+ * ── Why the plugin needs a spec at all ────────────────────────────────────
+ *
+ * A.4 is `Format(P, Σₜ, Oₜ)`, and P is the first argument. Paper mode
+ * therefore cannot assemble a paper-conformant prompt without one, even
+ * though the store ({@link ProjectStateStore}) is deliberately schema-free:
+ * notes mode never shows the model a schema, so it never needs P.
+ *
+ * ── Resolution order ─────────────────────────────────────────────────────
+ *
+ * 1. `<project>/skill-spec.json` — the file `skillstate init` writes and the
+ *    one the CLI's `--spec` already points at (`config.ts` default
+ *    `specPath: './skill-spec.json'`). A project that has customised its
+ *    procedure gets that procedure.
+ * 2. {@link GENERIC_PROCEDURE_SPEC} — the built-in, domain-neutral default.
+ *
+ * ── A malformed spec file must not reach the model ────────────────────────
+ *
+ * A half-written or hand-mangled `skill-spec.json` is exactly the kind of
+ * input that produced the v1 failure, where the spec's own instructions
+ * ("You are an autonomous CTF agent … find the flag") overrode the user. So
+ * the file is VALIDATED before it is trusted, field by field, and anything
+ * that does not typecheck falls back to the built-in spec with the reason
+ * recorded. There is no code path that feeds an unvalidated P to the model.
+ *
+ * Reads are cached per directory for the lifetime of the resolver: the
+ * `context` hook runs on every model request, and re-reading and re-validating
+ * a file that cannot change without the user editing it is pure overhead on
+ * the agent loop's hot path. {@link SpecResolver.invalidate} drops the cache
+ * for callers that do edit it.
+ */
+import type { ProceduralSpec } from '@skillstate/core';
+/** The file a project keeps its procedural spec in. */
+export declare const SPEC_FILE_NAME = "skill-spec.json";
+/** Where the resolved spec came from. */
+export type SpecSource = 'builtin' | 'file';
+/** The outcome of {@link SpecResolver.resolve}. */
+export interface SpecResolution {
+    /** The spec to build the prompt from. Always valid. */
+    readonly spec: ProceduralSpec;
+    /** `builtin` when the file was absent or rejected. */
+    readonly source: SpecSource;
+    /** Absolute path of the file that was read, when one existed. */
+    readonly path?: string;
+    /**
+     * Why a file was rejected, verbatim. Present only alongside
+     * `source: 'builtin'` when a file existed and did not validate.
+     */
+    readonly rejected?: string;
+}
+/**
+ * Validate a parsed spec document. Returns the spec, or a sentence naming
+ * the first field that failed. Pure.
+ *
+ * The checks are deliberately structural only — they reject a document that
+ * could not be rendered or that would misdescribe Σₜ, and nothing subtler.
+ * Semantic review of an instructions string is not something a type check can
+ * do, and pretending otherwise would be worse than not checking.
+ */
+export declare function parseSpec(value: unknown): ProceduralSpec | string;
+/**
+ * Per-project spec resolution with a cache.
+ *
+ * One instance per plugin setup. The cache key is the resolved project
+ * directory, so a single OpenCode server serving several checkouts gets a
+ * different spec per checkout without the caller managing that.
+ */
+export declare class SpecResolver {
+    private readonly cache;
+    /**
+     * The spec for `directory`, reading and validating the file at most once
+     * per {@link invalidate}.
+     */
+    resolve(directory: string): SpecResolution;
+    /** Drop the cached spec for `directory` (or for every directory). */
+    invalidate(directory?: string): void;
+    private load;
+}
+//# sourceMappingURL=spec-loader.d.ts.map

package/dist/spec-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-loader.d.ts","sourceRoot":"","sources":["../src/spec-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,kBAAkB,CAAC;AAEjF,uDAAuD;AACvD,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5C,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AA+BD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,MAAM,CAiBjE;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAOzC;IAED,qEAAqE;IACrE,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAGnC;IAED,OAAO,CAAC,IAAI;CA8Bb"}

package/dist/spec-loader.js

@@ -0,0 +1,163 @@
+/**
+ * Resolving P — the procedural specification the paper's prompt is built on.
+ *
+ * ── Why the plugin needs a spec at all ────────────────────────────────────
+ *
+ * A.4 is `Format(P, Σₜ, Oₜ)`, and P is the first argument. Paper mode
+ * therefore cannot assemble a paper-conformant prompt without one, even
+ * though the store ({@link ProjectStateStore}) is deliberately schema-free:
+ * notes mode never shows the model a schema, so it never needs P.
+ *
+ * ── Resolution order ─────────────────────────────────────────────────────
+ *
+ * 1. `<project>/skill-spec.json` — the file `skillstate init` writes and the
+ *    one the CLI's `--spec` already points at (`config.ts` default
+ *    `specPath: './skill-spec.json'`). A project that has customised its
+ *    procedure gets that procedure.
+ * 2. {@link GENERIC_PROCEDURE_SPEC} — the built-in, domain-neutral default.
+ *
+ * ── A malformed spec file must not reach the model ────────────────────────
+ *
+ * A half-written or hand-mangled `skill-spec.json` is exactly the kind of
+ * input that produced the v1 failure, where the spec's own instructions
+ * ("You are an autonomous CTF agent … find the flag") overrode the user. So
+ * the file is VALIDATED before it is trusted, field by field, and anything
+ * that does not typecheck falls back to the built-in spec with the reason
+ * recorded. There is no code path that feeds an unvalidated P to the model.
+ *
+ * Reads are cached per directory for the lifetime of the resolver: the
+ * `context` hook runs on every model request, and re-reading and re-validating
+ * a file that cannot change without the user editing it is pure overhead on
+ * the agent loop's hot path. {@link SpecResolver.invalidate} drops the cache
+ * for callers that do edit it.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { GENERIC_PROCEDURE_SPEC, isPlainObject } from '@skillstate/core';
+/** The file a project keeps its procedural spec in. */
+export const SPEC_FILE_NAME = 'skill-spec.json';
+const SCHEMA_TYPES = new Set([
+    'string',
+    'number',
+    'boolean',
+    'array',
+    'object',
+]);
+function validateSchema(value, at) {
+    if (!isPlainObject(value))
+        return `${at} is not an object`;
+    const schema = {};
+    for (const [key, raw] of Object.entries(value)) {
+        if (!isPlainObject(raw))
+            return `${at}.${key} is not an object`;
+        const type = raw['type'];
+        if (typeof type !== 'string' || !SCHEMA_TYPES.has(type)) {
+            return `${at}.${key}.type must be one of ${[...SCHEMA_TYPES].join(', ')}`;
+        }
+        if (!('default' in raw))
+            return `${at}.${key}.default is required`;
+        const description = raw['description'];
+        if (description !== undefined && typeof description !== 'string') {
+            return `${at}.${key}.description must be a string`;
+        }
+        const field = { type: type, default: raw['default'] };
+        if (typeof description === 'string')
+            field.description = description;
+        schema[key] = field;
+    }
+    return schema;
+}
+/**
+ * Validate a parsed spec document. Returns the spec, or a sentence naming
+ * the first field that failed. Pure.
+ *
+ * The checks are deliberately structural only — they reject a document that
+ * could not be rendered or that would misdescribe Σₜ, and nothing subtler.
+ * Semantic review of an instructions string is not something a type check can
+ * do, and pretending otherwise would be worse than not checking.
+ */
+export function parseSpec(value) {
+    if (!isPlainObject(value))
+        return 'spec is not an object';
+    const id = value['id'];
+    if (typeof id !== 'string' || id.trim() === '')
+        return 'id must be a non-empty string';
+    const name = value['name'];
+    if (typeof name !== 'string' || name.trim() === '')
+        return 'name must be a non-empty string';
+    const version = value['version'];
+    if (typeof version !== 'string' || version.trim() === '') {
+        return 'version must be a non-empty string';
+    }
+    const instructions = value['instructions'];
+    if (typeof instructions !== 'string' || instructions.trim() === '') {
+        return 'instructions must be a non-empty string';
+    }
+    const schema = validateSchema(value['schema'], 'schema');
+    if (typeof schema === 'string')
+        return schema;
+    return { id, name, version, instructions, schema };
+}
+/**
+ * Per-project spec resolution with a cache.
+ *
+ * One instance per plugin setup. The cache key is the resolved project
+ * directory, so a single OpenCode server serving several checkouts gets a
+ * different spec per checkout without the caller managing that.
+ */
+export class SpecResolver {
+    cache = new Map();
+    /**
+     * The spec for `directory`, reading and validating the file at most once
+     * per {@link invalidate}.
+     */
+    resolve(directory) {
+        const key = path.resolve(directory);
+        const cached = this.cache.get(key);
+        if (cached !== undefined)
+            return cached;
+        const resolution = this.load(key);
+        this.cache.set(key, resolution);
+        return resolution;
+    }
+    /** Drop the cached spec for `directory` (or for every directory). */
+    invalidate(directory) {
+        if (directory === undefined)
+            this.cache.clear();
+        else
+            this.cache.delete(path.resolve(directory));
+    }
+    load(directory) {
+        const file = path.join(directory, SPEC_FILE_NAME);
+        let raw;
+        try {
+            raw = fs.readFileSync(file, 'utf-8');
+        }
+        catch {
+            return { spec: GENERIC_PROCEDURE_SPEC, source: 'builtin' };
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (error) {
+            return {
+                spec: GENERIC_PROCEDURE_SPEC,
+                source: 'builtin',
+                path: file,
+                rejected: `invalid JSON: ${String(error)}`,
+            };
+        }
+        const validated = parseSpec(parsed);
+        if (typeof validated === 'string') {
+            return {
+                spec: GENERIC_PROCEDURE_SPEC,
+                source: 'builtin',
+                path: file,
+                rejected: validated,
+            };
+        }
+        return { spec: validated, source: 'file', path: file };
+    }
+}
+//# sourceMappingURL=spec-loader.js.map

package/dist/spec-loader.js.map

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