@herdctl/chat 0.0.1 → 0.2.1

package/dist/session-manager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session-manager/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,mDAAmD;IACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,4BAA4B,CAAC;IAE1D,wDAAwD;IACxD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,mDAAmD;KAC7D,CAAC;CACH,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C;;;;;OAKG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5D,+CAA+C;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,4BAA4B,CAAC;IAE1D,wCAAwC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC;CACrD,CAAC,CAAC;AA8JH,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAiB;IAEjB,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS;QACT,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO;QACL,SAAS;QACT,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACxC,CAAC;AACJ,CAAC"}

package/dist/status-formatting.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Status formatting utilities for chat commands
+ *
+ * Provides common formatting functions used by status commands
+ * across all chat platforms. These are identical between Discord
+ * and Slack status commands.
+ */
+/**
+ * Format an ISO timestamp for display
+ *
+ * Converts an ISO 8601 timestamp to a locale-appropriate string.
+ * Returns "N/A" if the timestamp is null or undefined.
+ *
+ * @param isoString - ISO 8601 timestamp string
+ * @returns Formatted date/time string
+ *
+ * @example
+ * ```typescript
+ * formatTimestamp('2024-01-15T10:30:00Z');
+ * // Returns: "1/15/2024, 10:30:00 AM" (locale-dependent)
+ *
+ * formatTimestamp(null);
+ * // Returns: "N/A"
+ * ```
+ */
+export declare function formatTimestamp(isoString: string | null): string;
+/**
+ * Format the duration since a timestamp
+ *
+ * Calculates and formats the time elapsed since the given timestamp.
+ * Returns a human-readable string like "2h 30m" or "5d 12h".
+ *
+ * @param isoString - ISO 8601 timestamp string (start time)
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * // If current time is 2 hours after the timestamp:
+ * formatDuration('2024-01-15T10:30:00Z');
+ * // Returns: "2h 0m"
+ *
+ * formatDuration(null);
+ * // Returns: "N/A"
+ * ```
+ */
+export declare function formatDuration(isoString: string | null): string;
+/**
+ * Format a duration in milliseconds to a human-readable string
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * formatDurationMs(500);
+ * // Returns: "500ms"
+ *
+ * formatDurationMs(65000);
+ * // Returns: "1m 5s"
+ * ```
+ */
+export declare function formatDurationMs(ms: number): string;
+/**
+ * Get the appropriate emoji for a connection status
+ *
+ * Returns a circle emoji colored based on the connection state:
+ * - Green: connected
+ * - Yellow: connecting/reconnecting
+ * - White: disconnected/disconnecting
+ * - Red: error
+ * - Question mark: unknown status
+ *
+ * @param status - Connection status string
+ * @returns Appropriate emoji for the status
+ *
+ * @example
+ * ```typescript
+ * getStatusEmoji('connected');
+ * // Returns: green circle emoji
+ *
+ * getStatusEmoji('error');
+ * // Returns: red circle emoji
+ * ```
+ */
+export declare function getStatusEmoji(status: string): string;
+/**
+ * Format a number with thousand separators
+ *
+ * @param num - Number to format
+ * @returns Formatted string with locale-appropriate separators
+ *
+ * @example
+ * ```typescript
+ * formatNumber(1234567);
+ * // Returns: "1,234,567" (US locale)
+ * ```
+ */
+export declare function formatNumber(num: number): string;
+/**
+ * Format a large number in abbreviated form
+ *
+ * @param num - Number to format
+ * @returns Abbreviated string (e.g., "1.2k", "3.5M")
+ *
+ * @example
+ * ```typescript
+ * formatCompactNumber(1500);
+ * // Returns: "1.5k"
+ *
+ * formatCompactNumber(2500000);
+ * // Returns: "2.5M"
+ * ```
+ */
+export declare function formatCompactNumber(num: number): string;
+/**
+ * Format a character count for display
+ *
+ * Shows "X chars" for small counts, "X.Xk chars" for larger counts.
+ *
+ * @param count - Number of characters
+ * @returns Formatted character count string
+ *
+ * @example
+ * ```typescript
+ * formatCharCount(500);
+ * // Returns: "500 chars"
+ *
+ * formatCharCount(15000);
+ * // Returns: "15.0k chars"
+ * ```
+ */
+export declare function formatCharCount(count: number): string;
+/**
+ * Format a USD cost amount
+ *
+ * @param usd - Cost in USD
+ * @param precision - Decimal precision (default: 4)
+ * @returns Formatted cost string with $ prefix
+ *
+ * @example
+ * ```typescript
+ * formatCost(0.0123);
+ * // Returns: "$0.0123"
+ * ```
+ */
+export declare function formatCost(usd: number, precision?: number): string;
+//# sourceMappingURL=status-formatting.d.ts.map

package/dist/status-formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-formatting.d.ts","sourceRoot":"","sources":["../src/status-formatting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMhE;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAuB/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAWnD;AAuBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrD;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM,CAErE"}

package/dist/status-formatting.js

@@ -0,0 +1,234 @@
+/**
+ * Status formatting utilities for chat commands
+ *
+ * Provides common formatting functions used by status commands
+ * across all chat platforms. These are identical between Discord
+ * and Slack status commands.
+ */
+// =============================================================================
+// Timestamp Formatting
+// =============================================================================
+/**
+ * Format an ISO timestamp for display
+ *
+ * Converts an ISO 8601 timestamp to a locale-appropriate string.
+ * Returns "N/A" if the timestamp is null or undefined.
+ *
+ * @param isoString - ISO 8601 timestamp string
+ * @returns Formatted date/time string
+ *
+ * @example
+ * ```typescript
+ * formatTimestamp('2024-01-15T10:30:00Z');
+ * // Returns: "1/15/2024, 10:30:00 AM" (locale-dependent)
+ *
+ * formatTimestamp(null);
+ * // Returns: "N/A"
+ * ```
+ */
+export function formatTimestamp(isoString) {
+    if (!isoString) {
+        return "N/A";
+    }
+    const date = new Date(isoString);
+    return date.toLocaleString();
+}
+// =============================================================================
+// Duration Formatting
+// =============================================================================
+/**
+ * Format the duration since a timestamp
+ *
+ * Calculates and formats the time elapsed since the given timestamp.
+ * Returns a human-readable string like "2h 30m" or "5d 12h".
+ *
+ * @param isoString - ISO 8601 timestamp string (start time)
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * // If current time is 2 hours after the timestamp:
+ * formatDuration('2024-01-15T10:30:00Z');
+ * // Returns: "2h 0m"
+ *
+ * formatDuration(null);
+ * // Returns: "N/A"
+ * ```
+ */
+export function formatDuration(isoString) {
+    if (!isoString) {
+        return "N/A";
+    }
+    const startTime = new Date(isoString).getTime();
+    const now = Date.now();
+    const durationMs = now - startTime;
+    const seconds = Math.floor(durationMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0) {
+        return `${days}d ${hours % 24}h`;
+    }
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+/**
+ * Format a duration in milliseconds to a human-readable string
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * formatDurationMs(500);
+ * // Returns: "500ms"
+ *
+ * formatDurationMs(65000);
+ * // Returns: "1m 5s"
+ * ```
+ */
+export function formatDurationMs(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return remainingSeconds > 0 ? `${minutes}m ${remainingSeconds}s` : `${minutes}m`;
+}
+// =============================================================================
+// Status Emoji
+// =============================================================================
+/**
+ * Status emoji mapping
+ *
+ * Maps connection status to appropriate emoji for display.
+ * Uses Unicode code points to avoid rendering issues.
+ */
+const STATUS_EMOJIS = {
+    connected: "\u{1F7E2}", // Green circle
+    connecting: "\u{1F7E1}", // Yellow circle
+    reconnecting: "\u{1F7E1}", // Yellow circle
+    disconnected: "\u26AA", // White circle
+    disconnecting: "\u26AA", // White circle
+    error: "\u{1F534}", // Red circle
+};
+const DEFAULT_STATUS_EMOJI = "\u2753"; // Question mark
+/**
+ * Get the appropriate emoji for a connection status
+ *
+ * Returns a circle emoji colored based on the connection state:
+ * - Green: connected
+ * - Yellow: connecting/reconnecting
+ * - White: disconnected/disconnecting
+ * - Red: error
+ * - Question mark: unknown status
+ *
+ * @param status - Connection status string
+ * @returns Appropriate emoji for the status
+ *
+ * @example
+ * ```typescript
+ * getStatusEmoji('connected');
+ * // Returns: green circle emoji
+ *
+ * getStatusEmoji('error');
+ * // Returns: red circle emoji
+ * ```
+ */
+export function getStatusEmoji(status) {
+    return STATUS_EMOJIS[status] ?? DEFAULT_STATUS_EMOJI;
+}
+// =============================================================================
+// Number Formatting
+// =============================================================================
+/**
+ * Format a number with thousand separators
+ *
+ * @param num - Number to format
+ * @returns Formatted string with locale-appropriate separators
+ *
+ * @example
+ * ```typescript
+ * formatNumber(1234567);
+ * // Returns: "1,234,567" (US locale)
+ * ```
+ */
+export function formatNumber(num) {
+    return num.toLocaleString();
+}
+/**
+ * Format a large number in abbreviated form
+ *
+ * @param num - Number to format
+ * @returns Abbreviated string (e.g., "1.2k", "3.5M")
+ *
+ * @example
+ * ```typescript
+ * formatCompactNumber(1500);
+ * // Returns: "1.5k"
+ *
+ * formatCompactNumber(2500000);
+ * // Returns: "2.5M"
+ * ```
+ */
+export function formatCompactNumber(num) {
+    if (num >= 1000000) {
+        return `${(num / 1000000).toFixed(1)}M`;
+    }
+    if (num >= 1000) {
+        return `${(num / 1000).toFixed(1)}k`;
+    }
+    return String(num);
+}
+/**
+ * Format a character count for display
+ *
+ * Shows "X chars" for small counts, "X.Xk chars" for larger counts.
+ *
+ * @param count - Number of characters
+ * @returns Formatted character count string
+ *
+ * @example
+ * ```typescript
+ * formatCharCount(500);
+ * // Returns: "500 chars"
+ *
+ * formatCharCount(15000);
+ * // Returns: "15.0k chars"
+ * ```
+ */
+export function formatCharCount(count) {
+    if (count >= 1000) {
+        return `${(count / 1000).toFixed(1)}k chars`;
+    }
+    return `${count} chars`;
+}
+// =============================================================================
+// Cost Formatting
+// =============================================================================
+/**
+ * Format a USD cost amount
+ *
+ * @param usd - Cost in USD
+ * @param precision - Decimal precision (default: 4)
+ * @returns Formatted cost string with $ prefix
+ *
+ * @example
+ * ```typescript
+ * formatCost(0.0123);
+ * // Returns: "$0.0123"
+ * ```
+ */
+export function formatCost(usd, precision = 4) {
+    return `$${usd.toFixed(precision)}`;
+}
+//# sourceMappingURL=status-formatting.js.map

package/dist/status-formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-formatting.js","sourceRoot":"","sources":["../src/status-formatting.ts"],"names":[],"mappings":"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"}

package/dist/streaming-responder.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Streaming Responder for chat platforms
+ *
+ * Handles incremental message delivery to chat platforms with:
+ * - Message buffering
+ * - Rate limiting between sends
+ * - Automatic message splitting for platform limits
+ */
+import type { ChatConnectorLogger } from "./types.js";
+/**
+ * Options for StreamingResponder
+ */
+export interface StreamingResponderOptions {
+    /** Function to send a reply to the chat platform */
+    reply: (content: string) => Promise<void>;
+    /** Logger for debug output */
+    logger: ChatConnectorLogger;
+    /** Agent name for logging context */
+    agentName: string;
+    /**
+     * Maximum message length for the platform
+     * Discord: 2000, Slack: 4000
+     */
+    maxMessageLength: number;
+    /**
+     * Minimum time between messages in ms (default: 1000)
+     * Helps avoid rate limiting
+     */
+    minMessageInterval?: number;
+    /**
+     * Maximum buffer size before forcing a send (default: platform max - 500)
+     * Discord: 1500, Slack: 3500
+     */
+    maxBufferSize?: number;
+    /**
+     * Platform name for logging (default: "chat")
+     */
+    platformName?: string;
+}
+/**
+ * StreamingResponder handles incremental message delivery to chat platforms
+ *
+ * Instead of collecting all output and sending at the end, this class:
+ * - Buffers incoming content
+ * - Sends messages as complete chunks arrive
+ * - Respects rate limits by enforcing minimum intervals between sends
+ * - Handles message splitting for content exceeding platform limits
+ *
+ * @example
+ * ```typescript
+ * const streamer = new StreamingResponder({
+ *   reply: (content) => channel.send(content),
+ *   logger: myLogger,
+ *   agentName: 'my-agent',
+ *   maxMessageLength: 2000,  // Discord
+ *   maxBufferSize: 1500,
+ * });
+ *
+ * // Add content as it arrives
+ * await streamer.addContent("Hello ");
+ * await streamer.addContent("world!");
+ *
+ * // Flush any remaining content when done
+ * await streamer.flush();
+ * ```
+ */
+export declare class StreamingResponder {
+    private buffer;
+    private lastSendTime;
+    private messagesSent;
+    private readonly reply;
+    private readonly logger;
+    private readonly agentName;
+    private readonly maxMessageLength;
+    private readonly minMessageInterval;
+    private readonly maxBufferSize;
+    private readonly platformName;
+    constructor(options: StreamingResponderOptions);
+    /**
+     * Add content to the buffer
+     *
+     * Content is accumulated until flush() is called or buffer exceeds maxBufferSize.
+     *
+     * @param content - Text content to add
+     */
+    addContent(content: string): void;
+    /**
+     * Add a complete message and send it immediately (with rate limiting)
+     *
+     * Use this for complete assistant message turns from the SDK.
+     * Each assistant message is a complete response that should be sent.
+     *
+     * @param content - Complete message content to send
+     */
+    addMessageAndSend(content: string): Promise<void>;
+    /**
+     * Flush any remaining content in the buffer
+     *
+     * Should be called when message processing is complete to ensure
+     * all content is sent.
+     */
+    flush(): Promise<void>;
+    /**
+     * Check if any messages have been sent
+     *
+     * @returns true if at least one message has been sent
+     */
+    hasSentAnything(): boolean;
+    /**
+     * Alias for hasSentAnything() for backward compatibility
+     */
+    hasSentMessages(): boolean;
+    /**
+     * Get the number of messages sent
+     */
+    getMessagesSent(): number;
+    /**
+     * Get the current buffer content (for debugging)
+     */
+    getBufferContent(): string;
+    /**
+     * Send all buffered content immediately (with rate limiting)
+     */
+    private sendAll;
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    private sleep;
+}
+//# sourceMappingURL=streaming-responder.d.ts.map

package/dist/streaming-responder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-responder.d.ts","sourceRoot":"","sources":["../src/streaming-responder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOtD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oDAAoD;IACpD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,8BAA8B;IAC9B,MAAM,EAAE,mBAAmB,CAAC;IAE5B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IAEjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,EAAE,yBAAyB;IAU9C;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOjC;;;;;;;OAOG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;OAIG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAQ1B;;OAEG;YACW,OAAO;IA6CrB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}