acpx 0.1.13 → 0.1.15

package/README.md

@@ -10,7 +10,8 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/node/v/acpx.svg)](https://nodejs.org)
 
-> Alpha notice: `acpx` is in alpha and the CLI/runtime interfaces are likely to change.
+> ⚠️ `acpx` is in alpha and the CLI/runtime interfaces are likely to change. Anything you build downstream of this might break until it stabilizes.
+
 > ACP coverage status: see [ACP Spec Coverage Roadmap](docs/2026-02-19-acp-coverage-roadmap.md).
 
 Your agents love acpx! 🤖❤️ They hate having to scrape characters from a PTY session 😤

package/dist/cli.d.ts

@@ -1,21 +1,102 @@
 #!/usr/bin/env node
-import { AgentCapabilities } from '@agentclientprotocol/sdk';
+import { AgentCapabilities, SessionConfigOption } from '@agentclientprotocol/sdk';
 
-type SessionHistoryRole = "user" | "assistant";
-type SessionHistoryEntry = {
-    role: SessionHistoryRole;
-    timestamp: string;
-    textPreview: string;
+type SessionEventLog = {
+    active_path: string;
+    segment_count: number;
+    max_segment_bytes: number;
+    max_segments: number;
+    last_write_at?: string;
+    last_write_error?: string | null;
 };
-type SessionRecord = {
+declare const SESSION_RECORD_SCHEMA: "acpx.session.v1";
+type SessionMessageImage = {
+    source: string;
+    size?: {
+        width: number;
+        height: number;
+    } | null;
+};
+type SessionUserContent = {
+    Text: string;
+} | {
+    Mention: {
+        uri: string;
+        content: string;
+    };
+} | {
+    Image: SessionMessageImage;
+};
+type SessionToolUse = {
+    id: string;
+    name: string;
+    raw_input: string;
+    input: unknown;
+    is_input_complete: boolean;
+    thought_signature?: string | null;
+};
+type SessionToolResultContent = {
+    Text: string;
+} | {
+    Image: SessionMessageImage;
+};
+type SessionToolResult = {
+    tool_use_id: string;
+    tool_name: string;
+    is_error: boolean;
+    content: SessionToolResultContent;
+    output?: unknown;
+};
+type SessionAgentContent = {
+    Text: string;
+} | {
+    Thinking: {
+        text: string;
+        signature?: string | null;
+    };
+} | {
+    RedactedThinking: string;
+} | {
+    ToolUse: SessionToolUse;
+};
+type SessionUserMessage = {
     id: string;
-    sessionId: string;
+    content: SessionUserContent[];
+};
+type SessionAgentMessage = {
+    content: SessionAgentContent[];
+    tool_results: Record<string, SessionToolResult>;
+    reasoning_details?: unknown | null;
+};
+type SessionMessage = {
+    User: SessionUserMessage;
+} | {
+    Agent: SessionAgentMessage;
+} | "Resume";
+type SessionTokenUsage = {
+    input_tokens?: number;
+    output_tokens?: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+};
+type SessionAcpxState = {
+    current_mode_id?: string;
+    available_commands?: string[];
+    config_options?: SessionConfigOption[];
+};
+type SessionRecord = {
+    schema: typeof SESSION_RECORD_SCHEMA;
+    acpxRecordId: string;
+    acpSessionId: string;
     agentSessionId?: string;
     agentCommand: string;
     cwd: string;
     name?: string;
     createdAt: string;
     lastUsedAt: string;
+    lastSeq: number;
+    lastRequestId?: string;
+    eventLog: SessionEventLog;
     closed?: boolean;
     closedAt?: string;
     pid?: number;
@@ -25,13 +106,19 @@ type SessionRecord = {
     lastAgentExitSignal?: NodeJS.Signals | null;
     lastAgentExitAt?: string;
     lastAgentDisconnectReason?: string;
-    turnHistory?: SessionHistoryEntry[];
     protocolVersion?: number;
     agentCapabilities?: AgentCapabilities;
+    title?: string | null;
+    messages: SessionMessage[];
+    updated_at: string;
+    cumulative_token_usage: SessionTokenUsage;
+    request_token_usage: Record<string, SessionTokenUsage>;
+    acpx?: SessionAcpxState;
 };
 
 declare function parseTtlSeconds(value: string): number;
-declare function formatPromptSessionBannerLine(record: SessionRecord, currentCwd: string): string;
-declare function main(argv?: string[]): Promise<void>;
 
-export { formatPromptSessionBannerLine, main, parseTtlSeconds };
+type SessionConnectionStatus = "connected" | "needs reconnect";
+declare function formatPromptSessionBannerLine(record: SessionRecord, currentCwd: string, connectionStatus?: SessionConnectionStatus): string;
+
+export { formatPromptSessionBannerLine, parseTtlSeconds };