@chatcops/core 0.3.2 → 0.5.0

package/dist/protocol/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAGA,MAAM,cAAc,GAAkC;IACpD,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,GAAG;IACrB,gBAAgB,EAAE,GAAG;IACrB,aAAa,EAAE,GAAG;IAClB,qBAAqB,EAAE,GAAG;IAC1B,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,GAAG;IACvB,iBAAiB,EAAE,GAAG;IACtB,iBAAiB,EAAE,GAAG;IACtB,YAAY,EAAE,GAAG;IACjB,eAAe,EAAE,GAAG;IACpB,UAAU,EAAE,GAAG;IACf,cAAc,EAAE,GAAG;IACnB,cAAc,EAAE,GAAG;IACnB,oBAAoB,EAAE,GAAG;IACzB,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,IAAmB,EACnB,OAAqD;IAErD,MAAM,KAAK,GAA2B,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CAAC,KAAiB;IACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC;QACnB,CAAC,CAAC,oBAAoB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACpD,CAAC,CAAC,iBAAiB,CAAC;AACxB,CAAC"}

package/dist/protocol/index.d.ts

@@ -0,0 +1,9 @@
+export { PROTOCOL_VERSION } from './v1.js';
+export { encodeSSE, SSE_PING, SSE_DONE, SSE_HEADERS } from './sse.js';
+export { statusForError, errorBody, describeInvalidRequest } from './errors.js';
+export { toLegacyChunk } from './legacy.js';
+export { aiSdkEncoder, fromAiSdkRequest, AI_SDK_STREAM_HEADER } from './ai-sdk.js';
+export type { AiSdkChunk } from './ai-sdk.js';
+export type { LegacyChunk } from './legacy.js';
+export type { WirePart, WirePartType, WireErrorCode, WireFinishReason, WireAgent, WireErrorBody, ChatRequestV1, ClientToolManifest, } from './v1.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,6 @@
+export { PROTOCOL_VERSION } from './v1.js';
+export { encodeSSE, SSE_PING, SSE_DONE, SSE_HEADERS } from './sse.js';
+export { statusForError, errorBody, describeInvalidRequest } from './errors.js';
+export { toLegacyChunk } from './legacy.js';
+export { aiSdkEncoder, fromAiSdkRequest, AI_SDK_STREAM_HEADER } from './ai-sdk.js';
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/protocol/legacy.d.ts

@@ -0,0 +1,18 @@
+import type { WirePart } from './v1.js';
+/**
+ * One chunk of the stream servers before 0.6 send, and widgets before 0.6
+ * read: `data: {"content":"Hi"}`, `data: {"done":true}` and so on.
+ */
+export interface LegacyChunk {
+    content?: string;
+    done?: boolean;
+    error?: string;
+    /** Seconds. */
+    retryAfter?: number;
+    leadCaptured?: boolean;
+    leadData?: Record<string, unknown>;
+    suggestedActions?: string[];
+}
+/** The chunk an old widget expects for this part, or null for parts it has no use for. */
+export declare function toLegacyChunk(part: WirePart): LegacyChunk | null;
+//# sourceMappingURL=legacy.d.ts.map

package/dist/protocol/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../src/protocol/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAkBhE"}

package/dist/protocol/legacy.js

@@ -0,0 +1,41 @@
+/** The chunk an old widget expects for this part, or null for parts it has no use for. */
+export function toLegacyChunk(part) {
+    switch (part.type) {
+        case 'text-delta':
+            return { content: part.delta };
+        case 'lead-captured':
+            return { leadCaptured: true, leadData: part.lead };
+        case 'suggestions':
+            return { suggestedActions: part.items };
+        case 'error':
+            return legacyError(part);
+        case 'finish':
+            // After an error the error chunk already went out, and after an abort
+            // nobody is listening.
+            return part.reason === 'error' || part.reason === 'aborted' ? null : { done: true };
+        default:
+            // Parts old widgets have no use for, and parts added after this was written.
+            return null;
+    }
+}
+function legacyError(part) {
+    switch (part.code) {
+        case 'rate_limited': {
+            const { retryAfterMs } = part;
+            if (retryAfterMs === undefined || !Number.isFinite(retryAfterMs) || retryAfterMs <= 0) {
+                return { error: 'rate_limit' };
+            }
+            return { error: 'rate_limit', retryAfter: Math.ceil(retryAfterMs / 1000) };
+        }
+        case 'timeout':
+            return { error: 'timeout' };
+        case 'internal_error':
+            return { error: 'internal_error' };
+        case 'invalid_request':
+            // What 0.5 servers send for a request they can't read.
+            return { error: 'Invalid request' };
+        default:
+            return { error: 'provider_error' };
+    }
+}
+//# sourceMappingURL=legacy.js.map

package/dist/protocol/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../src/protocol/legacy.ts"],"names":[],"mappings":"AAiBA,0FAA0F;AAC1F,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,YAAY;YACf,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,KAAK,eAAe;YAClB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACrD,KAAK,aAAa;YAChB,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1C,KAAK,OAAO;YACV,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,QAAQ;YACX,sEAAsE;YACtE,uBAAuB;YACvB,OAAO,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACtF;YACE,6EAA6E;YAC7E,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAA0C;IAC7D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;YAC9B,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;gBACtF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC;QAC7E,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC9B,KAAK,gBAAgB;YACnB,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QACrC,KAAK,iBAAiB;YACpB,uDAAuD;YACvD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;QACtC;YACE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/protocol/sse.d.ts

@@ -0,0 +1,10 @@
+import type { WirePart } from './v1.js';
+/** One event: `data: <json>` and a blank line. */
+export declare function encodeSSE(part: WirePart | Record<string, unknown>): string;
+/** A comment line that keeps the connection busy while nothing else is sent. */
+export declare const SSE_PING = ": ping\n\n";
+/** Ends the stream. */
+export declare const SSE_DONE = "data: [DONE]\n\n";
+/** Standard HTTP headers for an SSE response. */
+export declare const SSE_HEADERS: Readonly<Record<string, string>>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/protocol/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE1E;AAED,gFAAgF;AAChF,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC,uBAAuB;AACvB,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAE3C,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIvD,CAAC"}

package/dist/protocol/sse.js

@@ -0,0 +1,15 @@
+/** One event: `data: <json>` and a blank line. */
+export function encodeSSE(part) {
+    return `data: ${JSON.stringify(part)}\n\n`;
+}
+/** A comment line that keeps the connection busy while nothing else is sent. */
+export const SSE_PING = ': ping\n\n';
+/** Ends the stream. */
+export const SSE_DONE = 'data: [DONE]\n\n';
+/** Standard HTTP headers for an SSE response. */
+export const SSE_HEADERS = Object.freeze({
+    'Content-Type': 'text/event-stream; charset=utf-8',
+    'Cache-Control': 'no-cache, no-transform',
+    'X-Accel-Buffering': 'no',
+});
+//# sourceMappingURL=sse.js.map

package/dist/protocol/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,IAAwC;IAChE,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAErC,uBAAuB;AACvB,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAE3C,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAqC,MAAM,CAAC,MAAM,CAAC;IACzE,cAAc,EAAE,kCAAkC;IAClD,eAAe,EAAE,wBAAwB;IACzC,mBAAmB,EAAE,IAAI;CAC1B,CAAC,CAAC"}

package/dist/protocol/v1.d.ts

@@ -0,0 +1,140 @@
+import type { JSONSchema, PageContext, ToolExecutor } from '../types.js';
+/**
+ * Version 1 of the stream between the widget and the server.
+ *
+ * The widget asks for it with `"protocol": 1` in the request body. A body
+ * field rather than a header, because servers before 0.6 only allow
+ * `Content-Type` in their CORS preflight. A server that doesn't know the field
+ * ignores it and answers in the old format, and the widget tells the two apart
+ * by the first part: v1 always starts with `start`.
+ *
+ * Every part is one SSE line, `data: <json>`. Clients ignore part types they
+ * don't know, so adding a part is not a version change; changing or removing
+ * one is.
+ */
+export declare const PROTOCOL_VERSION: 1;
+export type WireErrorCode = 'invalid_request' | 'session_required' | 'token_expired' | 'conversation_mismatch' | 'turnstile_failed' | 'origin_not_allowed' | 'conversation_busy' | 'payload_too_large' | 'rate_limited' | 'provider_unavailable' | 'provider_error' | 'tool_error' | 'budget_exceeded' | 'content_filtered' | 'internal_error' | 'timeout';
+export type WireFinishReason = 'stop' | 'length' | 'client-tool-calls' | 'approval-required' | 'handoff' | 'error' | 'aborted';
+export interface WireAgent {
+    name: string;
+    avatarUrl?: string;
+}
+export type WirePart = {
+    type: 'start';
+    protocol: typeof PROTOCOL_VERSION;
+    conversationId: string;
+    /** The id the server saves the reply under. */
+    messageId: string;
+    resumed?: boolean;
+    /** Optional server features the widget can turn on. */
+    capabilities?: {
+        session?: boolean;
+    };
+} | {
+    type: 'text-start';
+    id: string;
+} | {
+    type: 'text-delta';
+    id: string;
+    delta: string;
+} | {
+    type: 'text-end';
+    id: string;
+} | {
+    type: 'source';
+    sourceId: string;
+    url: string;
+    title?: string;
+    snippet?: string;
+} | {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    executor: ToolExecutor;
+    needsApproval?: boolean;
+    title?: string;
+} | {
+    type: 'tool-result';
+    toolCallId: string;
+    output?: unknown;
+    error?: string;
+} | {
+    type: 'lead-captured';
+    lead: Record<string, unknown>;
+} | {
+    type: 'handoff';
+    status: 'requested' | 'queued' | 'connected' | 'ended';
+    agent?: WireAgent;
+    pollAfterMs?: number;
+} | {
+    type: 'agent-message';
+    messageId: string;
+    text: string;
+    agent: WireAgent;
+    timestamp: number;
+} | {
+    type: 'suggestions';
+    items: string[];
+} | {
+    type: 'error';
+    code: WireErrorCode;
+    message?: string;
+    retryable: boolean;
+    retryAfterMs?: number;
+    scope?: 'conversation' | 'session' | 'ip' | 'global';
+} | {
+    type: 'finish';
+    reason: WireFinishReason;
+    /** Only sent when the server is configured to expose usage. */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    pendingToolCalls?: string[];
+    resumeToken?: string;
+};
+export type WirePartType = WirePart['type'];
+/** A tool the page offers, run in the browser (page tools). */
+export interface ClientToolManifest {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    needsApproval?: boolean;
+    title?: string;
+}
+export interface ChatRequestV1 {
+    protocol: typeof PROTOCOL_VERSION;
+    conversationId: string;
+    /** Absent when the request only sends tool results or approvals. */
+    message?: string;
+    messageId?: string;
+    /** `true` is the 0.5 form and regenerates the latest reply. */
+    regenerate?: boolean | {
+        assistantMessageId: string;
+    };
+    toolResults?: Array<{
+        toolCallId: string;
+        output?: unknown;
+        error?: string;
+    }>;
+    toolApprovals?: Array<{
+        toolCallId: string;
+        approved: boolean;
+        reason?: string;
+    }>;
+    resumeToken?: string;
+    clientTools?: ClientToolManifest[];
+    pageContext?: PageContext;
+    locale?: string;
+    userData?: Record<string, string>;
+}
+/** The JSON body of an error answered before the stream starts. */
+export interface WireErrorBody {
+    error: {
+        code: WireErrorCode;
+        message?: string;
+        retryAfterMs?: number;
+    };
+}
+//# sourceMappingURL=v1.d.ts.map

package/dist/protocol/v1.d.ts.map

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

package/dist/protocol/v1.js

@@ -0,0 +1,15 @@
+/**
+ * Version 1 of the stream between the widget and the server.
+ *
+ * The widget asks for it with `"protocol": 1` in the request body. A body
+ * field rather than a header, because servers before 0.6 only allow
+ * `Content-Type` in their CORS preflight. A server that doesn't know the field
+ * ignores it and answers in the old format, and the widget tells the two apart
+ * by the first part: v1 always starts with `start`.
+ *
+ * Every part is one SSE line, `data: <json>`. Clients ignore part types they
+ * don't know, so adding a part is not a version change; changing or removing
+ * one is.
+ */
+export const PROTOCOL_VERSION = 1;
+//# sourceMappingURL=v1.js.map

package/dist/protocol/v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.js","sourceRoot":"","sources":["../../src/protocol/v1.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC"}

package/dist/providers/base.d.ts

@@ -1,22 +1,28 @@
-import { type Tool } from '@google/generative-ai';
-import type { ChatMessage, ProviderChatParams, ProviderConfig, ToolDefinition } from '../types.js';
-export interface AIProvider {
-    name: string;
-    chat(params: ProviderChatParams): AsyncGenerator<string>;
-    chatSync(params: ProviderChatParams): Promise<string>;
-}
+import type { Tool as GeminiTool } from '@google/genai';
+import type { ChatMessage, ProviderConfig, ToolDefinition } from '../types.js';
+import type { AIProvider } from './types.js';
+export type { AIProvider } from './types.js';
+/** Output token limit used when neither the server config nor the request sets one. */
+export declare const DEFAULT_MAX_TOKENS = 4096;
+/**
+ * True for a provider object, false for a provider config. A config never
+ * has functions, so an object with a `step` or `chat` function is a provider.
+ */
+export declare function isAIProvider(value: unknown): value is AIProvider;
 export declare function createProvider(config: ProviderConfig): Promise<AIProvider>;
 export declare function toProviderMessages(messages: ChatMessage[]): Array<{
     role: string;
     content: string;
 }>;
+export { normalizeHistory, normalizeTurns, trimHistory, estimateTokens, type NormalizedMessage, type NormalizedTurn, type TurnPart, } from './history.js';
+/** Logs a configuration warning once per process. */
+export declare function warnOnce(key: string, message: string): void;
 export declare function toClaudeTools(tools: ToolDefinition[]): {
     name: string;
     description: string;
     input_schema: {
         type: "object";
-        properties: Record<string, import("../types.js").ToolParameter>;
-        required: string[];
+        [key: string]: unknown;
     };
 }[];
 export declare function toOpenAITools(tools: ToolDefinition[]): {
@@ -24,12 +30,8 @@ export declare function toOpenAITools(tools: ToolDefinition[]): {
     function: {
         name: string;
         description: string;
-        parameters: {
-            type: "object";
-            properties: Record<string, import("../types.js").ToolParameter>;
-            required: string[];
-        };
+        parameters: import("../types.js").JSONSchema;
     };
 }[];
-export declare function toGeminiTools(tools: ToolDefinition[]): Tool[];
+export declare function toGeminiTools(tools: ToolDefinition[]): GeminiTool[];
 //# sourceMappingURL=base.d.ts.map

package/dist/providers/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,IAAI,EAA4B,MAAM,uBAAuB,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBhF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE;;;;;;;;IAUpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE;;;;;;;;;;;IAapD;AAQD,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,CAkB7D"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAIhE;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBhF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpG;AAED,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC;AAItB,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE;;;kBAIb;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;IAEjF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE;;;;;;;IAapD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE,CAQnE"}

package/dist/providers/base.js

@@ -1,5 +1,21 @@
-import { SchemaType } from '@google/generative-ai';
+import { toolInputSchema } from './schema.js';
+import { getProviderFactory } from './registry.js';
+/** Output token limit used when neither the server config nor the request sets one. */
+export const DEFAULT_MAX_TOKENS = 4096;
+/**
+ * True for a provider object, false for a provider config. A config never
+ * has functions, so an object with a `step` or `chat` function is a provider.
+ */
+export function isAIProvider(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.step === 'function' || typeof candidate.chat === 'function';
+}
 export async function createProvider(config) {
+    const factory = getProviderFactory(config.type);
+    if (factory)
+        return factory(config);
     switch (config.type) {
         case 'claude': {
             const { ClaudeProvider } = await import('./claude.js');
@@ -9,6 +25,10 @@ export async function createProvider(config) {
             const { OpenAIProvider } = await import('./openai.js');
             return new OpenAIProvider(config);
         }
+        case 'openai-compatible': {
+            const { OpenAIProvider } = await import('./openai.js');
+            return new OpenAIProvider(config, { compatible: true });
+        }
         case 'gemini': {
             const { GeminiProvider } = await import('./gemini.js');
             return new GeminiProvider(config);
@@ -22,50 +42,42 @@ export function toProviderMessages(messages) {
         .filter((m) => m.role !== 'system')
         .map((m) => ({ role: m.role, content: m.content }));
 }
+export { normalizeHistory, normalizeTurns, trimHistory, estimateTokens, } from './history.js';
+const warned = new Set();
+/** Logs a configuration warning once per process. */
+export function warnOnce(key, message) {
+    if (warned.has(key))
+        return;
+    warned.add(key);
+    console.warn(`[chatcops] ${message}`);
+}
 export function toClaudeTools(tools) {
     return tools.map((t) => ({
         name: t.name,
         description: t.description,
-        input_schema: {
-            type: 'object',
-            properties: t.parameters,
-            required: t.required,
-        },
+        input_schema: toolInputSchema(t),
     }));
 }
 export function toOpenAITools(tools) {
-    return tools.map((t) => ({
-        type: 'function',
-        function: {
-            name: t.name,
-            description: t.description,
-            parameters: {
-                type: 'object',
-                properties: t.parameters,
-                required: t.required,
+    return tools.map((t) => {
+        const schema = toolInputSchema(t);
+        return {
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                // OpenAI rejects an object schema without `properties`.
+                parameters: 'properties' in schema ? schema : { ...schema, properties: {} },
             },
-        },
-    }));
+        };
+    });
 }
-const SCHEMA_TYPE_MAP = {
-    string: SchemaType.STRING,
-    number: SchemaType.NUMBER,
-    boolean: SchemaType.BOOLEAN,
-};
 export function toGeminiTools(tools) {
     return [{
             functionDeclarations: tools.map((t) => ({
                 name: t.name,
                 description: t.description,
-                parameters: {
-                    type: SchemaType.OBJECT,
-                    properties: Object.fromEntries(Object.entries(t.parameters).map(([k, v]) => [k, {
-                            type: SCHEMA_TYPE_MAP[v.type] ?? SchemaType.STRING,
-                            description: v.description,
-                            ...(v.enum ? { enum: v.enum } : {}),
-                        }])),
-                    required: t.required,
-                },
+                parametersJsonSchema: toolInputSchema(t),
             })),
         }];
 }

package/dist/providers/base.js.map

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

package/dist/providers/claude.d.ts

@@ -1,11 +1,49 @@
-import type { ProviderConfig, ProviderChatParams } from '../types.js';
+import Anthropic from '@anthropic-ai/sdk';
+import type { ChatMessage, ProviderChatParams, ProviderConfig } from '../types.js';
 import type { AIProvider } from './base.js';
+import type { ProviderEvent, ProviderStepParams } from './types.js';
+interface ClaudeVersion {
+    family: string;
+    major: number;
+    minor: number;
+}
+/** Reads family and version from ids like `claude-haiku-5-5` or `claude-haiku-4-5-20251001`. */
+export declare function parseClaudeModel(model: string): ClaudeVersion | null;
+/** `output_config.effort` exists on Opus 4.5 and on every model from 4.6 on. */
+export declare function claudeSupportsEffort(model: string): boolean;
+/** Fable, Mythos, every 5.x model and Opus 4.7+ reject non-default `temperature`. */
+export declare function claudeRejectsTemperature(model: string): boolean;
+type MessageParam = Anthropic.Messages.MessageParam;
+/**
+ * Stored history as Claude messages. An assistant message with tool calls
+ * becomes the assistant turn with its `tool_use` blocks, then a user turn
+ * with the results, and so on for each step. Thinking blocks go back with
+ * their signatures, as Claude requires within a tool loop.
+ */
+export declare function toClaudeStepMessages(messages: ChatMessage[]): MessageParam[];
 export declare class ClaudeProvider implements AIProvider {
     name: string;
     private client;
-    private model;
+    readonly model: string;
+    private effort;
+    private promptCaching;
     constructor(config: ProviderConfig);
+    /**
+     * The system prompt, with a cache breakpoint after it. Claude caches tools
+     * and system together, in that order, so both are read from the cache on
+     * later requests. Per-request context goes after the breakpoint.
+     */
+    private system;
+    private request;
+    /** One model request: streams text and reasoning, then reports tool calls and why it stopped. */
+    step(params: ProviderStepParams): AsyncGenerator<ProviderEvent>;
+    /**
+     * A turn with tools run through `params.toolExecutor`, as text.
+     * @deprecated Use `runTurn()`, which also returns the reply's parts, status and usage.
+     */
     chat(params: ProviderChatParams): AsyncGenerator<string>;
+    /** @deprecated Use `runTurn()`. */
     chatSync(params: ProviderChatParams): Promise<string>;
 }
+export {};
 //# sourceMappingURL=claude.d.ts.map

package/dist/providers/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/providers/claude.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAyC5C,qBAAa,cAAe,YAAW,UAAU;IAC/C,IAAI,SAAY;IAChB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,cAAc;IAK3B,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC;IA2DzD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;CAqD5D"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/providers/claude.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EACV,WAAW,EAEX,kBAAkB,EAClB,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAK5C,OAAO,KAAK,EAAgB,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKlF,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAIpE;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM/D;AAED,KAAK,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC;AAgDpD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,CAyC5E;AA0DD,qBAAa,cAAe,YAAW,UAAU;IAC/C,IAAI,SAAY;IAChB,OAAO,CAAC,MAAM,CAAY;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,aAAa,CAAU;gBAEnB,MAAM,EAAE,cAAc;IAiBlC;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,OAAO;IAwBf,iGAAiG;IAC1F,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,aAAa,CAAC;IAmCtE;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC;IAIxD,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;CAGtD"}