@timurproko/a1 0.1.8-dev.472 → 0.1.8-dev.508

package/dist/integrations/pi/components/upstream/components/first-time-setup.js

@@ -1,105 +0,0 @@
-// Mechanically adapted from Pi commit 914cf14
-// packages/coding-agent/src/modes/interactive/components/first-time-setup.ts (MIT).
-// Local modifications: remap private imports to public package-root or owned theme boundaries.
-import { Container, getKeybindings, Spacer, Text } from "#pi-tui";
-import { DynamicBorder, keyHint, rawKeyHint } from "../../../startup-public.js";
-import { piTheme } from "../theme/theme.js";
-const APP_NAME = "pi";
-const THEME_OPTIONS = [
-    { value: "dark", label: "Dark" },
-    { value: "light", label: "Light" },
-];
-const ANALYTICS_OPTIONS = [
-    { value: true, label: "Share anonymous usage data" },
-    { value: false, label: "Don't share" },
-];
-const SETUP_LOGO_LINES = ["██████", "██  ██", "████  ██", "██    ██"];
-/** First-time setup dialog: theme choice and analytics opt-in. */
-export class FirstTimeSetupComponent extends Container {
-    step = "theme";
-    themeIndex;
-    analyticsIndex = 0;
-    options;
-    constructor(options) {
-        super();
-        this.options = options;
-        this.themeIndex = Math.max(0, THEME_OPTIONS.findIndex((option) => option.value === options.detectedTheme));
-        this.update();
-    }
-    // Rebuild the whole dialog on every change so theme previews recolor all text.
-    update() {
-        this.clear();
-        this.addChild(new DynamicBorder());
-        this.addChild(new Spacer(1));
-        this.addChild(new Text(piTheme().fg("accent", SETUP_LOGO_LINES.join("\n")), 1, 0));
-        this.addChild(new Spacer(1));
-        this.addChild(new Text(piTheme().fg("accent", piTheme().bold(`Welcome to ${APP_NAME}, the minimal coding agent.`)), 1, 0));
-        this.addChild(new Spacer(1));
-        if (this.step === "theme") {
-            this.addChild(new Text(piTheme().fg("text", "Pick a theme."), 1, 0));
-            this.addChild(new Text(piTheme().fg("muted", `Detected system appearance: ${this.options.detectedTheme}`), 1, 0));
-            this.addChild(new Spacer(1));
-            this.addOptionList(THEME_OPTIONS.map((option) => option.label), this.themeIndex);
-        }
-        else {
-            this.addChild(new Text(piTheme().fg("text", "Opt-in to anonymous usage data sharing?"), 1, 0));
-            this.addChild(new Text(piTheme().fg("muted", "Opting in stores a tracking identifier in settings.json and enables anonymous\nusage analytics. This helps us to better debug, reproduce, and resolve issues\nand bugs within Pi. You can observe what is shared using /privacy and make\nchanges anytime in settings.json."), 1, 0));
-            this.addChild(new Spacer(1));
-            this.addOptionList(ANALYTICS_OPTIONS.map((option) => option.label), this.analyticsIndex);
-        }
-        this.addChild(new Spacer(1));
-        this.addChild(new Text(rawKeyHint("↑↓", "navigate") +
-            "  " +
-            keyHint("tui.select.confirm", this.step === "theme" ? "continue" : "finish") +
-            "  " +
-            keyHint("tui.select.cancel", "skip setup"), 1, 0));
-        this.addChild(new Spacer(1));
-        this.addChild(new DynamicBorder());
-    }
-    addOptionList(labels, selectedIndex) {
-        for (let i = 0; i < labels.length; i++) {
-            const isSelected = i === selectedIndex;
-            const prefix = isSelected ? piTheme().fg("accent", "→ ") : "  ";
-            const optionLabel = labels[i] ?? "";
-            const label = isSelected ? piTheme().fg("accent", optionLabel) : piTheme().fg("text", optionLabel);
-            this.addChild(new Text(`${prefix}${label}`, 1, 0));
-        }
-    }
-    moveSelection(delta) {
-        if (this.step === "theme") {
-            const next = Math.max(0, Math.min(THEME_OPTIONS.length - 1, this.themeIndex + delta));
-            if (next !== this.themeIndex) {
-                this.themeIndex = next;
-                this.options.onThemePreview(THEME_OPTIONS[this.themeIndex]?.value ?? "dark");
-            }
-        }
-        else {
-            this.analyticsIndex = Math.max(0, Math.min(ANALYTICS_OPTIONS.length - 1, this.analyticsIndex + delta));
-        }
-        this.update();
-    }
-    handleInput(keyData) {
-        const kb = getKeybindings();
-        if (kb.matches(keyData, "tui.select.up") || keyData === "k") {
-            this.moveSelection(-1);
-        }
-        else if (kb.matches(keyData, "tui.select.down") || keyData === "j") {
-            this.moveSelection(1);
-        }
-        else if (kb.matches(keyData, "tui.select.confirm") || keyData === "\n") {
-            if (this.step === "theme") {
-                this.step = "analytics";
-                this.update();
-            }
-            else {
-                this.options.onSubmit({
-                    theme: THEME_OPTIONS[this.themeIndex]?.value ?? "dark",
-                    shareAnalytics: ANALYTICS_OPTIONS[this.analyticsIndex]?.value ?? true,
-                });
-            }
-        }
-        else if (kb.matches(keyData, "tui.select.cancel")) {
-            this.options.onCancel();
-        }
-    }
-}

package/dist/integrations/pi/components/upstream/components/markdown-transform.d.ts

@@ -1,2 +0,0 @@
-import type { MarkdownTransformContext, MarkdownTransformer } from "@earendil-works/pi-coding-agent";
-export declare function createMarkdownTransform(messageType: MarkdownTransformContext["messageType"], isStreaming: boolean, transformers: readonly MarkdownTransformer[]): (markdown: string, availableWidth: number) => string;

package/dist/integrations/pi/components/upstream/components/markdown-transform.js

@@ -1,18 +0,0 @@
-export function createMarkdownTransform(messageType, isStreaming, transformers) {
-    return (markdown, availableWidth) => applyMarkdownTransformers(markdown, { messageType, isStreaming, availableWidth }, transformers);
-}
-function applyMarkdownTransformers(markdown, context, transformers) {
-    let transformedMarkdown = markdown;
-    for (const transformer of transformers) {
-        try {
-            const transformed = transformer(transformedMarkdown, context);
-            if (typeof transformed === "string") {
-                transformedMarkdown = transformed;
-            }
-        }
-        catch {
-            // Keep the current Markdown and continue with the next transformer.
-        }
-    }
-    return transformedMarkdown;
-}

package/dist/integrations/pi/engine/model-auth-integration.d.ts

@@ -1,31 +0,0 @@
-import type { ModelRuntime } from "../startup-public.js";
-import type { AgentAuthenticationPort, AgentModelDescriptor, AgentModelPort } from "../../../contracts/agent-engine/index.js";
-export type PiDocumentedModelRuntime = Pick<ModelRuntime, "getAvailableSnapshot" | "getModel" | "getProvider" | "hasConfiguredAuth" | "refresh" | "logout">;
-export interface PiModelAuthenticationOptions {
-    readonly runtime: PiDocumentedModelRuntime;
-    readonly currentModel: () => AgentModelDescriptor | null;
-    readonly selectModel: (model: ReturnType<PiDocumentedModelRuntime["getModel"]> extends infer T ? Exclude<T, undefined> : never) => Promise<void>;
-    readonly login: (providerId: string, signal: AbortSignal) => Promise<void>;
-    readonly timeoutMs?: number;
-    readonly scopedModelIds?: () => readonly string[] | undefined;
-}
-/** Adapts the pinned model runtime to neutral model selection and authentication operations. */
-export declare class PiModelAuthenticationIntegration implements AgentModelPort, AgentAuthenticationPort {
-    #private;
-    private readonly options;
-    readonly capabilities: {
-        selection: boolean;
-        refresh: boolean;
-        scopedCatalog: boolean;
-        login: boolean;
-        logout: boolean;
-    };
-    constructor(options: PiModelAuthenticationOptions);
-    listModels(): Promise<readonly AgentModelDescriptor[]>;
-    currentModel(): Promise<AgentModelDescriptor | null>;
-    selectModel(providerId: string, modelId: string): Promise<void>;
-    refreshModels(): Promise<void>;
-    status(providerId: string): Promise<"authenticated" | "unauthenticated" | "unavailable">;
-    login(providerId: string, signal?: AbortSignal): Promise<void>;
-    logout(providerId: string): Promise<void>;
-}

package/dist/integrations/pi/engine/model-auth-integration.js

@@ -1,62 +0,0 @@
-/** Adapts the pinned model runtime to neutral model selection and authentication operations. */
-export class PiModelAuthenticationIntegration {
-    options;
-    capabilities = { selection: true, refresh: true, scopedCatalog: true, login: true, logout: true };
-    #timeoutMs;
-    constructor(options) {
-        this.options = options;
-        this.#timeoutMs = options.timeoutMs ?? 30_000;
-    }
-    async listModels() {
-        const scope = this.options.scopedModelIds?.();
-        const selected = scope ? new Set(scope) : null;
-        return this.options.runtime.getAvailableSnapshot()
-            .filter(model => !selected || selected.has(`${model.provider}/${model.id}`))
-            .map(model => ({
-            providerId: model.provider,
-            modelId: model.id,
-            displayName: model.name,
-            contextWindow: model.contextWindow,
-            thinkingLevels: [],
-        }));
-    }
-    async currentModel() { return this.options.currentModel(); }
-    async selectModel(providerId, modelId) {
-        const model = this.options.runtime.getModel(providerId, modelId);
-        if (!model)
-            throw new Error(`model is unavailable: ${providerId}/${modelId}`);
-        await this.options.selectModel(model);
-    }
-    async refreshModels() {
-        await this.options.runtime.refresh();
-    }
-    async status(providerId) {
-        return this.options.runtime.getProvider(providerId) === undefined
-            ? "unavailable"
-            : this.options.runtime.hasConfiguredAuth(providerId) ? "authenticated" : "unauthenticated";
-    }
-    async login(providerId, signal) {
-        await boundedOperation(inner => this.options.login(providerId, inner), this.#timeoutMs, signal);
-    }
-    async logout(providerId) {
-        await boundedOperation(signal => this.options.runtime.logout(providerId, { signal }), this.#timeoutMs);
-    }
-}
-async function boundedOperation(operation, timeoutMs, outer) {
-    const controller = new AbortController();
-    const abort = () => controller.abort(outer?.reason);
-    outer?.addEventListener("abort", abort, { once: true });
-    const timer = setTimeout(() => controller.abort(new Error(`model/authentication operation timed out after ${timeoutMs}ms`)), timeoutMs);
-    try {
-        if (outer?.aborted)
-            abort();
-        await Promise.race([
-            operation(controller.signal),
-            new Promise((_, reject) => controller.signal.addEventListener("abort", () => reject(controller.signal.reason ?? new Error("model/authentication operation cancelled")), { once: true })),
-        ]);
-    }
-    finally {
-        clearTimeout(timer);
-        outer?.removeEventListener("abort", abort);
-    }
-}

package/dist/integrations/pi/engine/resource-extension-integration.d.ts

@@ -1,32 +0,0 @@
-import type { AgentSession } from "../startup-public.js";
-import type { AgentExtensionBinding, AgentExtensionFailure, AgentExtensionPort, AgentResourceDescriptor, AgentResourcesPort, AgentSessionMetadata } from "../../../contracts/agent-engine/index.js";
-export interface PiResourceExtensionOptions {
-    readonly session: AgentSession;
-    readonly bindUi: () => Promise<void>;
-    readonly unbindUi: () => Promise<void>;
-}
-/** Adapts Pi resource discovery and extension binding while containing extension failures at the port. */
-export declare class PiResourceExtensionIntegration implements AgentResourcesPort, AgentExtensionPort {
-    #private;
-    private readonly options;
-    readonly capabilities: {
-        reload: boolean;
-        extensionBinding: boolean;
-        binding: boolean;
-        renderers: boolean;
-    };
-    constructor(options: PiResourceExtensionOptions);
-    discoverResources(): Promise<readonly AgentResourceDescriptor[]>;
-    discoverCommands(): Promise<{
-        name: string;
-        description: string;
-    }[]>;
-    sessionMetadata(): Promise<AgentSessionMetadata>;
-    bind(sessionId: string): Promise<AgentExtensionBinding>;
-    bindExtensions(sessionId: string): Promise<AgentExtensionBinding>;
-    reload(): Promise<void>;
-    resolveMessageRenderer(customType: string): unknown;
-    resolveToolRenderer(toolName: string): unknown;
-    subscribeFailures(listener: (failure: AgentExtensionFailure) => void): () => void;
-    dispose(): Promise<void>;
-}

package/dist/integrations/pi/engine/resource-extension-integration.js

@@ -1,81 +0,0 @@
-/** Adapts Pi resource discovery and extension binding while containing extension failures at the port. */
-export class PiResourceExtensionIntegration {
-    options;
-    capabilities = { reload: true, extensionBinding: true, binding: true, renderers: true };
-    #failures = new Set();
-    #unsubscribeError;
-    #binding;
-    constructor(options) {
-        this.options = options;
-        this.#unsubscribeError = options.session.extensionRunner.onError(error => {
-            const failure = {
-                extensionPath: error.extensionPath || null,
-                operation: error.event || "extension",
-                message: error.error || "unknown extension failure",
-                recoverable: true,
-            };
-            for (const listener of this.#failures)
-                listener(failure);
-        });
-    }
-    async discoverResources() {
-        const loader = this.options.session.resourceLoader;
-        const resources = [];
-        for (const skill of loader.getSkills().skills)
-            resources.push(resource(skill.name, "skill", skill.name, { source: skill.filePath }));
-        for (const prompt of loader.getPrompts().prompts)
-            resources.push(resource(prompt.name, "prompt", prompt.name, { source: prompt.filePath }));
-        for (const theme of loader.getThemes().themes)
-            resources.push(resource(theme.name ?? "theme", "other", theme.name ?? "Theme", { resourceType: "theme" }));
-        for (const file of loader.getAgentsFiles().agentsFiles)
-            resources.push(resource(file.path, "other", file.path, { resourceType: "agent-context" }));
-        for (const command of this.options.session.extensionRunner.getRegisteredCommands())
-            resources.push(resource(command.name, "command", command.name, { invocationName: command.invocationName }));
-        return resources;
-    }
-    async discoverCommands() {
-        return this.options.session.extensionRunner.getRegisteredCommands().map(command => ({
-            name: command.name,
-            description: command.description ?? "",
-        }));
-    }
-    async sessionMetadata() {
-        const manager = this.options.session.sessionManager;
-        return {
-            sessionId: this.options.session.sessionId,
-            sessionName: manager.getSessionName() ?? null,
-            sessionPath: manager.getSessionFile() ?? null,
-            cwd: manager.getCwd(),
-        };
-    }
-    async bind(sessionId) {
-        if (sessionId !== this.options.session.sessionId)
-            throw new Error("extension binding targets a different session");
-        await this.#binding?.dispose();
-        await this.options.bindUi();
-        let disposed = false;
-        const binding = {
-            sessionId,
-            dispose: async () => {
-                if (disposed)
-                    return;
-                disposed = true;
-                if (this.#binding === binding)
-                    this.#binding = undefined;
-                await this.options.unbindUi();
-            },
-        };
-        this.#binding = binding;
-        return binding;
-    }
-    async bindExtensions(sessionId) { return this.bind(sessionId); }
-    async reload() { await this.options.session.reload(); }
-    resolveMessageRenderer(customType) { return this.options.session.extensionRunner.getMessageRenderer(customType); }
-    resolveToolRenderer(toolName) { return this.options.session.extensionRunner.getToolDefinition(toolName); }
-    subscribeFailures(listener) { this.#failures.add(listener); return () => this.#failures.delete(listener); }
-    async dispose() { await this.#binding?.dispose(); this.#unsubscribeError(); this.#failures.clear(); }
-}
-function resource(id, kind, label, metadata) {
-    return { id: normalizeId(id), kind, label, metadata: Object.fromEntries(Object.entries(metadata).filter((entry) => typeof entry[1] === "string")) };
-}
-function normalizeId(value) { return value.replace(/[^A-Za-z0-9._:/-]/g, "-").slice(0, 128) || "resource"; }

package/dist/integrations/pi/engine/settings-effects.js

@@ -1,249 +0,0 @@
-/**
- * Reviewed effect authority for every generated Pi setting. Presentation remains
- * generated; this table states who must make each accepted value observable.
- */
-export const PI_SETTING_EFFECTS = Object.freeze({
-    autoCompact: effect("live", "agent", "transcript", "compaction status, summary, completion, and failure rows", "pinned-transcript-lifecycle-parity"),
-    showImages: effect("live", "shell", "transcript", "pinned inline image and textual fallback components", "pinned-transcript-image-parity"),
-    imageWidthCells: effect("live", "shell", "transcript-geometry", "pinned image component width and clipping", "pinned-transcript-image-parity"),
-    autoResizeImages: effect("live", "agent", "none", "provider image preparation and pinned warning row", "settings-effects-provider-parity"),
-    blockImages: effect("live", "agent", "none", "provider context conversion and pinned blocked-image notice", "settings-effects-provider-parity"),
-    enableSkillCommands: effect("live", "shell", "editor-menu", "pinned command autocomplete list", "pinned-editor-input-parity"),
-    steeringMode: effect("live", "agent", "queue-transcript", "pinned steering queue and submitted prompt rows", "pinned-status-indicator-parity"),
-    followUpMode: effect("live", "agent", "queue-transcript", "pinned follow-up queue and submitted prompt rows", "pinned-status-indicator-parity"),
-    transport: effect("live", "agent", "status-error", "pinned provider request status and failure rows", "settings-effects-provider-parity"),
-    httpIdleTimeoutMs: effect("live", "agent", "retry-error", "pinned timeout, retry, and terminal failure rows", "pinned-transcript-lifecycle-parity"),
-    thinkingLevel: effect("live", "agent", "footer-transcript", "pinned footer indicator, thinking rows, and clamp notice", "pinned-status-indicator-parity"),
-    theme: hiddenEffect("live", "shell", "pinned theme selector and complete themed shell", "pinned-theme-parity"),
-    hideThinkingBlock: effect("live", "shell", "transcript", "pinned thinking block presence and spacing", "pinned-transcript-lifecycle-parity"),
-    mermaidRenderingMode: effect("live", "shell", "markdown", "pinned Mermaid Markdown transformation", "pinned-assistant-content-parity"),
-    showCacheMissNotices: effect("live", "shell", "transcript-notice", "pinned cache-miss transcript notice", "pinned-transcript-lifecycle-parity"),
-    collapseChangelog: effect("next-start", "startup", "startup-transcript", "pinned startup and command changelog components", "pi-startup-composition-parity"),
-    enableInstallTelemetry: effect("next-start", "installation", "none", "install lifecycle and its pinned failure diagnostic", "settings-effects-installation-parity"),
-    quietStartup: hiddenEffect("next-start", "startup", "pinned startup suppression lifecycle", "pi-startup-composition-parity"),
-    defaultProjectTrust: effect("next-start", "startup", "startup-selector", "pinned pre-resource project trust selector", "project-trust-startup-parity"),
-    doubleEscapeAction: effect("live", "shell", "selector", "pinned tree or fork selector", "pinned-selector-parity"),
-    treeFilterMode: effect("live", "shell", "selector", "pinned tree selector filter, rows, and hints", "pinned-selector-parity"),
-    showHardwareCursor: effect("live", "terminal", "terminal-cursor", "pinned editor, overlay, blur, failure, and exit cursor operations", "pi-terminal-operation-parity"),
-    editorPaddingX: effect("live", "shell", "editor-geometry", "pinned editor border, padding, wrapping, and cursor column", "pinned-editor-input-parity"),
-    outputPad: effect("live", "shell", "transcript-geometry", "pinned transcript, tool, status, and error horizontal padding", "pinned-transcript-lifecycle-parity"),
-    autocompleteMaxVisible: effect("live", "shell", "menu-geometry", "pinned autocomplete clipping and editor anchoring", "pinned-editor-input-parity"),
-    clearOnShrink: effect("live", "terminal", "terminal-frame", "pinned resize clearing and resulting terminal frame", "pi-terminal-operation-parity"),
-    showTerminalProgress: effect("live", "terminal", "terminal-status", "pinned OSC progress lifecycle", "pi-terminal-operation-parity"),
-    tuiMode: hiddenEffect("next-session", "shell", "pinned regular/fullscreen selector and terminal lifecycle", "pi-terminal-operation-parity"),
-    fullscreenExitOutput: hiddenEffect("current-exit", "shutdown", "pinned styled transcript and compact dim resume hint", "pinned-fullscreen-exit-parity"),
-    fullscreenScrollbar: hiddenEffect("live", "shell", "pinned fullscreen scrollbar reservation", "pi-terminal-operation-parity"),
-    warnings: effect("live", "agent", "transcript-notice", "pinned warning rows by warning part", "pinned-transcript-lifecycle-parity"),
-});
-function effect(application, owner, visualClass, pinnedSurface, evidence) {
-    return { application, owner, visual: { class: visualClass, pinnedSurface, evidence } };
-}
-function hiddenEffect(application, owner, pinnedSurface, evidence) {
-    return { application, owner, hiddenInBare: true, visual: { class: "hidden", pinnedSurface, evidence } };
-}
-/**
- * One transactional authority for Pi setting validation, active effects,
- * persistence, durability, rollback, and owner lifecycle.
- */
-export class PiSettingsCoordinator {
-    #operations;
-    #handlers = new Map();
-    #state = new Map();
-    #productMode;
-    #flushStorage;
-    #drainErrors;
-    constructor(operations, options) {
-        this.#operations = new Map(operations.map(operation => [operation.key, operation]));
-        this.#productMode = options.productMode ?? "bare";
-        this.#flushStorage = options.flush;
-        this.#drainErrors = options.drainErrors;
-        for (const operation of operations) {
-            const stored = operation.read();
-            this.#state.set(operation.key, { stored, effective: stored, inconsistentReason: null });
-        }
-    }
-    bindOwner(owner, handlers) {
-        const bound = [];
-        for (const [candidate, handler] of Object.entries(handlers)) {
-            if (handler === undefined)
-                continue;
-            const key = candidate;
-            const definition = PI_SETTING_EFFECTS[key];
-            if (definition === undefined)
-                throw new Error(`unknown Pi setting effect: ${key}`);
-            if (definition.owner !== owner)
-                throw new Error(`${key} belongs to ${definition.owner}, not ${owner}`);
-            if (this.#productMode === "bare" && definition.hiddenInBare === true) {
-                throw new Error(`${key} is hidden in bare A1`);
-            }
-            this.#handlers.set(key, handler);
-            bound.push(key);
-        }
-        return () => this.unbindOwner(owner, bound);
-    }
-    unbindOwner(owner, keys) {
-        const candidates = keys ?? [...this.#handlers.keys()];
-        for (const key of candidates)
-            if (PI_SETTING_EFFECTS[key].owner === owner)
-                this.#handlers.delete(key);
-    }
-    definition(key) {
-        return PI_SETTING_EFFECTS[key];
-    }
-    storedValue(key) {
-        const operation = this.#requireOperation(key);
-        const stored = operation.read();
-        const state = this.#requireState(key);
-        state.stored = stored;
-        return stored;
-    }
-    effectiveValue(key) {
-        return this.#requireState(key).effective;
-    }
-    limitationReason(key) {
-        const definition = PI_SETTING_EFFECTS[key];
-        if (this.#productMode === "bare" && definition.hiddenInBare === true)
-            return "setting is not available in the active product mode";
-        const inconsistent = this.#requireState(key).inconsistentReason;
-        if (inconsistent !== null)
-            return inconsistent;
-        if (!this.#handlers.has(key))
-            return `${definition.owner} effect is not bound for ${definition.application} application`;
-        return null;
-    }
-    available(key) {
-        return this.limitationReason(key) === null;
-    }
-    validate(key, value) {
-        this.#requireOperation(key).validate(value);
-    }
-    async apply(key, value) {
-        const operation = this.#requireOperation(key);
-        operation.validate(value);
-        const definition = PI_SETTING_EFFECTS[key];
-        const previousStored = operation.read();
-        const state = this.#requireState(key);
-        const previousEffective = state.effective;
-        const limitationReason = this.limitationReason(key);
-        if (limitationReason !== null) {
-            return outcome("unavailable", definition.application, previousStored, previousEffective, null, limitationReason);
-        }
-        const handler = this.#handlers.get(key);
-        if (definition.application !== "live") {
-            try {
-                operation.write(value);
-                await this.flush();
-                state.stored = value;
-                return outcome("deferred", definition.application, value, previousEffective, null, null);
-            }
-            catch (error) {
-                const failure = await this.#restorePersistence(operation, previousStored, error);
-                state.stored = operation.read();
-                return outcome("failed", definition.application, state.stored, previousEffective, failure, null);
-            }
-        }
-        try {
-            await handler.apply(value);
-        }
-        catch (error) {
-            return outcome("failed", definition.application, previousStored, previousEffective, describe(error), null);
-        }
-        state.effective = value;
-        try {
-            operation.write(value);
-            await this.flush();
-            state.stored = value;
-            state.inconsistentReason = null;
-            return outcome("applied", definition.application, value, value, null, null);
-        }
-        catch (error) {
-            const persistenceFailure = await this.#restorePersistence(operation, previousStored, error);
-            try {
-                await handler.apply(previousEffective);
-                state.effective = previousEffective;
-                state.stored = operation.read();
-                return outcome("failed", definition.application, state.stored, previousEffective, persistenceFailure, null);
-            }
-            catch (rollbackError) {
-                state.stored = operation.read();
-                state.inconsistentReason = `rollback failed after ${persistenceFailure}: ${describe(rollbackError)}`;
-                return outcome("failed", definition.application, state.stored, state.effective, state.inconsistentReason, state.inconsistentReason);
-            }
-        }
-    }
-    async flush() {
-        await this.#flushStorage();
-        const errors = this.#drainErrors?.() ?? [];
-        if (errors.length > 0)
-            throw new Error(errors.map(value => value.error.message).join("; "));
-    }
-    async rollback(key, value) {
-        const handler = this.#handlers.get(key);
-        if (handler === undefined)
-            throw new Error(`cannot roll back unbound setting: ${key}`);
-        await handler.apply(value);
-        this.#requireState(key).effective = value;
-    }
-    async #restorePersistence(operation, previous, cause) {
-        const original = describe(cause);
-        try {
-            operation.write(previous);
-            await this.flush();
-            return original;
-        }
-        catch (rollbackError) {
-            return `${original}; persistence rollback failed: ${describe(rollbackError)}`;
-        }
-    }
-    #requireOperation(key) {
-        const operation = this.#operations.get(key);
-        if (operation === undefined)
-            throw new Error(`setting is unavailable: ${key}`);
-        return operation;
-    }
-    #requireState(key) {
-        const state = this.#state.get(key);
-        if (state === undefined)
-            throw new Error(`setting state is unavailable: ${key}`);
-        return state;
-    }
-}
-export function settingsEffectInventoryDrift(presented, reviewed = Object.keys(PI_SETTING_EFFECTS)) {
-    const reviewedSet = new Set(reviewed);
-    const presentedSet = new Set(presented);
-    const counts = new Map();
-    for (const key of reviewed)
-        counts.set(key, (counts.get(key) ?? 0) + 1);
-    return {
-        unmapped: presented.filter(key => !reviewedSet.has(key)),
-        stale: reviewed.filter(key => !presentedSet.has(key)),
-        duplicated: [...counts].filter(([, count]) => count > 1).map(([key]) => key),
-    };
-}
-export function settingsVisualInventoryViolations(presented, reviewed = PI_SETTING_EFFECTS) {
-    const violations = [];
-    for (const candidate of presented) {
-        const key = candidate;
-        const definition = reviewed[key];
-        if (definition === undefined) {
-            violations.push(`${candidate}: missing visual classification`);
-            continue;
-        }
-        const visual = definition.visual;
-        if (!visual || visual.pinnedSurface.trim().length === 0)
-            violations.push(`${candidate}: missing pinned visual source`);
-        if (!visual || visual.evidence.trim().length === 0)
-            violations.push(`${candidate}: missing independent visual evidence`);
-        if (definition.hiddenInBare === true && visual?.class !== "hidden")
-            violations.push(`${candidate}: hidden setting declares a visible frame`);
-        if (definition.hiddenInBare !== true && visual?.class === "hidden")
-            violations.push(`${candidate}: visible setting declares hidden evidence`);
-    }
-    return violations;
-}
-function outcome(status, application, storedValue, effectiveValue, failure, limitationReason) {
-    return { status, application, storedValue, effectiveValue, failure, limitationReason };
-}
-function describe(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/integrations/pi/engine/settings-integration.d.ts

@@ -1,43 +0,0 @@
-import type { SettingsManager } from "../startup-public.js";
-import type { AgentJsonValue, AgentSettingChangeOutcome, AgentSettingDescriptor, AgentSettingOwner, AgentSettingsPort } from "../../../contracts/agent-engine/index.js";
-import { type PiSettingOwnerHandlers } from "./settings-effects.js";
-/** Values only the running engine knows. */
-export interface PiSettingsProviders {
-    readonly themes?: () => readonly string[];
-    readonly thinkingLevels?: () => readonly string[];
-    readonly productMode?: "bare" | "comparison";
-}
-export declare const AUTOMATIC_THEME = "automatic";
-interface AutomaticTheme {
-    readonly light: string;
-    readonly dark: string;
-}
-export declare function parseAutomaticTheme(stored: string): AutomaticTheme | null;
-export declare const EXPOSED_SETTING_KEYS: readonly string[];
-export declare function settingsInventoryDrift(presented: readonly string[], mapped: readonly string[]): {
-    readonly unmapped: readonly string[];
-    readonly stale: readonly string[];
-};
-/**
- * Pi settings boundary backed by the transactional settings coordinator. The
- * generated metadata owns presentation while the reviewed effect registry owns
- * timing, availability, and active behavior.
- */
-export declare class PiSettingsIntegration implements AgentSettingsPort {
-    #private;
-    private readonly settings;
-    readonly capabilities: {
-        write: boolean;
-        flush: boolean;
-    };
-    constructor(settings: SettingsManager, providers?: PiSettingsProviders);
-    bindOwner(owner: AgentSettingOwner, handlers: PiSettingOwnerHandlers): () => void;
-    unbindOwner(owner: AgentSettingOwner): void;
-    listSettings(): Promise<readonly AgentSettingDescriptor[]>;
-    readSetting(key: string): Promise<AgentJsonValue | undefined>;
-    writeSetting(key: string, value: AgentJsonValue): Promise<AgentSettingChangeOutcome>;
-    /** Shared route used by the pinned selector and owned settings surface. */
-    writeSettingNow(key: string, value: AgentJsonValue): Promise<AgentSettingChangeOutcome>;
-    flush(): Promise<void>;
-}
-export {};