@termaxjs/web-ai 0.1.1

package/dist/tools/tools.d.ts

@@ -0,0 +1,236 @@
+export { resolvePath, type ToolContext } from "./context.js";
+export { buildFsTools } from "./fs.js";
+export { buildSearchTools } from "./search.js";
+/**
+ * AI tool definitions.
+ *
+ * Approval policy:
+ *  - Read-only tools (`read_file`, `list_directory`, `grep`, `glob`)
+ *    auto-execute, but go through the security guard which refuses obvious
+ *    secret paths (.env*, .ssh/, credentials, etc.).
+ *  - Mutating tools (`write_file`, `edit`, `multi_edit`, `create_directory`,
+ *    `run_command`) require explicit user approval — the AI SDK pauses on
+ *    tool-call and surfaces a `tool-approval-request` part that the UI
+ *    renders as a confirmation card.
+ *  - `edit` / `multi_edit` additionally enforce a read-before-edit invariant
+ *    (the model must have called read_file on the path earlier in the
+ *    session).
+ *
+ * The model sees absolute paths only after they are resolved against the
+ * active terminal's cwd (provided via `getCwd`); it should not invent paths
+ * outside that.
+ */
+export declare function buildTools(ctx: import("./context.js").ToolContext): {
+    readonly run_subagent: any;
+    readonly suggest_command: import("ai").Tool<{
+        command: string;
+        explanation?: string | undefined;
+    }, {
+        error: string;
+        command?: undefined;
+        explanation?: undefined;
+    } | {
+        command: string;
+        explanation: string | undefined;
+        error?: undefined;
+    }>;
+    readonly get_terminal_output: import("ai").Tool<{
+        lines?: number | undefined;
+    }, {
+        error: string;
+        output?: undefined;
+        note?: undefined;
+        lines_returned?: undefined;
+    } | {
+        output: string;
+        note: string;
+        error?: undefined;
+        lines_returned?: undefined;
+    } | {
+        output: string;
+        lines_returned: number;
+        error?: undefined;
+        note?: undefined;
+    }>;
+    readonly open_preview: import("ai").Tool<{
+        url: string;
+    }, {
+        error: string;
+        url: string;
+        ok?: undefined;
+    } | {
+        url: string;
+        ok: boolean;
+        error?: undefined;
+    }>;
+    readonly bash_run: import("ai").Tool<{
+        command: string;
+        timeout_secs?: number | undefined;
+    }, any>;
+    readonly grep: import("ai").Tool<{
+        pattern: string;
+        root?: string | undefined;
+        glob?: string[] | undefined;
+        case_insensitive?: boolean | undefined;
+        max_results?: number | undefined;
+    }, {
+        error: string;
+        root?: undefined;
+        hits?: undefined;
+        truncated?: undefined;
+        files_scanned?: undefined;
+    } | {
+        error: string;
+        root: string;
+        hits?: undefined;
+        truncated?: undefined;
+        files_scanned?: undefined;
+    } | {
+        root: string;
+        hits: any;
+        truncated: any;
+        files_scanned: any;
+        error?: undefined;
+    }>;
+    readonly glob: import("ai").Tool<{
+        pattern: string;
+        root?: string | undefined;
+        max_results?: number | undefined;
+    }, {
+        error: string;
+        root?: undefined;
+        hits?: undefined;
+        truncated?: undefined;
+    } | {
+        error: string;
+        root: string;
+        hits?: undefined;
+        truncated?: undefined;
+    } | {
+        root: string;
+        hits: any;
+        truncated: any;
+        error?: undefined;
+    }>;
+    readonly edit: import("ai").Tool<{
+        path: string;
+        old_string: string;
+        new_string: string;
+        replace_all?: boolean | undefined;
+    }, {
+        ok: true;
+        replacements: number;
+        bytesWritten: number;
+        path: string;
+    } | {
+        error: string;
+        path: string;
+    }>;
+    readonly multi_edit: import("ai").Tool<{
+        path: string;
+        edits: {
+            old_string: string;
+            new_string: string;
+            replace_all?: boolean | undefined;
+        }[];
+    }, {
+        ok: true;
+        replacements: number;
+        bytesWritten: number;
+        path: string;
+    } | {
+        error: string;
+        path: string;
+    }>;
+    readonly read_file: import("ai").Tool<{
+        path: string;
+        offset?: number | undefined;
+        limit?: number | undefined;
+    }, {
+        error: string;
+        path: string;
+        size?: undefined;
+        unchanged?: undefined;
+    } | {
+        error: string;
+        path: string;
+        size: any;
+        unchanged?: undefined;
+    } | {
+        path: string;
+        unchanged: boolean;
+        size: any;
+        error?: undefined;
+    } | {
+        truncated?: boolean | undefined;
+        hint?: string | undefined;
+        path: string;
+        content: any;
+        size: any;
+        total_lines: any;
+        error?: undefined;
+        unchanged?: undefined;
+    } | {
+        truncated?: boolean | undefined;
+        path: string;
+        content: any;
+        size: any;
+        total_lines: any;
+        start_line: number;
+        end_line: number;
+        error?: undefined;
+        unchanged?: undefined;
+    }>;
+    readonly list_directory: import("ai").Tool<{
+        path: string;
+    }, {
+        error: string;
+        path: string;
+        entries?: undefined;
+    } | {
+        path: string;
+        entries: any;
+        error?: undefined;
+    }>;
+    readonly write_file: import("ai").Tool<{
+        path: string;
+        content: string;
+    }, {
+        error: string;
+        path: string;
+        queued_for_plan_review?: undefined;
+        ok?: undefined;
+        bytesWritten?: undefined;
+    } | {
+        path: string;
+        queued_for_plan_review: boolean;
+        ok: boolean;
+        error?: undefined;
+        bytesWritten?: undefined;
+    } | {
+        path: string;
+        bytesWritten: number;
+        ok: boolean;
+        error?: undefined;
+        queued_for_plan_review?: undefined;
+    }>;
+    readonly create_directory: import("ai").Tool<{
+        path: string;
+    }, {
+        error: string;
+        path: string;
+        queued_for_plan_review?: undefined;
+        ok?: undefined;
+    } | {
+        path: string;
+        queued_for_plan_review: boolean;
+        ok: boolean;
+        error?: undefined;
+    } | {
+        path: string;
+        ok: boolean;
+        error?: undefined;
+        queued_for_plan_review?: undefined;
+    }>;
+};
+export type ChatTools = ReturnType<typeof buildTools>;

package/dist/tools/tools.js

@@ -0,0 +1,42 @@
+import { buildManagedAgentTools } from "./agent.js";
+import { buildEditTools } from "./edit.js";
+import { buildFsTools } from "./fs.js";
+import { buildSearchTools } from "./search.js";
+import { buildShellTools } from "./shell.js";
+import { buildSubagentTools } from "./subagent.js";
+import { buildTerminalTools } from "./terminal.js";
+import { buildTodoTools } from "./todo.js";
+export { resolvePath } from "./context.js";
+export { buildFsTools } from "./fs.js";
+export { buildSearchTools } from "./search.js";
+/**
+ * AI tool definitions.
+ *
+ * Approval policy:
+ *  - Read-only tools (`read_file`, `list_directory`, `grep`, `glob`)
+ *    auto-execute, but go through the security guard which refuses obvious
+ *    secret paths (.env*, .ssh/, credentials, etc.).
+ *  - Mutating tools (`write_file`, `edit`, `multi_edit`, `create_directory`,
+ *    `run_command`) require explicit user approval — the AI SDK pauses on
+ *    tool-call and surfaces a `tool-approval-request` part that the UI
+ *    renders as a confirmation card.
+ *  - `edit` / `multi_edit` additionally enforce a read-before-edit invariant
+ *    (the model must have called read_file on the path earlier in the
+ *    session).
+ *
+ * The model sees absolute paths only after they are resolved against the
+ * active terminal's cwd (provided via `getCwd`); it should not invent paths
+ * outside that.
+ */
+export function buildTools(ctx) {
+    return {
+        ...buildFsTools(ctx),
+        ...buildEditTools(ctx),
+        ...buildSearchTools(ctx),
+        ...buildShellTools(ctx),
+        ...buildSubagentTools(ctx),
+        ...buildTerminalTools(ctx),
+        ...buildTodoTools(ctx),
+        ...buildManagedAgentTools(ctx),
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+export interface AiAdapter {
+    getKey: (providerId: string) => Promise<string | null>;
+    native: any;
+    isPlanActive: () => boolean;
+    enqueuePlanEdit: (edit: any) => void;
+    getWorkspaceEnv: () => Promise<Record<string, string>>;
+    getWorkspaceScopeKey: () => Promise<string>;
+    writeToTerminalSession: (sessionId: string, data: string) => void;
+    spawnManagedAgent: (opts: any) => Promise<any>;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@termaxjs/web-ai",
+  "version": "0.1.1",
+  "description": "Headless AI engine for Termax",
+  "main": "./dist/index.js",
+  "module": "./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/tools.d.ts",
+      "import": "./dist/tools/tools.js",
+      "default": "./dist/tools/tools.js"
+    }
+  },
+  "peerDependencies": {
+    "zustand": "^5.0.0"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.81",
+    "@ai-sdk/cerebras": "^2.0.54",
+    "@ai-sdk/google": "^3.0.80",
+    "@ai-sdk/groq": "^3.0.39",
+    "@ai-sdk/openai": "^3.0.67",
+    "ai": "^6.0.196",
+    "zod": "^4.4.3"
+  },
+  "type": "module",
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.5"
+  },
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}