@cuylabs/agent-code 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from '@cuylabs/agent-core';
+export { BashParams, EditParams, GlobParams, GrepParams, ReadParams, ToolsetBuilder, WriteParams, bashParameters, bashTool, defaultCodingTools, editParameters, editTool, executeBash, executeGrep, globParameters, globTool, grepParameters, grepTool, readParameters, readTool, resolveTools, setupToolRegistry, toolset, writeParameters, writeTool } from './tools/index.js';
+import 'zod';

package/dist/index.js

@@ -0,0 +1,45 @@
+import {
+  ToolsetBuilder,
+  bashParameters,
+  bashTool,
+  defaultCodingTools,
+  editParameters,
+  editTool,
+  executeBash,
+  executeGrep,
+  globParameters,
+  globTool,
+  grepParameters,
+  grepTool,
+  readParameters,
+  readTool,
+  resolveTools,
+  setupToolRegistry,
+  toolset,
+  writeParameters,
+  writeTool
+} from "./chunk-IOXLKDEB.js";
+
+// src/index.ts
+export * from "@cuylabs/agent-core";
+export {
+  ToolsetBuilder,
+  bashParameters,
+  bashTool,
+  defaultCodingTools,
+  editParameters,
+  editTool,
+  executeBash,
+  executeGrep,
+  globParameters,
+  globTool,
+  grepParameters,
+  grepTool,
+  readParameters,
+  readTool,
+  resolveTools,
+  setupToolRegistry,
+  toolset,
+  writeParameters,
+  writeTool
+};

package/dist/tools/index.d.ts

@@ -0,0 +1,360 @@
+import { Tool, ToolHost, ExecResult, ToolSpec } from '@cuylabs/agent-core';
+import { z } from 'zod';
+
+/**
+ * Bash tool - Execute shell commands
+ * Based on OpenCode's tool/bash.ts patterns
+ */
+
+declare const bashParameters: z.ZodObject<{
+    command: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    workdir: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    description: string;
+    timeout?: number | undefined;
+    workdir?: string | undefined;
+}, {
+    command: string;
+    description: string;
+    timeout?: number | undefined;
+    workdir?: string | undefined;
+}>;
+type BashParams = z.infer<typeof bashParameters>;
+/**
+ * Execute a bash command via a ToolHost.
+ */
+declare function executeBash(params: BashParams, host: ToolHost, cwd: string, abort?: AbortSignal): Promise<ExecResult>;
+/**
+ * Bash tool definition
+ */
+declare const bashTool: Tool.Info<z.ZodObject<{
+    command: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    workdir: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    description: string;
+    timeout?: number | undefined;
+    workdir?: string | undefined;
+}, {
+    command: string;
+    description: string;
+    timeout?: number | undefined;
+    workdir?: string | undefined;
+}>, {
+    exitCode: number | null;
+    timedOut: boolean;
+    truncated: boolean;
+    outputPath: string | undefined;
+}>;
+
+/**
+ * Read tool - Read file contents
+ * Based on OpenCode's tool/read.ts patterns
+ */
+
+declare const readParameters: z.ZodObject<{
+    filePath: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    filePath: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>;
+type ReadParams = z.infer<typeof readParameters>;
+/**
+ * Read tool definition
+ */
+declare const readTool: Tool.Info<z.ZodObject<{
+    filePath: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    filePath: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>, {
+    totalLines: number;
+    linesRead: number;
+    offset: number;
+    truncated: boolean;
+    preview: string;
+}>;
+
+/**
+ * Edit tool - Edit files by replacing text
+ * Based on OpenCode's tool/edit.ts patterns
+ */
+
+declare const editParameters: z.ZodObject<{
+    filePath: z.ZodString;
+    oldString: z.ZodString;
+    newString: z.ZodString;
+    replaceAll: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    oldString: string;
+    newString: string;
+    replaceAll?: boolean | undefined;
+}, {
+    filePath: string;
+    oldString: string;
+    newString: string;
+    replaceAll?: boolean | undefined;
+}>;
+type EditParams = z.infer<typeof editParameters>;
+/**
+ * Edit tool definition
+ */
+declare const editTool: Tool.Info<z.ZodObject<{
+    filePath: z.ZodString;
+    oldString: z.ZodString;
+    newString: z.ZodString;
+    replaceAll: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    oldString: string;
+    newString: string;
+    replaceAll?: boolean | undefined;
+}, {
+    filePath: string;
+    oldString: string;
+    newString: string;
+    replaceAll?: boolean | undefined;
+}>, {
+    filepath: string;
+    created: boolean;
+    additions: number;
+    deletions: number;
+    diff: string;
+}>;
+
+/**
+ * Write tool - Create or overwrite files
+ * Based on OpenCode's tool/write.ts patterns
+ */
+
+declare const writeParameters: z.ZodObject<{
+    filePath: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    content: string;
+}, {
+    filePath: string;
+    content: string;
+}>;
+type WriteParams = z.infer<typeof writeParameters>;
+/**
+ * Write tool definition
+ */
+declare const writeTool: Tool.Info<z.ZodObject<{
+    filePath: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    content: string;
+}, {
+    filePath: string;
+    content: string;
+}>, {
+    filepath: string;
+    created: boolean;
+    updated: boolean;
+    lines: number;
+}>;
+
+/**
+ * Grep tool - Search file contents
+ * Based on OpenCode's tool/grep.ts patterns
+ */
+
+declare const grepParameters: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    path?: string | undefined;
+    include?: string | undefined;
+}, {
+    pattern: string;
+    path?: string | undefined;
+    include?: string | undefined;
+}>;
+type GrepParams = z.infer<typeof grepParameters>;
+/**
+ * Execute grep search
+ */
+declare function executeGrep(params: GrepParams, host: ToolHost, cwd: string, abort?: AbortSignal): Promise<{
+    matches: Array<{
+        file: string;
+        line: number;
+        text: string;
+    }>;
+    truncated: boolean;
+}>;
+/**
+ * Grep tool definition
+ */
+declare const grepTool: Tool.Info<z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    path?: string | undefined;
+    include?: string | undefined;
+}, {
+    pattern: string;
+    path?: string | undefined;
+    include?: string | undefined;
+}>, {
+    matches: number;
+    truncated: boolean;
+}>;
+
+/**
+ * Glob tool - Find files by pattern
+ * Based on OpenCode's tool/glob.ts patterns
+ */
+
+declare const globParameters: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    path?: string | undefined;
+}, {
+    pattern: string;
+    path?: string | undefined;
+}>;
+type GlobParams = z.infer<typeof globParameters>;
+/**
+ * Glob tool definition
+ */
+declare const globTool: Tool.Info<z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    path?: string | undefined;
+}, {
+    pattern: string;
+    path?: string | undefined;
+}>, {
+    count: number;
+    truncated: boolean;
+}>;
+
+/**
+ * Default tool collections
+ */
+
+/**
+ * Default tools for a coding agent
+ */
+declare const defaultCodingTools: Tool.AnyInfo[];
+
+/**
+ * Tool composition and registry setup for @cuylabs/agent-code.
+ *
+ * Registers all coding tools into the default registry, defines standard
+ * groups, and provides a fluent `toolset()` builder for easy composition.
+ *
+ * @example
+ * ```typescript
+ * import { toolset, resolveTools } from "@cuylabs/agent-code";
+ *
+ * // Fluent builder
+ * const tools = toolset("read-only").add(myCustomTool).build();
+ *
+ * // Spec-based resolution
+ * const tools = resolveTools("all,-bash");
+ * const tools = resolveTools("read,grep,glob");
+ * const tools = resolveTools("safe");
+ * ```
+ */
+
+/**
+ * Register all coding tools and standard groups into the default registry.
+ * Uses `set()` (upsert) so it's safe to call multiple times, even after
+ * `clear()`.
+ */
+declare function setupToolRegistry(): void;
+/**
+ * Fluent tool composition builder.
+ *
+ * @example
+ * ```typescript
+ * // Start from a group and customize
+ * const tools = toolset("read-only").add(myTool).build();
+ *
+ * // Start from all and exclude
+ * const tools = toolset("all").remove("bash").build();
+ *
+ * // Start empty and pick
+ * const tools = toolset().add("read").add("grep").build();
+ * ```
+ */
+declare class ToolsetBuilder {
+    private tools;
+    constructor(base?: ToolSpec);
+    /** Add a tool by ID (from registry) or by instance. */
+    add(tool: string | Tool.AnyInfo): this;
+    /** Remove a tool by ID. */
+    remove(id: string): this;
+    /** Keep only the specified tool IDs (intersection). */
+    only(...ids: string[]): this;
+    /** Return the final tool array. */
+    build(): Tool.AnyInfo[];
+}
+/**
+ * Create a toolset builder with an optional base spec.
+ *
+ * @param base Starting point — group name, tool IDs, boolean, or array.
+ *             Defaults to empty (call `.add()` to populate).
+ *
+ * @example
+ * ```typescript
+ * // All tools except bash
+ * const tools = toolset("all").remove("bash").build();
+ *
+ * // Read-only with a custom tool
+ * const tools = toolset("read-only").add(mySearchTool).build();
+ * ```
+ */
+declare function toolset(base?: ToolSpec): ToolsetBuilder;
+/**
+ * Resolve a tool spec to an array of tools.
+ *
+ * Ensures the coding tool registry is initialized, then delegates to
+ * `defaultRegistry.resolve()`.
+ *
+ * @param spec Group name, comma-separated IDs, boolean, or array.
+ *
+ * @example
+ * ```typescript
+ * resolveTools("read-only");         // → [readTool, grepTool, globTool]
+ * resolveTools("all,-bash");         // → all except bash
+ * resolveTools("read,grep");         // → [readTool, grepTool]
+ * resolveTools(true);                // → all coding tools
+ * resolveTools(false);               // → []
+ * ```
+ */
+declare function resolveTools(spec: ToolSpec): Tool.AnyInfo[];
+
+export { type BashParams, type EditParams, type GlobParams, type GrepParams, type ReadParams, ToolsetBuilder, type WriteParams, bashParameters, bashTool, defaultCodingTools, editParameters, editTool, executeBash, executeGrep, globParameters, globTool, grepParameters, grepTool, readParameters, readTool, resolveTools, setupToolRegistry, toolset, writeParameters, writeTool };

package/dist/tools/index.js

@@ -0,0 +1,42 @@
+import {
+  ToolsetBuilder,
+  bashParameters,
+  bashTool,
+  defaultCodingTools,
+  editParameters,
+  editTool,
+  executeBash,
+  executeGrep,
+  globParameters,
+  globTool,
+  grepParameters,
+  grepTool,
+  readParameters,
+  readTool,
+  resolveTools,
+  setupToolRegistry,
+  toolset,
+  writeParameters,
+  writeTool
+} from "../chunk-IOXLKDEB.js";
+export {
+  ToolsetBuilder,
+  bashParameters,
+  bashTool,
+  defaultCodingTools,
+  editParameters,
+  editTool,
+  executeBash,
+  executeGrep,
+  globParameters,
+  globTool,
+  grepParameters,
+  grepTool,
+  readParameters,
+  readTool,
+  resolveTools,
+  setupToolRegistry,
+  toolset,
+  writeParameters,
+  writeTool
+};

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@cuylabs/agent-code",
+  "version": "0.1.0",
+  "description": "Embeddable AI coding agent built on @cuylabs/agent-core",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js",
+      "default": "./dist/tools/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/tools/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/tools/index.ts --format esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@cuylabs/agent-core": "workspace:*",
+    "ai": "^6.0.67",
+    "zod": "^3.24.0"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": "^3.0.0",
+    "@ai-sdk/google": "^1.0.0",
+    "@ai-sdk/openai": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.35",
+    "@ai-sdk/openai": "^3.0.25",
+    "@types/node": "^22.0.0",
+    "dotenv": "^17.2.3",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "llm",
+    "vercel-ai-sdk",
+    "embeddable",
+    "coding-agent"
+  ],
+  "author": "cuylabs",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cuylabs-ai/agents-ts.git",
+    "directory": "packages/agent-code"
+  }
+}