@townco/ui 0.1.50 → 0.1.52

package/dist/sdk/client/acp-client.d.ts

@@ -1,5 +1,5 @@
 import type { MessageChunk, Session, SessionConfig, SessionUpdate } from "../schemas/index.js";
-import type { HttpTransportOptions, StdioTransportOptions, WebSocketTransportOptions } from "../transports/index.js";
+import type { HttpTransportOptions, SessionSummary, StdioTransportOptions, WebSocketTransportOptions } from "../transports/index.js";
 /**
  * Client configuration with explicit transport selection
  */
@@ -48,6 +48,10 @@ export declare class AcpClient {
      * Load an existing session
      */
     loadSession(sessionId: string, config?: Partial<SessionConfig>): Promise<string>;
+    /**
+     * List available sessions
+     */
+    listSessions(): Promise<SessionSummary[]>;
     /**
      * Send a message in the current session
      */
@@ -89,6 +93,7 @@ export declare class AcpClient {
      * - tools: List of tools available to the agent
      * - mcps: List of MCP servers connected to the agent
      * - subagents: List of subagents available via Task tool
+     * - uiConfig: UI configuration for interface appearance
      */
     getAgentInfo(): {
         name?: string;
@@ -96,6 +101,9 @@ export declare class AcpClient {
         version?: string;
         description?: string;
         suggestedPrompts?: string[];
+        uiConfig?: {
+            hideTopBar?: boolean;
+        };
         tools?: Array<{
             name: string;
             description?: string;

package/dist/sdk/client/acp-client.js

@@ -131,6 +131,15 @@ export class AcpClient {
         this.updateSessionStatus(sessionId, "connected");
         return sessionId;
     }
+    /**
+     * List available sessions
+     */
+    async listSessions() {
+        if (!this.transport.listSessions) {
+            return [];
+        }
+        return this.transport.listSessions();
+    }
     /**
      * Send a message in the current session
      */
@@ -236,6 +245,7 @@ export class AcpClient {
      * - tools: List of tools available to the agent
      * - mcps: List of MCP servers connected to the agent
      * - subagents: List of subagents available via Task tool
+     * - uiConfig: UI configuration for interface appearance
      */
     getAgentInfo() {
         return this.transport.getAgentInfo?.() || {};

package/dist/sdk/schemas/message.d.ts

@@ -13,9 +13,9 @@ export type MessageRole = z.infer<typeof MessageRole>;
  * Content type for messages
  */
 export declare const ContentType: z.ZodEnum<{
+    file: "file";
     text: "text";
     image: "image";
-    file: "file";
     tool_call: "tool_call";
     tool_result: "tool_result";
 }>;
@@ -25,9 +25,9 @@ export type ContentType = z.infer<typeof ContentType>;
  */
 export declare const BaseContent: z.ZodObject<{
     type: z.ZodEnum<{
+        file: "file";
         text: "text";
         image: "image";
-        file: "file";
         tool_call: "tool_call";
         tool_result: "tool_result";
     }>;

package/dist/sdk/schemas/session.d.ts

@@ -249,6 +249,100 @@ export declare const SessionUpdate: z.ZodUnion<readonly [z.ZodObject<{
             originalTokens: z.ZodOptional<z.ZodNumber>;
             finalTokens: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        subagentPort: z.ZodOptional<z.ZodNumber>;
+        subagentSessionId: z.ZodOptional<z.ZodString>;
+        subagentMessages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            content: z.ZodString;
+            toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                prettyName: z.ZodOptional<z.ZodString>;
+                icon: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<{
+                    pending: "pending";
+                    in_progress: "in_progress";
+                    completed: "completed";
+                    failed: "failed";
+                }>;
+                content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"content">;
+                    content: z.ZodObject<{
+                        type: z.ZodLiteral<"text">;
+                        text: z.ZodString;
+                    }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"image">;
+                    data: z.ZodString;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                    alt: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"image">;
+                    url: z.ZodString;
+                    alt: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"diff">;
+                    path: z.ZodString;
+                    oldText: z.ZodString;
+                    newText: z.ZodString;
+                    line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"terminal">;
+                    terminalId: z.ZodString;
+                }, z.core.$strip>], "type">>>;
+            }, z.core.$strip>>>;
+            contentBlocks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"tool_call">;
+                toolCall: z.ZodObject<{
+                    id: z.ZodString;
+                    title: z.ZodString;
+                    prettyName: z.ZodOptional<z.ZodString>;
+                    icon: z.ZodOptional<z.ZodString>;
+                    status: z.ZodEnum<{
+                        pending: "pending";
+                        in_progress: "in_progress";
+                        completed: "completed";
+                        failed: "failed";
+                    }>;
+                    content: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"content">;
+                        content: z.ZodObject<{
+                            type: z.ZodLiteral<"text">;
+                            text: z.ZodString;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"text">;
+                        text: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"image">;
+                        data: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                        alt: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"image">;
+                        url: z.ZodString;
+                        alt: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"diff">;
+                        path: z.ZodString;
+                        oldText: z.ZodString;
+                        newText: z.ZodString;
+                        line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"terminal">;
+                        terminalId: z.ZodString;
+                    }, z.core.$strip>], "type">>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>], "type">>>;
+            isStreaming: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        subagentStreaming: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     messageId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
@@ -363,6 +457,8 @@ export declare const SessionUpdate: z.ZodUnion<readonly [z.ZodObject<{
             outputTokens: z.ZodOptional<z.ZodNumber>;
             totalTokens: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        subagentPort: z.ZodOptional<z.ZodNumber>;
+        subagentSessionId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     messageId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{

package/dist/sdk/transports/http.d.ts

@@ -1,5 +1,5 @@
 import type { Message, MessageChunk, SessionUpdate } from "../schemas/index.js";
-import type { HttpTransportOptions, Transport } from "./types.js";
+import type { HttpTransportOptions, SessionSummary, Transport } from "./types.js";
 /**
  * HTTP transport implementation using ACP over HTTP + SSE
  * Uses POST /rpc for client->agent messages and GET /events (SSE) for agent->client
@@ -29,6 +29,10 @@ export declare class HttpTransport implements Transport {
      * @param sessionId - The session ID to load
      */
     loadSession(sessionId: string): Promise<void>;
+    /**
+     * List available sessions from the server
+     */
+    listSessions(): Promise<SessionSummary[]>;
     disconnect(): Promise<void>;
     send(message: Message): Promise<void>;
     receive(): AsyncIterableIterator<MessageChunk>;
@@ -41,6 +45,13 @@ export declare class HttpTransport implements Transport {
         version?: string;
         description?: string;
         suggestedPrompts?: string[];
+        initialMessage?: {
+            enabled: boolean;
+            content: string;
+        };
+        uiConfig?: {
+            hideTopBar?: boolean;
+        };
         tools?: Array<{
             name: string;
             description?: string;

package/dist/sdk/transports/http.js

@@ -65,6 +65,18 @@ export class HttpTransport {
                 const subagents = metaIsObject && "subagents" in meta && Array.isArray(meta.subagents)
                     ? meta.subagents
                     : undefined;
+                const initialMessage = metaIsObject &&
+                    "initialMessage" in meta &&
+                    meta.initialMessage &&
+                    typeof meta.initialMessage === "object"
+                    ? meta.initialMessage
+                    : undefined;
+                const uiConfig = metaIsObject &&
+                    "uiConfig" in meta &&
+                    meta.uiConfig &&
+                    typeof meta.uiConfig === "object"
+                    ? meta.uiConfig
+                    : undefined;
                 this.agentInfo = {
                     name: initResponse.agentInfo.name,
                     // title is the ACP field for human-readable display name
@@ -74,6 +86,8 @@ export class HttpTransport {
                     version: initResponse.agentInfo.version,
                     ...(description ? { description } : {}),
                     ...(suggestedPrompts ? { suggestedPrompts } : {}),
+                    ...(initialMessage ? { initialMessage } : {}),
+                    ...(uiConfig ? { uiConfig } : {}),
                     ...(tools ? { tools } : {}),
                     ...(mcps ? { mcps } : {}),
                     ...(subagents ? { subagents } : {}),
@@ -146,6 +160,18 @@ export class HttpTransport {
                 const subagents = metaIsObject && "subagents" in meta && Array.isArray(meta.subagents)
                     ? meta.subagents
                     : undefined;
+                const initialMessage = metaIsObject &&
+                    "initialMessage" in meta &&
+                    meta.initialMessage &&
+                    typeof meta.initialMessage === "object"
+                    ? meta.initialMessage
+                    : undefined;
+                const uiConfig = metaIsObject &&
+                    "uiConfig" in meta &&
+                    meta.uiConfig &&
+                    typeof meta.uiConfig === "object"
+                    ? meta.uiConfig
+                    : undefined;
                 this.agentInfo = {
                     name: initResponse.agentInfo.name,
                     // title is the ACP field for human-readable display name
@@ -155,6 +181,8 @@ export class HttpTransport {
                     version: initResponse.agentInfo.version,
                     ...(description ? { description } : {}),
                     ...(suggestedPrompts ? { suggestedPrompts } : {}),
+                    ...(initialMessage ? { initialMessage } : {}),
+                    ...(uiConfig ? { uiConfig } : {}),
                     ...(tools ? { tools } : {}),
                     ...(mcps ? { mcps } : {}),
                     ...(subagents ? { subagents } : {}),
@@ -204,6 +232,29 @@ export class HttpTransport {
             throw err;
         }
     }
+    /**
+     * List available sessions from the server
+     */
+    async listSessions() {
+        try {
+            const fetchOptions = {
+                method: "GET",
+            };
+            if (this.options.headers) {
+                fetchOptions.headers = this.options.headers;
+            }
+            const response = await fetch(`${this.options.baseUrl}/sessions`, fetchOptions);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+            }
+            const data = await response.json();
+            return data.sessions || [];
+        }
+        catch (error) {
+            logger.error("Failed to list sessions", { error });
+            return [];
+        }
+    }
     async disconnect() {
         if (!this.connected) {
             return;
@@ -736,6 +787,28 @@ export class HttpTransport {
                 typeof update._meta.batchId === "string"
                 ? update._meta.batchId
                 : undefined;
+            // Extract subagent connection info from _meta
+            const subagentPort = update._meta &&
+                typeof update._meta === "object" &&
+                "subagentPort" in update._meta &&
+                typeof update._meta.subagentPort === "number"
+                ? update._meta.subagentPort
+                : undefined;
+            const subagentSessionId = update._meta &&
+                typeof update._meta === "object" &&
+                "subagentSessionId" in update._meta &&
+                typeof update._meta.subagentSessionId === "string"
+                ? update._meta.subagentSessionId
+                : undefined;
+            // Debug logging for subagent connection info
+            if (subagentPort || subagentSessionId) {
+                logger.info("Extracted subagent connection info from tool_call_update", {
+                    toolCallId: update.toolCallId,
+                    subagentPort,
+                    subagentSessionId,
+                    _meta: update._meta,
+                });
+            }
             // Tool call update notification
             const toolCallUpdate = {
                 id: update.toolCallId ?? "",
@@ -798,6 +871,9 @@ export class HttpTransport {
                 completedAt: update.status === "completed" || update.status === "failed"
                     ? Date.now()
                     : undefined,
+                // Sub-agent connection info for direct SSE streaming
+                subagentPort,
+                subagentSessionId,
             };
             const sessionUpdate = {
                 type: "tool_call_update",
@@ -982,7 +1058,7 @@ export class HttpTransport {
                             timestamp: new Date().toISOString(),
                         },
                     };
-                    // Notify as a complete message (for session replay)
+                    // Notify as a complete message (for session replay or initial message)
                     this.notifySessionUpdate(messageSessionUpdate);
                 }
             }

package/dist/sdk/transports/stdio.d.ts

@@ -31,6 +31,9 @@ export declare class StdioTransport implements Transport {
         version?: string;
         description?: string;
         suggestedPrompts?: string[];
+        uiConfig?: {
+            hideTopBar?: boolean;
+        };
         tools?: Array<{
             name: string;
             description?: string;

package/dist/sdk/transports/types.d.ts

@@ -22,6 +22,32 @@ export interface AgentSubagentInfo {
     name: string;
     description: string;
 }
+/**
+ * Initial message configuration for agents
+ */
+export interface AgentInitialMessage {
+    /** Whether the agent should send an initial message when a session starts */
+    enabled: boolean;
+    /** The content of the initial message */
+    content: string;
+}
+/**
+ * UI configuration for agents
+ */
+export interface AgentUiConfig {
+    /** Whether to hide the top bar (session switcher, debugger link, settings) */
+    hideTopBar?: boolean;
+}
+/**
+ * Session summary for listing
+ */
+export interface SessionSummary {
+    sessionId: string;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+    firstUserMessage?: string;
+}
 /**
  * Transport interface for different communication methods
  */
@@ -34,6 +60,10 @@ export interface Transport {
      * Load an existing session (optional, not all transports support this)
      */
     loadSession?(sessionId: string): Promise<void>;
+    /**
+     * List available sessions (optional, not all transports support this)
+     */
+    listSessions?(): Promise<SessionSummary[]>;
     /**
      * Close the transport connection
      */
@@ -66,6 +96,8 @@ export interface Transport {
      * - tools: List of tools available to the agent
      * - mcps: List of MCP servers connected to the agent
      * - subagents: List of subagents available via Task tool
+     * - initialMessage: Configuration for agent's initial message on session start
+     * - uiConfig: UI configuration for controlling interface appearance
      */
     getAgentInfo?(): {
         name?: string;
@@ -73,6 +105,8 @@ export interface Transport {
         version?: string;
         description?: string;
         suggestedPrompts?: string[];
+        initialMessage?: AgentInitialMessage;
+        uiConfig?: AgentUiConfig;
         tools?: AgentToolInfo[];
         mcps?: AgentMcpInfo[];
         subagents?: AgentSubagentInfo[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@townco/ui",
-  "version": "0.1.50",
+  "version": "0.1.52",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.5.1",
-    "@townco/core": "0.0.28",
+    "@townco/core": "0.0.30",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-label": "^2.1.8",
@@ -67,7 +67,7 @@
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.17",
-    "@townco/tsconfig": "0.1.47",
+    "@townco/tsconfig": "0.1.49",
     "@types/node": "^24.10.0",
     "@types/react": "^19.2.2",
     "ink": "^6.4.0",