@botbotgo/kit-builtin 0.0.92

package/README.md

@@ -0,0 +1,82 @@
+# @botbotgo/kit-builtin
+
+## Introduction
+
+`@botbotgo/kit-builtin` is the built-in tool extension package for `@botbotgo/kit`. It exposes the extension entry required by the tool runtime and also exports iTerm helpers from the `./iterm` subpath.
+
+## API Reference
+
+| API | What it does | Minimal usage |
+| --- | --- | --- |
+| `register` | Register this extension into a tool registry. | `register(registry, { only: ["fs.readText"] })` |
+| `getExtensionContext` | Read the current extension context inside a tool. | `const ctx = getExtensionContext()` |
+| `runWithExtensionContext` | Run code with an injected extension context, mainly for tests. | `runWithExtensionContext(ctx, () => fn())` |
+| `@botbotgo/kit-builtin/iterm` | Re-export iTerm-related helpers and tool implementations. | `import * as iTermTools from "@botbotgo/kit-builtin/iterm"` |
+
+## Usage
+
+Use the package from `tool.yaml`:
+
+```yaml
+tools:
+  sandboxedPath: .
+  allowedHosts: []
+  blockedHosts: []
+  list:
+    - npm:@botbotgo/kit-builtin
+```
+
+Enable only specific tools:
+
+```yaml
+tools:
+  sandboxedPath: .
+  allowedHosts: [api.github.com]
+  blockedHosts: []
+  list:
+    - npm:@botbotgo/kit-builtin#fs.readText
+    - npm:@botbotgo/kit-builtin#fs.writeText
+    - npm:@botbotgo/kit-builtin#http.fetchJson
+```
+
+### YAML config
+
+This package ships an embedded `config/tool.yaml` with default settings for built-in tools. It is picked up automatically by `@botbotgo/kit` when this extension is loaded.
+
+Example:
+
+```yaml
+apiVersion: botbotgo.world/v1
+kind: ToolConfig
+metadata:
+  name: agent-tool-buildin-default
+spec:
+  tools:
+    sandboxedPath: .
+    enableSandboxValidation: false
+    allowedHosts: []
+    blockedHosts: []
+    defaults:
+      fs.readText:
+        maxBytes: 5242880
+      fs.listDir:
+        maxEntries: 2000
+        maxDepth: 5
+      http.fetchJson:
+        timeoutMs: 15000
+        maxBytes: 5242880
+        userAgent: "agent-tool-core/1.0"
+      exec.runCommand:
+        allowedCommands: [rg, sed, cat, ls]
+        maxOutputBytes: 1048576
+        timeoutMs: 10000
+```
+
+Explanation:
+
+- `enableSandboxValidation`: controls extra sandbox validation behavior.
+- `defaults`: per-tool default arguments merged at load time.
+- `fs.readText.maxBytes`: read limit for file content.
+- `fs.listDir.maxEntries` and `fs.listDir.maxDepth`: directory traversal limits.
+- `http.fetchJson.timeoutMs`: request timeout for HTTP JSON fetches.
+- `exec.runCommand.allowedCommands`: shell commands allowed by the built-in exec tool.

package/dist/agent-tool-extension-compat.d.ts

@@ -0,0 +1,5 @@
+export declare function createExtensionCompat(options: {
+    importMeta: ImportMeta;
+}): import("@botbotgo/kit/sdk").CreateExtensionResult<Record<string, unknown>, import("@botbotgo/kit/sdk").RegisterOptionsDefaultOnly>;
+export declare function generateManifestCompat(cwd: string): void;
+//# sourceMappingURL=agent-tool-extension-compat.d.ts.map

package/dist/agent-tool-extension-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool-extension-compat.d.ts","sourceRoot":"","sources":["../agent-tool-extension-compat.ts"],"names":[],"mappings":"AAKA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,sIAExE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExD"}

package/dist/agent-tool-extension-compat.js

@@ -0,0 +1,8 @@
+import { createExtension, generateManifest, } from "@botbotgo/kit/sdk";
+export function createExtensionCompat(options) {
+    return createExtension(options);
+}
+export function generateManifestCompat(cwd) {
+    generateManifest(cwd);
+}
+//# sourceMappingURL=agent-tool-extension-compat.js.map

package/dist/agent-tool-extension-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool-extension-compat.js","sourceRoot":"","sources":["../agent-tool-extension-compat.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,UAAU,qBAAqB,CAAC,OAAmC;IACvE,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,gBAAgB,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/config/tool.yaml

@@ -0,0 +1,162 @@
+apiVersion: botbotgo.world/v1
+kind: ToolConfig
+metadata:
+  name: agent-tool-buildin-default
+spec:
+  tools:
+    sandboxedPath: .
+    enableSandboxValidation: false
+    allowedHosts: []
+    blockedHosts: []
+
+    # Per-tool default configs. Override any of these via tool.override.yaml.
+    defaults:
+
+      # --- fs tools ---
+      fs.readText:
+        maxBytes: 5242880        # 5MB
+      fs.listDir:
+        maxEntries: 2000
+        maxDepth: 5
+      fs.searchText:
+        maxMatches: 100
+        maxFiles: 500
+      fs.writeText: {}
+      fs.deletePath: {}
+      fs.sha256: {}
+
+      # --- http tools ---
+      http.fetchText:
+        timeoutMs: 15000
+        maxBytes: 5242880        # 5MB
+        userAgent: "agent-tool-core/1.0"
+      http.fetchJson:
+        timeoutMs: 15000
+        maxBytes: 5242880
+        userAgent: "agent-tool-core/1.0"
+      http.downloadFile:
+        timeoutMs: 15000
+        maxBytes: 104857600      # 100MB
+        userAgent: "agent-tool-core/1.0"
+      http.fetchPageMainContent:
+        timeoutMs: 15000
+        maxBytes: 5242880
+        userAgent: "agent-tool-core/1.0"
+      http.head:
+        timeoutMs: 15000
+        userAgent: "agent-tool-core/1.0"
+      http.duckduckgoSearch:
+        timeoutMs: 15000
+        maxBytes: 5242880
+        userAgent: "agent-tool-core/1.0"
+      http.yahooFinance:
+        timeoutMs: 15000
+        maxBytes: 5242880
+        userAgent: "agent-tool-core/1.0"
+
+      # --- exec tools ---
+      exec.runCommand:
+        allowedCommands:
+          - awk
+          - cat
+          - cut
+          - echo
+          - env
+          - find
+          - grep
+          - head
+          - ls
+          - pwd
+          - rg
+          - sed
+          - sort
+          - tail
+          - tr
+          - uniq
+          - wc
+          - whoami
+          - xargs
+        maxOutputBytes: 1048576  # 1MB
+        timeoutMs: 10000
+
+      # --- git tools ---
+      git.gitStatus: {}
+      git.gitLog:
+        maxCount: 100
+        timeoutMs: 30000
+        maxOutputBytes: 2097152  # 2MB
+      git.gitDiff:
+        timeoutMs: 30000
+        maxOutputBytes: 2097152
+      git.gitAdd: {}
+      git.gitCommit: {}
+      git.gitShow:
+        timeoutMs: 30000
+        maxOutputBytes: 2097152
+      git.gitCommand:
+        allowedCommands:
+          - status
+          - log
+          - show
+          - diff
+          - branch
+          - rev-parse
+          - remote
+          - tag
+          - reflog
+          - blame
+          - ls-files
+          - grep
+          - shortlog
+          - describe
+          - ls-remote
+          - cat-file
+        timeoutMs: 30000
+        maxOutputBytes: 2097152
+      git.ghCommand:
+        allowedCommands:
+          - "repo view"
+          - "pr list"
+          - "pr view"
+          - "issue list"
+          - "issue view"
+          - "search prs"
+          - "search issues"
+          - "release list"
+          - "release view"
+          - "workflow list"
+          - "workflow view"
+          - "run list"
+          - "run view"
+        timeoutMs: 30000
+        maxOutputBytes: 2097152
+
+      # --- analyze tools ---
+      analyze.analyzeLog:
+        model: "gpt-4o-mini"
+        openaiBaseUrl: "https://api.openai.com/v1"
+        timeoutMs: 60000
+        chunkSize: 2000
+        chunkOverlap: 200
+      analyze.analyzeProjectRepo:
+        model: "gpt-4o-mini"
+        openaiBaseUrl: "https://api.openai.com/v1"
+        timeoutMs: 60000
+        chunkSize: 2000
+        chunkOverlap: 200
+        embeddingModel: "qwen3-embedding:0.6b"
+        embeddingBaseUrl: "http://localhost:11434/v1"
+        embeddingTimeoutMs: 30000
+      analyze.askProjectRepo:
+        model: "gpt-4o-mini"
+        openaiBaseUrl: "https://api.openai.com/v1"
+        timeoutMs: 60000
+        chunkSize: 2000
+        chunkOverlap: 200
+        embeddingModel: "qwen3-embedding:0.6b"
+        embeddingBaseUrl: "http://localhost:11434/v1"
+        embeddingTimeoutMs: 30000
+      analyze.embedText:
+        embeddingModel: "qwen3-embedding:0.6b"
+        embeddingBaseUrl: "http://localhost:11434/v1"
+        embeddingTimeoutMs: 30000