skillscript-runtime 0.7.0 → 0.7.2

package/dist/connectors/memory-store-mcp.js

@@ -0,0 +1,94 @@
+// v0.7.2 — `MemoryStoreMcpConnector`. Bridge class that exposes a registered
+// `MemoryStore` instance as an `McpConnector`, so the canonical
+// `$ memory mode=... query=... limit=N` MCP-dispatch path works in default
+// deployments without adopter wiring.
+//
+// Per Perry's v0.7.2 kickoff (d284763f) + Scott's substrate-portability
+// architectural decision (831c2661 thread) + Perry's bundled-memory-call
+// scope-lock (5f471b0a).
+//
+// **Bundled surface is ONE canonical call.** Read-only FTS-flavored query:
+//
+//   $ <connector_name> mode="fts|semantic|rerank" query="..." limit=N [...extras] -> R
+//
+// where R is `{items: PortableMemory[]}` envelope (consistent with the
+// object-iteration-advisory hint pattern: cold authors write
+// `foreach M in ${R.items}`).
+//
+// Explicitly NOT in this bridge: `memory_write`, by-id lookup, thread
+// operations, introspection / traversal / promote / reinforce. Those
+// are substrate-specific and adopter-wired via the dotted form
+// (e.g., `$ amp.amp_write_memory ...`).
+//
+// Substrate-portability: skills written against this bridge's shape
+// work across any `MemoryStore` interface impl. The bundled
+// `SqliteMemoryStore` is the reference impl; adopters with FTS-style
+// substrates implement `MemoryStore` and the bridge transparently
+// wraps. Fundamentally-different substrates (vector DBs, embedding-
+// based stores) wire under different connector names with their own
+// surface — this bridge stays canonical FTS-flavored.
+//
+// Wiring: auto-registered at bootstrap as connector instance "memory"
+// pointing at the "default" MemoryStore registration. Adopters override
+// by re-registering "memory" with their own bridge instance OR a
+// different MCP connector entirely.
+const CONTRACT_VERSION = "1.0.0";
+export class MemoryStoreMcpConnector {
+    memoryStore;
+    static staticCapabilities() {
+        return {
+            connector_type: "mcp_connector",
+            implementation: "MemoryStoreMcpConnector",
+            contract_version: CONTRACT_VERSION,
+            features: {
+                supports_identity_propagation: false,
+                supports_streaming_responses: false,
+                supports_batch: false,
+            },
+        };
+    }
+    constructor(memoryStore) {
+        this.memoryStore = memoryStore;
+    }
+    async call(_toolName, args, _ctxOverrides) {
+        const query = typeof args["query"] === "string" ? args["query"] : "";
+        if (query === "") {
+            throw new Error("MemoryStoreMcpConnector: `query` kwarg is required and must be a non-empty string.");
+        }
+        const mode = typeof args["mode"] === "string" && args["mode"] !== "" ? args["mode"] : "fts";
+        let limit = 10;
+        const rawLimit = args["limit"];
+        if (typeof rawLimit === "number" && rawLimit > 0) {
+            limit = rawLimit;
+        }
+        else if (typeof rawLimit === "string") {
+            const n = parseInt(rawLimit, 10);
+            if (Number.isFinite(n) && n > 0)
+                limit = n;
+        }
+        // Pass extras (anything beyond mode/query/limit) verbatim — substrate
+        // impls may consume domain_tags, vault, payload_type, etc.
+        const filters = { query, limit, mode };
+        for (const [k, v] of Object.entries(args)) {
+            if (k === "query" || k === "limit" || k === "mode")
+                continue;
+            filters[k] = v;
+        }
+        const items = await this.memoryStore.query(filters);
+        // Envelope-wrap per the canonical contract. Cold-author iteration
+        // pattern: `foreach M in ${R.items}` (consistent with the v0.7.2
+        // object-iteration-advisory's hint).
+        return { items };
+    }
+    async manifest() {
+        const msManifest = await this.memoryStore.manifest();
+        return {
+            capabilities_version: "1",
+            manifest: {
+                kind: "memory-store-bridge",
+                wraps: msManifest.manifest ?? {},
+            },
+        };
+    }
+}
+//# sourceMappingURL=memory-store-mcp.js.map

package/dist/connectors/memory-store-mcp.js.map

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

package/dist/help-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help-content.d.ts","sourceRoot":"","sources":["../src/help-content.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAuoBzD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}
+{"version":3,"file":"help-content.d.ts","sourceRoot":"","sources":["../src/help-content.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAstBzD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}