@thanh01.pmt/curriculum-kit 1.4.31 → 1.4.32

package/dist/{streamRunner-DYHFhNUr.d.cts → streamRunner-B0Z1nAG5.d.cts}

@@ -1,3 +1,44 @@
+/** Định nghĩa tool (OpenAI-compatible function schema) cho LLM tool-calling */
+interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        /** JSON Schema cho tham số */
+        parameters: Record<string, unknown>;
+    };
+}
+/** Tool call hoàn chỉnh sau khi aggregate các delta */
+interface AggregatedToolCall {
+    id: string;
+    name: string;
+    /** JSON string arguments từ model */
+    arguments: string;
+}
+/** Kết quả thực thi tool do caller cung cấp */
+interface ToolExecutionResult {
+    toolCallId: string;
+    name: string;
+    /** Kết quả serialize thành JSON string khi gửi lại model */
+    result: unknown;
+    isError?: boolean;
+}
+/** Executor: nhận (name, parsedArgs) → kết quả. Throw = lỗi tool (báo lại model) */
+type ToolExecutor = (name: string, args: Record<string, unknown>) => Promise<unknown>;
+/** Cấu hình vòng lặp tool-calling */
+interface ToolLoopConfig {
+    tools: ToolDefinition[];
+    executor: ToolExecutor;
+    /** Số vòng tool-call tối đa (chống vòng lặp vô hạn). Mặc định 4 */
+    maxRounds?: number;
+    /** Báo mỗi lần bắt đầu thực thi tool (để UI hiển thị) */
+    onToolStart?: (name: string, args: Record<string, unknown>) => void;
+    /** Báo kết quả tool */
+    onToolResult?: (result: ToolExecutionResult) => void;
+    /** Báo lỗi tool (không dừng workflow — tool error được đưa lại cho model tự xử lý) */
+    onToolError?: (name: string, error: string) => void;
+}
+
 interface ChatMessage {
     role: 'user' | 'assistant' | 'system' | 'model';
     content: string;
@@ -38,6 +79,40 @@ interface StreamRunnerOptions {
         maxTokens: number;
         onChunk: (token: string, type: ChunkType) => void;
     }) => Promise<string>;
+    /**
+     * Host-provided TOOL-CALLING inference override (unified-tracing mandate,
+     * gap #8 audit 2026-09-14). When present, `streamCurriculumAIInferenceWithTools`
+     * routes every turn through this gateway instead of its built-in raw-fetch
+     * provider routes, so tool-loop calls emit the host's OpenTelemetry spans
+     * (unified Langfuse trace). The request carries the FULL conversation
+     * (including prior assistant tool_calls and tool results) and the OpenAI-
+     * compatible tool definitions; the implementation returns the turn result.
+     * Stream text deltas via ('content'|'thought') chunks and report token spend
+     * via onChunk(JSON.stringify({ promptTokens, completionTokens, totalTokens,
+     * reasoningTokens }), 'usage') — same contract as customInference.
+     */
+    customToolInference?: (request: {
+        messages: Array<{
+            role: string;
+            content: string | null;
+            tool_calls?: Array<{
+                id: string;
+                type: 'function';
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+            }>;
+            tool_call_id?: string;
+        }>;
+        tools: ToolDefinition[];
+        temperature: number;
+        maxTokens: number;
+        onChunk: (token: string, type: ChunkType) => void;
+    }) => Promise<{
+        content: string;
+        toolCalls: AggregatedToolCall[];
+    }>;
 }
 declare function resolveApiKey(keyName: string, explicitKey?: string): string;
 /**
@@ -106,4 +181,4 @@ declare function streamCurriculumAIInference(messages: ChatMessage[], projectCon
  */
 declare function runCurriculumAIInference(messages: ChatMessage[], projectContext: string, options?: StreamRunnerOptions, onChunk?: (token: string, type: ChunkType) => void): Promise<string>;
 
-export { type ChatMessage as C, DEFAULT_ARTIFACT_STREAM_IDLE_MS as D, type FallbackTarget as F, type IdleAbort as I, type StreamRunnerOptions as S, isModelAllowed as a, getDesignatedFallbackConfig as b, type ChunkType as c, DEFAULT_ARTIFACT_STREAM_TOTAL_MS as d, extractThoughtAndContent as e, type StreamAbortController as f, getDesignatedFallbackChain as g, createStreamAbortController as h, isProviderEnabled as i, createIdleAbortController as j, runCurriculumAIInference as k, resolveApiKey as r, streamCurriculumAIInference as s };
+export { type AggregatedToolCall as A, type ChatMessage as C, DEFAULT_ARTIFACT_STREAM_IDLE_MS as D, type FallbackTarget as F, type IdleAbort as I, type StreamRunnerOptions as S, type ToolDefinition as T, isModelAllowed as a, getDesignatedFallbackConfig as b, type ChunkType as c, DEFAULT_ARTIFACT_STREAM_TOTAL_MS as d, extractThoughtAndContent as e, type StreamAbortController as f, getDesignatedFallbackChain as g, createStreamAbortController as h, isProviderEnabled as i, createIdleAbortController as j, runCurriculumAIInference as k, type ToolExecutionResult as l, type ToolExecutor as m, type ToolLoopConfig as n, resolveApiKey as r, streamCurriculumAIInference as s };

package/dist/{streamRunner-DYHFhNUr.d.ts → streamRunner-B0Z1nAG5.d.ts}

@@ -1,3 +1,44 @@
+/** Định nghĩa tool (OpenAI-compatible function schema) cho LLM tool-calling */
+interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        /** JSON Schema cho tham số */
+        parameters: Record<string, unknown>;
+    };
+}
+/** Tool call hoàn chỉnh sau khi aggregate các delta */
+interface AggregatedToolCall {
+    id: string;
+    name: string;
+    /** JSON string arguments từ model */
+    arguments: string;
+}
+/** Kết quả thực thi tool do caller cung cấp */
+interface ToolExecutionResult {
+    toolCallId: string;
+    name: string;
+    /** Kết quả serialize thành JSON string khi gửi lại model */
+    result: unknown;
+    isError?: boolean;
+}
+/** Executor: nhận (name, parsedArgs) → kết quả. Throw = lỗi tool (báo lại model) */
+type ToolExecutor = (name: string, args: Record<string, unknown>) => Promise<unknown>;
+/** Cấu hình vòng lặp tool-calling */
+interface ToolLoopConfig {
+    tools: ToolDefinition[];
+    executor: ToolExecutor;
+    /** Số vòng tool-call tối đa (chống vòng lặp vô hạn). Mặc định 4 */
+    maxRounds?: number;
+    /** Báo mỗi lần bắt đầu thực thi tool (để UI hiển thị) */
+    onToolStart?: (name: string, args: Record<string, unknown>) => void;
+    /** Báo kết quả tool */
+    onToolResult?: (result: ToolExecutionResult) => void;
+    /** Báo lỗi tool (không dừng workflow — tool error được đưa lại cho model tự xử lý) */
+    onToolError?: (name: string, error: string) => void;
+}
+
 interface ChatMessage {
     role: 'user' | 'assistant' | 'system' | 'model';
     content: string;
@@ -38,6 +79,40 @@ interface StreamRunnerOptions {
         maxTokens: number;
         onChunk: (token: string, type: ChunkType) => void;
     }) => Promise<string>;
+    /**
+     * Host-provided TOOL-CALLING inference override (unified-tracing mandate,
+     * gap #8 audit 2026-09-14). When present, `streamCurriculumAIInferenceWithTools`
+     * routes every turn through this gateway instead of its built-in raw-fetch
+     * provider routes, so tool-loop calls emit the host's OpenTelemetry spans
+     * (unified Langfuse trace). The request carries the FULL conversation
+     * (including prior assistant tool_calls and tool results) and the OpenAI-
+     * compatible tool definitions; the implementation returns the turn result.
+     * Stream text deltas via ('content'|'thought') chunks and report token spend
+     * via onChunk(JSON.stringify({ promptTokens, completionTokens, totalTokens,
+     * reasoningTokens }), 'usage') — same contract as customInference.
+     */
+    customToolInference?: (request: {
+        messages: Array<{
+            role: string;
+            content: string | null;
+            tool_calls?: Array<{
+                id: string;
+                type: 'function';
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+            }>;
+            tool_call_id?: string;
+        }>;
+        tools: ToolDefinition[];
+        temperature: number;
+        maxTokens: number;
+        onChunk: (token: string, type: ChunkType) => void;
+    }) => Promise<{
+        content: string;
+        toolCalls: AggregatedToolCall[];
+    }>;
 }
 declare function resolveApiKey(keyName: string, explicitKey?: string): string;
 /**
@@ -106,4 +181,4 @@ declare function streamCurriculumAIInference(messages: ChatMessage[], projectCon
  */
 declare function runCurriculumAIInference(messages: ChatMessage[], projectContext: string, options?: StreamRunnerOptions, onChunk?: (token: string, type: ChunkType) => void): Promise<string>;
 
-export { type ChatMessage as C, DEFAULT_ARTIFACT_STREAM_IDLE_MS as D, type FallbackTarget as F, type IdleAbort as I, type StreamRunnerOptions as S, isModelAllowed as a, getDesignatedFallbackConfig as b, type ChunkType as c, DEFAULT_ARTIFACT_STREAM_TOTAL_MS as d, extractThoughtAndContent as e, type StreamAbortController as f, getDesignatedFallbackChain as g, createStreamAbortController as h, isProviderEnabled as i, createIdleAbortController as j, runCurriculumAIInference as k, resolveApiKey as r, streamCurriculumAIInference as s };
+export { type AggregatedToolCall as A, type ChatMessage as C, DEFAULT_ARTIFACT_STREAM_IDLE_MS as D, type FallbackTarget as F, type IdleAbort as I, type StreamRunnerOptions as S, type ToolDefinition as T, isModelAllowed as a, getDesignatedFallbackConfig as b, type ChunkType as c, DEFAULT_ARTIFACT_STREAM_TOTAL_MS as d, extractThoughtAndContent as e, type StreamAbortController as f, getDesignatedFallbackChain as g, createStreamAbortController as h, isProviderEnabled as i, createIdleAbortController as j, runCurriculumAIInference as k, type ToolExecutionResult as l, type ToolExecutor as m, type ToolLoopConfig as n, resolveApiKey as r, streamCurriculumAIInference as s };