@timurproko/a1 0.1.8-dev.de7821a → 0.2.0

package/dist/src/foundation/ui-components/value-menu.d.ts

@@ -1,41 +0,0 @@
-import type { UiTheme } from "./theme.js";
-/**
- * The menu a value opens: anchored to the row it was opened from, marking what
- * is in effect, highlighting nothing until something is picked, and flipping
- * above its anchor only when it would otherwise run off the bottom.
- */
-export interface ValueMenuState {
-    /** Values offered, as they should read. */
-    readonly choices: readonly string[];
-    /** The value in effect, marked rather than highlighted. */
-    readonly current: string | null;
-    /** The entry picked by a key or the pointer, or -1 while none is. */
-    readonly index: number;
-}
-export interface ValueMenuAnchor {
-    /** Row the menu was opened from, which it keeps even as the selection moves. */
-    readonly screenRow: number;
-    /** Column the values start at. */
-    readonly valueColumn: number;
-}
-/** Where a menu sits on screen, for reading a pointer against it. */
-export interface ValueMenuFrame {
-    readonly top: number;
-    readonly column: number;
-    readonly width: number;
-    readonly rows: number;
-}
-export interface ValueMenuLayout {
-    /** Rows available above the footer. */
-    readonly bodyHeight: number;
-    /** Full surface width, so the menu stays inside it. */
-    readonly surfaceWidth: number;
-    /** Columns reserved at the right edge, such as a scrollbar rail. */
-    readonly reservedRight: number;
-}
-/** Where the menu is placed: below its anchor where there is room, else above. */
-export declare function valueMenuFrame(state: ValueMenuState, anchor: ValueMenuAnchor, layout: ValueMenuLayout): ValueMenuFrame;
-/** Draws the menu over the rows behind it, leaving them otherwise untouched. */
-export declare function renderValueMenu(lines: readonly string[], state: ValueMenuState, frame: ValueMenuFrame, theme: UiTheme): readonly string[];
-/** Whether a pointer report lands inside the menu rather than behind it. */
-export declare function menuRowAt(frame: ValueMenuFrame, row: number, column: number): number | null;

package/dist/src/foundation/ui-components/value-menu.js

@@ -1,33 +0,0 @@
-import { overlaySpan } from "./spans.js";
-import { displayWidth, padToWidth } from "./text.js";
-/** Where the menu is placed: below its anchor where there is room, else above. */
-export function valueMenuFrame(state, anchor, layout) {
-    const below = anchor.screenRow + 1;
-    const top = below + state.choices.length <= layout.bodyHeight
-        ? below
-        : Math.max(0, anchor.screenRow - state.choices.length);
-    const width = Math.max(...state.choices.map(choice => displayWidth(choice) + 4), 6);
-    const column = Math.min(anchor.valueColumn, Math.max(0, layout.surfaceWidth - width - layout.reservedRight));
-    return { top, column, width, rows: state.choices.length };
-}
-/** Draws the menu over the rows behind it, leaving them otherwise untouched. */
-export function renderValueMenu(lines, state, frame, theme) {
-    const output = [...lines];
-    state.choices.forEach((choice, index) => {
-        const target = frame.top + index;
-        if (target < 0 || target >= output.length)
-            return;
-        const mark = choice === state.current ? "✓ " : "  ";
-        const text = padToWidth(`${mark}${choice} `, frame.width);
-        const painted = index === state.index ? theme.highlight(text) : theme.panel(text);
-        output[target] = overlaySpan(output[target] ?? "", frame.column, frame.column + frame.width, painted);
-    });
-    return output;
-}
-/** Whether a pointer report lands inside the menu rather than behind it. */
-export function menuRowAt(frame, row, column) {
-    const at = row - frame.top;
-    if (at < 0 || at >= frame.rows)
-        return null;
-    return column > frame.column && column <= frame.column + frame.width ? at : null;
-}

package/dist/src/foundation/workspace-contracts/index.d.ts

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

package/dist/src/foundation/workspace-contracts/index.js

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

package/dist/src/foundation/workspace-contracts/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/src/foundation/workspace-contracts/model.js

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

package/dist/src/foundation/workspace-contracts/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;