@datagusto/cli 0.0.0-stage → 0.1.0

package/vendor/claude_code/dist/monitoring.js

@@ -0,0 +1,66 @@
+// ---------------------------------------------------------------------------
+// Datagusto Safety Plugin - Monitoring-mode resolution
+// ---------------------------------------------------------------------------
+//
+// Two independent switches can turn enforcement off:
+//
+//   - the plugin's own `monitorOnly` config (a local staging-rollout knob), and
+//   - the platform's per-agent monitoring mode, surfaced by the server as
+//     `monitoring_mode_enabled` on /sessions/alignment and /sessions/validate
+//     responses.
+//
+// Either one being true means a verdict (deny / ask / block / inject) is
+// logged but not enforced. The platform value is resolved per request:
+// the validate response of the current call wins, then the value most
+// recently reported by any alignment / validate response for this session
+// (kept in session state), then false — older servers that omit the field
+// behave as before.
+//
+// The platform value never changes fail-closed handling of API errors: the
+// server's monitoring mode only says whether *verdicts* are enforced, and
+// an errored request carries no verdict (and no flag) to begin with.
+/**
+ * Read `monitoring_mode_enabled` from an API response body. Returns undefined
+ * when the field is absent or not a boolean so callers can fall back to the
+ * value cached in session state.
+ */
+export function readMonitoringFlag(data) {
+    if (data && typeof data === "object") {
+        const v = data.monitoring_mode_enabled;
+        if (typeof v === "boolean")
+            return v;
+    }
+    return undefined;
+}
+/**
+ * Combine the plugin's `monitorOnly` config with the platform's monitoring
+ * mode. `responseFlag` is the value from the current request's response (or
+ * undefined when that response has none), `stateFlag` the value cached from
+ * alignment (null when never seen).
+ */
+export function resolveMonitoring(pluginMonitorOnly, responseFlag, stateFlag) {
+    const platformEnabled = typeof responseFlag === "boolean" ? responseFlag : stateFlag === true;
+    const plugin = pluginMonitorOnly === true;
+    let source;
+    if (plugin && platformEnabled)
+        source = "plugin+platform";
+    else if (plugin)
+        source = "plugin";
+    else if (platformEnabled)
+        source = "platform";
+    return { active: plugin || platformEnabled, source, platformEnabled };
+}
+/** Human-readable label for log lines, e.g. "platform monitoring mode". */
+export function describeMonitoring(decision) {
+    switch (decision.source) {
+        case "plugin":
+            return "plugin monitorOnly";
+        case "platform":
+            return "platform monitoring mode";
+        case "plugin+platform":
+            return "plugin monitorOnly + platform monitoring mode";
+        default:
+            return "enforcing";
+    }
+}
+//# sourceMappingURL=monitoring.js.map

package/vendor/claude_code/dist/state.js

@@ -0,0 +1,71 @@
+// ---------------------------------------------------------------------------
+// Datagusto Safety Plugin - Persisted Per-Session State
+// ---------------------------------------------------------------------------
+//
+// OpenClaw's plugin keeps state in memory inside one long-running process
+// and has to detect session boundaries itself (see the OpenClaw plugin's
+// `onNewTurn`). Claude Code hooks are the opposite: every invocation is a
+// brand-new process that exits after handling one event, but each payload
+// already carries a stable `session_id` for the lifetime of the
+// conversation. So instead of an in-memory class with manual session-change
+// detection, state is a small JSON blob on disk, namespaced by that
+// session_id — no reset hook is needed because a new session simply reads
+// and writes its own file.
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const EMPTY_STATE = {
+    sessionId: null,
+    registeredToolsHash: null,
+    lastUserInstructionHash: null,
+    lastPreToolUseCheck: null,
+    monitoringModeEnabled: null,
+    monitoringNoticeShown: false,
+};
+const STATE_DIR = join(tmpdir(), "datagusto-safety-plugin");
+function statePath(claudeSessionId) {
+    return join(STATE_DIR, `${claudeSessionId}.json`);
+}
+/** Load this Claude Code session's state, or an empty one if none exists yet. */
+export function loadState(claudeSessionId) {
+    try {
+        const raw = readFileSync(statePath(claudeSessionId), "utf8");
+        return { ...EMPTY_STATE, ...JSON.parse(raw) };
+    }
+    catch {
+        return { ...EMPTY_STATE };
+    }
+}
+/** Persist this Claude Code session's state for the next hook invocation. */
+export function saveState(claudeSessionId, state) {
+    mkdirSync(STATE_DIR, { recursive: true });
+    writeFileSync(statePath(claudeSessionId), JSON.stringify(state), "utf8");
+}
+/**
+ * Re-read the state file, apply `mutate` to the fresh copy, and write it back.
+ *
+ * Claude Code can run several hook processes for one session concurrently
+ * (parallel tool calls), and each handler awaits HTTP round-trips between
+ * its initial loadState() and any save. Writing back that stale snapshot
+ * would clobber fields another process persisted in the meantime, so
+ * handlers that only need to update a few fields after their awaits use
+ * this instead of saveState(). The read-modify-write is still unlocked —
+ * the window is the microseconds between the read and the write rather
+ * than the whole HTTP round-trip — which is adequate for these hints.
+ */
+export function mutateState(claudeSessionId, mutate) {
+    const fresh = loadState(claudeSessionId);
+    mutate(fresh);
+    saveState(claudeSessionId, fresh);
+    return fresh;
+}
+/** Remove this Claude Code session's state file (called from SessionEnd). */
+export function deleteState(claudeSessionId) {
+    try {
+        rmSync(statePath(claudeSessionId), { force: true });
+    }
+    catch {
+        // Best-effort cleanup — a failure here should never block SessionEnd.
+    }
+}
+//# sourceMappingURL=state.js.map

package/vendor/claude_code/dist/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Datagusto Safety Plugin - Type Definitions
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/vendor/claude_code/hooks/hooks.json

@@ -0,0 +1,25 @@
+{
+  "hooks": {
+    "SessionStart": [
+      { "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/index.js\"" }] }
+    ],
+    "SessionEnd": [
+      { "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/index.js\"" }] }
+    ],
+    "UserPromptSubmit": [
+      { "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/index.js\"" }] }
+    ],
+    "PreToolUse": [
+      { "matcher": "*", "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/index.js\"" }] }
+    ],
+    "PermissionRequest": [
+      { "matcher": "*", "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/index.js\"" }] }
+    ],
+    "PostToolUse": [
+      { "matcher": "*", "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/index.js\"" }] }
+    ],
+    "PostToolUseFailure": [
+      { "matcher": "*", "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/index.js\"" }] }
+    ]
+  }
+}

package/vendor/claude_code/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "datagusto-safety-plugin",
+  "version": "1.0.0",
+  "description": "Datagusto safety validation plugin for Claude Code",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && node --test tests/*.test.mjs"
+  },
+  "files": [
+    "dist/",
+    "src/",
+    ".claude-plugin/",
+    "hooks/",
+    "README.md"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^6.0.3"
+  }
+}

package/vendor/kiro/.kiro/agents/kiro_default.json

@@ -0,0 +1,20 @@
+{
+  "name": "kiro_default",
+  "description": "Kiro's default agent with the Datagusto safety hooks",
+  "tools": ["*"],
+  "allowedTools": [],
+  "resources": [
+    "file://AmazonQ.md",
+    "file://AGENTS.md",
+    "file://README.md",
+    "skill://.kiro/skills/*/SKILL.md"
+  ],
+  "includeMcpJson": true,
+  "hooks": {
+    "agentSpawn": [{ "command": "node dist/index.js", "description": "Datagusto safety", "timeout_ms": 30000 }],
+    "userPromptSubmit": [{ "command": "node dist/index.js", "description": "Datagusto safety", "timeout_ms": 30000 }],
+    "preToolUse": [{ "command": "node dist/index.js", "description": "Datagusto safety", "timeout_ms": 30000 }],
+    "postToolUse": [{ "command": "node dist/index.js", "description": "Datagusto safety", "timeout_ms": 30000 }],
+    "stop": [{ "command": "node dist/index.js", "description": "Datagusto safety", "timeout_ms": 30000 }]
+  }
+}

package/vendor/kiro/.kiro/hooks/datagusto-post-tool-use.json

@@ -0,0 +1,10 @@
+{
+  "version": "v1",
+  "hooks": [{
+    "name": "datagusto-post-tool-use",
+    "trigger": "PostToolUse",
+    "action": { "type": "command", "command": "node dist/index.js" },
+    "timeout": 30,
+    "enabled": true
+  }]
+}

package/vendor/kiro/.kiro/hooks/datagusto-pre-tool-use.json

@@ -0,0 +1,10 @@
+{
+  "version": "v1",
+  "hooks": [{
+    "name": "datagusto-pre-tool-use",
+    "trigger": "PreToolUse",
+    "action": { "type": "command", "command": "node dist/index.js" },
+    "timeout": 30,
+    "enabled": true
+  }]
+}

package/vendor/kiro/.kiro/hooks/datagusto-session-start.json

@@ -0,0 +1,10 @@
+{
+  "version": "v1",
+  "hooks": [{
+    "name": "datagusto-session-start",
+    "trigger": "SessionStart",
+    "action": { "type": "command", "command": "node dist/index.js" },
+    "timeout": 30,
+    "enabled": true
+  }]
+}

package/vendor/kiro/.kiro/hooks/datagusto-stop.json

@@ -0,0 +1,10 @@
+{
+  "version": "v1",
+  "hooks": [{
+    "name": "datagusto-stop",
+    "trigger": "Stop",
+    "action": { "type": "command", "command": "node dist/index.js" },
+    "timeout": 30,
+    "enabled": true
+  }]
+}

package/vendor/kiro/.kiro/hooks/datagusto-user-prompt-submit.json

@@ -0,0 +1,10 @@
+{
+  "version": "v1",
+  "hooks": [{
+    "name": "datagusto-user-prompt-submit",
+    "trigger": "UserPromptSubmit",
+    "action": { "type": "command", "command": "node dist/index.js" },
+    "timeout": 30,
+    "enabled": true
+  }]
+}

package/vendor/kiro/dist/api-client.js

@@ -0,0 +1,82 @@
+// ---------------------------------------------------------------------------
+// Datagusto Safety Plugin - HTTP API Client
+// ---------------------------------------------------------------------------
+const TOOLS_REGISTER_PATH = "/api/v1/public/safety/tools/register";
+const SESSIONS_ALIGNMENT_PATH = "/api/v1/public/safety/sessions/alignment";
+const SESSIONS_VALIDATE_PATH = "/api/v1/public/safety/sessions/validate";
+const GUARDRAILS_EVALUATE_PATH = "/api/v1/public/guardrails/evaluate";
+export class DatagustoApiClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    constructor(baseUrl, apiKey, timeoutMs = 30_000) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.apiKey = apiKey;
+        this.timeoutMs = timeoutMs;
+    }
+    // -- Public API methods ---------------------------------------------------
+    async registerTools(tools) {
+        const body = { tools };
+        return this._post(TOOLS_REGISTER_PATH, body);
+    }
+    async postAlignment(userInstruction, sessionId, agentType) {
+        const body = { user_instruction: userInstruction };
+        if (sessionId) {
+            body.session_id = sessionId;
+        }
+        if (agentType) {
+            body.agent_type = agentType;
+        }
+        return this._post(SESSIONS_ALIGNMENT_PATH, body);
+    }
+    async postValidate(payload) {
+        return this._post(SESSIONS_VALIDATE_PATH, payload);
+    }
+    /**
+     * Evaluate the agent's assigned (dashboard-authored) guardrail rules for a
+     * single tool call. Agent-scoped via the API key — needs no session_id — and
+     * is the only path that evaluates assigned rules and on_end timing. Called
+     * alongside postValidate and merged (block-wins) by the hook handlers.
+     */
+    async evaluateGuardrails(payload) {
+        return this._post(GUARDRAILS_EVALUATE_PATH, payload);
+    }
+    // -- Internal helper ------------------------------------------------------
+    async _post(endpoint, body) {
+        const url = this.baseUrl + endpoint;
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            const text = await response.text();
+            let data = null;
+            try {
+                data = text ? JSON.parse(text) : null;
+            }
+            catch {
+                // Non-JSON response — leave data as null
+            }
+            return {
+                ok: response.ok,
+                status: response.status,
+                data,
+                ...(response.ok ? {} : { error: text }),
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                status: null,
+                data: null,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/vendor/kiro/dist/builtin-tools.generated.js

@@ -0,0 +1,87 @@
+// GENERATED by scripts/generate-builtin-tools.mjs — do not edit by hand.
+// Sources:
+//   V1      tool index embedded in the Kiro CLI binary (kiro-cli-chat 2.27.1)
+//   V2, V3  tool calls observed in hook payloads (scripts/observed-tool-inputs.json,
+//           Kiro CLI 2.27.1)
+// Tool counts: V1 18, V2 15, V3 18
+//
+// One catalog per Kiro agent engine. Tool ids are the names that engine sends
+// as `tool_name` in hook payloads, so the same capability has a different id
+// per engine (read a file: `fs_read` on V1, `read` on V2, `read_file` on V3),
+// and two ids (`fs_write`, `execute_bash`) mean different things on V1 and
+// V3. MCP tools are dynamic per-installation and intentionally excluded.
+/** V1 engine (the setting `chat.agentEngine` = "v1", or `--agent-engine v1` per Kiro's help text). */
+export const BUILTIN_TOOLS_V1 = [
+    { "id": "fs_read", "description": "Read files, directories, and images", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "operations": { "type": "array", "description": "Array of operations to execute. Provide one element for single operation, multiple for batch.", "items": { "type": "object", "properties": { "mode": { "type": "string", "enum": ["Line", "Directory", "Search", "Image"], "description": "The operation mode to run in: `Line`, `Directory`, `Search`. `Line` and `Search` are only for text files, and `Directory` is only for directories. `Image` is for image files, in this mode `image_paths` is required." }, "path": { "type": "string", "description": "Path to the file or directory. The path should be absolute, or otherwise start with ~ for the user's home (required for Line, Directory, Search modes)." }, "image_paths": { "type": "array", "items": { "type": "string" }, "description": "List of paths to the images. This is currently supported by the Image mode." }, "start_line": { "type": "integer", "description": "Starting line number (optional, for Line mode). A negative index represents a line number starting from the end of the file.", "default": 1 }, "end_line": { "type": "integer", "description": "Ending line number (optional, for Line mode). A negative index represents a line number starting from the end of the file.", "default": -1 }, "pattern": { "type": "string", "description": "Pattern to search for (required, for Search mode). Case insensitive. The pattern matching is performed per line." }, "context_lines": { "type": "integer", "description": "Number of context lines around search results (optional, for Search mode)", "default": 2 }, "depth": { "type": "integer", "description": "Depth of a recursive directory listing (optional, for Directory mode)", "default": 0 }, "exclude_patterns": { "type": "array", "items": { "type": "string" }, "description": "Glob patterns to exclude from directory listing (optional, for Directory mode). If omitted, uses defaults. If empty array [] is provided, no exclusions are applied (shows everything). If patterns are provided, they completely override the defaults. Examples: '**/target/**', '*.log'", "default": ["node_modules", ".git", "dist", "build", "out", ".cache", "target"] }, "max_entries": { "type": "integer", "description": "Maximum number of entries to return (optional, for Directory mode). When limit is reached, results are truncated and metadata shows 'showing X of Y entries'. Use to prevent context window overflow. Default: 1000", "default": 1000 }, "offset": { "type": "integer", "description": "Number of entries to skip for pagination (optional, for Directory mode). Use with max_entries to iterate through large directories. Entries are sorted by last modified time (most recent first). Default: 0", "default": 0 } }, "required": ["mode"] }, "minItems": 1 }, "summary": { "type": "string", "description": "Optional description of the purpose of this batch operation (mainly useful for multiple operations)" } }, "required": ["operations"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "fs_write", "description": "Create and modify files", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "command": { "type": "string", "enum": ["create", "str_replace", "insert", "append"], "description": "The commands to run. Allowed options are: `create`, `str_replace`, `insert`, `append`." }, "file_text": { "description": "Required parameter of `create` command, with the content of the file to be created.", "type": "string" }, "insert_line": { "description": "Required parameter of `insert` command. The `new_str` will be inserted AFTER the line `insert_line` of `path`.", "type": "integer" }, "new_str": { "description": "Required parameter of `str_replace` command containing the new string. Required parameter of `insert` command containing the string to insert. Required parameter of `append` command containing the content to append to the file.", "type": "string" }, "old_str": { "description": "Required parameter of `str_replace` command containing the string in `path` to replace.", "type": "string" }, "path": { "description": "Absolute path to file or directory, e.g. `/repo/file.py` or `/repo`.", "type": "string" }, "summary": { "description": "A brief explanation of what the file change does or why it's being made.", "type": "string" } }, "required": ["command", "path"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "glob", "description": "Find files and directories matching glob patterns", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "pattern": { "type": "string", "description": "Glob pattern, e.g. '**/*.rs', 'src/**/*.{ts,tsx}' or '**/test*'." }, "path": { "type": "string", "description": "Root directory to search from. Only set this when the user explicitly mentions a directory path. In all other cases, omit this so the tool searches from the current working directory (the project root)." }, "limit": { "type": "integer", "description": "Maximum files to return. If totalFiles exceeds this, truncated will be true." }, "max_depth": { "type": "integer", "description": "Maximum directory depth to traverse. Increase for deep nested structures." } }, "required": ["pattern"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "grep", "description": "Search file contents with a regex", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "pattern": { "type": "string", "description": "Regex pattern to search for. Examples: 'fn main', 'class.*Component', 'TODO|FIXME'. Start with simple patterns first (e.g. just the word you're looking for), then refine if needed." }, "path": { "type": "string", "description": "Directory to search from. Defaults to current working directory." }, "include": { "type": "string", "description": "File filter glob. Examples: '*.rs', '*.{ts,tsx}', '*.py'" }, "case_sensitive": { "type": "boolean", "description": "Case-sensitive search. Defaults to false (case-insensitive)." }, "output_mode": { "type": "string", "enum": ["content", "files_with_matches", "count"], "description": "Output format: 'content' returns matches as 'file:line:content' (default, best for seeing actual matches), 'files_with_matches' returns only file paths, 'count' returns match counts per file." }, "max_matches_per_file": { "type": "integer", "description": "Max matches returned per file (output limit). Increase to see all occurrences in a file." }, "max_files": { "type": "integer", "description": "Max number of files returned (output limit). Increase for comprehensive codebase searches." }, "max_total_lines": { "type": "integer", "description": "Max total matched lines returned across all files (output limit). Increase when searching for many occurrences." }, "max_depth": { "type": "integer", "description": "Max directory depth to traverse when searching (search limit). Increase for deeply nested structures." } }, "required": ["pattern"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "execute_bash", "description": "Execute a shell command", "sectionId": "runtime", "sectionLabel": "Shell", "inputSchema": { "type": "object", "properties": { "command": { "type": "string", "description": "Bash command to execute" }, "summary": { "type": "string", "description": "A brief explanation of what the command does" }, "working_dir": { "type": "string", "description": "Working directory for command execution. Supports tilde expansion (e.g., ~/projects). If not specified, uses the current working directory." } }, "required": ["command"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "use_aws", "description": "Make AWS CLI API calls", "sectionId": "aws", "sectionLabel": "AWS", "inputSchema": { "type": "object", "properties": { "service_name": { "type": "string", "pattern": "^[^-].*", "description": "The name of the AWS service. If you want to query s3, you should use s3api if possible. Must not start with a dash (-)." }, "operation_name": { "type": "string", "description": "The name of the operation to perform." }, "positional_args": { "type": "array", "items": { "type": "string" }, "description": "Positional arguments for high-level commands (e.g., s3 cp, s3 mv, s3 sync, s3 rm). These are passed directly without -- prefix. Use this for source/destination paths in S3 commands." }, "parameters": { "type": "object", "description": "The parameters for the operation. The parameter keys MUST conform to the AWS CLI specification. You should prefer to use JSON Syntax over shorthand syntax wherever possible. For parameters that are booleans, prioritize using flags with no value. Denote these flags with flag names as key and an empty string as their value. You should also prefer kebab case." }, "region": { "type": "string", "description": "Region name for calling the operation on AWS." }, "profile_name": { "type": "string", "description": "Optional: AWS profile name to use from ~/.aws/credentials. Defaults to default profile if not specified." }, "label": { "type": "string", "description": "Human readable description of the api that is being called." } }, "required": ["region", "service_name", "operation_name", "label"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "web_search", "description": "Search the web", "sectionId": "web", "sectionLabel": "Web", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "maxLength": 200, "description": "Search query (max 200 chars) - use concise keywords, not full sentences" } }, "required": ["query"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "web_fetch", "description": "Fetch and extract content from a URL", "sectionId": "web", "sectionLabel": "Web", "inputSchema": { "type": "object", "properties": { "url": { "type": "string", "description": "URL to fetch content from" }, "mode": { "type": "string", "enum": ["selective", "truncated", "full"], "description": "Extraction mode: 'selective' for smart extraction (default), 'truncated' for first 8000 chars, 'full' for complete content" }, "search_terms": { "type": "string", "description": "Optional: Keywords to find in selective mode (e.g., 'pricing cost', 'installation setup'). Returns ~10 lines before and after matches. If not provided, returns beginning of page." } }, "required": ["url"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "delegate", "description": "Launch and manage background agent processes", "sectionId": "agents", "sectionLabel": "Agents", "inputSchema": { "type": "object", "properties": { "operation": { "description": "Operation to perform: launch, status, or list", "$ref": "#/$defs/Operation" }, "agent": { "description": "Agent name to use (optional - uses \"q_cli_default\" if not specified)", "type": ["string", "null"], "default": null }, "task": { "description": "Task description (required for launch operation). This process is supposed to be async. DO NOT query immediately after launching a task.", "type": ["string", "null"], "default": null } }, "required": ["operation"], "$defs": { "Operation": { "oneOf": [{ "description": "Launch a new agent with a specified task", "type": "string", "const": "launch" }, { "description": "Check the status of a specific agent or all agents if None is provided", "type": "object", "properties": { "status": { "type": ["string", "null"] } }, "required": ["status"], "additionalProperties": false }, { "description": "List all available agents", "type": "string", "const": "list" }] } } }, "inputSchemaSource": "kiro-cli" },
+    { "id": "use_subagent", "description": "Delegate tasks to subagents running in parallel", "sectionId": "agents", "sectionLabel": "Agents", "inputSchema": { "type": "object", "properties": { "command": { "type": "string", "enum": ["ListAgents", "InvokeSubagents"], "description": "The commands to run. Allowed options are `ListAgents` to query available agents, or `InvokeSubagents` to invoke one or more subagents" }, "content": { "description": "Required for `InvokeSubagents` command. Contains subagents array and optional conversation ID.", "type": "object", "properties": { "subagents": { "type": "array", "description": "Array of subagent invocations to execute in parallel. Each invocation specifies a query, optional agent name, and optional context.", "items": { "type": "object", "properties": { "query": { "type": "string", "description": "The query or task to be handled by the subagent" }, "agent_name": { "type": "string", "description": "Optional name of the specific agent to use. If not provided, uses the default agent" }, "relevant_context": { "type": "string", "description": "Optional additional context that should be provided to the subagent to help it understand the task better" } }, "required": ["query"] } } }, "required": ["subagents"] } }, "required": ["command"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "todo_list", "description": "Create and manage TODO lists for multi-step tasks", "sectionId": "workflow", "sectionLabel": "Workflow", "inputSchema": { "type": "object", "properties": { "command": { "type": "string", "enum": ["create", "complete", "load", "add", "remove", "lookup"], "description": "The command to run. Allowed options are `create`, `complete`, `load`, `add`, `remove`, and `lookup`. Call `lookup` without arguments to see a list of all existing TODO list IDs." }, "tasks": { "description": "Required parameter of `create` command containing the list of DISTINCT tasks to be added to the TODO list.", "type": "array", "items": { "type": "object", "properties": { "task_description": { "type": "string", "description": "The main task description" }, "details": { "type": "string", "description": "Optional detailed information about the task" } }, "required": ["task_description"] } }, "todo_list_description": { "description": "Required parameter of `create` command containing a BRIEF summary of the todo list being created. The summary should be detailed enough to refer to without knowing the problem context beforehand.", "type": "string" }, "completed_indices": { "description": "Required parameter of `complete` command containing the 0-INDEXED numbers of EVERY completed task. Each task should be marked as completed IMMEDIATELY after it is finished.", "type": "array", "items": { "type": "integer" } }, "context_update": { "description": "Required parameter of `complete` command containing important task context. Use this command to track important information about the task AND information about files you have read.", "type": "string" }, "modified_files": { "description": "Optional parameter of `complete` command containing a list of paths of files that were modified during the task. This is useful for tracking file changes that are important to the task.", "type": "array", "items": { "type": "string" } }, "load_id": { "description": "Required parameter of `load` command containing ID of todo list to load", "type": "string" }, "current_id": { "description": "Required parameter of `complete`, `add`, and `remove` commands containing the ID of the currently loaded todo list. The ID will ALWAYS be provided after every `todo_list` call after the serialized todo list state.", "type": "string" }, "new_tasks": { "description": "Required parameter of `add` command containing a list of new tasks to be added to the to-do list.", "type": "array", "items": { "type": "object", "properties": { "task_description": { "type": "string", "description": "The main task description" }, "details": { "type": "string", "description": "Optional detailed information about the task" } }, "required": ["task_description"] } }, "insert_indices": { "description": "Required parameter of `add` command containing a list of 0-INDEXED positions to insert the new tasks. There MUST be an index for every new task being added.", "type": "array", "items": { "type": "integer" } }, "new_description": { "description": "Optional parameter of `add` and `remove` containing a new todo list description. Use this when the updated set of tasks significantly change the goal or overall procedure of the todo list.", "type": "string" }, "remove_indices": { "description": "Required parameter of `remove` command containing a list of 0-INDEXED positions of tasks to remove.", "type": "array", "items": { "type": "integer" } } }, "required": ["command"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "thinking", "description": "Internal reasoning for complex problems", "sectionId": "workflow", "sectionLabel": "Workflow", "inputSchema": { "type": "object", "properties": { "thought": { "type": "string", "description": "A reflective note or intermediate reasoning step such as \"The user needs to prepare their application for production. I need to complete three major asks including 1: building their code from source, 2: bundling their release artifacts together, and 3: signing the application bundle." } }, "required": ["thought"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "switch_to_execution", "description": "Switch from planning to execution mode", "sectionId": "workflow", "sectionLabel": "Workflow", "inputSchema": { "type": "object", "properties": { "plan": { "type": "string", "description": "The generated implementation plan" } }, "required": ["plan"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "introspect", "description": "Answer questions about Kiro CLI capabilities and documentation", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "description": "The user's question about this assistant's usage, features, or capabilities" }, "doc_path": { "type": "string", "description": "Path to a specific doc to retrieve (e.g., \"features/tangent-mode.md\"). Use this to get full content of a doc from the index." } }, "required": [] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "knowledge", "description": "Store and retrieve information across chat sessions", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "command": { "type": "string", "enum": ["show", "add", "remove", "clear", "search", "update", "status", "cancel"], "description": "The knowledge operation to perform:\n- 'show': List all knowledge contexts (no additional parameters required)\n- 'add': Add content to knowledge base (requires 'name' and 'value')\n- 'remove': Remove content from knowledge base (requires one of: 'name', 'context_id', or 'path')\n- 'clear': Remove all knowledge contexts.\n- 'search': Search across knowledge contexts (requires 'query', optional: 'context_id', 'limit', 'offset', 'snippet_length', 'sort_by', 'file_type')\n- 'update': Update existing context with new content (requires 'path' and one of: 'name', 'context_id')\n- 'status': Show background operation status and progress\n- 'cancel': Cancel background operations (optional 'operation_id' to cancel specific operation, or cancel all if not provided)" }, "name": { "type": "string", "description": "A descriptive name for the knowledge context. Required for 'add' operations. Can be used for 'remove' and 'update' operations to identify the context." }, "value": { "type": "string", "description": "The content to store in knowledge base. Required for 'add' operations. Can be either text content or a file/directory path. If it's a valid file or directory path, the content will be indexed; otherwise it's treated as text." }, "context_id": { "type": "string", "description": "The unique context identifier for targeted operations. Can be obtained from 'show' command. Used for 'remove', 'update', and 'search' operations to specify which context to operate on." }, "path": { "type": "string", "description": "File or directory path. Used in 'remove' operations to remove contexts by their source path, and required for 'update' operations to specify the new content location." }, "query": { "type": "string", "description": "The search query string. Required for 'search' operations. Performs semantic search across knowledge contexts to find relevant content." }, "limit": { "type": "integer", "description": "Maximum number of search results to return, use default value unless required more results or focused search. Optional for 'search' operations." }, "offset": { "type": "integer", "description": "Number of results to skip for pagination. Optional for 'search' operations." }, "snippet_length": { "type": "integer", "description": "Maximum character length for text snippets in results. Text longer than this will be truncated. Optional for 'search' operations." }, "sort_by": { "type": "string", "enum": ["relevance", "path", "name"], "description": "Sort order for search results. Options: 'relevance' (default, by similarity score), 'path' or 'name' (alphabetically by file path). Optional for 'search' operations." }, "file_type": { "type": "string", "description": "Filter results by file type (e.g., 'Code', 'Markdown', 'Text'). Optional for 'search' operations." }, "operation_id": { "type": "string", "description": "Optional operation ID to cancel a specific operation. Used with 'cancel' command. If not provided, all active operations will be cancelled. Can be either the full operation ID or the short 8-character ID." } }, "required": ["command"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "session", "description": "Adjust session settings temporarily", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "operation": { "type": "string", "enum": ["list", "get", "set", "reset"], "description": "The operation to perform: 'list' shows configured settings, 'get' retrieves a specific setting, 'set' changes a setting value temporarily, 'reset' clears session override(s)" }, "key": { "type": "string", "description": "Setting key (e.g., 'chat.disableMarkdownRendering'). Required for 'get' and 'set' operations. Optional for 'reset' (if omitted, resets all session overrides). MUST be verified with introspect tool first." }, "value": { "description": "Value to set. Type depends on the setting (boolean, string, or number). Required for 'set' operation" } }, "required": ["operation"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "report_issue", "description": "Open a pre-filled GitHub issue for Kiro CLI", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "title": { "type": "string", "description": "The title of the GitHub issue." }, "expected_behavior": { "type": "string", "description": "Optional: The expected chat behavior or action that did not happen." }, "actual_behavior": { "type": "string", "description": "Optional: The actual chat behavior that happened and demonstrates the issue or lack of a feature." }, "steps_to_reproduce": { "type": "string", "description": "Optional: Previous user chat requests or steps that were taken that may have resulted in the issue or error response." } }, "required": ["title"] }, "inputSchemaSource": "kiro-cli" },
+    { "id": "code", "description": "Code intelligence operations such as symbol search", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "operation": { "type": "string" }, "symbol_name": { "type": "string" } } }, "inputSchemaSource": "observed" },
+];
+/** V2 engine (plain `kiro-cli`, the default in Kiro CLI 2.x). */
+export const BUILTIN_TOOLS_V2 = [
+    { "id": "read", "description": "Read files, directories, and images", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "operations": { "type": "array", "items": { "type": "object", "properties": { "mode": { "type": "string" }, "path": { "type": "string" } } } } } }, "inputSchemaSource": "observed" },
+    { "id": "write", "description": "Create and modify files", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "command": { "type": "string" }, "path": { "type": "string" }, "content": { "type": "string" }, "oldStr": { "type": "string" }, "newStr": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "glob", "description": "Find files and directories matching glob patterns", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "pattern": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "grep", "description": "Search file contents with a regex", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "pattern": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "code", "description": "Code intelligence operations such as symbol search", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "operation": { "type": "string" }, "symbol_name": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "shell", "description": "Execute a shell command", "sectionId": "runtime", "sectionLabel": "Shell", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "command": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "use_aws", "description": "Make AWS CLI API calls", "sectionId": "aws", "sectionLabel": "AWS", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "region": { "type": "string" }, "service_name": { "type": "string" }, "operation_name": { "type": "string" }, "label": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "web_search", "description": "Search the web", "sectionId": "web", "sectionLabel": "Web", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "query": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "web_fetch", "description": "Fetch and extract content from a URL", "sectionId": "web", "sectionLabel": "Web", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "url": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "subagent", "description": "Run a task through one or more subagent stages", "sectionId": "agents", "sectionLabel": "Agents", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "task": { "type": "string" }, "stages": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "role": { "type": "string" }, "prompt_template": { "type": "string" } } } } } }, "inputSchemaSource": "observed" },
+    { "id": "todo_list", "description": "Create and manage TODO lists for multi-step tasks", "sectionId": "workflow", "sectionLabel": "Workflow", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "command": { "type": "string" }, "task_list_description": { "type": "string" }, "tasks": { "type": "array", "items": { "type": "object", "properties": { "task_description": { "type": "string" } } } } } }, "inputSchemaSource": "observed" },
+    { "id": "goal", "description": "Track and complete the session's goal", "sectionId": "workflow", "sectionLabel": "Workflow", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "command": { "type": "string" }, "summary": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "switch_to_execution", "description": "Switch from planning to execution mode", "sectionId": "workflow", "sectionLabel": "Workflow", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "plan": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "introspect", "description": "Answer questions about Kiro CLI capabilities and documentation", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "__tool_use_purpose": { "type": "string" }, "query": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "knowledge", "description": "Store and retrieve information across chat sessions", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "command": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" }, "__tool_use_purpose": { "type": "string" } } }, "inputSchemaSource": "observed" },
+];
+/** V3 engine (`kiro-cli --v3`). */
+export const BUILTIN_TOOLS_V3 = [
+    { "id": "read_file", "description": "Read a file, optionally a range of lines", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "path": { "type": "string" }, "offset": { "description": "Optional. Only null has been observed." }, "limit": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "list_directory", "description": "List the contents of a directory", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "path": { "type": "string" }, "explanation": { "description": "Optional. Only null has been observed." }, "depth": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "fs_write", "description": "Create a file with the given text", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "path": { "type": "string" }, "text": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "fs_append", "description": "Append text to a file", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "path": { "type": "string" }, "text": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "str_replace", "description": "Replace a string in a file", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "path": { "type": "string" }, "oldStr": { "type": "string" }, "newStr": { "type": "string" }, "replace_all": { "type": "boolean" } } }, "inputSchemaSource": "observed" },
+    { "id": "delete_file", "description": "Delete a file", "sectionId": "fs", "sectionLabel": "Files", "inputSchema": { "type": "object", "properties": { "explanation": { "type": "string" }, "targetFile": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "file_search", "description": "Find files by name or glob pattern", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "explanation": { "type": "string" }, "query": { "type": "string" }, "excludePattern": { "description": "Optional. Only null has been observed." }, "includeIgnoredFiles": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "grep_search", "description": "Search file contents with a regex", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "query": { "type": "string" }, "caseSensitive": { "description": "Optional. Only null has been observed." }, "excludePattern": { "description": "Optional. Only null has been observed." }, "explanation": { "description": "Optional. Only null has been observed." }, "includePattern": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "code", "description": "Code intelligence operations such as symbol search", "sectionId": "search", "sectionLabel": "Search", "inputSchema": { "type": "object", "properties": { "operation": { "type": "string" }, "file_path": { "description": "Optional. Only null has been observed." }, "symbol_name": { "type": "string" }, "symbols": { "type": "array" }, "path": { "description": "Optional. Only null has been observed." }, "symbol_type": { "description": "Optional. Only null has been observed." }, "limit": { "description": "Optional. Only null has been observed." }, "exact_match": { "description": "Optional. Only null has been observed." }, "language": { "description": "Optional. Only null has been observed." }, "include_source": { "description": "Optional. Only null has been observed." }, "top_level_only": { "description": "Optional. Only null has been observed." }, "pattern": { "description": "Optional. Only null has been observed." }, "replacement": { "description": "Optional. Only null has been observed." }, "row": { "description": "Optional. Only null has been observed." }, "column": { "description": "Optional. Only null has been observed." }, "new_name": { "description": "Optional. Only null has been observed." }, "trigger_character": { "description": "Optional. Only null has been observed." }, "tab_size": { "description": "Optional. Only null has been observed." }, "insert_spaces": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "execute_bash", "description": "Execute a shell command", "sectionId": "runtime", "sectionLabel": "Shell", "inputSchema": { "type": "object", "properties": { "command": { "type": "string" }, "description": { "type": ["string", "null"] }, "cwd": { "description": "Optional. Only null has been observed." }, "run_in_background": { "type": "boolean" }, "timeout": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "remote_web_search", "description": "Search the web", "sectionId": "web", "sectionLabel": "Web", "inputSchema": { "type": "object", "properties": { "query": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "web_fetch", "description": "Fetch and extract content from a URL", "sectionId": "web", "sectionLabel": "Web", "inputSchema": { "type": "object", "properties": { "url": { "type": "string" }, "mode": { "type": "string" }, "searchPhrase": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "orchestrate_subagent", "description": "Run a task through one or more subagent stages", "sectionId": "agents", "sectionLabel": "Agents", "inputSchema": { "type": "object", "properties": { "task": { "type": "string" }, "stages": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "role": { "type": "string" }, "prompt_template": { "type": "string" } } } }, "repeat": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "update_session_information", "description": "Update the session's title, description, or status", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "title": { "type": "string" }, "description": { "description": "Optional. Only null has been observed." }, "status": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "disclose_context", "description": "Load a named context, such as a skill, into the session", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "name": { "type": "string" } } }, "inputSchemaSource": "observed" },
+    { "id": "kiro_powers", "description": "List and use Kiro powers", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "action": { "type": "string" }, "powerName": { "description": "Optional. Only null has been observed." }, "serverName": { "description": "Optional. Only null has been observed." }, "toolName": { "description": "Optional. Only null has been observed." }, "arguments": { "description": "Optional. Only null has been observed." }, "steeringFile": { "description": "Optional. Only null has been observed." }, "skillName": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "knowledge", "description": "Store and retrieve information across chat sessions", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "command": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" }, "include": { "description": "Optional. Only null has been observed." }, "exclude": { "description": "Optional. Only null has been observed." }, "index_type": { "description": "Optional. Only null has been observed." }, "context_id": { "description": "Optional. Only null has been observed." }, "path": { "description": "Optional. Only null has been observed." }, "query": { "description": "Optional. Only null has been observed." }, "limit": { "description": "Optional. Only null has been observed." }, "offset": { "description": "Optional. Only null has been observed." }, "snippet_length": { "description": "Optional. Only null has been observed." }, "sort_by": { "description": "Optional. Only null has been observed." }, "file_type": { "description": "Optional. Only null has been observed." }, "operation_id": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+    { "id": "createHook", "description": "Create a Kiro hook", "sectionId": "kiro", "sectionLabel": "Kiro", "inputSchema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "description": "Optional. Only null has been observed." }, "trigger": { "type": "string" }, "matcher": { "description": "Optional. Only null has been observed." }, "actionType": { "type": "string" }, "command": { "description": "Optional. Only null has been observed." }, "prompt": { "type": "string" }, "timeout": { "description": "Optional. Only null has been observed." } } }, "inputSchemaSource": "observed" },
+];
+export const BUILTIN_TOOLS_BY_ENGINE = {
+    v1: BUILTIN_TOOLS_V1,
+    v2: BUILTIN_TOOLS_V2,
+    v3: BUILTIN_TOOLS_V3,
+};
+/**
+ * The default engine's catalog under the name the shared extractors.ts
+ * imports. Nothing in the Kiro plugin registers through it any more:
+ * index.ts builds the running engine's catalog in engine.ts, and
+ * extractors.ts's `buildBuiltinToolDefinitions` is unused here. The alias
+ * exists so that extractors.ts still compiles while staying byte-identical
+ * with the Claude Code plugin's copy.
+ */
+export const BUILTIN_TOOLS = BUILTIN_TOOLS_V2;
+//# sourceMappingURL=builtin-tools.generated.js.map

package/vendor/kiro/dist/engine.js

@@ -0,0 +1,65 @@
+// ---------------------------------------------------------------------------
+// Datagusto Safety Plugin - Kiro agent engine detection
+// ---------------------------------------------------------------------------
+//
+// Kiro CLI 2.x has three agent engines. They send different tool names and
+// input shapes in their hook payloads, so the plugin registers the tool
+// catalog of the engine that is actually running (see
+// builtin-tools.generated.ts). Nothing in the payload names the engine; it is
+// told apart by how the payload is spelled:
+//
+//             hook_event_name                 session_id
+//   V1        camelCase  (`preToolUse`)       absent
+//   V2        camelCase  (`preToolUse`)       present (a uuid)
+//   V3        PascalCase (`PreToolUse`)       present (`sess_<uuid>`)
+//
+// V2 is plain `kiro-cli`, the default. V1 runs when the Kiro setting
+// `chat.agentEngine` is "v1"; `kiro-cli chat --help` also lists
+// `--agent-engine v1`, which has not been run here. V3 is `kiro-cli --v3`.
+//
+// Tool names are never translated between engines: guardrails and the
+// dashboard see the name the engine sent.
+import { BUILTIN_TOOLS_BY_ENGINE } from "./builtin-tools.generated.js";
+/** The engine used when a payload does not identify one: Kiro CLI 2.x's default. */
+export const DEFAULT_ENGINE = "v2";
+const V3_EVENTS = new Set(["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "Stop"]);
+const V1_V2_EVENTS = new Set(["agentSpawn", "userPromptSubmit", "preToolUse", "postToolUse", "stop"]);
+/**
+ * Which Kiro engine wrote this hook payload.
+ *
+ * Only the exact event spellings Kiro sends are recognized. Anything else
+ * (another spelling, a missing or unknown event name) falls back to the
+ * default engine with `recognized: false`. This decides which catalog is
+ * registered and nothing else: how an event is dispatched and whether a call
+ * is blocked do not depend on it.
+ */
+export function detectEngine(payload) {
+    const event = payload.hook_event_name;
+    if (typeof event === "string") {
+        if (V3_EVENTS.has(event))
+            return { engine: "v3", recognized: true };
+        if (V1_V2_EVENTS.has(event)) {
+            const hasSession = typeof payload.session_id === "string" && payload.session_id.length > 0;
+            return { engine: hasSession ? "v2" : "v1", recognized: true };
+        }
+    }
+    return { engine: DEFAULT_ENGINE, recognized: false };
+}
+/**
+ * The built-in tool catalog of `engine`, in the shape /tools/register takes.
+ *
+ * This replaces `buildBuiltinToolDefinitions()` from extractors.ts, which
+ * only knows one catalog. That function and the `BUILTIN_TOOLS` export it
+ * reads are now unused in this plugin; they stay because extractors.ts is
+ * kept byte-identical with the Claude Code plugin's copy.
+ */
+export function buildToolDefinitions(engine) {
+    return BUILTIN_TOOLS_BY_ENGINE[engine].map((t) => ({
+        name: t.id,
+        description: t.description,
+        input_schema: t.inputSchema,
+        // Kiro does not expose output schemas.
+        output_schema: { type: "object", properties: {} },
+    }));
+}
+//# sourceMappingURL=engine.js.map