apex-code 0.0.1-alpha.1 → 0.0.1-alpha.10

package/dist/testing/replay/runner.js

@@ -0,0 +1,406 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { InMemoryModelsStore, Type, } from "@earendil-works/pi-ai";
+import { Agent } from "apex-code-agent-core";
+import { AuthStorage } from "../../core/auth-storage.js";
+import { estimateTokens } from "../../core/compaction/compaction.js";
+import { installContextPipeline } from "../../core/context/pipeline.js";
+import { ModelRuntime } from "../../core/model-runtime.js";
+import { buildSessionContext, loadEntriesFromFile, SessionManager, } from "../../core/session-manager.js";
+import { buildSystemPrompt } from "../../core/system-prompt.js";
+import { createAllToolDefinitions } from "../../core/tools/index.js";
+import { buildReplayMetrics } from "./metrics.js";
+import { registerRecordedProvider } from "./recorded-provider.js";
+/**
+ * Dedicated eviction budget for the replay harness — deliberately **not** derived
+ * from the fixture model's `contextWindow` (`recorded-provider.ts` hardcodes
+ * `1_000_000` for unrelated reasons predating this pipeline, shared by every
+ * fixture in the corpus, and is not to be changed here). Feeding that real
+ * `contextWindow` through production's `evictionBudget` formula
+ * (`../../core/context/pipeline.ts`) would yield a budget of roughly 490,000 tokens
+ * — orders of magnitude above anything in this corpus, so eviction would never
+ * observably fire and the gate it is meant to measure would stay blind, which is
+ * exactly the gap this task closes.
+ *
+ * `1_000` was chosen empirically — measured directly against `replayCorpus()`, not
+ * estimated — against three constraints that all have to hold simultaneously:
+ *
+ *  - `tool-error-recovery.jsonl`'s single turn carries its entire ~759 tokens
+ *    (mostly the static system prompt/tool-schema prefix) under budget, so its
+ *    recorded `contextTokensByTurn: [759]` (`test/replay-runner.test.ts`) is
+ *    unaffected — confirmed unchanged at this budget.
+ *  - `heavy-tool-output.jsonl` carries a single ~8,400-token recoverable `read`
+ *    result — comfortably over budget, so it evicts, which is the fixture's
+ *    documented purpose ("Large deterministic result for eviction measurements",
+ *    `fixtures/corpus/README.md`). Measured post-eviction turn: 748 tokens.
+ *  - `long-tool-heavy.jsonl` accumulates roughly 14,300 evictable tokens by turn 20
+ *    across ten interleaved `read`/`grep` results. `1_000` was verified against
+ *    `REPLAY_EVICTION_BUDGET: 0` (the theoretical floor — evict every eligible
+ *    result unconditionally) and produces the *same* turn-20 result, 1,769 tokens
+ *    — an 88.4% drop from the pre-pipeline baseline of 15,272 — confirming `1_000`
+ *    already reaches that floor rather than under-evicting. A first pass at
+ *    `3_000` measured 3,195 (79.1%, just short of the phase's 80% per-fixture
+ *    goal); `1_000` was chosen after confirming the floor is actually lower.
+ *
+ * This constant governs replay measurement only; it has no effect on production,
+ * which always calls `evictionBudget` with the real model's `contextWindow`.
+ */
+export const REPLAY_EVICTION_BUDGET = 1_000;
+/**
+ * Builds a `ContractLookup` from the real production tool definitions — a second,
+ * independent call to `createAllToolDefinitions` alongside the one
+ * `productionPromptAndSchemas` already makes for the static-prompt baseline. Kept
+ * separate rather than threading that function's `definitions` out: the two
+ * concerns (building the static prompt/schema baseline vs. resolving a tool's
+ * contract for the pipeline) are unrelated, and `createAllToolDefinitions` is cheap
+ * and pure, so a second call costs nothing and keeps both call sites simple.
+ */
+function replayContractLookup(cwd) {
+    const definitions = createAllToolDefinitions(cwd);
+    return (name) => Reflect.get(definitions, name)?.contract;
+}
+function isVersionThreeHeader(entry) {
+    if (entry === null || typeof entry !== "object")
+        return false;
+    return Reflect.get(entry, "type") === "session" && Reflect.get(entry, "version") === 3;
+}
+function isSessionEntry(entry) {
+    if (entry === null || typeof entry !== "object")
+        return false;
+    const type = Reflect.get(entry, "type");
+    const id = Reflect.get(entry, "id");
+    const parentId = Reflect.get(entry, "parentId");
+    return (type !== "session" &&
+        typeof type === "string" &&
+        typeof id === "string" &&
+        (parentId === null || typeof parentId === "string"));
+}
+function validateSessionTree(entries) {
+    const ids = new Set();
+    const parentById = new Map();
+    let roots = 0;
+    for (const entry of entries) {
+        if (!entry || typeof entry.id !== "string" || ids.has(entry.id))
+            throw new Error("Replay session contains invalid or duplicate entry ids");
+        ids.add(entry.id);
+        parentById.set(entry.id, entry.parentId);
+        if (entry.parentId === null)
+            roots++;
+        else if (typeof entry.parentId !== "string")
+            throw new Error("Replay session contains an invalid parentId");
+    }
+    if (roots !== 1)
+        throw new Error("Replay session must contain exactly one tree root");
+    for (const entry of entries) {
+        if (entry.parentId !== null && !ids.has(entry.parentId))
+            throw new Error(`Replay session has missing parent ${entry.parentId}`);
+        const seen = new Set();
+        let current = entry.id;
+        while (current !== null) {
+            if (seen.has(current))
+                throw new Error("Replay session contains a parent cycle");
+            seen.add(current);
+            current = parentById.get(current) ?? null;
+        }
+    }
+}
+function isMessageEntry(entry) {
+    return entry.type === "message";
+}
+function selectedResponses(entries) {
+    return entries
+        .filter(isMessageEntry)
+        .map((entry) => entry.message)
+        .filter((message) => message.role === "assistant");
+}
+function selectedToolResults(entries) {
+    return entries
+        .filter(isMessageEntry)
+        .map((entry) => entry.message)
+        .filter((message) => message.role === "toolResult");
+}
+function selectedUserEntries(entries) {
+    return entries.filter(isMessageEntry).filter((entry) => entry.message.role === "user");
+}
+function toolCalls(responses) {
+    return responses.flatMap((message) => message.content.filter((part) => part.type === "toolCall"));
+}
+function createRecordedTools(calls, results) {
+    const resultByCallId = new Map(results.map((result) => [result.toolCallId, structuredClone(result)]));
+    const unconsumed = new Set(resultByCallId.keys());
+    const tools = [...new Set(calls.map((call) => call.name))].map((name) => ({
+        name,
+        label: `Recorded ${name}`,
+        description: "Replays a recorded tool result without external side effects.",
+        parameters: Type.Any(),
+        execute: async (toolCallId) => {
+            const result = resultByCallId.get(toolCallId);
+            if (!result)
+                throw new Error(`Missing recorded tool result for ${toolCallId}`);
+            unconsumed.delete(toolCallId);
+            if (result.isError) {
+                const text = result.content.find((part) => part.type === "text")?.text ?? "Recorded tool error";
+                throw new Error(text);
+            }
+            return {
+                content: structuredClone(result.content),
+                details: structuredClone(result.details),
+                usage: structuredClone(result.usage),
+                addedToolNames: structuredClone(result.addedToolNames),
+            };
+        },
+    }));
+    return {
+        tools,
+        assertExhausted() {
+            if (unconsumed.size > 0)
+                throw new Error(`Replay left ${unconsumed.size} tool result(s) unused`);
+        },
+    };
+}
+function assertResponsesMatch(actual, expected) {
+    if (actual.length !== expected.length) {
+        throw new Error(`Replayed ${actual.length} assistant response(s), expected ${expected.length}`);
+    }
+    for (const [index, response] of actual.entries()) {
+        if (JSON.stringify(response) !== JSON.stringify(expected[index])) {
+            throw new Error(`Replayed assistant response ${index + 1} does not match the recording`);
+        }
+    }
+}
+function assertToolResultsMatch(actual, expected) {
+    if (actual.length !== expected.length) {
+        throw new Error(`Replayed ${actual.length} tool result(s), expected ${expected.length}`);
+    }
+    for (const [index, result] of actual.entries()) {
+        const recorded = expected[index];
+        if (!recorded)
+            throw new Error(`Missing recorded tool result ${index + 1}`);
+        const { timestamp: _actualTimestamp, ...actualStable } = result;
+        const { timestamp: _recordedTimestamp, ...recordedStable } = recorded;
+        const actualComparable = { ...actualStable };
+        const recordedComparable = { ...recordedStable };
+        if (actualComparable.details === undefined ||
+            (typeof actualComparable.details === "object" && Object.keys(actualComparable.details ?? {}).length === 0))
+            delete actualComparable.details;
+        if (recordedComparable.details === undefined ||
+            (typeof recordedComparable.details === "object" && Object.keys(recordedComparable.details ?? {}).length === 0))
+            delete recordedComparable.details;
+        if (JSON.stringify(actualComparable) !== JSON.stringify(recordedComparable)) {
+            throw new Error(`Replayed tool result ${index + 1} does not match the recording`);
+        }
+    }
+}
+function productionPromptAndSchemas(toolNames) {
+    const definitions = createAllToolDefinitions("$HOME/replay-fixtures");
+    const defaultToolNames = ["read", "bash", "edit", "write"];
+    const selected = [...new Set([...defaultToolNames, ...toolNames])].sort().flatMap((name) => {
+        const definition = Reflect.get(definitions, name);
+        return definition && typeof definition === "object" ? [definition] : [];
+    });
+    const toolSnippets = Object.fromEntries(selected.flatMap((definition) => typeof definition.promptSnippet === "string" ? [[definition.name, definition.promptSnippet]] : []));
+    const promptGuidelines = selected.flatMap((definition) => definition.promptGuidelines ?? []);
+    return {
+        systemPrompt: buildSystemPrompt({
+            cwd: "$HOME/replay-fixtures",
+            customPrompt: "You are an expert coding assistant operating inside Apex Code.",
+            selectedTools: selected.map((definition) => definition.name),
+            toolSnippets,
+            promptGuidelines,
+        }),
+        tools: selected.map((definition) => ({
+            name: definition.name,
+            description: definition.description,
+            parameters: definition.parameters,
+        })),
+    };
+}
+export async function replay(filePath) {
+    let physicalLines;
+    try {
+        physicalLines = readFileSync(filePath, "utf8")
+            .split("\n")
+            .filter((line) => line.trim().length > 0)
+            .map((line) => JSON.parse(line));
+    }
+    catch (error) {
+        throw new Error(`Replay requires valid JSONL: ${filePath}`, { cause: error });
+    }
+    const fileEntries = loadEntriesFromFile(filePath);
+    if (physicalLines.length !== fileEntries.length)
+        throw new Error("Replay session contains an invalid physical line");
+    if (!isVersionThreeHeader(fileEntries[0])) {
+        throw new Error(`Replay requires a native version 3 session: ${filePath}`);
+    }
+    const rawEntries = fileEntries.slice(1);
+    const rawSessionEntries = rawEntries.filter(isSessionEntry);
+    if (rawSessionEntries.length !== rawEntries.length)
+        throw new Error("Replay session contains an invalid entry");
+    validateSessionTree(rawSessionEntries);
+    const sessionManager = SessionManager.open(filePath);
+    const entries = sessionManager.getBranch();
+    validateSessionTree(entries);
+    const responses = selectedResponses(entries);
+    const recordedToolResults = selectedToolResults(entries);
+    const users = selectedUserEntries(entries);
+    if (users.length === 0 || responses.length === 0)
+        throw new Error("Replay session must contain user and assistant messages");
+    const runtime = await ModelRuntime.create({
+        credentials: AuthStorage.inMemory(),
+        modelsPath: null,
+        modelsStore: new InMemoryModelsStore(),
+        allowModelNetwork: false,
+        refreshOnCreate: false,
+    });
+    const recorded = registerRecordedProvider(runtime, responses);
+    const recordedTools = createRecordedTools(toolCalls(responses), recordedToolResults);
+    const replayedResponses = [];
+    const replayedToolResults = [];
+    const contextTokensByTurn = [];
+    let turnsCompleted = 0;
+    const promptBaseline = productionPromptAndSchemas(recordedTools.tools.map((tool) => tool.name));
+    let networkCalls = 0;
+    const rejectNetwork = async () => {
+        networkCalls++;
+        throw new Error("Network access is disabled during replay");
+    };
+    const firstContext = buildSessionContext(entries, users[0]?.id);
+    const firstResponse = responses[0];
+    if (!firstResponse)
+        throw new Error("Replay session has no recorded response");
+    const agent = new Agent({
+        initialState: {
+            model: recorded.getModel(firstContext.model?.modelId ?? firstResponse.model),
+            systemPrompt: promptBaseline.systemPrompt,
+            tools: recordedTools.tools,
+        },
+        streamFn: (model, context, options) => runtime.streamSimple(model, context, { ...options, fetch: rejectNetwork }),
+        getApiKey: () => "offline-replay",
+        convertToLlm: (messages) => {
+            const converted = [];
+            for (const message of messages) {
+                if (message.role === "user") {
+                    converted.push({ role: "user", content: message.content, timestamp: message.timestamp });
+                    continue;
+                }
+                if (message.role === "assistant") {
+                    converted.push(message);
+                    continue;
+                }
+                if (message.role !== "toolResult")
+                    continue;
+                // Validate the call id is one this replay actually recorded, but send the
+                // *incoming* message — not a fresh lookup by id — so that whatever the
+                // context pipeline's eviction stage did to `message.content` upstream
+                // (in `transformContext`) is what reaches the provider request. Re-fetching
+                // the original recorded content here would silently discard eviction,
+                // since eviction never touches `recordedToolResults` itself (see
+                // `assertToolResultsMatch`, which intentionally still compares against the
+                // untouched recording).
+                const recordedResult = recordedToolResults.find((result) => result.toolCallId === message.toolCallId);
+                if (!recordedResult)
+                    throw new Error(`Missing recorded tool result for ${message.toolCallId}`);
+                converted.push(structuredClone(message));
+            }
+            return converted;
+        },
+        afterToolCall: async ({ toolCall }) => {
+            const result = recordedToolResults.find((candidate) => candidate.toolCallId === toolCall.id);
+            if (!result)
+                throw new Error(`Missing recorded tool result for ${toolCall.id}`);
+            return {
+                content: structuredClone(result.content),
+                details: result.details,
+                usage: result.usage,
+                isError: result.isError,
+            };
+        },
+        toolExecution: "sequential",
+    });
+    // Same pipeline `AgentSession` installs in production (`_installContextPipeline`
+    // in `core/agent-session.ts`), via the shared `installContextPipeline` — deferred
+    // -schema resolution ahead of every request, then tool-result eviction — so the
+    // replay gate can observe both. The contract lookup is built from the real
+    // production tool definitions; the budget is `REPLAY_EVICTION_BUDGET`, a
+    // dedicated constant documented above (not derived from the fixture model's
+    // `contextWindow`; see that constant's comment for why).
+    installContextPipeline(agent, {
+        contractLookup: replayContractLookup("$HOME/replay-fixtures"),
+        evictionBudget: () => REPLAY_EVICTION_BUDGET,
+    });
+    const contextsByTurn = [];
+    for (const user of users) {
+        const historical = buildSessionContext(entries, user.id);
+        const nextResponse = responses[recorded.requestCount];
+        if (!nextResponse)
+            throw new Error(`Missing recorded response for user turn ${contextTokensByTurn.length + 1}`);
+        agent.state.model = recorded.getModel(historical.model?.modelId ?? nextResponse.model);
+        agent.state.messages = historical.messages.slice(0, -1);
+        const requestStart = recorded.requestCount;
+        await agent.prompt(user.message);
+        const turnContexts = recorded.contexts.slice(requestStart);
+        const lastContext = turnContexts.at(-1);
+        if (!lastContext)
+            throw new Error(`User turn ${contextTokensByTurn.length + 1} made no provider request`);
+        const staticInputTokens = Math.ceil(`${promptBaseline.systemPrompt}\n${JSON.stringify(promptBaseline.tools)}`.length / 4);
+        contextTokensByTurn.push(staticInputTokens + lastContext.messages.reduce((total, message) => total + estimateTokens(message), 0));
+        // Normalize toolResult timestamps to the recorded value before exposing this
+        // turn's context, mirroring the same normalization the `toolResults` field
+        // below already does and for the same reason: a toolResult's timestamp is
+        // stamped live (via `agent.state.messages`) rather than replayed from the
+        // fixture, so leaving it as-is would make `contextsByTurn` — and anything
+        // that serializes it, like the determinism test below — flaky across runs.
+        // Content (what eviction may have rewritten) is untouched.
+        contextsByTurn.push(lastContext.messages.map((message) => message.role === "toolResult"
+            ? {
+                ...message,
+                timestamp: recordedToolResults.find((result) => result.toolCallId === message.toolCallId)?.timestamp ??
+                    message.timestamp,
+            }
+            : message));
+        for (const message of agent.state.messages.slice(historical.messages.length - 1)) {
+            if (message.role === "assistant")
+                replayedResponses.push(message);
+            if (message.role === "toolResult")
+                replayedToolResults.push(message);
+        }
+        const terminalResponse = replayedResponses.at(-1);
+        if (terminalResponse && terminalResponse.stopReason !== "error" && terminalResponse.stopReason !== "aborted") {
+            turnsCompleted++;
+        }
+    }
+    recorded.assertExhausted();
+    recordedTools.assertExhausted();
+    assertResponsesMatch(replayedResponses, responses);
+    assertToolResultsMatch(replayedToolResults, recordedToolResults);
+    return {
+        turns: users.length,
+        requests: recorded.requestCount,
+        networkCalls,
+        responses: replayedResponses,
+        toolResults: replayedToolResults.map((result, index) => ({
+            ...structuredClone(result),
+            timestamp: recordedToolResults[index]?.timestamp ?? result.timestamp,
+        })),
+        contextsByTurn,
+        metrics: buildReplayMetrics({
+            systemPrompt: promptBaseline.systemPrompt,
+            tools: promptBaseline.tools,
+            recordedResponses: responses,
+            replayedResponses,
+            contextTokensByTurn,
+            turnsCompleted,
+        }),
+    };
+}
+/** Replay every JSONL fixture in lexical order for byte-stable corpus output. */
+export async function replayCorpus(directory) {
+    const metrics = {};
+    for (const name of readdirSync(directory)
+        .filter((entry) => entry.endsWith(".jsonl"))
+        .sort()) {
+        metrics[name] = (await replay(join(directory, name))).metrics;
+    }
+    return metrics;
+}
+//# sourceMappingURL=runner.js.map

package/dist/testing/replay/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/testing/replay/runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdirSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport {\n\ttype AssistantMessage,\n\tInMemoryModelsStore,\n\ttype Message,\n\ttype Tool,\n\ttype ToolCall,\n\ttype ToolResultMessage,\n\tType,\n} from \"@earendil-works/pi-ai\";\nimport { Agent, type AgentTool, type AgentToolResult } from \"apex-code-agent-core\";\nimport { AuthStorage } from \"../../core/auth-storage.ts\";\nimport { estimateTokens } from \"../../core/compaction/compaction.ts\";\nimport type { ContractLookup } from \"../../core/context/eviction.ts\";\nimport { installContextPipeline } from \"../../core/context/pipeline.ts\";\nimport { ModelRuntime } from \"../../core/model-runtime.ts\";\nimport {\n\tbuildSessionContext,\n\tloadEntriesFromFile,\n\ttype SessionEntry,\n\ttype SessionHeader,\n\tSessionManager,\n\ttype SessionMessageEntry,\n} from \"../../core/session-manager.ts\";\nimport { buildSystemPrompt } from \"../../core/system-prompt.ts\";\nimport { createAllToolDefinitions, type ToolDef } from \"../../core/tools/index.ts\";\nimport { buildReplayMetrics, type ReplayMetrics } from \"./metrics.ts\";\nimport { registerRecordedProvider } from \"./recorded-provider.ts\";\n\nexport interface ReplayResult {\n\tturns: number;\n\trequests: number;\n\tnetworkCalls: number;\n\tresponses: AssistantMessage[];\n\ttoolResults: ToolResultMessage[];\n\tmetrics: ReplayMetrics;\n\t/**\n\t * The final outbound provider request's messages for each user turn — the same\n\t * array `contextTokensByTurn` is measured from, exposed so tests can assert\n\t * directly on context-pipeline effects (eviction markers, deferred schemas)\n\t * without reaching into `RecordedProvider` internals.\n\t */\n\tcontextsByTurn: Message[][];\n}\n\n/**\n * Dedicated eviction budget for the replay harness — deliberately **not** derived\n * from the fixture model's `contextWindow` (`recorded-provider.ts` hardcodes\n * `1_000_000` for unrelated reasons predating this pipeline, shared by every\n * fixture in the corpus, and is not to be changed here). Feeding that real\n * `contextWindow` through production's `evictionBudget` formula\n * (`../../core/context/pipeline.ts`) would yield a budget of roughly 490,000 tokens\n * — orders of magnitude above anything in this corpus, so eviction would never\n * observably fire and the gate it is meant to measure would stay blind, which is\n * exactly the gap this task closes.\n *\n * `1_000` was chosen empirically — measured directly against `replayCorpus()`, not\n * estimated — against three constraints that all have to hold simultaneously:\n *\n *  - `tool-error-recovery.jsonl`'s single turn carries its entire ~759 tokens\n *    (mostly the static system prompt/tool-schema prefix) under budget, so its\n *    recorded `contextTokensByTurn: [759]` (`test/replay-runner.test.ts`) is\n *    unaffected — confirmed unchanged at this budget.\n *  - `heavy-tool-output.jsonl` carries a single ~8,400-token recoverable `read`\n *    result — comfortably over budget, so it evicts, which is the fixture's\n *    documented purpose (\"Large deterministic result for eviction measurements\",\n *    `fixtures/corpus/README.md`). Measured post-eviction turn: 748 tokens.\n *  - `long-tool-heavy.jsonl` accumulates roughly 14,300 evictable tokens by turn 20\n *    across ten interleaved `read`/`grep` results. `1_000` was verified against\n *    `REPLAY_EVICTION_BUDGET: 0` (the theoretical floor — evict every eligible\n *    result unconditionally) and produces the *same* turn-20 result, 1,769 tokens\n *    — an 88.4% drop from the pre-pipeline baseline of 15,272 — confirming `1_000`\n *    already reaches that floor rather than under-evicting. A first pass at\n *    `3_000` measured 3,195 (79.1%, just short of the phase's 80% per-fixture\n *    goal); `1_000` was chosen after confirming the floor is actually lower.\n *\n * This constant governs replay measurement only; it has no effect on production,\n * which always calls `evictionBudget` with the real model's `contextWindow`.\n */\nexport const REPLAY_EVICTION_BUDGET = 1_000;\n\n/**\n * Builds a `ContractLookup` from the real production tool definitions — a second,\n * independent call to `createAllToolDefinitions` alongside the one\n * `productionPromptAndSchemas` already makes for the static-prompt baseline. Kept\n * separate rather than threading that function's `definitions` out: the two\n * concerns (building the static prompt/schema baseline vs. resolving a tool's\n * contract for the pipeline) are unrelated, and `createAllToolDefinitions` is cheap\n * and pure, so a second call costs nothing and keeps both call sites simple.\n */\nfunction replayContractLookup(cwd: string): ContractLookup {\n\tconst definitions = createAllToolDefinitions(cwd);\n\treturn (name) => (Reflect.get(definitions, name) as Partial<ToolDef> | undefined)?.contract;\n}\n\nfunction isVersionThreeHeader(entry: unknown): entry is SessionHeader & { version: 3 } {\n\tif (entry === null || typeof entry !== \"object\") return false;\n\treturn Reflect.get(entry, \"type\") === \"session\" && Reflect.get(entry, \"version\") === 3;\n}\n\nfunction isSessionEntry(entry: unknown): entry is SessionEntry {\n\tif (entry === null || typeof entry !== \"object\") return false;\n\tconst type = Reflect.get(entry, \"type\");\n\tconst id = Reflect.get(entry, \"id\");\n\tconst parentId = Reflect.get(entry, \"parentId\");\n\treturn (\n\t\ttype !== \"session\" &&\n\t\ttypeof type === \"string\" &&\n\t\ttypeof id === \"string\" &&\n\t\t(parentId === null || typeof parentId === \"string\")\n\t);\n}\n\nfunction validateSessionTree(entries: readonly SessionEntry[]): void {\n\tconst ids = new Set<string>();\n\tconst parentById = new Map<string, string | null>();\n\tlet roots = 0;\n\tfor (const entry of entries) {\n\t\tif (!entry || typeof entry.id !== \"string\" || ids.has(entry.id))\n\t\t\tthrow new Error(\"Replay session contains invalid or duplicate entry ids\");\n\t\tids.add(entry.id);\n\t\tparentById.set(entry.id, entry.parentId);\n\t\tif (entry.parentId === null) roots++;\n\t\telse if (typeof entry.parentId !== \"string\") throw new Error(\"Replay session contains an invalid parentId\");\n\t}\n\tif (roots !== 1) throw new Error(\"Replay session must contain exactly one tree root\");\n\tfor (const entry of entries) {\n\t\tif (entry.parentId !== null && !ids.has(entry.parentId))\n\t\t\tthrow new Error(`Replay session has missing parent ${entry.parentId}`);\n\t\tconst seen = new Set<string>();\n\t\tlet current: string | null = entry.id;\n\t\twhile (current !== null) {\n\t\t\tif (seen.has(current)) throw new Error(\"Replay session contains a parent cycle\");\n\t\t\tseen.add(current);\n\t\t\tcurrent = parentById.get(current) ?? null;\n\t\t}\n\t}\n}\n\nfunction isMessageEntry(entry: SessionEntry): entry is SessionMessageEntry {\n\treturn entry.type === \"message\";\n}\n\nfunction selectedResponses(entries: readonly SessionEntry[]): AssistantMessage[] {\n\treturn entries\n\t\t.filter(isMessageEntry)\n\t\t.map((entry) => entry.message)\n\t\t.filter((message): message is AssistantMessage => message.role === \"assistant\");\n}\n\nfunction selectedToolResults(entries: readonly SessionEntry[]): ToolResultMessage[] {\n\treturn entries\n\t\t.filter(isMessageEntry)\n\t\t.map((entry) => entry.message)\n\t\t.filter((message): message is ToolResultMessage => message.role === \"toolResult\");\n}\n\nfunction selectedUserEntries(entries: readonly SessionEntry[]): SessionMessageEntry[] {\n\treturn entries.filter(isMessageEntry).filter((entry) => entry.message.role === \"user\");\n}\n\nfunction toolCalls(responses: readonly AssistantMessage[]): ToolCall[] {\n\treturn responses.flatMap((message) => message.content.filter((part): part is ToolCall => part.type === \"toolCall\"));\n}\n\nfunction createRecordedTools(\n\tcalls: readonly ToolCall[],\n\tresults: readonly ToolResultMessage[],\n): { tools: AgentTool[]; assertExhausted(): void } {\n\tconst resultByCallId = new Map(results.map((result) => [result.toolCallId, structuredClone(result)]));\n\tconst unconsumed = new Set(resultByCallId.keys());\n\tconst tools = [...new Set(calls.map((call) => call.name))].map(\n\t\t(name): AgentTool => ({\n\t\t\tname,\n\t\t\tlabel: `Recorded ${name}`,\n\t\t\tdescription: \"Replays a recorded tool result without external side effects.\",\n\t\t\tparameters: Type.Any(),\n\t\t\texecute: async (toolCallId): Promise<AgentToolResult<unknown>> => {\n\t\t\t\tconst result = resultByCallId.get(toolCallId);\n\t\t\t\tif (!result) throw new Error(`Missing recorded tool result for ${toolCallId}`);\n\t\t\t\tunconsumed.delete(toolCallId);\n\t\t\t\tif (result.isError) {\n\t\t\t\t\tconst text = result.content.find((part) => part.type === \"text\")?.text ?? \"Recorded tool error\";\n\t\t\t\t\tthrow new Error(text);\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tcontent: structuredClone(result.content),\n\t\t\t\t\tdetails: structuredClone(result.details),\n\t\t\t\t\tusage: structuredClone(result.usage),\n\t\t\t\t\taddedToolNames: structuredClone(result.addedToolNames),\n\t\t\t\t};\n\t\t\t},\n\t\t}),\n\t);\n\treturn {\n\t\ttools,\n\t\tassertExhausted() {\n\t\t\tif (unconsumed.size > 0) throw new Error(`Replay left ${unconsumed.size} tool result(s) unused`);\n\t\t},\n\t};\n}\n\nfunction assertResponsesMatch(actual: readonly AssistantMessage[], expected: readonly AssistantMessage[]): void {\n\tif (actual.length !== expected.length) {\n\t\tthrow new Error(`Replayed ${actual.length} assistant response(s), expected ${expected.length}`);\n\t}\n\tfor (const [index, response] of actual.entries()) {\n\t\tif (JSON.stringify(response) !== JSON.stringify(expected[index])) {\n\t\t\tthrow new Error(`Replayed assistant response ${index + 1} does not match the recording`);\n\t\t}\n\t}\n}\n\nfunction assertToolResultsMatch(actual: readonly ToolResultMessage[], expected: readonly ToolResultMessage[]): void {\n\tif (actual.length !== expected.length) {\n\t\tthrow new Error(`Replayed ${actual.length} tool result(s), expected ${expected.length}`);\n\t}\n\tfor (const [index, result] of actual.entries()) {\n\t\tconst recorded = expected[index];\n\t\tif (!recorded) throw new Error(`Missing recorded tool result ${index + 1}`);\n\t\tconst { timestamp: _actualTimestamp, ...actualStable } = result;\n\t\tconst { timestamp: _recordedTimestamp, ...recordedStable } = recorded;\n\t\tconst actualComparable = { ...actualStable };\n\t\tconst recordedComparable = { ...recordedStable };\n\t\tif (\n\t\t\tactualComparable.details === undefined ||\n\t\t\t(typeof actualComparable.details === \"object\" && Object.keys(actualComparable.details ?? {}).length === 0)\n\t\t)\n\t\t\tdelete actualComparable.details;\n\t\tif (\n\t\t\trecordedComparable.details === undefined ||\n\t\t\t(typeof recordedComparable.details === \"object\" && Object.keys(recordedComparable.details ?? {}).length === 0)\n\t\t)\n\t\t\tdelete recordedComparable.details;\n\t\tif (JSON.stringify(actualComparable) !== JSON.stringify(recordedComparable)) {\n\t\t\tthrow new Error(`Replayed tool result ${index + 1} does not match the recording`);\n\t\t}\n\t}\n}\n\nfunction productionPromptAndSchemas(toolNames: readonly string[]): { systemPrompt: string; tools: Tool[] } {\n\tconst definitions = createAllToolDefinitions(\"$HOME/replay-fixtures\");\n\tconst defaultToolNames = [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst selected = [...new Set([...defaultToolNames, ...toolNames])].sort().flatMap((name) => {\n\t\tconst definition = Reflect.get(definitions, name);\n\t\treturn definition && typeof definition === \"object\" ? [definition] : [];\n\t});\n\tconst toolSnippets = Object.fromEntries(\n\t\tselected.flatMap((definition) =>\n\t\t\ttypeof definition.promptSnippet === \"string\" ? [[definition.name, definition.promptSnippet]] : [],\n\t\t),\n\t);\n\tconst promptGuidelines = selected.flatMap((definition) => definition.promptGuidelines ?? []);\n\treturn {\n\t\tsystemPrompt: buildSystemPrompt({\n\t\t\tcwd: \"$HOME/replay-fixtures\",\n\t\t\tcustomPrompt: \"You are an expert coding assistant operating inside Apex Code.\",\n\t\t\tselectedTools: selected.map((definition) => definition.name),\n\t\t\ttoolSnippets,\n\t\t\tpromptGuidelines,\n\t\t}),\n\t\ttools: selected.map((definition) => ({\n\t\t\tname: definition.name,\n\t\t\tdescription: definition.description,\n\t\t\tparameters: definition.parameters,\n\t\t})),\n\t};\n}\n\nexport async function replay(filePath: string): Promise<ReplayResult> {\n\tlet physicalLines: unknown[];\n\ttry {\n\t\tphysicalLines = readFileSync(filePath, \"utf8\")\n\t\t\t.split(\"\\n\")\n\t\t\t.filter((line) => line.trim().length > 0)\n\t\t\t.map((line) => JSON.parse(line));\n\t} catch (error) {\n\t\tthrow new Error(`Replay requires valid JSONL: ${filePath}`, { cause: error });\n\t}\n\tconst fileEntries = loadEntriesFromFile(filePath);\n\tif (physicalLines.length !== fileEntries.length) throw new Error(\"Replay session contains an invalid physical line\");\n\tif (!isVersionThreeHeader(fileEntries[0])) {\n\t\tthrow new Error(`Replay requires a native version 3 session: ${filePath}`);\n\t}\n\tconst rawEntries = fileEntries.slice(1);\n\tconst rawSessionEntries = rawEntries.filter(isSessionEntry);\n\tif (rawSessionEntries.length !== rawEntries.length) throw new Error(\"Replay session contains an invalid entry\");\n\tvalidateSessionTree(rawSessionEntries);\n\tconst sessionManager = SessionManager.open(filePath);\n\tconst entries = sessionManager.getBranch();\n\tvalidateSessionTree(entries);\n\tconst responses = selectedResponses(entries);\n\tconst recordedToolResults = selectedToolResults(entries);\n\tconst users = selectedUserEntries(entries);\n\tif (users.length === 0 || responses.length === 0)\n\t\tthrow new Error(\"Replay session must contain user and assistant messages\");\n\n\tconst runtime = await ModelRuntime.create({\n\t\tcredentials: AuthStorage.inMemory(),\n\t\tmodelsPath: null,\n\t\tmodelsStore: new InMemoryModelsStore(),\n\t\tallowModelNetwork: false,\n\t\trefreshOnCreate: false,\n\t});\n\tconst recorded = registerRecordedProvider(runtime, responses);\n\tconst recordedTools = createRecordedTools(toolCalls(responses), recordedToolResults);\n\tconst replayedResponses: AssistantMessage[] = [];\n\tconst replayedToolResults: ToolResultMessage[] = [];\n\tconst contextTokensByTurn: number[] = [];\n\tlet turnsCompleted = 0;\n\tconst promptBaseline = productionPromptAndSchemas(recordedTools.tools.map((tool) => tool.name));\n\tlet networkCalls = 0;\n\tconst rejectNetwork: typeof globalThis.fetch = async () => {\n\t\tnetworkCalls++;\n\t\tthrow new Error(\"Network access is disabled during replay\");\n\t};\n\tconst firstContext = buildSessionContext(entries, users[0]?.id);\n\tconst firstResponse = responses[0];\n\tif (!firstResponse) throw new Error(\"Replay session has no recorded response\");\n\tconst agent = new Agent({\n\t\tinitialState: {\n\t\t\tmodel: recorded.getModel(firstContext.model?.modelId ?? firstResponse.model),\n\t\t\tsystemPrompt: promptBaseline.systemPrompt,\n\t\t\ttools: recordedTools.tools,\n\t\t},\n\t\tstreamFn: (model, context, options) => runtime.streamSimple(model, context, { ...options, fetch: rejectNetwork }),\n\t\tgetApiKey: () => \"offline-replay\",\n\t\tconvertToLlm: (messages) => {\n\t\t\tconst converted: Message[] = [];\n\t\t\tfor (const message of messages) {\n\t\t\t\tif (message.role === \"user\") {\n\t\t\t\t\tconverted.push({ role: \"user\", content: message.content, timestamp: message.timestamp });\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (message.role === \"assistant\") {\n\t\t\t\t\tconverted.push(message);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (message.role !== \"toolResult\") continue;\n\t\t\t\t// Validate the call id is one this replay actually recorded, but send the\n\t\t\t\t// *incoming* message — not a fresh lookup by id — so that whatever the\n\t\t\t\t// context pipeline's eviction stage did to `message.content` upstream\n\t\t\t\t// (in `transformContext`) is what reaches the provider request. Re-fetching\n\t\t\t\t// the original recorded content here would silently discard eviction,\n\t\t\t\t// since eviction never touches `recordedToolResults` itself (see\n\t\t\t\t// `assertToolResultsMatch`, which intentionally still compares against the\n\t\t\t\t// untouched recording).\n\t\t\t\tconst recordedResult = recordedToolResults.find((result) => result.toolCallId === message.toolCallId);\n\t\t\t\tif (!recordedResult) throw new Error(`Missing recorded tool result for ${message.toolCallId}`);\n\t\t\t\tconverted.push(structuredClone(message));\n\t\t\t}\n\t\t\treturn converted;\n\t\t},\n\t\tafterToolCall: async ({ toolCall }) => {\n\t\t\tconst result = recordedToolResults.find((candidate) => candidate.toolCallId === toolCall.id);\n\t\t\tif (!result) throw new Error(`Missing recorded tool result for ${toolCall.id}`);\n\t\t\treturn {\n\t\t\t\tcontent: structuredClone(result.content),\n\t\t\t\tdetails: result.details,\n\t\t\t\tusage: result.usage,\n\t\t\t\tisError: result.isError,\n\t\t\t};\n\t\t},\n\t\ttoolExecution: \"sequential\",\n\t});\n\n\t// Same pipeline `AgentSession` installs in production (`_installContextPipeline`\n\t// in `core/agent-session.ts`), via the shared `installContextPipeline` — deferred\n\t// -schema resolution ahead of every request, then tool-result eviction — so the\n\t// replay gate can observe both. The contract lookup is built from the real\n\t// production tool definitions; the budget is `REPLAY_EVICTION_BUDGET`, a\n\t// dedicated constant documented above (not derived from the fixture model's\n\t// `contextWindow`; see that constant's comment for why).\n\tinstallContextPipeline(agent, {\n\t\tcontractLookup: replayContractLookup(\"$HOME/replay-fixtures\"),\n\t\tevictionBudget: () => REPLAY_EVICTION_BUDGET,\n\t});\n\n\tconst contextsByTurn: Message[][] = [];\n\tfor (const user of users) {\n\t\tconst historical = buildSessionContext(entries, user.id);\n\t\tconst nextResponse = responses[recorded.requestCount];\n\t\tif (!nextResponse) throw new Error(`Missing recorded response for user turn ${contextTokensByTurn.length + 1}`);\n\t\tagent.state.model = recorded.getModel(historical.model?.modelId ?? nextResponse.model);\n\t\tagent.state.messages = historical.messages.slice(0, -1);\n\t\tconst requestStart = recorded.requestCount;\n\t\tawait agent.prompt(user.message);\n\t\tconst turnContexts = recorded.contexts.slice(requestStart);\n\t\tconst lastContext = turnContexts.at(-1);\n\t\tif (!lastContext) throw new Error(`User turn ${contextTokensByTurn.length + 1} made no provider request`);\n\t\tconst staticInputTokens = Math.ceil(\n\t\t\t`${promptBaseline.systemPrompt}\\n${JSON.stringify(promptBaseline.tools)}`.length / 4,\n\t\t);\n\t\tcontextTokensByTurn.push(\n\t\t\tstaticInputTokens + lastContext.messages.reduce((total, message) => total + estimateTokens(message), 0),\n\t\t);\n\t\t// Normalize toolResult timestamps to the recorded value before exposing this\n\t\t// turn's context, mirroring the same normalization the `toolResults` field\n\t\t// below already does and for the same reason: a toolResult's timestamp is\n\t\t// stamped live (via `agent.state.messages`) rather than replayed from the\n\t\t// fixture, so leaving it as-is would make `contextsByTurn` — and anything\n\t\t// that serializes it, like the determinism test below — flaky across runs.\n\t\t// Content (what eviction may have rewritten) is untouched.\n\t\tcontextsByTurn.push(\n\t\t\tlastContext.messages.map((message) =>\n\t\t\t\tmessage.role === \"toolResult\"\n\t\t\t\t\t? {\n\t\t\t\t\t\t\t...message,\n\t\t\t\t\t\t\ttimestamp:\n\t\t\t\t\t\t\t\trecordedToolResults.find((result) => result.toolCallId === message.toolCallId)?.timestamp ??\n\t\t\t\t\t\t\t\tmessage.timestamp,\n\t\t\t\t\t\t}\n\t\t\t\t\t: message,\n\t\t\t),\n\t\t);\n\t\tfor (const message of agent.state.messages.slice(historical.messages.length - 1)) {\n\t\t\tif (message.role === \"assistant\") replayedResponses.push(message);\n\t\t\tif (message.role === \"toolResult\") replayedToolResults.push(message);\n\t\t}\n\t\tconst terminalResponse = replayedResponses.at(-1);\n\t\tif (terminalResponse && terminalResponse.stopReason !== \"error\" && terminalResponse.stopReason !== \"aborted\") {\n\t\t\tturnsCompleted++;\n\t\t}\n\t}\n\trecorded.assertExhausted();\n\trecordedTools.assertExhausted();\n\tassertResponsesMatch(replayedResponses, responses);\n\tassertToolResultsMatch(replayedToolResults, recordedToolResults);\n\n\treturn {\n\t\tturns: users.length,\n\t\trequests: recorded.requestCount,\n\t\tnetworkCalls,\n\t\tresponses: replayedResponses,\n\t\ttoolResults: replayedToolResults.map((result, index) => ({\n\t\t\t...structuredClone(result),\n\t\t\ttimestamp: recordedToolResults[index]?.timestamp ?? result.timestamp,\n\t\t})),\n\t\tcontextsByTurn,\n\t\tmetrics: buildReplayMetrics({\n\t\t\tsystemPrompt: promptBaseline.systemPrompt,\n\t\t\ttools: promptBaseline.tools,\n\t\t\trecordedResponses: responses,\n\t\t\treplayedResponses,\n\t\t\tcontextTokensByTurn,\n\t\t\tturnsCompleted,\n\t\t}),\n\t};\n}\n\n/** Replay every JSONL fixture in lexical order for byte-stable corpus output. */\nexport async function replayCorpus(directory: string): Promise<Record<string, ReplayMetrics>> {\n\tconst metrics: Record<string, ReplayMetrics> = {};\n\tfor (const name of readdirSync(directory)\n\t\t.filter((entry) => entry.endsWith(\".jsonl\"))\n\t\t.sort()) {\n\t\tmetrics[name] = (await replay(join(directory, name))).metrics;\n\t}\n\treturn metrics;\n}\n"]}

package/dist/themes/apex-logo.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The Apex Code brand mark, in the forms a terminal can actually render.
+ *
+ * Only the five-row block wordmark survives a monospace grid. Every monospace
+ * face leaves a hairline gap at the cell boundary, so a letterform two or three
+ * rows tall dissolves into texture rather than reading as a word. The mark
+ * therefore does not shrink: below the width the block form needs, it is
+ * replaced outright by a glyph-and-type lockup.
+ *
+ * A mark is a list of rows, each split into an accent run and a text run. That
+ * one shape covers both forms: the block wordmark puts its whole baseline row
+ * in the accent so the letters sit on an ember footing, and the inline lockup
+ * puts only its leading glyph there.
+ */
+export interface MarkRow {
+    /** Leading run, painted in the brand accent. */
+    readonly accent: string;
+    /** Trailing run, painted in the neutral text tone. */
+    readonly text: string;
+}
+export interface BrandMark {
+    readonly rows: readonly MarkRow[];
+    /** Widest row, in terminal columns. */
+    readonly width: number;
+}
+export type MarkSymbolPreset = "unicode" | "ascii";
+/** 5 rows x 30 columns. The brand mark, with the baseline row in the accent. */
+export declare const APEX_MARK_BLOCK: BrandMark;
+/** 1 row x 11 columns. Used when the block mark will not fit. */
+export declare const APEX_MARK_INLINE: BrandMark;
+/**
+ * 1 row x 12 columns. Honours `terminal.symbolPreset: "ascii"`, whose users
+ * opted out of block drawing because it renders badly for them. The previous
+ * ASCII mark was line-drawn art whose first letter was an O, so it read "OPEX".
+ */
+export declare const APEX_MARK_INLINE_ASCII: BrandMark;
+/** Pick the widest mark that fits. ASCII users always get the type lockup. */
+export declare function selectBrandMark(contentWidth: number, symbolPreset: MarkSymbolPreset): BrandMark;
+/** Wrap a mark supplied by a rebranding extension. It carries no accent run. */
+export declare function customBrandMark(logo: string): BrandMark;
+//# sourceMappingURL=apex-logo.d.ts.map

package/dist/themes/apex-logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apex-logo.d.ts","sourceRoot":"","sources":["../../src/themes/apex-logo.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,OAAO;IACvB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAiBnD,gFAAgF;AAChF,eAAO,MAAM,eAAe,WAI3B,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,WAA8C,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,WAAgD,CAAC;AAEpF,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,GAAG,SAAS,CAG/F;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEvD","sourcesContent":["import { visibleWidth } from \"@earendil-works/pi-tui\";\n\n/**\n * The Apex Code brand mark, in the forms a terminal can actually render.\n *\n * Only the five-row block wordmark survives a monospace grid. Every monospace\n * face leaves a hairline gap at the cell boundary, so a letterform two or three\n * rows tall dissolves into texture rather than reading as a word. The mark\n * therefore does not shrink: below the width the block form needs, it is\n * replaced outright by a glyph-and-type lockup.\n *\n * A mark is a list of rows, each split into an accent run and a text run. That\n * one shape covers both forms: the block wordmark puts its whole baseline row\n * in the accent so the letters sit on an ember footing, and the inline lockup\n * puts only its leading glyph there.\n */\n\nexport interface MarkRow {\n\t/** Leading run, painted in the brand accent. */\n\treadonly accent: string;\n\t/** Trailing run, painted in the neutral text tone. */\n\treadonly text: string;\n}\n\nexport interface BrandMark {\n\treadonly rows: readonly MarkRow[];\n\t/** Widest row, in terminal columns. */\n\treadonly width: number;\n}\n\nexport type MarkSymbolPreset = \"unicode\" | \"ascii\";\n\nfunction mark(rows: readonly MarkRow[]): BrandMark {\n\treturn {\n\t\trows,\n\t\twidth: rows.reduce((max, row) => Math.max(max, visibleWidth(row.accent + row.text)), 0),\n\t};\n}\n\nconst BLOCK_ROWS = [\n\t\" ▄▄▄▄▄  ▄▄▄▄▄▄  ▄▄▄▄▄▄ ▄▄   ▄▄\",\n\t\"██   ██ ██   ██ ██      ██ ██ \",\n\t\"███████ ██████  █████    ███  \",\n\t\"██   ██ ██      ██      ██ ██ \",\n\t\"▀▀   ▀▀ ▀▀      ▀▀▀▀▀▀ ▀▀   ▀▀\",\n];\n\n/** 5 rows x 30 columns. The brand mark, with the baseline row in the accent. */\nexport const APEX_MARK_BLOCK = mark(\n\tBLOCK_ROWS.map((row, index) =>\n\t\tindex === BLOCK_ROWS.length - 1 ? { accent: row, text: \"\" } : { accent: \"\", text: row },\n\t),\n);\n\n/** 1 row x 11 columns. Used when the block mark will not fit. */\nexport const APEX_MARK_INLINE = mark([{ accent: \"◤\", text: \" apex code\" }]);\n\n/**\n * 1 row x 12 columns. Honours `terminal.symbolPreset: \"ascii\"`, whose users\n * opted out of block drawing because it renders badly for them. The previous\n * ASCII mark was line-drawn art whose first letter was an O, so it read \"OPEX\".\n */\nexport const APEX_MARK_INLINE_ASCII = mark([{ accent: \"/\\\\\", text: \" apex code\" }]);\n\n/** Pick the widest mark that fits. ASCII users always get the type lockup. */\nexport function selectBrandMark(contentWidth: number, symbolPreset: MarkSymbolPreset): BrandMark {\n\tif (symbolPreset === \"ascii\") return APEX_MARK_INLINE_ASCII;\n\treturn contentWidth >= APEX_MARK_BLOCK.width ? APEX_MARK_BLOCK : APEX_MARK_INLINE;\n}\n\n/** Wrap a mark supplied by a rebranding extension. It carries no accent run. */\nexport function customBrandMark(logo: string): BrandMark {\n\treturn mark(logo.split(\"\\n\").map((row) => ({ accent: \"\", text: row })));\n}\n"]}

package/dist/themes/apex-logo.js

@@ -0,0 +1,35 @@
+import { visibleWidth } from "@earendil-works/pi-tui";
+function mark(rows) {
+    return {
+        rows,
+        width: rows.reduce((max, row) => Math.max(max, visibleWidth(row.accent + row.text)), 0),
+    };
+}
+const BLOCK_ROWS = [
+    " ▄▄▄▄▄  ▄▄▄▄▄▄  ▄▄▄▄▄▄ ▄▄   ▄▄",
+    "██   ██ ██   ██ ██      ██ ██ ",
+    "███████ ██████  █████    ███  ",
+    "██   ██ ██      ██      ██ ██ ",
+    "▀▀   ▀▀ ▀▀      ▀▀▀▀▀▀ ▀▀   ▀▀",
+];
+/** 5 rows x 30 columns. The brand mark, with the baseline row in the accent. */
+export const APEX_MARK_BLOCK = mark(BLOCK_ROWS.map((row, index) => index === BLOCK_ROWS.length - 1 ? { accent: row, text: "" } : { accent: "", text: row }));
+/** 1 row x 11 columns. Used when the block mark will not fit. */
+export const APEX_MARK_INLINE = mark([{ accent: "◤", text: " apex code" }]);
+/**
+ * 1 row x 12 columns. Honours `terminal.symbolPreset: "ascii"`, whose users
+ * opted out of block drawing because it renders badly for them. The previous
+ * ASCII mark was line-drawn art whose first letter was an O, so it read "OPEX".
+ */
+export const APEX_MARK_INLINE_ASCII = mark([{ accent: "/\\", text: " apex code" }]);
+/** Pick the widest mark that fits. ASCII users always get the type lockup. */
+export function selectBrandMark(contentWidth, symbolPreset) {
+    if (symbolPreset === "ascii")
+        return APEX_MARK_INLINE_ASCII;
+    return contentWidth >= APEX_MARK_BLOCK.width ? APEX_MARK_BLOCK : APEX_MARK_INLINE;
+}
+/** Wrap a mark supplied by a rebranding extension. It carries no accent run. */
+export function customBrandMark(logo) {
+    return mark(logo.split("\n").map((row) => ({ accent: "", text: row })));
+}
+//# sourceMappingURL=apex-logo.js.map

package/dist/themes/apex-logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apex-logo.js","sourceRoot":"","sources":["../../src/themes/apex-logo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAgCtD,SAAS,IAAI,CAAC,IAAwB,EAAa;IAClD,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;KACvF,CAAC;AAAA,CACF;AAED,MAAM,UAAU,GAAG;IAClB,0EAAgC;IAChC,4DAAgC;IAChC,0EAAgC;IAChC,wDAAgC;IAChC,gEAAgC;CAChC,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAClC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAC7B,KAAK,KAAK,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CACvF,CACD,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,KAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAEpF,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,YAAoB,EAAE,YAA8B,EAAa;IAChG,IAAI,YAAY,KAAK,OAAO;QAAE,OAAO,sBAAsB,CAAC;IAC5D,OAAO,YAAY,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC;AAAA,CAClF;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,IAAY,EAAa;IACxD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAAA,CACxE","sourcesContent":["import { visibleWidth } from \"@earendil-works/pi-tui\";\n\n/**\n * The Apex Code brand mark, in the forms a terminal can actually render.\n *\n * Only the five-row block wordmark survives a monospace grid. Every monospace\n * face leaves a hairline gap at the cell boundary, so a letterform two or three\n * rows tall dissolves into texture rather than reading as a word. The mark\n * therefore does not shrink: below the width the block form needs, it is\n * replaced outright by a glyph-and-type lockup.\n *\n * A mark is a list of rows, each split into an accent run and a text run. That\n * one shape covers both forms: the block wordmark puts its whole baseline row\n * in the accent so the letters sit on an ember footing, and the inline lockup\n * puts only its leading glyph there.\n */\n\nexport interface MarkRow {\n\t/** Leading run, painted in the brand accent. */\n\treadonly accent: string;\n\t/** Trailing run, painted in the neutral text tone. */\n\treadonly text: string;\n}\n\nexport interface BrandMark {\n\treadonly rows: readonly MarkRow[];\n\t/** Widest row, in terminal columns. */\n\treadonly width: number;\n}\n\nexport type MarkSymbolPreset = \"unicode\" | \"ascii\";\n\nfunction mark(rows: readonly MarkRow[]): BrandMark {\n\treturn {\n\t\trows,\n\t\twidth: rows.reduce((max, row) => Math.max(max, visibleWidth(row.accent + row.text)), 0),\n\t};\n}\n\nconst BLOCK_ROWS = [\n\t\" ▄▄▄▄▄  ▄▄▄▄▄▄  ▄▄▄▄▄▄ ▄▄   ▄▄\",\n\t\"██   ██ ██   ██ ██      ██ ██ \",\n\t\"███████ ██████  █████    ███  \",\n\t\"██   ██ ██      ██      ██ ██ \",\n\t\"▀▀   ▀▀ ▀▀      ▀▀▀▀▀▀ ▀▀   ▀▀\",\n];\n\n/** 5 rows x 30 columns. The brand mark, with the baseline row in the accent. */\nexport const APEX_MARK_BLOCK = mark(\n\tBLOCK_ROWS.map((row, index) =>\n\t\tindex === BLOCK_ROWS.length - 1 ? { accent: row, text: \"\" } : { accent: \"\", text: row },\n\t),\n);\n\n/** 1 row x 11 columns. Used when the block mark will not fit. */\nexport const APEX_MARK_INLINE = mark([{ accent: \"◤\", text: \" apex code\" }]);\n\n/**\n * 1 row x 12 columns. Honours `terminal.symbolPreset: \"ascii\"`, whose users\n * opted out of block drawing because it renders badly for them. The previous\n * ASCII mark was line-drawn art whose first letter was an O, so it read \"OPEX\".\n */\nexport const APEX_MARK_INLINE_ASCII = mark([{ accent: \"/\\\\\", text: \" apex code\" }]);\n\n/** Pick the widest mark that fits. ASCII users always get the type lockup. */\nexport function selectBrandMark(contentWidth: number, symbolPreset: MarkSymbolPreset): BrandMark {\n\tif (symbolPreset === \"ascii\") return APEX_MARK_INLINE_ASCII;\n\treturn contentWidth >= APEX_MARK_BLOCK.width ? APEX_MARK_BLOCK : APEX_MARK_INLINE;\n}\n\n/** Wrap a mark supplied by a rebranding extension. It carries no accent run. */\nexport function customBrandMark(logo: string): BrandMark {\n\treturn mark(logo.split(\"\\n\").map((row) => ({ accent: \"\", text: row })));\n}\n"]}

package/dist/utils/apex-code-user-agent.d.ts

@@ -0,0 +1,2 @@
+export declare function getApexCodeUserAgent(version: string): string;
+//# sourceMappingURL=apex-code-user-agent.d.ts.map

package/dist/utils/apex-code-user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apex-code-user-agent.d.ts","sourceRoot":"","sources":["../../src/utils/apex-code-user-agent.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5D","sourcesContent":["export function getApexCodeUserAgent(version: string): string {\n\tconst runtime = process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`;\n\treturn `apex-code/${version} (${process.platform}; ${runtime}; ${process.arch})`;\n}\n"]}

package/dist/utils/apex-code-user-agent.js

@@ -0,0 +1,5 @@
+export function getApexCodeUserAgent(version) {
+    const runtime = process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`;
+    return `apex-code/${version} (${process.platform}; ${runtime}; ${process.arch})`;
+}
+//# sourceMappingURL=apex-code-user-agent.js.map

package/dist/utils/apex-code-user-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apex-code-user-agent.js","sourceRoot":"","sources":["../../src/utils/apex-code-user-agent.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAU;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;IACjG,OAAO,aAAa,OAAO,KAAK,OAAO,CAAC,QAAQ,KAAK,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC;AAAA,CACjF","sourcesContent":["export function getApexCodeUserAgent(version: string): string {\n\tconst runtime = process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`;\n\treturn `apex-code/${version} (${process.platform}; ${runtime}; ${process.arch})`;\n}\n"]}

package/dist/utils/changelog.d.ts

@@ -2,12 +2,15 @@ export interface ChangelogEntry {
     major: number;
     minor: number;
     patch: number;
+    /** Prerelease identifier without the leading dash, e.g. "alpha.4". Absent on stable releases. */
+    prerelease?: string;
     content: string;
 }
 export declare function normalizeChangelogLinks(markdown: string, version: string | ChangelogEntry): string;
 /**
  * Parse changelog entries from CHANGELOG.md
- * Scans for ## lines and collects content until next ## or EOF
+ * Scans for ## lines and collects content until next ## or EOF.
+ * Stops at the upstream history heading — those entries are attribution, not Apex Code releases.
  */
 export declare function parseChangelog(changelogPath: string): ChangelogEntry[];
 /**
@@ -15,7 +18,9 @@ export declare function parseChangelog(changelogPath: string): ChangelogEntry[];
  */
 export declare function compareVersions(v1: ChangelogEntry, v2: ChangelogEntry): number;
 /**
- * Get entries newer than lastVersion
+ * Get entries newer than lastVersion.
+ * An unparseable lastVersion yields nothing: replaying the entire changelog on every launch
+ * is a far worse failure than staying quiet about one upgrade.
  */
 export declare function getNewEntries(entries: ChangelogEntry[], lastVersion: string): ChangelogEntry[];
 export { getChangelogPath } from "../config.ts";