@timurproko/a1 0.1.8-dev.de7821a → 0.2.0

package/dist/src/foundation/owned-ui-settings/declarations.js

@@ -1,39 +0,0 @@
-export const OWNED_UI_SETTINGS_VERSION = 1;
-const MAX_ID_LENGTH = 64;
-const ID_PATTERN = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/;
-export const OWNED_UI_SETTING_DECLARATIONS = Object.freeze([
-    Object.freeze({
-        id: "transcriptDensity",
-        description: "Vertical density of transcript content. Reserved for the custom-viewport milestone; no visible effect yet.",
-        application: "live",
-        defaultValue: "comfortable",
-        allowedValues: Object.freeze(["comfortable", "compact"]),
-    }),
-]);
-export function assertOwnedUiSettingDeclarations(declarations) {
-    const seen = new Set();
-    for (const declaration of declarations) {
-        if (!ID_PATTERN.test(declaration.id) || declaration.id.length > MAX_ID_LENGTH) {
-            throw new Error(`owned UI setting id is not a bounded camelCase identifier: ${declaration.id}`);
-        }
-        if (seen.has(declaration.id))
-            throw new Error(`duplicate owned UI setting id: ${declaration.id}`);
-        seen.add(declaration.id);
-        if (declaration.description.trim().length === 0) {
-            throw new Error(`owned UI setting has no description: ${declaration.id}`);
-        }
-        if (declaration.allowedValues.length === 0) {
-            throw new Error(`owned UI setting declares no allowed values: ${declaration.id}`);
-        }
-        const types = new Set(declaration.allowedValues.map(value => typeof value));
-        if (types.size !== 1) {
-            throw new Error(`owned UI setting mixes allowed value types: ${declaration.id}`);
-        }
-        if (!declaration.allowedValues.includes(declaration.defaultValue)) {
-            throw new Error(`owned UI setting default is not an allowed value: ${declaration.id}`);
-        }
-    }
-}
-export function findOwnedUiSettingDeclaration(declarations, id) {
-    return declarations.find(declaration => declaration.id === id) ?? null;
-}

package/dist/src/foundation/owned-ui-settings/index.d.ts

@@ -1,6 +0,0 @@
-export * from "./declarations.js";
-export * from "./migrations.js";
-export * from "./resolution.js";
-export * from "./sections.js";
-export * from "./session.js";
-export * from "./store.js";

package/dist/src/foundation/owned-ui-settings/index.js

@@ -1,6 +0,0 @@
-export * from "./declarations.js";
-export * from "./migrations.js";
-export * from "./resolution.js";
-export * from "./sections.js";
-export * from "./session.js";
-export * from "./store.js";

package/dist/src/foundation/owned-ui-settings/migrations.d.ts

@@ -1,13 +0,0 @@
-export interface OwnedUiSettingsMigration {
-    /** Version this migration produces. A migration from N-1 declares `to: N`. */
-    readonly to: number;
-    readonly description: string;
-    migrate(values: Readonly<Record<string, unknown>>): Record<string, unknown>;
-}
-/**
- * Ordered, contiguous migrations ending at OWNED_UI_SETTINGS_VERSION. Version 1
- * is the first stored shape, so nothing precedes it and the list is empty.
- */
-export declare const OWNED_UI_SETTINGS_MIGRATIONS: readonly OwnedUiSettingsMigration[];
-export declare function assertOwnedUiSettingsMigrations(migrations: readonly OwnedUiSettingsMigration[], currentVersion?: number): void;
-export declare function migrationsFrom(migrations: readonly OwnedUiSettingsMigration[], storedVersion: number): readonly OwnedUiSettingsMigration[];

package/dist/src/foundation/owned-ui-settings/migrations.js

@@ -1,28 +0,0 @@
-import { OWNED_UI_SETTINGS_VERSION } from "./declarations.js";
-/**
- * Ordered, contiguous migrations ending at OWNED_UI_SETTINGS_VERSION. Version 1
- * is the first stored shape, so nothing precedes it and the list is empty.
- */
-export const OWNED_UI_SETTINGS_MIGRATIONS = Object.freeze([]);
-export function assertOwnedUiSettingsMigrations(migrations, currentVersion = OWNED_UI_SETTINGS_VERSION) {
-    const firstProduced = currentVersion - migrations.length + 1;
-    if (migrations.length > 0 && firstProduced < 2) {
-        throw new Error("owned UI settings migrations cannot produce a version below 2");
-    }
-    migrations.forEach((migration, index) => {
-        const expected = firstProduced + index;
-        if (migration.to !== expected) {
-            throw new Error(`owned UI settings migration ${index} produces version ${migration.to}, expected ${expected}`);
-        }
-        if (migration.description.trim().length === 0) {
-            throw new Error(`owned UI settings migration to version ${migration.to} has no description`);
-        }
-    });
-    const last = migrations.at(-1);
-    if (last && last.to !== currentVersion) {
-        throw new Error(`owned UI settings migrations end at version ${last.to}, expected ${currentVersion}`);
-    }
-}
-export function migrationsFrom(migrations, storedVersion) {
-    return migrations.filter(migration => migration.to > storedVersion);
-}

package/dist/src/foundation/owned-ui-settings/sections.d.ts

@@ -1,70 +0,0 @@
-import type { OwnedUiSettingValue } from "./declarations.js";
-import type { OwnedUiSettingsResolution } from "./resolution.js";
-export type OwnedUiSettingsBackend = "a1" | "agent";
-export interface OwnedUiSettingsEntry {
-    readonly id: string;
-    /** Label to show, when its source provides one. Falls back to the id. */
-    readonly label: string | null;
-    readonly backend: OwnedUiSettingsBackend;
-    readonly description: string | null;
-    /** Present when the value is a scalar the surface can offer as a choice. */
-    readonly value: OwnedUiSettingValue | null;
-    /** Raw value as reported by its backend, for entries the surface can only display. */
-    readonly rawValue: unknown;
-    readonly editable: boolean;
-    readonly choices: readonly OwnedUiSettingValue[] | null;
-    /** True when the value is a structured object edited through its own surface. */
-    readonly structured: boolean;
-    /** Limits a numeric setting accepts, when the engine states them. */
-    readonly minimum: number | null;
-    readonly maximum: number | null;
-    /** Flags that surface offers, declared by the source rather than by the value. */
-    readonly flags: readonly {
-        readonly key: string;
-        readonly label: string;
-        readonly description: string;
-        readonly fallback: boolean;
-    }[];
-    readonly origin: "default" | "stored" | "engine";
-    readonly application: "live" | "restart" | "engine";
-}
-export interface OwnedUiSettingsSection {
-    readonly id: string;
-    readonly title: string;
-    readonly entries: readonly OwnedUiSettingsEntry[];
-    /** Set when the section could not be built; entries is then empty. */
-    readonly unavailableReason: string | null;
-    /** Set when the section is present but nothing in it can be changed here. */
-    readonly readOnlyReason: string | null;
-}
-export interface AgentSettingsSnapshot {
-    readonly descriptors: readonly {
-        readonly key: string;
-        readonly valueType: "boolean" | "number" | "string" | "enum" | "json";
-        readonly writable: boolean;
-        readonly choices?: readonly unknown[];
-        readonly label?: string;
-        readonly description?: string;
-        readonly minimum?: number;
-        readonly maximum?: number;
-        readonly flags?: readonly {
-            readonly key: string;
-            readonly label: string;
-            readonly description: string;
-            readonly fallback: boolean;
-        }[];
-    }[];
-    readonly values: Readonly<Record<string, unknown>>;
-    /** Whether the engine advertises settings write capability at all. */
-    readonly writeAdvertised: boolean;
-    /** Set when the engine could not report its settings. */
-    readonly failure: string | null;
-}
-export interface BuildOwnedUiSettingsSectionsInput {
-    readonly resolution: OwnedUiSettingsResolution;
-    /** Null when no engine is attached, which is not a failure. */
-    readonly agent: AgentSettingsSnapshot | null;
-}
-export declare const AGENT_SECTION_ID = "agent";
-export declare function buildOwnedUiSettingsSections(input: BuildOwnedUiSettingsSectionsInput): readonly OwnedUiSettingsSection[];
-export declare function findOwnedUiSettingsEntry(sections: readonly OwnedUiSettingsSection[], id: string, backend: OwnedUiSettingsBackend): OwnedUiSettingsEntry | null;

package/dist/src/foundation/owned-ui-settings/sections.js

@@ -1,93 +0,0 @@
-export const AGENT_SECTION_ID = "agent";
-const BOOLEAN_CHOICES = Object.freeze([true, false]);
-export function buildOwnedUiSettingsSections(input) {
-    const ownedSection = {
-        id: "a1",
-        title: "A1",
-        entries: Object.freeze(input.resolution.settings.map(setting => ({
-            id: setting.declaration.id,
-            label: null,
-            backend: "a1",
-            description: setting.declaration.description,
-            value: setting.value,
-            rawValue: setting.value,
-            editable: true,
-            structured: false,
-            minimum: null,
-            maximum: null,
-            flags: [],
-            choices: setting.declaration.allowedValues,
-            origin: setting.source,
-            application: setting.declaration.application,
-        }))),
-        unavailableReason: null,
-        readOnlyReason: null,
-    };
-    return Object.freeze([ownedSection, agentSection(input.agent)]);
-}
-export function findOwnedUiSettingsEntry(sections, id, backend) {
-    for (const section of sections) {
-        const entry = section.entries.find(candidate => candidate.id === id && candidate.backend === backend);
-        if (entry)
-            return entry;
-    }
-    return null;
-}
-function agentSection(snapshot) {
-    if (snapshot === null) {
-        return frozenSection("Agent settings are unavailable because no agent engine is attached", null, []);
-    }
-    if (snapshot.failure !== null) {
-        return frozenSection(`Agent settings are unavailable: ${snapshot.failure}`, null, []);
-    }
-    if (snapshot.descriptors.length === 0) {
-        return frozenSection("The agent engine reported no settings", null, []);
-    }
-    const entries = snapshot.descriptors.map(descriptor => {
-        const raw = Object.hasOwn(snapshot.values, descriptor.key) ? snapshot.values[descriptor.key] : null;
-        return {
-            id: descriptor.key,
-            label: descriptor.label ?? null,
-            backend: "agent",
-            description: descriptor.description ?? null,
-            value: scalar(raw),
-            rawValue: raw,
-            // A structured value is editable through its own surface rather than a
-            // value menu, so it stays reachable instead of being reported as fixed.
-            editable: snapshot.writeAdvertised && descriptor.writable,
-            structured: descriptor.valueType === "json",
-            minimum: descriptor.minimum ?? null,
-            maximum: descriptor.maximum ?? null,
-            flags: descriptor.flags ?? [],
-            // A boolean is a two-value choice even when the engine names no choices,
-            // so it opens the same menu as any other enumerated setting.
-            choices: descriptor.valueType === "boolean" ? BOOLEAN_CHOICES : choicesOf(descriptor.choices),
-            origin: "engine",
-            application: "engine",
-        };
-    });
-    const readOnlyReason = snapshot.writeAdvertised
-        ? (entries.some(entry => entry.editable)
-            ? null
-            : "The agent engine reports no writable settings")
-        : "The agent engine does not support changing settings from this surface";
-    return {
-        id: AGENT_SECTION_ID,
-        title: "Agent",
-        entries: Object.freeze(entries),
-        unavailableReason: null,
-        readOnlyReason,
-    };
-}
-function frozenSection(unavailableReason, readOnlyReason, entries) {
-    return { id: AGENT_SECTION_ID, title: "Agent", entries: Object.freeze(entries), unavailableReason, readOnlyReason };
-}
-function scalar(value) {
-    return typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? value : null;
-}
-function choicesOf(choices) {
-    if (choices === undefined)
-        return null;
-    const scalars = choices.map(scalar).filter((choice) => choice !== null);
-    return scalars.length === choices.length ? Object.freeze(scalars) : null;
-}

package/dist/src/foundation/owned-ui-settings/session.d.ts

@@ -1,44 +0,0 @@
-import type { AgentSettingsPort } from "../agent-engine-contracts/index.js";
-import type { OwnedUiSettingValue } from "./declarations.js";
-import type { OwnedUiSettingsResolution } from "./resolution.js";
-import { type OwnedUiSettingsBackend, type OwnedUiSettingsSection } from "./sections.js";
-import type { OwnedUiSettingsStore } from "./store.js";
-export interface OwnedUiSettingsChangeOutcome {
-    readonly applied: boolean;
-    /** True when the value is stored but only takes effect on the next start. */
-    readonly pendingRestart: boolean;
-    /** Present when the change could not be persisted; the surface must not show it as saved. */
-    readonly failure: string | null;
-}
-export interface OwnedUiSettingsSessionOptions {
-    readonly store: OwnedUiSettingsStore;
-    /** Null when no engine is attached; the Agent section then reports itself unavailable. */
-    readonly agent?: AgentSettingsPort | null;
-    /**
-     * Resolves the port at load time instead of construction time, for an engine
-     * whose runtime is not up yet. Takes precedence over `agent`.
-     */
-    readonly agentProvider?: () => AgentSettingsPort | null;
-}
-export type OwnedUiSettingsListener = (session: OwnedUiSettingsSession) => void;
-/**
- * Holds the resolved settings for one owned UI session and routes every accepted
- * change to the backend that owns it: A1 settings to the A1 document, agent
- * settings to the engine settings port. Neither backend ever sees the other's value.
- */
-export declare class OwnedUiSettingsSession {
-    #private;
-    constructor(options: OwnedUiSettingsSessionOptions);
-    get resolution(): OwnedUiSettingsResolution;
-    /** Reads the engine's settings so the Agent section can be built. Never throws. */
-    load(): Promise<void>;
-    sections(): readonly OwnedUiSettingsSection[];
-    /** Resolved value of an A1 setting, or null when it is not declared. */
-    value(id: string): OwnedUiSettingValue | null;
-    /** Value stored this session but not yet in effect, for a restart-required setting. */
-    pendingValue(id: string): OwnedUiSettingValue | null;
-    onChange(listener: OwnedUiSettingsListener): () => void;
-    /** Writes a structured value, which only an engine-backed setting can hold. */
-    changeStructured(backend: OwnedUiSettingsBackend, id: string, value: Readonly<Record<string, unknown>>): Promise<OwnedUiSettingsChangeOutcome>;
-    change(backend: OwnedUiSettingsBackend, id: string, value: OwnedUiSettingValue): Promise<OwnedUiSettingsChangeOutcome>;
-}

package/dist/src/foundation/owned-ui-settings/session.js

@@ -1,145 +0,0 @@
-import { buildOwnedUiSettingsSections, findOwnedUiSettingsEntry, } from "./sections.js";
-/**
- * Holds the resolved settings for one owned UI session and routes every accepted
- * change to the backend that owns it: A1 settings to the A1 document, agent
- * settings to the engine settings port. Neither backend ever sees the other's value.
- */
-export class OwnedUiSettingsSession {
-    #store;
-    #agent;
-    #agentProvider;
-    #listeners = new Set();
-    #resolution;
-    #agentSnapshot = null;
-    #pending = new Map();
-    constructor(options) {
-        this.#store = options.store;
-        this.#agent = options.agent ?? null;
-        this.#agentProvider = options.agentProvider ?? null;
-        this.#resolution = options.store.read();
-    }
-    get resolution() {
-        return this.#resolution;
-    }
-    /** Reads the engine's settings so the Agent section can be built. Never throws. */
-    async load() {
-        this.#resolution = this.#store.read();
-        const agent = this.#agentProvider === null ? this.#agent : this.#agentProvider();
-        this.#agentSnapshot = agent === null ? null : await snapshotOf(agent);
-        this.#notify();
-    }
-    sections() {
-        return buildOwnedUiSettingsSections({ resolution: this.#resolution, agent: this.#agentSnapshot });
-    }
-    /** Resolved value of an A1 setting, or null when it is not declared. */
-    value(id) {
-        return this.#resolution.settings.find(setting => setting.declaration.id === id)?.value ?? null;
-    }
-    /** Value stored this session but not yet in effect, for a restart-required setting. */
-    pendingValue(id) {
-        return this.#pending.get(id) ?? null;
-    }
-    onChange(listener) {
-        this.#listeners.add(listener);
-        return () => this.#listeners.delete(listener);
-    }
-    /** Writes a structured value, which only an engine-backed setting can hold. */
-    async changeStructured(backend, id, value) {
-        if (backend !== "agent")
-            return failed("only an agent setting holds a structured value");
-        const agent = this.#agentProvider === null ? this.#agent : this.#agentProvider();
-        if (agent === null)
-            return failed("no agent engine is attached");
-        if (!agent.capabilities.write || !agent.writeSetting) {
-            return failed("the agent engine does not support changing settings from this surface");
-        }
-        try {
-            await agent.writeSetting(id, value);
-            if (agent.capabilities.flush && agent.flush)
-                await agent.flush();
-        }
-        catch (error) {
-            return failed(`${id} could not be written to the agent engine: ${describe(error)}`);
-        }
-        this.#agentSnapshot = await snapshotOf(agent);
-        this.#notify();
-        return { applied: true, pendingRestart: false, failure: null };
-    }
-    async change(backend, id, value) {
-        const entry = findOwnedUiSettingsEntry(this.sections(), id, backend);
-        if (entry === null)
-            return failed(`unknown ${backend} setting: ${id}`);
-        if (!entry.editable)
-            return failed(`${id} is not editable from this surface`);
-        return backend === "a1" ? this.#changeOwned(id, value) : await this.#changeAgent(id, value);
-    }
-    #changeOwned(id, value) {
-        const outcome = this.#store.write(this.#resolution, id, value);
-        if (!outcome.stored)
-            return failed(outcome.failure ?? `${id} could not be stored`);
-        const previous = this.#resolution;
-        this.#resolution = this.#store.read();
-        const declaration = previous.settings.find(setting => setting.declaration.id === id)?.declaration;
-        if (declaration?.application === "restart") {
-            this.#pending.set(id, value);
-            this.#resolution = previous;
-            this.#notify();
-            return { applied: false, pendingRestart: true, failure: null };
-        }
-        this.#pending.delete(id);
-        this.#notify();
-        return { applied: true, pendingRestart: false, failure: null };
-    }
-    async #changeAgent(id, value) {
-        const agent = this.#agentProvider === null ? this.#agent : this.#agentProvider();
-        if (agent === null)
-            return failed("no agent engine is attached");
-        if (!agent.capabilities.write || !agent.writeSetting) {
-            return failed("the agent engine does not support changing settings from this surface");
-        }
-        try {
-            await agent.writeSetting(id, value);
-            if (agent.capabilities.flush && agent.flush)
-                await agent.flush();
-        }
-        catch (error) {
-            return failed(`${id} could not be written to the agent engine: ${describe(error)}`);
-        }
-        this.#agentSnapshot = await snapshotOf(agent);
-        this.#notify();
-        return { applied: true, pendingRestart: false, failure: null };
-    }
-    #notify() {
-        for (const listener of this.#listeners)
-            listener(this);
-    }
-}
-async function snapshotOf(agent) {
-    try {
-        const descriptors = await agent.listSettings();
-        const values = {};
-        for (const descriptor of descriptors) {
-            try {
-                values[descriptor.key] = await agent.readSetting(descriptor.key) ?? null;
-            }
-            catch {
-                values[descriptor.key] = null;
-            }
-        }
-        return {
-            descriptors,
-            values,
-            writeAdvertised: agent.capabilities.write && typeof agent.writeSetting === "function",
-            failure: null,
-        };
-    }
-    catch (error) {
-        return { descriptors: [], values: {}, writeAdvertised: false, failure: describe(error) };
-    }
-}
-function failed(failure) {
-    return { applied: false, pendingRestart: false, failure };
-}
-function describe(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/src/foundation/owned-ui-settings/store.d.ts

@@ -1,28 +0,0 @@
-import { type OwnedUiSettingDeclaration, type OwnedUiSettingValue } from "./declarations.js";
-import { type OwnedUiSettingsMigration } from "./migrations.js";
-import { type OwnedUiSettingsResolution } from "./resolution.js";
-export interface OwnedUiSettingsStoreOptions {
-    /** A1 configuration root. Settings live under `<configDir>/settings/`. */
-    readonly configDir: string;
-    readonly profileId: string;
-    readonly declarations?: readonly OwnedUiSettingDeclaration[];
-    readonly migrations?: readonly OwnedUiSettingsMigration[];
-}
-export interface OwnedUiSettingsWriteOutcome {
-    readonly stored: boolean;
-    /** Present when the write failed; the caller must not report the change as saved. */
-    readonly failure: string | null;
-}
-export declare class OwnedUiSettingsStore {
-    #private;
-    constructor(options: OwnedUiSettingsStoreOptions);
-    get file(): string;
-    /** Reads and resolves. Never throws: every failure becomes a notice. */
-    read(): OwnedUiSettingsResolution;
-    /**
-     * Writes the resolved form with `id` set to `value`, preserving undeclared keys.
-     * Atomic: a temporary sibling is renamed over the target, so an interrupted
-     * write leaves either the complete previous document or the complete new one.
-     */
-    write(resolution: OwnedUiSettingsResolution, id: string, value: OwnedUiSettingValue): OwnedUiSettingsWriteOutcome;
-}

package/dist/src/foundation/owned-ui-settings/store.js

@@ -1,90 +0,0 @@
-import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import { OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING_DECLARATIONS, } from "./declarations.js";
-import { OWNED_UI_SETTINGS_MIGRATIONS } from "./migrations.js";
-import { documentFrom, parseOwnedUiSettingsDocument, resolveOwnedUiSettings, } from "./resolution.js";
-const PROFILE_ID_PATTERN = /^[a-z][a-z0-9-]{0,63}$/;
-const MAX_DOCUMENT_BYTES = 256 * 1024;
-export class OwnedUiSettingsStore {
-    #file;
-    #declarations;
-    #migrations;
-    constructor(options) {
-        if (!PROFILE_ID_PATTERN.test(options.profileId)) {
-            throw new Error(`owned UI settings profile id is not a bounded slug: ${options.profileId}`);
-        }
-        this.#file = path.join(path.resolve(options.configDir), "settings", `${options.profileId}.json`);
-        this.#declarations = options.declarations ?? OWNED_UI_SETTING_DECLARATIONS;
-        this.#migrations = options.migrations ?? OWNED_UI_SETTINGS_MIGRATIONS;
-    }
-    get file() {
-        return this.#file;
-    }
-    /** Reads and resolves. Never throws: every failure becomes a notice. */
-    read() {
-        let raw = null;
-        let unreadable = null;
-        try {
-            raw = readFileSync(this.#file, "utf8");
-        }
-        catch (error) {
-            if (!isMissing(error))
-                unreadable = `${this.#file} could not be read: ${describe(error)}`;
-        }
-        if (raw !== null && Buffer.byteLength(raw, "utf8") > MAX_DOCUMENT_BYTES) {
-            unreadable = `${this.#file} exceeds the ${MAX_DOCUMENT_BYTES}-byte settings limit and was ignored`;
-            raw = null;
-        }
-        const document = raw === null ? null : parseOwnedUiSettingsDocument(raw);
-        if (raw !== null && document === null && unreadable === null) {
-            unreadable = `${this.#file} is not a valid settings document and was ignored`;
-        }
-        return resolveOwnedUiSettings({
-            declarations: this.#declarations,
-            migrations: this.#migrations,
-            document,
-            ...(unreadable === null ? {} : { unreadableDetail: unreadable }),
-            currentVersion: OWNED_UI_SETTINGS_VERSION,
-        });
-    }
-    /**
-     * Writes the resolved form with `id` set to `value`, preserving undeclared keys.
-     * Atomic: a temporary sibling is renamed over the target, so an interrupted
-     * write leaves either the complete previous document or the complete new one.
-     */
-    write(resolution, id, value) {
-        const declaration = this.#declarations.find(candidate => candidate.id === id);
-        if (!declaration)
-            return { stored: false, failure: `unknown owned UI setting: ${id}` };
-        if (!declaration.allowedValues.includes(value)) {
-            return { stored: false, failure: `value ${JSON.stringify(value)} is not allowed for ${id}` };
-        }
-        const current = documentFrom(resolution);
-        const next = {
-            version: OWNED_UI_SETTINGS_VERSION,
-            values: { ...current.values, [id]: value },
-        };
-        const temporary = `${this.#file}.${process.pid}.tmp`;
-        try {
-            mkdirSync(path.dirname(this.#file), { recursive: true, mode: 0o700 });
-            writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
-            renameSync(temporary, this.#file);
-            return { stored: true, failure: null };
-        }
-        catch (error) {
-            try {
-                rmSync(temporary, { force: true });
-            }
-            catch {
-                // A leftover temporary file is inert: read() only ever opens the target path.
-            }
-            return { stored: false, failure: `${this.#file} could not be written: ${describe(error)}` };
-        }
-    }
-}
-function isMissing(error) {
-    return typeof error === "object" && error !== null && error.code === "ENOENT";
-}
-function describe(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/src/foundation/pi-component-adapter/components.d.ts

@@ -1,4 +0,0 @@
-import type { OwnedUiTranscriptBlock } from "../owned-ui-contracts/index.js";
-export declare function adaptPiUserMessage(block: OwnedUiTranscriptBlock, width: number): readonly string[];
-export declare function adaptPiAssistantMessage(block: OwnedUiTranscriptBlock, width: number): readonly string[];
-export declare function adaptPiToolExecution(block: OwnedUiTranscriptBlock, width: number, cwd: string): readonly string[];

package/dist/src/foundation/pi-component-adapter/components.js

@@ -1,64 +0,0 @@
-import { AssistantMessageComponent, ToolExecutionComponent, UserMessageComponent, } from "@earendil-works/pi-coding-agent";
-import { createTuiFacade, validatedAssistantMessage } from "./shell-components.js";
-import { ensurePiTheme } from "./theme.js";
-export function adaptPiUserMessage(block, width) {
-    requireBlock(block, "user");
-    ensurePiTheme();
-    return new UserMessageComponent(block.text).render(width);
-}
-export function adaptPiAssistantMessage(block, width) {
-    requireBlock(block, "assistant");
-    ensurePiTheme();
-    return new AssistantMessageComponent(validatedAssistantMessage(block), false).render(width);
-}
-export function adaptPiToolExecution(block, width, cwd) {
-    if (block.kind !== "tool-call" && block.kind !== "tool-result") {
-        throw new TypeError("Pi tool execution adaptation requires a tool block");
-    }
-    ensurePiTheme();
-    const payload = blockPayload(block);
-    const toolCallId = stringPayload(payload, "toolCallId") ?? block.id;
-    const toolName = stringPayload(payload, "toolName") ?? block.title ?? "tool";
-    const args = isRecord(payload.arguments) && "json" in payload.arguments ? payload.arguments.json : {};
-    const component = new ToolExecutionComponent(toolName, toolCallId, args, undefined, undefined, createTuiFacade({ getColumns: () => width, getRows: () => 24, requestRender() { } }), cwd);
-    if (block.status === "live")
-        component.markExecutionStarted();
-    component.setArgsComplete();
-    if (block.kind === "tool-result") {
-        component.updateResult({
-            content: [{ type: "text", text: block.text }],
-            isError: payload.isError === true,
-        });
-    }
-    return component.render(width);
-}
-function requireBlock(block, kind) {
-    if (block.kind !== kind)
-        throw new TypeError(`Pi component adaptation requires ${kind}, received ${block.kind}`);
-}
-function blockPayload(block) {
-    return isRecord(block.payload) ? block.payload : {};
-}
-function blockProvider(block) {
-    return stringPayload(blockPayload(block), "provider") ?? "openai";
-}
-function blockModel(block) {
-    return stringPayload(blockPayload(block), "model") ?? "gpt-5";
-}
-function stringPayload(payload, key) {
-    const value = payload[key];
-    return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-function emptyUsage() {
-    return {
-        input: 0,
-        output: 0,
-        cacheRead: 0,
-        cacheWrite: 0,
-        totalTokens: 0,
-        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-    };
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null;
-}

package/dist/src/foundation/pi-component-adapter/conformance.d.ts

@@ -1,17 +0,0 @@
-export interface PiComponentConformanceResult {
-    readonly component: "user-message" | "assistant-message" | "tool-execution";
-    readonly renderRows: number;
-    readonly width: number;
-}
-export interface PiComponentConformanceReport {
-    readonly packageName: "@earendil-works/pi-coding-agent";
-    readonly packageVersion: string;
-    readonly ownedUiContractVersion: number;
-    readonly componentResults: readonly PiComponentConformanceResult[];
-    readonly componentFamilies: readonly string[];
-}
-export declare class PiComponentConformanceError extends Error {
-    readonly stage: "theme" | "components";
-    constructor(stage: "theme" | "components", cause: unknown);
-}
-export declare function runPiComponentConformance(): Promise<PiComponentConformanceReport>;