@timurproko/a1 0.1.8-dev.112 → 0.1.8-dev.122

package/dist/src/composition/index.js

@@ -1,258 +0,0 @@
-import { AGENT_ENGINE_CONTRACT_VERSION, assertAgentCapabilityContract, assertAgentCommand, } from "../foundation/agent-engine-contracts/index.js";
-import { createPiEngineAdapter } from "../foundation/pi-engine-adapter/index.js";
-import { createPiPresentationRuntime, createPiTerminalBridge } from "../foundation/pi-tui-runtime-adapter/index.js";
-import { assertPresentationComponent, assertPresentationRuntime, } from "../foundation/presentation-contracts/index.js";
-import { OwnedUiSessionShell } from "../foundation/pi-owned-ui-integration/index.js";
-import { OwnedUiSettingsSession, OwnedUiSettingsStore } from "../foundation/owned-ui-settings/index.js";
-import { UiAppHost, UiAppRegistry } from "../foundation/ui-apps/index.js";
-import { applyConfiguredPiTheme, getAvailablePiThemes, piTheme } from "../foundation/pi-component-adapter/index.js";
-import { faint } from "../foundation/ui-components/index.js";
-import { SETTINGS_APP_ID, SETTINGS_ROUTE, SettingsApp } from "../features/owned-ui/index.js";
-import { resolveProductPaths } from "../foundation/lifecycle/index.js";
-const CAPABILITIES = {
-    contractVersion: AGENT_ENGINE_CONTRACT_VERSION,
-    commands: ["prompt", "steer", "follow-up", "abort", "retry", "compact", "bash", "replace-session"],
-    events: ["lifecycle", "content", "command-outcome", "snapshot-invalidated", "diagnostic"],
-    snapshots: { supported: true, maxBytes: 1024 * 1024 },
-};
-export async function composeOwnedUiApplication(options = {}) {
-    return (await composeOwnedUi(options)).application;
-}
-export async function composeOwnedUi(options = {}) {
-    const cwd = options.cwd ?? process.cwd();
-    const adapter = options.createPiAdapter
-        ? await options.createPiAdapter()
-        : await createPiEngineAdapter({ cwd, availableThemes: () => getAvailablePiThemes().map(theme => theme.name) });
-    const settings = options.profileId === undefined
-        ? null
-        : new OwnedUiSettingsSession({
-            store: new OwnedUiSettingsStore({ configDir: resolveProductPaths().configDir, profileId: options.profileId }),
-            agentProvider: () => adapter.settingsPort(),
-        });
-    // Before anything is drawn, so every surface uses the configured theme rather
-    // than the one guessed from the terminal's background.
-    applyConfiguredPiTheme(adapter.configuredTheme());
-    const routeHost = settings === null || options.ownedSurfaces === "off" ? null : createOwnedRouteHost(settings);
-    const shell = new OwnedUiSessionShell({
-        backend: adapter,
-        cwd,
-        ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
-        ...(routeHost === null ? {} : { routeHost }),
-    });
-    const application = {
-        get disposed() { return adapter.disposed; },
-        start: () => shell.start(),
-        flush: () => adapter.flushEvents(),
-        waitUntilStopped: () => shell.waitUntilStopped(),
-        dispose: () => shell.dispose(),
-    };
-    return { application, settings };
-}
-export async function composeProcess(options = {}) {
-    let engine = options.engine;
-    if (!engine) {
-        const adapter = options.createPiAdapter
-            ? await options.createPiAdapter()
-            : await createPiEngineAdapter({
-                ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
-                ...(options.sessionId === undefined ? {} : { sessionId: options.sessionId }),
-            });
-        engine = new PiAgentEngineBridge(adapter, options.cwd ?? process.cwd());
-    }
-    assertAgentCapabilityContract(engine.capabilities);
-    if (typeof engine.createSession !== "function" || typeof engine.dispose !== "function")
-        throw new TypeError("composed engine does not satisfy the neutral engine port");
-    const presentations = new Set();
-    let disposed = false;
-    return {
-        engine,
-        createPresentation(root, terminal) {
-            if (disposed)
-                throw new Error("process composition is disposed");
-            assertPresentationComponent(root);
-            const runtime = options.presentationFactory?.(root, terminal) ?? createPiPresentationRuntime(root, terminal);
-            assertPresentationRuntime(runtime);
-            presentations.add(runtime);
-            return runtime;
-        },
-        async dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            const failures = [];
-            for (const runtime of [...presentations].reverse())
-                await runtime.stop().catch(error => failures.push(error));
-            await engine.dispose().catch(error => failures.push(error));
-            if (failures.length)
-                throw new AggregateError(failures, "process composition disposal failed");
-        },
-    };
-}
-class PiAgentEngineBridge {
-    adapter;
-    cwd;
-    capabilities = CAPABILITIES;
-    #session;
-    constructor(adapter, cwd) {
-        this.adapter = adapter;
-        this.cwd = cwd;
-    }
-    async createSession(input) {
-        if (this.#session)
-            return this.#session;
-        if (input.cwd !== this.cwd)
-            throw new TypeError("composed Pi engine cannot change working directory");
-        await this.adapter.start();
-        this.#session = new PiAgentSessionBridge(this.adapter, input.sessionId);
-        return this.#session;
-    }
-    async dispose() { await this.adapter.dispose(); }
-}
-class PiAgentSessionBridge {
-    adapter;
-    sessionId;
-    capabilities = CAPABILITIES;
-    lifecycle = "starting";
-    #listeners = new Set();
-    #unsubscribe;
-    constructor(adapter, sessionId) {
-        this.adapter = adapter;
-        this.sessionId = sessionId;
-        this.#unsubscribe = adapter.onEvent(event => {
-            const converted = convertEvent(event);
-            if (!converted)
-                return;
-            if (converted.type === "lifecycle")
-                this.lifecycle = converted.lifecycle;
-            for (const listener of this.#listeners)
-                listener(converted);
-        });
-        this.lifecycle = toLifecycle(adapter.snapshot().view.lifecycle);
-    }
-    async execute(command) {
-        assertAgentCommand(command, this.capabilities);
-        if (command.sessionId !== this.sessionId)
-            return "rejected";
-        if (command.type === "bash") {
-            const result = await this.adapter.executeBashWorkflow(command.command, false);
-            return !result.cancelled && result.exitCode === 0 ? "completed" : result.cancelled ? "cancelled" : "failed";
-        }
-        const owned = toOwnedCommand(command);
-        const result = await this.adapter.execute(owned);
-        return result.outcome === "timed-out" ? "failed" : result.outcome;
-    }
-    subscribe(listener) { this.#listeners.add(listener); return () => this.#listeners.delete(listener); }
-    async snapshot() {
-        const snapshot = this.adapter.snapshot();
-        return {
-            contractVersion: AGENT_ENGINE_CONTRACT_VERSION,
-            snapshotId: snapshot.snapshotId,
-            sessionId: this.sessionId,
-            revision: snapshot.view.revision,
-            sequence: snapshot.sequence,
-            lifecycle: toLifecycle(snapshot.view.lifecycle),
-            content: snapshot.view.transcript.map(toMessage),
-            activeCommandIds: snapshot.view.activeCommandIds,
-            capabilities: this.capabilities,
-        };
-    }
-    async dispose() { this.#unsubscribe(); this.#listeners.clear(); await this.adapter.dispose(); this.lifecycle = "stopped"; }
-}
-function toOwnedCommand(command) {
-    const base = { correlationId: command.commandId, sessionId: command.sessionId };
-    if (command.type === "replace-session")
-        return command.source.kind === "new" ? { ...base, type: "new-session" } : { ...base, type: "resume-session", sessionPath: command.source.sessionPath };
-    if (command.type === "prompt" || command.type === "steer" || command.type === "follow-up")
-        return { ...base, type: command.type, text: command.text };
-    return { ...base, type: command.type };
-}
-function convertEvent(event) {
-    const base = { contractVersion: AGENT_ENGINE_CONTRACT_VERSION, sessionId: event.sessionId, sequence: event.sequence };
-    if (event.type === "session-lifecycle")
-        return { ...base, type: "lifecycle", lifecycle: toLifecycle(event.lifecycle), reason: event.reason };
-    if (event.type === "transcript-block")
-        return { ...base, type: "content", content: toMessage(event.block) };
-    if (event.type === "command-outcome")
-        return { ...base, type: "command-outcome", commandId: event.correlationId, outcome: event.outcome === "timed-out" ? "failed" : event.outcome, diagnostic: event.diagnostic };
-    if (event.type === "diagnostic")
-        return { ...base, type: "diagnostic", code: event.diagnostic.code, message: event.diagnostic.message, recoverable: event.diagnostic.recoverable };
-    if (event.type === "session-view")
-        return { ...base, type: "snapshot-invalidated", expectedRevision: event.view.revision };
-    return null;
-}
-function toLifecycle(lifecycle) {
-    return lifecycle === "suspended" ? "ready" : lifecycle;
-}
-function toMessage(block) {
-    const role = block.kind === "user" ? "user" : block.kind === "system" ? "system" : block.kind === "tool-call" || block.kind === "tool-result" ? "tool" : "assistant";
-    return { id: block.id, role, status: block.status === "live" ? "streaming" : "final", content: [{ kind: "text", text: block.text }] };
-}
-/**
- * Registers the A1-owned screens and adapts the app host to the shell's route
- * seam. The shell mounts whatever surface it is handed and forwards keys; it
- * never learns what an app is.
- */
-export function createOwnedRouteHost(settings) {
-    const registry = new UiAppRegistry();
-    registry.register({ id: SETTINGS_APP_ID, route: SETTINGS_ROUTE, create: () => new SettingsApp(settings) });
-    return {
-        claims: route => registry.forRoute(route) !== null,
-        open: route => {
-            const registration = registry.forRoute(route);
-            if (registration === null)
-                return null;
-            let size = { width: 80, height: 24 };
-            let frame = [];
-            let closed = false;
-            let onRender = () => undefined;
-            let onExit = () => undefined;
-            const host = new UiAppHost({
-                registry,
-                closeOnInterrupt: true,
-                theme: pinnedTheme(),
-                surface: {
-                    size: () => size,
-                    requestRender: () => onRender(),
-                    exit: () => onExit(),
-                    present: lines => {
-                        if (lines === null)
-                            closed = true;
-                        else
-                            frame = lines;
-                    },
-                },
-            });
-            host.open(registration.id);
-            const surface = {
-                id: registration.id,
-                render: (width, height) => {
-                    size = { width, height };
-                    host.render();
-                    return frame.length === height ? frame : [...frame.slice(0, height), ...Array(Math.max(0, height - frame.length)).fill("")];
-                },
-                handleInput: data => host.handleInput(data).consumed,
-                handleMouse: event => host.handleMouse(event).consumed,
-                isClosed: () => closed || !host.isPresenting,
-                close: () => host.close(),
-                onRenderRequested: listener => { onRender = listener; },
-                onExitRequested: listener => { onExit = listener; },
-            };
-            return surface;
-        },
-    };
-}
-/** Maps A1 UI tokens onto the pinned Pi theme so owned screens match the shell. */
-function pinnedTheme() {
-    return {
-        fg: (token, text) => piTheme().fg(token, text),
-        bold: (text) => piTheme().bold(text),
-        // Unpainted, so a list reads against the terminal the reader actually has
-        // rather than against the background the configured theme was built for.
-        plain: (text) => text,
-        // Quiet, and quieter again: the terminal's own faint attribute over the
-        // dimmest colour the theme has.
-        disabled: (text) => faint(piTheme().fg("dim", text)),
-        highlight: (text) => `${text}`,
-        panel: (text) => `${text}`,
-    };
-}

package/dist/src/foundation/lifecycle/paths.d.ts

@@ -1,10 +0,0 @@
-export interface ProductPaths {
-    readonly configDir: string;
-    readonly dataDir: string;
-    readonly runtimeDir: string;
-    readonly databasePath: string;
-    readonly endpoint: string;
-    readonly endpointMetadataPath: string;
-    readonly supervisorLogPath: string;
-}
-export declare function resolveProductPaths(environment?: NodeJS.ProcessEnv, hostPlatform?: NodeJS.Platform, fallbackHome?: string): ProductPaths;

package/dist/src/foundation/supervision/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./main.js";
-export * from "./server.js";
-export { resolveProductPaths, type ProductPaths } from "../lifecycle/index.js";

package/dist/src/foundation/supervision/index.js

@@ -1,3 +0,0 @@
-export * from "./main.js";
-export * from "./server.js";
-export { resolveProductPaths } from "../lifecycle/index.js";

package/dist/src/foundation/supervision/paths.d.ts

@@ -1 +0,0 @@
-export { resolveProductPaths, type ProductPaths } from "../lifecycle/index.js";

package/dist/src/foundation/supervision/paths.js

@@ -1 +0,0 @@
-export { resolveProductPaths } from "../lifecycle/index.js";

package/docs/manual-transparent-checkpoint.md

@@ -1,53 +0,0 @@
-# Manual owned-UI and transparent fallback checkpoint
-
-This checkpoint is user-controlled. Tests and coding agents must not launch or focus a terminal, inject desktop input, resize windows, close applications, or clean up workstation processes.
-
-## Prepare an exact candidate
-
-From the candidate checkout, pack once and install that tarball into a disposable prefix:
-
-```powershell
-npm ci
-npm run build
-npm pack --ignore-scripts --pack-destination artifacts/manual-transparent
-npm install --prefix artifacts/manual-transparent/install --ignore-scripts artifacts/manual-transparent/<exact-tarball>.tgz
-```
-
-Use isolated A1 control state:
-
-```powershell
-$manualRoot = (Resolve-Path "artifacts/manual-transparent").Path
-$env:A1_CONFIG_DIR = "$manualRoot\state\config"
-$env:A1_DATA_DIR = "$manualRoot\state\data"
-$env:A1_RUNTIME_DIR = "$manualRoot\state\runtime"
-$env:A1_DATABASE_PATH = "$manualRoot\state\data\control.sqlite3"
-```
-
-Run the installed candidate yourself:
-
-```powershell
-& "artifacts/manual-transparent/install/node_modules/.bin/a1.cmd"
-```
-
-Test each installed launch form separately: bare `a1` (the owned UI), `a1 pi` (the untouched comparison oracle), and `a1 sandbox` (the unchanged isolated vanilla profile). Confirm that files created through `/settings`, `/login`, sessions, and resource directories remain under the selected profile root. Generic transparent-fallback testing may set `A1_TERMINAL_EXECUTABLE` and a JSON array in `A1_TERMINAL_ARGUMENTS_JSON`.
-
-Physical automation is not part of this repository baseline. Future certification tooling may run only on dedicated disposable workers or VMs with exclusive test desktops, never on this workstation.
-
-## Compare bare A1 with `a1 pi`
-
-Use the same terminal, working directory, dimensions, environment, and equivalent profile resources. Bare A1 and the untouched oracle intentionally use separate profile roots.
-
-- [ ] Startup resources, logo, notices, spacing, editor, and footer match.
-- [ ] Text, Unicode, emoji, styles, cursor, and layout match.
-- [ ] Rapid typing has no visible A1 delay or dropped/duplicated characters.
-- [ ] Ctrl+C, Ctrl+P, arrows, paste, focus, dialogs, mouse, and wheel match.
-- [ ] Selection, copy, clipboard, scrollback, and resize match.
-- [ ] Normal and error exits preserve child output and return a usable parent prompt.
-- [ ] Parent typing, cursor movement, Backspace, Delete, and submission work after exit.
-- [ ] A missing executable reports a concise spawn failure without affecting other applications.
-
-Report failures with direct-versus-A1 behavior, platform/terminal versions, exact command, reproducibility, and optional manually captured evidence.
-
-For recovery, use `a1 pi`; do not use the removed `a1 ui` command. `a1 sandbox` remains profile isolation rather than a security boundary.
-
-Manual acceptance can authorize an exact uncertified development preview after non-desktop gates pass. It does not certify stable terminal parity or platform support.