@six5536/smllm-wasm 0.4.0 → 0.5.0

package/dist/node/host.d.ts

@@ -1,5 +1,5 @@
 import type { Host } from "../types.js";
-/** `timeoutSecs` default (DEC-5), as the CLI's. */
+/** `timeoutSecs` default (CLI-11), as the CLI's. */
 export declare const DEFAULT_TIMEOUT_SECS = 60;
 /**
  * A host that runs `command` guards and actions. `configDir` is the folder

package/dist/node/host.js

@@ -1,17 +1,16 @@
-// The Node command host (HOST-15): `command` guards
-// and actions run as the CLI runs them (DEC-4..DEC-7). Host methods are
+// The Node command host (WASM-3): `command` guards
+// and actions run as the CLI runs them (CLI-11..CLI-11). Host methods are
 // synchronous, so commands run with `spawnSync`. On unix the command is
 // started detached, as the leader of its own process group, and a timeout
 // kills that whole group, so what the command started dies with it; its
 // output goes to a file, not a pipe, so a process it leaves running cannot
 // hold the call open. On Windows the command's own process is killed, as the
 // CLI does.
-// @zen-component: HOST-JsPackage
 import { spawnSync } from "node:child_process";
 import { closeSync, mkdtempSync, openSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
-/** `timeoutSecs` default (DEC-5), as the CLI's. */
+/** `timeoutSecs` default (CLI-11), as the CLI's. */
 export const DEFAULT_TIMEOUT_SECS = 60;
 const TAIL_CHARS = 400;
 /** The last `TAIL_CHARS` characters of `text`, on one line (as the CLI's). */
@@ -22,6 +21,7 @@ function tail(text) {
     return cut ? `…${s}` : s;
 }
 /** A command's failure text, `""` when it passed. */
+// sokf-implements: WASM-3_AC-1
 function runCommand(params, env, sessionCwd, configDir, timeoutSecs) {
     const run = params.run;
     let argv;

package/dist/node/storage.js

@@ -1,8 +1,7 @@
-// Node file storage (HOST-14): a file per record, written
+// Node file storage (WASM-2): a file per record, written
 // atomically (temp file, then rename), and history as JSONL, one line per
 // entry in the CLI's format. One process owns a folder: several processes
 // sharing state should use the CLI, whose store locks.
-// @zen-component: HOST-JsPackage
 import { appendFileSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 const SHELF = {

package/dist/storage.js

@@ -1,6 +1,5 @@
-// In-memory storage (HOST-14): what `nodeFileStorage` does with files,
+// In-memory storage (WASM-2): what `nodeFileStorage` does with files,
 // without them; for tests, examples and hosts that persist elsewhere.
-// @zen-component: HOST-JsPackage
 /** A storage that keeps everything in memory. `history` holds the log by `machine/id`. */
 export function memoryStorage() {
     const state = { sessions: {}, bindings: {}, instances: {} };

package/dist/types.d.ts

@@ -13,7 +13,7 @@ export interface Reply {
     location: Location;
     text: string;
 }
-/** The stop hook's decision (TURN-4..6). */
+/** The stop hook's decision (AGT-8..6). */
 export type StopDecision = {
     decision: "allow";
 }
@@ -79,7 +79,7 @@ export interface Host {
 /** What `put` hands on: a session (key: its key), a binding (`harness/hostSession`, record: the session key) or an instance (`machine/id`). */
 export type RecordKind = "session" | "binding" | "instance";
 /**
- * Where an engine's state lives (HOST-14): `load` once, into `importState`;
+ * Where an engine's state lives (WASM-2): `load` once, into `importState`;
  * then each saved record through `put` and each history entry through
  * `history`, as they happen, so persisting costs what changed.
  */

package/dist/wrap.d.ts

@@ -39,7 +39,7 @@ export declare class Engine {
      * record and history entry (its `put` and `history` go before `host`'s).
      */
     constructor(compiled: string | object, host?: Host, storage?: Storage);
-    /** The agent-facing tool, to hand to an LLM's tool list (HOST-13). */
+    /** The agent-facing tool, to hand to an LLM's tool list (WASM-1). */
     tool(): Tool;
     /** Answer a tool call as the MCP server does; a malformed call is `ok: false`, never a throw. */
     callTool(args?: ToolArgs): Reply;

package/dist/wrap.js

@@ -46,12 +46,13 @@ export class Engine {
             }
             : host;
         this.#raw = new Raw(json, adapt(all));
+        // sokf-implements: WASM-2_AC-2
         const saved = storage?.load();
         if (saved) {
             this.importState(saved);
         }
     }
-    /** The agent-facing tool, to hand to an LLM's tool list (HOST-13). */
+    /** The agent-facing tool, to hand to an LLM's tool list (WASM-1). */
     tool() {
         return parse(this.#raw.tool());
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@six5536/smllm-wasm",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "smllm's engine as WebAssembly: run smllm state machines that drive an LLM agent, in a browser or Node.",
   "homepage": "https://github.com/six5536/smllm#readme",
   "repository": {

package/wasm/bundler/smllm_wasm.d.ts

@@ -13,7 +13,7 @@ export class Engine {
     bind(harness: string, host_session: string | null | undefined, cwd: string): string;
     /**
      * A tool call: the agent's arguments as JSON, answered as the MCP
-     * server answers them (HOST-13). A malformed call or an engine error is
+     * server answers them (WASM-1). A malformed call or an engine error is
      * a reply with `ok: false` and `error: …`, never a throw: the agent
      * sees its mistake as the tool's answer.
      */
@@ -43,11 +43,11 @@ export class Engine {
      */
     promptSubmitted(key: string): void;
     /**
-     * Where the session is, as the `smllm statusline --json` object (STL-8).
+     * Where the session is, as the `smllm statusline --json` object (ENG-3).
      */
     status(key: string): string;
     /**
-     * The stop decision as JSON (TURN-4..6): `{"decision": "allow"}` = may
+     * The stop decision as JSON (AGT-8..6): `{"decision": "allow"}` = may
      * stop; `{"decision": "block", "text"}` = hold the agent with the events
      * list; `{"decision": "runaway", "text"}` = let it stop, showing the
      * list to the user (the harness was already continuing because of a
@@ -56,7 +56,7 @@ export class Engine {
     stop(key: string, stop_hook_active: boolean): string;
     /**
      * The agent-facing tool, as JSON `{name, description, inputSchema}`:
-     * the core's definition, as the MCP server offers it (HOST-13).
+     * the core's definition, as the MCP server offers it (WASM-1).
      */
     tool(): string;
     /**

package/wasm/bundler/smllm_wasm_bg.js

@@ -51,7 +51,7 @@ export class Engine {
     }
     /**
      * A tool call: the agent's arguments as JSON, answered as the MCP
-     * server answers them (HOST-13). A malformed call or an engine error is
+     * server answers them (WASM-1). A malformed call or an engine error is
      * a reply with `ok: false` and `error: …`, never a throw: the agent
      * sees its mistake as the tool's answer.
      * @param {string} args
@@ -226,7 +226,7 @@ export class Engine {
         }
     }
     /**
-     * Where the session is, as the `smllm statusline --json` object (STL-8).
+     * Where the session is, as the `smllm statusline --json` object (ENG-3).
      * @param {string} key
      * @returns {string}
      */
@@ -257,7 +257,7 @@ export class Engine {
         }
     }
     /**
-     * The stop decision as JSON (TURN-4..6): `{"decision": "allow"}` = may
+     * The stop decision as JSON (AGT-8..6): `{"decision": "allow"}` = may
      * stop; `{"decision": "block", "text"}` = hold the agent with the events
      * list; `{"decision": "runaway", "text"}` = let it stop, showing the
      * list to the user (the harness was already continuing because of a
@@ -294,7 +294,7 @@ export class Engine {
     }
     /**
      * The agent-facing tool, as JSON `{name, description, inputSchema}`:
-     * the core's definition, as the MCP server offers it (HOST-13).
+     * the core's definition, as the MCP server offers it (WASM-1).
      * @returns {string}
      */
     tool() {
@@ -370,7 +370,7 @@ export function __wbg_Error_30c8987f7c2ed4e2(arg0, arg1) {
     const ret = Error(getStringFromWasm0(arg0, arg1));
     return addHeapObject(ret);
 }
-export function __wbg_String_50e8e7e5340432bd(arg0, arg1) {
+export function __wbg_String_bbd7b99db50d2c72(arg0, arg1) {
     const ret = String(getObject(arg1));
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
     const len1 = WASM_VECTOR_LEN;
@@ -380,43 +380,43 @@ export function __wbg_String_50e8e7e5340432bd(arg0, arg1) {
 export function __wbg___wbindgen_throw_41e9ee4f547fc59a(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
-export function __wbg_check_50c1a220e37a7313() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) {
+export function __wbg_check_6dfc683de5752eb9() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) {
     const ret = getObject(arg0).check(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4), getStringFromWasm0(arg5, arg6), getStringFromWasm0(arg7, arg8));
     return ret;
 }, arguments); }
-export function __wbg_history_96f90f47fe48bff5() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6) {
+export function __wbg_history_ed6a3249cdbf6fba() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6) {
     getObject(arg0).history(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4), getStringFromWasm0(arg5, arg6));
 }, arguments); }
-export function __wbg_isMatch_6fae7431ba8c03f8() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
+export function __wbg_isMatch_b6fb6fb03924405a() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
     const ret = getObject(arg0).isMatch(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4));
     return ret;
 }, arguments); }
-export function __wbg_now_fc028ce4f381e65e() { return handleError(function (arg0) {
+export function __wbg_now_976fd88331086448() { return handleError(function (arg0) {
     const ret = getObject(arg0).now();
     return ret;
 }, arguments); }
-export function __wbg_put_d358a9a844a38014() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6) {
+export function __wbg_put_9cd5b2a059778929() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6) {
     getObject(arg0).put(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4), getStringFromWasm0(arg5, arg6));
 }, arguments); }
-export function __wbg_random_00b1f6c7178bf1c0() { return handleError(function (arg0) {
+export function __wbg_random_5e704a8263f19bfe() { return handleError(function (arg0) {
     const ret = getObject(arg0).random();
     return ret;
 }, arguments); }
-export function __wbg_read_1bd3096dfdac8efb() { return handleError(function (arg0, arg1, arg2, arg3) {
+export function __wbg_read_3a7eb14b88f4a798() { return handleError(function (arg0, arg1, arg2, arg3) {
     const ret = getObject(arg1).read(getStringFromWasm0(arg2, arg3));
     var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
     var len1 = WASM_VECTOR_LEN;
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }, arguments); }
-export function __wbg_run_a559624047f1d933() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) {
+export function __wbg_run_9856da75a23eb26d() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) {
     const ret = getObject(arg1).run(getStringFromWasm0(arg2, arg3), getStringFromWasm0(arg4, arg5), getStringFromWasm0(arg6, arg7), getStringFromWasm0(arg8, arg9));
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
     const len1 = WASM_VECTOR_LEN;
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }, arguments); }
-export function __wbg_supports_e8118f6f4e42b431() { return handleError(function (arg0, arg1, arg2) {
+export function __wbg_supports_ecfa18db153d083b() { return handleError(function (arg0, arg1, arg2) {
     const ret = getObject(arg0).supports(getStringFromWasm0(arg1, arg2));
     return ret;
 }, arguments); }

package/wasm/web/smllm_wasm.d.ts

@@ -13,7 +13,7 @@ export class Engine {
     bind(harness: string, host_session: string | null | undefined, cwd: string): string;
     /**
      * A tool call: the agent's arguments as JSON, answered as the MCP
-     * server answers them (HOST-13). A malformed call or an engine error is
+     * server answers them (WASM-1). A malformed call or an engine error is
      * a reply with `ok: false` and `error: …`, never a throw: the agent
      * sees its mistake as the tool's answer.
      */
@@ -43,11 +43,11 @@ export class Engine {
      */
     promptSubmitted(key: string): void;
     /**
-     * Where the session is, as the `smllm statusline --json` object (STL-8).
+     * Where the session is, as the `smllm statusline --json` object (ENG-3).
      */
     status(key: string): string;
     /**
-     * The stop decision as JSON (TURN-4..6): `{"decision": "allow"}` = may
+     * The stop decision as JSON (AGT-8..6): `{"decision": "allow"}` = may
      * stop; `{"decision": "block", "text"}` = hold the agent with the events
      * list; `{"decision": "runaway", "text"}` = let it stop, showing the
      * list to the user (the harness was already continuing because of a
@@ -56,7 +56,7 @@ export class Engine {
     stop(key: string, stop_hook_active: boolean): string;
     /**
      * The agent-facing tool, as JSON `{name, description, inputSchema}`:
-     * the core's definition, as the MCP server offers it (HOST-13).
+     * the core's definition, as the MCP server offers it (WASM-1).
      */
     tool(): string;
     /**

package/wasm/web/smllm_wasm.js

@@ -53,7 +53,7 @@ export class Engine {
     }
     /**
      * A tool call: the agent's arguments as JSON, answered as the MCP
-     * server answers them (HOST-13). A malformed call or an engine error is
+     * server answers them (WASM-1). A malformed call or an engine error is
      * a reply with `ok: false` and `error: …`, never a throw: the agent
      * sees its mistake as the tool's answer.
      * @param {string} args
@@ -228,7 +228,7 @@ export class Engine {
         }
     }
     /**
-     * Where the session is, as the `smllm statusline --json` object (STL-8).
+     * Where the session is, as the `smllm statusline --json` object (ENG-3).
      * @param {string} key
      * @returns {string}
      */
@@ -259,7 +259,7 @@ export class Engine {
         }
     }
     /**
-     * The stop decision as JSON (TURN-4..6): `{"decision": "allow"}` = may
+     * The stop decision as JSON (AGT-8..6): `{"decision": "allow"}` = may
      * stop; `{"decision": "block", "text"}` = hold the agent with the events
      * list; `{"decision": "runaway", "text"}` = let it stop, showing the
      * list to the user (the harness was already continuing because of a
@@ -296,7 +296,7 @@ export class Engine {
     }
     /**
      * The agent-facing tool, as JSON `{name, description, inputSchema}`:
-     * the core's definition, as the MCP server offers it (HOST-13).
+     * the core's definition, as the MCP server offers it (WASM-1).
      * @returns {string}
      */
     tool() {
@@ -375,7 +375,7 @@ function __wbg_get_imports() {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
-        __wbg_String_50e8e7e5340432bd: function(arg0, arg1) {
+        __wbg_String_bbd7b99db50d2c72: function(arg0, arg1) {
             const ret = String(getObject(arg1));
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len1 = WASM_VECTOR_LEN;
@@ -385,43 +385,43 @@ function __wbg_get_imports() {
         __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_check_50c1a220e37a7313: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) {
+        __wbg_check_6dfc683de5752eb9: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) {
             const ret = getObject(arg0).check(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4), getStringFromWasm0(arg5, arg6), getStringFromWasm0(arg7, arg8));
             return ret;
         }, arguments); },
-        __wbg_history_96f90f47fe48bff5: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6) {
+        __wbg_history_ed6a3249cdbf6fba: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6) {
             getObject(arg0).history(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4), getStringFromWasm0(arg5, arg6));
         }, arguments); },
-        __wbg_isMatch_6fae7431ba8c03f8: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
+        __wbg_isMatch_b6fb6fb03924405a: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4) {
             const ret = getObject(arg0).isMatch(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4));
             return ret;
         }, arguments); },
-        __wbg_now_fc028ce4f381e65e: function() { return handleError(function (arg0) {
+        __wbg_now_976fd88331086448: function() { return handleError(function (arg0) {
             const ret = getObject(arg0).now();
             return ret;
         }, arguments); },
-        __wbg_put_d358a9a844a38014: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6) {
+        __wbg_put_9cd5b2a059778929: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6) {
             getObject(arg0).put(getStringFromWasm0(arg1, arg2), getStringFromWasm0(arg3, arg4), getStringFromWasm0(arg5, arg6));
         }, arguments); },
-        __wbg_random_00b1f6c7178bf1c0: function() { return handleError(function (arg0) {
+        __wbg_random_5e704a8263f19bfe: function() { return handleError(function (arg0) {
             const ret = getObject(arg0).random();
             return ret;
         }, arguments); },
-        __wbg_read_1bd3096dfdac8efb: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+        __wbg_read_3a7eb14b88f4a798: function() { return handleError(function (arg0, arg1, arg2, arg3) {
             const ret = getObject(arg1).read(getStringFromWasm0(arg2, arg3));
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             var len1 = WASM_VECTOR_LEN;
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         }, arguments); },
-        __wbg_run_a559624047f1d933: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) {
+        __wbg_run_9856da75a23eb26d: function() { return handleError(function (arg0, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9) {
             const ret = getObject(arg1).run(getStringFromWasm0(arg2, arg3), getStringFromWasm0(arg4, arg5), getStringFromWasm0(arg6, arg7), getStringFromWasm0(arg8, arg9));
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len1 = WASM_VECTOR_LEN;
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         }, arguments); },
-        __wbg_supports_e8118f6f4e42b431: function() { return handleError(function (arg0, arg1, arg2) {
+        __wbg_supports_ecfa18db153d083b: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = getObject(arg0).supports(getStringFromWasm0(arg1, arg2));
             return ret;
         }, arguments); },