opensquid 0.5.395

package/dist/functions/fsm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsm.js","sourceRoot":"","sources":["../../src/functions/fsm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAI1C,4EAA4E;AAC5E,0DAA0D;AAC1D,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACnF,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEvE,MAAM,UAAU,oBAAoB,CAAC,QAA0B;IAC7D,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,CAAC;QACjB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;YAC/B,8EAA8E;YAC9E,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9E,mEAAmE;YACnE,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,EAAE,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACxE,CAAC;KACF,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,cAAc;QACzB,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,CAAC;QACjB,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;YAChC,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,GAAG,CAAC,SAAS,EACb,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,OAAO,EACX,KAAK,EACL,GAAG,EACH,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAC5C,CAAC;YACF,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/functions/handoff_session_start.d.ts

@@ -0,0 +1,26 @@
+/**
+ * T-AUTO-HANDOFF — the SessionStart reader + tier-3 LAZY GENERATOR.
+ *
+ * At SessionStart the FU.3 project-scoped pointer still names the DEAD
+ * session (it is advanced ONLY by the UserPromptSubmit hook —
+ * user-prompt-submit.ts is the sole `recordCurrentSession` caller), so this
+ * function can recover even a kill-9'd session: if the dead session's
+ * handover doc is absent or older than its FSM state file, GENERATE it from
+ * disk first, then inject the pointer. One injection per fresh session
+ * (stamped). Fail-quiet: any error → null (never blocks session start).
+ *
+ * Imports from: zod, ../runtime/handoff/index.js, ../runtime/hooks/session_id.js,
+ *   ../runtime/paths.js, ../runtime/result.js.
+ * Imported by: src/runtime/bootstrap.ts (registry wiring); called by the
+ *   default-discipline session-connection-check rule.
+ */
+import { z } from 'zod';
+import type { FunctionDef } from './registry.js';
+declare const NoArgs: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+interface InjectResult {
+    kind: 'inject_context';
+    content: string;
+}
+export declare const HandoffSessionStart: FunctionDef<z.input<typeof NoArgs>, InjectResult | null>;
+export {};
+//# sourceMappingURL=handoff_session_start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handoff_session_start.d.ts","sourceRoot":"","sources":["../../src/functions/handoff_session_start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,QAAA,MAAM,MAAM,iDAAwB,CAAC;AAErC,UAAU,YAAY;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CA4CxF,CAAC"}

package/dist/functions/handoff_session_start.js

@@ -0,0 +1,81 @@
+/**
+ * T-AUTO-HANDOFF — the SessionStart reader + tier-3 LAZY GENERATOR.
+ *
+ * At SessionStart the FU.3 project-scoped pointer still names the DEAD
+ * session (it is advanced ONLY by the UserPromptSubmit hook —
+ * user-prompt-submit.ts is the sole `recordCurrentSession` caller), so this
+ * function can recover even a kill-9'd session: if the dead session's
+ * handover doc is absent or older than its FSM state file, GENERATE it from
+ * disk first, then inject the pointer. One injection per fresh session
+ * (stamped). Fail-quiet: any error → null (never blocks session start).
+ *
+ * Imports from: zod, ../runtime/handoff/index.js, ../runtime/hooks/session_id.js,
+ *   ../runtime/paths.js, ../runtime/result.js.
+ * Imported by: src/runtime/bootstrap.ts (registry wiring); called by the
+ *   default-discipline session-connection-check rule.
+ */
+import { stat, writeFile } from 'node:fs/promises';
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { z } from 'zod';
+import { handoverDocPath, renderInjection, runHandoff, umbrellaRootFor, } from '../runtime/handoff/index.js';
+import { hasResumableState } from '../runtime/handoff/substance.js';
+import { readProjectCurrentSession } from '../runtime/hooks/session_id.js';
+import { resolveProjectUuid, sessionStateFile } from '../runtime/paths.js';
+import { ok } from '../runtime/result.js';
+const NoArgs = z.object({}).strict();
+async function mtimeOf(path) {
+    try {
+        return (await stat(path)).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+export const HandoffSessionStart = {
+    name: 'handoff_session_start',
+    argSchema: NoArgs,
+    durable: false,
+    memoizable: false,
+    costEstimateMs: 50,
+    execute: async (_args, ctx) => {
+        try {
+            const cwd = ctx.event.kind === 'session_start' ? (ctx.event.cwd ?? process.cwd()) : process.cwd();
+            const uuid = await resolveProjectUuid({ cwd, env: process.env });
+            if (uuid === null)
+                return ok(null);
+            const deadSid = await readProjectCurrentSession(uuid);
+            if (deadSid === null || deadSid === ctx.sessionId)
+                return ok(null);
+            // Once per fresh session.
+            const stamp = sessionStateFile(ctx.sessionId, 'handoff-read');
+            if ((await mtimeOf(stamp)) !== null)
+                return ok(null);
+            const umbrellaRoot = await umbrellaRootFor(cwd);
+            const fsmPath = sessionStateFile(deadSid, 'fsm-coding-flow');
+            const fsmM = await mtimeOf(fsmPath);
+            // AHO.4: the shared substance predicate (an FSM at bare scoping with no
+            // task/artifact is the junk class — same gate as the SessionEnd writer).
+            let docPath = null;
+            if (await hasResumableState(deadSid)) {
+                // AHO.3: sid-only key — the probe now finds the doc regardless of
+                // which day it was generated (the date-keyed path missed yesterday's).
+                docPath = handoverDocPath(umbrellaRoot, deadSid);
+                const docM = await mtimeOf(docPath);
+                if (docM === null || fsmM === null || docM < fsmM) {
+                    const result = await runHandoff(deadSid, cwd); // generate from disk
+                    docPath = result.docPath;
+                }
+            }
+            await mkdir(dirname(stamp), { recursive: true });
+            await writeFile(stamp, new Date().toISOString(), 'utf8');
+            if (docPath === null)
+                return ok(null);
+            return ok({ kind: 'inject_context', content: renderInjection(docPath) });
+        }
+        catch {
+            return ok(null); // fail-quiet — never block session start
+        }
+    },
+};
+//# sourceMappingURL=handoff_session_start.js.map

package/dist/functions/handoff_session_start.js.map

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

package/dist/functions/http_request.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `http_request` primitive — gated HTTP fetch stub (AUTO.3).
+ *
+ * Like `shell_exec.ts`, AUTO.3 lands the GATE only. The actual fetch
+ * (timeout, retry policy, body framing, redirect handling, response-size
+ * cap) lands in SCHED.1 / AUTO.6 — until then, this primitive performs the
+ * gate check, returns a verdict-routed error on deny, and emits a
+ * `not-implemented` error on allow.
+ *
+ * The gate sees both `url` and `method` — method matching is part of the
+ * pack's `http_request.methods:` declaration, so the primitive forwards
+ * the method as `req.method` for the gate to honour.
+ *
+ * Imports from: zod, ../runtime/result.js, ../runtime/capability_gate.js,
+ *   ./registry.js.
+ * Imported by: src/functions/index.ts (registry wiring).
+ */
+import type { CapabilityGate } from '../runtime/capability_gate.js';
+import type { FunctionRegistry } from './registry.js';
+export declare function registerHttpRequestFunction(registry: FunctionRegistry, opts: {
+    gate: CapabilityGate;
+}): void;
+//# sourceMappingURL=http_request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http_request.d.ts","sourceRoot":"","sources":["../../src/functions/http_request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOtD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GAC7B,IAAI,CAkCN"}

package/dist/functions/http_request.js

@@ -0,0 +1,59 @@
+/**
+ * `http_request` primitive — gated HTTP fetch stub (AUTO.3).
+ *
+ * Like `shell_exec.ts`, AUTO.3 lands the GATE only. The actual fetch
+ * (timeout, retry policy, body framing, redirect handling, response-size
+ * cap) lands in SCHED.1 / AUTO.6 — until then, this primitive performs the
+ * gate check, returns a verdict-routed error on deny, and emits a
+ * `not-implemented` error on allow.
+ *
+ * The gate sees both `url` and `method` — method matching is part of the
+ * pack's `http_request.methods:` declaration, so the primitive forwards
+ * the method as `req.method` for the gate to honour.
+ *
+ * Imports from: zod, ../runtime/result.js, ../runtime/capability_gate.js,
+ *   ./registry.js.
+ * Imported by: src/functions/index.ts (registry wiring).
+ */
+import { z } from 'zod';
+import { err } from '../runtime/result.js';
+const HttpRequestArgs = z.object({
+    url: z.string().min(1),
+    method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']).default('GET'),
+});
+export function registerHttpRequestFunction(registry, opts) {
+    // DURABLE.2 — once SCHED.1 / AUTO.6 wires the real fetch, http_request
+    // is expensive (network round-trip + token-bucket rate limit). Marked
+    // `durable: true` now so the contract is fixed before the fetch layer
+    // lands. `memoizable: true` for the GET case (idempotent reads against
+    // identical URLs); pack authors composing POST/PUT/PATCH/DELETE should
+    // mind that the memo cache (DURABLE.3) keys on `(fn, args)` and will
+    // happily cache a non-idempotent request — DURABLE.3 documents this risk.
+    registry.register({
+        name: 'http_request',
+        argSchema: HttpRequestArgs,
+        durable: true,
+        memoizable: true,
+        costEstimateMs: 500,
+        execute: async ({ url, method }, ctx) => {
+            const verdict = await opts.gate.check({
+                pack: ctx.packId,
+                capability: 'http_request',
+                target: url,
+                method: method ?? 'GET',
+                context: { sessionId: ctx.sessionId },
+            });
+            if (!verdict.allowed) {
+                return err({
+                    kind: 'runtime',
+                    message: `http_request denied: ${verdict.message ?? verdict.source}`,
+                });
+            }
+            return err({
+                kind: 'runtime',
+                message: `http_request gate-allowed but fetch is deferred to SCHED.1/AUTO.6: ${method} "${url}"`,
+            });
+        },
+    });
+}
+//# sourceMappingURL=http_request.js.map

package/dist/functions/http_request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http_request.js","sourceRoot":"","sources":["../../src/functions/http_request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAI3C,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CACzC,QAA0B,EAC1B,IAA8B;IAE9B,uEAAuE;IACvE,sEAAsE;IACtE,sEAAsE;IACtE,uEAAuE;IACvE,uEAAuE;IACvE,qEAAqE;IACrE,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,GAAG;QACnB,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;gBACpC,IAAI,EAAE,GAAG,CAAC,MAAM;gBAChB,UAAU,EAAE,cAAc;gBAC1B,MAAM,EAAE,GAAG;gBACX,MAAM,EAAE,MAAM,IAAI,KAAK;gBACvB,OAAO,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE;aACtC,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrB,OAAO,GAAG,CAAC;oBACT,IAAI,EAAE,SAAkB;oBACxB,OAAO,EAAE,wBAAwB,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE;iBACrE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,GAAG,CAAC;gBACT,IAAI,EAAE,SAAkB;gBACxB,OAAO,EAAE,sEAAsE,MAAM,KAAK,GAAG,GAAG;aACjG,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/functions/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Function library: atomic primitives that skills compose into rule processes.
+ *
+ * The registry is the only path from a skill step to a primitive — packs
+ * resolve `function:` refs via `FunctionRegistry.call()`. Primitives live
+ * in sibling modules and are registered into a per-runtime instance.
+ *
+ * Imports from: runtime/types.ts, runtime/result.ts (transitively via registry).
+ * Imported by: runtime/, packs/.
+ */
+export * from './registry.js';
+export { registerEventFunctions } from './event.js';
+export { registerLessonFunctions } from './lessons.js';
+export { registerLlmFunctions } from './llm.js';
+export { registerRagFunctions } from './rag.js';
+export { registerRecallPreInjectFunction } from './recall_pre_inject.js';
+export { registerStateFunctions } from './state.js';
+export { registerVerdictFunctions } from './verdict.js';
+export { registerDestinationCheckFunction, type CheckDestinationResult, } from './destination_check.js';
+export { registerSubagentFunction, type RegisterSubagentOptions, type SpawnSubagentResult, type SubagentDrift, type SubagentSdk, type SubagentSdkRunResult, } from './subagent.js';
+export { registerFileWriteFunction } from './file_write.js';
+export { registerShellExecFunction } from './shell_exec.js';
+export { registerHttpRequestFunction } from './http_request.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,gCAAgC,EAChC,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,wBAAwB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/functions/index.js

@@ -0,0 +1,28 @@
+/**
+ * Function library: atomic primitives that skills compose into rule processes.
+ *
+ * The registry is the only path from a skill step to a primitive — packs
+ * resolve `function:` refs via `FunctionRegistry.call()`. Primitives live
+ * in sibling modules and are registered into a per-runtime instance.
+ *
+ * Imports from: runtime/types.ts, runtime/result.ts (transitively via registry).
+ * Imported by: runtime/, packs/.
+ */
+export * from './registry.js';
+export { registerEventFunctions } from './event.js';
+export { registerLessonFunctions } from './lessons.js';
+export { registerLlmFunctions } from './llm.js';
+export { registerRagFunctions } from './rag.js';
+export { registerRecallPreInjectFunction } from './recall_pre_inject.js';
+export { registerStateFunctions } from './state.js';
+export { registerVerdictFunctions } from './verdict.js';
+export { registerDestinationCheckFunction, } from './destination_check.js';
+export { registerSubagentFunction, } from './subagent.js';
+// AUTO.3 gated primitives — all three flow through `CapabilityGate.check()`
+// before any side effect. file_write is the only one with a real impl
+// (atomic tmp+rename); shell_exec + http_request are gated stubs that
+// AUTO.5 / SCHED.1 wire to spawn + fetch respectively.
+export { registerFileWriteFunction } from './file_write.js';
+export { registerShellExecFunction } from './shell_exec.js';
+export { registerHttpRequestFunction } from './http_request.js';
+//# sourceMappingURL=index.js.map

package/dist/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,gCAAgC,GAEjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,wBAAwB,GAMzB,MAAM,eAAe,CAAC;AACvB,4EAA4E;AAC5E,sEAAsE;AACtE,sEAAsE;AACtE,uDAAuD;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/functions/is_automation_mode.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `is_automation_mode` primitive — gate skill rules on whether the session
+ * is currently in an automation loop (G.12).
+ *
+ * Two signal sources, OR'd at the boundary:
+ *
+ *   1. `OPENSQUID_AUTOMATION=1` env var — process-level override the user
+ *      (or a wrapper script) sets explicitly. Manual escape hatch when the
+ *      flag-file path doesn't apply (e.g. ad-hoc dist-binary testing).
+ *   2. `~/.opensquid/sessions/<session-id>/automation.flag` — the canonical
+ *      signal the `opensquid automation on|off` CLI writes/removes. File
+ *      EXISTENCE = automation on; absence = automation off. Source-of-truth
+ *      for `/loop` and any future automation-aware skill.
+ *
+ * Return shape: `ok({ value: boolean, source: 'env' | 'flag' | 'none' })`.
+ * The `source` field is purely for downstream observability (audit logs,
+ * trace ui) — skills should branch on `value`, never on `source`.
+ *
+ * Active-loops-registry integration (3rd source from the spec) is
+ * INTENTIONALLY OUT OF SCOPE for G.12 — the `/loop` skill doesn't yet ship
+ * its own state file. Phase-2 lock #1: ANY of (env|flag) = true.
+ *
+ * Failure model: this primitive cannot fail in any meaningful way — env
+ * read is sync + cheap, flag-file ENOENT is the "off" answer. We register
+ * `durable: false, memoizable: false` because the answer can flip mid-run
+ * (user toggles `opensquid automation on/off` between turns) and caching
+ * would defeat the whole point of the gate.
+ *
+ * Imports from: node:fs/promises, zod, ../runtime/result.js,
+ *   ../runtime/automation_state.js, ./registry.js.
+ * Imported by: src/runtime/bootstrap.ts (registry wiring).
+ */
+import { z } from 'zod';
+import type { FunctionDef } from './registry.js';
+export declare const IsAutomationModeArgs: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export type AutomationSource = 'env' | 'flag' | 'none';
+export interface IsAutomationModeResult {
+    value: boolean;
+    source: AutomationSource;
+}
+export declare const IsAutomationMode: FunctionDef<z.input<typeof IsAutomationModeArgs>, IsAutomationModeResult>;
+//# sourceMappingURL=is_automation_mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is_automation_mode.d.ts","sourceRoot":"","sources":["../../src/functions/is_automation_mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,eAAO,MAAM,oBAAoB,iDAAwB,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,EAAE,WAAW,CACxC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EACpC,sBAAsB,CAgBvB,CAAC"}

package/dist/functions/is_automation_mode.js

@@ -0,0 +1,53 @@
+/**
+ * `is_automation_mode` primitive — gate skill rules on whether the session
+ * is currently in an automation loop (G.12).
+ *
+ * Two signal sources, OR'd at the boundary:
+ *
+ *   1. `OPENSQUID_AUTOMATION=1` env var — process-level override the user
+ *      (or a wrapper script) sets explicitly. Manual escape hatch when the
+ *      flag-file path doesn't apply (e.g. ad-hoc dist-binary testing).
+ *   2. `~/.opensquid/sessions/<session-id>/automation.flag` — the canonical
+ *      signal the `opensquid automation on|off` CLI writes/removes. File
+ *      EXISTENCE = automation on; absence = automation off. Source-of-truth
+ *      for `/loop` and any future automation-aware skill.
+ *
+ * Return shape: `ok({ value: boolean, source: 'env' | 'flag' | 'none' })`.
+ * The `source` field is purely for downstream observability (audit logs,
+ * trace ui) — skills should branch on `value`, never on `source`.
+ *
+ * Active-loops-registry integration (3rd source from the spec) is
+ * INTENTIONALLY OUT OF SCOPE for G.12 — the `/loop` skill doesn't yet ship
+ * its own state file. Phase-2 lock #1: ANY of (env|flag) = true.
+ *
+ * Failure model: this primitive cannot fail in any meaningful way — env
+ * read is sync + cheap, flag-file ENOENT is the "off" answer. We register
+ * `durable: false, memoizable: false` because the answer can flip mid-run
+ * (user toggles `opensquid automation on/off` between turns) and caching
+ * would defeat the whole point of the gate.
+ *
+ * Imports from: node:fs/promises, zod, ../runtime/result.js,
+ *   ../runtime/automation_state.js, ./registry.js.
+ * Imported by: src/runtime/bootstrap.ts (registry wiring).
+ */
+import { z } from 'zod';
+import { isAutomationFlagSet } from '../runtime/automation_state.js';
+import { ok } from '../runtime/result.js';
+export const IsAutomationModeArgs = z.object({}).strict();
+export const IsAutomationMode = {
+    name: 'is_automation_mode',
+    argSchema: IsAutomationModeArgs,
+    durable: false,
+    memoizable: false,
+    costEstimateMs: 1,
+    execute: async (_args, ctx) => {
+        if (process.env.OPENSQUID_AUTOMATION === '1') {
+            return ok({ value: true, source: 'env' });
+        }
+        if (await isAutomationFlagSet(ctx.sessionId)) {
+            return ok({ value: true, source: 'flag' });
+        }
+        return ok({ value: false, source: 'none' });
+    },
+};
+//# sourceMappingURL=is_automation_mode.js.map

package/dist/functions/is_automation_mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_automation_mode.js","sourceRoot":"","sources":["../../src/functions/is_automation_mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAI1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAS1D,MAAM,CAAC,MAAM,gBAAgB,GAGzB;IACF,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,oBAAoB;IAC/B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,KAAK;IACjB,cAAc,EAAE,CAAC;IACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,EAAE,CAAC;YAC7C,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7C,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}

package/dist/functions/lessons.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Lesson primitives: `propose_lesson`, `promote_lesson`, `recall_lesson`.
+ *
+ * T-loop-engine-reintegration T.6 — surfaces the loop-engine wedge gate
+ * to skills. Three atomic primitives compose into capture/promote/recall
+ * workflows; the gate itself lives in `engine/src/engine/lessons/gate.rs`.
+ *
+ * Why these three (and only these three):
+ *   - `propose_lesson` — the capture surface. Skill authors call this
+ *     when an agent or user proposes a new lesson candidate. Agent-
+ *     authored lessons remain `pending` until the gate promotes them;
+ *     user-authored lessons skip the gate (eviction-immune via
+ *     `Authorship::is_immune` per T.1.G).
+ *   - `promote_lesson` — the gate firing surface. Calls engine's
+ *     `lesson.promote`, which runs the wedge checks. A block here is
+ *     the entire competitive moat (per
+ *     `project_2026_05_12_strategic_pivot`): the only system that
+ *     refuses to self-grade promotions. We surface the block as a
+ *     successful `ok({status:'blocked', reasons})` because the block IS
+ *     the system working as designed — not a runtime error.
+ *   - `recall_lesson` — text-match retrieval across pending/active/
+ *     promoted/superseded status dirs (T.1.B). NOT vector — that
+ *     property surfaces evidence-less lessons during the capture loop
+ *     even when the embedder is degraded.
+ *
+ * What's intentionally NOT here (out of scope; pack-install only):
+ *   - `pack_id`, `external_id`, `seed_as_promoted` on propose_lesson —
+ *     pack-authored seed paths handled by a separate install flow
+ *     (T.1.B notes the validation rules: `pack_id` required when
+ *     `authored_by === 'pack'`, `seed_as_promoted` requires
+ *     `authored_by === 'pack'`).
+ *
+ * Authored_by encoding gotcha (T.1.G):
+ *   The wire input only honors `'user'` and `'pack'`. Anything else —
+ *   including `'agent'` from a Zod-validated arg — silently maps to
+ *   engine's `Llm` default. We accept `'user' | 'agent'` from skill
+ *   authors for ergonomic symmetry with the existing `store_lesson`
+ *   primitive, then translate: `'user'` passes through verbatim;
+ *   `'agent'` becomes `undefined` (engine default Llm). User-authored
+ *   lessons are eviction-immune; agent/llm-authored aren't.
+ *
+ * Why no "permits promotion" test (deliberate scope correction per
+ * T.1.F + T.1.HH + spec line 967-969):
+ *   The engine's `PromotionConfig::default()` requires:
+ *     min_age = 24 hours
+ *     min_applied_count = 3 (via manifest.assemble side effect)
+ *     external_signal_sources non-empty (via lesson.capture_feedback)
+ *     causal_narrative present (auto-built when evidence is supplied)
+ *   None of those are satisfiable in unit-test timescales — that's the
+ *   moat working as designed, not a bug. T.6 proves the gate FIRES
+ *   (block-only E2E); production promotion only happens over real
+ *   session usage. T.8 will file an engine follow-up to expose a
+ *   PromotionConfig override for testing, but that's NOT in T.6 scope.
+ *
+ * Imports from: zod, ../engine/client.js, ../engine/types.js,
+ *   ../runtime/result.js, ./registry.js.
+ * Imported by: ../runtime/bootstrap.ts.
+ */
+import { type WedgeLessonStore } from '../rag/wedge/store.js';
+import type { FunctionRegistry } from './registry.js';
+export declare function registerLessonFunctions(registry: FunctionRegistry, store: WedgeLessonStore): void;
+/**
+ * Result of a `promote_lesson` call.
+ *
+ * `'promoted'` means the engine accepted the promotion (the wedge gate ran
+ * AND passed — production happy path after 24h+ real session usage).
+ *
+ * `'blocked'` means the engine ran the gate and refused the promotion.
+ * `reasons` carries kebab-case BlockReason::Display strings (T.1.F). This
+ * is the moat firing, NOT an error — skills branch on this field to
+ * decide whether to surface the block to the user or capture more
+ * evidence and retry.
+ */
+export type PromoteLessonResult = {
+    status: 'promoted';
+    detail: {
+        id: string;
+        status: 'promoted';
+    };
+} | {
+    status: 'blocked';
+    reasons: string[];
+};
+//# sourceMappingURL=lessons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lessons.d.ts","sourceRoot":"","sources":["../../src/functions/lessons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAKH,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAErF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAqCtD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAkJjG;AAOD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAA;CAAE,GAClE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC"}