@allternit/gizzi-sdk 1.3.0

package/dist/providers/allternit/lib/beta-parser.js

@@ -0,0 +1,75 @@
+import { AllternitError } from '../core/error';
+function getOutputFormat(params) {
+    // Prefer output_format (deprecated) over output_config.format for backward compatibility
+    return params?.output_format ?? params?.output_config?.format;
+}
+export function maybeParseBetaMessage(message, params, opts) {
+    const outputFormat = getOutputFormat(params);
+    if (!params || !('parse' in (outputFormat ?? {}))) {
+        return {
+            ...message,
+            content: message.content.map((block) => {
+                if (block.type === 'text') {
+                    const parsedBlock = Object.defineProperty({ ...block }, 'parsed_output', {
+                        value: null,
+                        enumerable: false,
+                    });
+                    return Object.defineProperty(parsedBlock, 'parsed', {
+                        get() {
+                            opts.logger.warn('The `parsed` property on `text` blocks is deprecated, please use `parsed_output` instead.');
+                            return null;
+                        },
+                        enumerable: false,
+                    });
+                }
+                return block;
+            }),
+            parsed_output: null,
+        };
+    }
+    return parseBetaMessage(message, params, opts);
+}
+export function parseBetaMessage(message, params, opts) {
+    let firstParsedOutput = null;
+    const content = message.content.map((block) => {
+        if (block.type === 'text') {
+            const parsedOutput = parseBetaOutputFormat(params, block.text);
+            if (firstParsedOutput === null) {
+                firstParsedOutput = parsedOutput;
+            }
+            const parsedBlock = Object.defineProperty({ ...block }, 'parsed_output', {
+                value: parsedOutput,
+                enumerable: false,
+            });
+            return Object.defineProperty(parsedBlock, 'parsed', {
+                get() {
+                    opts.logger.warn('The `parsed` property on `text` blocks is deprecated, please use `parsed_output` instead.');
+                    return parsedOutput;
+                },
+                enumerable: false,
+            });
+        }
+        return block;
+    });
+    return {
+        ...message,
+        content,
+        parsed_output: firstParsedOutput,
+    };
+}
+function parseBetaOutputFormat(params, content) {
+    const outputFormat = getOutputFormat(params);
+    if (outputFormat?.type !== 'json_schema') {
+        return null;
+    }
+    try {
+        if ('parse' in outputFormat) {
+            return outputFormat.parse(content);
+        }
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new AllternitError(`Failed to parse structured output: ${error}`);
+    }
+}
+//# sourceMappingURL=beta-parser.js.map

package/dist/providers/allternit/lib/beta-parser.js.map

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

package/dist/providers/allternit/lib/parser.d.ts

@@ -0,0 +1,32 @@
+import type { Logger } from '../client';
+import { ContentBlock, JSONOutputFormat, Message, OutputConfig, TextBlock, MessageCreateParams } from '../resources/messages/messages';
+type Simplify<T> = {
+    [KeyType in keyof T]: T[KeyType];
+} & {};
+type AutoParseableOutputConfig = Omit<OutputConfig, 'format'> & {
+    format?: JSONOutputFormat | AutoParseableOutputFormat<any> | null;
+};
+export type ParseableMessageCreateParams = Simplify<Omit<MessageCreateParams, 'output_config'> & {
+    output_config?: AutoParseableOutputConfig | null;
+}>;
+export type ExtractParsedContentFromParams<Params extends ParseableMessageCreateParams> = Params['output_config'] extends {
+    format: AutoParseableOutputFormat<infer P>;
+} ? P : null;
+export type AutoParseableOutputFormat<ParsedT> = JSONOutputFormat & {
+    parse(content: string): ParsedT;
+};
+export type ParsedMessage<ParsedT> = Message & {
+    content: Array<ParsedContentBlock<ParsedT>>;
+    parsed_output: ParsedT | null;
+};
+export type ParsedContentBlock<ParsedT> = (TextBlock & {
+    parsed_output: ParsedT | null;
+}) | Exclude<ContentBlock, TextBlock>;
+export declare function maybeParseMessage<Params extends ParseableMessageCreateParams | null>(message: Message, params: Params, opts: {
+    logger: Logger;
+}): ParsedMessage<ExtractParsedContentFromParams<NonNullable<Params>>>;
+export declare function parseMessage<Params extends ParseableMessageCreateParams>(message: Message, params: Params, opts: {
+    logger: Logger;
+}): ParsedMessage<ExtractParsedContentFromParams<Params>>;
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/providers/allternit/lib/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/providers/allternit/lib/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,SAAS,EACT,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAGxC,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CAAE,GAAG,EAAE,CAAC;AAE7D,KAAK,yBAAyB,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG;IAC9D,MAAM,CAAC,EAAE,gBAAgB,GAAG,yBAAyB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG;IAC3C,aAAa,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAClD,CACF,CAAC;AAEF,MAAM,MAAM,8BAA8B,CAAC,MAAM,SAAS,4BAA4B,IACpF,MAAM,CAAC,eAAe,CAAC,SAAS;IAAE,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,IAAI,CAAC;AAE5F,MAAM,MAAM,yBAAyB,CAAC,OAAO,IAAI,gBAAgB,GAAG;IAClE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,OAAO,GAAG;IAC7C,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAClC,CAAC,SAAS,GAAG;IAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC,GAC/C,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAQrC,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,4BAA4B,GAAG,IAAI,EAClF,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAqBpE;AAED,wBAAgB,YAAY,CAAC,MAAM,SAAS,4BAA4B,EACtE,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CA2BvD"}

package/dist/providers/allternit/lib/parser.js

@@ -0,0 +1,62 @@
+import { AllternitError } from '../core/error';
+function getOutputFormat(params) {
+    return params?.output_config?.format;
+}
+export function maybeParseMessage(message, params, opts) {
+    const outputFormat = getOutputFormat(params);
+    if (!params || !('parse' in (outputFormat ?? {}))) {
+        return {
+            ...message,
+            content: message.content.map((block) => {
+                if (block.type === 'text') {
+                    const parsedBlock = Object.defineProperty({ ...block }, 'parsed_output', {
+                        value: null,
+                        enumerable: false,
+                    });
+                    return parsedBlock;
+                }
+                return block;
+            }),
+            parsed_output: null,
+        };
+    }
+    return parseMessage(message, params, opts);
+}
+export function parseMessage(message, params, opts) {
+    let firstParsedOutput = null;
+    const content = message.content.map((block) => {
+        if (block.type === 'text') {
+            const parsedOutput = parseOutputFormat(params, block.text);
+            if (firstParsedOutput === null) {
+                firstParsedOutput = parsedOutput;
+            }
+            const parsedBlock = Object.defineProperty({ ...block }, 'parsed_output', {
+                value: parsedOutput,
+                enumerable: false,
+            });
+            return parsedBlock;
+        }
+        return block;
+    });
+    return {
+        ...message,
+        content,
+        parsed_output: firstParsedOutput,
+    };
+}
+function parseOutputFormat(params, content) {
+    const outputFormat = getOutputFormat(params);
+    if (outputFormat?.type !== 'json_schema') {
+        return null;
+    }
+    try {
+        if ('parse' in outputFormat) {
+            return outputFormat.parse(content);
+        }
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new AllternitError(`Failed to parse structured output: ${error}`);
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/providers/allternit/lib/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/providers/allternit/lib/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAuC/C,SAAS,eAAe,CACtB,MAA2C;IAE3C,OAAO,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,MAAc,EACd,IAAwB;IAExB,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,EAAE;wBACvE,KAAK,EAAE,IAAI;wBACX,UAAU,EAAE,KAAK;qBAClB,CAA4E,CAAC;oBAE9E,OAAO,WAAW,CAAC;gBACrB,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;YACF,aAAa,EAAE,IAAI;SACkD,CAAC;IAC1E,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,MAAc,EACd,IAAwB;IAExB,IAAI,iBAAiB,GAAwD,IAAI,CAAC;IAElF,MAAM,OAAO,GAAsE,OAAO,CAAC,OAAO,CAAC,GAAG,CACpG,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAE3D,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;gBAC/B,iBAAiB,GAAG,YAAY,CAAC;YACnC,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,EAAE;gBACvE,KAAK,EAAE,YAAY;gBACnB,UAAU,EAAE,KAAK;aAClB,CAA+D,CAAC;YACjE,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CACF,CAAC;IAEF,OAAO;QACL,GAAG,OAAO;QACV,OAAO;QACP,aAAa,EAAE,iBAAiB;KACwB,CAAC;AAC7D,CAAC;AAED,SAAS,iBAAiB,CACxB,MAAc,EACd,OAAe;IAEf,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,YAAY,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;YAC5B,OAAO,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/providers/allternit/lib/stainless-helper-header.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared utilities for tracking SDK helper usage.
+ */
+import type { BetaMessageParam, BetaToolUnion } from '../resources/beta';
+/**
+ * Symbol used to mark objects created by SDK helpers for tracking.
+ * The value is the helper name (e.g., 'mcpTool', 'betaZodTool').
+ */
+export declare const SDK_HELPER_SYMBOL: unique symbol;
+type StainlessHelperObject = {
+    [SDK_HELPER_SYMBOL]: string;
+};
+export declare function wasCreatedByStainlessHelper(value: unknown): value is StainlessHelperObject;
+/**
+ * Collects helper names from tools and messages arrays.
+ * Returns a deduplicated array of helper names found.
+ */
+export declare function collectStainlessHelpers(tools: BetaToolUnion[] | undefined, messages: BetaMessageParam[] | undefined): string[];
+/**
+ * Builds x-stainless-helper header value from tools and messages.
+ * Returns an empty object if no helpers are found.
+ */
+export declare function stainlessHelperHeader(tools: BetaToolUnion[] | undefined, messages: BetaMessageParam[] | undefined): {
+    'x-stainless-helper'?: string;
+};
+/**
+ * Builds x-stainless-helper header value from a file object.
+ * Returns an empty object if the file is not marked with a helper.
+ */
+export declare function stainlessHelperHeaderFromFile(file: unknown): {
+    'x-stainless-helper'?: string;
+};
+export {};
+//# sourceMappingURL=stainless-helper-header.d.ts.map

package/dist/providers/allternit/lib/stainless-helper-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stainless-helper-header.d.ts","sourceRoot":"","sources":["../../../../src/providers/allternit/lib/stainless-helper-header.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,eAA0C,CAAC;AAEzE,KAAK,qBAAqB,GAAG;IAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAE1F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC,MAAM,EAAE,CA8BV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAInC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9F"}

package/dist/providers/allternit/lib/stainless-helper-header.js

@@ -0,0 +1,63 @@
+/**
+ * Shared utilities for tracking SDK helper usage.
+ */
+/**
+ * Symbol used to mark objects created by SDK helpers for tracking.
+ * The value is the helper name (e.g., 'mcpTool', 'betaZodTool').
+ */
+export const SDK_HELPER_SYMBOL = Symbol('allternit.sdk.stainlessHelper');
+export function wasCreatedByStainlessHelper(value) {
+    return typeof value === 'object' && value !== null && SDK_HELPER_SYMBOL in value;
+}
+/**
+ * Collects helper names from tools and messages arrays.
+ * Returns a deduplicated array of helper names found.
+ */
+export function collectStainlessHelpers(tools, messages) {
+    const helpers = new Set();
+    // Collect from tools
+    if (tools) {
+        for (const tool of tools) {
+            if (wasCreatedByStainlessHelper(tool)) {
+                helpers.add(tool[SDK_HELPER_SYMBOL]);
+            }
+        }
+    }
+    // Collect from messages and their content blocks
+    if (messages) {
+        for (const message of messages) {
+            if (wasCreatedByStainlessHelper(message)) {
+                helpers.add(message[SDK_HELPER_SYMBOL]);
+            }
+            if (Array.isArray(message.content)) {
+                for (const block of message.content) {
+                    if (wasCreatedByStainlessHelper(block)) {
+                        helpers.add(block[SDK_HELPER_SYMBOL]);
+                    }
+                }
+            }
+        }
+    }
+    return Array.from(helpers);
+}
+/**
+ * Builds x-stainless-helper header value from tools and messages.
+ * Returns an empty object if no helpers are found.
+ */
+export function stainlessHelperHeader(tools, messages) {
+    const helpers = collectStainlessHelpers(tools, messages);
+    if (helpers.length === 0)
+        return {};
+    return { 'x-stainless-helper': helpers.join(', ') };
+}
+/**
+ * Builds x-stainless-helper header value from a file object.
+ * Returns an empty object if the file is not marked with a helper.
+ */
+export function stainlessHelperHeaderFromFile(file) {
+    if (wasCreatedByStainlessHelper(file)) {
+        return { 'x-stainless-helper': file[SDK_HELPER_SYMBOL] };
+    }
+    return {};
+}
+//# sourceMappingURL=stainless-helper-header.js.map

package/dist/providers/allternit/lib/stainless-helper-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stainless-helper-header.js","sourceRoot":"","sources":["../../../../src/providers/allternit/lib/stainless-helper-header.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC;AAIzE,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,iBAAiB,IAAI,KAAK,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAkC,EAClC,QAAwC;IAExC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,qBAAqB;IACrB,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAC1C,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpC,IAAI,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;wBACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;oBACxC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAkC,EAClC,QAAwC;IAExC,MAAM,OAAO,GAAG,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAa;IACzD,IAAI,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,oBAAoB,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/providers/allternit/lib/tools/BetaRunnableTool.d.ts

@@ -0,0 +1,12 @@
+import { BetaMemoryTool20250818, BetaTool, BetaToolBash20241022, BetaToolBash20250124, BetaToolComputerUse20241022, BetaToolComputerUse20250124, BetaToolComputerUse20251124, BetaToolResultContentBlockParam, BetaToolTextEditor20241022, BetaToolTextEditor20250124, BetaToolTextEditor20250429, BetaToolTextEditor20250728 } from '../../resources/beta';
+export type Promisable<T> = T | Promise<T>;
+/**
+ * Tool types that can be implemented on the client.
+ * Excludes server-side tools like code execution, web search, and MCP toolsets.
+ */
+export type BetaClientRunnableToolType = BetaTool | BetaMemoryTool20250818 | BetaToolBash20241022 | BetaToolBash20250124 | BetaToolComputerUse20241022 | BetaToolComputerUse20250124 | BetaToolComputerUse20251124 | BetaToolTextEditor20241022 | BetaToolTextEditor20250124 | BetaToolTextEditor20250429 | BetaToolTextEditor20250728;
+export type BetaRunnableTool<Input = any> = BetaClientRunnableToolType & {
+    run: (args: Input) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
+    parse: (content: unknown) => Input;
+};
+//# sourceMappingURL=BetaRunnableTool.d.ts.map

package/dist/providers/allternit/lib/tools/BetaRunnableTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BetaRunnableTool.d.ts","sourceRoot":"","sources":["../../../../../src/providers/allternit/lib/tools/BetaRunnableTool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAClC,QAAQ,GACR,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,2BAA2B,GAC3B,2BAA2B,GAC3B,2BAA2B,GAC3B,0BAA0B,GAC1B,0BAA0B,GAC1B,0BAA0B,GAC1B,0BAA0B,CAAC;AAI/B,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,GAAG,IAAI,0BAA0B,GAAG;IACvE,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IAClF,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC;CACpC,CAAC"}

package/dist/providers/allternit/lib/tools/BetaRunnableTool.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BetaRunnableTool.js.map

package/dist/providers/allternit/lib/tools/BetaRunnableTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BetaRunnableTool.js","sourceRoot":"","sources":["../../../../../src/providers/allternit/lib/tools/BetaRunnableTool.ts"],"names":[],"mappings":""}

package/dist/providers/allternit/lib/tools/BetaToolRunner.d.ts

@@ -0,0 +1,136 @@
+import { BetaRunnableTool } from './BetaRunnableTool';
+import { AllternitAI as Allternit } from '../..';
+import { BetaMessage, BetaMessageParam, BetaToolUnion, MessageCreateParams } from '../../resources/beta';
+import { BetaMessageStream } from '../BetaMessageStream';
+import { RequestOptions } from '../../internal/request-options';
+import { CompactionControl } from './CompactionControl';
+/**
+ * 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 declare class BetaToolRunner<Stream extends boolean> {
+    #private;
+    private client;
+    constructor(client: Allternit, params: BetaToolRunnerParams, options?: BetaToolRunnerRequestOptions);
+    [Symbol.asyncIterator](): AsyncIterator<Stream extends true ? BetaMessageStream : Stream extends false ? BetaMessage : BetaMessage | BetaMessageStream>;
+    /**
+     * Update the parameters for the next API call. This invalidates any cached tool responses.
+     *
+     * @param paramsOrMutator - Either new parameters or a function to mutate existing parameters
+     *
+     * @example
+     * // Direct parameter update
+     * runner.setMessagesParams({
+     *   model: 'claude-haiku-4-5',
+     *   max_tokens: 500,
+     * });
+     *
+     * @example
+     * // Using a mutator function
+     * runner.setMessagesParams((params) => ({
+     *   ...params,
+     *   max_tokens: 100,
+     * }));
+     */
+    setMessagesParams(params: BetaToolRunnerParams): void;
+    setMessagesParams(mutator: (prevParams: BetaToolRunnerParams) => BetaToolRunnerParams): void;
+    /**
+     * 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);
+     * }
+     */
+    generateToolResponse(): Promise<Allternit.Beta.Messages.BetaMessageParam | null>;
+    /**
+     * 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(): Promise<BetaMessage>;
+    /**
+     * 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 {AllternitError} If no messages were processed during the conversation
+     *
+     * @example
+     * const finalMessage = await runner.runUntilDone();
+     * console.log('Final response:', finalMessage.content);
+     */
+    runUntilDone(): Promise<BetaMessage>;
+    /**
+     * 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(): Readonly<BetaToolRunnerParams>;
+    /**
+     * 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: BetaMessageParam[]): void;
+    /**
+     * Makes the ToolRunner directly awaitable, equivalent to calling .runUntilDone()
+     * This allows using `await runner` instead of `await runner.runUntilDone()`
+     */
+    then<TResult1 = BetaMessage, TResult2 = never>(onfulfilled?: ((value: BetaMessage) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
+}
+type Simplify<T> = {
+    [KeyType in keyof T]: T[KeyType];
+} & {};
+/**
+ * Parameters for creating a ToolRunner, extending MessageCreateParams with runnable tools.
+ */
+export type BetaToolRunnerParams = Simplify<Omit<MessageCreateParams, 'tools'> & {
+    tools: (BetaToolUnion | BetaRunnableTool<any>)[];
+    /**
+     * Maximum number of iterations (API requests) to make in the tool execution loop.
+     * Each iteration consists of: assistant response → tool execution → tool results.
+     * When exceeded, the loop will terminate even if tools are still being requested.
+     */
+    max_iterations?: number;
+    compactionControl?: CompactionControl;
+}>;
+export type BetaToolRunnerRequestOptions = Pick<RequestOptions, 'headers'>;
+export {};
+//# sourceMappingURL=BetaToolRunner.d.ts.map

package/dist/providers/allternit/lib/tools/BetaToolRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BetaToolRunner.d.ts","sourceRoot":"","sources":["../../../../../src/providers/allternit/lib/tools/BetaToolRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,WAAW,IAAI,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAmD,MAAM,qBAAqB,CAAC;AAoBzG;;;;;GAKG;AACH,qBAAa,cAAc,CAAC,MAAM,SAAS,OAAO;;IAsB9C,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS,EACzB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,4BAA4B;IAwGjC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAC5C,MAAM,SAAS,IAAI,GAAG,iBAAiB,GACrC,MAAM,SAAS,KAAK,GAAG,WAAW,GAClC,WAAW,GAAG,iBAAiB,CAClC;IA2ED;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IACrD,iBAAiB,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,oBAAoB,GAAG,IAAI;IAc5F;;;;;;;;;;;OAWG;IACG,oBAAoB;IAgB1B;;;;;;;;;;;;;;;OAeG;IACH,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAI5B;;;;;;;;;;;;OAYG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAY1C;;;;;;;;;OASG;IACH,IAAI,MAAM,IAAI,QAAQ,CAAC,oBAAoB,CAAC,CAE3C;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,GAAG,QAAQ,EAAE,gBAAgB,EAAE;IAO5C;;;OAGG;IACH,IAAI,CAAC,QAAQ,GAAG,WAAW,EAAE,QAAQ,GAAG,KAAK,EAC3C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EAC3F,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAClF,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAGhC;AAkED,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CAAE,GAAG,EAAE,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CACzC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAAG;IACnC,KAAK,EAAE,CAAC,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACjD;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,CACF,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC"}