@skillstate/opencode 2.2.2 → 3.0.1

package/dist/tools.js

@@ -0,0 +1,350 @@
+/**
+ * Native OpenCode tools for skillstate.
+ *
+ * These are the NATIVE tools: the fast path when the host is opencode v2.
+ * They carry a real JSON Schema and structured output, where the MCP server
+ * (`@skillstate/mcp`, still shipped and still registered) can only offer a
+ * JSON-RPC round-trip and untyped text. Both read the same state file, so
+ * the choice between them is about speed and typing on one side and reach
+ * on the other -- never about which one is correct.
+ *
+ * The MCP server was once the ONLY option: an opencode v1 plugin could not
+ * contribute first-class tools at all.
+ *
+ * Three tools, deliberately:
+ *
+ * - `skillstate_read`   - what this session has already saved.
+ * - `skillstate_update` - merge a patch (the only write path).
+ * - `skillstate_merge`  - fold sub-agent notes back into the root session.
+ *
+ * A fourth "delete everything" tool is intentionally absent: `null` in a
+ * patch already deletes a key, and a tool whose only job is to erase state
+ * is a foot-gun with no upside.
+ *
+ * ── Result shape ──────────────────────────────────────────────────────────
+ *
+ * Every tool returns a DISCRIMINATED result: `{ ok: true, ... }` or
+ * `{ ok: false, error }`. This is not a stylistic choice. A tool that
+ * declares an `output` schema must return a value matching it, so a failure
+ * path that returned only text was rejected by the host with "tool did not
+ * return its declared output" — a rejected tool call is worse for the agent
+ * than a failed one, because it loses the reason. A validation failure is a
+ * normal outcome here, and it is modelled as one.
+ *
+ * SCOPING is automatic. The current session's scope comes from
+ * `ToolContext.sessionID` plus the {@link SessionRegistry}, so the model
+ * never passes a session id and can never write another agent's file by
+ * guessing one.
+ */
+import { validatePatch } from '@skillstate/core';
+import { stateScopeFor } from './session-registry.js';
+/**
+ * Largest serialized patch a single `skillstate_update` accepts. The state
+ * file is a side channel for a human to read; a model that tries to dump a
+ * whole file into it should be told, not silently accommodated.
+ */
+export const MAX_PATCH_BYTES = 64 * 1024;
+/* ------------------------------------------------------------------ */
+/*  Result plumbing                                                    */
+/* ------------------------------------------------------------------ */
+/** Wrap a successful payload in the tool result envelope. */
+function ok(value) {
+    return { ok: true, value };
+}
+/** Wrap a refusal in the tool result envelope. */
+function refuse(error) {
+    return { ok: false, error };
+}
+/**
+ * Render a result as the host-facing tool result.
+ *
+ * `content` carries the same JSON so the model reads a stable shape whether
+ * or not the host surfaces `output` — and a refusal states its reason in
+ * plain text rather than burying it in a shape the model must parse.
+ */
+function render(result) {
+    if (result.ok) {
+        return { output: result, content: JSON.stringify(result.value, null, 2) };
+    }
+    return { output: result, content: result.error };
+}
+/* ------------------------------------------------------------------ */
+/*  Schemas                                                            */
+/* ------------------------------------------------------------------ */
+function object(properties, required = []) {
+    return {
+        type: 'object',
+        properties,
+        required: [...required],
+        additionalProperties: false,
+    };
+}
+/** The state document: a free-form JSON object. */
+const STATE = { type: 'object', additionalProperties: true };
+const STRING_ARRAY = { type: 'array', items: { type: 'string' } };
+/** The change sets a patch or merge reports. */
+const CHANGES = object({ added: STRING_ARRAY, updated: STRING_ARRAY, deleted: STRING_ARRAY }, ['added', 'updated', 'deleted']);
+/**
+ * Build an `output` schema for a result whose success payload is `value`.
+ *
+ * The `ok` discriminator is the only required key, so a refusal validates
+ * exactly as well as a success does — the shape the host checks is the
+ * shape every call actually returns.
+ */
+function outputSchema(value) {
+    return object({
+        ok: { type: 'boolean' },
+        value: value,
+        error: { type: 'string' },
+    }, ['ok']);
+}
+const READ_OUTPUT = outputSchema(object({ state: STATE, path: { type: 'string' }, scope: { type: 'string' }, empty: { type: 'boolean' } }, [
+    'state',
+    'path',
+    'scope',
+    'empty',
+]));
+const UPDATE_OUTPUT = outputSchema(object({ state: STATE, changes: CHANGES, path: { type: 'string' }, scope: { type: 'string' } }, ['state', 'changes', 'path', 'scope']));
+const MERGE_OUTPUT = outputSchema(object({
+    state: STATE,
+    changes: CHANGES,
+    merged: STRING_ARRAY,
+    skipped: STRING_ARRAY,
+}, ['state', 'changes', 'merged', 'skipped']));
+/* ------------------------------------------------------------------ */
+/*  Input handling                                                     */
+/* ------------------------------------------------------------------ */
+/** JSON guard: a usable top-level object value. */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Narrow a tool's `input`.
+ *
+ * A tool declared with a JSON Schema is validated by the host before
+ * `execute` runs, so the parameter arrives typed `unknown` and narrowing it
+ * here is the honest boundary rather than a cast. Unknown keys are dropped
+ * instead of forwarded, so a model that invents a field cannot smuggle it
+ * into the patch. The host check is not sufficient on its own: it cannot
+ * see a byte budget, and JSON Schema does not describe "no undefined".
+ */
+function readInput(input, guard) {
+    if (!isPlainObject(input))
+        return guard({});
+    return guard(input);
+}
+/** Reader for `skillstate_read`: an optional sub-agent scope. */
+function readReadInput(input) {
+    return readInput(input, (raw) => {
+        const scope = typeof raw['scope'] === 'string' ? raw['scope'].trim() : '';
+        return scope.length > 0 ? { scope } : {};
+    });
+}
+/** Reader for `skillstate_update`: the required patch. */
+function readUpdateInput(input) {
+    return readInput(input, (raw) => ({ patch: raw['patch'] }));
+}
+/** Reader for `skillstate_merge`: optional scope and keep policy. */
+function readMergeInput(input) {
+    return readInput(input, (raw) => {
+        const scope = typeof raw['scope'] === 'string' ? raw['scope'].trim() : '';
+        return {
+            ...(scope.length > 0 ? { scope } : {}),
+            keep: raw['keep'] === 'source' ? 'source' : 'existing',
+        };
+    });
+}
+/**
+ * Validate and normalize an incoming patch.
+ *
+ * Returns either the patch or a human-readable reason it was rejected. The
+ * checks protect the file; they do not dictate the model's schema. A state
+ * note is free-form by design, so the only hard rules are "must be an
+ * object", "must be JSON-serializable", and "must fit".
+ */
+export function normalizePatch(raw) {
+    if (!isPlainObject(raw)) {
+        return {
+            ok: false,
+            reason: '`patch` must be a JSON object, for example {"decisions": ["..."]}.',
+        };
+    }
+    for (const [key, value] of Object.entries(raw)) {
+        if (key.length === 0) {
+            return { ok: false, reason: '`patch` contains an empty key.' };
+        }
+        if (value === undefined) {
+            return {
+                ok: false,
+                reason: `\`${key}\` is undefined - omit the key instead, or set it to null to delete it.`,
+            };
+        }
+    }
+    let serialized;
+    try {
+        serialized = JSON.stringify(raw);
+    }
+    catch {
+        return {
+            ok: false,
+            reason: '`patch` is not JSON-serializable - use plain objects, arrays, strings, numbers, booleans and null.',
+        };
+    }
+    const bytes = Buffer.byteLength(serialized, 'utf-8');
+    if (bytes > MAX_PATCH_BYTES) {
+        return {
+            ok: false,
+            reason: `\`patch\` is ${bytes} bytes, over the ${MAX_PATCH_BYTES}-byte limit. Keep file contents in the repository instead and save only the path.`,
+        };
+    }
+    return { ok: true, patch: raw };
+}
+/** Best-effort error text; never leaks a stack into the model context. */
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * The scope a call addresses: an explicit override when the model passed
+ * one (only ever a sub-agent scope name it learned from the system fragment
+ * or from `skillstate_merge`), otherwise this session's own scope.
+ */
+function resolveScope(scope, context, deps) {
+    return scope !== undefined && scope.length > 0 ? scope : deps.scopeFor(context.sessionID);
+}
+/* ------------------------------------------------------------------ */
+/*  Registration                                                       */
+/* ------------------------------------------------------------------ */
+/**
+ * Register the skillstate tools on an editor.
+ *
+ * The callback is synchronous, side-effect-free and replayable: OpenCode
+ * re-runs it on every registry rebuild, so it must not do I/O at
+ * registration time. All filesystem work happens inside `execute`.
+ */
+export function registerTools(editor, deps) {
+    editor.namespace({
+        name: 'skillstate',
+        description: 'Persist project notes across context resets and compaction.',
+    });
+    /* -- skillstate_read ---------------------------------------------- */
+    editor.add({
+        name: 'skillstate_read',
+        description: 'Read the notes this session has saved for the current project (file: .skillstate/skillstate.json). Use after a context reset or compaction to recover earlier decisions, file paths, and remaining work. Returns the stored document, or an empty object when nothing is saved yet.',
+        input: object({
+            scope: {
+                type: 'string',
+                description: 'Optional sub-agent scope to read instead of this session. Omit to read this session own notes.',
+            },
+        }),
+        output: READ_OUTPUT,
+        async execute(input, context) {
+            const scope = resolveScope(readReadInput(input).scope, context, deps);
+            const state = deps.store.read(scope);
+            return render(ok({
+                state,
+                path: deps.store.pathFor(scope),
+                scope,
+                empty: Object.keys(state).length === 0,
+            }));
+        },
+    });
+    /* -- skillstate_update -------------------------------------------- */
+    editor.add({
+        name: 'skillstate_update',
+        description: 'Merge a patch into the notes this session has saved for the project. Keys merge shallowly, nested objects merge recursively, and a null value deletes that key. Use it to record a decision already made, a file path already located, or what is still outstanding - not to log the conversation. Returns the merged document and which keys changed.',
+        input: object({
+            patch: {
+                type: 'object',
+                description: 'Sparse patch to merge, e.g. {"decisions":["..."],"todo":["..."]}. Set a key to null to delete it.',
+            },
+        }, ['patch']),
+        output: UPDATE_OUTPUT,
+        async execute(input, context) {
+            const checked = normalizePatch(readUpdateInput(input).patch);
+            if (!checked.ok)
+                return render(refuse(checked.reason));
+            // §6.2, when there is a P to validate against. Deterministic, runtime-side,
+            // and it never sees the model: a refused patch leaves Σ exactly as it was.
+            if (deps.schema !== undefined) {
+                const verdict = validatePatch(deps.schema, checked.patch);
+                if (!verdict.valid) {
+                    // The declared fields go in the refusal. §6.4's rollback is that a
+                    // rejected patch has no path into Σ, which means the model gets one
+                    // more turn with nothing changed — so the refusal has to say what the
+                    // alternative is, or the model retries the identical patch. Naming the
+                    // offending key alone is a dead end it cannot act on.
+                    return render(refuse(`${verdict.error} (field: ${verdict.field}). ` +
+                        `This project declares: ${Object.keys(deps.schema).join(', ') || 'no fields'}.`));
+                }
+            }
+            const scope = resolveScope(undefined, context, deps);
+            try {
+                const { state, changes } = await deps.store.patch(scope, checked.patch);
+                deps.onWrite?.(scope);
+                return render(ok({ state, changes, path: deps.store.pathFor(scope), scope }));
+            }
+            catch (error) {
+                return render(refuse(`Could not save the notes: ${errorMessage(error)}`));
+            }
+        },
+    });
+    /* -- skillstate_merge --------------------------------------------- */
+    editor.add({
+        name: 'skillstate_merge',
+        description: 'Fold a sub-agent saved notes into this session notes. Call it with no arguments from a root session to fold in every sub-agent of this session, or pass a sub-agent scope to fold just that one. Nested objects merge; conflicting values keep the existing one unless you pass keep: "source".',
+        input: object({
+            scope: {
+                type: 'string',
+                description: 'Sub-agent scope to fold in. Omit to fold in every sub-agent of this session.',
+            },
+            keep: {
+                type: 'string',
+                enum: ['existing', 'source'],
+                description: 'Which side wins a conflict. Defaults to "existing", this session value.',
+            },
+        }),
+        output: MERGE_OUTPUT,
+        async execute(input, context) {
+            if (context.signal.aborted)
+                return render(refuse('Cancelled.'));
+            if (deps.scopeFor(context.sessionID) !== '') {
+                return render(refuse('skillstate_merge is only available to the root session. Write your findings with skillstate_update instead - the main session folds them in.'));
+            }
+            const { scope, keep } = readMergeInput(input);
+            // A bulk fold enumerates SESSION ids from the registry, so each one has
+            // to be translated to the scope name it writes under. An explicit
+            // `scope` is already a scope name (the model read it from the system
+            // fragment) and must be passed through untouched.
+            const targets = scope !== undefined
+                ? [{ scope, label: scope }]
+                : deps.sessions
+                    .descendantsOf(context.sessionID)
+                    .map((sessionID) => ({ scope: deps.scopeFor(sessionID), label: sessionID }));
+            if (targets.length === 0) {
+                return render(ok({ state: deps.store.read(''), changes: emptyChanges(), merged: [], skipped: [] }));
+            }
+            const merged = [];
+            const skipped = [];
+            let state = {};
+            let changes = emptyChanges();
+            for (const target of targets) {
+                try {
+                    const result = await deps.store.merge('', target.scope, keep);
+                    state = result.state;
+                    changes = result.changes;
+                    merged.push(target.label);
+                }
+                catch {
+                    skipped.push(target.label);
+                }
+            }
+            return render(ok({ state, changes, merged, skipped }));
+        },
+    });
+}
+/** A change set with nothing in it. */
+function emptyChanges() {
+    return { added: [], updated: [], deleted: [] };
+}
+export { stateScopeFor };
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillstate/opencode",
-  "version": "2.2.2",
+  "version": "3.0.1",
   "description": "OpenCode platform adapter for the skillstate runtime.",
   "type": "module",
   "main": "dist/index.js",
@@ -25,6 +25,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@skillstate/core": "^2.2.2"
+    "@opencode/plugin": "2.0.19",
+    "@skillstate/core": "^3.0.0"
   }
 }

package/dist/plugin-types.d.ts

@@ -1,71 +0,0 @@
-/**
- * Minimal local types for OpenCode plugin hooks — the `@opencode-ai/plugin`
- * shape, verified against opencode 1.17 (PluginInput/Hooks). Declared locally
- * to keep `@skillstate/opencode` zero-dep; the host supplies the real types
- * at runtime.
- */
-/** Message roles seen by `experimental.chat.messages.transform`. */
-export type OpenCodeMessageRole = 'user' | 'assistant' | 'system';
-/**
- * Message envelope: the transform pipeline hands each message as
- * `{ info, parts }` — the role lives on `info.role`.
- */
-export interface OpenCodeMessage {
-    info: {
-        role: OpenCodeMessageRole | string;
-        [key: string]: unknown;
-    };
-    parts: Array<{
-        type: string;
-        text?: string;
-        [key: string]: unknown;
-    }>;
-}
-/** Output payload of `experimental.chat.messages.transform`. */
-export interface MessagesTransformOutput {
-    /** Mutated IN PLACE — the pipeline keeps the original array reference. */
-    messages: OpenCodeMessage[];
-}
-/** Output payload of `experimental.session.compacting`. */
-export interface SessionCompactingOutput {
-    context: string[];
-    prompt?: string;
-}
-/** Output payload of `tool.execute.after`. */
-export interface ToolExecuteAfterOutput {
-    title?: string;
-    /** The tool's string response (state_patch extraction source). */
-    output: unknown;
-    metadata?: unknown;
-}
-/** OpenCode hooks used by the skillstate plugin. */
-export interface SkillStateHooks {
-    /**
-     * Host event bus (`session.created`/`session.updated` carry the full
-     * Session, including `parentID`) — feeds the sub-agent registry.
-     */
-    event?: (input: {
-        event: unknown;
-    }) => Promise<void>;
-    'experimental.chat.messages.transform'?: (input: Record<string, never>, output: MessagesTransformOutput) => Promise<void>;
-    'experimental.session.compacting'?: (input: {
-        sessionID: string;
-    }, output: SessionCompactingOutput) => Promise<void>;
-    'tool.execute.after'?: (input: {
-        tool: string;
-        sessionID: string;
-        callID: string;
-        args: unknown;
-    }, output: ToolExecuteAfterOutput) => Promise<void>;
-}
-/**
- * OpenCode plugin: an async factory receiving the host input and returning
- * the hooks object (`Plugin` from `@opencode-ai/plugin`).
- */
-export type SkillStatePlugin = (input: {
-    project?: unknown;
-    client?: unknown;
-    $?: unknown;
-    [key: string]: unknown;
-}) => Promise<SkillStateHooks>;
-//# sourceMappingURL=plugin-types.d.ts.map

package/dist/plugin-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QAAE,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACrE,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC,0EAA0E;IAC1E,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,sCAAsC,CAAC,EAAE,CACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC5B,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,iCAAiC,CAAC,EAAE,CAClC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5B,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,oBAAoB,CAAC,EAAE,CACrB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EACzE,MAAM,EAAE,sBAAsB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC"}

package/dist/plugin-types.js

@@ -1,8 +0,0 @@
-/**
- * Minimal local types for OpenCode plugin hooks — the `@opencode-ai/plugin`
- * shape, verified against opencode 1.17 (PluginInput/Hooks). Declared locally
- * to keep `@skillstate/opencode` zero-dep; the host supplies the real types
- * at runtime.
- */
-export {};
-//# sourceMappingURL=plugin-types.js.map

package/dist/plugin-types.js.map

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