@ai-sdk-tool/harness 0.1.0

package/dist/agent.d.ts

@@ -0,0 +1,3 @@
+import type { Agent, AgentConfig } from "./types";
+export declare function createAgent(config: AgentConfig): Agent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EAGZ,MAAM,SAAS,CAAC;AAEjB,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CA6BtD"}

package/dist/agent.js

@@ -0,0 +1,29 @@
+import { stepCountIs, streamText } from "ai";
+export function createAgent(config) {
+    return {
+        config,
+        stream(opts) {
+            const system = opts.system ??
+                (typeof config.instructions === "string"
+                    ? config.instructions
+                    : undefined);
+            const result = streamText({
+                model: config.model,
+                tools: config.tools,
+                system,
+                messages: opts.messages,
+                providerOptions: opts.providerOptions,
+                maxOutputTokens: opts.maxOutputTokens,
+                stopWhen: stepCountIs(config.maxStepsPerTurn ?? 1),
+                abortSignal: opts.abortSignal,
+                experimental_repairToolCall: config.experimental_repairToolCall,
+            });
+            return {
+                finishReason: result.finishReason,
+                fullStream: result.fullStream,
+                response: result.response,
+            };
+        },
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAQ7C,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,OAAO;QACL,MAAM;QACN,MAAM,CAAC,IAAwB;YAC7B,MAAM,MAAM,GACV,IAAI,CAAC,MAAM;gBACX,CAAC,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;oBACtC,CAAC,CAAC,MAAM,CAAC,YAAY;oBACrB,CAAC,CAAC,SAAS,CAAC,CAAC;YAEjB,MAAM,MAAM,GAAG,UAAU,CAAC;gBACxB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;gBAClD,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,2BAA2B,EAAE,MAAM,CAAC,2BAA2B;aAChE,CAAC,CAAC;YAEH,OAAO;gBACL,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createAgent } from "./agent";
+export { runAgentLoop } from "./loop";
+export type { Message, MessageHistoryOptions } from "./message-history";
+export { MessageHistory } from "./message-history";
+export { MANUAL_TOOL_LOOP_MAX_STEPS, normalizeFinishReason, shouldContinueManualToolLoop, } from "./tool-loop-control";
+export type * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,mBAAmB,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createAgent } from "./agent";
+export { runAgentLoop } from "./loop";
+export { MessageHistory } from "./message-history";
+export { MANUAL_TOOL_LOOP_MAX_STEPS, normalizeFinishReason, shouldContinueManualToolLoop, } from "./tool-loop-control";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC"}

package/dist/loop.d.ts

@@ -0,0 +1,3 @@
+import type { RunAgentLoopOptions, RunAgentLoopResult } from "./types";
+export declare function runAgentLoop(options: RunAgentLoopOptions): Promise<RunAgentLoopResult>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA8D7B"}

package/dist/loop.js

@@ -0,0 +1,53 @@
+import { MANUAL_TOOL_LOOP_MAX_STEPS, shouldContinueManualToolLoop, } from "./tool-loop-control";
+export async function runAgentLoop(options) {
+    const { agent, abortSignal, onError, onStepComplete, onToolCall } = options;
+    const shouldContinue = options.shouldContinue ?? shouldContinueManualToolLoop;
+    const maxIterations = options.maxIterations ?? MANUAL_TOOL_LOOP_MAX_STEPS;
+    const messages = [...options.messages];
+    let iteration = 0;
+    let lastFinishReason = "stop";
+    while (iteration < maxIterations) {
+        if (abortSignal?.aborted) {
+            break;
+        }
+        const context = { iteration, messages };
+        try {
+            const instructions = agent.config.instructions;
+            const system = typeof instructions === "function"
+                ? await instructions()
+                : instructions;
+            const stream = agent.stream({ messages, abortSignal, system });
+            for await (const part of stream.fullStream) {
+                if (part.type === "tool-call") {
+                    await onToolCall?.(part, context);
+                }
+            }
+            const [response, finishReason] = await Promise.all([
+                stream.response,
+                stream.finishReason,
+            ]);
+            messages.push(...response.messages);
+            lastFinishReason = finishReason;
+            await onStepComplete?.({
+                finishReason: lastFinishReason,
+                iteration,
+                messages,
+                response,
+            });
+            iteration += 1;
+            if (!shouldContinue(lastFinishReason, context)) {
+                break;
+            }
+        }
+        catch (error) {
+            await onError?.(error, context);
+            throw error;
+        }
+    }
+    return {
+        messages,
+        iterations: iteration,
+        finishReason: lastFinishReason,
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA4B;IAE5B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC5E,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,4BAA4B,CAAC;IAC9E,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,0BAA0B,CAAC;IAC1E,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,gBAAgB,GAAsB,MAAM,CAAC;IAEjD,OAAO,SAAS,GAAG,aAAa,EAAE,CAAC;QACjC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAwB,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QAE7D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC;YAC/C,MAAM,MAAM,GACV,OAAO,YAAY,KAAK,UAAU;gBAChC,CAAC,CAAC,MAAM,YAAY,EAAE;gBACtB,CAAC,CAAC,YAAY,CAAC;YAEnB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YAE/D,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBAC9B,MAAM,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;YAED,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACjD,MAAM,CAAC,QAAQ;gBACf,MAAM,CAAC,YAAY;aACpB,CAAC,CAAC;YAEH,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACpC,gBAAgB,GAAG,YAAY,CAAC;YAEhC,MAAM,cAAc,EAAE,CAAC;gBACrB,YAAY,EAAE,gBAAgB;gBAC9B,SAAS;gBACT,QAAQ;gBACR,QAAQ;aACT,CAAC,CAAC;YAEH,SAAS,IAAI,CAAC,CAAC;YAEf,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC/C,MAAM;YACR,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,gBAAgB;KAC/B,CAAC;AACJ,CAAC"}

package/dist/message-history.d.ts

@@ -0,0 +1,29 @@
+import type { ModelMessage } from "ai";
+export interface Message {
+    createdAt: Date;
+    id: string;
+    modelMessage: ModelMessage;
+    originalContent?: string;
+}
+export interface MessageHistoryOptions {
+    /**
+     * Maximum number of messages to retain. When exceeded, older messages
+     * are trimmed from the front while preserving the initial user message
+     * for context continuity. Defaults to 1000.
+     */
+    maxMessages?: number;
+}
+export declare class MessageHistory {
+    private messages;
+    private readonly maxMessages;
+    constructor(options?: MessageHistoryOptions);
+    getAll(): Message[];
+    clear(): void;
+    addUserMessage(content: string, originalContent?: string): Message;
+    addModelMessages(messages: ModelMessage[]): Message[];
+    private enforceLimit;
+    private sanitizeMessage;
+    private serializeValue;
+    toModelMessages(): ModelMessage[];
+}
+//# sourceMappingURL=message-history.d.ts.map

package/dist/message-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-history.d.ts","sourceRoot":"","sources":["../src/message-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,IAAI,CAAC;AAiDjE,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAYD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,CAAC,EAAE,qBAAqB;IAU3C,MAAM,IAAI,OAAO,EAAE;IAInB,KAAK,IAAI,IAAI;IAIb,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO;IAelE,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE;IAmBrD,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,cAAc;IA6BtB,eAAe,IAAI,YAAY,EAAE;CAGlC"}

package/dist/message-history.js

@@ -0,0 +1,189 @@
+const TRAILING_NEWLINES = /\n+$/;
+function trimTrailingNewlines(message) {
+    if (message.role !== "assistant") {
+        return message;
+    }
+    const content = message.content;
+    if (typeof content === "string") {
+        const trimmed = content.replace(TRAILING_NEWLINES, "");
+        if (trimmed === content) {
+            return message;
+        }
+        return { ...message, content: trimmed };
+    }
+    if (!Array.isArray(content) || content.length === 0) {
+        return message;
+    }
+    let lastTextIndex = -1;
+    for (let i = content.length - 1; i >= 0; i--) {
+        const part = content[i];
+        if (part && typeof part === "object" && part.type === "text") {
+            lastTextIndex = i;
+            break;
+        }
+    }
+    if (lastTextIndex === -1) {
+        return message;
+    }
+    const textPart = content[lastTextIndex];
+    const trimmedText = textPart.text.replace(TRAILING_NEWLINES, "");
+    if (trimmedText === textPart.text) {
+        return message;
+    }
+    const newContent = [...content];
+    newContent[lastTextIndex] = { ...textPart, text: trimmedText };
+    return { ...message, content: newContent };
+}
+const createMessageId = (() => {
+    let counter = 0;
+    return () => {
+        counter += 1;
+        return `msg_${counter}`;
+    };
+})();
+const DEFAULT_MAX_MESSAGES = 1000;
+export class MessageHistory {
+    messages = [];
+    maxMessages;
+    constructor(options) {
+        const max = options?.maxMessages ?? DEFAULT_MAX_MESSAGES;
+        if (!Number.isFinite(max) || max < 1 || max !== Math.floor(max)) {
+            throw new RangeError(`maxMessages must be a positive integer >= 1, got ${max}`);
+        }
+        this.maxMessages = max;
+    }
+    getAll() {
+        return [...this.messages];
+    }
+    clear() {
+        this.messages = [];
+    }
+    addUserMessage(content, originalContent) {
+        const message = {
+            id: createMessageId(),
+            createdAt: new Date(),
+            modelMessage: {
+                role: "user",
+                content,
+            },
+            originalContent,
+        };
+        this.messages.push(message);
+        this.enforceLimit();
+        return message;
+    }
+    addModelMessages(messages) {
+        const created = [];
+        for (const modelMessage of messages) {
+            const processedMessage = trimTrailingNewlines(modelMessage);
+            const sanitizedMessage = this.sanitizeMessage(processedMessage);
+            const message = {
+                id: createMessageId(),
+                createdAt: new Date(),
+                modelMessage: sanitizedMessage,
+            };
+            created.push(message);
+        }
+        this.messages.push(...created);
+        this.enforceLimit();
+        return created;
+    }
+    enforceLimit() {
+        if (this.messages.length <= this.maxMessages) {
+            return;
+        }
+        if (this.maxMessages === 1) {
+            this.messages = [this.messages[this.messages.length - 1]];
+            return;
+        }
+        const turnBoundaries = [];
+        for (let i = 1; i < this.messages.length; i++) {
+            if (this.messages[i].modelMessage.role === "user") {
+                turnBoundaries.push(i);
+            }
+        }
+        if (turnBoundaries.length === 0) {
+            this.messages = [
+                this.messages[0],
+                ...this.messages.slice(-(this.maxMessages - 1)),
+            ];
+            return;
+        }
+        for (const boundary of turnBoundaries) {
+            const keptCount = 1 + (this.messages.length - boundary);
+            if (keptCount <= this.maxMessages) {
+                this.messages = [this.messages[0], ...this.messages.slice(boundary)];
+                return;
+            }
+        }
+        const lastBoundary = turnBoundaries[turnBoundaries.length - 1];
+        const lastBoundaryCandidate = [
+            this.messages[0],
+            ...this.messages.slice(lastBoundary),
+        ];
+        if (lastBoundaryCandidate.length <= this.maxMessages) {
+            this.messages = lastBoundaryCandidate;
+            return;
+        }
+        this.messages = [
+            this.messages[0],
+            ...this.messages.slice(-(this.maxMessages - 1)),
+        ];
+    }
+    sanitizeMessage(message) {
+        if (message.role !== "tool") {
+            return message;
+        }
+        if (!Array.isArray(message.content)) {
+            return message;
+        }
+        const sanitizedContent = message.content.map((part) => {
+            if (part.type !== "tool-result") {
+                return part;
+            }
+            const sanitizedOutput = this.serializeValue(part.output);
+            if (sanitizedOutput === part.output) {
+                return part;
+            }
+            // SAFETY: serializeValue preserves the ToolResultOutput discriminated union structure.
+            // It only transforms Error instances (which shouldn't appear in ToolResultOutput's
+            // JSON-serializable variants). The cast narrows unknown -> ToolResultOutput.
+            return {
+                ...part,
+                output: sanitizedOutput,
+            };
+        });
+        return {
+            ...message,
+            content: sanitizedContent,
+        };
+    }
+    serializeValue(value) {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        if (value instanceof Error) {
+            return {
+                __error: true,
+                name: value.name,
+                message: value.message,
+                stack: value.stack,
+            };
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.serializeValue(item));
+        }
+        if (typeof value === "object" && value.constructor === Object) {
+            const result = {};
+            for (const [key, val] of Object.entries(value)) {
+                result[key] = this.serializeValue(val);
+            }
+            return result;
+        }
+        return value;
+    }
+    toModelMessages() {
+        return this.messages.map((message) => message.modelMessage);
+    }
+}
+//# sourceMappingURL=message-history.js.map

package/dist/message-history.js.map

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

package/dist/tool-loop-control.d.ts

@@ -0,0 +1,4 @@
+export declare const MANUAL_TOOL_LOOP_MAX_STEPS = 200;
+export declare const normalizeFinishReason: (finishReason: string) => string;
+export declare const shouldContinueManualToolLoop: (finishReason: string) => boolean;
+//# sourceMappingURL=tool-loop-control.d.ts.map

package/dist/tool-loop-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loop-control.d.ts","sourceRoot":"","sources":["../src/tool-loop-control.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAS9C,eAAO,MAAM,qBAAqB,GAAI,cAAc,MAAM,KAAG,MAG5D,CAAC;AAEF,eAAO,MAAM,4BAA4B,GAAI,cAAc,MAAM,KAAG,OAEnE,CAAC"}

package/dist/tool-loop-control.js

@@ -0,0 +1,15 @@
+export const MANUAL_TOOL_LOOP_MAX_STEPS = 200;
+const CONTINUATION_FINISH_REASONS = new Set(["tool-calls"]);
+const FINISH_REASON_ALIASES = new Map([
+    ["tool_calls", "tool-calls"],
+    ["tool_use", "tool-calls"],
+    ["function_call", "tool-calls"],
+]);
+export const normalizeFinishReason = (finishReason) => {
+    const normalized = finishReason.trim().toLowerCase();
+    return FINISH_REASON_ALIASES.get(normalized) ?? normalized;
+};
+export const shouldContinueManualToolLoop = (finishReason) => {
+    return CONTINUATION_FINISH_REASONS.has(normalizeFinishReason(finishReason));
+};
+//# sourceMappingURL=tool-loop-control.js.map

package/dist/tool-loop-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loop-control.js","sourceRoot":"","sources":["../src/tool-loop-control.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AAC5D,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5B,CAAC,UAAU,EAAE,YAAY,CAAC;IAC1B,CAAC,eAAe,EAAE,YAAY,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAoB,EAAU,EAAE;IACpE,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,OAAO,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,YAAoB,EAAW,EAAE;IAC5E,OAAO,2BAA2B,CAAC,GAAG,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+import type { LanguageModel, ModelMessage, streamText, Tool, ToolCallPart, ToolSet } from "ai";
+type CoreStreamResult = ReturnType<typeof streamText>;
+type StreamTextOptions = Parameters<typeof streamText>[0];
+export type { LanguageModel, ModelMessage, Tool, ToolSet };
+export type AgentInstructions = string | (() => Promise<string>);
+export interface AgentConfig {
+    experimental_repairToolCall?: StreamTextOptions["experimental_repairToolCall"];
+    instructions?: AgentInstructions;
+    maxStepsPerTurn?: number;
+    model: LanguageModel;
+    tools?: ToolSet;
+}
+export interface Agent {
+    config: AgentConfig;
+    stream(opts: AgentStreamOptions): AgentStreamResult;
+}
+export interface AgentStreamOptions {
+    abortSignal?: AbortSignal;
+    maxOutputTokens?: StreamTextOptions["maxOutputTokens"];
+    messages: ModelMessage[];
+    providerOptions?: StreamTextOptions["providerOptions"];
+    system?: string;
+}
+export interface AgentStreamResult {
+    finishReason: CoreStreamResult["finishReason"];
+    fullStream: CoreStreamResult["fullStream"];
+    response: CoreStreamResult["response"];
+}
+export type AgentFinishReason = Awaited<AgentStreamResult["finishReason"]>;
+export interface LoopContinueContext {
+    iteration: number;
+    messages: ModelMessage[];
+}
+export interface LoopStepInfo {
+    finishReason: Awaited<AgentStreamResult["finishReason"]>;
+    iteration: number;
+    messages: ModelMessage[];
+    response: Awaited<AgentStreamResult["response"]>;
+}
+export interface LoopHooks {
+    onError?: (error: unknown, context: LoopContinueContext) => void | Promise<void>;
+    onStepComplete?: (step: LoopStepInfo) => void | Promise<void>;
+    onToolCall?: (call: ToolCallPart, context: LoopContinueContext) => void | Promise<void>;
+    shouldContinue?: (finishReason: AgentFinishReason, context: LoopContinueContext) => boolean;
+}
+export interface RunAgentLoopOptions extends LoopHooks {
+    abortSignal?: AbortSignal;
+    agent: Agent;
+    maxIterations?: number;
+    messages: ModelMessage[];
+}
+export interface RunAgentLoopResult {
+    finishReason: AgentFinishReason;
+    iterations: number;
+    messages: ModelMessage[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@ai-sdk-tool/harness",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "ai": "^6.0.101"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}