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

package/dist/composition/agent-engine-bridge.js

@@ -1,108 +0,0 @@
-import { AGENT_ENGINE_CONTRACT_VERSION, assertAgentCommand, } from "../contracts/agent-engine/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 function createPiAgentEngineBridge(adapter, cwd) {
-    return new PiAgentEngineBridge(adapter, cwd);
-}
-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 result = await this.adapter.execute(toOwnedCommand(command));
-        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 }] };
-}

package/dist/composition/process.d.ts

@@ -1,16 +0,0 @@
-import { type AgentEnginePort } from "../contracts/agent-engine/index.js";
-import { type PiEngineAdapter } from "../integrations/pi/engine/index.js";
-import { type PresentationComponentPort, type PresentationRuntimePort, type PresentationTerminalPort } from "../contracts/presentation/index.js";
-export interface ProcessCompositionOptions {
-    readonly cwd?: string;
-    readonly sessionId?: string;
-    readonly engine?: AgentEnginePort;
-    readonly presentationFactory?: (root: PresentationComponentPort, terminal: PresentationTerminalPort) => PresentationRuntimePort;
-    readonly createPiAdapter?: () => Promise<PiEngineAdapter>;
-}
-export interface ProcessComposition {
-    readonly engine: AgentEnginePort;
-    createPresentation(root: PresentationComponentPort, terminal: PresentationTerminalPort): PresentationRuntimePort;
-    dispose(): Promise<void>;
-}
-export declare function composeProcess(options?: ProcessCompositionOptions): Promise<ProcessComposition>;

package/dist/composition/process.js

@@ -1,45 +0,0 @@
-import { assertAgentCapabilityContract, } from "../contracts/agent-engine/index.js";
-import { createPiEngineAdapter } from "../integrations/pi/engine/index.js";
-import { createPiPresentationRuntime } from "../integrations/pi/tui-runtime/index.js";
-import { assertPresentationComponent, assertPresentationRuntime, } from "../contracts/presentation/index.js";
-import { createPiAgentEngineBridge } from "./agent-engine-bridge.js";
-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 = createPiAgentEngineBridge(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");
-        },
-    };
-}

package/dist/contracts/workspace/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./model.js";
-export * from "./validation.js";

package/dist/contracts/workspace/index.js

@@ -1,2 +0,0 @@
-export * from "./model.js";
-export * from "./validation.js";

package/dist/contracts/workspace/model.d.ts

@@ -1,248 +0,0 @@
-export declare const WORKSPACE_CONTRACT_VERSION: 1;
-export declare const NATIVE_HOST_PROTOCOL_VERSION: 1;
-export type WorkspaceId = string;
-export type AgentId = string;
-export type AdapterId = string;
-export type CorrelationId = string;
-export type EventPosition = number;
-export type WindowId = string;
-export type TabId = string;
-export type PaneId = string;
-export type TerminalSessionId = string;
-export type TopologyNodeId = string;
-export type NativeHostInstanceId = string;
-export type RecoveryReferenceId = string;
-export type AgentRuntimeKind = "structured" | "composed-terminal";
-export type AgentLifecycleState = "creating" | "ready" | "inactive" | "stopping" | "stopped" | "failed" | "discontinuous";
-export interface StructuredFlowLimits {
-    readonly maxEventBytes: number;
-    readonly maxSnapshotBytes: number;
-    readonly maxAttachmentBytes: number;
-    readonly maxQueuedEvents: number;
-    readonly maxConcurrentCommands: number;
-    readonly maxReconnectEvents: number;
-}
-export interface StructuredCapabilityContract {
-    readonly kind: "structured";
-    readonly protocolVersion: typeof WORKSPACE_CONTRACT_VERSION;
-    readonly adapterId: AdapterId;
-    readonly commands: readonly string[];
-    readonly eventTypes: readonly string[];
-    readonly snapshots: "none" | "authoritative";
-    readonly resume: "none" | "position" | "snapshot";
-    readonly cancellation: "none" | "correlated";
-    readonly attachmentTypes: readonly string[];
-    readonly flow: StructuredFlowLimits;
-}
-export interface ComposedTerminalCapabilityContract {
-    readonly kind: "composed-terminal";
-    readonly protocolVersion: typeof NATIVE_HOST_PROTOCOL_VERSION;
-    readonly hostInstanceId: NativeHostInstanceId;
-    readonly topologyRevision: number;
-    readonly proofStatus: "unavailable" | "pending" | "accepted" | "rejected";
-}
-export type AgentCapabilityContract = StructuredCapabilityContract | ComposedTerminalCapabilityContract;
-export interface ManagedAgentDescriptor {
-    readonly id: AgentId;
-    readonly displayName: string;
-    readonly adapterId: AdapterId;
-    readonly runtime: AgentRuntimeKind;
-    readonly lifecycle: AgentLifecycleState;
-    readonly capability: AgentCapabilityContract;
-    readonly createdAt: string;
-    readonly recoveryReferenceId: RecoveryReferenceId | null;
-}
-export interface TerminalDimensions {
-    readonly columns: number;
-    readonly rows: number;
-    readonly widthPixels: number;
-    readonly heightPixels: number;
-}
-export interface TerminalSessionLaunch {
-    readonly id: TerminalSessionId;
-    readonly executable: string;
-    readonly arguments: readonly string[];
-    readonly cwd: string;
-    readonly environment: Readonly<Record<string, string>>;
-    readonly dimensions: TerminalDimensions;
-    readonly inactivity: "live-unpainted" | "pause-display" | "suspend" | "terminate";
-}
-export interface TerminalPane {
-    readonly id: PaneId;
-    readonly sessionId: TerminalSessionId;
-}
-export type TerminalTopologyNode = {
-    readonly id: TopologyNodeId;
-    readonly kind: "leaf";
-    readonly paneId: PaneId;
-} | {
-    readonly id: TopologyNodeId;
-    readonly kind: "split";
-    readonly axis: "horizontal" | "vertical";
-    readonly ratio: number;
-    readonly first: TopologyNodeId;
-    readonly second: TopologyNodeId;
-};
-export interface TerminalTab {
-    readonly id: TabId;
-    readonly rootNodeId: TopologyNodeId;
-    readonly focusedPaneId: PaneId;
-    readonly nodes: readonly TerminalTopologyNode[];
-    readonly panes: readonly TerminalPane[];
-}
-export interface TerminalWindow {
-    readonly id: WindowId;
-    readonly activeTabId: TabId;
-    readonly tabs: readonly TerminalTab[];
-}
-export interface TerminalTopologySnapshot {
-    readonly hostInstanceId: NativeHostInstanceId;
-    readonly revision: number;
-    readonly windows: readonly TerminalWindow[];
-    readonly sessions: readonly TerminalSessionLaunch[];
-}
-export type WorkspaceCommand = {
-    readonly type: "create-agent";
-    readonly correlationId: CorrelationId;
-    readonly agent: ManagedAgentDescriptor;
-} | {
-    readonly type: "select-agent";
-    readonly correlationId: CorrelationId;
-    readonly agentId: AgentId;
-} | {
-    readonly type: "rename-agent";
-    readonly correlationId: CorrelationId;
-    readonly agentId: AgentId;
-    readonly displayName: string;
-} | {
-    readonly type: "stop-agent" | "restart-agent" | "remove-agent";
-    readonly correlationId: CorrelationId;
-    readonly agentId: AgentId;
-} | {
-    readonly type: "structured-command";
-    readonly correlationId: CorrelationId;
-    readonly agentId: AgentId;
-    readonly command: string;
-    readonly payload: unknown;
-} | {
-    readonly type: "cancel-structured-command";
-    readonly correlationId: CorrelationId;
-    readonly agentId: AgentId;
-    readonly targetCorrelationId: CorrelationId;
-};
-export type WorkspaceEvent = {
-    readonly type: "agent-lifecycle";
-    readonly agentId: AgentId;
-    readonly position: EventPosition;
-    readonly state: AgentLifecycleState;
-} | {
-    readonly type: "structured-event";
-    readonly agentId: AgentId;
-    readonly position: EventPosition;
-    readonly eventType: string;
-    readonly payload: unknown;
-} | {
-    readonly type: "command-outcome";
-    readonly agentId: AgentId;
-    readonly correlationId: CorrelationId;
-    readonly outcome: "accepted" | "rejected" | "completed" | "failed" | "timed-out" | "cancelled";
-} | {
-    readonly type: "terminal-topology";
-    readonly agentId: AgentId;
-    readonly topology: TerminalTopologySnapshot;
-} | {
-    readonly type: "recovery-discontinuity";
-    readonly agentId: AgentId;
-    readonly reason: string;
-};
-export interface WorkspaceSnapshot {
-    readonly contractVersion: typeof WORKSPACE_CONTRACT_VERSION;
-    readonly workspaceId: WorkspaceId;
-    readonly revision: number;
-    readonly selectedAgentId: AgentId | null;
-    readonly agents: readonly ManagedAgentDescriptor[];
-}
-export interface StructuredAgentSnapshot {
-    readonly contractVersion: typeof WORKSPACE_CONTRACT_VERSION;
-    readonly agentId: AgentId;
-    readonly snapshotId: string;
-    readonly position: EventPosition;
-    readonly authoritative: true;
-    readonly payload: unknown;
-}
-export interface NativeHostHello {
-    readonly protocolVersion: typeof NATIVE_HOST_PROTOCOL_VERSION;
-    readonly hostInstanceId: NativeHostInstanceId;
-    readonly buildId: string;
-    readonly platform: "windows" | "macos" | "linux";
-    readonly capabilities: readonly ("exact-command" | "revisioned-topology" | "native-input" | "native-rendering" | "retained-terminal-state")[];
-}
-export type NativeHostCommand = {
-    readonly type: "snapshot";
-    readonly correlationId: CorrelationId;
-} | {
-    readonly type: "apply-topology";
-    readonly correlationId: CorrelationId;
-    readonly expectedRevision: number;
-    readonly topology: TerminalTopologySnapshot;
-} | {
-    readonly type: "focus-pane";
-    readonly correlationId: CorrelationId;
-    readonly expectedRevision: number;
-    readonly paneId: PaneId;
-} | {
-    readonly type: "close-pane";
-    readonly correlationId: CorrelationId;
-    readonly expectedRevision: number;
-    readonly paneId: PaneId;
-} | {
-    readonly type: "shutdown";
-    readonly correlationId: CorrelationId;
-};
-export type NativeHostEvent = {
-    readonly type: "topology-changed";
-    readonly topology: TerminalTopologySnapshot;
-} | {
-    readonly type: "pane-ready";
-    readonly paneId: PaneId;
-    readonly sessionId: TerminalSessionId;
-} | {
-    readonly type: "process-exited";
-    readonly paneId: PaneId;
-    readonly sessionId: TerminalSessionId;
-    readonly exitCode: number | null;
-    readonly signal: string | null;
-} | {
-    readonly type: "host-degraded";
-    readonly code: string;
-    readonly message: string;
-};
-export interface StructuredRecoveryAuthority {
-    readonly kind: "structured";
-    readonly referenceId: RecoveryReferenceId;
-    readonly agentId: AgentId;
-    readonly adapterId: AdapterId;
-    readonly processIdentity: string;
-    readonly ownershipProof: string;
-    readonly boundary: {
-        readonly kind: "position";
-        readonly position: EventPosition;
-        readonly resumeToken: string;
-    } | {
-        readonly kind: "snapshot";
-        readonly snapshotId: string;
-    };
-}
-export interface ComposedRecoveryAuthority {
-    readonly kind: "composed-terminal";
-    readonly referenceId: RecoveryReferenceId;
-    readonly agentId: AgentId;
-    readonly hostInstanceId: NativeHostInstanceId;
-    readonly hostBuildId: string;
-    readonly processIdentity: string;
-    readonly pseudoterminalIdentity: string;
-    readonly retainedStateIdentity: string;
-    readonly topologyRevision: number;
-    readonly streamPosition: number;
-}
-export type AgentRecoveryAuthority = StructuredRecoveryAuthority | ComposedRecoveryAuthority;

package/dist/contracts/workspace/model.js

@@ -1,2 +0,0 @@
-export const WORKSPACE_CONTRACT_VERSION = 1;
-export const NATIVE_HOST_PROTOCOL_VERSION = 1;

package/dist/contracts/workspace/validation.d.ts

@@ -1,13 +0,0 @@
-import type { AgentCapabilityContract, AgentRecoveryAuthority, ComposedTerminalCapabilityContract, ManagedAgentDescriptor, NativeHostCommand, StructuredAgentSnapshot, StructuredCapabilityContract, TerminalSessionLaunch, TerminalTopologySnapshot, WorkspaceCommand, WorkspaceEvent, WorkspaceSnapshot } from "./model.js";
-export declare function assertManagedAgentDescriptor(agent: ManagedAgentDescriptor): void;
-export declare function assertAgentCapability(capability: AgentCapabilityContract): void;
-export declare function assertStructuredCapability(capability: StructuredCapabilityContract): void;
-export declare function assertComposedTerminalCapability(capability: ComposedTerminalCapabilityContract): void;
-export declare function assertWorkspaceSnapshot(snapshot: WorkspaceSnapshot): void;
-export declare function assertWorkspaceCommand(command: WorkspaceCommand): void;
-export declare function assertWorkspaceEvent(event: WorkspaceEvent): void;
-export declare function assertStructuredAgentSnapshot(snapshot: StructuredAgentSnapshot): void;
-export declare function assertTerminalTopologySnapshot(topology: TerminalTopologySnapshot): void;
-export declare function assertNativeHostCommand(command: NativeHostCommand): void;
-export declare function assertRecoveryAuthority(authority: AgentRecoveryAuthority): void;
-export declare function assertTerminalSessionLaunch(session: TerminalSessionLaunch): void;