@developerz.ai/ai-claude-compat 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 developerz-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @developerz.ai/ai-claude-compat
+
+Claude-Code-style agent primitives for the [Vercel AI SDK](https://ai-sdk.dev):
+FS/edit/search/bash tools, an `<env>` system-context block, a subagent-as-tool
+factory, and `.claude/` skills/agents loading.
+
+## Install
+
+```sh
+npm install @developerz.ai/ai-claude-compat ai
+```
+
+## What's inside
+
+- **Tools** — filesystem, edit, search, and bash tools scoped to a working
+  directory, shaped like Claude Code's tool surface.
+- **`composeSystemPrompt` / `envBlock`** — assemble a system prompt with an
+  `<env>` block (cwd, platform, OS, runtime, date).
+- **`createSubagent`** — wrap an `experimental_Agent` as a callable tool
+  (the subagents-as-tools pattern).
+- **`.claude/` loading** — discover and parse local skills and agents.
+
+## License
+
+MIT

package/dist/agents-loader.d.ts

@@ -0,0 +1,10 @@
+export type AgentDefinition = {
+    name: string;
+    description: string;
+    tools?: string[];
+    model?: string;
+    systemPrompt: string;
+    path: string;
+};
+export declare function loadAgents(claudeDir: string): Promise<AgentDefinition[]>;
+export declare function claudeDirs(cwd: string): string[];

package/dist/agents-loader.js

@@ -0,0 +1,48 @@
+// Discover Claude-Code-style subagent definitions: `<claudeDir>/agents/<name>.md`, each with
+// YAML frontmatter (name, description, tools, model) + a markdown body that is the subagent's
+// system prompt. Mirrors how the harness scans `.claude/agents/` (see claude-code-knowledge
+// skills-and-subagents.md). Also exposes the standard global + project `.claude` locations.
+import { readdir, readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, join } from 'node:path';
+import { asString, asStringArray, parseFrontmatter } from "./frontmatter.js";
+// Load every agent under `<claudeDir>/agents/*.md`. `claudeDir` is a `.claude` directory.
+// A missing dir yields []. Sorted by name.
+export async function loadAgents(claudeDir) {
+    const agentsDir = join(claudeDir, 'agents');
+    const entries = await readdir(agentsDir, { withFileTypes: true }).catch(() => null);
+    if (entries === null)
+        return [];
+    const agents = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        const path = join(agentsDir, entry.name);
+        const content = await readFile(path, 'utf8').catch(() => null);
+        if (content === null)
+            continue;
+        const { data, body } = parseFrontmatter(content);
+        const def = {
+            name: asString(data.name) || basename(entry.name, '.md'),
+            description: asString(data.description),
+            systemPrompt: body.trim(),
+            path,
+        };
+        const tools = asStringArray(data.tools);
+        if (tools)
+            def.tools = tools;
+        const model = asString(data.model);
+        if (model)
+            def.model = model;
+        agents.push(def);
+    }
+    agents.sort((a, b) => a.name.localeCompare(b.name));
+    return agents;
+}
+// The two `.claude` locations the harness scans, in increasing precedence: the global
+// `~/.claude` first, then the project `<cwd>/.claude`. A caller merging by name should let the
+// later (project) entry win.
+export function claudeDirs(cwd) {
+    return [join(homedir(), '.claude'), join(cwd, '.claude')];
+}
+//# sourceMappingURL=agents-loader.js.map

package/dist/agents-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-loader.js","sourceRoot":"","sources":["../src/agents-loader.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8FAA8F;AAC9F,4FAA4F;AAC5F,4FAA4F;AAE5F,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAe7E,0FAA0F;AAC1F,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACpF,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,OAAO,KAAK,IAAI;YAAE,SAAS;QAC/B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,GAAG,GAAoB;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;YACxD,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;YACvC,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE;YACzB,IAAI;SACL,CAAC;QACF,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,KAAK;YAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,KAAK;YAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sFAAsF;AACtF,+FAA+F;AAC/F,6BAA6B;AAC7B,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/bash-tool.d.ts

@@ -0,0 +1,20 @@
+import { type Tool } from 'ai';
+import { execa } from 'execa';
+import { z } from 'zod';
+declare const bashInputSchema: z.ZodObject<{
+    command: z.ZodString;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type BashInput = z.infer<typeof bashInputSchema>;
+export type BashOutput = {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+};
+export type BashToolInit = {
+    cwd: string;
+    defaultTimeoutMs?: number;
+    exec?: typeof execa;
+};
+export declare function bashTool(init: BashToolInit): Tool<BashInput, BashOutput>;
+export {};

package/dist/bash-tool.js

@@ -0,0 +1,61 @@
+// Shell tool, modeled on Claude Code's Bash. Runs a command via `bash -c` with its initial cwd
+// set to the worktree. Unlike the FS tools it is intentionally NOT confined to the worktree:
+// subagents need git, test and build commands, so `cd`, absolute paths and `git -C` are all
+// legitimate. The trust boundary is "an agent is running on your repo" — same as Claude Code
+// itself; sandboxing/containerization is out of scope. The worktree is the initial cwd as a
+// convenience default, not a security boundary.
+import { tool } from 'ai';
+import { ExecaError, execa } from 'execa';
+import { z } from 'zod';
+const bashInputSchema = z.object({
+    command: z.string().min(1),
+    timeoutMs: z.number().int().positive().optional(),
+});
+const DEFAULT_BASH_TIMEOUT_MS = 60_000;
+// Hard ceiling on the effective timeout so a single tool call — via a huge per-call timeoutMs or
+// an over-large configured default — can't pin the agent loop far longer than intended.
+const MAX_BASH_TIMEOUT_MS = 600_000;
+export function bashTool(init) {
+    const exec = init.exec ?? execa;
+    const defaultTimeout = init.defaultTimeoutMs ?? DEFAULT_BASH_TIMEOUT_MS;
+    return tool({
+        description: 'Run a shell command inside the current worktree. Returns stdout, stderr, and exit code. The command runs via `bash -c` with its initial cwd set to the worktree.',
+        inputSchema: bashInputSchema,
+        execute: async (input) => {
+            const timeout = Math.min(input.timeoutMs ?? defaultTimeout, MAX_BASH_TIMEOUT_MS);
+            try {
+                // Plain `-c`, not a login shell (`-lc`): a login shell sources /etc/profile and
+                // ~/.bash_profile, which in CI can `cd` away from `cwd` before the command runs. Also
+                // scrub BASH_ENV — even a non-login `bash -c` sources the file it points to at startup,
+                // which could `cd` away and defeat the cwd lock.
+                const r = await exec('bash', ['-c', input.command], {
+                    cwd: init.cwd,
+                    timeout,
+                    env: { ...process.env, BASH_ENV: '' },
+                });
+                return {
+                    stdout: typeof r.stdout === 'string' ? r.stdout : '',
+                    stderr: typeof r.stderr === 'string' ? r.stderr : '',
+                    exitCode: r.exitCode ?? 0,
+                };
+            }
+            catch (err) {
+                if (err instanceof ExecaError) {
+                    return {
+                        stdout: typeof err.stdout === 'string' ? err.stdout : '',
+                        stderr: typeof err.stderr === 'string' ? err.stderr : err.message,
+                        exitCode: err.exitCode ?? 1,
+                    };
+                }
+                // Unknown failure (timeout, ENOENT on bash, etc.): surface as a non-zero exit with the
+                // error message in stderr so the LLM can read it and react.
+                return {
+                    stdout: '',
+                    stderr: err instanceof Error ? err.message : String(err),
+                    exitCode: 1,
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=bash-tool.js.map

package/dist/bash-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-tool.js","sourceRoot":"","sources":["../src/bash-tool.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,6FAA6F;AAC7F,4FAA4F;AAC5F,6FAA6F;AAC7F,4FAA4F;AAC5F,gDAAgD;AAEhD,OAAO,EAAa,IAAI,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAkBH,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,iGAAiG;AACjG,wFAAwF;AACxF,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAEpC,MAAM,UAAU,QAAQ,CAAC,IAAkB;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;IAChC,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;IACxE,OAAO,IAAI,CAAC;QACV,WAAW,EACT,kKAAkK;QACpK,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAuB,EAAE;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,cAAc,EAAE,mBAAmB,CAAC,CAAC;YACjF,IAAI,CAAC;gBACH,gFAAgF;gBAChF,sFAAsF;gBACtF,wFAAwF;gBACxF,iDAAiD;gBACjD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;oBAClD,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,OAAO;oBACP,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE;iBACtC,CAAC,CAAC;gBACH,OAAO;oBACL,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;oBACpD,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;oBACpD,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC;iBAC1B,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;oBAC9B,OAAO;wBACL,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;wBACxD,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO;wBACjE,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,CAAC;qBAC5B,CAAC;gBACJ,CAAC;gBACD,uFAAuF;gBACvF,4DAA4D;gBAC5D,OAAO;oBACL,MAAM,EAAE,EAAE;oBACV,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACxD,QAAQ,EAAE,CAAC;iBACZ,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/edit-tools.d.ts

@@ -0,0 +1,40 @@
+import { type Tool } from 'ai';
+import { z } from 'zod';
+import type { ToolInit } from './fs-tools.ts';
+declare const editSpecSchema: z.ZodObject<{
+    oldString: z.ZodString;
+    newString: z.ZodString;
+    replaceAll: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const editFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    oldString: z.ZodString;
+    newString: z.ZodString;
+    replaceAll: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const multiEditInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    edits: z.ZodArray<z.ZodObject<{
+        oldString: z.ZodString;
+        newString: z.ZodString;
+        replaceAll: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type EditSpec = z.infer<typeof editSpecSchema>;
+export type EditFileInput = z.infer<typeof editFileInputSchema>;
+export type EditFileOutput = {
+    ok: boolean;
+    replacements: number;
+};
+export type MultiEditInput = z.infer<typeof multiEditInputSchema>;
+export type MultiEditOutput = {
+    ok: boolean;
+    replacements: number;
+};
+export declare function editFileTool(init: ToolInit): Tool<EditFileInput, EditFileOutput>;
+export declare function multiEditTool(init: ToolInit): Tool<MultiEditInput, MultiEditOutput>;
+export declare function applyEdit(content: string, edit: EditSpec): {
+    next: string;
+    count: number;
+};
+export {};

package/dist/edit-tools.js

@@ -0,0 +1,81 @@
+// String-replace edit tools, modeled on Claude Code's Edit. `editFile` does one exact
+// replacement; `multiEdit` applies a sequence atomically (all succeed and the file is written
+// once, or nothing is written). Both reject an `oldString` that is absent or — unless
+// `replaceAll` — ambiguous, so the model can't silently edit the wrong occurrence.
+import { readFile as fsReadFile, writeFile as fsWriteFile } from 'node:fs/promises';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { resolveInside } from "./safe-path.js";
+const editSpecSchema = z.object({
+    oldString: z.string().min(1),
+    newString: z.string(),
+    replaceAll: z.boolean().optional(),
+});
+const editFileInputSchema = z.object({ path: z.string().min(1) }).extend(editSpecSchema.shape);
+const multiEditInputSchema = z.object({
+    path: z.string().min(1),
+    edits: z.array(editSpecSchema).min(1),
+});
+export function editFileTool(init) {
+    return tool({
+        description: 'Edit a file in the worktree by exact string replacement. `oldString` must occur exactly once unless `replaceAll` is true (then every occurrence is replaced). Errors if `oldString` is not found, or is ambiguous without `replaceAll`.',
+        inputSchema: editFileInputSchema,
+        execute: async (input) => {
+            const safe = await resolveInside(init.cwd, input.path);
+            const original = await fsReadFile(safe, 'utf8');
+            const { next, count } = applyEdit(original, input);
+            await fsWriteFile(safe, next, 'utf8');
+            return { ok: true, replacements: count };
+        },
+    });
+}
+export function multiEditTool(init) {
+    return tool({
+        description: 'Apply a sequence of exact string replacements to a single file atomically. Edits apply in order to the in-memory contents; if any edit fails (string absent or ambiguous), nothing is written. Use for several related edits to the same file.',
+        inputSchema: multiEditInputSchema,
+        execute: async (input) => {
+            const safe = await resolveInside(init.cwd, input.path);
+            let content = await fsReadFile(safe, 'utf8');
+            let total = 0;
+            input.edits.forEach((edit, i) => {
+                try {
+                    const { next, count } = applyEdit(content, edit);
+                    content = next;
+                    total += count;
+                }
+                catch (err) {
+                    throw new Error(`edit ${i + 1}/${input.edits.length}: ${err.message}`);
+                }
+            });
+            await fsWriteFile(safe, content, 'utf8');
+            return { ok: true, replacements: total };
+        },
+    });
+}
+// Pure string replacement with the uniqueness contract. Uses split/join so `newString` is
+// inserted verbatim (no `$&`/`$1` substitution that String.prototype.replace would apply).
+export function applyEdit(content, edit) {
+    // Guard the exported API: the tool schemas enforce min(1), but a direct caller could pass
+    // '' — which `split('')` would treat as a match at every character boundary.
+    if (edit.oldString.length === 0) {
+        throw new Error('oldString must be non-empty');
+    }
+    const occurrences = content.split(edit.oldString).length - 1;
+    if (occurrences === 0) {
+        throw new Error(`oldString not found: ${preview(edit.oldString)}`);
+    }
+    if (occurrences > 1 && !edit.replaceAll) {
+        throw new Error(`oldString is not unique (${occurrences} matches): ${preview(edit.oldString)} — add surrounding context or pass replaceAll`);
+    }
+    if (edit.replaceAll) {
+        return { next: content.split(edit.oldString).join(edit.newString), count: occurrences };
+    }
+    const at = content.indexOf(edit.oldString);
+    const next = content.slice(0, at) + edit.newString + content.slice(at + edit.oldString.length);
+    return { next, count: 1 };
+}
+function preview(s) {
+    const oneLine = s.replace(/\n/g, '\\n');
+    return oneLine.length > 60 ? `${oneLine.slice(0, 60)}…` : oneLine;
+}
+//# sourceMappingURL=edit-tools.js.map

package/dist/edit-tools.js.map

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

package/dist/env-block.d.ts

@@ -0,0 +1,6 @@
+export type EnvInfo = {
+    cwd: string;
+    isGitRepo?: boolean;
+    date?: string;
+};
+export declare function envBlock(info: EnvInfo): string;

package/dist/env-block.js

@@ -0,0 +1,29 @@
+// The `<env>` system-context block injected into a subagent's system prompt so the model
+// picks the right paths/commands. Portable: node:os + process only (Bun, Node >=20, Deno).
+import { arch as osArch, release } from 'node:os';
+function runtimeLabel() {
+    const v = process.versions;
+    if (v.bun)
+        return `bun ${v.bun}`;
+    if (v.deno)
+        return `deno ${v.deno}`;
+    return `node ${process.version}`;
+}
+export function envBlock(info) {
+    const lines = [
+        '<env>',
+        `Working directory: ${info.cwd}`,
+        ...(info.isGitRepo === undefined
+            ? []
+            : [`Is directory a git repo: ${info.isGitRepo ? 'Yes' : 'No'}`]),
+        `Platform: ${process.platform}`,
+        `OS version: ${release()}`,
+        `Arch: ${osArch()}`,
+        `Shell: ${process.env.SHELL ?? ''}`,
+        `Runtime: ${runtimeLabel()}`,
+        `Today's date: ${info.date ?? new Date().toISOString().slice(0, 10)}`,
+        '</env>',
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=env-block.js.map

package/dist/env-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-block.js","sourceRoot":"","sources":["../src/env-block.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,2FAA2F;AAE3F,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AASlD,SAAS,YAAY;IACnB,MAAM,CAAC,GAAG,OAAO,CAAC,QAA8C,CAAC;IACjE,IAAI,CAAC,CAAC,GAAG;QAAE,OAAO,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;IACjC,IAAI,CAAC,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,MAAM,KAAK,GAAG;QACZ,OAAO;QACP,sBAAsB,IAAI,CAAC,GAAG,EAAE;QAChC,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS;YAC9B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,aAAa,OAAO,CAAC,QAAQ,EAAE;QAC/B,eAAe,OAAO,EAAE,EAAE;QAC1B,SAAS,MAAM,EAAE,EAAE;QACnB,UAAU,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE;QACnC,YAAY,YAAY,EAAE,EAAE;QAC5B,iBAAiB,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QACrE,QAAQ;KACT,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/frontmatter.d.ts

@@ -0,0 +1,8 @@
+export type FrontmatterValue = string | string[];
+export type Frontmatter = {
+    data: Record<string, FrontmatterValue>;
+    body: string;
+};
+export declare function parseFrontmatter(content: string): Frontmatter;
+export declare function asString(value: FrontmatterValue | undefined): string;
+export declare function asStringArray(value: FrontmatterValue | undefined): string[] | undefined;

package/dist/frontmatter.js

@@ -0,0 +1,70 @@
+// Minimal YAML-frontmatter parser for `.claude/` extension files (SKILL.md, agents/*.md).
+// Handles only what those files use — scalar strings, flow arrays (`[a, b]`), and block
+// sequences (`- a` lines) — so the lib stays dependency-free rather than pulling a full YAML
+// engine. Anything outside that shape is ignored, not errored, so a malformed field never
+// blocks discovery of the rest.
+const FRONTMATTER = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n([\s\S]*))?$/;
+export function parseFrontmatter(content) {
+    const match = FRONTMATTER.exec(content);
+    if (!match)
+        return { data: {}, body: content };
+    return { data: parseBlock(match[1] ?? ''), body: match[2] ?? '' };
+}
+function parseBlock(raw) {
+    const data = {};
+    const lines = raw.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        if (line.trim() === '' || line.trimStart().startsWith('#'))
+            continue;
+        const m = /^([A-Za-z0-9_-]+):[ \t]*(.*)$/.exec(line);
+        if (!m)
+            continue;
+        const key = m[1] ?? '';
+        const rest = (m[2] ?? '').trim();
+        if (rest === '') {
+            // A bare `key:` may head a block sequence on the following `- item` lines.
+            const items = [];
+            while (i + 1 < lines.length && /^[ \t]*-[ \t]+/.test(lines[i + 1] ?? '')) {
+                i += 1;
+                items.push(stripQuotes((lines[i] ?? '').replace(/^[ \t]*-[ \t]+/, '').trim()));
+            }
+            data[key] = items;
+        }
+        else if (rest.startsWith('[') && rest.endsWith(']')) {
+            const inner = rest.slice(1, -1).trim();
+            data[key] = inner === '' ? [] : inner.split(',').map((s) => stripQuotes(s.trim()));
+        }
+        else {
+            data[key] = stripQuotes(rest);
+        }
+    }
+    return data;
+}
+function stripQuotes(s) {
+    if (s.length >= 2) {
+        const first = s[0];
+        if ((first === '"' || first === "'") && s[s.length - 1] === first) {
+            return s.slice(1, -1);
+        }
+    }
+    return s;
+}
+// Coerce a parsed value to a single string (scalars stay; arrays join). Empty when absent.
+export function asString(value) {
+    if (typeof value === 'string')
+        return value;
+    if (Array.isArray(value))
+        return value.join(', ');
+    return '';
+}
+// Coerce a parsed value to a string list. A scalar splits on commas; absent → undefined.
+export function asStringArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value === 'string' && value.trim() !== '') {
+        return value.split(',').map((s) => s.trim());
+    }
+    return undefined;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/fs-tools.d.ts

@@ -0,0 +1,25 @@
+import { type Tool } from 'ai';
+import { z } from 'zod';
+export type ToolInit = {
+    cwd: string;
+};
+declare const readFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const writeFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type ReadFileInput = z.infer<typeof readFileInputSchema>;
+export type ReadFileOutput = {
+    content: string;
+};
+export type WriteFileInput = z.infer<typeof writeFileInputSchema>;
+export type WriteFileOutput = {
+    ok: boolean;
+};
+export declare function readFileTool(init: ToolInit): Tool<ReadFileInput, ReadFileOutput>;
+export declare function writeFileTool(init: ToolInit): Tool<WriteFileInput, WriteFileOutput>;
+export {};

package/dist/fs-tools.js

@@ -0,0 +1,79 @@
+// Read/write filesystem tools, modeled on Claude Code's Read/Write. Every tool is scoped to a
+// `cwd` (the active worktree) and rejects paths that escape it via the shared `resolveInside`
+// guard. AI-SDK `Tool`-shaped so they drop straight into a subagent's tool set.
+import { createReadStream } from 'node:fs';
+import { readFile as fsReadFile, writeFile as fsWriteFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { createInterface } from 'node:readline';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { resolveInside } from "./safe-path.js";
+// offset is a 1-based starting line; limit is the max number of lines to return. Both optional
+// — omitting them reads the whole file. Mirrors Claude Code's Read line window.
+const readFileInputSchema = z.object({
+    path: z.string().min(1),
+    offset: z.number().int().positive().optional(),
+    limit: z.number().int().positive().optional(),
+});
+const writeFileInputSchema = z.object({
+    path: z.string().min(1),
+    content: z.string(),
+});
+export function readFileTool(init) {
+    return tool({
+        description: 'Read a UTF-8 text file from the current worktree. Path may be relative (resolved against the worktree root) or absolute (must still be inside the worktree). Optionally pass `offset` (1-based start line) and `limit` (line count) to read a window of a large file.',
+        inputSchema: readFileInputSchema,
+        execute: async (input) => {
+            const safe = await resolveInside(init.cwd, input.path);
+            // Whole-file read returns the bytes verbatim; a windowed read streams line-by-line so a
+            // small window of a huge file doesn't pull the whole thing into memory.
+            if (input.offset === undefined && input.limit === undefined) {
+                return { content: await fsReadFile(safe, 'utf8') };
+            }
+            return { content: await readWindow(safe, input.offset, input.limit) };
+        },
+    });
+}
+export function writeFileTool(init) {
+    return tool({
+        description: 'Write a UTF-8 text file inside the current worktree. Creates parent directories. Overwrites any existing file. Path must stay inside the worktree.',
+        inputSchema: writeFileInputSchema,
+        execute: async (input) => {
+            const safe = await resolveInside(init.cwd, input.path);
+            await mkdir(dirname(safe), { recursive: true });
+            await fsWriteFile(safe, input.content, 'utf8');
+            return { ok: true };
+        },
+    });
+}
+// Stream the [offset, offset+limit) line window (1-based offset) without reading the whole file.
+// readline strips line terminators, so when the window runs to the end of the file we re-attach a
+// trailing newline — matching the whole-file read for to-EOF windows. A window capped early by
+// `limit` returns just the joined lines (no trailing terminator).
+async function readWindow(path, offset, limit) {
+    const start = offset ?? 1;
+    const stream = createReadStream(path, { encoding: 'utf8' });
+    try {
+        const rl = createInterface({ input: stream, crlfDelay: Number.POSITIVE_INFINITY });
+        const lines = [];
+        let lineNo = 0;
+        let cappedEarly = false;
+        for await (const line of rl) {
+            lineNo += 1;
+            if (lineNo < start)
+                continue;
+            lines.push(line);
+            if (limit !== undefined && lines.length >= limit) {
+                cappedEarly = true;
+                break;
+            }
+        }
+        rl.close();
+        const text = lines.join('\n');
+        return !cappedEarly && lines.length > 0 ? `${text}\n` : text;
+    }
+    finally {
+        stream.destroy();
+    }
+}
+//# sourceMappingURL=fs-tools.js.map

package/dist/fs-tools.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { type AgentDefinition, claudeDirs, loadAgents } from './agents-loader.ts';
+export { type BashInput, type BashOutput, type BashToolInit, bashTool } from './bash-tool.ts';
+export { applyEdit, type EditFileInput, type EditFileOutput, type EditSpec, editFileTool, type MultiEditInput, type MultiEditOutput, multiEditTool, } from './edit-tools.ts';
+export { type EnvInfo, envBlock } from './env-block.ts';
+export { asString, asStringArray, type Frontmatter, type FrontmatterValue, parseFrontmatter, } from './frontmatter.ts';
+export { type ReadFileInput, type ReadFileOutput, readFileTool, type ToolInit, type WriteFileInput, type WriteFileOutput, writeFileTool, } from './fs-tools.ts';
+export { resolveInside } from './safe-path.ts';
+export { type GlobInput, type GlobOutput, type GrepInput, type GrepOutput, globTool, globToRegExp, grepTool, } from './search-tools.ts';
+export { loadSkills, type SkillDefinition } from './skills-loader.ts';
+export { composeSystemPrompt, createSubagent, type SubagentConfig } from './subagent.ts';

package/dist/index.js

@@ -0,0 +1,14 @@
+// Public API for @developerz.ai/ai-claude-compat. Claude-Code-style agent primitives for the
+// Vercel AI SDK: cwd-scoped FS/edit/search/shell tools, an <env> system-context block, and
+// .claude/ skills + agents loading.
+export { claudeDirs, loadAgents } from "./agents-loader.js";
+export { bashTool } from "./bash-tool.js";
+export { applyEdit, editFileTool, multiEditTool, } from "./edit-tools.js";
+export { envBlock } from "./env-block.js";
+export { asString, asStringArray, parseFrontmatter, } from "./frontmatter.js";
+export { readFileTool, writeFileTool, } from "./fs-tools.js";
+export { resolveInside } from "./safe-path.js";
+export { globTool, globToRegExp, grepTool, } from "./search-tools.js";
+export { loadSkills } from "./skills-loader.js";
+export { composeSystemPrompt, createSubagent } from "./subagent.js";
+//# 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,6FAA6F;AAC7F,2FAA2F;AAC3F,oCAAoC;AAEpC,OAAO,EAAwB,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAsD,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EACL,SAAS,EAIT,YAAY,EAGZ,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAgB,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,QAAQ,EACR,aAAa,EAGb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGL,YAAY,EAIZ,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAKL,QAAQ,EACR,YAAY,EACZ,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAwB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAuB,MAAM,eAAe,CAAC"}

package/dist/safe-path.d.ts

@@ -0,0 +1 @@
+export declare function resolveInside(root: string, requested: string): Promise<string>;

package/dist/safe-path.js

@@ -0,0 +1,71 @@
+// Confine a requested path to a root directory. Every FS tool in this lib is exposed to a
+// fallible LLM and may run against the user's real repo (not a sandbox), so a missing path
+// check is an arbitrary read/write primitive — same severity as a path-traversal CVE in a web
+// app. The guard uses two layers: (1) a cheap pre-resolve string check via `path.relative`
+// that rejects `../`-style escapes, and (2) a realpath of the closest existing ancestor that
+// defeats symlink trickery. We can't realpath the target itself (it may not exist yet for a
+// write), so we realpath the parent and re-check the relative path from there.
+import { realpath } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+// Resolve `requested` against `root` and assert the result stays inside `root`. Accepts a
+// relative path (resolved against root) or an absolute path (must still be inside root).
+// Throws if the path escapes, by string or via symlink.
+export async function resolveInside(root, requested) {
+    const absRoot = resolve(root);
+    const target = isAbsolute(requested) ? resolve(requested) : resolve(absRoot, requested);
+    if (escapesRoot(absRoot, target)) {
+        throw new Error(`path escapes worktree: ${requested}`);
+    }
+    const realRoot = await safeRealpath(absRoot);
+    const realTarget = await realpathOfExisting(target);
+    if (escapesRoot(realRoot, realTarget)) {
+        throw new Error(`path escapes worktree via symlink: ${requested}`);
+    }
+    return target;
+}
+function escapesRoot(root, target) {
+    const rel = relative(root, target);
+    if (rel === '')
+        return false;
+    // Only a real parent-traversal token escapes — not an in-root name that merely starts with
+    // ".." (e.g. "..cache/file").
+    if (rel === '..' || rel.startsWith(`..${sep}`))
+        return true;
+    if (isAbsolute(rel))
+        return true;
+    return false;
+}
+// Only a genuinely-absent path (ENOENT) may fall back to the string form. EACCES/ELOOP/EIO and
+// the like must propagate — swallowing them would silently downgrade the symlink guard to the
+// weaker string-only check.
+function isEnoent(err) {
+    return typeof err === 'object' && err !== null && err.code === 'ENOENT';
+}
+async function safeRealpath(p) {
+    try {
+        return await realpath(p);
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return resolve(p);
+        throw err;
+    }
+}
+// Walk up `target`'s ancestors until one exists, realpath it, then re-attach the
+// non-existing suffix. Lets us safely check would-be-created paths.
+async function realpathOfExisting(target) {
+    try {
+        return await realpath(target);
+    }
+    catch (err) {
+        if (!isEnoent(err))
+            throw err;
+        const parent = dirname(target);
+        if (parent === target)
+            return target;
+        const realParent = await realpathOfExisting(parent);
+        const suffix = relative(parent, target);
+        return resolve(realParent, suffix);
+    }
+}
+//# sourceMappingURL=safe-path.js.map

package/dist/safe-path.js.map

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

package/dist/search-tools.d.ts

@@ -0,0 +1,29 @@
+import { type Tool } from 'ai';
+import { z } from 'zod';
+import type { ToolInit } from './fs-tools.ts';
+declare const grepInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    glob: z.ZodOptional<z.ZodString>;
+    ignoreCase: z.ZodOptional<z.ZodBoolean>;
+    filesWithMatches: z.ZodOptional<z.ZodBoolean>;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const globInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GrepInput = z.infer<typeof grepInputSchema>;
+export type GrepOutput = {
+    matches: string[];
+    truncated: boolean;
+};
+export type GlobInput = z.infer<typeof globInputSchema>;
+export type GlobOutput = {
+    files: string[];
+    truncated: boolean;
+};
+export declare function grepTool(init: ToolInit): Tool<GrepInput, GrepOutput>;
+export declare function globTool(init: ToolInit): Tool<GlobInput, GlobOutput>;
+export declare function globToRegExp(glob: string): RegExp;
+export {};

package/dist/search-tools.js

@@ -0,0 +1,166 @@
+// Portable search tools, modeled on how Claude Code uses ripgrep + glob — but implemented in
+// pure node so there's no `rg` dependency (it may be absent) and no reliance on `fs.glob`
+// (not on Node 20). Both walk the tree under a cwd-confined root, skipping `.git` and
+// `node_modules`, following no symlinks (which keeps the walk inside the worktree and loop-free).
+import { readFile as fsReadFile, readdir, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+import { tool } from 'ai';
+import { z } from 'zod';
+import { resolveInside } from "./safe-path.js";
+const DEFAULT_MAX_RESULTS = 200;
+const GLOB_MAX_FILES = 2000;
+const MAX_FILE_BYTES = 5_000_000;
+// Regex metacharacters escaped to literals when translating a glob (a Set, not a string, so the
+// `${` pair doesn't read as a template placeholder).
+const REGEX_META = new Set(['.', '+', '^', '$', '{', '}', '(', ')', '|', '[', ']', '\\']);
+const grepInputSchema = z.object({
+    pattern: z.string().min(1),
+    path: z.string().optional(),
+    glob: z.string().optional(),
+    ignoreCase: z.boolean().optional(),
+    filesWithMatches: z.boolean().optional(),
+    maxResults: z.number().int().positive().optional(),
+});
+const globInputSchema = z.object({
+    pattern: z.string().min(1),
+    path: z.string().optional(),
+});
+export function grepTool(init) {
+    return tool({
+        description: 'Search file contents under the worktree for a JavaScript regular expression. Returns `path:line:text` lines (or just file paths with filesWithMatches). Optionally restrict to files matching a glob, ignore case, and cap results.',
+        inputSchema: grepInputSchema,
+        execute: async (input) => {
+            const root = await resolveInside(init.cwd, input.path ?? '.');
+            const re = compileRegExp(input.pattern, input.ignoreCase ? 'i' : '');
+            const fileFilter = input.glob ? globToRegExp(input.glob) : null;
+            const cap = input.maxResults ?? DEFAULT_MAX_RESULTS;
+            const matches = [];
+            let truncated = false;
+            outer: for await (const file of walk(root, init.cwd)) {
+                if (fileFilter && !fileFilter.test(file.rel))
+                    continue;
+                const text = await readTextOrSkip(file.abs);
+                if (text === null)
+                    continue;
+                const lines = text.split('\n');
+                for (let i = 0; i < lines.length; i++) {
+                    const line = lines[i] ?? '';
+                    if (!re.test(line))
+                        continue;
+                    matches.push(input.filesWithMatches ? file.rel : `${file.rel}:${i + 1}:${line}`);
+                    if (matches.length >= cap) {
+                        truncated = true;
+                        break outer;
+                    }
+                    if (input.filesWithMatches)
+                        continue outer; // one entry per file
+                }
+            }
+            return { matches, truncated };
+        },
+    });
+}
+export function globTool(init) {
+    return tool({
+        description: 'List files under the worktree whose path matches a glob (supports `*`, `**`, `?`). Paths are returned relative to the worktree, sorted. Skips `.git` and `node_modules`.',
+        inputSchema: globInputSchema,
+        execute: async (input) => {
+            const root = await resolveInside(init.cwd, input.path ?? '.');
+            const re = globToRegExp(input.pattern);
+            const files = [];
+            let truncated = false;
+            for await (const file of walk(root, init.cwd)) {
+                if (!re.test(file.rel))
+                    continue;
+                files.push(file.rel);
+                if (files.length >= GLOB_MAX_FILES) {
+                    truncated = true;
+                    break;
+                }
+            }
+            files.sort();
+            return { files, truncated };
+        },
+    });
+}
+// Depth-first walk yielding regular files only. `rel` is POSIX-style and relative to `cwd`
+// (so a caller's glob/regex sees forward slashes regardless of platform). Symlinks are not
+// followed — that confines the walk to the worktree and avoids cycles.
+async function* walk(dir, cwd) {
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => null);
+    if (entries === null)
+        return;
+    // readdir order is filesystem-dependent; sort so capped grep/glob results (and which entries
+    // survive maxResults) stay deterministic across environments.
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        if (entry.isSymbolicLink())
+            continue;
+        if (entry.name === '.git' || entry.name === 'node_modules')
+            continue;
+        const abs = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            yield* walk(abs, cwd);
+        }
+        else if (entry.isFile()) {
+            yield { abs, rel: relative(cwd, abs).split(sep).join('/') };
+        }
+    }
+}
+async function readTextOrSkip(abs) {
+    try {
+        const info = await stat(abs);
+        if (info.size > MAX_FILE_BYTES)
+            return null;
+        const text = await fsReadFile(abs, 'utf8');
+        if (text.includes(String.fromCharCode(0)))
+            return null; // crude binary guard: NUL byte
+        return text;
+    }
+    catch {
+        return null;
+    }
+}
+function compileRegExp(pattern, flags) {
+    try {
+        return new RegExp(pattern, flags);
+    }
+    catch (err) {
+        throw new Error(`invalid regular expression: ${err.message}`);
+    }
+}
+// Convert a glob to an anchored RegExp. Supports `**` (any run of path segments, incl. zero),
+// `*` (any run within one segment), `?` (one non-slash char). Other regex metacharacters are
+// escaped so they match literally.
+export function globToRegExp(glob) {
+    let re = '';
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (c === '*') {
+            if (glob[i + 1] === '*') {
+                i++;
+                if (glob[i + 1] === '/') {
+                    i++;
+                    re += '(?:[^/]+/)*'; // `**/` — zero or more directories
+                }
+                else {
+                    re += '.*'; // `**` — anything, including slashes
+                }
+            }
+            else {
+                re += '[^/]*'; // `*` — within a segment
+            }
+        }
+        else if (c === '?') {
+            re += '[^/]';
+        }
+        else if (c !== undefined && REGEX_META.has(c)) {
+            re += `\\${c}`;
+        }
+        else {
+            re += c;
+        }
+    }
+    return new RegExp(`^${re}$`);
+}
+//# sourceMappingURL=search-tools.js.map

package/dist/search-tools.js.map

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

package/dist/skills-loader.d.ts

@@ -0,0 +1,7 @@
+export type SkillDefinition = {
+    name: string;
+    description: string;
+    body: string;
+    path: string;
+};
+export declare function loadSkills(claudeDir: string): Promise<SkillDefinition[]>;

package/dist/skills-loader.js

@@ -0,0 +1,33 @@
+// Discover Claude-Code-style skills: `<claudeDir>/skills/<name>/SKILL.md`, each with YAML
+// frontmatter (name, description) + a markdown body of instructions. Mirrors how the harness
+// scans `.claude/skills/` (see claude-code-knowledge skills-and-subagents.md).
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { asString, parseFrontmatter } from "./frontmatter.js";
+// Load every skill under `<claudeDir>/skills/*/SKILL.md`. `claudeDir` is a `.claude` directory.
+// A missing dir yields []; a skill folder without a SKILL.md is skipped. Sorted by name.
+export async function loadSkills(claudeDir) {
+    const skillsDir = join(claudeDir, 'skills');
+    const entries = await readdir(skillsDir, { withFileTypes: true }).catch(() => null);
+    if (entries === null)
+        return [];
+    const skills = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const path = join(skillsDir, entry.name, 'SKILL.md');
+        const content = await readFile(path, 'utf8').catch(() => null);
+        if (content === null)
+            continue;
+        const { data, body } = parseFrontmatter(content);
+        skills.push({
+            name: asString(data.name) || entry.name,
+            description: asString(data.description),
+            body: body.trim(),
+            path,
+        });
+    }
+    skills.sort((a, b) => a.name.localeCompare(b.name));
+    return skills;
+}
+//# sourceMappingURL=skills-loader.js.map

package/dist/skills-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-loader.js","sourceRoot":"","sources":["../src/skills-loader.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,6FAA6F;AAC7F,+EAA+E;AAE/E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAW9D,gGAAgG;AAChG,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACpF,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,OAAO,KAAK,IAAI;YAAE,SAAS;QAC/B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI;YACvC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;YACvC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/subagent.d.ts

@@ -0,0 +1,11 @@
+import { type LanguageModel, type Output, ToolLoopAgent, type ToolSet } from 'ai';
+import { type EnvInfo } from './env-block.ts';
+export declare function composeSystemPrompt(style: string, rolePrefix: string, env: string | EnvInfo): string;
+export type SubagentConfig<TOOLS extends ToolSet, OUTPUT extends Output.Output> = {
+    model: LanguageModel;
+    tools: TOOLS;
+    systemPrompt: string;
+    output: OUTPUT;
+    maxSteps?: number;
+};
+export declare function createSubagent<TOOLS extends ToolSet, OUTPUT extends Output.Output>(config: SubagentConfig<TOOLS, OUTPUT>, defaultMaxSteps: number): ToolLoopAgent<never, TOOLS, OUTPUT>;

package/dist/subagent.js

@@ -0,0 +1,25 @@
+// Provider-agnostic subagent scaffolding for the Vercel AI SDK: compose a system prompt with an
+// <env> block, and wrap the `ToolLoopAgent` construction (the subagents-as-tools pattern) behind
+// a single factory so callers don't repeat the model/tools/instructions/stopWhen boilerplate.
+import { stepCountIs, ToolLoopAgent } from 'ai';
+import { envBlock } from "./env-block.js";
+// Build a subagent system prompt: caller style/context + role prefix + an <env> system-context
+// block (so the model knows the worktree cwd, platform, runtime, date). The cwd is per-worktree,
+// so this is composed at the wiring site rather than baked into a static role prefix. Pass a
+// string cwd for the common case, or a full EnvInfo to control the git/date fields.
+export function composeSystemPrompt(style, rolePrefix, env) {
+    const info = typeof env === 'string' ? { cwd: env, isGitRepo: true } : env;
+    return `${style}${rolePrefix}\n${envBlock(info)}`;
+}
+// Wrap a ToolLoopAgent. Maps systemPrompt → instructions and maxSteps → a stepCountIs stop
+// condition, so each concrete subagent factory is a one-liner over its own tools + output type.
+export function createSubagent(config, defaultMaxSteps) {
+    return new ToolLoopAgent({
+        model: config.model,
+        tools: config.tools,
+        instructions: config.systemPrompt,
+        output: config.output,
+        stopWhen: stepCountIs(config.maxSteps ?? defaultMaxSteps),
+    });
+}
+//# sourceMappingURL=subagent.js.map

package/dist/subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../src/subagent.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,iGAAiG;AACjG,8FAA8F;AAE9F,OAAO,EAAmC,WAAW,EAAE,aAAa,EAAgB,MAAM,IAAI,CAAC;AAC/F,OAAO,EAAgB,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAExD,+FAA+F;AAC/F,iGAAiG;AACjG,6FAA6F;AAC7F,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,UAAkB,EAClB,GAAqB;IAErB,MAAM,IAAI,GAAY,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACpF,OAAO,GAAG,KAAK,GAAG,UAAU,KAAK,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AACpD,CAAC;AAaD,2FAA2F;AAC3F,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAC5B,MAAqC,EACrC,eAAuB;IAEvB,OAAO,IAAI,aAAa,CAAuB;QAC7C,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,IAAI,eAAe,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@developerz.ai/ai-claude-compat",
+  "version": "0.0.0",
+  "description": "Claude-Code-style agent primitives for the Vercel AI SDK: FS/bash tools, an <env> system-context block, a subagent-as-tool factory, and .claude/ skills/agents loading.",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test:node": "node --test --import tsx \"src/**/*.test.ts\""
+  },
+  "dependencies": {
+    "ai": "^6.0.182",
+    "execa": "^9.6.1",
+    "zod": "^4.4.3"
+  }
+}