@witqq/agent-sdk 0.6.1 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. package/README.md +539 -6
  2. package/dist/{types-BvwNzZCj.d.cts → agent-CW9XbmG_.d.ts} +148 -95
  3. package/dist/{types-BvwNzZCj.d.ts → agent-DxY68NZL.d.cts} +148 -95
  4. package/dist/auth/index.cjs +260 -2
  5. package/dist/auth/index.cjs.map +1 -1
  6. package/dist/auth/index.d.cts +21 -138
  7. package/dist/auth/index.d.ts +21 -138
  8. package/dist/auth/index.js +260 -3
  9. package/dist/auth/index.js.map +1 -1
  10. package/dist/backends/claude.cjs +653 -140
  11. package/dist/backends/claude.cjs.map +1 -1
  12. package/dist/backends/claude.d.cts +4 -1
  13. package/dist/backends/claude.d.ts +4 -1
  14. package/dist/backends/claude.js +653 -140
  15. package/dist/backends/claude.js.map +1 -1
  16. package/dist/backends/copilot.cjs +428 -88
  17. package/dist/backends/copilot.cjs.map +1 -1
  18. package/dist/backends/copilot.d.cts +13 -4
  19. package/dist/backends/copilot.d.ts +13 -4
  20. package/dist/backends/copilot.js +428 -88
  21. package/dist/backends/copilot.js.map +1 -1
  22. package/dist/backends/vercel-ai.cjs +349 -77
  23. package/dist/backends/vercel-ai.cjs.map +1 -1
  24. package/dist/backends/vercel-ai.d.cts +3 -1
  25. package/dist/backends/vercel-ai.d.ts +3 -1
  26. package/dist/backends/vercel-ai.js +349 -77
  27. package/dist/backends/vercel-ai.js.map +1 -1
  28. package/dist/backends-BSrsBYFn.d.cts +39 -0
  29. package/dist/backends-BSrsBYFn.d.ts +39 -0
  30. package/dist/chat/accumulator.cjs +147 -0
  31. package/dist/chat/accumulator.cjs.map +1 -0
  32. package/dist/chat/accumulator.d.cts +64 -0
  33. package/dist/chat/accumulator.d.ts +64 -0
  34. package/dist/chat/accumulator.js +145 -0
  35. package/dist/chat/accumulator.js.map +1 -0
  36. package/dist/chat/backends.cjs +3524 -0
  37. package/dist/chat/backends.cjs.map +1 -0
  38. package/dist/chat/backends.d.cts +66 -0
  39. package/dist/chat/backends.d.ts +66 -0
  40. package/dist/chat/backends.js +3512 -0
  41. package/dist/chat/backends.js.map +1 -0
  42. package/dist/chat/context.cjs +280 -0
  43. package/dist/chat/context.cjs.map +1 -0
  44. package/dist/chat/context.d.cts +191 -0
  45. package/dist/chat/context.d.ts +191 -0
  46. package/dist/chat/context.js +277 -0
  47. package/dist/chat/context.js.map +1 -0
  48. package/dist/chat/core.cjs +305 -0
  49. package/dist/chat/core.cjs.map +1 -0
  50. package/dist/chat/core.d.cts +84 -0
  51. package/dist/chat/core.d.ts +84 -0
  52. package/dist/chat/core.js +282 -0
  53. package/dist/chat/core.js.map +1 -0
  54. package/dist/chat/errors.cjs +273 -0
  55. package/dist/chat/errors.cjs.map +1 -0
  56. package/dist/chat/errors.d.cts +97 -0
  57. package/dist/chat/errors.d.ts +97 -0
  58. package/dist/chat/errors.js +266 -0
  59. package/dist/chat/errors.js.map +1 -0
  60. package/dist/chat/events.cjs +203 -0
  61. package/dist/chat/events.cjs.map +1 -0
  62. package/dist/chat/events.d.cts +245 -0
  63. package/dist/chat/events.d.ts +245 -0
  64. package/dist/chat/events.js +196 -0
  65. package/dist/chat/events.js.map +1 -0
  66. package/dist/chat/index.cjs +5550 -0
  67. package/dist/chat/index.cjs.map +1 -0
  68. package/dist/chat/index.d.cts +77 -0
  69. package/dist/chat/index.d.ts +77 -0
  70. package/dist/chat/index.js +5505 -0
  71. package/dist/chat/index.js.map +1 -0
  72. package/dist/chat/react/theme.css +2517 -0
  73. package/dist/chat/react.cjs +3589 -0
  74. package/dist/chat/react.cjs.map +1 -0
  75. package/dist/chat/react.d.cts +1088 -0
  76. package/dist/chat/react.d.ts +1088 -0
  77. package/dist/chat/react.js +3547 -0
  78. package/dist/chat/react.js.map +1 -0
  79. package/dist/chat/runtime.cjs +1245 -0
  80. package/dist/chat/runtime.cjs.map +1 -0
  81. package/dist/chat/runtime.d.cts +182 -0
  82. package/dist/chat/runtime.d.ts +182 -0
  83. package/dist/chat/runtime.js +1243 -0
  84. package/dist/chat/runtime.js.map +1 -0
  85. package/dist/chat/server.cjs +2668 -0
  86. package/dist/chat/server.cjs.map +1 -0
  87. package/dist/chat/server.d.cts +648 -0
  88. package/dist/chat/server.d.ts +648 -0
  89. package/dist/chat/server.js +2628 -0
  90. package/dist/chat/server.js.map +1 -0
  91. package/dist/chat/sessions.cjs +380 -0
  92. package/dist/chat/sessions.cjs.map +1 -0
  93. package/dist/chat/sessions.d.cts +158 -0
  94. package/dist/chat/sessions.d.ts +158 -0
  95. package/dist/chat/sessions.js +376 -0
  96. package/dist/chat/sessions.js.map +1 -0
  97. package/dist/chat/sqlite.cjs +441 -0
  98. package/dist/chat/sqlite.cjs.map +1 -0
  99. package/dist/chat/sqlite.d.cts +128 -0
  100. package/dist/chat/sqlite.d.ts +128 -0
  101. package/dist/chat/sqlite.js +435 -0
  102. package/dist/chat/sqlite.js.map +1 -0
  103. package/dist/chat/state.cjs +190 -0
  104. package/dist/chat/state.cjs.map +1 -0
  105. package/dist/chat/state.d.cts +95 -0
  106. package/dist/chat/state.d.ts +95 -0
  107. package/dist/chat/state.js +180 -0
  108. package/dist/chat/state.js.map +1 -0
  109. package/dist/chat/storage.cjs +249 -0
  110. package/dist/chat/storage.cjs.map +1 -0
  111. package/dist/chat/storage.d.cts +197 -0
  112. package/dist/chat/storage.d.ts +197 -0
  113. package/dist/chat/storage.js +245 -0
  114. package/dist/chat/storage.js.map +1 -0
  115. package/dist/errors-C-so0M4t.d.cts +33 -0
  116. package/dist/errors-C-so0M4t.d.ts +33 -0
  117. package/dist/errors-CmVvczxZ.d.cts +28 -0
  118. package/dist/errors-CmVvczxZ.d.ts +28 -0
  119. package/dist/in-process-transport-C1JnJGVR.d.ts +228 -0
  120. package/dist/in-process-transport-C7DSqPyX.d.cts +228 -0
  121. package/dist/index.cjs +365 -59
  122. package/dist/index.cjs.map +1 -1
  123. package/dist/index.d.cts +322 -125
  124. package/dist/index.d.ts +322 -125
  125. package/dist/index.js +359 -60
  126. package/dist/index.js.map +1 -1
  127. package/dist/provider-types-PTSlRPNB.d.cts +39 -0
  128. package/dist/provider-types-PTSlRPNB.d.ts +39 -0
  129. package/dist/refresh-manager-B81PpYBr.d.cts +153 -0
  130. package/dist/refresh-manager-Dlv_iNZi.d.ts +153 -0
  131. package/dist/testing.cjs +383 -0
  132. package/dist/testing.cjs.map +1 -0
  133. package/dist/testing.d.cts +132 -0
  134. package/dist/testing.d.ts +132 -0
  135. package/dist/testing.js +377 -0
  136. package/dist/testing.js.map +1 -0
  137. package/dist/token-store-CSUBgYwn.d.ts +48 -0
  138. package/dist/token-store-CuC4hB9Z.d.cts +48 -0
  139. package/dist/transport-Cdh3M0tS.d.cts +68 -0
  140. package/dist/transport-Ciap4PWK.d.ts +68 -0
  141. package/dist/types-4vbcmPTp.d.cts +143 -0
  142. package/dist/types-BxggH0Yh.d.ts +143 -0
  143. package/dist/types-DRgd_9R7.d.cts +363 -0
  144. package/dist/types-ajANVzf7.d.ts +363 -0
  145. package/package.json +178 -6
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/testing/mock-agent-service.ts","../src/chat/types.ts","../src/testing/mock-data.ts","../src/testing/mock-runtime.ts","../src/testing/mock-chat-client.ts"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["/**\n * Mock IAgentService factory for testing.\n */\nimport type {\n IAgentService,\n IAgent,\n FullAgentConfig,\n ModelInfo,\n ValidationResult,\n AgentResult,\n AgentEvent,\n Message,\n MessageContent,\n RunOptions,\n StructuredOutputConfig,\n AgentState,\n} from \"../types.js\";\n\n/** Options for createMockAgentService. */\nexport interface MockAgentServiceOptions {\n /** Service name. Default: \"mock\". */\n name?: string;\n /** Models to return from listModels(). */\n models?: ModelInfo[];\n /** Custom validation result. Default: { valid: true, errors: [] }. */\n validationResult?: ValidationResult;\n /** Custom run handler. Default: returns \"Mock response\". */\n onRun?: (prompt: MessageContent, options?: RunOptions) => Promise<AgentResult>;\n /** Custom stream handler. Default: yields text_delta + result events. */\n onStream?: (prompt: MessageContent, options?: RunOptions) => AsyncIterable<AgentEvent>;\n}\n\nclass MockAgent implements IAgent {\n readonly sessionId: string | undefined = undefined;\n private _state: AgentState = \"idle\";\n private readonly _config: FullAgentConfig;\n private readonly _onRun?: MockAgentServiceOptions[\"onRun\"];\n private readonly _onStream?: MockAgentServiceOptions[\"onStream\"];\n\n constructor(config: FullAgentConfig, options?: MockAgentServiceOptions) {\n this._config = config;\n this._onRun = options?.onRun;\n this._onStream = options?.onStream;\n }\n\n async run(prompt: MessageContent, options: RunOptions): Promise<AgentResult> {\n if (this._onRun) return this._onRun(prompt, options);\n return { output: \"Mock response\", structuredOutput: undefined, toolCalls: [], messages: [], usage: { promptTokens: 10, completionTokens: 5 } };\n }\n\n async runWithContext(messages: Message[], options: RunOptions): Promise<AgentResult> {\n const lastMsg = messages[messages.length - 1];\n const text = typeof lastMsg?.content === \"string\" ? lastMsg.content : \"context\";\n return this.run(text, options);\n }\n\n async runStructured<T>(\n prompt: MessageContent,\n _schema: StructuredOutputConfig<T>,\n options: RunOptions,\n ): Promise<AgentResult<T>> {\n const base = await this.run(prompt, options);\n return { ...base, structuredOutput: undefined as unknown as T extends void ? undefined : T };\n }\n\n async *stream(prompt: MessageContent, options: RunOptions): AsyncIterable<AgentEvent> {\n if (this._onStream) {\n yield* this._onStream(prompt, options);\n return;\n }\n yield { type: \"text_delta\", text: \"Mock \" };\n yield { type: \"text_delta\", text: \"response\" };\n yield { type: \"done\", finalOutput: \"Mock response\" };\n }\n\n async *streamWithContext(messages: Message[], options: RunOptions): AsyncIterable<AgentEvent> {\n const lastMsg = messages[messages.length - 1];\n const text = typeof lastMsg?.content === \"string\" ? lastMsg.content : \"context\";\n yield* this.stream(text, options);\n }\n\n abort(): void {\n this._state = \"idle\";\n }\n\n async interrupt(): Promise<void> {\n this._state = \"idle\";\n }\n\n getState(): AgentState {\n return this._state;\n }\n\n getConfig(): Readonly<FullAgentConfig> {\n return this._config;\n }\n\n dispose(): void {\n this._state = \"disposed\";\n }\n}\n\n/**\n * Create a mock IAgentService for testing agent-level code.\n *\n * ```ts\n * const service = createMockAgentService({ name: \"test\" });\n * const agent = service.createAgent({ model: \"gpt-5-mini\" });\n * const result = await agent.run(\"Hello\");\n * ```\n */\nexport function createMockAgentService(options: MockAgentServiceOptions = {}): IAgentService {\n const name = options.name ?? \"mock\";\n return {\n name,\n createAgent(config: FullAgentConfig): IAgent {\n return new MockAgent(config, options);\n },\n async listModels(): Promise<ModelInfo[]> {\n return options.models ?? [\n { id: \"mock-model-1\", name: \"Mock Model 1\" },\n { id: \"mock-model-2\", name: \"Mock Model 2\" },\n ];\n },\n async validate(): Promise<ValidationResult> {\n return options.validationResult ?? { valid: true, errors: [] };\n },\n async dispose(): Promise<void> {\n // no-op\n },\n };\n}\n","/**\n * @witqq/agent-sdk — Chat domain types\n *\n * All type definitions and interfaces for the chat layer.\n * Pure types + ChatId generation (tightly coupled to branded type).\n */\n\nimport type { UsageData, ToolDefinition, ErrorCode } from \"../types.js\";\nimport type { AuthToken } from \"../auth/types.js\";\n\n// ─── Unique ID ─────────────────────────────────────────────────\n\n/** Branded type for unique identifiers */\nexport type ChatId = string & { readonly __brand: \"ChatId\" };\n\n/**\n * Generate a new unique ChatId (crypto.randomUUID-based)\n * @returns Branded ChatId string\n */\nexport function createChatId(): ChatId {\n return crypto.randomUUID() as ChatId;\n}\n\n/** UUID v4 pattern for ChatId validation */\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * Cast a string to ChatId with UUID format validation.\n * Use this instead of manual `as ChatId` type assertions.\n *\n * @param value - String to validate and cast\n * @returns Branded ChatId\n * @throws {TypeError} If value is not a valid UUID v4 format\n */\nexport function toChatId(value: string): ChatId {\n if (!UUID_RE.test(value)) {\n throw new TypeError(`Invalid ChatId: \"${value}\" is not a valid UUID`);\n }\n return value as ChatId;\n}\n\n/**\n * Accepts either a plain string or branded ChatId for API convenience.\n * Use this in public API signatures so consumers don't need `as ChatId` casts.\n */\nexport type ChatIdLike = string | ChatId;\n\n// ─── Status Types ──────────────────────────────────────────────\n\n/** Lifecycle status of a message part (text, reasoning, etc.) */\nexport type PartStatus = \"pending\" | \"streaming\" | \"complete\" | \"error\";\n/** Lifecycle status of a tool call within a message */\nexport type ToolCallStatus = \"pending\" | \"running\" | \"requires_approval\" | \"complete\" | \"error\" | \"denied\";\n/** Lifecycle status of an entire message */\nexport type MessageStatus = \"pending\" | \"streaming\" | \"complete\" | \"error\" | \"cancelled\";\n/** Lifecycle status of a chat session */\nexport type SessionStatus = \"active\";\n/** Lifecycle status of the chat runtime */\nexport type RuntimeStatus = \"idle\" | \"streaming\" | \"error\" | \"disposed\";\n\n// ─── Message Parts (union) ─────────────────────────────────────\n\n/** Plain text content part */\nexport interface TextPart { type: \"text\"; text: string; status: PartStatus; }\n/** Model reasoning/thinking content part */\nexport interface ReasoningPart { type: \"reasoning\"; text: string; status: PartStatus; }\n/** Tool invocation part with call ID, arguments, optional result */\nexport interface ToolCallPart { type: \"tool_call\"; toolCallId: string; name: string; args: unknown; result?: unknown; status: ToolCallStatus; error?: string; }\n/** Source reference part (URL citation) */\nexport interface SourcePart { type: \"source\"; url: string; title?: string; status: PartStatus; }\n/** File attachment part (base64-encoded data) */\nexport interface FilePart { type: \"file\"; name: string; mimeType: string; data: string; status: PartStatus; }\n/** Union of all message part types */\nexport type MessagePart = TextPart | ReasoningPart | ToolCallPart | SourcePart | FilePart;\n\n// ─── Chat Message ──────────────────────────────────────────────\n\n/** Role of message author */\nexport type ChatRole = \"user\" | \"assistant\" | \"system\";\n\n/** Metadata attached to messages — useful preset for the TMetadata generic */\nexport interface ChatMessageMetadata {\n model?: string;\n backend?: string;\n usage?: UsageData;\n isSummary?: boolean;\n estimatedTokens?: number;\n custom?: Record<string, unknown>;\n}\n\n/** Message status */\nexport type ChatMessageStatus = MessageStatus;\n\n/** A single chat message — the fundamental unit of conversation */\nexport interface ChatMessage<TMetadata = unknown> {\n id: ChatId;\n role: ChatRole;\n parts: MessagePart[];\n metadata?: TMetadata;\n createdAt: string;\n updatedAt?: string;\n status: MessageStatus;\n}\n\n// ─── Supporting Types ──────────────────────────────────────────\n\n// ─── Chat Session ──────────────────────────────────────────────\n\n/** Session configuration snapshot */\nexport interface ChatSessionConfig {\n model: string;\n backend: string;\n systemPrompt?: string;\n temperature?: number;\n maxTokens?: number;\n}\n\n/**\n * Session metadata tracking usage statistics and custom extensions.\n *\n * Updated automatically by session stores on each `addMessage()` call.\n * The generic `TCustom` parameter allows type-safe application-specific\n * metadata via the `custom` field.\n *\n * @typeParam TCustom - Shape of the `custom` field (defaults to `Record<string, unknown>`)\n */\nexport interface ChatSessionMetadata<TCustom extends Record<string, unknown> = Record<string, unknown>> {\n /** Number of messages in the session (updated by session store) */\n messageCount: number;\n /** Total token count across all messages in the session */\n totalTokens: number;\n /** Optional tags for session categorization and filtering */\n tags?: string[];\n /** Application-specific metadata — typed via the TCustom generic parameter */\n custom?: TCustom;\n}\n\n/** Chat session — a conversation with ordered messages (pure serializable data) */\nexport interface ChatSession<TCustom extends Record<string, unknown> = Record<string, unknown>> {\n id: ChatId;\n title?: string;\n messages: ChatMessage[];\n config: ChatSessionConfig;\n metadata: ChatSessionMetadata<TCustom>;\n status: SessionStatus;\n createdAt: string;\n updatedAt: string;\n backendSessionId?: string;\n}\n\n/**\n * Reactive wrapper around ChatSession — provides subscribe/getSnapshot for\n * React useSyncExternalStore integration and lastMessage convenience getter.\n * Session stores may optionally return ObservableSession instances.\n */\nexport interface ObservableSession<TCustom extends Record<string, unknown> = Record<string, unknown>>\n extends ChatSession<TCustom> {\n /** Subscribe to session changes (for React useSyncExternalStore) */\n subscribe(callback: () => void): () => void;\n /** Get immutable snapshot of session state (for React useSyncExternalStore) */\n getSnapshot(): ChatSession<TCustom>;\n /** Last message in the session */\n readonly lastMessage: ChatMessage | undefined;\n}\n\n/** Lightweight session info for listing (without full message array) */\nexport interface SessionInfo {\n id: ChatId;\n title?: string;\n status: SessionStatus;\n messageCount: number;\n lastMessage?: ChatMessage;\n createdAt: string;\n updatedAt: string;\n}\n\n// ─── Chat Events ───────────────────────────────────────────────\n\n/** Events emitted during chat operation */\nexport type ChatEvent =\n | { type: \"message:start\"; messageId: ChatId; role: ChatRole }\n | { type: \"message:delta\"; messageId: ChatId; text: string }\n | { type: \"message:complete\"; messageId: ChatId; message: ChatMessage }\n | {\n type: \"tool:start\";\n messageId: ChatId;\n toolCallId: string;\n toolName: string;\n args: Record<string, unknown>;\n }\n | {\n type: \"tool:complete\";\n messageId: ChatId;\n toolCallId: string;\n toolName: string;\n result: unknown;\n isError?: boolean;\n }\n | { type: \"thinking:start\"; messageId: ChatId }\n | { type: \"thinking:delta\"; messageId: ChatId; text: string }\n | { type: \"thinking:end\"; messageId: ChatId }\n | {\n type: \"permission:request\";\n messageId: ChatId;\n toolName: string;\n toolArgs: Record<string, unknown>;\n }\n | {\n type: \"permission:response\";\n messageId: ChatId;\n toolName: string;\n allowed: boolean;\n }\n | {\n type: \"usage\";\n promptTokens: number;\n completionTokens: number;\n model?: string;\n }\n | { type: \"session:created\"; sessionId: ChatId }\n | { type: \"session:updated\"; sessionId: ChatId }\n | {\n type: \"error\";\n error: string;\n recoverable: boolean;\n code?: ErrorCode;\n messageId?: ChatId;\n }\n | { type: \"typing:start\" }\n | { type: \"typing:end\" }\n | { type: \"heartbeat\" }\n | { type: \"done\"; finalOutput?: string };\n\n/** All possible ChatEvent type strings */\nexport type ChatEventType = ChatEvent[\"type\"];\n\n// ─── Chat Middleware ───────────────────────────────────────────\n\n/** Context passed to ChatMiddleware hooks */\nexport interface ChatMiddlewareContext {\n sessionId: ChatId;\n signal: AbortSignal;\n}\n\n/** Runtime-level middleware for the send/receive lifecycle.\n * Different from EventMiddleware which operates at the event bus level. */\nexport interface ChatMiddleware {\n /** Transform message before sending to backend. Return null to reject the send. */\n onBeforeSend?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | null | Promise<ChatMessage | null>;\n /** Transform/intercept stream events */\n onEvent?(event: ChatEvent, context: ChatMiddlewareContext): ChatEvent | null | Promise<ChatEvent | null>;\n /** Transform completed message after receiving from backend */\n onAfterReceive?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | Promise<ChatMessage>;\n /** Intercept errors — return null to suppress, return error to propagate */\n onError?(error: Error, context: ChatMiddlewareContext): Error | null | Promise<Error | null>;\n}\n\n// ─── Chat Provider Abstraction ─────────────────────────────────\n\n/** Options for sending a message to a provider */\nexport interface SendMessageOptions {\n signal?: AbortSignal;\n /** Model to use for this request. Required for server-side runtime.send(). */\n model?: string;\n /** Per-call system prompt override (forwarded to the backend agent) */\n systemPrompt?: string;\n context?: Record<string, unknown>;\n /** Additional tools to include in this request */\n tools?: ToolDefinition[];\n}\n\n/** Options for runtime.send() — requires backend routing info */\nexport interface RuntimeSendOptions {\n /** Backend to route this request to (key in backends map) */\n backend: string;\n /** Authentication credentials for the backend factory */\n credentials: AuthToken;\n /** Model to use for this request */\n model: string;\n /** Per-call system prompt override (forwarded to the backend agent) */\n systemPrompt?: string;\n /** Abort signal */\n signal?: AbortSignal;\n /** Request-scoped context */\n context?: Record<string, unknown>;\n /** Additional tools */\n tools?: ToolDefinition[];\n}\n\n/**\n * @deprecated IChatProvider has been inlined into IChatBackend.\n * Import IChatBackend from \"@witqq/agent-sdk/chat/backends\" instead.\n * Kept as type alias for backward compatibility.\n */\nexport type IChatProvider = import(\"./backends/types.js\").IChatBackend;\n\n// ─── Factory Functions ─────────────────────────────────────────\n\n/**\n * Create a simple text ChatMessage.\n *\n * @param text - Message text content\n * @param role - Message role (default: \"user\")\n * @returns A complete ChatMessage with a single TextPart\n */\nexport function createTextMessage(text: string, role: ChatRole = \"user\"): ChatMessage {\n return {\n id: createChatId(),\n role,\n parts: [{ type: \"text\", text, status: \"complete\" }],\n createdAt: new Date().toISOString(),\n status: \"complete\",\n };\n}\n\n/** Type guard: checks if a session has reactive API (subscribe/getSnapshot) */\nexport function isObservableSession<TCustom extends Record<string, unknown> = Record<string, unknown>>(\n session: ChatSession<TCustom>,\n): session is ObservableSession<TCustom> {\n return \"subscribe\" in session && typeof (session as ObservableSession<TCustom>).subscribe === \"function\"\n && \"getSnapshot\" in session && typeof (session as ObservableSession<TCustom>).getSnapshot === \"function\";\n}\n","/**\n * Mock data factories for creating test ChatSession and ChatMessage instances.\n */\nimport type { ChatSession, ChatMessage, MessagePart, ChatSessionConfig, ChatId } from \"../chat/core.js\";\nimport { createChatId } from \"../chat/core.js\";\n\n/** Options for createMockSession. */\nexport interface MockSessionOptions {\n id?: string;\n title?: string;\n messages?: ChatMessage[];\n config?: Partial<ChatSessionConfig>;\n metadata?: Record<string, unknown>;\n status?: \"active\";\n}\n\n/** Options for createMockMessage. */\nexport interface MockMessageOptions {\n id?: string;\n role?: \"user\" | \"assistant\" | \"system\";\n text?: string;\n parts?: MessagePart[];\n status?: \"pending\" | \"streaming\" | \"complete\" | \"error\";\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Create a mock ChatSession for testing.\n *\n * ```ts\n * const session = createMockSession({ title: \"Test chat\" });\n * ```\n */\nexport function createMockSession(options: MockSessionOptions = {}): ChatSession {\n const id = (options.id ?? createChatId()) as ChatId;\n const now = new Date().toISOString();\n return {\n id,\n title: options.title ?? \"Test Session\",\n messages: options.messages ?? [],\n config: {\n model: options.config?.model ?? \"test-model\",\n backend: options.config?.backend ?? \"test-backend\",\n systemPrompt: options.config?.systemPrompt ?? \"\",\n },\n metadata: {\n messageCount: options.messages?.length ?? 0,\n totalTokens: 0,\n custom: options.metadata ?? {},\n },\n status: options.status ?? \"active\",\n createdAt: now,\n updatedAt: now,\n };\n}\n\n/**\n * Create a mock ChatMessage for testing.\n *\n * ```ts\n * const msg = createMockMessage({ role: \"user\", text: \"Hello\" });\n * ```\n */\nexport function createMockMessage(options: MockMessageOptions = {}): ChatMessage {\n const id = createChatId();\n const parts: MessagePart[] = options.parts ?? (options.text\n ? [{ type: \"text\" as const, text: options.text, status: \"complete\" as const }]\n : [{ type: \"text\" as const, text: \"Test message\", status: \"complete\" as const }]);\n const now = new Date().toISOString();\n return {\n id,\n role: options.role ?? \"user\",\n parts,\n status: options.status ?? \"complete\",\n createdAt: now,\n metadata: options.metadata ?? {},\n };\n}\n","/**\n * Mock IChatRuntime factory for testing chat runtime consumers.\n */\nimport type { IChatRuntime, BackendInfo } from \"../chat/runtime.js\";\nimport type { CreateSessionOptions, SessionListOptions } from \"../chat/sessions.js\";\nimport type { ChatSession, ChatEvent, ChatIdLike, ChatMiddleware, RuntimeStatus } from \"../chat/core.js\";\nimport type { RuntimeSendOptions } from \"../chat/types.js\";\nimport type { ContextStats } from \"../chat/context.js\";\nimport type { ToolDefinition, ModelInfo } from \"../types.js\";\nimport { createChatId, toChatId } from \"../chat/core.js\";\nimport { createMockSession, createMockMessage } from \"./mock-data.js\";\n\n/** Options for createMockRuntime. */\nexport interface MockRuntimeOptions {\n /** Default backend name. Default: \"mock\". */\n defaultBackend?: string;\n /** Default model. */\n defaultModel?: string;\n /** Pre-seeded sessions. */\n sessions?: ChatSession[];\n /** Models to return from listModels(). */\n models?: ModelInfo[];\n /** Custom send handler. When not provided, yields a single text_delta + done event. */\n onSend?: (sessionId: ChatIdLike, message: string, options?: RuntimeSendOptions) => AsyncIterable<ChatEvent>;\n}\n\n/**\n * Create a mock IChatRuntime for testing chat UI hooks and components.\n *\n * ```ts\n * const runtime = createMockRuntime({ defaultModel: \"gpt-5-mini\" });\n * const session = await runtime.createSession({});\n * ```\n */\nexport function createMockRuntime(options: MockRuntimeOptions = {}): IChatRuntime {\n const sessions = new Map<string, ChatSession>();\n const tools = new Map<string, ToolDefinition>();\n const middleware: ChatMiddleware[] = [];\n const sessionListeners = new Set<() => void>();\n let currentBackend = options.defaultBackend ?? \"mock\";\n let status: RuntimeStatus = \"idle\";\n\n // Seed initial sessions\n for (const s of options.sessions ?? []) {\n sessions.set(s.id, s);\n }\n\n function notifySessionChange() {\n for (const cb of sessionListeners) {\n try { cb(); } catch { /* isolated */ }\n }\n }\n\n const runtime: IChatRuntime = {\n get status() { return status; },\n get registeredTools() { return tools as ReadonlyMap<string, ToolDefinition>; },\n\n async createSession(opts: CreateSessionOptions): Promise<ChatSession> {\n const session = createMockSession({\n title: opts.title,\n config: {\n model: opts.config?.model ?? \"mock-model\",\n backend: opts.config?.backend ?? currentBackend,\n systemPrompt: opts.config?.systemPrompt,\n },\n metadata: opts.custom as Record<string, unknown>,\n });\n sessions.set(session.id, session);\n notifySessionChange();\n return session;\n },\n\n async getSession(id: ChatIdLike): Promise<ChatSession | null> {\n return sessions.get(toChatId(String(id))) ?? null;\n },\n\n async listSessions(_opts?: SessionListOptions): Promise<ChatSession[]> {\n return [...sessions.values()];\n },\n\n async deleteSession(id: ChatIdLike): Promise<void> {\n sessions.delete(toChatId(String(id)));\n notifySessionChange();\n },\n\n send(sessionId: ChatIdLike, message: string, sendOpts?: RuntimeSendOptions): AsyncIterable<ChatEvent> {\n if (options.onSend) return options.onSend(sessionId, message, sendOpts);\n // Default: yield a simple response\n async function* defaultStream(): AsyncIterable<ChatEvent> {\n const msgId = createChatId();\n yield { type: \"message:start\", messageId: msgId } as ChatEvent;\n yield { type: \"message:delta\", text: \"Mock reply\" } as ChatEvent;\n yield { type: \"message:complete\", messageId: msgId } as ChatEvent;\n yield { type: \"done\", finalOutput: \"Mock reply\" } as ChatEvent;\n // Add assistant message to session\n const session = sessions.get(toChatId(String(sessionId)));\n if (session) {\n session.messages.push(createMockMessage({ role: \"assistant\", text: \"Mock reply\" }));\n session.metadata.messageCount = session.messages.length;\n }\n notifySessionChange();\n }\n return defaultStream();\n },\n\n abort(): void { /* no-op */ },\n\n async listModels(): Promise<ModelInfo[]> {\n return options.models ?? [{ id: \"mock-model\", name: \"Mock Model\" }];\n },\n\n async listBackends(): Promise<BackendInfo[]> {\n return [{ name: currentBackend }];\n },\n\n onSessionChange(callback: () => void): () => void {\n sessionListeners.add(callback);\n return () => { sessionListeners.delete(callback); };\n },\n\n registerTool(tool: ToolDefinition): void {\n tools.set(tool.name, tool);\n },\n\n removeTool(name: string): void {\n tools.delete(name);\n },\n\n use(mw: ChatMiddleware): void {\n middleware.push(mw);\n },\n\n removeMiddleware(mw: ChatMiddleware): void {\n const idx = middleware.indexOf(mw);\n if (idx >= 0) middleware.splice(idx, 1);\n },\n\n async getContextStats(_sessionId: ChatIdLike): Promise<ContextStats | null> {\n return null;\n },\n\n async dispose(): Promise<void> {\n status = \"disposed\";\n sessions.clear();\n tools.clear();\n middleware.length = 0;\n sessionListeners.clear();\n },\n };\n\n return runtime;\n}\n","/**\n * Mock IChatClient factory for testing remote chat client consumers.\n */\nimport type { IChatClient, BackendInfo } from \"../chat/runtime.js\";\nimport type { CreateSessionOptions, SessionListOptions } from \"../chat/sessions.js\";\nimport type { ChatSession, ChatEvent, ChatId, ChatIdLike, SendMessageOptions, RuntimeStatus } from \"../chat/core.js\";\nimport type { ProviderConfig } from \"../chat/provider-types.js\";\nimport type { ModelInfo } from \"../types.js\";\nimport type { ContextStats } from \"../chat/context.js\";\nimport { createChatId, toChatId } from \"../chat/core.js\";\nimport { createMockSession, createMockMessage } from \"./mock-data.js\";\n\n/** Options for createMockChatClient. */\nexport interface MockChatClientOptions {\n /** Pre-seeded sessions. */\n sessions?: ChatSession[];\n /** Models to return from listModels(). */\n models?: ModelInfo[];\n /** Providers to return from listProviders(). */\n providers?: ProviderConfig[];\n /** Custom send handler. */\n onSend?: (sessionId: ChatIdLike, message: string, options?: SendMessageOptions) => AsyncIterable<ChatEvent>;\n}\n\n/**\n * Create a mock IChatClient for testing React hooks that talk to RemoteChatClient.\n *\n * ```ts\n * const client = createMockChatClient({ providers: [{ id: \"p1\", backend: \"copilot\", model: \"gpt-5-mini\", label: \"GPT Mini\", createdAt: \"\" }] });\n * const providers = await client.listProviders();\n * ```\n */\nexport function createMockChatClient(options: MockChatClientOptions = {}): IChatClient {\n const sessions = new Map<string, ChatSession>();\n const providers = new Map<string, ProviderConfig>();\n const sessionListeners = new Set<() => void>();\n const selectionListeners = new Set<(providerId: string | null) => void>();\n let activeSessionId: ChatId | null = null;\n let selectedProviderId: string | null = null;\n let status: RuntimeStatus = \"idle\";\n\n // Seed sessions\n for (const s of options.sessions ?? []) {\n sessions.set(s.id, s);\n }\n // Seed providers\n for (const p of options.providers ?? []) {\n providers.set(p.id, p);\n }\n\n function notifySessionChange() {\n for (const cb of sessionListeners) {\n try { cb(); } catch { /* isolated */ }\n }\n }\n\n const client: IChatClient = {\n get status() { return status; },\n get activeSessionId() { return activeSessionId; },\n\n async createSession(opts: CreateSessionOptions): Promise<ChatSession> {\n const session = createMockSession({\n title: opts.title,\n config: {\n model: opts.config?.model ?? \"mock-model\",\n backend: opts.config?.backend ?? \"mock\",\n systemPrompt: opts.config?.systemPrompt,\n },\n });\n sessions.set(session.id, session);\n activeSessionId = session.id;\n notifySessionChange();\n return session;\n },\n\n async getSession(id: ChatIdLike): Promise<ChatSession | null> {\n return sessions.get(toChatId(String(id))) ?? null;\n },\n\n async listSessions(_opts?: SessionListOptions): Promise<ChatSession[]> {\n return [...sessions.values()];\n },\n\n async deleteSession(id: ChatIdLike): Promise<void> {\n sessions.delete(toChatId(String(id)));\n if (activeSessionId === String(id)) activeSessionId = null;\n notifySessionChange();\n },\n\n async switchSession(id: ChatIdLike): Promise<ChatSession> {\n const session = sessions.get(toChatId(String(id)));\n if (!session) throw new Error(`Session ${id} not found`);\n activeSessionId = session.id;\n return session;\n },\n\n send(sessionId: ChatIdLike, message: string, sendOpts?: SendMessageOptions): AsyncIterable<ChatEvent> {\n if (options.onSend) return options.onSend(sessionId, message, sendOpts);\n async function* defaultStream(): AsyncIterable<ChatEvent> {\n const msgId = createChatId();\n yield { type: \"message:start\", messageId: msgId } as ChatEvent;\n yield { type: \"message:delta\", text: \"Mock reply\" } as ChatEvent;\n yield { type: \"message:complete\", messageId: msgId } as ChatEvent;\n yield { type: \"done\", finalOutput: \"Mock reply\" } as ChatEvent;\n const session = sessions.get(toChatId(String(sessionId)));\n if (session) {\n session.messages.push(createMockMessage({ role: \"assistant\", text: \"Mock reply\" }));\n session.metadata.messageCount = session.messages.length;\n }\n notifySessionChange();\n }\n return defaultStream();\n },\n\n abort(): void { /* no-op */ },\n\n // ── Provider Selection ──\n get selectedProviderId() { return selectedProviderId; },\n selectProvider(providerId: string): void {\n selectedProviderId = providerId;\n for (const cb of selectionListeners) {\n try { cb(providerId); } catch { /* isolated */ }\n }\n },\n onSelectionChange(callback: (providerId: string | null) => void): () => void {\n selectionListeners.add(callback);\n return () => { selectionListeners.delete(callback); };\n },\n\n async listModels(): Promise<ModelInfo[]> {\n return options.models ?? [{ id: \"mock-model\", name: \"Mock Model\" }];\n },\n\n async listBackends(): Promise<BackendInfo[]> {\n return [{ name: \"mock\" }];\n },\n\n onSessionChange(callback: () => void): () => void {\n sessionListeners.add(callback);\n return () => { sessionListeners.delete(callback); };\n },\n\n async getContextStats(_sessionId: ChatIdLike): Promise<ContextStats | null> {\n return null;\n },\n\n // ── Provider CRUD ──\n async listProviders(): Promise<ProviderConfig[]> {\n return [...providers.values()];\n },\n\n async createProvider(config: Omit<ProviderConfig, \"id\" | \"createdAt\">): Promise<ProviderConfig> {\n const provider: ProviderConfig = {\n ...config,\n id: createChatId(),\n createdAt: Date.now(),\n };\n providers.set(provider.id, provider);\n return provider;\n },\n\n async updateProvider(id: string, changes: Partial<Omit<ProviderConfig, \"id\" | \"createdAt\">>): Promise<void> {\n const existing = providers.get(id);\n if (!existing) throw new Error(`Provider ${id} not found`);\n providers.set(id, { ...existing, ...changes });\n },\n\n async deleteProvider(id: string): Promise<void> {\n providers.delete(id);\n },\n\n async dispose(): Promise<void> {\n status = \"disposed\";\n sessions.clear();\n providers.clear();\n sessionListeners.clear();\n selectionListeners.clear();\n },\n };\n\n return client;\n}\n"]}
@@ -0,0 +1,48 @@
1
+ import { A as AuthToken } from './types-BxggH0Yh.js';
2
+
3
+ /**
4
+ * Token storage abstraction and default filesystem implementation.
5
+ */
6
+
7
+ /** Token storage interface for server-side token management */
8
+ interface ITokenStore {
9
+ /** Save a token for a provider. Overwrites if exists. */
10
+ save(provider: string, token: AuthToken): Promise<void>;
11
+ /** Load a previously saved token. Returns null if not found. */
12
+ load(provider: string): Promise<AuthToken | null>;
13
+ /** Remove a specific provider's token. */
14
+ clear(provider: string): Promise<void>;
15
+ /** Remove all stored tokens. */
16
+ clearAll(): Promise<void>;
17
+ /** List provider names that have saved tokens. */
18
+ list(): Promise<string[]>;
19
+ /** Release any resources held by this store (optional). */
20
+ dispose?(): Promise<void>;
21
+ }
22
+ /** In-memory token store for testing and ephemeral use */
23
+ declare class InMemoryTokenStore implements ITokenStore {
24
+ private readonly tokens;
25
+ save(provider: string, token: AuthToken): Promise<void>;
26
+ load(provider: string): Promise<AuthToken | null>;
27
+ clear(provider: string): Promise<void>;
28
+ clearAll(): Promise<void>;
29
+ list(): Promise<string[]>;
30
+ }
31
+ /** Options for FileTokenStore */
32
+ interface FileTokenStoreOptions {
33
+ /** Directory to store token JSON files. Default: ".tokens" in cwd */
34
+ directory: string;
35
+ }
36
+ /** Filesystem-based token store using JSON files (one per provider) */
37
+ declare class FileTokenStore implements ITokenStore {
38
+ private readonly dir;
39
+ constructor(options: FileTokenStoreOptions);
40
+ save(provider: string, token: AuthToken): Promise<void>;
41
+ load(provider: string): Promise<AuthToken | null>;
42
+ clear(provider: string): Promise<void>;
43
+ clearAll(): Promise<void>;
44
+ list(): Promise<string[]>;
45
+ private filePath;
46
+ }
47
+
48
+ export { FileTokenStore as F, type ITokenStore as I, type FileTokenStoreOptions as a, InMemoryTokenStore as b };
@@ -0,0 +1,48 @@
1
+ import { A as AuthToken } from './types-4vbcmPTp.cjs';
2
+
3
+ /**
4
+ * Token storage abstraction and default filesystem implementation.
5
+ */
6
+
7
+ /** Token storage interface for server-side token management */
8
+ interface ITokenStore {
9
+ /** Save a token for a provider. Overwrites if exists. */
10
+ save(provider: string, token: AuthToken): Promise<void>;
11
+ /** Load a previously saved token. Returns null if not found. */
12
+ load(provider: string): Promise<AuthToken | null>;
13
+ /** Remove a specific provider's token. */
14
+ clear(provider: string): Promise<void>;
15
+ /** Remove all stored tokens. */
16
+ clearAll(): Promise<void>;
17
+ /** List provider names that have saved tokens. */
18
+ list(): Promise<string[]>;
19
+ /** Release any resources held by this store (optional). */
20
+ dispose?(): Promise<void>;
21
+ }
22
+ /** In-memory token store for testing and ephemeral use */
23
+ declare class InMemoryTokenStore implements ITokenStore {
24
+ private readonly tokens;
25
+ save(provider: string, token: AuthToken): Promise<void>;
26
+ load(provider: string): Promise<AuthToken | null>;
27
+ clear(provider: string): Promise<void>;
28
+ clearAll(): Promise<void>;
29
+ list(): Promise<string[]>;
30
+ }
31
+ /** Options for FileTokenStore */
32
+ interface FileTokenStoreOptions {
33
+ /** Directory to store token JSON files. Default: ".tokens" in cwd */
34
+ directory: string;
35
+ }
36
+ /** Filesystem-based token store using JSON files (one per provider) */
37
+ declare class FileTokenStore implements ITokenStore {
38
+ private readonly dir;
39
+ constructor(options: FileTokenStoreOptions);
40
+ save(provider: string, token: AuthToken): Promise<void>;
41
+ load(provider: string): Promise<AuthToken | null>;
42
+ clear(provider: string): Promise<void>;
43
+ clearAll(): Promise<void>;
44
+ list(): Promise<string[]>;
45
+ private filePath;
46
+ }
47
+
48
+ export { FileTokenStore as F, type ITokenStore as I, type FileTokenStoreOptions as a, InMemoryTokenStore as b };
@@ -0,0 +1,68 @@
1
+ import { a as ChatEvent } from './types-DRgd_9R7.cjs';
2
+
3
+ /**
4
+ * @witqq/agent-sdk/chat/backends/transport
5
+ *
6
+ * IChatTransport abstracts how ChatEvents are delivered to clients.
7
+ * SSEChatTransport implements Server-Sent Events over HTTP.
8
+ */
9
+
10
+ /**
11
+ * Abstraction for delivering chat events to a client.
12
+ * Implementations handle protocol details (SSE, WebSocket, etc.).
13
+ */
14
+ interface IChatTransport {
15
+ /** Send a single chat event to the client */
16
+ send(event: ChatEvent): void;
17
+ /** Signal stream completion and close the connection */
18
+ close(): void;
19
+ /** Signal an error to the client */
20
+ error(err: Error): void;
21
+ /** Whether the transport is still open */
22
+ readonly isOpen: boolean;
23
+ }
24
+ /** Writable HTTP response interface — minimal type satisfied by Express, Fastify (raw), and Node http.ServerResponse without casts. */
25
+ interface WritableResponse {
26
+ writeHead(statusCode: number, headers?: Record<string, string | string[]>): unknown;
27
+ setHeader(name: string, value: string): unknown;
28
+ write(chunk: string): boolean;
29
+ end(body?: string): unknown;
30
+ readonly writableEnded: boolean;
31
+ }
32
+ /** Minimal interface for detecting client disconnection */
33
+ interface CloseDetectable {
34
+ on(event: "close", listener: () => void): void;
35
+ }
36
+ /** Configuration options for SSEChatTransport */
37
+ interface SSETransportOptions {
38
+ /** Heartbeat interval in milliseconds. 0 or undefined disables heartbeat. */
39
+ heartbeatMs?: number;
40
+ /** Request object for detecting client disconnection (listens for 'close' event) */
41
+ request?: CloseDetectable;
42
+ }
43
+ /**
44
+ * Server-Sent Events transport for ChatEvent streaming.
45
+ * Sends events as `data: JSON\n\n` lines with SSE headers.
46
+ */
47
+ declare class SSEChatTransport implements IChatTransport {
48
+ private readonly res;
49
+ private _open;
50
+ private _heartbeatTimer;
51
+ constructor(res: WritableResponse, options?: SSETransportOptions);
52
+ get isOpen(): boolean;
53
+ send(event: ChatEvent): void;
54
+ close(): void;
55
+ error(err: Error): void;
56
+ private _cleanup;
57
+ private _clearHeartbeat;
58
+ }
59
+ /**
60
+ * Pipes an async iterable of ChatEvents into a transport.
61
+ * Handles errors and ensures transport is closed on completion.
62
+ *
63
+ * @param events - Async iterable of ChatEvent (from adapter.streamMessage)
64
+ * @param transport - Transport to send events through
65
+ */
66
+ declare function streamToTransport(events: AsyncIterable<ChatEvent>, transport: IChatTransport): Promise<void>;
67
+
68
+ export { type CloseDetectable as C, type IChatTransport as I, SSEChatTransport as S, type WritableResponse as W, type SSETransportOptions as a, streamToTransport as s };
@@ -0,0 +1,68 @@
1
+ import { a as ChatEvent } from './types-ajANVzf7.js';
2
+
3
+ /**
4
+ * @witqq/agent-sdk/chat/backends/transport
5
+ *
6
+ * IChatTransport abstracts how ChatEvents are delivered to clients.
7
+ * SSEChatTransport implements Server-Sent Events over HTTP.
8
+ */
9
+
10
+ /**
11
+ * Abstraction for delivering chat events to a client.
12
+ * Implementations handle protocol details (SSE, WebSocket, etc.).
13
+ */
14
+ interface IChatTransport {
15
+ /** Send a single chat event to the client */
16
+ send(event: ChatEvent): void;
17
+ /** Signal stream completion and close the connection */
18
+ close(): void;
19
+ /** Signal an error to the client */
20
+ error(err: Error): void;
21
+ /** Whether the transport is still open */
22
+ readonly isOpen: boolean;
23
+ }
24
+ /** Writable HTTP response interface — minimal type satisfied by Express, Fastify (raw), and Node http.ServerResponse without casts. */
25
+ interface WritableResponse {
26
+ writeHead(statusCode: number, headers?: Record<string, string | string[]>): unknown;
27
+ setHeader(name: string, value: string): unknown;
28
+ write(chunk: string): boolean;
29
+ end(body?: string): unknown;
30
+ readonly writableEnded: boolean;
31
+ }
32
+ /** Minimal interface for detecting client disconnection */
33
+ interface CloseDetectable {
34
+ on(event: "close", listener: () => void): void;
35
+ }
36
+ /** Configuration options for SSEChatTransport */
37
+ interface SSETransportOptions {
38
+ /** Heartbeat interval in milliseconds. 0 or undefined disables heartbeat. */
39
+ heartbeatMs?: number;
40
+ /** Request object for detecting client disconnection (listens for 'close' event) */
41
+ request?: CloseDetectable;
42
+ }
43
+ /**
44
+ * Server-Sent Events transport for ChatEvent streaming.
45
+ * Sends events as `data: JSON\n\n` lines with SSE headers.
46
+ */
47
+ declare class SSEChatTransport implements IChatTransport {
48
+ private readonly res;
49
+ private _open;
50
+ private _heartbeatTimer;
51
+ constructor(res: WritableResponse, options?: SSETransportOptions);
52
+ get isOpen(): boolean;
53
+ send(event: ChatEvent): void;
54
+ close(): void;
55
+ error(err: Error): void;
56
+ private _cleanup;
57
+ private _clearHeartbeat;
58
+ }
59
+ /**
60
+ * Pipes an async iterable of ChatEvents into a transport.
61
+ * Handles errors and ensures transport is closed on completion.
62
+ *
63
+ * @param events - Async iterable of ChatEvent (from adapter.streamMessage)
64
+ * @param transport - Transport to send events through
65
+ */
66
+ declare function streamToTransport(events: AsyncIterable<ChatEvent>, transport: IChatTransport): Promise<void>;
67
+
68
+ export { type CloseDetectable as C, type IChatTransport as I, SSEChatTransport as S, type WritableResponse as W, type SSETransportOptions as a, streamToTransport as s };
@@ -0,0 +1,143 @@
1
+ import { A as AgentSDKError } from './errors-CmVvczxZ.cjs';
2
+
3
+ /**
4
+ * Base auth token returned by all auth providers.
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import type { AuthToken } from "@witqq/agent-sdk/auth";
9
+ *
10
+ * const token: AuthToken = {
11
+ * accessToken: "gho_abc123...",
12
+ * tokenType: "bearer",
13
+ * obtainedAt: Date.now(),
14
+ * };
15
+ * ```
16
+ */
17
+ interface AuthToken {
18
+ /** The access token string */
19
+ accessToken: string;
20
+ /** Token type (e.g. "bearer") */
21
+ tokenType: string;
22
+ /** Seconds until token expires (undefined = long-lived) */
23
+ expiresIn?: number;
24
+ /** Timestamp when the token was obtained */
25
+ obtainedAt: number;
26
+ }
27
+ /**
28
+ * Copilot-specific token (GitHub OAuth, long-lived).
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * import type { CopilotAuthToken } from "@witqq/agent-sdk/auth";
33
+ *
34
+ * const token: CopilotAuthToken = {
35
+ * accessToken: "gho_abc123...",
36
+ * tokenType: "bearer",
37
+ * obtainedAt: Date.now(),
38
+ * login: "octocat",
39
+ * };
40
+ * ```
41
+ */
42
+ interface CopilotAuthToken extends AuthToken {
43
+ /** GitHub user login associated with the token */
44
+ login?: string;
45
+ /** Refresh token for obtaining new access tokens (present when GitHub App has expiring tokens) */
46
+ refreshToken?: string;
47
+ }
48
+ /**
49
+ * Claude-specific token (OAuth+PKCE, expires in 8h).
50
+ *
51
+ * @example
52
+ * ```ts
53
+ * import type { ClaudeAuthToken } from "@witqq/agent-sdk/auth";
54
+ *
55
+ * const token: ClaudeAuthToken = {
56
+ * accessToken: "sk-ant-oat01-...",
57
+ * tokenType: "bearer",
58
+ * expiresIn: 28800,
59
+ * obtainedAt: Date.now(),
60
+ * refreshToken: "sk-ant-rt01-...",
61
+ * scopes: ["user:inference", "user:profile"],
62
+ * };
63
+ * ```
64
+ */
65
+ interface ClaudeAuthToken extends AuthToken {
66
+ /** Refresh token for obtaining new access tokens */
67
+ refreshToken: string;
68
+ /** OAuth scopes granted */
69
+ scopes: string[];
70
+ }
71
+ /**
72
+ * Result of initiating a GitHub Device Flow.
73
+ *
74
+ * @example
75
+ * ```ts
76
+ * import { CopilotAuth } from "@witqq/agent-sdk/auth";
77
+ *
78
+ * const auth = new CopilotAuth();
79
+ * const { userCode, verificationUrl, waitForToken } = await auth.startDeviceFlow();
80
+ * console.log(`Open ${verificationUrl} and enter code: ${userCode}`);
81
+ * const token = await waitForToken();
82
+ * ```
83
+ */
84
+ interface DeviceFlowResult {
85
+ /** The code the user must enter at the verification URL */
86
+ userCode: string;
87
+ /** URL where the user enters the code */
88
+ verificationUrl: string;
89
+ /** Polls GitHub until user authorizes; resolves with token */
90
+ waitForToken: (signal?: AbortSignal) => Promise<CopilotAuthToken>;
91
+ }
92
+ /** Options for starting a Claude OAuth flow */
93
+ interface OAuthFlowOptions {
94
+ /** The redirect URI registered with the OAuth app */
95
+ redirectUri?: string;
96
+ /** OAuth scopes to request (defaults to user:profile user:inference) */
97
+ scopes?: string;
98
+ }
99
+ /**
100
+ * Result of initiating a Claude OAuth flow.
101
+ *
102
+ * @example
103
+ * ```ts
104
+ * import type { OAuthFlowResult } from "@witqq/agent-sdk/auth";
105
+ *
106
+ * const result: OAuthFlowResult = {
107
+ * authorizeUrl: "https://claude.ai/oauth/authorize?...",
108
+ * completeAuth: async (code) => ({ ... }),
109
+ * };
110
+ * // Open result.authorizeUrl in browser, get code from redirect
111
+ * const token = await result.completeAuth(code);
112
+ * ```
113
+ */
114
+ interface OAuthFlowResult {
115
+ /** URL to open in browser for user authorization */
116
+ authorizeUrl: string;
117
+ /** Exchange the authorization code (or full redirect URL) for tokens */
118
+ completeAuth: (codeOrUrl: string) => Promise<ClaudeAuthToken>;
119
+ }
120
+ /** Base error for auth operations.
121
+ * @param message - Error description
122
+ * @param options - Standard ErrorOptions (e.g. cause)
123
+ */
124
+ declare class AuthError extends AgentSDKError {
125
+ constructor(message: string, options?: ErrorOptions);
126
+ }
127
+ /** Device code expired before user authorized */
128
+ declare class DeviceCodeExpiredError extends AuthError {
129
+ constructor();
130
+ }
131
+ /** User denied access during OAuth flow */
132
+ declare class AccessDeniedError extends AuthError {
133
+ constructor();
134
+ }
135
+ /** Token exchange or refresh failed.
136
+ * @param message - Error description
137
+ * @param options - Standard ErrorOptions (e.g. cause)
138
+ */
139
+ declare class TokenExchangeError extends AuthError {
140
+ constructor(message: string, options?: ErrorOptions);
141
+ }
142
+
143
+ export { type AuthToken as A, type CopilotAuthToken as C, type DeviceFlowResult as D, type OAuthFlowOptions as O, TokenExchangeError as T, type OAuthFlowResult as a, type ClaudeAuthToken as b, AccessDeniedError as c, AuthError as d, DeviceCodeExpiredError as e };
@@ -0,0 +1,143 @@
1
+ import { A as AgentSDKError } from './errors-CmVvczxZ.js';
2
+
3
+ /**
4
+ * Base auth token returned by all auth providers.
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import type { AuthToken } from "@witqq/agent-sdk/auth";
9
+ *
10
+ * const token: AuthToken = {
11
+ * accessToken: "gho_abc123...",
12
+ * tokenType: "bearer",
13
+ * obtainedAt: Date.now(),
14
+ * };
15
+ * ```
16
+ */
17
+ interface AuthToken {
18
+ /** The access token string */
19
+ accessToken: string;
20
+ /** Token type (e.g. "bearer") */
21
+ tokenType: string;
22
+ /** Seconds until token expires (undefined = long-lived) */
23
+ expiresIn?: number;
24
+ /** Timestamp when the token was obtained */
25
+ obtainedAt: number;
26
+ }
27
+ /**
28
+ * Copilot-specific token (GitHub OAuth, long-lived).
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * import type { CopilotAuthToken } from "@witqq/agent-sdk/auth";
33
+ *
34
+ * const token: CopilotAuthToken = {
35
+ * accessToken: "gho_abc123...",
36
+ * tokenType: "bearer",
37
+ * obtainedAt: Date.now(),
38
+ * login: "octocat",
39
+ * };
40
+ * ```
41
+ */
42
+ interface CopilotAuthToken extends AuthToken {
43
+ /** GitHub user login associated with the token */
44
+ login?: string;
45
+ /** Refresh token for obtaining new access tokens (present when GitHub App has expiring tokens) */
46
+ refreshToken?: string;
47
+ }
48
+ /**
49
+ * Claude-specific token (OAuth+PKCE, expires in 8h).
50
+ *
51
+ * @example
52
+ * ```ts
53
+ * import type { ClaudeAuthToken } from "@witqq/agent-sdk/auth";
54
+ *
55
+ * const token: ClaudeAuthToken = {
56
+ * accessToken: "sk-ant-oat01-...",
57
+ * tokenType: "bearer",
58
+ * expiresIn: 28800,
59
+ * obtainedAt: Date.now(),
60
+ * refreshToken: "sk-ant-rt01-...",
61
+ * scopes: ["user:inference", "user:profile"],
62
+ * };
63
+ * ```
64
+ */
65
+ interface ClaudeAuthToken extends AuthToken {
66
+ /** Refresh token for obtaining new access tokens */
67
+ refreshToken: string;
68
+ /** OAuth scopes granted */
69
+ scopes: string[];
70
+ }
71
+ /**
72
+ * Result of initiating a GitHub Device Flow.
73
+ *
74
+ * @example
75
+ * ```ts
76
+ * import { CopilotAuth } from "@witqq/agent-sdk/auth";
77
+ *
78
+ * const auth = new CopilotAuth();
79
+ * const { userCode, verificationUrl, waitForToken } = await auth.startDeviceFlow();
80
+ * console.log(`Open ${verificationUrl} and enter code: ${userCode}`);
81
+ * const token = await waitForToken();
82
+ * ```
83
+ */
84
+ interface DeviceFlowResult {
85
+ /** The code the user must enter at the verification URL */
86
+ userCode: string;
87
+ /** URL where the user enters the code */
88
+ verificationUrl: string;
89
+ /** Polls GitHub until user authorizes; resolves with token */
90
+ waitForToken: (signal?: AbortSignal) => Promise<CopilotAuthToken>;
91
+ }
92
+ /** Options for starting a Claude OAuth flow */
93
+ interface OAuthFlowOptions {
94
+ /** The redirect URI registered with the OAuth app */
95
+ redirectUri?: string;
96
+ /** OAuth scopes to request (defaults to user:profile user:inference) */
97
+ scopes?: string;
98
+ }
99
+ /**
100
+ * Result of initiating a Claude OAuth flow.
101
+ *
102
+ * @example
103
+ * ```ts
104
+ * import type { OAuthFlowResult } from "@witqq/agent-sdk/auth";
105
+ *
106
+ * const result: OAuthFlowResult = {
107
+ * authorizeUrl: "https://claude.ai/oauth/authorize?...",
108
+ * completeAuth: async (code) => ({ ... }),
109
+ * };
110
+ * // Open result.authorizeUrl in browser, get code from redirect
111
+ * const token = await result.completeAuth(code);
112
+ * ```
113
+ */
114
+ interface OAuthFlowResult {
115
+ /** URL to open in browser for user authorization */
116
+ authorizeUrl: string;
117
+ /** Exchange the authorization code (or full redirect URL) for tokens */
118
+ completeAuth: (codeOrUrl: string) => Promise<ClaudeAuthToken>;
119
+ }
120
+ /** Base error for auth operations.
121
+ * @param message - Error description
122
+ * @param options - Standard ErrorOptions (e.g. cause)
123
+ */
124
+ declare class AuthError extends AgentSDKError {
125
+ constructor(message: string, options?: ErrorOptions);
126
+ }
127
+ /** Device code expired before user authorized */
128
+ declare class DeviceCodeExpiredError extends AuthError {
129
+ constructor();
130
+ }
131
+ /** User denied access during OAuth flow */
132
+ declare class AccessDeniedError extends AuthError {
133
+ constructor();
134
+ }
135
+ /** Token exchange or refresh failed.
136
+ * @param message - Error description
137
+ * @param options - Standard ErrorOptions (e.g. cause)
138
+ */
139
+ declare class TokenExchangeError extends AuthError {
140
+ constructor(message: string, options?: ErrorOptions);
141
+ }
142
+
143
+ export { type AuthToken as A, type CopilotAuthToken as C, type DeviceFlowResult as D, type OAuthFlowOptions as O, TokenExchangeError as T, type OAuthFlowResult as a, type ClaudeAuthToken as b, AccessDeniedError as c, AuthError as d, DeviceCodeExpiredError as e };