@developerz.ai/aitm 0.0.0

package/dist/subagents/reviewer.js

@@ -0,0 +1,159 @@
+// docs/subagents.md (Reviewer row), docs/commands/merge-pr.md
+// Input: unresolved review threads. Output: per-thread resolution (reply / push fix / mark stale).
+// Pushes go through Worker tools (FS write, bash); thread ops via a `github` tool that wraps a
+// subset of GitHubClient (replyToThread / resolveThread).
+//
+// Strategy:
+//   - One agent.generate call per thread, scoped to that thread's conversation.
+//   - Agent emits a structured ThreadResolutionOutput JSON describing the chosen outcome.
+//   - For "fixed", the runner — not the agent — performs the git commit so commit shas are
+//     deterministic and observable (worker pattern).
+//
+// SDK references:
+//   chunk-04.md §"ToolLoopAgent"
+//   chunk-05.md §"Generating Structured Data"
+//   chunk-09.md §"Subagents"
+import { createSubagent } from '@developerz.ai/ai-claude-compat';
+import { Output } from 'ai';
+import { z } from 'zod';
+// Per-thread structured output emitted by the model. A FLAT object (not a discriminatedUnion):
+// a discriminated union compiles to JSON-Schema `oneOf`, which several OpenRouter-routed
+// providers reject for structured output (`output_config.format.schema: Schema type 'oneOf' is
+// not supported` — seen on Anthropic, which is also aitm's default tier). `kind` selects the
+// outcome; `commitMessage` is expected for "fixed" and `reason` for "wontfix".
+export const ThreadResolutionOutputSchema = z.object({
+    kind: z.enum(['fixed', 'replied', 'wontfix']),
+    commitMessage: z.string().optional(),
+    reason: z.string().optional(),
+});
+export const REVIEWER_SYSTEM_PREFIX = [
+    '',
+    'You are the Reviewer subagent. You receive ONE unresolved PR review thread at a time and',
+    'decide between three outcomes, emitting a ThreadResolutionOutput JSON that names the choice.',
+    '',
+    '- "fixed": the reviewer is right and a code change is needed. Use your tools (grep/glob/',
+    '  readFile to locate, editFile/multiEdit to change, writeFile to rewrite, bash for the rest)',
+    '  to make the fix inside the worktree. DO NOT run `git commit` yourself — the runner commits',
+    '  every staged change after you finish. Reply on the thread via the github tool explaining',
+    '  the fix and resolve the thread, then emit { kind: "fixed", commitMessage } where',
+    '  commitMessage is the subject line the runner will pass to `git commit`.',
+    '- "replied": the comment is a question or clarification request and no code change is needed.',
+    '  Answer it via github.replyToThread. Do not edit code. Emit { kind: "replied" }.',
+    '- "wontfix": the suggestion is stale, out of scope, or you disagree. Reply with the reason',
+    '  via github.replyToThread, resolve the thread via github.resolveThread, and emit',
+    '  { kind: "wontfix", reason }.',
+    '',
+    'Rules:',
+    '- Stay inside the worktree. No work outside the repo.',
+    '- Resolve the thread for "fixed" and "wontfix" outcomes; "replied" leaves it open.',
+    '- Return JSON that matches the ThreadResolutionOutput schema exactly.',
+].join('\n');
+// Module-private link from agent to its init so runReviewer can drive bash commits with the
+// same tools without exposing them on the public agent surface (worker uses the same pattern).
+const reviewerInitRegistry = new WeakMap();
+export function createReviewerAgent(init) {
+    const agent = createSubagent({
+        model: init.model,
+        tools: init.tools,
+        systemPrompt: init.systemPrompt,
+        output: Output.object({
+            schema: ThreadResolutionOutputSchema,
+            name: 'ThreadResolution',
+        }),
+        ...(init.maxSteps !== undefined ? { maxSteps: init.maxSteps } : {}),
+    }, 20);
+    reviewerInitRegistry.set(agent, init);
+    return agent;
+}
+export async function runReviewer(agent, input) {
+    const init = reviewerInitRegistry.get(agent);
+    if (!init) {
+        return {
+            kind: 'error',
+            error: 'runReviewer called with an agent not built by createReviewerAgent',
+        };
+    }
+    if (input.threads.length === 0) {
+        return { kind: 'ok', resolutions: [] };
+    }
+    try {
+        const resolutions = [];
+        for (const thread of input.threads) {
+            resolutions.push(await resolveOneThread(agent, init, input, thread));
+        }
+        return { kind: 'ok', resolutions };
+    }
+    catch (err) {
+        return { kind: 'error', error: err instanceof Error ? err.message : String(err) };
+    }
+}
+async function resolveOneThread(agent, init, input, thread) {
+    const result = await agent.generate({ prompt: buildThreadPrompt(input, thread) });
+    const out = result.experimental_output;
+    switch (out.kind) {
+        case 'fixed': {
+            // commitMessage is optional on the flat schema; fall back to a generic subject.
+            const message = out.commitMessage?.trim() || `fix: address review thread ${thread.id}`;
+            const commitSha = await commitFix(init.tools.bash, input.worktreePath, message);
+            return { threadId: thread.id, kind: 'fixed', commitSha };
+        }
+        case 'replied':
+            return { threadId: thread.id, kind: 'replied' };
+        default:
+            return {
+                threadId: thread.id,
+                kind: 'wontfix',
+                reason: out.reason?.trim() || 'no reason provided',
+            };
+    }
+}
+function buildThreadPrompt(input, thread) {
+    const lines = [`PR: #${input.pr}`, `Worktree: ${input.worktreePath}`, `Thread id: ${thread.id}`];
+    if (thread.path)
+        lines.push(`File: ${thread.path}`);
+    lines.push('', 'Conversation:');
+    for (const c of thread.comments) {
+        lines.push(`  @${c.author}: ${c.body}`);
+    }
+    lines.push('', 'Decide the outcome, take the action, then emit the ThreadResolutionOutput JSON.');
+    return lines.join('\n');
+}
+async function commitFix(bash, worktreePath, message) {
+    const exec = bash.execute;
+    if (typeof exec !== 'function') {
+        throw new Error('bash tool is missing an execute function');
+    }
+    const wt = shQuote(worktreePath);
+    await runBash(exec, `git -C ${wt} add -A`);
+    await runBash(exec, `git -C ${wt} commit -m ${shQuote(message)}`);
+    const sha = await captureBash(exec, `git -C ${wt} rev-parse HEAD`);
+    return sha.trim();
+}
+async function runBash(exec, command) {
+    const out = await execBash(exec, command);
+    if (out.exitCode !== 0) {
+        throw new Error(`bash failed (${out.exitCode}): ${command}\n${out.stderr}`);
+    }
+}
+async function captureBash(exec, command) {
+    const out = await execBash(exec, command);
+    if (out.exitCode !== 0) {
+        throw new Error(`bash failed (${out.exitCode}): ${command}\n${out.stderr}`);
+    }
+    return out.stdout;
+}
+async function execBash(exec, command) {
+    const out = await exec({ command }, { toolCallId: `reviewer-bash-${Date.now()}`, messages: [] });
+    if (isAsyncIterable(out)) {
+        throw new Error('bash tool returned an async iterable; expected a single result');
+    }
+    return out;
+}
+function isAsyncIterable(v) {
+    return v !== null && typeof v === 'object' && Symbol.asyncIterator in v;
+}
+// POSIX shell-quote: wrap in single quotes, escape embedded single quotes.
+function shQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=reviewer.js.map

package/dist/subagents/reviewer.js.map

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

package/dist/subagents/worker.d.ts

@@ -0,0 +1,71 @@
+import type { BashInput, BashOutput, EditFileInput, EditFileOutput, GlobInput, GlobOutput, GrepInput, GrepOutput, MultiEditInput, MultiEditOutput, ReadFileInput, ReadFileOutput, WriteFileInput, WriteFileOutput } from '@developerz.ai/ai-claude-compat';
+import { type DeepPartial, Output, type Tool, type ToolLoopAgent } from 'ai';
+import { z } from 'zod';
+import type { PrGroup } from '../state/schema.ts';
+import type { SubagentInit } from './factory.ts';
+export type WorkerTools = {
+    readFile: Tool<ReadFileInput, ReadFileOutput>;
+    writeFile: Tool<WriteFileInput, WriteFileOutput>;
+    editFile: Tool<EditFileInput, EditFileOutput>;
+    multiEdit: Tool<MultiEditInput, MultiEditOutput>;
+    grep: Tool<GrepInput, GrepOutput>;
+    glob: Tool<GlobInput, GlobOutput>;
+    bash: Tool<BashInput, BashOutput>;
+};
+export declare const FileManifestEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        create: "create";
+        modify: "modify";
+        delete: "delete";
+    }>;
+    purpose: z.ZodString;
+}, z.core.$strip>;
+export type FileManifestEntry = z.infer<typeof FileManifestEntrySchema>;
+export declare const FileManifestSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            create: "create";
+            modify: "modify";
+            delete: "delete";
+        }>;
+        purpose: z.ZodString;
+    }, z.core.$strip>>;
+    draftCommitMessage: z.ZodString;
+}, z.core.$strip>;
+export type FileManifest = z.infer<typeof FileManifestSchema>;
+type WorkerOutput = Output.Output<FileManifest, DeepPartial<FileManifest>, never>;
+export type WorkerAgent = ToolLoopAgent<never, WorkerTools, WorkerOutput>;
+export type WorkerInput = {
+    group: PrGroup;
+    worktreePath: string;
+    baseBranch: string;
+    styleContents: string;
+    rollingContext: string;
+};
+export type FileChange = {
+    path: string;
+    kind: 'create' | 'modify' | 'delete';
+    summary: string;
+};
+export type WorkerDelivery = {
+    branch: string;
+    draftCommitMessage: string;
+    changes: FileChange[];
+    progressEntries: string[];
+};
+export type WorkerResult = {
+    kind: 'ok';
+    delivery: WorkerDelivery;
+} | {
+    kind: 'blocked';
+    reason: string;
+} | {
+    kind: 'error';
+    error: string;
+};
+export declare const WORKER_SYSTEM_PREFIX: string;
+export declare function createWorkerAgent(init: SubagentInit<WorkerTools>): WorkerAgent;
+export declare function runWorker(agent: WorkerAgent, input: WorkerInput): Promise<WorkerResult>;
+export {};

package/dist/subagents/worker.js

@@ -0,0 +1,180 @@
+// docs/subagents.md (Worker row), docs/task-groups.md, docs/commands/start.md
+// One PR group: produce file changes + commits on a dedicated branch. Does NOT open the PR
+// and does NOT finalize the commit message — those belong to the Orchestrator (more reliable
+// at composing global-context narration: PR title, body, squash commit message).
+//
+// Strategy for *really big PRs* (the explicit design goal) — two layers of parallelism:
+//
+//   Layer A (outer, across files): plan a file manifest via Output.object() that lists every
+//   file to create/modify/delete (docs/vendor/ai-sdk/chunk-09.md §"Orchestrator-Worker"),
+//   then Promise.all over per-file editor sub-subagents.
+//
+//   Layer B (inner, within one step): each editor enables `parallelToolCalls: true` (default
+//   in the SDK — chunk-02.md §"parallelToolCalls") so the model can issue multiple readFile /
+//   writeFile tool calls in a single step and the runtime executes them concurrently.
+//
+// SDK references:
+//   chunk-09.md §"Orchestrator-Worker" (manifest + per-file workers)
+//   chunk-09.md §"Subagents" §"Controlling What the Model Sees" (toModelOutput one-line summary)
+//   chunk-04.md §"ToolLoopAgent" (agent class)
+//   chunk-02.md §"Tool Calling" (parallelToolCalls)
+import { composeSystemPrompt, createSubagent } from '@developerz.ai/ai-claude-compat';
+import { generateText, Output, stepCountIs, } from 'ai';
+import { z } from 'zod';
+// File manifest — Phase 1 structured output. Each entry drives one editor in Phase 2.
+export const FileManifestEntrySchema = z.object({
+    path: z.string().min(1),
+    kind: z.enum(['create', 'modify', 'delete']),
+    purpose: z.string().min(1),
+});
+export const FileManifestSchema = z.object({
+    files: z.array(FileManifestEntrySchema),
+    draftCommitMessage: z.string().min(1),
+});
+export const WORKER_SYSTEM_PREFIX = [
+    '',
+    'You are the Worker subagent. You receive one PR group: a coherent batch of tasks that',
+    'land in a single pull request on a dedicated branch. Work in two phases.',
+    '',
+    'Phase 1 — manifest. Use your read-only tools (readFile with optional offset/limit, grep,',
+    'glob) to ground yourself in the existing code, then emit a FileManifest JSON listing every',
+    'file to create/modify/delete plus a one-line draft commit message. Do not edit yet.',
+    '',
+    'Phase 2 — edits. Each manifest entry is handed to a dedicated editor subagent in',
+    'parallel by the runtime; you do not execute Phase 2 yourself.',
+    '',
+    'Rules:',
+    '- Stay inside the worktree provided. No work outside the repo.',
+    '- One responsibility per file. If a file has multiple unrelated edits, split it.',
+    '- draftCommitMessage is a hint to the Orchestrator; keep the subject under 72 chars.',
+    '- Return the FileManifest JSON exactly matching the schema.',
+].join('\n');
+// Editor subagent prompt — applied to every per-file fanout. Kept here so the Worker
+// owns the contract its editors run under.
+const EDITOR_SYSTEM_PREFIX = [
+    '',
+    'You are a per-file editor subagent. You receive one file path and a purpose.',
+    '- To CREATE a file, emit its full contents via `writeFile`.',
+    '- To MODIFY an existing file, `readFile` it first, then prefer `editFile` (one exact string',
+    '  replacement) or `multiEdit` (several replacements applied atomically). Use `writeFile` only',
+    '  for a full rewrite.',
+    '- To DELETE a file, use `bash` with `rm -f <path>`.',
+    'You may issue multiple tool calls in parallel.',
+    '',
+    "IMPORTANT: your final assistant message is returned to the outer Worker as this file's",
+    'summary. Keep it to one line, present-tense, and specific.',
+].join('\n');
+// Module-private link from a Worker agent back to its init, so runWorker can spawn editor
+// sub-agents with the same model + tool handles without exposing them on the public surface.
+const workerInitRegistry = new WeakMap();
+export function createWorkerAgent(init) {
+    const agent = createSubagent({
+        model: init.model,
+        tools: init.tools,
+        systemPrompt: init.systemPrompt,
+        output: Output.object({ schema: FileManifestSchema, name: 'FileManifest' }),
+        ...(init.maxSteps !== undefined ? { maxSteps: init.maxSteps } : {}),
+    }, 30);
+    workerInitRegistry.set(agent, init);
+    return agent;
+}
+export async function runWorker(agent, input) {
+    const init = workerInitRegistry.get(agent);
+    if (!init) {
+        return {
+            kind: 'error',
+            error: 'runWorker called with an agent not built by createWorkerAgent',
+        };
+    }
+    const branch = input.group.branch ?? `aitm/${input.group.id}`;
+    try {
+        const manifest = await planManifest(agent, input);
+        if (manifest.files.length === 0) {
+            return { kind: 'blocked', reason: 'worker produced an empty file manifest' };
+        }
+        const changes = await Promise.all(manifest.files.map((file) => runEditor(init, file, input)));
+        await commitOnBranch(init.tools.bash, input, branch, manifest.draftCommitMessage);
+        return {
+            kind: 'ok',
+            delivery: {
+                branch,
+                draftCommitMessage: manifest.draftCommitMessage,
+                changes,
+                progressEntries: input.group.tasks.map((task) => `- ${task}`),
+            },
+        };
+    }
+    catch (err) {
+        return { kind: 'error', error: err instanceof Error ? err.message : String(err) };
+    }
+}
+async function planManifest(agent, input) {
+    const result = await agent.generate({ prompt: buildManifestPrompt(input) });
+    return result.experimental_output;
+}
+function buildManifestPrompt(input) {
+    const lines = [
+        `PR group: ${input.group.id} — ${input.group.title}`,
+        `Branch: ${input.group.branch ?? `aitm/${input.group.id}`}`,
+        `Base branch: ${input.baseBranch}`,
+        `Worktree: ${input.worktreePath}`,
+        '',
+        'Tasks in this PR group:',
+        ...input.group.tasks.map((task, i) => `  ${i + 1}. ${task}`),
+    ];
+    if (input.rollingContext.trim()) {
+        lines.push('', 'Rolling context from prior PRs:', input.rollingContext);
+    }
+    lines.push('', 'Survey the repo, then emit the FileManifest JSON.');
+    return lines.join('\n');
+}
+async function runEditor(init, file, input) {
+    const { text } = await generateText({
+        model: init.model,
+        tools: init.tools,
+        system: composeSystemPrompt(input.styleContents, EDITOR_SYSTEM_PREFIX, input.worktreePath),
+        prompt: buildEditorPrompt(file, input),
+        stopWhen: stepCountIs(12),
+        providerOptions: { openai: { parallelToolCalls: true } },
+    });
+    const firstLine = text.trim().split('\n')[0];
+    const summary = firstLine && firstLine.length > 0 ? firstLine : `${file.kind} ${file.path}`;
+    return { path: file.path, kind: file.kind, summary };
+}
+function buildEditorPrompt(file, input) {
+    return [
+        `Worktree: ${input.worktreePath}`,
+        `File: ${file.path}`,
+        `Change kind: ${file.kind}`,
+        `Purpose: ${file.purpose}`,
+        '',
+        'Make the change. Reply with a one-line summary.',
+    ].join('\n');
+}
+async function commitOnBranch(bash, input, branch, message) {
+    const exec = bash.execute;
+    if (typeof exec !== 'function') {
+        throw new Error('bash tool is missing an execute function');
+    }
+    const wt = shQuote(input.worktreePath);
+    await runBash(exec, `git -C ${wt} checkout -B ${shQuote(branch)}`);
+    await runBash(exec, `git -C ${wt} add -A`);
+    await runBash(exec, `git -C ${wt} commit -m ${shQuote(message)}`);
+}
+async function runBash(exec, command) {
+    const out = await exec({ command }, { toolCallId: `worker-bash-${Date.now()}`, messages: [] });
+    if (isAsyncIterable(out)) {
+        throw new Error('bash tool returned an async iterable; expected a single result');
+    }
+    if (out.exitCode !== 0) {
+        throw new Error(`bash failed (${out.exitCode}): ${command}\n${out.stderr}`);
+    }
+}
+function isAsyncIterable(v) {
+    return v !== null && typeof v === 'object' && Symbol.asyncIterator in v;
+}
+// POSIX shell-quote: wrap in single quotes, escape embedded single quotes.
+function shQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=worker.js.map

package/dist/subagents/worker.js.map

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

package/dist/testing/temp-repo.d.ts

@@ -0,0 +1,7 @@
+export type TempRepo = {
+    path: string;
+    cleanup: () => Promise<void>;
+};
+export declare function makeTempRepo(opts?: {
+    withClaudeMd?: boolean;
+}): Promise<TempRepo>;

package/dist/testing/temp-repo.js

@@ -0,0 +1,21 @@
+// Shared test helper: spin up a throwaway git repo in a tempdir.
+// Used by *.test.ts (unit) for filesystem-touching cases AND by test/integration/*.test.ts.
+// docs/runtime.md §Testing — integration tests run against real temp git repos.
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { execa } from 'execa';
+export async function makeTempRepo(opts) {
+    const path = await mkdtemp(join(tmpdir(), 'aitm-test-'));
+    await execa('git', ['init'], { cwd: path });
+    await execa('git', ['config', 'user.email', 'test@aitm.local'], { cwd: path });
+    await execa('git', ['config', 'user.name', 'aitm-test'], { cwd: path });
+    if (opts?.withClaudeMd) {
+        await writeFile(join(path, 'CLAUDE.md'), '# CLAUDE.md\n');
+    }
+    const cleanup = async () => {
+        await rm(path, { recursive: true, force: true });
+    };
+    return { path, cleanup };
+}
+//# sourceMappingURL=temp-repo.js.map

package/dist/testing/temp-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temp-repo.js","sourceRoot":"","sources":["../../src/testing/temp-repo.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,4FAA4F;AAC5F,gFAAgF;AAEhF,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAO9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAiC;IAClE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IAEzD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAExE,IAAI,IAAI,EAAE,YAAY,EAAE,CAAC;QACvB,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/dist/tools/datetime.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from 'ai';
+import { z } from 'zod';
+declare const datetimeInputSchema: z.ZodObject<{
+    timezone: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DatetimeInput = z.infer<typeof datetimeInputSchema>;
+export type DatetimeOutput = {
+    datetime: string;
+    timezone: string;
+};
+export declare function datetimeTool(): Tool;
+export {};

package/dist/tools/datetime.js

@@ -0,0 +1,42 @@
+// Local datetime tool — implemented as a Vercel AI SDK function tool, NOT as
+// `openrouter:datetime` (server tool). Local is faster (no round-trip), free, and
+// not subject to the server-tool beta API. The server-tool variant offers zero
+// capability beyond `new Date()` + `Intl.DateTimeFormat`.
+//
+// SDK ref: docs/vendor/ai-sdk/chunk-02.md §"Tool Calling" — tool({ description, inputSchema, execute }).
+import { tool } from 'ai';
+import { z } from 'zod';
+// Reject empty string and invalid IANA tz strings; allow `undefined` from `.optional()`.
+// `toLocaleString` throws on both empty and unknown timezones, so we validate upfront.
+function isValidTimezone(tz) {
+    if (tz === undefined)
+        return true;
+    if (tz === '')
+        return false;
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: tz });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const datetimeInputSchema = z.object({
+    timezone: z.string().optional().refine(isValidTimezone, { message: 'Invalid IANA timezone' }),
+});
+export function datetimeTool() {
+    return tool({
+        description: 'Get the current date and time, optionally formatted for a specific timezone',
+        inputSchema: datetimeInputSchema,
+        execute: async (input) => {
+            const datetime = new Date().toLocaleString('en-US', {
+                timeZone: input.timezone,
+            });
+            return {
+                datetime,
+                timezone: input.timezone ?? '',
+            };
+        },
+    });
+}
+//# sourceMappingURL=datetime.js.map

package/dist/tools/datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../src/tools/datetime.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,kFAAkF;AAClF,+EAA+E;AAC/E,0DAA0D;AAC1D,EAAE;AACF,yGAAyG;AAGzG,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yFAAyF;AACzF,uFAAuF;AACvF,SAAS,eAAe,CAAC,EAAsB;IAC7C,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;CAC9F,CAAC,CAAC;AASH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,6EAA6E;QAC1F,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,KAAK,EAAE,KAAoB,EAA2B,EAAE;YAC/D,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE;gBAClD,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;YACH,OAAO;gBACL,QAAQ;gBACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;aAC/B,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/fetch-html.d.ts

@@ -0,0 +1,32 @@
+import type { Tool } from 'ai';
+import { z } from 'zod';
+import { type LookupFn, type WebFetchOutput } from './web-fetch.ts';
+declare const fetchHtmlInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    maxChars: z.ZodOptional<z.ZodNumber>;
+    impersonate: z.ZodOptional<z.ZodEnum<{
+        chrome: "chrome";
+        firefox: "firefox";
+        safari: "safari";
+    }>>;
+}, z.core.$strip>;
+export type FetchHtmlInput = z.infer<typeof fetchHtmlInputSchema>;
+export type ImpersonateTarget = z.infer<typeof fetchHtmlInputSchema>['impersonate'];
+export declare const DEFAULT_IMPERSONATE_TARGETS: Readonly<Record<'chrome' | 'firefox' | 'safari', string>>;
+export type ExecLike = (file: string, args: readonly string[], options?: {
+    timeout?: number;
+    maxBuffer?: number;
+}) => Promise<{
+    stdout: unknown;
+    stderr: unknown;
+}>;
+export type FetchHtmlInit = {
+    binary?: string;
+    targets?: Record<'chrome' | 'firefox' | 'safari', string>;
+    lookup?: LookupFn;
+    exec?: ExecLike;
+};
+export declare function isFetchHtmlAvailable(init?: FetchHtmlInit): Promise<boolean>;
+export declare function fetchHtmlTool(init?: FetchHtmlInit): Tool<FetchHtmlInput, WebFetchOutput>;
+export {};