@yourgpt/copilot-sdk 2.1.3 → 2.1.5-alpha.0

package/dist/{types-DG2ya08y.d.cts → types-BeFBBZ5i.d.ts}

@@ -1,3 +1,56 @@
+/**
+ * Copilot SDK Logger
+ *
+ * Simple debug logger with console grouping support.
+ *
+ * Usage:
+ *   debug={true}   → enable all logs
+ *   debug={false}  → silent (default)
+ *
+ * Runtime toggle from browser console (no rebuild needed):
+ *   window.__COPILOT_DEBUG = true
+ *   window.__COPILOT_DEBUG = false
+ */
+/** Well-known log scopes — used internally as labels, not exposed to the user. */
+type LogScope = "streaming" | "tools" | "provider" | string;
+/** Debug config accepted by CopilotProvider. true = on, false = off. */
+type DebugConfig = boolean;
+declare global {
+    interface Window {
+        __COPILOT_DEBUG?: boolean;
+    }
+}
+interface ScopedLogger {
+    /** Log a message with optional data */
+    (action: string, data?: unknown): void;
+    /** Open a collapsible group — all subsequent logs nest inside until groupEnd() */
+    group(label: string): void;
+    /** Open a collapsed group (hidden by default in DevTools) */
+    groupCollapsed(label: string): void;
+    /** Close the most recently opened group */
+    groupEnd(): void;
+}
+/**
+ * Create a scoped logger bound to a specific namespace.
+ *
+ * @param scope      - Label shown in brackets, e.g. "streaming", "tools"
+ * @param getEnabled - Returns whether debug logging is currently on
+ *
+ * @example
+ * const log = createLogger("streaming", () => this.config.debug ?? false);
+ * log("sendMessage", { content });
+ * // → [streaming] sendMessage { content: '...' }
+ *
+ * log.groupCollapsed("Stream #1");
+ * log("chunk", { type: "message:start" });  // nested inside group
+ * log.groupEnd();
+ */
+/**
+ * One-shot log — for cases where you don't keep a persistent logger.
+ */
+declare function logOnce(scope: LogScope, enabled: boolean, action: string, data?: unknown): void;
+declare function createLogger(scope: LogScope, getEnabled: () => boolean): ScopedLogger;
+
 /**
  * Message roles in a conversation (OpenAI format)
  */
@@ -131,6 +184,15 @@ interface Message {
     metadata?: MessageMetadata;
     /** When the message was created */
     created_at: Date;
+    /**
+     * Parent message ID for branching support.
+     * - null = root message (no parent)
+     * - undefined = legacy linear message (no branch awareness)
+     * - string = ID of parent message
+     */
+    parent_id?: string | null;
+    /** Direct children IDs for O(1) sibling lookup */
+    children_ids?: string[];
 }
 /**
  * Helper to parse tool call arguments
@@ -153,6 +215,7 @@ declare function createUserMessage(content: string, options?: {
     id?: string;
     thread_id?: string;
     attachments?: MessageAttachment[];
+    parent_id?: string | null;
 }): Message;
 /**
  * Create an assistant message
@@ -364,4 +427,4 @@ interface AsyncThreadStorageAdapter extends ThreadStorageAdapter {
     listThreads?: (options?: ListThreadsOptions) => Promise<ListThreadsResult>;
 }
 
-export { type AsyncThreadStorageAdapter as A, type ListThreadsOptions as L, type Message as M, type PersistenceConfig as P, type Source as S, type Thread as T, type ThreadData as a, type ThreadStorageAdapter as b, type MessageAttachment as c, type MessageRole as d, type MessageMetadata as e, type ToolCall as f, type TokenUsage as g, type ThreadStorageAdapter$1 as h, generateThreadTitle as i, createMessage as j, createUserMessage as k, createAssistantMessage as l, createToolMessage as m, createToolCall as n, hasToolCalls as o, parseToolCallArgs as p, isToolResult as q, type ListThreadsResult as r };
+export { type AsyncThreadStorageAdapter as A, type DebugConfig as D, type ListThreadsOptions as L, type MessageAttachment as M, type PersistenceConfig as P, type Source as S, type ToolCall as T, type Thread as a, type ThreadData as b, type ThreadStorageAdapter as c, type Message as d, createLogger as e, type ScopedLogger as f, type MessageRole as g, type MessageMetadata as h, type TokenUsage as i, type ThreadStorageAdapter$1 as j, generateThreadTitle as k, logOnce as l, createMessage as m, createUserMessage as n, createAssistantMessage as o, createToolMessage as p, createToolCall as q, parseToolCallArgs as r, hasToolCalls as s, isToolResult as t, type ListThreadsResult as u };