@nervekit/tools 0.1.0

package/dist/catalog/orchestration/process.tools.js

@@ -0,0 +1,96 @@
+import { Type } from "typebox";
+const processStartParameters = Type.Object({
+    name: Type.Optional(Type.String({ description: "Stable process name" })),
+    cwd: Type.Optional(Type.String({ description: "Working directory relative to the project" })),
+    command: Type.String({ description: "Command to start and supervise" }),
+    env: Type.Optional(Type.Record(Type.String(), Type.String(), {
+        description: "Extra environment variables. Values are stored encrypted for restart and shown only as redacted keys.",
+    })),
+    readyOnUrl: Type.Optional(Type.Boolean({ description: "Treat first detected URL as ready" })),
+    readyPattern: Type.Optional(Type.String({ description: "Regex line that marks the process ready" })),
+    readyTimeoutMs: Type.Optional(Type.Number({ description: "Readiness wait timeout in milliseconds" })),
+}, { additionalProperties: false });
+const processTargetParameters = Type.Object({
+    processId: Type.Optional(Type.String({ description: "Process id" })),
+    name: Type.Optional(Type.String({ description: "Process name" })),
+    signal: Type.Optional(Type.Union([
+        Type.Literal("SIGTERM"),
+        Type.Literal("SIGINT"),
+        Type.Literal("SIGKILL"),
+    ])),
+    timeoutMs: Type.Optional(Type.Number({ description: "Stop timeout in milliseconds" })),
+}, { additionalProperties: false });
+const processRestartParameters = Type.Object({
+    processId: Type.Optional(Type.String({ description: "Process id" })),
+    name: Type.Optional(Type.String({ description: "Process name" })),
+}, { additionalProperties: false });
+const processListParameters = Type.Object({}, { additionalProperties: false });
+const processLogsParameters = Type.Object({
+    processId: Type.Optional(Type.String({ description: "Process id" })),
+    name: Type.Optional(Type.String({ description: "Process name" })),
+    mode: Type.Optional(Type.Union([
+        Type.Literal("recent"),
+        Type.Literal("errors"),
+        Type.Literal("warnings"),
+        Type.Literal("since_cursor"),
+        Type.Literal("first_failure"),
+    ])),
+    sinceSeq: Type.Optional(Type.Number({ description: "Cursor sequence" })),
+    contains: Type.Optional(Type.String({ description: "Substring filter" })),
+    regex: Type.Optional(Type.String({ description: "Regex filter" })),
+    contextLines: Type.Optional(Type.Number({ description: "Context lines" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum events" })),
+}, { additionalProperties: false });
+export const processToolDefinitions = [
+    {
+        name: "process_start",
+        label: "process_start",
+        description: "Start a managed long-running command such as a dev server, watcher, or daemon. Captures logs and readiness state for later process_logs queries.",
+        promptSnippet: "Start long-running commands with supervised logs and lifecycle management",
+        promptGuidelines: [
+            "Use process_start instead of bash for dev servers, file watchers, queue workers, and other long-running commands.",
+            "Provide readyOnUrl or readyPattern when possible so the tool can wait for readiness.",
+        ],
+        parameters: processStartParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "process_stop",
+        label: "process_stop",
+        description: "Stop a managed process or clean up an orphaned process by processId or name.",
+        promptSnippet: "Stop supervised long-running processes, including best-effort cleanup of orphaned process trees after daemon restarts",
+        promptGuidelines: [
+            "Use process_stop on orphaned records before restarting if a daemon restart may have left the old process tree alive.",
+        ],
+        parameters: processTargetParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "process_restart",
+        label: "process_restart",
+        description: "Restart a managed process by processId or name, preserving encrypted env overrides captured at start.",
+        promptSnippet: "Restart supervised long-running processes while preserving stored env overrides",
+        parameters: processRestartParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "process_list",
+        label: "process_list",
+        description: "List managed processes for the current project.",
+        promptSnippet: "List supervised processes",
+        parameters: processListParameters,
+        executionMode: "parallel",
+    },
+    {
+        name: "process_logs",
+        label: "process_logs",
+        description: "Query captured logs from a managed process, including recent output, errors, warnings, cursor-based updates, and first-failure context.",
+        promptSnippet: "Inspect logs from supervised processes",
+        promptGuidelines: [
+            "After code changes that trigger a running process to recompile, inspect process_logs instead of restarting the command just to see errors.",
+        ],
+        parameters: processLogsParameters,
+        executionMode: "parallel",
+    },
+];
+//# sourceMappingURL=process.tools.js.map

package/dist/catalog/orchestration/process.tools.js.map

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

package/dist/catalog/orchestration/subagent.tools.d.ts

@@ -0,0 +1,16 @@
+import { Type } from "typebox";
+export declare const subagentToolDefinitions: {
+    name: "subagent_run";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        task: Type.TString;
+        context: Type.TOptional<Type.TString>;
+        mode: Type.TOptional<Type.TUnion<[Type.TLiteral<"planning">, Type.TLiteral<"coding">]>>;
+        permissionLevel: Type.TOptional<Type.TUnion<[Type.TLiteral<"read_only">, Type.TLiteral<"supervised">, Type.TLiteral<"autonomous">]>>;
+    }>;
+    executionMode: "sequential";
+}[];
+//# sourceMappingURL=subagent.tools.d.ts.map

package/dist/catalog/orchestration/subagent.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.tools.d.ts","sourceRoot":"","sources":["../../../src/catalog/orchestration/subagent.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAuB/B,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;GAaJ,CAAC"}

package/dist/catalog/orchestration/subagent.tools.js

@@ -0,0 +1,25 @@
+import { Type } from "typebox";
+const subagentRunParameters = Type.Object({
+    task: Type.String({ description: "Task for the child agent" }),
+    context: Type.Optional(Type.String({ description: "Useful context for the child agent" })),
+    mode: Type.Optional(Type.Union([Type.Literal("planning"), Type.Literal("coding")])),
+    permissionLevel: Type.Optional(Type.Union([
+        Type.Literal("read_only"),
+        Type.Literal("supervised"),
+        Type.Literal("autonomous"),
+    ])),
+}, { additionalProperties: false });
+export const subagentToolDefinitions = [
+    {
+        name: "subagent_run",
+        label: "subagent_run",
+        description: "Spawn a child agent to investigate an independent task with bounded authority.",
+        promptSnippet: "Run a bounded child agent for independent investigation",
+        promptGuidelines: [
+            "Use subagent_run only for substantial independent investigations, not simple lookups.",
+        ],
+        parameters: subagentRunParameters,
+        executionMode: "sequential",
+    },
+];
+//# sourceMappingURL=subagent.tools.js.map

package/dist/catalog/orchestration/subagent.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.tools.js","sourceRoot":"","sources":["../../../src/catalog/orchestration/subagent.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,MAAM,qBAAqB,GAAG,IAAI,CAAC,MAAM,CACvC;IACE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;IAC9D,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC,CACnE;IACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC/D;IACD,eAAe,EAAE,IAAI,CAAC,QAAQ,CAC5B,IAAI,CAAC,KAAK,CAAC;QACT,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;KAC3B,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,gFAAgF;QAClF,aAAa,EAAE,yDAAyD;QACxE,gBAAgB,EAAE;YAChB,uFAAuF;SACxF;QACD,UAAU,EAAE,qBAAqB;QACjC,aAAa,EAAE,YAAY;KAC5B;CAC6B,CAAC"}

package/dist/catalog/orchestration/task.tools.d.ts

@@ -0,0 +1,107 @@
+import { Type } from "typebox";
+export declare const taskToolDefinitions: ({
+    name: "task_start";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        name: Type.TOptional<Type.TString>;
+        cwd: Type.TOptional<Type.TString>;
+        command: Type.TOptional<Type.TString>;
+        env: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+        readyUrl: Type.TOptional<Type.TString>;
+        readyOnUrl: Type.TOptional<Type.TBoolean>;
+        readyPattern: Type.TOptional<Type.TString>;
+        readyTimeoutMs: Type.TOptional<Type.TNumber>;
+        timeoutMs: Type.TOptional<Type.TNumber>;
+        notify: Type.TOptional<Type.TBoolean>;
+        tasks: Type.TOptional<Type.TArray<Type.TObject<{
+            name: Type.TOptional<Type.TString>;
+            cwd: Type.TOptional<Type.TString>;
+            command: Type.TString;
+            env: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+            readyUrl: Type.TOptional<Type.TString>;
+            readyOnUrl: Type.TOptional<Type.TBoolean>;
+            readyPattern: Type.TOptional<Type.TString>;
+            readyTimeoutMs: Type.TOptional<Type.TNumber>;
+            timeoutMs: Type.TOptional<Type.TNumber>;
+            notify: Type.TOptional<Type.TBoolean>;
+        }>>>;
+    }>;
+    executionMode: "sequential";
+} | {
+    name: "task_status";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        taskId: Type.TOptional<Type.TString>;
+        taskIds: Type.TOptional<Type.TArray<Type.TString>>;
+        groupId: Type.TOptional<Type.TString>;
+        activeOnly: Type.TOptional<Type.TBoolean>;
+        includeLogs: Type.TOptional<Type.TBoolean>;
+        logLimit: Type.TOptional<Type.TNumber>;
+        limit: Type.TOptional<Type.TNumber>;
+    }>;
+    executionMode: "parallel";
+} | {
+    name: "task_logs";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        taskId: Type.TOptional<Type.TString>;
+        groupId: Type.TOptional<Type.TString>;
+        mode: Type.TOptional<Type.TUnion<[Type.TLiteral<"recent">, Type.TLiteral<"errors">, Type.TLiteral<"warnings">, Type.TLiteral<"since_cursor">, Type.TLiteral<"first_failure">]>>;
+        sinceSeq: Type.TOptional<Type.TNumber>;
+        contains: Type.TOptional<Type.TString>;
+        regex: Type.TOptional<Type.TString>;
+        contextLines: Type.TOptional<Type.TNumber>;
+        limit: Type.TOptional<Type.TNumber>;
+    }>;
+    executionMode: "parallel";
+    promptGuidelines?: undefined;
+} | {
+    name: "task_cancel";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        taskId: Type.TOptional<Type.TString>;
+        groupId: Type.TOptional<Type.TString>;
+        signal: Type.TOptional<Type.TUnion<[Type.TLiteral<"SIGTERM">, Type.TLiteral<"SIGINT">, Type.TLiteral<"SIGKILL">]>>;
+        timeoutMs: Type.TOptional<Type.TNumber>;
+        reason: Type.TOptional<Type.TString>;
+    }>;
+    executionMode: "sequential";
+    promptGuidelines?: undefined;
+} | {
+    name: "task_restart";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        taskId: Type.TString;
+    }>;
+    executionMode: "sequential";
+    promptGuidelines?: undefined;
+} | {
+    name: "task_list";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        status: Type.TOptional<Type.TString>;
+        activeOnly: Type.TOptional<Type.TBoolean>;
+        projectId: Type.TOptional<Type.TString>;
+        conversationId: Type.TOptional<Type.TString>;
+        agentId: Type.TOptional<Type.TString>;
+        groupId: Type.TOptional<Type.TString>;
+        limit: Type.TOptional<Type.TNumber>;
+    }>;
+    executionMode: "parallel";
+    promptGuidelines?: undefined;
+})[];
+//# sourceMappingURL=task.tools.d.ts.map

package/dist/catalog/orchestration/task.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.tools.d.ts","sourceRoot":"","sources":["../../../src/catalog/orchestration/task.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AA2N/B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+DA,CAAC"}

package/dist/catalog/orchestration/task.tools.js

@@ -0,0 +1,170 @@
+import { Type } from "typebox";
+const taskStartItemParameters = Type.Object({
+    name: Type.Optional(Type.String({ description: "Stable task name" })),
+    cwd: Type.Optional(Type.String({ description: "Working directory relative to the project" })),
+    command: Type.String({ description: "Command to start and supervise" }),
+    env: Type.Optional(Type.Record(Type.String(), Type.String(), {
+        description: "Extra environment variables. Values are stored encrypted for restart and shown only as redacted keys.",
+    })),
+    readyUrl: Type.Optional(Type.String({ description: "Explicit URL to poll until reachable" })),
+    readyOnUrl: Type.Optional(Type.Boolean({ description: "Treat first detected URL as ready" })),
+    readyPattern: Type.Optional(Type.String({ description: "Regex line that marks the task ready" })),
+    readyTimeoutMs: Type.Optional(Type.Number({
+        description: "Readiness wait timeout in milliseconds. Only applies when readyUrl, readyOnUrl, or readyPattern is provided; it does not stop the process.",
+        minimum: 0,
+        maximum: 60_000,
+    })),
+    timeoutMs: Type.Optional(Type.Number({
+        description: "Maximum task runtime in milliseconds",
+        minimum: 1,
+        maximum: 86_400_000,
+    })),
+    notify: Type.Optional(Type.Boolean({
+        description: "Send concise asynchronous task updates to the agent. Defaults to true for agent task tools; set false to opt out.",
+        default: true,
+    })),
+}, { additionalProperties: false });
+const taskStartParameters = Type.Object({
+    name: Type.Optional(Type.String({ description: "Stable task name" })),
+    cwd: Type.Optional(Type.String({ description: "Working directory relative to the project" })),
+    command: Type.Optional(Type.String({ description: "Command to start and supervise" })),
+    env: Type.Optional(Type.Record(Type.String(), Type.String(), {
+        description: "Extra environment variables. Values are stored encrypted for restart and shown only as redacted keys.",
+    })),
+    readyUrl: Type.Optional(Type.String({ description: "Explicit URL to poll until reachable" })),
+    readyOnUrl: Type.Optional(Type.Boolean({ description: "Treat first detected URL as ready" })),
+    readyPattern: Type.Optional(Type.String({ description: "Regex line that marks the task ready" })),
+    readyTimeoutMs: Type.Optional(Type.Number({
+        description: "Readiness wait timeout in milliseconds. Only applies when readyUrl, readyOnUrl, or readyPattern is provided; it does not stop the process.",
+        minimum: 0,
+        maximum: 60_000,
+    })),
+    timeoutMs: Type.Optional(Type.Number({
+        description: "Maximum task runtime in milliseconds",
+        minimum: 1,
+        maximum: 86_400_000,
+    })),
+    notify: Type.Optional(Type.Boolean({
+        description: "Send concise asynchronous task updates to the agent. Defaults to true for agent task tools; set false to opt out.",
+        default: true,
+    })),
+    tasks: Type.Optional(Type.Array(taskStartItemParameters, {
+        maxItems: 8,
+        description: "Small batch of tasks to start in the background",
+    })),
+}, { additionalProperties: false });
+const taskTargetParameters = Type.Object({
+    taskId: Type.Optional(Type.String({ description: "Task id or stable task name" })),
+    groupId: Type.Optional(Type.String({ description: "Task group id" })),
+    signal: Type.Optional(Type.Union([
+        Type.Literal("SIGTERM"),
+        Type.Literal("SIGINT"),
+        Type.Literal("SIGKILL"),
+    ])),
+    timeoutMs: Type.Optional(Type.Number({
+        description: "Cancel timeout in milliseconds",
+        minimum: 1,
+        maximum: 30_000,
+    })),
+    reason: Type.Optional(Type.String({ description: "Cancellation reason" })),
+}, { additionalProperties: false });
+const taskRestartParameters = Type.Object({
+    taskId: Type.String({ description: "Task id or stable task name" }),
+}, { additionalProperties: false });
+const taskStatusParameters = Type.Object({
+    taskId: Type.Optional(Type.String({ description: "Task id or stable task name" })),
+    taskIds: Type.Optional(Type.Array(Type.String({ description: "Task id or stable task name" }), {
+        maxItems: 20,
+    })),
+    groupId: Type.Optional(Type.String({ description: "Task group id" })),
+    activeOnly: Type.Optional(Type.Boolean({ description: "Only active tasks" })),
+    includeLogs: Type.Optional(Type.Boolean({ description: "Include a short relevant log tail" })),
+    logLimit: Type.Optional(Type.Number({
+        description: "Maximum log events to include per task",
+        minimum: 1,
+        maximum: 50,
+    })),
+    limit: Type.Optional(Type.Number({ description: "Maximum tasks", minimum: 1, maximum: 50 })),
+}, { additionalProperties: false });
+const taskListParameters = Type.Object({
+    status: Type.Optional(Type.String({ description: "Task status filter" })),
+    activeOnly: Type.Optional(Type.Boolean({ description: "Only active tasks" })),
+    projectId: Type.Optional(Type.String({ description: "Project id filter" })),
+    conversationId: Type.Optional(Type.String({ description: "Conversation id filter" })),
+    agentId: Type.Optional(Type.String({ description: "Agent id filter" })),
+    groupId: Type.Optional(Type.String({ description: "Task group id filter" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum tasks" })),
+}, { additionalProperties: false });
+const taskLogsParameters = Type.Object({
+    taskId: Type.Optional(Type.String({ description: "Task id or stable task name" })),
+    groupId: Type.Optional(Type.String({ description: "Task group id" })),
+    mode: Type.Optional(Type.Union([
+        Type.Literal("recent"),
+        Type.Literal("errors"),
+        Type.Literal("warnings"),
+        Type.Literal("since_cursor"),
+        Type.Literal("first_failure"),
+    ])),
+    sinceSeq: Type.Optional(Type.Number({ description: "Cursor sequence", minimum: 0 })),
+    contains: Type.Optional(Type.String({ description: "Substring filter" })),
+    regex: Type.Optional(Type.String({ description: "Regex filter" })),
+    contextLines: Type.Optional(Type.Number({ description: "Context lines", minimum: 0, maximum: 20 })),
+    limit: Type.Optional(Type.Number({ description: "Maximum events", minimum: 1, maximum: 500 })),
+}, { additionalProperties: false });
+export const taskToolDefinitions = [
+    {
+        name: "task_start",
+        label: "task_start",
+        description: "Start supervised background tasks for servers, watchers, and other long-lived commands.",
+        promptSnippet: "Start detached background processes for long-lived commands and servers",
+        promptGuidelines: [
+            "Use task_start for servers, watchers, and other long-lived processes.",
+        ],
+        parameters: taskStartParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "task_status",
+        label: "task_status",
+        description: "Inspect task state once for diagnostics; not a wait mechanism.",
+        promptSnippet: "Inspect current task status",
+        promptGuidelines: [
+            "Do not poll task_status/task_logs; inspect once when current task state matters.",
+        ],
+        parameters: taskStatusParameters,
+        executionMode: "parallel",
+    },
+    {
+        name: "task_logs",
+        label: "task_logs",
+        description: "Inspect captured task logs for recent output, errors, warnings, or first-failure context.",
+        promptSnippet: "Inspect logs from background tasks",
+        parameters: taskLogsParameters,
+        executionMode: "parallel",
+    },
+    {
+        name: "task_cancel",
+        label: "task_cancel",
+        description: "Terminate a running or orphaned task by task ID/name or group.",
+        promptSnippet: "Cancel supervised background tasks or clean up orphaned task records",
+        parameters: taskTargetParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "task_restart",
+        label: "task_restart",
+        description: "Restart a task by ID or stable name, preserving stored launch settings.",
+        promptSnippet: "Restart supervised background tasks while preserving stored env overrides",
+        parameters: taskRestartParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "task_list",
+        label: "task_list",
+        description: "List known background tasks for the current project.",
+        promptSnippet: "List background tasks",
+        parameters: taskListParameters,
+        executionMode: "parallel",
+    },
+];
+//# sourceMappingURL=task.tools.js.map

package/dist/catalog/orchestration/task.tools.js.map

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

package/dist/catalog/risk.d.ts

@@ -0,0 +1,3 @@
+import type { ToolName, ToolRisk } from "@nervekit/shared";
+export declare function coreToolRiskForName(name: ToolName): ToolRisk;
+//# sourceMappingURL=risk.d.ts.map

package/dist/catalog/risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.d.ts","sourceRoot":"","sources":["../../src/catalog/risk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA4B3D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAE5D"}

package/dist/catalog/risk.js

@@ -0,0 +1,29 @@
+const toolRisks = {
+    read: "read",
+    bash: "command",
+    python: "command",
+    edit: "workspace_write",
+    write: "workspace_write",
+    grep: "read",
+    find: "read",
+    ls: "read",
+    ask_user: "interaction",
+    todos_set: "interaction",
+    todos_get: "read",
+    web_search: "network",
+    web_fetch: "network",
+    task_start: "command",
+    task_status: "read",
+    task_logs: "read",
+    task_cancel: "command",
+    task_restart: "command",
+    task_list: "read",
+    explore: "agent_spawn",
+    plan_mode_enter: "interaction",
+    plan_mode_present: "interaction",
+    plan_mode_force_exit: "interaction",
+};
+export function coreToolRiskForName(name) {
+    return toolRisks[name] ?? "command";
+}
+//# sourceMappingURL=risk.js.map

package/dist/catalog/risk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.js","sourceRoot":"","sources":["../../src/catalog/risk.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAA+B;IAC5C,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,iBAAiB;IACxB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,MAAM;IACV,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,MAAM;IACnB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,SAAS;IACtB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,aAAa;IACtB,eAAe,EAAE,aAAa;IAC9B,iBAAiB,EAAE,aAAa;IAChC,oBAAoB,EAAE,aAAa;CACpC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AACtC,CAAC"}

package/dist/catalog/types.d.ts

@@ -0,0 +1,14 @@
+import type { ToolName } from "@nervekit/shared";
+import type { Static, TSchema } from "typebox";
+export type CoreToolExecutionMode = "sequential" | "parallel";
+export interface CoreToolDefinition<TParams extends TSchema = TSchema> {
+    name: ToolName;
+    label: string;
+    description: string;
+    promptSnippet?: string;
+    promptGuidelines?: string[];
+    parameters: TParams;
+    prepareArguments?: (args: unknown) => Static<TParams>;
+    executionMode?: CoreToolExecutionMode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/catalog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,OAAO,GAAG,OAAO;IACnE,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;IACtD,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC"}

package/dist/catalog/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/catalog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":""}

package/dist/definitions.d.ts

@@ -0,0 +1,2 @@
+export * from "./catalog/index.js";
+//# sourceMappingURL=definitions.d.ts.map

package/dist/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/definitions.js

@@ -0,0 +1,2 @@
+export * from "./catalog/index.js";
+//# sourceMappingURL=definitions.js.map

package/dist/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/execution/atomic-write.d.ts

@@ -0,0 +1,2 @@
+export declare function writeTextFileAtomically(path: string, content: string): Promise<void>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/execution/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/execution/atomic-write.ts"],"names":[],"mappings":"AAEA,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/execution/atomic-write.js

@@ -0,0 +1,7 @@
+import { rename, writeFile } from "node:fs/promises";
+export async function writeTextFileAtomically(path, content) {
+    const tempPath = `${path}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(tempPath, content, "utf8");
+    await rename(tempPath, path);
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/execution/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/execution/atomic-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAY,EACZ,OAAe;IAEf,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IAC5D,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/execution/bash.d.ts

@@ -0,0 +1,3 @@
+import type { ToolExecutionContext, ToolExecutionResult } from "../types.js";
+export declare function executeBash(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+//# sourceMappingURL=bash.d.ts.map

package/dist/execution/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/execution/bash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAI7E,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA+F9B"}