@hellohelen-ai/goliath 0.0.1

package/dist/run-turn.js

@@ -0,0 +1,260 @@
+import { plan } from "./conductor.js";
+import { judgeAnswer, judgeStep, judgeToolFailures } from "./judge.js";
+import { DEFAULT_INSTRUCTIONS } from "./prompts.js";
+import { remember } from "./scribe.js";
+import { runAnswerStep, runToolStep } from "./worker.js";
+/**
+ * One turn, start to finish: recall, then up to `maxSteps` stones, then an
+ * answer, then remember. Every escalation path goes through `escalate` so the
+ * cloud always receives the same shape.
+ */
+const runTurn = async (input) => {
+    const instructions = input.instructions ?? DEFAULT_INSTRUCTIONS;
+    const trace = [];
+    const steps = [];
+    const emit = (event) => {
+        trace.push(event);
+        input.onEvent?.(event);
+    };
+    const state = await input.memory.load();
+    emit({ type: "recall", summary: state.summary, recent: state.recent.length });
+    const escalate = async (reason, error) => {
+        emit({ type: "escalate", reason, ...(error ? { error } : {}) });
+        if (!input.fallback) {
+            // No cloud to hand to. smolagents still answers from memory on max
+            // steps rather than returning nothing; so does Goliath, unless the
+            // model itself is what failed.
+            if (reason === "model-error")
+                return { text: "", handledBy: "device", steps, trace };
+            const text = await bestEffortAnswer(input, instructions, state.summary, steps);
+            if (text)
+                emit({ type: "answer", text });
+            return { text, handledBy: "device", bestEffort: true, steps, trace };
+        }
+        const { text } = await input.fallback({
+            ask: input.ask,
+            summary: state.summary,
+            recent: state.recent,
+            steps,
+            reason,
+            ...(error ? { error } : {}),
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+        await commit(input, state, { ask: input.ask, answer: text, at: Date.now() }, emit);
+        return { text, handledBy: "cloud", steps, trace };
+    };
+    const hasTools = Object.keys(input.tools).length > 0;
+    try {
+        return await stones();
+    }
+    catch (error) {
+        // Guardrail violations, refusals, a dead session after context overflow,
+        // an unavailable model: none of these are the app's fault, and none are
+        // worth retrying with the same input. The cloud gets the same step log.
+        if (isAbort(error))
+            throw error;
+        if (isGuardrail(error)) {
+            // Apple's guardrail objects to text in the prompt or the reply. On a
+            // step that carries tool output that is usually a false positive on a
+            // calendar title, not an attack; either way, escalating would ship the
+            // very text it flagged. Stop here and let the app tell the user.
+            emit({ type: "escalate", reason: "guardrail", error: describeError(error) });
+            return { text: "", handledBy: "device", steps, trace };
+        }
+        return escalate("model-error", describeError(error));
+    }
+    async function stones() {
+        let planRetried = false;
+        let retryHint;
+        for (;;) {
+            const stall = judgeStep({ steps, maxSteps: input.maxSteps });
+            if (stall)
+                return escalate(stall);
+            const outcome = hasTools
+                ? await plan({
+                    model: input.model,
+                    instructions,
+                    tools: input.tools,
+                    ask: input.ask,
+                    summary: state.summary,
+                    steps,
+                    maxSteps: input.maxSteps,
+                    window: input.window,
+                    emit,
+                    ...(input.facts ? { facts: input.facts } : {}),
+                    ...(input.examples ? { examples: input.examples } : {}),
+                    ...(retryHint ? { retryHint } : {}),
+                    ...(input.signal ? { signal: input.signal } : {}),
+                })
+                : { ok: true, plan: { kind: "answer", brief: "reply" } };
+            if (!outcome.ok) {
+                // Small models drop a brace now and then. One more try, told what was
+                // wrong (Claude Code feeds the validation error back), is cheap and
+                // usually enough; two failures in a row is a real signal.
+                if (planRetried)
+                    return escalate("plan-invalid");
+                planRetried = true;
+                retryHint = outcome.hint;
+                continue;
+            }
+            retryHint = undefined;
+            const next = outcome.plan;
+            emit({
+                type: "plan",
+                index: steps.length,
+                kind: next.kind === "escalate" ? "answer" : next.kind,
+                ...(next.tool ? { tool: next.tool } : {}),
+                ...(next.why ? { why: next.why } : {}),
+                brief: next.brief,
+            });
+            if (next.kind === "escalate")
+                return escalate("conductor-asked");
+            if (next.kind === "answer") {
+                const answerInput = {
+                    model: input.model,
+                    instructions,
+                    ask: input.ask,
+                    summary: state.summary,
+                    steps,
+                    ...(input.signal ? { signal: input.signal } : {}),
+                };
+                let text = await runAnswerStep(answerInput);
+                if (judgeAnswer(text)) {
+                    // eve, OpenClaw, and Hermes all reissue once with a nudge before giving up.
+                    text = await runAnswerStep({ ...answerInput, nudge: EMPTY_ANSWER_NUDGE });
+                }
+                const empty = judgeAnswer(text);
+                if (empty)
+                    return escalate(empty);
+                steps.push({ index: steps.length, kind: "answer", brief: next.brief, text });
+                emit({ type: "answer", text });
+                await commit(input, state, { ask: input.ask, answer: text, at: Date.now() }, emit);
+                return { text, handledBy: "device", steps, trace };
+            }
+            const tool = input.tools[next.tool ?? ""];
+            if (!tool)
+                return escalate("plan-invalid");
+            const started = Date.now();
+            // Claude Code answers an identical re-read with a stub instead of the
+            // file. A first repeat of a read-only tool gets the earlier result back
+            // with no model call and no execution; a second repeat is a real loop.
+            const cached = !tool.writes ? findRepeatOfReadOnly(steps, tool.name) : undefined;
+            if (cached) {
+                const record = {
+                    index: steps.length,
+                    kind: "tool",
+                    brief: next.brief,
+                    tool: tool.name,
+                    input: cached.input,
+                    result: `same as step ${cached.index + 1}`,
+                    cached: true,
+                };
+                steps.push(record);
+                emit({
+                    type: "tool",
+                    tool: tool.name,
+                    input: cached.input,
+                    result: record.result ?? "",
+                    ms: 0,
+                });
+                continue;
+            }
+            const done = await runToolStep({
+                model: input.model,
+                instructions,
+                tool,
+                brief: next.brief,
+                ask: input.ask,
+                confirm: async (request) => {
+                    const decision = await input.confirm(request);
+                    const approved = typeof decision === "boolean" ? decision : decision.approved;
+                    const reason = typeof decision === "object" ? decision.reason : undefined;
+                    emit({ type: "confirm", tool: request.tool, approved, ...(reason ? { reason } : {}) });
+                    return decision;
+                },
+                ...(input.signal ? { signal: input.signal } : {}),
+            });
+            if (!done.ok)
+                return escalate(done.reason);
+            const repeat = judgeStep({
+                steps,
+                maxSteps: input.maxSteps,
+                next: { tool: tool.name, input: done.input },
+            });
+            if (repeat === "repeated-tool-call")
+                return escalate(repeat);
+            steps.push({
+                index: steps.length,
+                kind: "tool",
+                brief: next.brief,
+                tool: tool.name,
+                input: done.input,
+                result: done.result,
+                skipped: done.skipped,
+                ...(done.failed ? { failed: true } : {}),
+            });
+            emit({
+                type: "tool",
+                tool: tool.name,
+                input: done.input,
+                result: done.result,
+                ms: Date.now() - started,
+            });
+            const failing = judgeToolFailures(steps);
+            if (failing)
+                return escalate(failing, steps.at(-1)?.result);
+        }
+    }
+};
+/**
+ * The most recent step with this read-only tool, when no step has already
+ * been served from cache for it. Argument equality is checked by the judge
+ * after the worker runs; here the tool name alone is the signal, because a
+ * no-argument tool never reaches the worker.
+ */
+const findRepeatOfReadOnly = (steps, toolName) => {
+    const same = steps.filter((s) => s.kind === "tool" && s.tool === toolName);
+    const last = same.at(-1);
+    if (!last || last.cached)
+        return undefined;
+    if (last.input !== undefined && Object.keys(last.input).length > 0)
+        return undefined;
+    return last;
+};
+/** One answer call from the step log; an empty or failing call yields "". */
+const bestEffortAnswer = async (input, instructions, summary, steps) => {
+    try {
+        return await runAnswerStep({
+            model: input.model,
+            instructions,
+            ask: input.ask,
+            summary,
+            steps,
+            bestEffort: true,
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+    }
+    catch (error) {
+        if (isAbort(error))
+            throw error;
+        return "";
+    }
+};
+const EMPTY_ANSWER_NUDGE = "Your previous reply was empty. Answer now from what you found above; do not mention this notice.";
+const isAbort = (error) => error?.name === "AbortError";
+/** Apple's GenerationError.guardrailViolation, however the provider spells it. */
+const isGuardrail = (error) => /guardrail|content.?filter|safety/i.test(describeError(error));
+const describeError = (error) => error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+const commit = async (input, state, exchange, emit) => {
+    const next = await remember({
+        model: input.model,
+        state,
+        exchange,
+        summaryBudget: Math.floor(input.window / 8),
+        ...(input.signal ? { signal: input.signal } : {}),
+    });
+    await input.memory.save(next);
+    emit({ type: "remember", summary: next.summary });
+};
+export { runTurn };
+//# sourceMappingURL=run-turn.js.map

package/dist/run-turn.js.map

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

package/dist/scribe.d.ts

@@ -0,0 +1,17 @@
+import { type LanguageModel } from "ai";
+import type { Exchange, MemoryState } from "./types.js";
+declare const RECENT_KEEP = 3;
+/**
+ * Remember the turn. The last few exchanges stay verbatim; when one falls off
+ * the end it is folded into the brief with one model call. So most turns cost
+ * nothing, and the brief never grows past its budget.
+ */
+declare const remember: (input: {
+    model: LanguageModel;
+    state: MemoryState;
+    exchange: Exchange;
+    summaryBudget: number;
+    signal?: AbortSignal;
+}) => Promise<MemoryState>;
+export { RECENT_KEEP, remember };
+//# sourceMappingURL=scribe.d.ts.map

package/dist/scribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scribe.d.ts","sourceRoot":"","sources":["../src/scribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAGtD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,QAAA,MAAM,WAAW,IAAI,CAAC;AAEtB;;;;GAIG;AACH,QAAA,MAAM,QAAQ,GAAU,OAAO;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAG,OAAO,CAAC,WAAW,CAoBtB,CAAC;AAsBF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC"}

package/dist/scribe.js

@@ -0,0 +1,44 @@
+import { generateText } from "ai";
+import { estimateTokens } from "./budget.js";
+import { scribeSystem, scribeUser } from "./prompts.js";
+const RECENT_KEEP = 3;
+/**
+ * Remember the turn. The last few exchanges stay verbatim; when one falls off
+ * the end it is folded into the brief with one model call. So most turns cost
+ * nothing, and the brief never grows past its budget.
+ */
+const remember = async (input) => {
+    const recent = [...input.state.recent, input.exchange];
+    let summary = input.state.summary;
+    while (recent.length > RECENT_KEEP) {
+        const evicted = recent.shift();
+        if (!evicted)
+            break;
+        summary = await fold({
+            model: input.model,
+            summary,
+            exchange: evicted,
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+    }
+    if (estimateTokens(summary) > input.summaryBudget) {
+        summary = summary.slice(0, input.summaryBudget * 4);
+    }
+    return { summary, recent };
+};
+const fold = async (input) => {
+    const result = await generateText({
+        model: input.model,
+        system: scribeSystem,
+        prompt: scribeUser({
+            summary: input.summary,
+            ask: input.exchange.ask,
+            answer: input.exchange.answer,
+        }),
+        ...(input.signal ? { abortSignal: input.signal } : {}),
+    });
+    const text = result.text.trim();
+    return text || input.summary;
+};
+export { RECENT_KEEP, remember };
+//# sourceMappingURL=scribe.js.map

package/dist/scribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scribe.js","sourceRoot":"","sources":["../src/scribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,IAAI,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGxD,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB;;;;GAIG;AACH,MAAM,QAAQ,GAAG,KAAK,EAAE,KAMvB,EAAwB,EAAE;IACzB,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;IAElC,OAAO,MAAM,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO;YAAE,MAAM;QACpB,OAAO,GAAG,MAAM,IAAI,CAAC;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO;YACP,QAAQ,EAAE,OAAO;YACjB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QAClD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,KAAK,EAAE,KAKnB,EAAmB,EAAE;IACpB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,UAAU,CAAC;YACjB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG;YACvB,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;SAC9B,CAAC;QACF,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC;AAC/B,CAAC,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC"}

package/dist/testing/fake-model.d.ts

@@ -0,0 +1,27 @@
+import { MockLanguageModelV4 } from "ai/test";
+import type { LanguageModelV4CallOptions } from "@ai-sdk/provider";
+/** One scripted reply. `json` is for structured output, `toolCall` for a worker step. */
+type ScriptedReply = {
+    text: string;
+} | {
+    json: unknown;
+} | {
+    toolCall: {
+        name: string;
+        input: unknown;
+    };
+};
+type FakeModel = MockLanguageModelV4 & {
+    /** Every prompt the harness sent, in order, for assertions. */
+    calls: LanguageModelV4CallOptions[];
+    /** Replies not yet consumed. Empty at the end of a well-scripted test. */
+    remaining: () => number;
+};
+/**
+ * A language model that reads from a script. Each `doGenerate` consumes the
+ * next reply; running out throws, so a test cannot silently pass on air.
+ */
+declare const fakeModel: (script: ScriptedReply[]) => FakeModel;
+export { fakeModel };
+export type { FakeModel, ScriptedReply };
+//# sourceMappingURL=fake-model.d.ts.map

package/dist/testing/fake-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-model.d.ts","sourceRoot":"","sources":["../../src/testing/fake-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,0BAA0B,EAAiC,MAAM,kBAAkB,CAAC;AAElG,yFAAyF;AACzF,KAAK,aAAa,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAAC;AAExF,KAAK,SAAS,GAAG,mBAAmB,GAAG;IACrC,+DAA+D;IAC/D,KAAK,EAAE,0BAA0B,EAAE,CAAC;IACpC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,MAAM,CAAC;CACzB,CAAC;AAwCF;;;GAGG;AACH,QAAA,MAAM,SAAS,GAAI,QAAQ,aAAa,EAAE,KAAG,SAkB5C,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC"}

package/dist/testing/fake-model.js

@@ -0,0 +1,57 @@
+import { MockLanguageModelV4 } from "ai/test";
+const usage = (input, output) => ({
+    inputTokens: { total: input, noCache: input, cacheRead: 0, cacheWrite: 0 },
+    outputTokens: { total: output, text: output, reasoning: 0 },
+});
+const promptChars = (options) => JSON.stringify(options.prompt).length;
+const toResult = (reply, options) => {
+    const inputTokens = Math.ceil(promptChars(options) / 4);
+    if ("toolCall" in reply) {
+        const input = JSON.stringify(reply.toolCall.input ?? {});
+        return {
+            content: [
+                {
+                    type: "tool-call",
+                    toolCallId: `call_${Math.random().toString(36).slice(2, 8)}`,
+                    toolName: reply.toolCall.name,
+                    input,
+                },
+            ],
+            finishReason: { unified: "tool-calls", raw: "tool-calls" },
+            usage: usage(inputTokens, Math.ceil(input.length / 4)),
+            warnings: [],
+        };
+    }
+    const text = "json" in reply ? JSON.stringify(reply.json) : reply.text;
+    return {
+        content: [{ type: "text", text }],
+        finishReason: { unified: "stop", raw: "stop" },
+        usage: usage(inputTokens, Math.ceil(text.length / 4)),
+        warnings: [],
+    };
+};
+/**
+ * A language model that reads from a script. Each `doGenerate` consumes the
+ * next reply; running out throws, so a test cannot silently pass on air.
+ */
+const fakeModel = (script) => {
+    const queue = [...script];
+    const calls = [];
+    const model = new MockLanguageModelV4({
+        provider: "goliath.fake",
+        modelId: "scripted",
+        doGenerate: async (options) => {
+            calls.push(options);
+            const reply = queue.shift();
+            if (!reply) {
+                throw new Error(`fakeModel: script exhausted after ${calls.length} call(s)`);
+            }
+            return toResult(reply, options);
+        },
+    });
+    model.calls = calls;
+    model.remaining = () => queue.length;
+    return model;
+};
+export { fakeModel };
+//# sourceMappingURL=fake-model.js.map

package/dist/testing/fake-model.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,3 @@
+export { fakeModel } from "./fake-model.js";
+export type { FakeModel, ScriptedReply } from "./fake-model.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,2 @@
+export { fakeModel } from "./fake-model.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/define-tool.d.ts

@@ -0,0 +1,21 @@
+import type { z } from "zod";
+import type { GoliathTool, ToolContext } from "../types.js";
+type DefineToolArgs<INPUT, OUTPUT> = {
+    name: string;
+    description: string;
+    parameters: z.ZodType<INPUT>;
+    writes?: boolean;
+    execute: (input: INPUT, context: ToolContext) => Promise<OUTPUT> | OUTPUT;
+    toModelOutput?: (output: OUTPUT) => string;
+    requires?: string[];
+};
+/**
+ * Declare a tool. A thin identity function that pins the types.
+ *
+ * Keep `parameters` flat: primitives and enums, no nested objects, no unions.
+ * That is what a 3B model fills in reliably and what Apple's guided
+ * generation accepts (docs/research/rn-providers-and-ai-sdk.md § 1.5).
+ */
+declare const defineTool: <INPUT, OUTPUT>(args: DefineToolArgs<INPUT, OUTPUT>) => GoliathTool<INPUT, OUTPUT>;
+export { defineTool };
+//# sourceMappingURL=define-tool.d.ts.map

package/dist/tools/define-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.d.ts","sourceRoot":"","sources":["../../src/tools/define-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,IAAI;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC1E,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,UAAU,GAAI,KAAK,EAAE,MAAM,EAC/B,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,KAClC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAS,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/tools/define-tool.js

@@ -0,0 +1,10 @@
+/**
+ * Declare a tool. A thin identity function that pins the types.
+ *
+ * Keep `parameters` flat: primitives and enums, no nested objects, no unions.
+ * That is what a 3B model fills in reliably and what Apple's guided
+ * generation accepts (docs/research/rn-providers-and-ai-sdk.md § 1.5).
+ */
+const defineTool = (args) => args;
+export { defineTool };
+//# sourceMappingURL=define-tool.js.map

package/dist/tools/define-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.js","sourceRoot":"","sources":["../../src/tools/define-tool.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CACjB,IAAmC,EACP,EAAE,CAAC,IAAI,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,CAAC"}