@qodo/sdk 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG3H,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAElG,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAG3D,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,mBAAmB,EACnB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,OAAO,GACR,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/sdk/index.js

@@ -0,0 +1,17 @@
+/**
+ * SDK module - main entry point and public exports
+ */
+export { QodoSDK } from './QodoSDK.js';
+// Public helpers (info + sessions)
+export { QodoInfoClient } from '../clients/info/InfoClient.js';
+export { QodoSessionsClient } from '../clients/sessions/SessionsClient.js';
+export { findNearestAgentConfig } from './discovery.js';
+export { buildDefaultSdkAgentConfig } from './defaults.js';
+// Zod-first helpers (recommended SDK authoring)
+export { zodOutputSchema, zodArgsSchema, zCoerce, parseArgsWithSchema, QodoSchemaError, } from './schemas.js';
+// Zod-first builders (preferred for SDK v2)
+export { sdkAgent, sdkCommand, sdkArgs, } from './builders.js';
+export { SDK_PROTOCOL_V2, SdkEventType, matchSdkEvent, createSdkEvent, getSdkVersion, } from './events.js';
+// Internal runner exports (for advanced usage)
+export { AgentRunnerCore } from './runner/index.js';
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,mCAAmC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAG3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAE3D,gDAAgD;AAChD,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,mBAAmB,EACnB,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,4CAA4C;AAC5C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,OAAO,GACR,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AAkBrB,+CAA+C;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/sdk/runner/AgentRunner.d.ts

@@ -0,0 +1,22 @@
+import { AgentAPI } from '../../api/agent.js';
+import { MessageManager } from '../../context/index.js';
+import { SessionContext } from '../../session/index.js';
+export type EmitFn = (type: string, data: any) => void;
+export declare class AgentRunnerCore {
+    private readonly sessionContext;
+    private readonly messageManager;
+    private readonly agent;
+    private readonly emit;
+    private readonly autoApproveTools;
+    private unsubscribers;
+    private finalEmitted;
+    constructor(sessionContext: SessionContext, messageManager: MessageManager, agent: AgentAPI, emit: EmitFn, autoApproveTools?: boolean);
+    private setupListeners;
+    private flushPendingUserResponses;
+    private emitFinal;
+    start(prompt: string, extraInstructions: string, commandArgs?: Record<string, any>, outputSchema?: any): Promise<void>;
+    resume(sessionId: string): Promise<void>;
+    cancel(): void;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=AgentRunner.d.ts.map

package/dist/sdk/runner/AgentRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRunner.d.ts","sourceRoot":"","sources":["../../../src/sdk/runner/AgentRunner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQxD,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;AAEvD,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IARnC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,YAAY,CAAS;gBAGV,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,EACZ,gBAAgB,GAAE,OAAc;IAwBnD,OAAO,CAAC,cAAc;IAmDtB,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,SAAS;IA+BJ,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEtH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,MAAM,IAAI,IAAI;IAIR,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAStC"}

package/dist/sdk/runner/AgentRunner.js

@@ -0,0 +1,222 @@
+import { v4 as uuid } from 'uuid';
+import { AIMessage } from '@langchain/core/messages';
+import { MCPManager } from '../../mcp/index.js';
+import { toLangChainDict, toOpenAIChat } from './formats.js';
+import { extractProgress } from './progress.js';
+import { buildFinalResult } from './finalize.js';
+import { buildUserContextFromArgs } from '../../context/index.js';
+export class AgentRunnerCore {
+    sessionContext;
+    messageManager;
+    agent;
+    emit;
+    autoApproveTools;
+    unsubscribers = [];
+    finalEmitted = false;
+    constructor(sessionContext, messageManager, agent, emit, autoApproveTools = true) {
+        this.sessionContext = sessionContext;
+        this.messageManager = messageManager;
+        this.agent = agent;
+        this.emit = emit;
+        this.autoApproveTools = autoApproveTools;
+        // Optional auto-approval
+        if (this.autoApproveTools) {
+            try {
+                MCPManager.getInstance().setAutoApprovedAllTools();
+            }
+            catch { }
+        }
+        // Announce protocol
+        this.emit('init', {
+            protocol: 'qodo.sdk.v1',
+            model: this.sessionContext.getModel(),
+            pid: process.pid,
+        });
+        // Say hello from SDK mode
+        this.emit('hello', {
+            message: 'Hello from SDK mode! 👋',
+            mode: 'sdk',
+            ready: true,
+        });
+        this.setupListeners();
+    }
+    setupListeners() {
+        // Messages
+        const unMsg = this.messageManager.addMessageListener((messages) => {
+            const lc = toLangChainDict(messages);
+            const openai = toOpenAIChat(messages);
+            this.emit('messages', { messages: { langchain: lc, openai } });
+            const progress = extractProgress(messages);
+            if (progress) {
+                this.emit('progress', progress);
+            }
+        });
+        this.unsubscribers.push(unMsg);
+        // Loading
+        // IMPORTANT: Wrap in try-catch to ensure emitFinal is always called even if
+        // finishCurrentTask throws. Without this, exceptions in async listeners cause
+        // the SDK stream to hang indefinitely waiting for the 'final' event.
+        const unLoad = this.messageManager.addLoadingListener(async (isLoading) => {
+            this.emit('isLoading', isLoading);
+            if (!isLoading) {
+                try {
+                    await this.agent.finishCurrentTask(false);
+                }
+                catch (e) {
+                    // Log but don't throw - we must emit final regardless
+                    console.debug('[AgentRunnerCore] Error in finishCurrentTask (loading listener):', e instanceof Error ? e.message : e);
+                }
+                this.emitFinal();
+            }
+        });
+        this.unsubscribers.push(unLoad);
+        // Errors
+        // IMPORTANT: Same try-catch pattern to prevent hanging on exceptions.
+        // Also note: error listener may fire before loading becomes false, so we
+        // guard against double emitFinal with the finalEmitted flag.
+        const unErr = this.messageManager.addErrorListener(async (error) => {
+            if (error) {
+                this.emit('error', { message: error });
+                try {
+                    await this.agent.finishCurrentTask(true);
+                }
+                catch (e) {
+                    // Log but don't throw - we must emit final regardless
+                    console.debug('[AgentRunnerCore] Error in finishCurrentTask (error listener):', e instanceof Error ? e.message : e);
+                }
+                this.emitFinal(error);
+            }
+        });
+        this.unsubscribers.push(unErr);
+    }
+    flushPendingUserResponses() {
+        if (this.messageManager.hasPendingResponses()) {
+            const pending = this.messageManager.getAllAccumulatedResponses();
+            pending.forEach((_, toolId) => {
+                this.messageManager.finalizeUserResponse(toolId);
+            });
+        }
+    }
+    emitFinal(err) {
+        // Guard against double emission - both error and loading listeners may call this
+        if (this.finalEmitted) {
+            // Guard against double emission - keep SDK silent by default.
+            return;
+        }
+        this.finalEmitted = true;
+        try {
+            this.flushPendingUserResponses();
+            const finalized = buildFinalResult(this.messageManager);
+            this.emit('final', {
+                success: !err,
+                error: err,
+                session_id: this.sessionContext.getSessionId(),
+                model: this.sessionContext.getModel(),
+                result: {
+                    ...(finalized.structured_output ? { structured_output: finalized.structured_output } : {}),
+                    ...(finalized.final_output ? { final_output: finalized.final_output } : {}),
+                },
+                messages: { langchain: finalized.messagesLC, openai: finalized.messagesOpenAI },
+                meta: {
+                    tools_auto_approved: this.autoApproveTools,
+                    subagents_used: finalized.subagentsUsed,
+                }
+            });
+        }
+        catch (e) {
+            this.emit('final', { success: false, error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    async start(prompt, extraInstructions, commandArgs, outputSchema) {
+        // Reset final emission guard for new run
+        this.finalEmitted = false;
+        this.messageManager.setLoading(true);
+        this.messageManager.setError(null);
+        // Load --with summaries as an AI message, like CLI
+        try {
+            const prevSummaries = this.sessionContext.getPreviousSessionsSummarization();
+            if (prevSummaries && prevSummaries.length > 0) {
+                const heading = `Using context from ${prevSummaries.length} previous session(s):`;
+                const sections = prevSummaries.map(({ sessionId, summary }) => `### Session ${sessionId}\n${(summary || '').trim()}`);
+                const message = [heading, ...sections].join('\n\n---\n\n');
+                this.messageManager.addMessage(new AIMessage(message));
+            }
+        }
+        catch { }
+        if (this.sessionContext.isResumedSession()) {
+            return this.resume(this.sessionContext.getSessionId());
+        }
+        // add user message
+        const { getUserInput } = await import('../../context/userInput.js');
+        const userInput = getUserInput(prompt || '', extraInstructions || '', this.sessionContext.getCommand());
+        this.messageManager.addUserMessage(userInput);
+        // Normalize and validate SDK-provided output schema same as config enforcement
+        let normalizedOutputSchema = undefined;
+        if (outputSchema) {
+            try {
+                if (typeof outputSchema === 'string') {
+                    const { transformOutputSchema } = await import('../../parser/utils.js');
+                    normalizedOutputSchema = transformOutputSchema(outputSchema, 'SDK');
+                }
+                else {
+                    normalizedOutputSchema = outputSchema;
+                }
+                const { validateOutputSchema } = await import('../../parser/index.js');
+                const errors = [];
+                validateOutputSchema(normalizedOutputSchema, 'sdk.output_schema', errors);
+                if (errors.length > 0) {
+                    const msg = errors.map((e) => `${e.path}: ${e.message}`).join('; ');
+                    throw new Error(`Invalid output_schema: ${msg}`);
+                }
+            }
+            catch (e) {
+                throw new Error(e?.message || 'Invalid output_schema');
+            }
+        }
+        const commandCfg = this.sessionContext.getCommand();
+        const enrichedContext = buildUserContextFromArgs(commandArgs || undefined, commandCfg);
+        const agentSession = {
+            sessionId: this.sessionContext.getSessionId(),
+            requestId: uuid(),
+            data: {
+                user_request: extraInstructions || prompt,
+                user_context: enrichedContext,
+                ...(normalizedOutputSchema ? { output_schema: normalizedOutputSchema } : {}),
+                ci_mode: true, // non-interactive behavior
+            },
+            userEngagementCallback: this.messageManager.createUserEngagementCallback(true, true),
+            command: commandCfg,
+        };
+        await this.agent.startTask(agentSession);
+    }
+    async resume(sessionId) {
+        const agentSession = {
+            sessionId,
+            requestId: uuid(),
+            data: {
+                ci_mode: true, // ensure SDK runner stays non-interactive on resume as well
+            },
+            userEngagementCallback: this.messageManager.createUserEngagementCallback(true, true),
+            command: this.sessionContext.getCommand(),
+        };
+        await this.agent.resumeTask(agentSession);
+    }
+    cancel() {
+        this.agent.cancelCurrentSession();
+    }
+    async dispose() {
+        // Remove listeners
+        for (const un of this.unsubscribers) {
+            try {
+                un();
+            }
+            catch { }
+        }
+        this.unsubscribers = [];
+        try {
+            this.agent.removeAllListeners();
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=AgentRunner.js.map

package/dist/sdk/runner/AgentRunner.js.map

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

package/dist/sdk/runner/finalize.d.ts

@@ -0,0 +1,9 @@
+import { MessageManager } from '../../context/index.js';
+export declare function buildFinalResult(messageManager: MessageManager): {
+    structured_output?: any;
+    final_output?: string;
+    messagesLC: any[];
+    messagesOpenAI: any[];
+    subagentsUsed: boolean;
+};
+//# sourceMappingURL=finalize.d.ts.map

package/dist/sdk/runner/finalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../../src/sdk/runner/finalize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,cAAc,GAAG;IAChE,iBAAiB,CAAC,EAAE,GAAG,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,cAAc,EAAE,GAAG,EAAE,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB,CAiHA"}

package/dist/sdk/runner/finalize.js

@@ -0,0 +1,115 @@
+import { AIMessage, ToolMessage } from '@langchain/core/messages';
+import { toLangChainDict, toOpenAIChat } from './formats.js';
+export function buildFinalResult(messageManager) {
+    // Ensure pending accumulated responses are flushed by the caller before invoking this
+    const lastStructured = messageManager.getLastAIStructuredOutputMessage();
+    // IMPORTANT:
+    // The message list includes AIMessages that represent tool calls. Those messages typically have
+    // `tool_calls` populated and `content` set to the tool reasoning. They are not user-facing output
+    // and must not be surfaced as final_output.
+    const messages = messageManager.getMessages();
+    const lastPlainAI = (() => {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const m = messages[i];
+            if (!(m instanceof AIMessage))
+                continue;
+            if (m.additional_kwargs?.type === 'progress')
+                continue;
+            if (Array.isArray(m.tool_calls) && m.tool_calls.length > 0)
+                continue;
+            return m;
+        }
+        return null;
+    })();
+    let structured_output = undefined;
+    let final_output = undefined;
+    if (lastStructured?.content) {
+        const c = lastStructured.content;
+        if (typeof c === 'string') {
+            try {
+                structured_output = JSON.parse(c);
+            }
+            catch {
+                // ignore
+            }
+        }
+        else if (typeof c === 'object') {
+            structured_output = c;
+        }
+    }
+    if (!structured_output && lastPlainAI?.content) {
+        final_output = typeof lastPlainAI.content === 'string'
+            ? lastPlainAI.content
+            : JSON.stringify(lastPlainAI.content);
+        // Heuristic: if the assistant's final output is JSON, surface it as structured_output as well.
+        // This improves DX for output_schema users even when the backend doesn't emit a dedicated
+        // structured_output tool message.
+        const trimmed = final_output.trim();
+        if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (parsed && typeof parsed === 'object') {
+                    structured_output = parsed;
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    // Fallback: find the last meaningful AI message content (excluding tool-call messages)
+    if (!structured_output && (!final_output || final_output.trim().length === 0)) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const m = messages[i];
+            if (m instanceof AIMessage) {
+                if (m.additional_kwargs?.type === 'progress')
+                    continue;
+                if (Array.isArray(m.tool_calls) && m.tool_calls.length > 0)
+                    continue;
+                if (typeof m.content === 'string' && m.content.trim().length > 0) {
+                    final_output = m.content;
+                    break;
+                }
+            }
+        }
+    }
+    // Fallback 2: derive final_output from last ToolMessage content
+    if (!structured_output && (!final_output || final_output.trim().length === 0)) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const m = messages[i];
+            if (m instanceof ToolMessage) {
+                const content = m.content;
+                if (typeof content === 'string' && content.trim().length > 0) {
+                    final_output = content;
+                    break;
+                }
+                if (Array.isArray(content) && content.length > 0) {
+                    const first = content.find((c) => c && typeof c === 'object' && (c.type === 'text' || c.text));
+                    if (first && (first.text || '').trim().length > 0) {
+                        final_output = first.text;
+                        break;
+                    }
+                }
+                if (!final_output && content && typeof content === 'object') {
+                    try {
+                        final_output = JSON.stringify(content);
+                    }
+                    catch { }
+                    if (final_output)
+                        break;
+                }
+            }
+        }
+    }
+    const messagesLC = toLangChainDict(messages);
+    const messagesOpenAI = toOpenAIChat(messages);
+    const subagentsUsed = messages.some((m) => m instanceof AIMessage && m.additional_kwargs?.server_name === 'subagent');
+    return {
+        ...(structured_output ? { structured_output } : {}),
+        ...(final_output ? { final_output } : {}),
+        messagesLC,
+        messagesOpenAI,
+        subagentsUsed,
+    };
+}
+//# sourceMappingURL=finalize.js.map

package/dist/sdk/runner/finalize.js.map

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

package/dist/sdk/runner/formats.d.ts

@@ -0,0 +1,7 @@
+import { BaseMessage } from '@langchain/core/messages';
+export declare function toLangChainDict(messages: BaseMessage[]): Array<{
+    type: string;
+    data: any;
+}>;
+export declare function toOpenAIChat(messages: BaseMessage[]): any[];
+//# sourceMappingURL=formats.d.ts.map

package/dist/sdk/runner/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../src/sdk/runner/formats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAe,MAAM,0BAA0B,CAAC;AAI/E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,CAyD3F;AAGD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,EAAE,CAkC3D"}

package/dist/sdk/runner/formats.js

@@ -0,0 +1,91 @@
+import { AIMessage, ToolMessage } from '@langchain/core/messages';
+import { _convertMessagesToOpenAIParams } from '@langchain/openai';
+// Convert LangChain messages to dict form compatible with Python messages_from_dict
+export function toLangChainDict(messages) {
+    return messages.map((msg) => {
+        const base = msg;
+        const isAI = msg instanceof AIMessage;
+        const isTool = msg instanceof ToolMessage;
+        if (isAI) {
+            return {
+                type: 'ai',
+                data: {
+                    content: base.content,
+                    tool_calls: Array.isArray(base.tool_calls)
+                        ? base.tool_calls.map((tc) => ({
+                            id: tc.id,
+                            name: tc.name,
+                            args: tc.args,
+                            type: tc.type || 'tool_call',
+                        }))
+                        : [],
+                    additional_kwargs: base.additional_kwargs || {},
+                },
+            };
+        }
+        if (isTool) {
+            // Preserve status and tool_call_id
+            return {
+                type: 'tool',
+                data: {
+                    content: base.content,
+                    tool_call_id: base.tool_call_id,
+                    name: base.name,
+                    status: base.status,
+                    additional_kwargs: base.additional_kwargs || {},
+                },
+            };
+        }
+        // Human/System/Function fallbacks
+        const ctor = msg._getType?.() || msg.constructor?.name || '';
+        const t = ctor.toString().toLowerCase();
+        if (t.includes('human')) {
+            return { type: 'human', data: { content: base.content, additional_kwargs: base.additional_kwargs || {} } };
+        }
+        if (t.includes('system')) {
+            return { type: 'system', data: { content: base.content, additional_kwargs: base.additional_kwargs || {} } };
+        }
+        if (t.includes('function')) {
+            return {
+                type: 'function',
+                data: { content: base.content, name: base.name, additional_kwargs: base.additional_kwargs || {} },
+            };
+        }
+        // Default fallback
+        return { type: 'ai', data: { content: String(base.content ?? ''), additional_kwargs: base.additional_kwargs || {} } };
+    });
+}
+// Convert messages to OpenAI chat params while preserving additional fields per webApp.enhanceMessages
+export function toOpenAIChat(messages) {
+    // Filter out progress messages from assistant for OpenAI mapping but preserve additional_kwargs
+    const reindexed = messages.map(m => {
+        if (m instanceof AIMessage &&
+            m.tool_calls &&
+            m.tool_calls.length > 0 &&
+            m.additional_kwargs?.tool_args_for_ui) {
+            // copy and augment args for UI
+            const c = new AIMessage({
+                content: m.content,
+                tool_calls: m.tool_calls.map((tc) => ({
+                    ...tc,
+                    args: { ...tc.args, argsForUI: m.additional_kwargs.tool_args_for_ui },
+                })),
+                additional_kwargs: m.additional_kwargs,
+            });
+            return c;
+        }
+        return m;
+    });
+    const open = _convertMessagesToOpenAIParams(reindexed);
+    return open.map((o, i) => {
+        const original = reindexed[i];
+        if (original instanceof AIMessage && original.additional_kwargs) {
+            return { ...o, additional_kwargs: original.additional_kwargs };
+        }
+        if (o.role === 'tool' && original instanceof ToolMessage) {
+            return { ...o, status: original.status, tool_call_id: o.tool_call_id || original.tool_call_id };
+        }
+        return o;
+    });
+}
+//# sourceMappingURL=formats.js.map

package/dist/sdk/runner/formats.js.map

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

package/dist/sdk/runner/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent runner components
+ * @internal
+ */
+export type { EmitFn } from './AgentRunner.js';
+export { toLangChainDict, toOpenAIChat } from './formats.js';
+export { extractProgress } from './progress.js';
+export { buildFinalResult } from './finalize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/runner/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/sdk/runner/index.js

@@ -0,0 +1,9 @@
+/**
+ * Agent runner components
+ * @internal
+ */
+export { AgentRunnerCore } from './AgentRunner.js';
+export { toLangChainDict, toOpenAIChat } from './formats.js';
+export { extractProgress } from './progress.js';
+export { buildFinalResult } from './finalize.js';
+//# sourceMappingURL=index.js.map

package/dist/sdk/runner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sdk/runner/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/sdk/runner/progress.d.ts

@@ -0,0 +1,3 @@
+import { BaseMessage } from '@langchain/core/messages';
+export declare function extractProgress(messages: BaseMessage[]): any | null;
+//# sourceMappingURL=progress.d.ts.map

package/dist/sdk/runner/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/sdk/runner/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,GAAG,IAAI,CAWnE"}

package/dist/sdk/runner/progress.js

@@ -0,0 +1,16 @@
+import { AIMessage } from '@langchain/core/messages';
+export function extractProgress(messages) {
+    if (!messages || messages.length === 0)
+        return null;
+    const last = messages[messages.length - 1];
+    if (last instanceof AIMessage && last.additional_kwargs?.type === 'progress') {
+        try {
+            return JSON.parse(String(last.content || '{}'));
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=progress.js.map

package/dist/sdk/runner/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/sdk/runner/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,0BAA0B,CAAC;AAElE,MAAM,UAAU,eAAe,CAAC,QAAuB;IACrD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,YAAY,SAAS,IAAK,IAAY,CAAC,iBAAiB,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;QACtF,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAE,IAAY,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}