opensquid 0.5.395

package/dist/functions/state.js

@@ -0,0 +1,165 @@
+/**
+ * State I/O primitives: `read_state`, `write_state`, `append_log`.
+ *
+ * Per `docs/opensquid-real-design.md` §"Phase 1 — Runtime skeleton" (state
+ * surface). These three primitives are the only filesystem-touching
+ * primitives in the Phase 1 runtime — skills compose them into rule
+ * processes via YAML.
+ *
+ * Atomicity contract:
+ *   - `write_state` uses tmp-file + rename (atomic on POSIX, near-atomic on
+ *     Windows — rename over an open target fails there; documented risk).
+ *   - `append_log` serializes concurrent writers via `proper-lockfile`
+ *     (5 s stale timeout — minimum allowed by the lib). The file is
+ *     touched before locking because `proper-lockfile` requires the
+ *     target to exist.
+ *
+ * Error model: ENOENT on read returns `ok(null)` (canonical "no state"
+ * signal — the original anti-drift `read_state` pattern).
+ * Every other failure travels as `err({ kind: 'runtime', ... })`. Throws
+ * never escape an `execute` — the evaluator's stray-throw wrapper is for
+ * bugs, not for normal failure modes.
+ *
+ * Imports from: zod, node:fs/promises, node:path, proper-lockfile,
+ *   ../runtime/paths.js, ./registry.js, ../runtime/result.js.
+ * Imported by: src/functions/index.ts (registry wiring).
+ */
+import { appendFile, mkdir, open, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import lockfile from 'proper-lockfile';
+import { z } from 'zod';
+import { packStateFile, sessionLogFile, sessionStateFile } from '../runtime/paths.js';
+import { err, ok } from '../runtime/result.js';
+// ---------------------------------------------------------------------------
+// Zod arg schemas — `min(1)` on key/name to block empty-string foot-guns.
+// `z.unknown()` on value/entry: state primitives are JSON-shape-agnostic by
+// design; per-skill refinement happens at the YAML layer if needed.
+//
+// Optional `pack` (Task 5.3) — when present, state is namespaced under
+// `~/.opensquid/packs/<id>/state/<key>.json`; when absent, falls back to
+// session-scoped state under `~/.opensquid/sessions/<session-id>/state/`.
+// Pack-id sanitization happens inside `packStateFile` (no `.` / `/` etc.).
+// ---------------------------------------------------------------------------
+const ReadStateArgs = z.object({ key: z.string().min(1), pack: z.string().min(1).optional() });
+const WriteStateArgs = z.object({
+    key: z.string().min(1),
+    value: z.unknown(),
+    pack: z.string().min(1).optional(),
+});
+const AppendLogArgs = z.object({ name: z.string().min(1), entry: z.unknown() });
+// ---------------------------------------------------------------------------
+// atomicWriteJson — tmp-file + rename idiom.
+//
+// `${pid}.${ts}` suffix on the tmp file makes concurrent writers from
+// different processes collision-proof. POSIX `rename(2)` is atomic; on
+// Windows the rename fails if the target is open by another process —
+// callers running on Windows should treat `write_state` as best-effort.
+// ---------------------------------------------------------------------------
+async function atomicWriteJson(path, value) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    await writeFile(tmp, JSON.stringify(value, null, 2), 'utf8');
+    await rename(tmp, path);
+}
+// ---------------------------------------------------------------------------
+// touchFile — ensure target exists so `proper-lockfile` can lock it.
+//
+// `proper-lockfile.lock()` rejects with ENOENT if the file is absent. We
+// create the file empty (`'a'` flag = append, creates if missing, never
+// truncates) and close the descriptor before locking, so the lock has a
+// stable inode to attach `.lock` next to.
+// ---------------------------------------------------------------------------
+async function touchFile(path) {
+    const fh = await open(path, 'a');
+    await fh.close();
+}
+export function registerStateFunctions(registry) {
+    // DURABLE.2 — local filesystem reads/writes against `~/.opensquid/`. Each
+    // call is a few-ms `readFile` / atomic `rename`; checkpoint overhead would
+    // exceed the cost of re-running the call on resume. None are memoizable
+    // because state changes between calls — a memoized `read_state` would
+    // return stale data if another step writes the same key.
+    registry.register({
+        name: 'read_state',
+        argSchema: ReadStateArgs,
+        durable: false,
+        memoizable: false,
+        costEstimateMs: 1,
+        execute: async ({ key, pack }, ctx) => {
+            // Optional `pack` arg routes to `~/.opensquid/packs/<id>/state/...`;
+            // omitted = session-scoped fallback (unchanged Phase 1 semantics).
+            const path = pack ? packStateFile(pack, key) : sessionStateFile(ctx.sessionId, key);
+            try {
+                const raw = await readFile(path, 'utf8');
+                return ok(JSON.parse(raw));
+            }
+            catch (e) {
+                if (e.code === 'ENOENT')
+                    return ok(null);
+                return err({
+                    kind: 'runtime',
+                    message: `read_state(${key}): ${String(e)}`,
+                    cause: e,
+                });
+            }
+        },
+    });
+    registry.register({
+        name: 'write_state',
+        argSchema: WriteStateArgs,
+        durable: false,
+        memoizable: false,
+        costEstimateMs: 2,
+        execute: async ({ key, value, pack }, ctx) => {
+            const path = pack ? packStateFile(pack, key) : sessionStateFile(ctx.sessionId, key);
+            try {
+                await atomicWriteJson(path, value);
+                return ok(undefined);
+            }
+            catch (e) {
+                return err({
+                    kind: 'runtime',
+                    message: `write_state(${key}): ${String(e)}`,
+                    cause: e,
+                });
+            }
+        },
+    });
+    registry.register({
+        name: 'append_log',
+        argSchema: AppendLogArgs,
+        durable: false,
+        memoizable: false,
+        costEstimateMs: 5,
+        execute: async ({ name, entry }, ctx) => {
+            const path = sessionLogFile(ctx.sessionId, name);
+            try {
+                await mkdir(dirname(path), { recursive: true });
+                await touchFile(path);
+                // 5000ms is the minimum stale-lock timeout accepted by
+                // proper-lockfile. Retries with exponential backoff so 10
+                // concurrent writers serialize cleanly without timing out.
+                const release = await lockfile.lock(path, {
+                    retries: { retries: 10, factor: 2, minTimeout: 20, maxTimeout: 200 },
+                    stale: 5000,
+                    realpath: false,
+                });
+                try {
+                    await appendFile(path, `${JSON.stringify(entry)}\n`, 'utf8');
+                    return ok(undefined);
+                }
+                finally {
+                    await release();
+                }
+            }
+            catch (e) {
+                return err({
+                    kind: 'runtime',
+                    message: `append_log(${name}): ${String(e)}`,
+                    cause: e,
+                });
+            }
+        },
+    });
+}
+//# sourceMappingURL=state.js.map

package/dist/functions/state.js.map

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

package/dist/functions/subagent.d.ts

@@ -0,0 +1,107 @@
+/**
+ * `spawn_subagent` primitive — Mode A team orchestration entry point.
+ *
+ * Per `docs/opensquid-real-design.md` §"Team modes" Mode A + memory
+ * `project_opensquid_team_modes` (Mode A = one agent + Agent-tool subagents
+ * for profession-instantiation; Mode B = multi-tenant, future).
+ *
+ * Surface (per Task 6.2 key code shape):
+ *
+ *   spawn_subagent({ model, prompt, context }) → ok({ stdout, drifts[] })
+ *
+ *   - `model`        : model alias (USER-supplied label, NOT a vendor model
+ *                      id; resolved against the active `models.yaml` by the
+ *                      caller before reaching this primitive). The primitive
+ *                      itself stays model-neutral — no vendor names in this
+ *                      file.
+ *   - `prompt`       : the subagent's initial prompt.
+ *   - `context`      : optional `{ project?, profession? }`. Used by the
+ *                      context-inheritance filter (Task 6.3) AND wired into
+ *                      drift roll-up provenance (Task 6.4). Anything beyond
+ *                      these two fields is intentionally rejected by the
+ *                      Zod schema — leakage of parent session secrets MUST
+ *                      NOT travel via arbitrary `context` bag.
+ *
+ * SDK call mode (per Task 6.2 acceptance criteria):
+ *
+ *   In-process Claude Agent SDK is the required mode (it's the only path
+ *   that can observe the parent session — see memory
+ *   `project_opensquid_model_neutral_subagent_primitive`).
+ *
+ *   The SDK (`@anthropic-ai/claude-agent-sdk`) is loaded LAZILY via
+ *   `await import(...)` so a missing dep doesn't crash startup — the setup
+ *   UI verifies presence later. If a pack actually invokes `spawn_subagent`
+ *   without the SDK installed, the dynamic import throws and we surface
+ *   `err({ kind: 'runtime' })` with the import error as cause.
+ *
+ *   The SDK package is declared as an OPTIONAL peer dep in package.json so
+ *   `pnpm install` won't fail when it isn't present in the user's env.
+ *
+ * Test seam (`opts.sdk`):
+ *
+ *   Tests inject a stub SDK via `registerSubagentFunction(registry, { sdk })`
+ *   to avoid requiring the real package + to assert the primitive's contract
+ *   (input shape, return shape, error mapping). The default — no `opts.sdk`
+ *   — falls back to the lazy dynamic import path used in production.
+ *
+ *   The seam is intentionally NOT a runtime override path that pack YAML can
+ *   reach: the only way to plug a stub is via the registration helper, which
+ *   pack-loading code does not call with `opts.sdk`. The seam exists for
+ *   tests only.
+ *
+ * Model neutrality (per `feedback_stop_haiku_drift` + memory
+ * `project_opensquid_model_neutral_subagent_primitive`): NO vendor model
+ * name appears in this file. A grep for `claude` / `haiku` / `opus` /
+ * `sonnet` / `gpt` should return zero hits. Treat any future addition as a
+ * regression — the model alias is the only abstraction.
+ *
+ * Drift roll-up (Task 6.4):
+ *
+ *   When the subagent returns `drifts`, this primitive ALSO writes them to
+ *   the parent's session-level drift catalog via `recordSubagentDrifts`
+ *   (drift_catalog.ts). The subagent's own pack catalog is written by the
+ *   SDK-side evaluator during its run; we do not double-write that path
+ *   here. See `recordSubagentDrifts` for the provenance enrichment policy.
+ *
+ *   The subagent id is generated per-call (`subagent-<random>`) so two
+ *   simultaneous spawns under the same profession pack remain distinguishable
+ *   in the catalog. The `professionPack` comes from `context.profession`,
+ *   falling back to a sentinel when the caller omits it.
+ *
+ *   The parent session id comes from `EvalCtx.sessionId` — the primitive
+ *   runs inside the parent's evaluation context, so by construction the
+ *   write target is the parent's catalog, never the subagent's own session.
+ *
+ * Imports from: zod, ../runtime/result.js, ../runtime/drift_catalog.js,
+ *               ./registry.js.
+ * Imported by: src/functions/index.ts, src/runtime/bootstrap.ts.
+ */
+import type { FunctionRegistry } from './registry.js';
+export interface SubagentDrift {
+    timestamp?: string;
+    pack?: string;
+    ruleId?: string;
+    level?: string;
+    message?: string;
+}
+export interface SubagentSdkRunResult {
+    text: string;
+    drifts?: SubagentDrift[];
+}
+export interface SubagentSdk {
+    runAgent: (opts: {
+        model: string;
+        prompt: string;
+        context: Record<string, unknown>;
+    }) => Promise<SubagentSdkRunResult>;
+}
+export interface SpawnSubagentResult {
+    stdout: string;
+    drifts: SubagentDrift[];
+}
+export interface RegisterSubagentOptions {
+    sdk?: SubagentSdk;
+    subagentIdFactory?: () => string;
+}
+export declare function registerSubagentFunction(registry: FunctionRegistry, opts?: RegisterSubagentOptions): void;
+//# sourceMappingURL=subagent.d.ts.map

package/dist/functions/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/functions/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAWtD,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC;AA+BD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AA2CD,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;CAClC;AAUD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,GAAE,uBAA4B,GACjC,IAAI,CAiEN"}

package/dist/functions/subagent.js

@@ -0,0 +1,202 @@
+/**
+ * `spawn_subagent` primitive — Mode A team orchestration entry point.
+ *
+ * Per `docs/opensquid-real-design.md` §"Team modes" Mode A + memory
+ * `project_opensquid_team_modes` (Mode A = one agent + Agent-tool subagents
+ * for profession-instantiation; Mode B = multi-tenant, future).
+ *
+ * Surface (per Task 6.2 key code shape):
+ *
+ *   spawn_subagent({ model, prompt, context }) → ok({ stdout, drifts[] })
+ *
+ *   - `model`        : model alias (USER-supplied label, NOT a vendor model
+ *                      id; resolved against the active `models.yaml` by the
+ *                      caller before reaching this primitive). The primitive
+ *                      itself stays model-neutral — no vendor names in this
+ *                      file.
+ *   - `prompt`       : the subagent's initial prompt.
+ *   - `context`      : optional `{ project?, profession? }`. Used by the
+ *                      context-inheritance filter (Task 6.3) AND wired into
+ *                      drift roll-up provenance (Task 6.4). Anything beyond
+ *                      these two fields is intentionally rejected by the
+ *                      Zod schema — leakage of parent session secrets MUST
+ *                      NOT travel via arbitrary `context` bag.
+ *
+ * SDK call mode (per Task 6.2 acceptance criteria):
+ *
+ *   In-process Claude Agent SDK is the required mode (it's the only path
+ *   that can observe the parent session — see memory
+ *   `project_opensquid_model_neutral_subagent_primitive`).
+ *
+ *   The SDK (`@anthropic-ai/claude-agent-sdk`) is loaded LAZILY via
+ *   `await import(...)` so a missing dep doesn't crash startup — the setup
+ *   UI verifies presence later. If a pack actually invokes `spawn_subagent`
+ *   without the SDK installed, the dynamic import throws and we surface
+ *   `err({ kind: 'runtime' })` with the import error as cause.
+ *
+ *   The SDK package is declared as an OPTIONAL peer dep in package.json so
+ *   `pnpm install` won't fail when it isn't present in the user's env.
+ *
+ * Test seam (`opts.sdk`):
+ *
+ *   Tests inject a stub SDK via `registerSubagentFunction(registry, { sdk })`
+ *   to avoid requiring the real package + to assert the primitive's contract
+ *   (input shape, return shape, error mapping). The default — no `opts.sdk`
+ *   — falls back to the lazy dynamic import path used in production.
+ *
+ *   The seam is intentionally NOT a runtime override path that pack YAML can
+ *   reach: the only way to plug a stub is via the registration helper, which
+ *   pack-loading code does not call with `opts.sdk`. The seam exists for
+ *   tests only.
+ *
+ * Model neutrality (per `feedback_stop_haiku_drift` + memory
+ * `project_opensquid_model_neutral_subagent_primitive`): NO vendor model
+ * name appears in this file. A grep for `claude` / `haiku` / `opus` /
+ * `sonnet` / `gpt` should return zero hits. Treat any future addition as a
+ * regression — the model alias is the only abstraction.
+ *
+ * Drift roll-up (Task 6.4):
+ *
+ *   When the subagent returns `drifts`, this primitive ALSO writes them to
+ *   the parent's session-level drift catalog via `recordSubagentDrifts`
+ *   (drift_catalog.ts). The subagent's own pack catalog is written by the
+ *   SDK-side evaluator during its run; we do not double-write that path
+ *   here. See `recordSubagentDrifts` for the provenance enrichment policy.
+ *
+ *   The subagent id is generated per-call (`subagent-<random>`) so two
+ *   simultaneous spawns under the same profession pack remain distinguishable
+ *   in the catalog. The `professionPack` comes from `context.profession`,
+ *   falling back to a sentinel when the caller omits it.
+ *
+ *   The parent session id comes from `EvalCtx.sessionId` — the primitive
+ *   runs inside the parent's evaluation context, so by construction the
+ *   write target is the parent's catalog, never the subagent's own session.
+ *
+ * Imports from: zod, ../runtime/result.js, ../runtime/drift_catalog.js,
+ *               ./registry.js.
+ * Imported by: src/functions/index.ts, src/runtime/bootstrap.ts.
+ */
+import { z } from 'zod';
+import { recordSubagentDrifts } from '../runtime/drift_catalog.js';
+import { err, ok } from '../runtime/result.js';
+// ---------------------------------------------------------------------------
+// SpawnSubagentArgs — Zod schema for primitive args.
+//
+// `context` is OPTIONAL + STRICT: only `project` + `profession` are allowed
+// fields, matching the context-inheritance contract (Task 6.3). A pack that
+// tries to pass other context fields gets `arg_invalid` so leakage paths
+// can't be opened by accident from YAML.
+// ---------------------------------------------------------------------------
+const SpawnSubagentArgs = z.object({
+    model: z.string().min(1),
+    prompt: z.string().min(1),
+    context: z
+        .object({
+        project: z.string().optional(),
+        profession: z.string().optional(),
+    })
+        .strict()
+        .optional(),
+});
+// ---------------------------------------------------------------------------
+// loadSdk — lazy dynamic import path for production.
+//
+// The real package may not be present (optional peer dep), in which case
+// the import throws. The caller wraps the throw into the standard
+// `err({ kind: 'runtime' })` shape so the evaluator handles it like any
+// other primitive failure.
+// ---------------------------------------------------------------------------
+async function loadSdk() {
+    // Variable-string import dodges TS module-resolution at compile time —
+    // the SDK is an OPTIONAL peer dep, so it may not be present on disk in
+    // dev (or in users' installs that don't opt into subagent spawning).
+    // The string is identical at runtime; TS just doesn't try to resolve
+    // the module specifier statically.
+    const moduleName = '@anthropic-ai/claude-agent-sdk';
+    const mod = (await import(/* @vite-ignore */ moduleName));
+    return mod;
+}
+// ---------------------------------------------------------------------------
+// generateSubagentId — opaque per-spawn id used in drift provenance.
+//
+// Not crypto-strong: this is a debugging / audit-trail key, not a security
+// token. `Math.random().toString(36).slice(2, 10)` matches the same pattern
+// used elsewhere (drift_catalog.test.ts seeds temp dirs the same way).
+// ---------------------------------------------------------------------------
+function generateSubagentId() {
+    return `subagent-${Math.random().toString(36).slice(2, 10)}`;
+}
+// ---------------------------------------------------------------------------
+// registerSubagentFunction — register `spawn_subagent` on a registry.
+//
+// `opts.sdk` overrides the lazy-import path (test-only — production never
+// passes it). The function captures the option at registration time, so a
+// later `opts.sdk` change has no effect on already-registered primitives.
+// ---------------------------------------------------------------------------
+export function registerSubagentFunction(registry, opts = {}) {
+    // DURABLE.2 — spawning a full subagent SDK run is the single most expensive
+    // primitive in the library (multi-second response + token cost + drift
+    // roll-up write). Always checkpoint so a resume restores `stdout` + `drifts`
+    // from the prior run instead of re-spawning. NOT memoizable: subagent runs
+    // are non-deterministic (temperature, context-dependent reasoning) and the
+    // drift roll-up has a side effect on the parent's catalog — caching would
+    // also skip the catalog write.
+    registry.register({
+        name: 'spawn_subagent',
+        argSchema: SpawnSubagentArgs,
+        durable: true,
+        memoizable: false,
+        costEstimateMs: 30_000,
+        execute: async ({ model, prompt, context }, ctx) => {
+            let sdk;
+            try {
+                sdk = opts.sdk ?? (await loadSdk());
+            }
+            catch (e) {
+                return err({
+                    kind: 'runtime',
+                    message: `spawn_subagent: failed to load SDK: ${String(e)}`,
+                    cause: e,
+                });
+            }
+            let result;
+            try {
+                result = await sdk.runAgent({
+                    model,
+                    prompt,
+                    context: context ?? {},
+                });
+            }
+            catch (e) {
+                return err({
+                    kind: 'runtime',
+                    message: `spawn_subagent: SDK run failed: ${String(e)}`,
+                    cause: e,
+                });
+            }
+            // Task 6.4 — drift roll-up to the parent's session-level catalog.
+            // `ctx.sessionId` is the PARENT's session (the primitive runs inside
+            // the parent's evaluation), so the write target is the parent catalog
+            // by construction. The subagent's own pack catalog is written by the
+            // SDK-side evaluator during its run — we do NOT double-write here.
+            const drifts = result.drifts ?? [];
+            const subagentId = (opts.subagentIdFactory ?? generateSubagentId)();
+            const professionPack = context?.profession ?? '<unspecified>';
+            try {
+                await recordSubagentDrifts(ctx.sessionId, subagentId, professionPack, drifts);
+            }
+            catch (e) {
+                return err({
+                    kind: 'runtime',
+                    message: `spawn_subagent: drift roll-up failed: ${String(e)}`,
+                    cause: e,
+                });
+            }
+            return ok({
+                stdout: result.text,
+                drifts,
+            });
+        },
+    });
+}
+//# sourceMappingURL=subagent.js.map

package/dist/functions/subagent.js.map

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

package/dist/functions/text_pattern_match.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `text_pattern_match` primitive — generic regex check on event text fields.
+ *
+ * Used by G.5's `verify-before-citing-memory` skill to scan a Stop event's
+ * `assistantText` for drift-prone phrases ("per memory", "the plan is",
+ * "deferred", etc.). Generic by design — the pattern list and the field
+ * path are both pack-authored, so the same primitive serves any future
+ * "watch event text for these phrases" skill.
+ *
+ * Field extraction: `text_field` supports dot notation
+ * (`assistantText`, `payload.body.text`) via a null-safe traversal — a
+ * missing segment yields `undefined` rather than throwing. The primitive
+ * gracefully degrades to `{ matched: [], phrases: [] }` when the path
+ * does not resolve to a string.
+ *
+ * Per-pattern execution-time cap (per G.5 spec Phase-2 lock #5): each
+ * pattern's `exec` loop is bounded by 10ms wall-clock. If the loop
+ * exceeds the budget we log a stderr warning and skip the remaining
+ * matches for THAT pattern (other patterns continue). Word-boundary
+ * patterns shouldn't hit the cap in practice; the guard is defensive
+ * against future authors who might add a catastrophic-backtracking
+ * regex by accident.
+ *
+ * Error model: returns `arg_invalid` if a regex literal is malformed.
+ * Never throws — this is a runtime primitive inside a hook bin.
+ *
+ * Imports from: zod, ../runtime/result.js, ./registry.js.
+ * Imported by: src/runtime/bootstrap.ts (registry wiring).
+ */
+import { z } from 'zod';
+import type { FunctionDef } from './registry.js';
+export declare const TextPatternMatchArgs: z.ZodObject<{
+    text_field: z.ZodString;
+    patterns: z.ZodArray<z.ZodString, "many">;
+    case_sensitive: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    text_field: string;
+    patterns: string[];
+    case_sensitive: boolean;
+}, {
+    text_field: string;
+    patterns: string[];
+    case_sensitive?: boolean | undefined;
+}>;
+interface TextPatternMatchResult {
+    matched: string[];
+    phrases: {
+        phrase: string;
+        offset: number;
+    }[];
+}
+export declare const TextPatternMatch: FunctionDef<z.input<typeof TextPatternMatchArgs>, TextPatternMatchResult>;
+export {};
+//# sourceMappingURL=text_pattern_match.d.ts.map

package/dist/functions/text_pattern_match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_pattern_match.d.ts","sourceRoot":"","sources":["../../src/functions/text_pattern_match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAKjD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAMtB,CAAC;AAEZ,UAAU,sBAAsB;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AASD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CACxC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EACpC,sBAAsB,CA0CvB,CAAC"}

package/dist/functions/text_pattern_match.js

@@ -0,0 +1,89 @@
+/**
+ * `text_pattern_match` primitive — generic regex check on event text fields.
+ *
+ * Used by G.5's `verify-before-citing-memory` skill to scan a Stop event's
+ * `assistantText` for drift-prone phrases ("per memory", "the plan is",
+ * "deferred", etc.). Generic by design — the pattern list and the field
+ * path are both pack-authored, so the same primitive serves any future
+ * "watch event text for these phrases" skill.
+ *
+ * Field extraction: `text_field` supports dot notation
+ * (`assistantText`, `payload.body.text`) via a null-safe traversal — a
+ * missing segment yields `undefined` rather than throwing. The primitive
+ * gracefully degrades to `{ matched: [], phrases: [] }` when the path
+ * does not resolve to a string.
+ *
+ * Per-pattern execution-time cap (per G.5 spec Phase-2 lock #5): each
+ * pattern's `exec` loop is bounded by 10ms wall-clock. If the loop
+ * exceeds the budget we log a stderr warning and skip the remaining
+ * matches for THAT pattern (other patterns continue). Word-boundary
+ * patterns shouldn't hit the cap in practice; the guard is defensive
+ * against future authors who might add a catastrophic-backtracking
+ * regex by accident.
+ *
+ * Error model: returns `arg_invalid` if a regex literal is malformed.
+ * Never throws — this is a runtime primitive inside a hook bin.
+ *
+ * Imports from: zod, ../runtime/result.js, ./registry.js.
+ * Imported by: src/runtime/bootstrap.ts (registry wiring).
+ */
+import { z } from 'zod';
+import { err, ok } from '../runtime/result.js';
+/** Maximum wall-clock budget per regex pattern. See header. */
+const PER_PATTERN_BUDGET_MS = 10;
+export const TextPatternMatchArgs = z
+    .object({
+    text_field: z.string().min(1),
+    patterns: z.array(z.string()).min(1),
+    case_sensitive: z.boolean().default(false),
+})
+    .strict();
+function extractField(event, path) {
+    return path.split('.').reduce((cur, key) => {
+        if (cur === null || cur === undefined || typeof cur !== 'object')
+            return undefined;
+        return cur[key];
+    }, event);
+}
+export const TextPatternMatch = {
+    name: 'text_pattern_match',
+    argSchema: TextPatternMatchArgs,
+    durable: false,
+    memoizable: true,
+    costEstimateMs: 1,
+    execute: (args, ctx) => {
+        const caseSensitive = args.case_sensitive ?? false;
+        const text = extractField(ctx.event, args.text_field);
+        if (typeof text !== 'string')
+            return Promise.resolve(ok({ matched: [], phrases: [] }));
+        const flags = caseSensitive ? 'g' : 'gi';
+        const phrases = [];
+        for (const pat of args.patterns) {
+            let re;
+            try {
+                re = new RegExp(pat, flags);
+            }
+            catch (e) {
+                return Promise.resolve(err({
+                    kind: 'arg_invalid',
+                    message: `bad regex "${pat}": ${e.message}`,
+                    cause: e,
+                }));
+            }
+            const start = Date.now();
+            let m;
+            while ((m = re.exec(text)) !== null) {
+                if (Date.now() - start > PER_PATTERN_BUDGET_MS) {
+                    process.stderr.write(`[opensquid:text_pattern_match] WARN: pattern "${pat}" exceeded ${String(PER_PATTERN_BUDGET_MS)}ms budget; skipping remaining matches\n`);
+                    break;
+                }
+                phrases.push({ phrase: m[0], offset: m.index });
+                // Guard against zero-width matches that would otherwise infinite-loop.
+                if (m.index === re.lastIndex)
+                    re.lastIndex += 1;
+            }
+        }
+        return Promise.resolve(ok({ matched: phrases.map((p) => p.phrase), phrases }));
+    },
+};
+//# sourceMappingURL=text_pattern_match.js.map

package/dist/functions/text_pattern_match.js.map

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