@puku-ai/sdk 4.0.1 → 4.0.2

package/dist/vendor/lib/tools/BetaToolRunner.js

@@ -0,0 +1,497 @@
+import { ToolError } from './ToolError.js';
+import { PukuError } from '../../core/error.js';
+import { buildHeaders } from '../../internal/headers.js';
+import { promiseWithResolvers } from '../../internal/utils/promise.js';
+import { checkNever } from '../../internal/utils/values.js';
+import { DEFAULT_SUMMARY_PROMPT, DEFAULT_TOKEN_THRESHOLD } from './CompactionControl.js';
+import { collectStainlessHelpers, helperHeader, STAINLESS_HELPER_HEADER, } from '../../internal/stainless-helper-header.js';
+/**
+ * A ToolRunner handles the automatic conversation loop between the assistant and tools.
+ *
+ * A ToolRunner is an async iterable that yields either BetaMessage or BetaMessageStream objects
+ * depending on the streaming configuration.
+ */
+export class BetaToolRunner {
+    client;
+    /** Whether the async iterator has been consumed */
+    #consumed = false;
+    /** Whether parameters have been mutated since the last API call */
+    #mutated = false;
+    /** Current state containing the request parameters */
+    #state;
+    #options;
+    /** Promise for the last message received from the assistant */
+    #message;
+    /** Cached tool response to avoid redundant executions */
+    #toolResponse;
+    /** Promise resolvers for waiting on completion */
+    #completion;
+    /** Number of iterations (API requests) made so far */
+    #iterationCount = 0;
+    constructor(client, params, options) {
+        this.client = client;
+        this.#state = {
+            params: {
+                // You can't clone the entire params since there are functions as handlers.
+                // You also don't really need to clone params.messages, but it probably will prevent a foot gun
+                // somewhere.
+                ...params,
+                messages: structuredClone(params.messages),
+            },
+        };
+        // structuredClone drops symbol-keyed properties, so collect helper marks
+        // from the original params here — the create()-side collector won't see
+        // them on the cloned messages.
+        const collected = collectStainlessHelpers(params.tools, params.messages);
+        this.#options = {
+            ...options,
+            headers: buildHeaders([
+                helperHeader('BetaToolRunner'),
+                collected.length ? { [STAINLESS_HELPER_HEADER]: collected.join(', ') } : undefined,
+                options?.headers,
+            ]),
+        };
+        this.#completion = promiseWithResolvers();
+        if (params.compactionControl?.enabled) {
+            console.warn('Puku: The `compactionControl` parameter is deprecated and will be removed in a future version. ' +
+                'Use server-side compaction instead by passing `edits: [{ type: "compact_20260112" }]` in the params passed to `toolRunner()`. ' +
+                'See https://puku.sh/docs/');
+        }
+    }
+    async #checkAndCompact() {
+        const compactionControl = this.#state.params.compactionControl;
+        if (!compactionControl || !compactionControl.enabled) {
+            return false;
+        }
+        let tokensUsed = 0;
+        if (this.#message !== undefined) {
+            try {
+                const message = await this.#message;
+                const totalInputTokens = message.usage.input_tokens +
+                    (message.usage.cache_creation_input_tokens ?? 0) +
+                    (message.usage.cache_read_input_tokens ?? 0);
+                tokensUsed = totalInputTokens + message.usage.output_tokens;
+            }
+            catch {
+                // If we can't get the message, skip compaction
+                return false;
+            }
+        }
+        const threshold = compactionControl.contextTokenThreshold ?? DEFAULT_TOKEN_THRESHOLD;
+        if (tokensUsed < threshold) {
+            return false;
+        }
+        const model = compactionControl.model ?? this.#state.params.model;
+        const summaryPrompt = compactionControl.summaryPrompt ?? DEFAULT_SUMMARY_PROMPT;
+        const messages = this.#state.params.messages;
+        if (messages[messages.length - 1].role === 'assistant') {
+            // Remove tool_use blocks from the last message to avoid 400 error
+            // (tool_use requires tool_result, which we don't have yet)
+            const lastMessage = messages[messages.length - 1];
+            if (Array.isArray(lastMessage.content)) {
+                const nonToolBlocks = lastMessage.content.filter((block) => block.type !== 'tool_use');
+                if (nonToolBlocks.length === 0) {
+                    // If all blocks were tool_use, just remove the message entirely
+                    messages.pop();
+                }
+                else {
+                    lastMessage.content = nonToolBlocks;
+                }
+            }
+        }
+        const response = await this.client.beta.messages.create({
+            model,
+            messages: [
+                ...messages,
+                {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'text',
+                            text: summaryPrompt,
+                        },
+                    ],
+                },
+            ],
+            max_tokens: this.#state.params.max_tokens,
+        }, {
+            signal: this.#options.signal,
+            headers: buildHeaders([this.#options.headers, helperHeader('compaction')]),
+        });
+        if (response.content[0]?.type !== 'text') {
+            throw new PukuError('Expected text response for compaction');
+        }
+        this.#state.params.messages = [
+            {
+                role: 'user',
+                content: response.content,
+            },
+        ];
+        return true;
+    }
+    async *[Symbol.asyncIterator]() {
+        if (this.#consumed) {
+            throw new PukuError('Cannot iterate over a consumed stream');
+        }
+        this.#consumed = true;
+        this.#mutated = true;
+        this.#toolResponse = undefined;
+        try {
+            while (true) {
+                let stream;
+                try {
+                    if (this.#state.params.max_iterations &&
+                        this.#iterationCount >= this.#state.params.max_iterations) {
+                        break;
+                    }
+                    this.#mutated = false;
+                    this.#toolResponse = undefined;
+                    this.#iterationCount++;
+                    this.#message = undefined;
+                    const { max_iterations, compactionControl, ...params } = this.#state.params;
+                    if (params.stream) {
+                        stream = this.client.beta.messages.stream({ ...params }, this.#options);
+                        this.#message = stream.finalMessage();
+                        // Make sure that this promise doesn't throw before we get the option to do something about it.
+                        // Error will be caught when we call await this.#message ultimately
+                        this.#message.catch(() => { });
+                        yield stream;
+                    }
+                    else {
+                        this.#message = this.client.beta.messages.create({ ...params, stream: false }, this.#options);
+                        yield this.#message;
+                    }
+                    const isCompacted = await this.#checkAndCompact();
+                    if (!isCompacted) {
+                        if (!this.#mutated) {
+                            const message = await this.#message;
+                            const nextStep = determineNextStepFromStopReason(message.stop_reason);
+                            this.#state.params.messages.push({ role: message.role, content: message.content });
+                            // Container-bound server tools reject a follow-up request that omits the container the
+                            // previous turn ran in, so carry its id forward unless the caller pinned one themselves.
+                            const { container } = this.#state.params;
+                            if (message.container) {
+                                if (container == null) {
+                                    this.#state.params.container = message.container.id;
+                                }
+                                else if (typeof container === 'object' && container.id == null) {
+                                    this.#state.params.container = { ...container, id: message.container.id };
+                                }
+                            }
+                            if (nextStep === 'stop') {
+                                break;
+                            }
+                            if (nextStep === 'resume') {
+                                continue;
+                            }
+                        }
+                        const toolMessage = await this.#generateToolResponse(this.#state.params.messages.at(-1));
+                        if (toolMessage) {
+                            this.#state.params.messages.push(toolMessage);
+                        }
+                        else if (!this.#mutated) {
+                            break;
+                        }
+                    }
+                }
+                finally {
+                    if (stream) {
+                        stream.abort();
+                    }
+                }
+            }
+            if (!this.#message) {
+                throw new PukuError('ToolRunner concluded without a message from the server');
+            }
+            this.#completion.resolve(await this.#message);
+        }
+        catch (error) {
+            this.#consumed = false;
+            // Silence unhandled promise errors
+            this.#completion.promise.catch(() => { });
+            this.#completion.reject(error);
+            this.#completion = promiseWithResolvers();
+            throw error;
+        }
+    }
+    setMessagesParams(paramsOrMutator) {
+        if (typeof paramsOrMutator === 'function') {
+            this.#state.params = paramsOrMutator(this.#state.params);
+        }
+        else {
+            this.#state.params = paramsOrMutator;
+        }
+        this.#mutated = true;
+        // Invalidate cached tool response since parameters changed
+        this.#toolResponse = undefined;
+    }
+    setRequestOptions(optionsOrMutator) {
+        if (typeof optionsOrMutator === 'function') {
+            this.#options = optionsOrMutator(this.#options);
+        }
+        else {
+            this.#options = { ...this.#options, ...optionsOrMutator };
+        }
+    }
+    /**
+     * Get the tool response for the last message from the assistant.
+     * Avoids redundant tool executions by caching results.
+     *
+     * @returns A promise that resolves to a BetaMessageParam containing tool results, or null if no tools need to be executed
+     *
+     * @example
+     * const toolResponse = await runner.generateToolResponse();
+     * if (toolResponse) {
+     *   console.log('Tool results:', toolResponse.content);
+     * }
+     */
+    async generateToolResponse(signal = this.#options.signal) {
+        const message = (await this.#message) ?? this.params.messages.at(-1);
+        if (!message) {
+            return null;
+        }
+        return this.#generateToolResponse(message, signal);
+    }
+    async #generateToolResponse(lastMessage, signal = this.#options.signal) {
+        if (this.#toolResponse !== undefined) {
+            return this.#toolResponse;
+        }
+        this.#toolResponse = generateToolResponse(this.#state.params, lastMessage, {
+            ...this.#options,
+            signal,
+        });
+        return this.#toolResponse;
+    }
+    /**
+     * Wait for the async iterator to complete. This works even if the async iterator hasn't yet started, and
+     * will wait for an instance to start and go to completion.
+     *
+     * @returns A promise that resolves to the final BetaMessage when the iterator completes
+     *
+     * @example
+     * // Start consuming the iterator
+     * for await (const message of runner) {
+     *   console.log('Message:', message.content);
+     * }
+     *
+     * // Meanwhile, wait for completion from another part of the code
+     * const finalMessage = await runner.done();
+     * console.log('Final response:', finalMessage.content);
+     */
+    done() {
+        return this.#completion.promise;
+    }
+    /**
+     * Returns a promise indicating that the stream is done. Unlike .done(), this will eagerly read the stream:
+     * * If the iterator has not been consumed, consume the entire iterator and return the final message from the
+     * assistant.
+     * * If the iterator has been consumed, waits for it to complete and returns the final message.
+     *
+     * @returns A promise that resolves to the final BetaMessage from the conversation
+     * @throws {PukuError} If no messages were processed during the conversation
+     *
+     * @example
+     * const finalMessage = await runner.runUntilDone();
+     * console.log('Final response:', finalMessage.content);
+     */
+    async runUntilDone() {
+        // If not yet consumed, start consuming and wait for completion
+        if (!this.#consumed) {
+            for await (const _ of this) {
+                // Iterator naturally populates this.#message
+            }
+        }
+        // If consumed but not completed, wait for completion
+        return this.done();
+    }
+    /**
+     * Get the current parameters being used by the ToolRunner.
+     *
+     * @returns A readonly view of the current ToolRunnerParams
+     *
+     * @example
+     * const currentParams = runner.params;
+     * console.log('Current model:', currentParams.model);
+     * console.log('Message count:', currentParams.messages.length);
+     */
+    get params() {
+        return this.#state.params;
+    }
+    /**
+     * Add one or more messages to the conversation history.
+     *
+     * @param messages - One or more BetaMessageParam objects to add to the conversation
+     *
+     * @example
+     * runner.pushMessages(
+     *   { role: 'user', content: 'Also, what about the weather in NYC?' }
+     * );
+     *
+     * @example
+     * // Adding multiple messages
+     * runner.pushMessages(
+     *   { role: 'user', content: 'What about NYC?' },
+     *   { role: 'user', content: 'And Boston?' }
+     * );
+     */
+    pushMessages(...messages) {
+        this.setMessagesParams((params) => ({
+            ...params,
+            messages: [...params.messages, ...messages],
+        }));
+    }
+    /**
+     * Makes the ToolRunner directly awaitable, equivalent to calling .runUntilDone()
+     * This allows using `await runner` instead of `await runner.runUntilDone()`
+     */
+    then(onfulfilled, onrejected) {
+        return this.runUntilDone().then(onfulfilled, onrejected);
+    }
+}
+async function generateToolResponse(params, lastMessage = params.messages.at(-1), requestOptions) {
+    // Only process if the last message is from the assistant and has tool use blocks
+    if (!lastMessage ||
+        lastMessage.role !== 'assistant' ||
+        !lastMessage.content ||
+        typeof lastMessage.content === 'string') {
+        return null;
+    }
+    const toolUseBlocks = lastMessage.content.filter((content) => content.type === 'tool_use');
+    if (toolUseBlocks.length === 0) {
+        return null;
+    }
+    const available = availableToolNames(params);
+    const toolResults = await Promise.all(toolUseBlocks.map(async (toolUse) => {
+        const tool = params.tools.find((t) => ('name' in t ? t.name
+            : 'mcp_server_name' in t ? t.mcp_server_name
+                : t.type) === toolUse.name);
+        // A `tool_removal` is only a hint to the model, which may still emit a tool_use for a
+        // withdrawn tool — treat those exactly like a tool that was never defined.
+        if (!tool || !('run' in tool) || !available.has(toolUse.name)) {
+            return toolNotFoundResult(toolUse);
+        }
+        try {
+            let input = toolUse.input;
+            if ('parse' in tool && tool.parse) {
+                input = tool.parse(input);
+            }
+            const result = await tool.run(input, {
+                toolUse: toolUse,
+                toolUseBlock: toolUse,
+                signal: requestOptions?.signal,
+            });
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: result,
+            };
+        }
+        catch (error) {
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: error instanceof ToolError ?
+                    error.content
+                    : `Error: ${error instanceof Error ? error.message : String(error)}`,
+                is_error: true,
+            };
+        }
+    }));
+    return {
+        role: 'user',
+        content: toolResults,
+    };
+}
+function toolNotFoundResult(toolUse) {
+    return {
+        type: 'tool_result',
+        tool_use_id: toolUse.id,
+        content: `Error: Tool '${toolUse.name}' not found`,
+        is_error: true,
+    };
+}
+/**
+ * Computes the names of locally runnable tools that are still available for the assistant
+ * turn being answered, by folding `tool_removal` / `tool_addition` blocks from the
+ * `role: "system"` messages over the runnable tools. The assistant turn being answered is
+ * terminal-or-absent and only `system` messages are inspected, so folding the whole current
+ * history is exactly folding the messages preceding that turn — call this before appending
+ * anything after it. MCP references are ignored — those tools are executed server-side and
+ * never dispatched by this runner.
+ */
+function availableToolNames(params) {
+    const available = new Set();
+    for (const tool of params.tools) {
+        if ('run' in tool) {
+            available.add(tool.name);
+        }
+    }
+    for (const message of params.messages) {
+        if (message.role !== 'system' || typeof message.content === 'string') {
+            continue;
+        }
+        for (const block of message.content) {
+            applyToolChange(block, available);
+        }
+    }
+    return available;
+}
+function applyToolChange(block, available) {
+    switch (block.type) {
+        case 'tool_removal':
+        case 'tool_addition':
+            applyToolReference(block, available);
+            break;
+    }
+}
+function applyToolReference(block, available) {
+    const name = referencedToolName(block.tool);
+    if (name === undefined)
+        return;
+    if (block.type === 'tool_removal') {
+        available.delete(name);
+    }
+    else {
+        available.add(name);
+    }
+}
+function referencedToolName(ref) {
+    switch (ref.type) {
+        case 'tool_reference':
+            return ref.name;
+        default:
+            // mcp_tool_reference / mcp_toolset_reference run server-side; unknown reference
+            // types are ignored rather than rejected.
+            return undefined;
+    }
+}
+/**
+ * Sorts every stop reason into one of three buckets: `run_tools` turns run their client tool
+ * calls and continue the loop; `resume` turns are sent back unchanged so the server continues
+ * them; `stop` turns end the loop without running any tool calls.
+ */
+function determineNextStepFromStopReason(stopReason) {
+    if (stopReason === null)
+        return 'stop';
+    switch (stopReason) {
+        case 'tool_use':
+            return 'run_tools';
+        case 'pause_turn':
+        // pause_after_compaction hands the turn back before the model answers; sending it back
+        // unchanged continues it.
+        case 'compaction':
+            return 'resume';
+        case 'end_turn':
+        case 'stop_sequence':
+        case 'max_tokens':
+        case 'model_context_window_exceeded':
+        case 'refusal':
+            return 'stop';
+        default:
+            // The union is forward-compatible, so a stop reason this SDK doesn't know yet ends the
+            // loop rather than throwing; the `never` check makes tsc reject an unclassified member.
+            checkNever(stopReason);
+            return 'stop';
+    }
+}
+//# sourceMappingURL=BetaToolRunner.js.map

package/dist/vendor/lib/tools/BetaToolRunner.js.map

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

package/dist/vendor/lib/tools/CompactionControl.d.ts

@@ -0,0 +1,29 @@
+import { Model } from '../../resources';
+export declare const DEFAULT_TOKEN_THRESHOLD = 100000;
+export declare const DEFAULT_SUMMARY_PROMPT = "You have been working on the task described above but have not yet completed it. Write a continuation summary that will allow you (or another instance of yourself) to resume work efficiently in a future context window where the conversation history will be replaced with this summary. Your summary should be structured, concise, and actionable. Include:\n1. Task Overview\nThe user's core request and success criteria\nAny clarifications or constraints they specified\n2. Current State\nWhat has been completed so far\nFiles created, modified, or analyzed (with paths if relevant)\nKey outputs or artifacts produced\n3. Important Discoveries\nTechnical constraints or requirements uncovered\nDecisions made and their rationale\nErrors encountered and how they were resolved\nWhat approaches were tried that didn't work (and why)\n4. Next Steps\nSpecific actions needed to complete the task\nAny blockers or open questions to resolve\nPriority order if multiple steps remain\n5. Context to Preserve\nUser preferences or style requirements\nDomain-specific details that aren't obvious\nAny promises made to the user\nBe concise but complete\u2014err on the side of including information that would prevent duplicate work or repeated mistakes. Write in a way that enables immediate resumption of the task.\nWrap your summary in <summary></summary> tags.";
+/**
+ * @deprecated Use server-side compaction instead by passing
+ * `edits: [{ type: 'compact' }]` in the params passed to `toolRunner()`.
+ *
+ */
+export interface CompactionControl {
+    /**
+     * The context token threshold at which to trigger compaction.
+     *
+     * When the cumulative token count (input + output) across all messages exceeds this threshold,
+     * the message history will be automatically summarized and compressed.
+     *
+     * @default 100000
+     */
+    contextTokenThreshold?: number;
+    /**
+     * The model to use for generating the compaction summary.
+     * If not specified, defaults to the same model used for the tool runner.
+     */
+    model?: Model;
+    /**
+     * The prompt used to instruct the model on how to generate the summary.
+     */
+    summaryPrompt?: string;
+    enabled: boolean;
+}

package/dist/vendor/lib/tools/CompactionControl.js

@@ -0,0 +1,25 @@
+export const DEFAULT_TOKEN_THRESHOLD = 100_000;
+export const DEFAULT_SUMMARY_PROMPT = `You have been working on the task described above but have not yet completed it. Write a continuation summary that will allow you (or another instance of yourself) to resume work efficiently in a future context window where the conversation history will be replaced with this summary. Your summary should be structured, concise, and actionable. Include:
+1. Task Overview
+The user's core request and success criteria
+Any clarifications or constraints they specified
+2. Current State
+What has been completed so far
+Files created, modified, or analyzed (with paths if relevant)
+Key outputs or artifacts produced
+3. Important Discoveries
+Technical constraints or requirements uncovered
+Decisions made and their rationale
+Errors encountered and how they were resolved
+What approaches were tried that didn't work (and why)
+4. Next Steps
+Specific actions needed to complete the task
+Any blockers or open questions to resolve
+Priority order if multiple steps remain
+5. Context to Preserve
+User preferences or style requirements
+Domain-specific details that aren't obvious
+Any promises made to the user
+Be concise but complete—err on the side of including information that would prevent duplicate work or repeated mistakes. Write in a way that enables immediate resumption of the task.
+Wrap your summary in <summary></summary> tags.`;
+//# sourceMappingURL=CompactionControl.js.map

package/dist/vendor/lib/tools/CompactionControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactionControl.js","sourceRoot":"","sources":["../../../../src/vendor/lib/tools/CompactionControl.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;+CAsBS,CAAC"}