@townco/ui 0.1.67 → 0.1.69

package/dist/gui/lib/motion.d.ts

@@ -0,0 +1,55 @@
+import type { Transition, Variants } from "framer-motion";
+/**
+ * Motion utilities and reusable animation variants for the UI package
+ * Provides consistent animation behavior across components
+ */
+export declare const motionDuration: {
+    readonly fast: 0.15;
+    readonly normal: 0.25;
+    readonly slow: 0.4;
+};
+export declare const motionEasing: {
+    readonly smooth: readonly [0.25, 0.1, 0.25, 1];
+    readonly bounce: readonly [0.68, -0.55, 0.265, 1.55];
+    readonly sharp: readonly [0.4, 0, 0.2, 1];
+    readonly gentle: readonly [0.25, 0.46, 0.45, 0.94];
+};
+export declare const fadeInVariants: Variants;
+export declare const fadeInUpVariants: Variants;
+export declare const expandCollapseVariants: Variants;
+export declare const slideDownVariants: Variants;
+export declare const shimmerTransition: Transition;
+export declare const shimmerVariants: Variants;
+export declare const scaleInVariants: Variants;
+export declare const pulseVariants: Variants;
+export declare const rotateVariants: Variants;
+export declare const standardTransition: Transition;
+export declare const fastTransition: Transition;
+export declare const slowTransition: Transition;
+export declare const springTransition: Transition;
+export declare const gentleSpringTransition: Transition;
+export declare const layoutTransition: Transition;
+export declare const staggerChildren: {
+    visible: {
+        transition: {
+            staggerChildren: number;
+        };
+    };
+};
+export declare const staggerChildrenFast: {
+    visible: {
+        transition: {
+            staggerChildren: number;
+        };
+    };
+};
+export declare const slideInFromRightVariants: Variants;
+export declare const slideOutToRightVariants: Variants;
+/**
+ * Get transition with reduced motion consideration
+ */
+export declare function getTransition(shouldReduceMotion: boolean, transition?: Transition): Transition;
+/**
+ * Get duration with reduced motion consideration
+ */
+export declare function getDuration(shouldReduceMotion: boolean, duration?: number): number;

package/dist/gui/lib/motion.js

@@ -0,0 +1,217 @@
+/**
+ * Motion utilities and reusable animation variants for the UI package
+ * Provides consistent animation behavior across components
+ */
+// ============================================================================
+// Standard Durations
+// ============================================================================
+export const motionDuration = {
+    fast: 0.15,
+    normal: 0.25,
+    slow: 0.4,
+};
+// ============================================================================
+// Standard Easings
+// ============================================================================
+export const motionEasing = {
+    // Smooth, natural easing
+    smooth: [0.25, 0.1, 0.25, 1],
+    // Bouncy, playful easing
+    bounce: [0.68, -0.55, 0.265, 1.55],
+    // Sharp, snappy easing
+    sharp: [0.4, 0, 0.2, 1],
+    // Gentle, subtle easing
+    gentle: [0.25, 0.46, 0.45, 0.94],
+};
+// ============================================================================
+// Fade Variants
+// ============================================================================
+export const fadeInVariants = {
+    hidden: {
+        opacity: 0,
+    },
+    visible: {
+        opacity: 1,
+    },
+};
+export const fadeInUpVariants = {
+    hidden: {
+        opacity: 0,
+        y: 8,
+    },
+    visible: {
+        opacity: 1,
+        y: 0,
+    },
+};
+// ============================================================================
+// Expand/Collapse Variants
+// ============================================================================
+export const expandCollapseVariants = {
+    collapsed: {
+        height: 0,
+        opacity: 0,
+        overflow: "hidden",
+    },
+    expanded: {
+        height: "auto",
+        opacity: 1,
+        overflow: "visible",
+    },
+};
+export const slideDownVariants = {
+    hidden: {
+        opacity: 0,
+        height: 0,
+        y: -4,
+    },
+    visible: {
+        opacity: 1,
+        height: "auto",
+        y: 0,
+    },
+};
+// ============================================================================
+// Shimmer Effect
+// ============================================================================
+export const shimmerTransition = {
+    duration: 2,
+    ease: "linear",
+    repeat: Infinity,
+    repeatType: "loop",
+};
+// For shimmer, we'll use a background gradient that shifts
+export const shimmerVariants = {
+    idle: {
+        backgroundPosition: "200% 0",
+    },
+    active: {
+        backgroundPosition: "-200% 0",
+    },
+};
+// ============================================================================
+// Scale Variants
+// ============================================================================
+export const scaleInVariants = {
+    hidden: {
+        scale: 0.95,
+        opacity: 0,
+    },
+    visible: {
+        scale: 1,
+        opacity: 1,
+    },
+};
+export const pulseVariants = {
+    idle: {
+        scale: 1,
+    },
+    pulse: {
+        scale: [1, 1.05, 1],
+    },
+};
+// ============================================================================
+// Rotation Variants
+// ============================================================================
+export const rotateVariants = {
+    collapsed: {
+        rotate: 0,
+    },
+    expanded: {
+        rotate: 180,
+    },
+};
+// ============================================================================
+// Standard Transitions
+// ============================================================================
+export const standardTransition = {
+    duration: motionDuration.normal,
+    ease: motionEasing.smooth,
+};
+export const fastTransition = {
+    duration: motionDuration.fast,
+    ease: motionEasing.sharp,
+};
+export const slowTransition = {
+    duration: motionDuration.slow,
+    ease: motionEasing.gentle,
+};
+export const springTransition = {
+    type: "spring",
+    stiffness: 300,
+    damping: 30,
+};
+export const gentleSpringTransition = {
+    type: "spring",
+    stiffness: 200,
+    damping: 25,
+};
+// ============================================================================
+// Layout Transition (for shared layout animations)
+// ============================================================================
+export const layoutTransition = {
+    layout: {
+        duration: motionDuration.normal,
+        ease: motionEasing.smooth,
+    },
+};
+// ============================================================================
+// Stagger Configurations
+// ============================================================================
+export const staggerChildren = {
+    visible: {
+        transition: {
+            staggerChildren: 0.05,
+        },
+    },
+};
+export const staggerChildrenFast = {
+    visible: {
+        transition: {
+            staggerChildren: 0.03,
+        },
+    },
+};
+// ============================================================================
+// Slide Variants (for panels and drawers)
+// ============================================================================
+export const slideInFromRightVariants = {
+    hidden: {
+        x: "100%",
+        opacity: 0,
+    },
+    visible: {
+        x: 0,
+        opacity: 1,
+    },
+};
+export const slideOutToRightVariants = {
+    visible: {
+        x: 0,
+        opacity: 1,
+    },
+    hidden: {
+        x: "100%",
+        opacity: 0,
+    },
+};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get transition with reduced motion consideration
+ */
+export function getTransition(shouldReduceMotion, transition = standardTransition) {
+    if (shouldReduceMotion) {
+        return {
+            duration: 0.01,
+        };
+    }
+    return transition;
+}
+/**
+ * Get duration with reduced motion consideration
+ */
+export function getDuration(shouldReduceMotion, duration = motionDuration.normal) {
+    return shouldReduceMotion ? 0.01 : duration;
+}

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

@@ -4,10 +4,10 @@ import { z } from "zod";
  */
 export declare const SessionStatus: z.ZodEnum<{
     error: "error";
+    active: "active";
     idle: "idle";
     connecting: "connecting";
     connected: "connected";
-    active: "active";
     streaming: "streaming";
     disconnected: "disconnected";
 }>;
@@ -41,10 +41,10 @@ export declare const Session: z.ZodObject<{
     id: z.ZodString;
     status: z.ZodEnum<{
         error: "error";
+        active: "active";
         idle: "idle";
         connecting: "connecting";
         connected: "connected";
-        active: "active";
         streaming: "streaming";
         disconnected: "disconnected";
     }>;
@@ -117,10 +117,10 @@ export declare const SessionUpdate: z.ZodUnion<readonly [z.ZodObject<{
     sessionId: z.ZodString;
     status: z.ZodOptional<z.ZodEnum<{
         error: "error";
+        active: "active";
         idle: "idle";
         connecting: "connecting";
         connected: "connected";
-        active: "active";
         streaming: "streaming";
         disconnected: "disconnected";
     }>>;
@@ -178,6 +178,11 @@ export declare const SessionUpdate: z.ZodUnion<readonly [z.ZodObject<{
         title: z.ZodString;
         prettyName: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
+        verbiage: z.ZodOptional<z.ZodObject<{
+            active: z.ZodString;
+            past: z.ZodString;
+            paramKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         subline: z.ZodOptional<z.ZodString>;
         kind: z.ZodEnum<{
             read: "read";
@@ -349,10 +354,10 @@ export declare const SessionUpdate: z.ZodUnion<readonly [z.ZodObject<{
     sessionId: z.ZodString;
     status: z.ZodOptional<z.ZodEnum<{
         error: "error";
+        active: "active";
         idle: "idle";
         connecting: "connecting";
         connected: "connected";
-        active: "active";
         streaming: "streaming";
         disconnected: "disconnected";
     }>>;
@@ -459,16 +464,107 @@ export declare const SessionUpdate: z.ZodUnion<readonly [z.ZodObject<{
         }, 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>>>;
     }, z.core.$strip>;
     messageId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     sessionId: z.ZodString;
     status: z.ZodOptional<z.ZodEnum<{
         error: "error";
+        active: "active";
         idle: "idle";
         connecting: "connecting";
         connected: "connected";
-        active: "active";
         streaming: "streaming";
         disconnected: "disconnected";
     }>>;
@@ -530,10 +626,10 @@ export declare const SessionUpdate: z.ZodUnion<readonly [z.ZodObject<{
     sessionId: z.ZodString;
     status: z.ZodOptional<z.ZodEnum<{
         error: "error";
+        active: "active";
         idle: "idle";
         connecting: "connecting";
         connected: "connected";
-        active: "active";
         streaming: "streaming";
         disconnected: "disconnected";
     }>>;

package/dist/sdk/transports/http.js

@@ -695,6 +695,25 @@ export class HttpTransport {
                 typeof update._meta.batchId === "string"
                 ? update._meta.batchId
                 : undefined;
+            // Extract subagent connection info for replay
+            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;
+            const subagentMessages = update._meta &&
+                typeof update._meta === "object" &&
+                "subagentMessages" in update._meta &&
+                Array.isArray(update._meta.subagentMessages)
+                ? update._meta.subagentMessages
+                : undefined;
             // Initial tool call notification
             const toolCall = {
                 id: update.toolCallId ?? "",
@@ -755,6 +774,10 @@ export class HttpTransport {
                     return { type: "text", text: "" };
                 }),
                 startedAt: Date.now(),
+                // Sub-agent connection info and messages for replay
+                subagentPort,
+                subagentSessionId,
+                subagentMessages,
             };
             const sessionUpdate = {
                 type: "tool_call",
@@ -763,19 +786,41 @@ export class HttpTransport {
                 toolCall: toolCall,
                 messageId,
             };
-            // Queue tool call as a chunk for ordered processing
-            const toolCallChunk = {
-                type: "tool_call",
-                id: sessionId,
-                toolCall: toolCall,
-                messageId,
-            };
-            const resolver = this.chunkResolvers.shift();
-            if (resolver) {
-                resolver(toolCallChunk);
+            // Check if this is replay
+            const isReplay = update._meta &&
+                typeof update._meta === "object" &&
+                "isReplay" in update._meta &&
+                update._meta.isReplay === true;
+            // Debug: log tool call creation
+            logger.info("Creating tool_call session update", {
+                toolCallId: toolCall.id,
+                title: toolCall.title,
+                hasSubagentPort: !!subagentPort,
+                hasSubagentSessionId: !!subagentSessionId,
+                hasSubagentMessages: !!subagentMessages,
+                subagentMessagesCount: subagentMessages?.length,
+                isReplay,
+                isInReplayMode: this.isInReplayMode,
+            });
+            // During replay, notify directly since there's no active receive() consumer
+            if (isReplay || this.isInReplayMode) {
+                this.notifySessionUpdate(sessionUpdate);
             }
             else {
-                this.messageQueue.push(toolCallChunk);
+                // Queue tool call as a chunk for ordered processing during live streaming
+                const toolCallChunk = {
+                    type: "tool_call",
+                    id: sessionId,
+                    toolCall: toolCall,
+                    messageId,
+                };
+                const resolver = this.chunkResolvers.shift();
+                if (resolver) {
+                    resolver(toolCallChunk);
+                }
+                else {
+                    this.messageQueue.push(toolCallChunk);
+                }
             }
         }
         else if (update?.sessionUpdate === "tool_call_update") {
@@ -816,13 +861,19 @@ export class HttpTransport {
                 typeof update._meta.subagentSessionId === "string"
                 ? update._meta.subagentSessionId
                 : undefined;
+            const subagentMessages = update._meta &&
+                typeof update._meta === "object" &&
+                "subagentMessages" in update._meta &&
+                Array.isArray(update._meta.subagentMessages)
+                ? update._meta.subagentMessages
+                : undefined;
             // Debug logging for subagent connection info
-            if (subagentPort || subagentSessionId) {
-                logger.info("Extracted subagent connection info from tool_call_update", {
+            if (subagentPort || subagentSessionId || subagentMessages) {
+                logger.info("Extracted subagent info from tool_call_update", {
                     toolCallId: update.toolCallId,
                     subagentPort,
                     subagentSessionId,
-                    _meta: update._meta,
+                    subagentMessagesCount: subagentMessages?.length,
                 });
             }
             // Tool call update notification
@@ -890,6 +941,8 @@ export class HttpTransport {
                 // Sub-agent connection info for direct SSE streaming
                 subagentPort,
                 subagentSessionId,
+                // Sub-agent messages for replay
+                subagentMessages,
             };
             const sessionUpdate = {
                 type: "tool_call_update",
@@ -898,22 +951,31 @@ export class HttpTransport {
                 toolCallUpdate: toolCallUpdate,
                 messageId,
             };
-            // Queue tool call update as a chunk for ordered processing
-            const toolCallUpdateChunk = {
-                type: "tool_call_update",
-                id: sessionId,
-                toolCallUpdate: toolCallUpdate,
-                messageId,
-            };
-            const resolver = this.chunkResolvers.shift();
-            if (resolver) {
-                resolver(toolCallUpdateChunk);
+            // Check if this is replay (tool_call_update doesn't have isReplay in _meta,
+            // but we can check if we're in replay mode)
+            if (this.isInReplayMode) {
+                // During replay, notify directly since there's no active receive() consumer
+                this.notifySessionUpdate(sessionUpdate);
             }
             else {
-                this.messageQueue.push(toolCallUpdateChunk);
+                // Queue tool call update as a chunk for ordered processing
+                const toolCallUpdateChunk = {
+                    type: "tool_call_update",
+                    id: sessionId,
+                    toolCallUpdate: toolCallUpdate,
+                    messageId,
+                };
+                const resolver = this.chunkResolvers.shift();
+                if (resolver) {
+                    resolver(toolCallUpdateChunk);
+                }
+                else {
+                    this.messageQueue.push(toolCallUpdateChunk);
+                }
             }
-            logger.debug("Queued tool_call_update chunk", {
+            logger.debug("Processed tool_call_update", {
                 sessionUpdate,
+                isReplay: this.isInReplayMode,
             });
         }
         else if (update &&
@@ -995,19 +1057,25 @@ export class HttpTransport {
                 toolCallUpdate: toolOutput,
                 messageId,
             };
-            // Queue tool output as a chunk for ordered processing
-            const toolCallUpdateChunk = {
-                type: "tool_call_update",
-                id: sessionId,
-                toolCallUpdate: toolOutput,
-                messageId,
-            };
-            const resolver = this.chunkResolvers.shift();
-            if (resolver) {
-                resolver(toolCallUpdateChunk);
+            // During replay, notify directly; otherwise queue for ordered processing
+            if (this.isInReplayMode) {
+                this.notifySessionUpdate(sessionUpdate);
             }
             else {
-                this.messageQueue.push(toolCallUpdateChunk);
+                // Queue tool output as a chunk for ordered processing
+                const toolCallUpdateChunk = {
+                    type: "tool_call_update",
+                    id: sessionId,
+                    toolCallUpdate: toolOutput,
+                    messageId,
+                };
+                const resolver = this.chunkResolvers.shift();
+                if (resolver) {
+                    resolver(toolCallUpdateChunk);
+                }
+                else {
+                    this.messageQueue.push(toolCallUpdateChunk);
+                }
             }
             logger.debug("Queued tool_output as tool_call_update chunk", {
                 sessionUpdate,

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

@@ -7,6 +7,11 @@ export interface AgentToolInfo {
     description?: string;
     prettyName?: string;
     icon?: string;
+    verbiage?: {
+        active: string;
+        past: string;
+        paramKey?: string;
+    };
 }
 /**
  * Agent MCP (Model Context Protocol) server information