@opencorelabs/lucidity 0.1.0

package/node_modules/@lucidity/runtime/dist/executor/cliVersion.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The Claude Code CLI version this executor's flag surface was verified against.
+ *
+ * {@link import('./claudeCode.js').ClaudeCodeExecutor} drives the CLI by argv, and argv
+ * is an UNSTABLE surface that changes on a CLI auto-update with no commit on our side.
+ * That failure mode has already bitten us once: `--disallowedTools` became variadic in
+ * Claude Code 2.x and silently swallowed the trailing positional prompt, which broke Chat
+ * only (the code path skipped it via `--permission-mode`). It took three rounds to find
+ * because nothing in the logs said which CLI produced the bad turn.
+ *
+ * So the daemon probes the live version at startup, logs it, and warns on major/minor
+ * drift. The point is not to block — it is to leave a version line next to the next
+ * mystery turn failure.
+ *
+ * Bump this after re-verifying the flags built in `ClaudeCodeExecutor.run`/`runStream`.
+ */
+export declare const EXPECTED_CLI_VERSION = "2.1.220";
+export interface CliVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    /** The full version string as reported, e.g. `"2.1.220"`. */
+    version: string;
+    /** The raw stdout line, e.g. `"2.1.220 (Claude Code)"`. */
+    raw: string;
+}
+/**
+ * Parse `claude --version` stdout. The CLI prints `2.1.220 (Claude Code)`, but we only
+ * anchor on the leading semver triple so a change to the trailing label can't break the
+ * probe — a version check that itself breaks on a CLI update would defeat its purpose.
+ * Returns null when no version can be found.
+ */
+export declare function parseCliVersion(stdout: string): CliVersion | null;
+/** Run `claude --version` and parse it. Resolves null on any failure (missing binary,
+ *  non-zero exit, timeout, unparseable output) — the caller treats that as "unknown",
+ *  and a genuinely missing CLI surfaces later with the executor's own ENOENT message. */
+export declare function probeCliVersion(command?: string): Promise<CliVersion | null>;
+export type CliVersionStatus = 'ok' | 'drift' | 'unknown';
+export interface CliVersionCheck {
+    status: CliVersionStatus;
+    /** A line ready for the daemon's startup banner. */
+    message: string;
+    actual: CliVersion | null;
+    expected: string;
+}
+/**
+ * Compare the live CLI against {@link EXPECTED_CLI_VERSION}.
+ *
+ * Only major/minor drift is reported. Patch releases move constantly and flagging them
+ * would train us to ignore the warning — the argv breakages we care about have landed on
+ * minor bumps. This never throws and never blocks: an unexpected version is still very
+ * likely to work, and refusing to start would be a worse failure than a noisy log line.
+ */
+export declare function checkCliVersion(actual: CliVersion | null, expected?: string): CliVersionCheck;
+//# sourceMappingURL=cliVersion.d.ts.map

package/node_modules/@lucidity/runtime/dist/executor/cliVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliVersion.d.ts","sourceRoot":"","sources":["../../src/executor/cliVersion.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAM9C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAUjE;AAED;;yFAEyF;AACzF,wBAAgB,eAAe,CAAC,OAAO,SAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAe9E;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,QAAQ,GAAE,MAA6B,GACtC,eAAe,CA4BjB"}

package/node_modules/@lucidity/runtime/dist/executor/cliVersion.js

@@ -0,0 +1,88 @@
+import { execFile } from 'node:child_process';
+/**
+ * The Claude Code CLI version this executor's flag surface was verified against.
+ *
+ * {@link import('./claudeCode.js').ClaudeCodeExecutor} drives the CLI by argv, and argv
+ * is an UNSTABLE surface that changes on a CLI auto-update with no commit on our side.
+ * That failure mode has already bitten us once: `--disallowedTools` became variadic in
+ * Claude Code 2.x and silently swallowed the trailing positional prompt, which broke Chat
+ * only (the code path skipped it via `--permission-mode`). It took three rounds to find
+ * because nothing in the logs said which CLI produced the bad turn.
+ *
+ * So the daemon probes the live version at startup, logs it, and warns on major/minor
+ * drift. The point is not to block — it is to leave a version line next to the next
+ * mystery turn failure.
+ *
+ * Bump this after re-verifying the flags built in `ClaudeCodeExecutor.run`/`runStream`.
+ */
+export const EXPECTED_CLI_VERSION = '2.1.220';
+/** How long to wait for `claude --version` before giving up. A wedged CLI must not
+ *  hold up daemon startup — an unknown version is a warning, not a failure. */
+const PROBE_TIMEOUT_MS = 5_000;
+/**
+ * Parse `claude --version` stdout. The CLI prints `2.1.220 (Claude Code)`, but we only
+ * anchor on the leading semver triple so a change to the trailing label can't break the
+ * probe — a version check that itself breaks on a CLI update would defeat its purpose.
+ * Returns null when no version can be found.
+ */
+export function parseCliVersion(stdout) {
+    const match = /(\d+)\.(\d+)\.(\d+)/.exec(stdout);
+    if (!match)
+        return null;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        version: `${match[1]}.${match[2]}.${match[3]}`,
+        raw: stdout.trim(),
+    };
+}
+/** Run `claude --version` and parse it. Resolves null on any failure (missing binary,
+ *  non-zero exit, timeout, unparseable output) — the caller treats that as "unknown",
+ *  and a genuinely missing CLI surfaces later with the executor's own ENOENT message. */
+export function probeCliVersion(command = 'claude') {
+    return new Promise((resolve) => {
+        execFile(command, ['--version'], { timeout: PROBE_TIMEOUT_MS }, (err, stdout) => {
+            if (err) {
+                resolve(null);
+                return;
+            }
+            resolve(parseCliVersion(stdout));
+        });
+    });
+}
+/**
+ * Compare the live CLI against {@link EXPECTED_CLI_VERSION}.
+ *
+ * Only major/minor drift is reported. Patch releases move constantly and flagging them
+ * would train us to ignore the warning — the argv breakages we care about have landed on
+ * minor bumps. This never throws and never blocks: an unexpected version is still very
+ * likely to work, and refusing to start would be a worse failure than a noisy log line.
+ */
+export function checkCliVersion(actual, expected = EXPECTED_CLI_VERSION) {
+    if (!actual) {
+        return {
+            status: 'unknown',
+            message: `claude CLI version unknown (probe failed; expected ~${expected})`,
+            actual: null,
+            expected,
+        };
+    }
+    const want = parseCliVersion(expected);
+    const drifted = !want || actual.major !== want.major || actual.minor !== want.minor;
+    if (drifted) {
+        return {
+            status: 'drift',
+            message: `claude CLI ${actual.version} differs from the verified ${expected} — ` +
+                `argv flags are unverified on this version; re-check the executor if turns misbehave`,
+            actual,
+            expected,
+        };
+    }
+    return {
+        status: 'ok',
+        message: `claude CLI ${actual.version}`,
+        actual,
+        expected,
+    };
+}

package/node_modules/@lucidity/runtime/dist/executor/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * A base64 image attached to a run (a vision input). Sent to `claude -p` as a
+ * stream-json content block — exactly like a pasted image in interactive Claude
+ * Code — and never written to disk, so the conversational deny-list stays intact.
+ */
+export interface ExecutorImage {
+    /** IANA media type Anthropic vision accepts: `image/jpeg | image/png | image/gif | image/webp`. */
+    mediaType: string;
+    /** Raw base64 payload, with no `data:` URI prefix. */
+    dataBase64: string;
+}
+export interface ExecutorRunInput {
+    /** The main prompt (passed to `claude -p "<userPrompt>"`). */
+    userPrompt: string;
+    /** System prompt appended to the engine's default (`--append-system-prompt`). */
+    systemPrompt?: string;
+    /**
+     * Vision inputs. When present the run switches to `--input-format stream-json`
+     * and the prompt + images are sent as one user message with content blocks
+     * (image blocks first, then the text), just like a pasted image in interactive
+     * Claude Code. Nothing touches the filesystem, so a conversational run keeps its
+     * file/shell deny-list. Absent (the common case) → today's plain-text stdin path.
+     */
+    images?: ExecutorImage[];
+    /** Model alias or full id (`--model`). Falls back to the executor default. */
+    model?: string;
+    /** Reasoning-effort level (`--effort`): `low | medium | high | xhigh | max`.
+     *  Falls back to the executor default; unset leaves the CLI's own default. */
+    effort?: string;
+    /** Hard timeout in ms; the run is aborted/killed if exceeded. */
+    timeoutMs?: number;
+    /**
+     * Optional MCP tool wiring for *agentic* runs (later chunks). When set, the
+     * executor passes `--mcp-config` + `--strict-mcp-config` and auto-approves the
+     * listed tools. Chunk 0's briefing pre-fetches its data and leaves this unset,
+     * so the run makes no tool calls (no permission prompts, frugal, deterministic).
+     */
+    mcp?: {
+        /** Path to a hermetic MCP config JSON (see the daemon's generator, later). */
+        configPath: string;
+        /** Tool patterns to auto-approve, e.g. `["mcp__lucidity__*"]`. */
+        allowedTools?: string[];
+    };
+    /** Cooperative cancellation (e.g. daemon shutdown). */
+    signal?: AbortSignal;
+    /** Assign a specific session id (interactive chat, turn 1). */
+    sessionId?: string;
+    /** Resume an existing chat session by id (subsequent turns); systemPrompt/model are already bound. */
+    resume?: string;
+    /** Working directory for the run (the target repo for a coding turn, M7). */
+    cwd?: string;
+    /** Permission mode (`--permission-mode`), e.g. `"auto"` for agentic coding runs (M7). */
+    permissionMode?: 'default' | 'acceptEdits' | 'plan' | 'auto' | 'bypassPermissions';
+    /** Tools to pre-approve (`--allowedTools`), the static first filter before auto mode. */
+    allowedTools?: string[];
+}
+/** Streaming event from {@link AgentExecutor.runStream}. */
+export type ExecutorStreamEvent = {
+    type: 'delta';
+    text: string;
+} | {
+    type: 'tool_call';
+    name: string;
+    phase: 'start' | 'end';
+} | {
+    type: 'done';
+    text: string;
+    sessionId?: string;
+    costUsd?: number;
+};
+export interface ExecutorResult {
+    /** The model's text response. */
+    text: string;
+    /** Engine session id, when reported (e.g. Claude Code json output). */
+    sessionId?: string;
+    /** Run cost in USD, when reported. */
+    costUsd?: number;
+}
+/**
+ * The one seam between Lucid's brain (prompt assembly) and the underlying model
+ * engine. Free tier = {@link import('./claudeCode.js').ClaudeCodeExecutor}
+ * (`claude --print` on the user's subscription). Later: an Anthropic-SDK executor
+ * (Pro) and a Codex executor (platform-risk hedge) — same prompts, different engine.
+ */
+export interface AgentExecutor {
+    /** Stable id for logs, e.g. `"claude-code"`. */
+    readonly name: string;
+    run(input: ExecutorRunInput): Promise<ExecutorResult>;
+    /** Optional token-streaming variant for interactive chat. */
+    runStream?(input: ExecutorRunInput): AsyncIterable<ExecutorStreamEvent>;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@lucidity/runtime/dist/executor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/executor/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,mGAAmG;IACnG,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;kFAC8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,GAAG,CAAC,EAAE;QACJ,8EAA8E;QAC9E,UAAU,EAAE,MAAM,CAAC;QACnB,kEAAkE;QAClE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,uDAAuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,cAAc,CAAC,EACX,SAAS,GACT,aAAa,GACb,MAAM,GACN,MAAM,GACN,mBAAmB,CAAC;IACxB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACtD,6DAA6D;IAC7D,SAAS,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;CACzE"}

package/node_modules/@lucidity/runtime/dist/executor/types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@lucidity/runtime/dist/harness/index.d.ts

@@ -0,0 +1,45 @@
+import type { AgentExecutor } from '../executor/types.js';
+import type { JournalSource, LucidHarness } from './types.js';
+export type { AskInput, BriefingInput, HarnessReply, JournalQuery, JournalResult, JournalSource, LucidHarness, } from './types.js';
+export interface LucidHarnessDeps {
+    /** The model engine. Free = ClaudeCodeExecutor; Pro = a hosted SDK executor. */
+    executor: AgentExecutor;
+    /** Persona/system text (SOUL.md or the packaged default). */
+    persona: string;
+    /** Optional run-log/DB source for journal reads (transport supplies it). */
+    journalSource?: JournalSource;
+    /**
+     * Scoped MCP tool wiring for the chat/ask path (the "Lucidity agent" tier). When
+     * present, `ask`/`askStream` pass it to the executor and the system prompt tells
+     * Lucid it can act; when absent, the prompt says it has no tools. Never enables
+     * raw file/shell — the executor still denies those (scoped MCP only).
+     */
+    mcp?: {
+        configPath: string;
+        allowedTools?: string[];
+    };
+    /** Which capability groups `mcp` exposes, for an accurate tools statement. */
+    capabilities?: {
+        tasks: boolean;
+        memory: boolean;
+    };
+    /**
+     * Raw shell + file access for the interactive chat (task #330 "Puny God"). When set,
+     * `ask`/`askStream` run in `cwd` under this `permissionMode` — dropping the executor's
+     * conversational deny-list so Lucid gets Bash/Write/Edit — and the tools note says so.
+     * Absent = the caged default. Only the chat methods honour it; `briefing`/`attentionBoard`
+     * never pass it, so the unattended cron jobs stay tool-less.
+     */
+    agent?: {
+        permissionMode: 'auto' | 'bypassPermissions';
+        cwd: string;
+    };
+}
+/**
+ * Build the one callable surface the transports invoke (#249). Each method
+ * assembles an EXISTING prompt builder and runs it through the AgentExecutor, so
+ * the daemon and the hosted server never duplicate prompt logic — they share
+ * this. `ask`/`briefing` are model-backed; `journal` is a pass-through read.
+ */
+export declare function createLucidHarness(deps: LucidHarnessDeps): LucidHarness;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@lucidity/runtime/dist/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAIV,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,QAAQ,EAAE,aAAa,CAAC;IACxB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;OAKG;IACH,GAAG,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtD,8EAA8E;IAC9E,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD;;;;;;OAMG;IACH,KAAK,CAAC,EAAE;QAAE,cAAc,EAAE,MAAM,GAAG,mBAAmB,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CA2IvE"}

package/node_modules/@lucidity/runtime/dist/harness/index.js

@@ -0,0 +1,132 @@
+import { buildBriefingPrompt, buildAttentionBoardPrompt, parseBoards, } from '../prompts/briefing.js';
+import { buildChatSystemPrompt, buildChatToolsNote } from '../prompts/chat.js';
+/**
+ * Build the one callable surface the transports invoke (#249). Each method
+ * assembles an EXISTING prompt builder and runs it through the AgentExecutor, so
+ * the daemon and the hosted server never duplicate prompt logic — they share
+ * this. `ask`/`briefing` are model-backed; `journal` is a pass-through read.
+ */
+export function createLucidHarness(deps) {
+    const { executor, persona, journalSource, mcp, capabilities, agent } = deps;
+    function askPrompts(input) {
+        const systemPrompt = buildChatSystemPrompt({
+            persona,
+            user: { name: input.user.name },
+            memory: input.memory,
+            notes: input.notes,
+            journal: input.journal,
+            context: input.context,
+            tools: buildChatToolsNote(input.user.name, !!mcp, capabilities, agent ? { cwd: agent.cwd } : undefined),
+        });
+        return { systemPrompt, userPrompt: input.prompt, images: input.images };
+    }
+    function briefingPrompts(input) {
+        return buildBriefingPrompt({
+            user: input.user,
+            tasks: input.tasks,
+            flagged: input.flagged,
+            persona,
+            now: input.now,
+            memory: input.memory,
+            notes: input.notes,
+        });
+    }
+    function streamFn() {
+        if (!executor.runStream) {
+            throw new Error(`Executor "${executor.name}" does not support streaming.`);
+        }
+        return executor.runStream.bind(executor);
+    }
+    return {
+        async ask(input) {
+            const { systemPrompt, userPrompt, images } = askPrompts(input);
+            const result = await executor.run({
+                systemPrompt,
+                userPrompt,
+                images,
+                model: input.model,
+                effort: input.effort,
+                timeoutMs: input.timeoutMs,
+                signal: input.signal,
+                resume: input.resume,
+                mcp,
+                permissionMode: agent?.permissionMode,
+                cwd: agent?.cwd,
+            });
+            return {
+                text: result.text,
+                sessionId: result.sessionId,
+                costUsd: result.costUsd,
+            };
+        },
+        askStream(input) {
+            const run = streamFn();
+            const { systemPrompt, userPrompt, images } = askPrompts(input);
+            return run({
+                systemPrompt,
+                userPrompt,
+                images,
+                model: input.model,
+                effort: input.effort,
+                timeoutMs: input.timeoutMs,
+                signal: input.signal,
+                resume: input.resume,
+                mcp,
+                permissionMode: agent?.permissionMode,
+                cwd: agent?.cwd,
+            });
+        },
+        async briefing(input) {
+            const { systemPrompt, userPrompt } = briefingPrompts(input);
+            const result = await executor.run({
+                systemPrompt,
+                userPrompt,
+                model: input.model,
+                timeoutMs: input.timeoutMs,
+                signal: input.signal,
+            });
+            return {
+                text: result.text,
+                sessionId: result.sessionId,
+                costUsd: result.costUsd,
+            };
+        },
+        briefingStream(input) {
+            const run = streamFn();
+            const { systemPrompt, userPrompt } = briefingPrompts(input);
+            return run({
+                systemPrompt,
+                userPrompt,
+                model: input.model,
+                timeoutMs: input.timeoutMs,
+                signal: input.signal,
+            });
+        },
+        async attentionBoard(input) {
+            const { systemPrompt, userPrompt } = buildAttentionBoardPrompt({
+                user: input.user,
+                tasks: input.tasks,
+                flagged: input.flagged,
+                persona,
+                now: input.now,
+                memory: input.memory,
+                notes: input.notes,
+            });
+            const result = await executor.run({
+                systemPrompt,
+                userPrompt,
+                model: input.model,
+                timeoutMs: input.timeoutMs,
+                signal: input.signal,
+            });
+            // The board-only prompt has no delimiter to split on — its whole output is boards.
+            return { boards: parseBoards(result.text), costUsd: result.costUsd };
+        },
+        async journal(query = {}) {
+            if (!journalSource) {
+                throw new Error('This harness has no journal source configured.');
+            }
+            return journalSource.read(query);
+        },
+    };
+}

package/node_modules/@lucidity/runtime/dist/harness/types.d.ts

@@ -0,0 +1,88 @@
+import type { Task, User, JournalEntry } from '@lucidity/shared';
+import type { ExecutorImage, ExecutorStreamEvent } from '../executor/types.js';
+import type { AttentionBoardEntry } from '../prompts/briefing.js';
+/**
+ * The callable harness seam (M6). It wraps the existing prompt builders so the
+ * transports — the local daemon gateway (free) and the hosted server (Pro) —
+ * invoke ONE surface and run identical prompts through the {@link AgentExecutor}.
+ * No prompt logic lives here; this only assembles existing builders and executes.
+ */
+export interface AskInput {
+    user: Pick<User, 'name'>;
+    /** The one-shot question ("Ask Lucid"). */
+    prompt: string;
+    /** Optional photos attached to the question — sent to the model as vision inputs. */
+    images?: ExecutorImage[];
+    /** Durable facts (MEMORY.md), woven into the system prompt when present. */
+    memory?: string;
+    /** Bounded recent-notes digest from the vault. */
+    notes?: string;
+    /** Bounded digest of recent journal days — see BuildChatSystemPromptInput.journal. */
+    journal?: string;
+    /** Extra session context, e.g. a snapshot of today's tasks. */
+    context?: string;
+    model?: string;
+    /** Reasoning-effort (`--effort`) for this turn. Falls back to the executor default. */
+    effort?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    /** Claude Code session id to --resume, for conversation continuity across turns. */
+    resume?: string;
+}
+export interface BriefingInput {
+    /** Flagged-important tasks, independent of due date and hierarchy (#320). */
+    flagged?: Task[];
+    user: Pick<User, 'name' | 'email'>;
+    /** Tasks due today or overdue (e.g. `GET /api/tasks/today`). */
+    tasks: Task[];
+    /** Reference "now" for the date header + overdue detection. */
+    now?: Date;
+    memory?: string;
+    notes?: string;
+    model?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+/** A buffered reply from a model-backed capability (ask/briefing). */
+export interface HarnessReply {
+    text: string;
+    sessionId?: string;
+    costUsd?: number;
+}
+export interface JournalQuery {
+    /** Max entries (newest first). */
+    limit?: number;
+    /** ISO cursor echoed from a prior page's `nextBefore`. */
+    before?: string;
+}
+export interface JournalResult {
+    entries: JournalEntry[];
+    nextBefore?: string;
+}
+/**
+ * A transport-supplied source of Lucid's past runs. The runtime is stateless and
+ * owns no storage, so journal reads delegate here: the daemon plugs in its run
+ * log, the hosted server plugs in a DB. The harness just exposes a uniform read.
+ */
+export interface JournalSource {
+    read(query: JournalQuery): Promise<JournalResult>;
+}
+/** The one surface both transports call. */
+export interface LucidHarness {
+    ask(input: AskInput): Promise<HarnessReply>;
+    askStream(input: AskInput): AsyncIterable<ExecutorStreamEvent>;
+    briefing(input: BriefingInput): Promise<HarnessReply>;
+    briefingStream(input: BriefingInput): AsyncIterable<ExecutorStreamEvent>;
+    /**
+     * Write just the phone's attention board (#320) — the same context a briefing reads, rendered
+     * as the two sentences that go on the Dashboard card. Used when the phone pulls a fresh board;
+     * the scheduled briefing gets its board out of its own turn instead, via `withBoard`.
+     */
+    attentionBoard(input: BriefingInput): Promise<{
+        boards: AttentionBoardEntry[];
+        costUsd?: number;
+    }>;
+    /** Read the agent journal. Throws if no {@link JournalSource} was configured. */
+    journal(query?: JournalQuery): Promise<JournalResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@lucidity/runtime/dist/harness/types.d.ts.map

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

package/node_modules/@lucidity/runtime/dist/harness/types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@lucidity/runtime/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { buildBriefingPrompt, buildAttentionBoardPrompt, splitBriefingOutput, parseBoards, BOARD_DELIMITER, FLAGGED_PRIORITY_MAX, } from './prompts/briefing.js';
+export type { BuildBriefingPromptInput, BriefingPrompt, AttentionBoardEntry } from './prompts/briefing.js';
+export { buildMemoryReflectionPrompt } from './prompts/reflection.js';
+export type { BuildMemoryReflectionPromptInput, ReflectionPrompt } from './prompts/reflection.js';
+export { buildChatSystemPrompt, buildChatToolsNote } from './prompts/chat.js';
+export type { BuildChatSystemPromptInput } from './prompts/chat.js';
+export { buildExtractionPrompt, parseExtractionOutput, locateQuote, resolveObservations, } from './prompts/extraction.js';
+export type { BuildExtractionPromptInput, ExtractionPrompt, ExtractionCatalogue, CatalogueEntry, RawObservation, ResolvedObservation, ResolveResult, } from './prompts/extraction.js';
+export { buildJournalDigest } from './journal/digest.js';
+export type { BuildJournalDigestInput, JournalDigest, DigestDay, DigestSegment, } from './journal/digest.js';
+export { loadJournalContext } from './journal/context.js';
+export type { LoadJournalContextOptions } from './journal/context.js';
+export { buildWeeklyReviewPrompt } from './prompts/weeklyReview.js';
+export type { BuildWeeklyReviewPromptInput, WeeklyReviewPrompt, WeeklyReviewStats, } from './prompts/weeklyReview.js';
+export { parseFacts, mergeFacts, renderMemoryFile } from './memory/merge.js';
+export { loadDefaultPersona } from './persona/index.js';
+export type { AgentExecutor, ExecutorRunInput, ExecutorResult, ExecutorStreamEvent } from './executor/types.js';
+export { ClaudeCodeExecutor } from './executor/claudeCode.js';
+export type { ClaudeCodeExecutorOptions } from './executor/claudeCode.js';
+export { EXPECTED_CLI_VERSION, checkCliVersion, parseCliVersion, probeCliVersion, } from './executor/cliVersion.js';
+export type { CliVersion, CliVersionCheck, CliVersionStatus } from './executor/cliVersion.js';
+export { createLucidHarness } from './harness/index.js';
+export type { LucidHarnessDeps, LucidHarness, AskInput, BriefingInput, HarnessReply, JournalQuery, JournalResult, JournalSource, } from './harness/index.js';
+export { createApiClient } from './client.js';
+export type { ApiClient, ApiClientConfig } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@lucidity/runtime/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,wBAAwB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EAAE,gCAAgC,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EACV,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/node_modules/@lucidity/runtime/dist/index.js

@@ -0,0 +1,18 @@
+// Prompt assembly (Lucid's "brain" — pure, stateless)
+export { buildBriefingPrompt, buildAttentionBoardPrompt, splitBriefingOutput, parseBoards, BOARD_DELIMITER, FLAGGED_PRIORITY_MAX, } from './prompts/briefing.js';
+export { buildMemoryReflectionPrompt } from './prompts/reflection.js';
+export { buildChatSystemPrompt, buildChatToolsNote } from './prompts/chat.js';
+export { buildExtractionPrompt, parseExtractionOutput, locateQuote, resolveObservations, } from './prompts/extraction.js';
+export { buildJournalDigest } from './journal/digest.js';
+export { loadJournalContext } from './journal/context.js';
+export { buildWeeklyReviewPrompt } from './prompts/weeklyReview.js';
+// Memory (durable facts) — pure helpers
+export { parseFacts, mergeFacts, renderMemoryFile } from './memory/merge.js';
+// Persona
+export { loadDefaultPersona } from './persona/index.js';
+export { ClaudeCodeExecutor } from './executor/claudeCode.js';
+export { EXPECTED_CLI_VERSION, checkCliVersion, parseCliVersion, probeCliVersion, } from './executor/cliVersion.js';
+// Harness seam — the one callable surface both transports invoke (ask/briefing/journal)
+export { createLucidHarness } from './harness/index.js';
+// API client
+export { createApiClient } from './client.js';

package/node_modules/@lucidity/runtime/dist/journal/context.d.ts

@@ -0,0 +1,23 @@
+import type { ApiClient } from '../client.js';
+import { type JournalDigest } from './digest.js';
+/**
+ * Fetching the journal and reducing it to something a prompt can hold.
+ *
+ * Deliberately in `packages/runtime` rather than the daemon. Two callers want exactly this —
+ * chat memory (#374) and the weekly review (#372) — and a second copy in the daemon is how the
+ * two quietly diverge on the one thing that has to be consistent: which words get read, the
+ * raw ones or the corrected ones.
+ *
+ * Never throws. A journal that can't be fetched should make Lucid slightly less informed, not
+ * make the chat turn fail — the same reasoning as `loadNotesContext` warning and returning
+ * undefined.
+ */
+export interface LoadJournalContextOptions {
+    /** How many recent days to consider. The digest then decides what actually fits. */
+    days?: number;
+    /** The question being asked, so relevant older days can outrank merely recent ones. */
+    query?: string;
+    maxChars?: number;
+}
+export declare function loadJournalContext(api: ApiClient, options?: LoadJournalContextOptions): Promise<JournalDigest | undefined>;
+//# sourceMappingURL=context.d.ts.map

package/node_modules/@lucidity/runtime/dist/journal/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/journal/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAsB,KAAK,aAAa,EAAkB,MAAM,aAAa,CAAC;AAErF;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,yBAAyB;IACxC,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmBD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAkDpC"}