skillscript-runtime 0.2.4

package/dist/skill-manager.js

@@ -0,0 +1,251 @@
+// Runtime-layer skill management API. User-facing surface for storing and
+// deleting skills with referential-integrity guarantees that the connector
+// contract intentionally delegates to this layer.
+//
+// `ReferentialIntegrityError` is a runtime-layer error class — NOT a
+// `ConnectorError` subclass. The distinction matters: the executor's
+// `else:` / `# OnError:` machinery catches `ConnectorError`s thrown
+// inside skill execution and routes them through the recovery chain.
+// `ReferentialIntegrityError` is thrown by `deleteSkill()`, which is a
+// user-facing management API — not a skill-execution op — so it surfaces
+// directly to the caller and bypasses recovery routing.
+import { parse } from "./parser.js";
+/**
+ * Thrown by `deleteSkill()` when the target skill is referenced by other
+ * skills and `opts.force` is not set. Runtime-layer error, distinct from
+ * the `ConnectorError` hierarchy in `src/errors.ts`.
+ */
+export class ReferentialIntegrityError extends Error {
+    skill_name;
+    referenced_by;
+    constructor(skill_name, referenced_by) {
+        super(`Cannot delete skill '${skill_name}' — referenced by: ${referenced_by.join(", ")}. ` +
+            `Pass { force: true } to delete anyway.`);
+        this.skill_name = skill_name;
+        this.referenced_by = referenced_by;
+        this.name = "ReferentialIntegrityError";
+    }
+}
+/**
+ * Runtime reference index. Maps `referencedSkill → set of skills that
+ * reference it`. Bidirectional bookkeeping lets storeSkill/delete updates
+ * stay O(refs) instead of O(N) scans.
+ *
+ * **Out-of-band edit tolerance.** If someone edits a `.skill` file directly
+ * (bypassing storeSkill), the index goes stale until the runtime restarts
+ * or `runtime.invalidateConnector()` triggers a rebuild. Not a correctness
+ * issue — the next startup scan re-derives — but operators editing files
+ * by hand will see incorrect referential-integrity checks until they
+ * either restart or invalidate.
+ *
+ * The runtime ships an explicit `rebuildIndex()` escape hatch for live
+ * recovery without restart.
+ */
+export class ReferenceIndex {
+    /** `name → skills that reference name` (deleteSkill consumes this). */
+    referencedBy = new Map();
+    /** `name → skills that name references` (storeSkill bookkeeping). */
+    referencing = new Map();
+    /** Skills that reference the given target. Empty array if none. */
+    referencesTo(name) {
+        const set = this.referencedBy.get(name);
+        return set ? Array.from(set).sort() : [];
+    }
+    /** Skills that the given source references. Empty array if none. */
+    referencesFrom(name) {
+        const set = this.referencing.get(name);
+        return set ? Array.from(set).sort() : [];
+    }
+    /** Update edges for one skill — replaces its outgoing edges. Used after storeSkill. */
+    setOutgoing(name, targets) {
+        // Drop old outgoing edges from referencedBy.
+        const oldTargets = this.referencing.get(name);
+        if (oldTargets !== undefined) {
+            for (const t of oldTargets) {
+                const set = this.referencedBy.get(t);
+                if (set !== undefined) {
+                    set.delete(name);
+                    if (set.size === 0)
+                        this.referencedBy.delete(t);
+                }
+            }
+        }
+        if (targets.length === 0) {
+            this.referencing.delete(name);
+        }
+        else {
+            this.referencing.set(name, new Set(targets));
+            for (const t of targets) {
+                let set = this.referencedBy.get(t);
+                if (set === undefined) {
+                    set = new Set();
+                    this.referencedBy.set(t, set);
+                }
+                set.add(name);
+            }
+        }
+    }
+    /** Drop all edges originating from `name`. Used after deleteSkill. */
+    drop(name) {
+        this.setOutgoing(name, []);
+    }
+    /** Total edge count — for tests + diagnostics. */
+    size() {
+        let n = 0;
+        for (const set of this.referencing.values())
+            n += set.size;
+        return n;
+    }
+    /**
+     * Replace this index's edges with another's. Used by
+     * `invalidateConnector()` when rebuilding from disk — the caller passes
+     * the long-lived index, we rebuild a fresh one off the store, then
+     * atomically swap the edges.
+     */
+    replaceAll(other) {
+        this.referencedBy.clear();
+        this.referencing.clear();
+        for (const [name, targets] of other.referencing) {
+            this.setOutgoing(name, Array.from(targets));
+        }
+    }
+}
+/**
+ * Walk a skill's parsed AST and extract names of skills it references via
+ * the `&` op. Returns a deduplicated, sorted list. Includes references to
+ * both data-skills (which inline at compile time) and procedural skills
+ * (which compile to runtime invocations) — the integrity check should fire
+ * for either, since deleting any referenced skill breaks the source.
+ *
+ * Walks foreach + if bodies recursively. T3+ grammar; T1 returns empty.
+ */
+export function extractReferences(source) {
+    const parsed = parse(source);
+    const refs = new Set();
+    for (const target of parsed.targets.values()) {
+        collectAmpRefs(target.ops, refs);
+        if (target.elseBlock !== undefined)
+            collectAmpRefs(target.elseBlock, refs);
+    }
+    return Array.from(refs).sort();
+}
+function collectAmpRefs(ops, out) {
+    for (const op of ops) {
+        if (op.kind === "&" && op.ampParams !== undefined) {
+            out.add(op.ampParams.skillName);
+        }
+        if (op.foreachBody !== undefined)
+            collectAmpRefs(op.foreachBody, out);
+        if (op.ifBranches !== undefined) {
+            for (const branch of op.ifBranches)
+                collectAmpRefs(branch.body, out);
+        }
+        if (op.ifElseBody !== undefined)
+            collectAmpRefs(op.ifElseBody, out);
+    }
+}
+/**
+ * Build a fresh reference index from a SkillStore by scanning every skill.
+ * Called once at runtime startup; subsequent storeSkill/deleteSkill calls
+ * maintain incrementally.
+ */
+export async function buildReferenceIndex(store) {
+    const index = new ReferenceIndex();
+    const metas = await store.query();
+    for (const meta of metas) {
+        try {
+            const source = await store.load(meta.name);
+            const refs = extractReferences(source.source);
+            if (refs.length > 0)
+                index.setOutgoing(meta.name, refs);
+        }
+        catch {
+            // Skip unreadable entries; query returned them but load failed.
+        }
+    }
+    return index;
+}
+/**
+ * Store (create or update) a skill, then update the reference index for
+ * its outgoing edges. Returns the substrate's `VersionInfo`.
+ */
+export async function storeSkill(name, source, options) {
+    const store = options.registry.getSkillStore(options.storeName);
+    const info = await store.store(name, source, options.metadata);
+    options.index.setOutgoing(name, extractReferences(source));
+    return info;
+}
+/**
+ * Delete a skill. Default behavior: index lookup; if any skill references
+ * the target, throw `ReferentialIntegrityError`. With `opts.force`, skip
+ * the check and dispatch directly to the substrate (which may still
+ * refuse for its own reasons, e.g., a signed-artifact store).
+ */
+export async function deleteSkill(name, options) {
+    if (options.force !== true) {
+        const referencedBy = options.index.referencesTo(name);
+        if (referencedBy.length > 0) {
+            throw new ReferentialIntegrityError(name, referencedBy);
+        }
+    }
+    const store = options.registry.getSkillStore(options.storeName);
+    await store.delete(name);
+    options.index.drop(name);
+}
+/**
+ * Invalidate a connector's cached state. **"Refresh everything dependent
+ * on this connector."** Type-aware behavior:
+ *
+ *   - Any connector kind: calls `instance.invalidateManifest()` if defined.
+ *     Triggers a refresh on the next `manifest()` call.
+ *   - SkillStore (when an `index` is passed in `options`): also rebuilds
+ *     the reference index by re-scanning the store. The recovery path for
+ *     stale reference state after operators edit `.skill` files directly
+ *     without going through `storeSkill()`.
+ *
+ * Used in dev/hot-reload loops and after operators change connector state
+ * out-of-band (new Ollama model loaded, new MCP server wired, manual
+ * .skill file edit).
+ *
+ * Convention reminder: connectors bump their internal `capabilities_version`
+ * on schema/structural changes, NOT on every query. This invalidate hook
+ * is the explicit escape valve for cases where the version-bump didn't
+ * fire (e.g., live model installation that the connector didn't observe,
+ * or out-of-band .skill file edits the runtime didn't mediate).
+ *
+ * Returns `Promise<void>` because the SkillStore reference-index rebuild
+ * is async. Non-SkillStore invalidations complete synchronously but the
+ * surface is uniform.
+ */
+export async function invalidateConnector(name, registry, options = {}) {
+    let matchedSkillStore = null;
+    for (const lookup of [
+        () => registry.hasLocalModel(name) ? registry.getLocalModel(name) : null,
+        () => registry.hasMemoryStore(name) ? registry.getMemoryStore(name) : null,
+        () => registry.hasSkillStore(name) ? registry.getSkillStore(name) : null,
+        () => registry.hasMcpConnector(name) ? registry.getMcpConnector(name) : null,
+    ]) {
+        const instance = lookup();
+        if (instance === null)
+            continue;
+        const maybe = instance;
+        if (typeof maybe.invalidateManifest === "function") {
+            maybe.invalidateManifest();
+        }
+    }
+    // Reference-index rebuild for SkillStore invalidations. Out-of-band
+    // .skill file edits (vim, direct disk writes) leave the in-memory
+    // reference index stale — incremental updates only fire through
+    // storeSkill(). A SkillStore invalidate is the explicit recovery.
+    if (registry.hasSkillStore(name)) {
+        matchedSkillStore = registry.getSkillStore(name);
+        if (options.index !== undefined) {
+            const fresh = await buildReferenceIndex(matchedSkillStore);
+            // Replace this index's edges with the rebuilt set. We do it by
+            // walking known edges + clearing them, then applying the fresh
+            // edges — cheaper than mutating private state from outside.
+            options.index.replaceAll(fresh);
+        }
+    }
+}
+//# sourceMappingURL=skill-manager.js.map

package/dist/skill-manager.js.map

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

package/dist/testing/conformance.d.ts

@@ -0,0 +1,57 @@
+import type { SkillStore, SkillStoreClass, MemoryStore, MemoryStoreClass, PortableMemory, LocalModel, LocalModelClass, McpConnector, McpConnectorClass } from "../connectors/types.js";
+import type { AgentConnector, AgentConnectorClass } from "../connectors/agent.js";
+export interface ConformanceTest {
+    category: ConformanceCategory;
+    name: string;
+    run(): Promise<void>;
+}
+export type ConformanceCategory = "method-existence" | "return-type" | "error-contract" | "static-capabilities" | "feature-behavior";
+export interface SkillStoreFixture {
+    build(): SkillStore;
+    ctor: SkillStoreClass;
+    teardown?(instance: SkillStore): Promise<void>;
+}
+export declare const SkillStoreConformance: {
+    buildTests(fixture: SkillStoreFixture): ConformanceTest[];
+};
+export interface MemoryStoreFixture {
+    build(): MemoryStore;
+    ctor: MemoryStoreClass;
+    seed?(instance: MemoryStore, memories: Partial<PortableMemory>[]): Promise<void>;
+    teardown?(instance: MemoryStore): Promise<void>;
+}
+export declare const MemoryStoreConformance: {
+    buildTests(fixture: MemoryStoreFixture): ConformanceTest[];
+};
+export interface LocalModelFixture {
+    build(): LocalModel;
+    ctor: LocalModelClass;
+    /** Set true if the model is reachable in the test environment. Default false. */
+    liveDispatch?: boolean;
+    teardown?(instance: LocalModel): Promise<void>;
+}
+export declare const LocalModelConformance: {
+    buildTests(fixture: LocalModelFixture): ConformanceTest[];
+};
+export interface McpConnectorFixture {
+    build(): McpConnector;
+    ctor: McpConnectorClass;
+    /** A tool name the connector should handle; used in the dispatch test. */
+    testToolName?: string;
+    teardown?(instance: McpConnector): Promise<void>;
+}
+export declare const McpConnectorConformance: {
+    buildTests(fixture: McpConnectorFixture): ConformanceTest[];
+};
+export interface AgentConnectorFixture {
+    build(): AgentConnector;
+    ctor: AgentConnectorClass;
+    /** Optional id the connector treats as reachable; used in deliver/wake tests. */
+    testAgentId?: string;
+    teardown?(instance: AgentConnector): Promise<void>;
+}
+export declare const AgentConnectorConformance: {
+    buildTests(fixture: AgentConnectorFixture): ConformanceTest[];
+};
+export type { SkillMeta } from "../connectors/types.js";
+//# sourceMappingURL=conformance.d.ts.map

package/dist/testing/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/testing/conformance.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAEf,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EAGlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,aAAa,GACb,gBAAgB,GAChB,qBAAqB,GACrB,kBAAkB,CAAC;AAIvB,MAAM,WAAW,iBAAiB;IAChC,KAAK,IAAI,UAAU,CAAC;IACpB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,CAAC,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,eAAO,MAAM,qBAAqB;wBACZ,iBAAiB,GAAG,eAAe,EAAE;CAyG1D,CAAC;AAIF,MAAM,WAAW,kBAAkB;IACjC,KAAK,IAAI,WAAW,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,QAAQ,CAAC,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,eAAO,MAAM,sBAAsB;wBACb,kBAAkB,GAAG,eAAe,EAAE;CAmC3D,CAAC;AAIF,MAAM,WAAW,iBAAiB;IAChC,KAAK,IAAI,UAAU,CAAC;IACpB,IAAI,EAAE,eAAe,CAAC;IACtB,iFAAiF;IACjF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,eAAO,MAAM,qBAAqB;wBACZ,iBAAiB,GAAG,eAAe,EAAE;CAyB1D,CAAC;AAIF,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,YAAY,CAAC;IACtB,IAAI,EAAE,iBAAiB,CAAC;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,uBAAuB;wBACd,mBAAmB,GAAG,eAAe,EAAE;CAe5D,CAAC;AAIF,MAAM,WAAW,qBAAqB;IACpC,KAAK,IAAI,cAAc,CAAC;IACxB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,yBAAyB;wBAChB,qBAAqB,GAAG,eAAe,EAAE;CAqD9D,CAAC;AAsHF,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}