opensquid 0.5.395

package/dist/runtime/observability/trace_reader.js

@@ -0,0 +1,357 @@
+/**
+ * OBSERVE.1 — trace timeline reader.
+ *
+ * Reads the existing DURABLE.1 + DURABLE.4 tables (`checkpoints` +
+ * `run_manifests` + `terminal_markers`) and renders them as a typed
+ * timeline. There is NO separate trace table — the checkpoint log IS
+ * the trace data. Every query in this module hits those three tables
+ * directly; nothing is duplicated, nothing is denormalized.
+ *
+ * Status inference (4 paths):
+ *
+ *   completed    — terminal_markers row exists AND no errored checkpoint
+ *   errored      — terminal_markers row exists AND ≥1 errored checkpoint
+ *   in_flight    — no terminal_markers row AND lastCompletedAtMs within
+ *                  RESUME_WINDOW_MS (60s, same as Resumer)
+ *   interrupted  — no terminal_markers row AND lastCompletedAtMs is older
+ *                  than RESUME_WINDOW_MS (the Resumer would skip these)
+ *
+ * OpenTelemetry export uses derived IDs:
+ *
+ *   trace_id  =  sha256(runId).slice(0, 32)              // 16 bytes / 32 hex
+ *   span_id   =  sha256(runId + ':' + stepIdx).slice(0, 16)  // 8 bytes / 16 hex
+ *
+ * Previews are truncated to 200 user-visible code points (UTF-8-safe via
+ * `Array.from`) and then passed through `stripSecrets` from
+ * `deliver_only.ts` — same regex pattern as the SCHED.2 deliver-only
+ * webhook path. Inputs only carry a content-addressed hash in the
+ * checkpoint, so `inputsPreview` is derived from the hash; outputs hold
+ * the canonical-JSON-revived value so `outputsPreview` is a JSON snippet.
+ *
+ * Tail polling defaults to 1000ms with a 100ms floor — libsql is
+ * resilient but hammering at 10ms doesn't reflect anything `tail`-shaped
+ * a user actually needs.
+ *
+ * Imports from: @libsql/client, node:crypto, ../deliver_only.js,
+ *               ../durable/canonical_json.js, ./trace_types.js.
+ * Imported by: OBSERVE.2 CLI, downstream consumers via barrel.
+ */
+import { stripSecrets } from '../deliver_only.js';
+import { canonicalJsonParse, canonicalJsonStringify } from '../durable/canonical_json.js';
+import { toOtel } from './otel_export.js';
+/** Same window as `DEFAULT_RESUME_WINDOW_MS` in the Resumer. */
+const RESUME_WINDOW_MS = 60_000;
+/** Default polling interval for `tail`. */
+const DEFAULT_TAIL_INTERVAL_MS = 1_000;
+/** Floor for `tail` polling — don't let callers hammer libsql. */
+const MIN_TAIL_INTERVAL_MS = 100;
+const PREVIEW_CODEPOINT_CAP = 200;
+export class TraceReader {
+    db;
+    nowMs;
+    constructor(db, nowMs = Date.now) {
+        this.db = db;
+        this.nowMs = nowMs;
+    }
+    /**
+     * Materialize a full timeline for `runId`. Joins one row from
+     * `run_manifests` with its ordered checkpoint rows, then derives status
+     * from the presence of a `terminal_markers` row + the age of the last
+     * completed step.
+     *
+     * Returns `null` when the manifest is missing — even if checkpoint rows
+     * exist, an orphan run can't be reconstructed without manifest identity
+     * (matches the Resumer's `manifest_missing` audit reason).
+     */
+    async getTimeline(runId) {
+        const manifestRow = await this.db.execute({
+            sql: `SELECT run_id, pack_id, skill, rule_id, event_kind, started_at_ms
+            FROM run_manifests WHERE run_id = ? LIMIT 1`,
+            args: [runId],
+        });
+        const m = manifestRow.rows[0];
+        if (!m)
+            return null;
+        const checkpointsRs = await this.db.execute({
+            sql: `SELECT step_idx, fn, inputs_hash, outputs_json, as_binding,
+                   started_at_ms, completed_at_ms, status, error_message
+            FROM checkpoints WHERE run_id = ? ORDER BY step_idx ASC`,
+            args: [runId],
+        });
+        const terminalRs = await this.db.execute({
+            sql: `SELECT terminated_at_ms FROM terminal_markers WHERE run_id = ? LIMIT 1`,
+            args: [runId],
+        });
+        const events = checkpointsRs.rows.map((r) => rowToTraceEvent(asRec(r), runId));
+        const terminalRec = terminalRs.rows[0] !== undefined ? asRec(terminalRs.rows[0]) : null;
+        const terminalAtMs = terminalRec !== null ? Number(terminalRec.terminated_at_ms) : null;
+        const hasErrored = events.some((e) => e.status === 'errored');
+        const lastCompletedAtMs = events.length > 0 ? Math.max(...events.map((e) => e.completedAtMs)) : 0;
+        const status = inferStatus({
+            hasTerminal: terminalRec !== null,
+            hasErrored,
+            lastCompletedAtMs,
+            nowMs: this.nowMs(),
+        });
+        const manifest = asRec(m);
+        const startedAtMs = Number(manifest.started_at_ms);
+        const completedAtMs = terminalAtMs;
+        const totalDurationMs = completedAtMs !== null
+            ? Math.max(0, completedAtMs - startedAtMs)
+            : Math.max(0, this.nowMs() - startedAtMs);
+        return {
+            runId,
+            packId: asStr(manifest.pack_id),
+            skill: asStr(manifest.skill),
+            ruleId: asStr(manifest.rule_id),
+            eventKind: asStr(manifest.event_kind),
+            startedAtMs,
+            completedAtMs,
+            totalDurationMs,
+            status,
+            events,
+        };
+    }
+    /**
+     * Recent runs, filterable by pack/skill/status/window. Uses
+     * `idx_run_manifests_started_at` for the time-range scan, which keeps
+     * the query sub-100ms at 1M-row scale (validated via EXPLAIN — the
+     * index is hit before the LEFT JOIN against terminal_markers).
+     *
+     * Status filter is applied AFTER the SQL pass since `interrupted` vs
+     * `in_flight` is a time-based heuristic, not a column.
+     */
+    async listRecent(opts = {}) {
+        const limit = Math.max(1, opts.limit ?? 50);
+        const sinceMs = opts.sinceMs ?? 0;
+        const filters = ['m.started_at_ms >= ?'];
+        const args = [sinceMs];
+        if (opts.packId !== undefined) {
+            filters.push('m.pack_id = ?');
+            args.push(opts.packId);
+        }
+        if (opts.skill !== undefined) {
+            filters.push('m.skill = ?');
+            args.push(opts.skill);
+        }
+        const sql = `
+      SELECT m.run_id AS run_id,
+             m.pack_id AS pack_id,
+             m.skill AS skill,
+             m.event_kind AS event_kind,
+             m.started_at_ms AS started_at_ms,
+             t.terminated_at_ms AS terminated_at_ms,
+             (SELECT COUNT(*) FROM checkpoints c WHERE c.run_id = m.run_id) AS step_count,
+             (SELECT MAX(c.completed_at_ms) FROM checkpoints c WHERE c.run_id = m.run_id) AS last_at_ms,
+             (SELECT COUNT(*) FROM checkpoints c
+                WHERE c.run_id = m.run_id AND c.status = 'errored') AS errored_count
+      FROM run_manifests m
+      LEFT JOIN terminal_markers t ON t.run_id = m.run_id
+      WHERE ${filters.join(' AND ')}
+      ORDER BY m.started_at_ms DESC
+      LIMIT ?
+    `;
+        args.push(limit);
+        const rs = await this.db.execute({ sql, args });
+        const now = this.nowMs();
+        const entries = [];
+        for (const rowRaw of rs.rows) {
+            const row = asRec(rowRaw);
+            const lastAt = row.last_at_ms === null || row.last_at_ms === undefined ? 0 : Number(row.last_at_ms);
+            const status = inferStatus({
+                hasTerminal: row.terminated_at_ms !== null && row.terminated_at_ms !== undefined,
+                hasErrored: Number(row.errored_count) > 0,
+                lastCompletedAtMs: lastAt,
+                nowMs: now,
+            });
+            if (opts.status !== undefined && opts.status !== status)
+                continue;
+            entries.push({
+                runId: asStr(row.run_id),
+                packId: asStr(row.pack_id),
+                skill: asStr(row.skill),
+                eventKind: asStr(row.event_kind),
+                startedAtMs: Number(row.started_at_ms),
+                status,
+                stepCount: Number(row.step_count),
+            });
+        }
+        return entries;
+    }
+    /**
+     * Polling tail. Returns an `AsyncIterable<TraceEvent>` that yields every
+     * checkpoint row whose `completed_at_ms` is `> cursor`, where `cursor`
+     * starts at `opts.sinceMs` and advances after every batch.
+     *
+     * Termination: caller passes an `AbortSignal`. When aborted, the
+     * generator returns cleanly (no thrown error, no leaked timer).
+     *
+     * libsql has no CDC; polling at 1s is fine for human-facing tail use
+     * cases. Higher-frequency consumers (CI dashboards) can drop to the
+     * 100ms floor.
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async tail(opts = {}) {
+        const interval = Math.max(MIN_TAIL_INTERVAL_MS, opts.intervalMs ?? DEFAULT_TAIL_INTERVAL_MS);
+        let cursor = opts.sinceMs ?? this.nowMs();
+        const packId = opts.packId;
+        const signal = opts.signal;
+        const db = this.db;
+        async function* gen() {
+            while (!signal?.aborted) {
+                const filters = ['c.completed_at_ms > ?'];
+                const args = [cursor];
+                if (packId !== undefined) {
+                    filters.push('m.pack_id = ?');
+                    args.push(packId);
+                }
+                const sql = `
+          SELECT c.run_id AS run_id, c.step_idx AS step_idx, c.fn AS fn,
+                 c.inputs_hash AS inputs_hash, c.outputs_json AS outputs_json,
+                 c.as_binding AS as_binding, c.started_at_ms AS started_at_ms,
+                 c.completed_at_ms AS completed_at_ms, c.status AS status,
+                 c.error_message AS error_message
+          FROM checkpoints c
+          ${packId !== undefined ? 'INNER JOIN run_manifests m ON m.run_id = c.run_id' : ''}
+          WHERE ${filters.join(' AND ')}
+          ORDER BY c.completed_at_ms ASC, c.step_idx ASC
+        `;
+                const rs = await db.execute({ sql, args });
+                for (const r of rs.rows) {
+                    const rec = asRec(r);
+                    const ev = rowToTraceEvent(rec, asStr(rec.run_id));
+                    if (ev.completedAtMs > cursor)
+                        cursor = ev.completedAtMs;
+                    yield ev;
+                }
+                if (signal?.aborted)
+                    return;
+                await sleep(interval, signal);
+            }
+        }
+        return gen();
+    }
+    /**
+     * Serialize a timeline as JSON (pretty) or OTEL (subset of the OTLP
+     * trace JSON format — vendor-importable into AgentOps / LangSmith /
+     * Jaeger). Returns `''` for a nonexistent runId so callers don't have
+     * to disambiguate `null` vs serialization failure.
+     */
+    async export(runId, format) {
+        const t = await this.getTimeline(runId);
+        if (t === null)
+            return '';
+        if (format === 'json')
+            return JSON.stringify(t, null, 2);
+        return JSON.stringify(toOtel(t), null, 2);
+    }
+}
+/**
+ * Re-typing helper. libsql's `Row` types cells as `Value`
+ * (`null | string | number | bigint | ArrayBuffer`); narrowing through
+ * `Record<string, unknown>` lets ESLint's no-base-to-string accept
+ * `String(...)` / `Number(...)` casts on unknown cells (we know which
+ * column is which type from the SQL schema).
+ */
+function asRec(row) {
+    return row;
+}
+function asStr(v) {
+    if (typeof v === 'string')
+        return v;
+    if (typeof v === 'number' || typeof v === 'bigint')
+        return v.toString();
+    return '';
+}
+/**
+ * Map one canonicalized checkpoint row to a TraceEvent. Centralizing this
+ * keeps the two read paths (`getTimeline` + `tail`) consistent — both
+ * emit the same TraceEvent shape with the same preview / status logic.
+ */
+function rowToTraceEvent(rec, runId) {
+    const outputsJsonRaw = rec.outputs_json;
+    const outputs = typeof outputsJsonRaw === 'string' ? canonicalJsonParse(outputsJsonRaw) : null;
+    const inputsHash = asStr(rec.inputs_hash);
+    const completedAtMs = Number(rec.completed_at_ms);
+    const startedAtMs = Number(rec.started_at_ms);
+    const asBindingRaw = rec.as_binding;
+    const errorRaw = rec.error_message;
+    const status = rec.status === 'errored' ? 'errored' : 'completed';
+    const ev = {
+        runId,
+        stepIdx: Number(rec.step_idx),
+        fn: asStr(rec.fn),
+        inputsHash,
+        outputs,
+        startedAtMs,
+        completedAtMs,
+        durationMs: Math.max(0, completedAtMs - startedAtMs),
+        status,
+    };
+    const inputsPreview = previewForInputsHash(inputsHash);
+    if (inputsPreview !== undefined)
+        ev.inputsPreview = inputsPreview;
+    const outputsPreview = previewForOutputs(outputs);
+    if (outputsPreview !== undefined)
+        ev.outputsPreview = outputsPreview;
+    if (typeof asBindingRaw === 'string')
+        ev.asBinding = asBindingRaw;
+    if (typeof errorRaw === 'string')
+        ev.errorMessage = errorRaw;
+    return ev;
+}
+function inferStatus(input) {
+    if (input.hasTerminal)
+        return input.hasErrored ? 'errored' : 'completed';
+    const age = input.nowMs - input.lastCompletedAtMs;
+    if (input.lastCompletedAtMs === 0)
+        return 'in_flight';
+    return age <= RESUME_WINDOW_MS ? 'in_flight' : 'interrupted';
+}
+/**
+ * UTF-8-safe truncate. `Array.from` yields one element per Unicode code
+ * point (correctly handling surrogate pairs), so `slice` then `join`
+ * never splits mid-codepoint. Then redact secret-bearing key/value
+ * patterns via the same regex used by SCHED.2 deliver-only.
+ */
+function truncatePreview(text) {
+    const cps = Array.from(text);
+    const clipped = cps.length > PREVIEW_CODEPOINT_CAP ? cps.slice(0, PREVIEW_CODEPOINT_CAP).join('') : text;
+    return stripSecrets(clipped).text;
+}
+function previewForOutputs(outputs) {
+    if (outputs === null || outputs === undefined)
+        return undefined;
+    try {
+        const json = canonicalJsonStringify(outputs);
+        return truncatePreview(json);
+    }
+    catch {
+        return undefined;
+    }
+}
+function previewForInputsHash(hash) {
+    if (hash === '')
+        return undefined;
+    // Inputs themselves are not stored — only the content-addressed hash.
+    // Surface the hash prefix so a user can correlate replay attempts.
+    return `inputs_hash:${hash.slice(0, 16)}`;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=trace_reader.js.map

package/dist/runtime/observability/trace_reader.js.map

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

package/dist/runtime/observability/trace_types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * OBSERVE.1 — trace timeline TS types.
+ *
+ * Shapes returned by `TraceReader`. The reader derives these from the
+ * existing DURABLE.1 + DURABLE.4 tables (`checkpoints` + `run_manifests`
+ * + `terminal_markers`) — no separate trace storage. Single source of
+ * truth: every field in `TraceEvent` maps 1:1 to a checkpoints column,
+ * and `TraceTimeline` joins one manifest with its ordered checkpoint
+ * rows.
+ *
+ * Imports from: nothing (pure types).
+ * Imported by: ./trace_reader.ts, ./index.ts, downstream CLI (OBSERVE.2).
+ */
+/** Status derived from terminal_markers + checkpoint state + age window. */
+export type TraceStatus = 'completed' | 'in_flight' | 'errored' | 'interrupted';
+/** One primitive call boundary — read from a single `checkpoints` row. */
+export interface TraceEvent {
+    runId: string;
+    stepIdx: number;
+    fn: string;
+    inputsHash: string;
+    /** First 200 chars (UTF-8-safe). Secret-redacted. Omitted when checkpoint has no input preview source. */
+    inputsPreview?: string;
+    outputs: unknown;
+    /** First 200 chars of canonical-JSON outputs (UTF-8-safe). Secret-redacted. */
+    outputsPreview?: string;
+    asBinding?: string;
+    startedAtMs: number;
+    completedAtMs: number;
+    durationMs: number;
+    status: 'completed' | 'errored';
+    errorMessage?: string;
+}
+/** A full run's timeline. Joins the manifest with its ordered events. */
+export interface TraceTimeline {
+    runId: string;
+    packId: string;
+    skill: string;
+    ruleId: string;
+    eventKind: string;
+    startedAtMs: number;
+    /** Null while the run is still in-flight (no terminal marker yet). */
+    completedAtMs: number | null;
+    totalDurationMs: number;
+    status: TraceStatus;
+    /** Sorted ascending by stepIdx. */
+    events: TraceEvent[];
+    /** Populated when the memo cache + cost router are wired (future). */
+    llmCost?: {
+        tokens: number;
+        usd?: number;
+    };
+}
+/** Summary row for `listRecent` — does NOT carry per-step events. */
+export interface TraceListEntry {
+    runId: string;
+    packId: string;
+    skill: string;
+    startedAtMs: number;
+    status: TraceStatus;
+    eventKind: string;
+    stepCount: number;
+}
+//# sourceMappingURL=trace_types.d.ts.map

package/dist/runtime/observability/trace_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace_types.d.ts","sourceRoot":"","sources":["../../../src/runtime/observability/trace_types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;AAEhF,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,0GAA0G;IAC1G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,mCAAmC;IACnC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,sEAAsE;IACtE,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/runtime/observability/trace_types.js

@@ -0,0 +1,15 @@
+/**
+ * OBSERVE.1 — trace timeline TS types.
+ *
+ * Shapes returned by `TraceReader`. The reader derives these from the
+ * existing DURABLE.1 + DURABLE.4 tables (`checkpoints` + `run_manifests`
+ * + `terminal_markers`) — no separate trace storage. Single source of
+ * truth: every field in `TraceEvent` maps 1:1 to a checkpoints column,
+ * and `TraceTimeline` joins one manifest with its ordered checkpoint
+ * rows.
+ *
+ * Imports from: nothing (pure types).
+ * Imported by: ./trace_reader.ts, ./index.ts, downstream CLI (OBSERVE.2).
+ */
+export {};
+//# sourceMappingURL=trace_types.js.map

package/dist/runtime/observability/trace_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace_types.js","sourceRoot":"","sources":["../../../src/runtime/observability/trace_types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/runtime/paths.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Path resolution helpers for opensquid's filesystem layout.
+ *
+ * Layout (per `docs/opensquid-real-design.md` §"Phase 1 — Runtime skeleton"
+ * + §"Phases 2–7 summary" Phase 5):
+ *
+ *   ~/.opensquid/
+ *     sessions/<session-id>/
+ *       state/
+ *         <key>.json      — `write_state` / `read_state` primitives
+ *         <name>.jsonl    — `append_log` primitive
+ *     packs/<pack-id>/
+ *       state/
+ *         <key>.json      — per-pack state (Task 5.3)
+ *         <name>.jsonl    — per-pack logs (e.g. drift-catalog.jsonl)
+ *
+ * `OPENSQUID_HOME` env-var override is intentional: tests point it at
+ * `os.tmpdir()` for filesystem isolation, and self-hosting deployments
+ * may relocate state to a non-`$HOME` data directory.
+ *
+ * Always `path.join` — never raw string concat — so Windows backslashes
+ * stay sane.
+ *
+ * Imported by: src/functions/state.ts, src/runtime/drift_catalog.ts.
+ */
+export declare const OPENSQUID_HOME: () => string;
+/**
+ * Returns the user-scope opensquid root (`~/.opensquid/` by default; honors
+ * `OPENSQUID_HOME` env override). Always returns a path; the directory may
+ * not exist yet (`discoverActivePacks` treats absent active.json as empty).
+ */
+export declare const resolveUserScopeRoot: () => string;
+/**
+ * BPDISC — Returns the built-in pack scope root: the directory whose
+ * `<root>/<name>/manifest.yaml` paths hold the packs that ship inside the
+ * opensquid npm install (`packs/builtin/`). When a user's `active.json`
+ * names a pack not found under user or project scope, the loader falls back
+ * to this root. Mirrors the OPENSQUID_HOME pattern: `OPENSQUID_BUILTIN_PACKS_ROOT`
+ * env var wins for test isolation; otherwise the path is computed relative
+ * to the dist file location at module import time.
+ *
+ * From a dist file at `<npm-root>/dist/runtime/paths.js`, the built-in
+ * packs sit at `<npm-root>/packs/builtin/` — three dirs up + `packs/builtin`.
+ * Works for both the local checkout layout (`src/runtime/paths.ts` → up to
+ * `opensquid/packs/builtin/`) and the npm-install layout (`node_modules/opensquid/dist/...`).
+ */
+export declare const resolveBuiltinScopeRoot: () => string;
+/**
+ * Walks up from `cwd` looking for a `.opensquid/` directory. Returns its
+ * absolute path on first hit, or `null` if the walk reaches the filesystem
+ * root without finding one (no project scope in effect).
+ *
+ * The 64-level cap protects against pathological symlink cycles. Real
+ * project trees bottom out well before 64 levels.
+ *
+ * Important: this probes for the `.opensquid/` DIRECTORY's existence, NOT
+ * the `.opensquid/project.json` FILE. The two walks have different purposes
+ * (this one answers "is there pack config here?"; `walkForProjectUuid`
+ * below answers "is there a UUID-bound project here?"). Both share the
+ * 64-level cap discipline.
+ */
+export declare const resolveProjectScopeRoot: (cwd: string) => Promise<string | null>;
+/** The `.opensquid/project.json` schema. `version` is the on-disk discriminator. */
+export interface ProjectCard {
+    version: 1;
+    id: string;
+    uuid: string;
+}
+/**
+ * Env-only project-UUID lookup. Returns the value of `OPENSQUID_PROJECT_UUID`
+ * if set + non-empty, else `null`. Synchronous — no I/O.
+ *
+ * Defaults to `process.env` when called without an argument; the optional
+ * `env` parameter exists for test injection.
+ */
+export declare function resolveProjectUuidFromEnv(env?: NodeJS.ProcessEnv): string | null;
+/**
+ * Walks up from `startDir` looking for `.opensquid/project.json`. Returns
+ * the parsed `uuid` on first hit (strict schema check: `version === 1 &&
+ * uuid && id`), or `null` when the walk exhausts the 64-level cap or
+ * reaches the filesystem root without a valid card.
+ *
+ * Malformed JSON, missing fields, and version mismatches all silently
+ * continue the walk — a bad ancestor card must not mask a good descendant
+ * one, and the same file might be valid under a different `version`-future
+ * revision that this consumer doesn't recognize.
+ */
+export declare function walkForProjectUuid(startDir: string): Promise<string | null>;
+/**
+ * Canonical combinator: env-first then cwd-walk. The pattern 5 call sites
+ * reimplemented before T-PUC consolidated them.
+ *
+ * Returns the first non-null source, else `null`. `env` defaults to
+ * `process.env` when omitted; `cwd` is required (callers always know which
+ * directory to walk from — there is no sensible default).
+ */
+export declare function resolveProjectUuid(opts: {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<string | null>;
+export declare const sessionStateDir: (sessionId: string) => string;
+export declare const sessionStateFile: (sessionId: string, key: string) => string;
+export declare const sessionLogFile: (sessionId: string, name: string) => string;
+/**
+ * The active-task signal file (AP.2). Lives at the session ROOT, deliberately
+ * NOT under `state/`: `state/` holds pack-authored `read_state`/`write_state`
+ * keys, and the active-task signal is runtime-owned — keeping it at the root
+ * prevents a pack's `write_state` from clobbering the gate's trigger. Absent
+ * file = no active task (the "tasks-loaded" signal is off).
+ */
+export declare const activeTaskFile: (sessionId: string) => string;
+/** Archive destination for the active-task file on SessionEnd (rule #16 — archive, never silently drop). */
+export declare const activeTaskArchiveFile: (sessionId: string, stamp: string) => string;
+export declare const packStateDir: (packId: string) => string;
+export declare const packStateFile: (packId: string, key: string) => string;
+export declare const packLogFile: (packId: string, name: string) => string;
+export declare const daemonLockPath: () => string;
+export declare const daemonPidPath: () => string;
+export declare const daemonLogPath: () => string;
+export declare const chatDaemonSockPath: () => string;
+export declare const chatDaemonPidPath: () => string;
+export declare const chatDaemonLogPath: () => string;
+export declare const inboxFile: (projectUuid: string, platform: string) => string;
+export declare const inboxDir: (projectUuid: string) => string;
+export declare const inboxAckedPath: (projectUuid: string) => string;
+export declare const liveSessionLease: (projectUuid: string) => string;
+export declare const projectCurrentSessionPath: (projectUuid: string) => string;
+export declare const umbrellaInboxFile: (umbrellaId: string, platform: string) => string;
+export declare const umbrellaInboxDir: (umbrellaId: string) => string;
+export declare const umbrellaInboxAckedPath: (umbrellaId: string) => string;
+export declare const umbrellaLiveSessionLease: (umbrellaId: string) => string;
+export declare const umbrellaCurrentSessionPath: (umbrellaId: string) => string;
+export declare const umbrellaChatDrivenMarker: (umbrellaId: string) => string;
+export declare const inboundMediaDir: () => string;
+export declare const orphanInboxFile: (platform: string) => string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/runtime/paths.d.ts.map

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