@nervekit/tools 0.1.0

package/dist/catalog/core/interaction.tools.js

@@ -0,0 +1,55 @@
+import { Type } from "typebox";
+const askUserParameters = Type.Object({
+    question: Type.String({
+        description: "The single focused free-text question to ask the user",
+    }),
+    context: Type.Optional(Type.String({
+        description: "Optional brief background that helps the user answer",
+    })),
+    recommendation: Type.Optional(Type.String({
+        description: "Optional current leaning or recommendation and why",
+    })),
+    placeholder: Type.Optional(Type.String({
+        description: "Optional placeholder text for the reply input",
+    })),
+}, { additionalProperties: false });
+const todoItemParameters = Type.Object({
+    todo: Type.String({ description: "The todo item text" }),
+    done: Type.Boolean({ description: "Whether the item is done" }),
+}, { additionalProperties: false });
+const todosSetParameters = Type.Object({
+    todos: Type.Array(todoItemParameters, {
+        description: "List of todo items with completion status",
+    }),
+}, { additionalProperties: false });
+const todosGetParameters = Type.Object({}, { additionalProperties: false });
+export const interactionToolDefinitions = [
+    {
+        name: "ask_user",
+        label: "Ask User",
+        description: "Ask one focused free-text question when progress depends on the user's decision or unavailable context.",
+        promptSnippet: "Ask the user a focused free-text clarification question",
+        promptGuidelines: [
+            "Ask the user only for decisions or context unavailable from the repo/tools.",
+        ],
+        parameters: askUserParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "todos_set",
+        label: "Set Todos",
+        description: "Set or replace the todo list for the current task.",
+        promptSnippet: "Set the todo list for the current task, replacing any existing todos",
+        parameters: todosSetParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "todos_get",
+        label: "Get Todos",
+        description: "Get the current todo list with completion status.",
+        promptSnippet: "Get the current todo list with completion status",
+        parameters: todosGetParameters,
+        executionMode: "parallel",
+    },
+];
+//# sourceMappingURL=interaction.tools.js.map

package/dist/catalog/core/interaction.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.tools.js","sourceRoot":"","sources":["../../../src/catalog/core/interaction.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CACnC;IACE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,uDAAuD;KACrE,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,sDAAsD;KACpE,CAAC,CACH;IACD,cAAc,EAAE,IAAI,CAAC,QAAQ,CAC3B,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,oDAAoD;KAClE,CAAC,CACH;IACD,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,+CAA+C;KAC7D,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CACpC;IACE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACxD,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;CAChE,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CACpC;IACE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE;QACpC,WAAW,EAAE,2CAA2C;KACzD,CAAC;CACH,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,yGAAyG;QAC3G,aAAa,EAAE,yDAAyD;QACxE,gBAAgB,EAAE;YAChB,6EAA6E;SAC9E;QACD,UAAU,EAAE,iBAAiB;QAC7B,aAAa,EAAE,YAAY;KAC5B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,oDAAoD;QACjE,aAAa,EACX,sEAAsE;QACxE,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,YAAY;KAC5B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,mDAAmD;QAChE,aAAa,EAAE,kDAAkD;QACjE,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,UAAU;KAC1B;CAC6B,CAAC"}

package/dist/catalog/core/python.tools.d.ts

@@ -0,0 +1,17 @@
+import { Type } from "typebox";
+export declare const pythonToolDefinitions: {
+    name: "python";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        code: Type.TOptional<Type.TString>;
+        path: Type.TOptional<Type.TString>;
+        cwd: Type.TOptional<Type.TString>;
+        timeout: Type.TOptional<Type.TNumber>;
+        env: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+    }>;
+    executionMode: "sequential";
+}[];
+//# sourceMappingURL=python.tools.d.ts.map

package/dist/catalog/core/python.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.tools.d.ts","sourceRoot":"","sources":["../../../src/catalog/core/python.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAmC/B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;GAgBF,CAAC"}

package/dist/catalog/core/python.tools.js

@@ -0,0 +1,32 @@
+import { Type } from "typebox";
+const pythonParameters = Type.Object({
+    code: Type.Optional(Type.String({ description: "Inline Python code to execute" })),
+    path: Type.Optional(Type.String({
+        description: "Path to a Python script file to execute (relative to cwd or absolute). Provide exactly one of code or path.",
+    })),
+    cwd: Type.Optional(Type.String({
+        description: "Working directory relative to the project directory. Defaults to the project directory.",
+    })),
+    timeout: Type.Optional(Type.Number({
+        description: "Timeout in seconds, capped by the executor",
+    })),
+    env: Type.Optional(Type.Record(Type.String(), Type.String(), {
+        description: "Non-secret environment variable overrides for the Python process. Sensitive-looking keys are rejected.",
+    })),
+}, { additionalProperties: false });
+export const pythonToolDefinitions = [
+    {
+        name: "python",
+        label: "python",
+        description: "Run inline Python or a script. Returns bounded output plus artifact/transcript paths when needed.",
+        promptSnippet: "Execute short Python snippets or scripts for parsing, calculations, data inspection, and one-off transformations.",
+        promptGuidelines: [
+            "Use python for short scripts/data work; provide exactly one of code or path.",
+            'Write large outputs under os.environ["NERVE_PYTHON_ARTIFACT_DIR"]; never pass secrets via env.',
+            "Do not use python for servers, watchers, daemons, or scripts that wait for stdin.",
+        ],
+        parameters: pythonParameters,
+        executionMode: "sequential",
+    },
+];
+//# sourceMappingURL=python.tools.js.map

package/dist/catalog/core/python.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.tools.js","sourceRoot":"","sources":["../../../src/catalog/core/python.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAClC;IACE,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC,CAC9D;IACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EACT,6GAA6G;KAChH,CAAC,CACH;IACD,GAAG,EAAE,IAAI,CAAC,QAAQ,CAChB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EACT,yFAAyF;KAC5F,CAAC,CACH;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,4CAA4C;KAC1D,CAAC,CACH;IACD,GAAG,EAAE,IAAI,CAAC,QAAQ,CAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE;QACxC,WAAW,EACT,wGAAwG;KAC3G,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,mGAAmG;QACrG,aAAa,EACX,mHAAmH;QACrH,gBAAgB,EAAE;YAChB,8EAA8E;YAC9E,gGAAgG;YAChG,mFAAmF;SACpF;QACD,UAAU,EAAE,gBAAgB;QAC5B,aAAa,EAAE,YAAY;KAC5B;CAC6B,CAAC"}

package/dist/catalog/core/shell.tools.d.ts

@@ -0,0 +1,14 @@
+import { Type } from "typebox";
+export declare const shellToolDefinitions: {
+    name: "bash";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        command: Type.TString;
+        timeout: Type.TOptional<Type.TNumber>;
+    }>;
+    executionMode: "sequential";
+}[];
+//# sourceMappingURL=shell.tools.d.ts.map

package/dist/catalog/core/shell.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.tools.d.ts","sourceRoot":"","sources":["../../../src/catalog/core/shell.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAe/B,eAAO,MAAM,oBAAoB;;;;;;;;;;;GAcD,CAAC"}

package/dist/catalog/core/shell.tools.js

@@ -0,0 +1,22 @@
+import { Type } from "typebox";
+const bashParameters = Type.Object({
+    command: Type.String({ description: "Bash command to execute" }),
+    timeout: Type.Optional(Type.Number({
+        description: "Timeout in seconds, capped by the executor",
+    })),
+}, { additionalProperties: false });
+export const shellToolDefinitions = [
+    {
+        name: "bash",
+        label: "bash",
+        description: "Run a finite shell command. Long commands may be promoted to a background task; use timeout to cap runtime.",
+        promptSnippet: "Run awaited shell commands",
+        promptGuidelines: [
+            "Prefer read/grep/find/ls over shell for file inspection and search.",
+            "Use bash for finite checks, tests, and builds.",
+        ],
+        parameters: bashParameters,
+        executionMode: "sequential",
+    },
+];
+//# sourceMappingURL=shell.tools.js.map

package/dist/catalog/core/shell.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.tools.js","sourceRoot":"","sources":["../../../src/catalog/core/shell.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAChC;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;IAChE,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,4CAA4C;KAC1D,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EACT,6GAA6G;QAC/G,aAAa,EAAE,4BAA4B;QAC3C,gBAAgB,EAAE;YAChB,qEAAqE;YACrE,gDAAgD;SACjD;QACD,UAAU,EAAE,cAAc;QAC1B,aAAa,EAAE,YAAY;KAC5B;CAC6B,CAAC"}

package/dist/catalog/core/web.tools.d.ts

@@ -0,0 +1,23 @@
+import { Type } from "typebox";
+export declare const webToolDefinitions: ({
+    name: "web_search";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        query: Type.TString;
+        max_results: Type.TOptional<Type.TNumber>;
+    }>;
+    executionMode: "parallel";
+} | {
+    name: "web_fetch";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        url: Type.TString;
+        raw: Type.TOptional<Type.TBoolean>;
+    }>;
+    executionMode: "parallel";
+})[];
+//# sourceMappingURL=web.tools.d.ts.map

package/dist/catalog/core/web.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.tools.d.ts","sourceRoot":"","sources":["../../../src/catalog/core/web.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AA8B/B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;IAmBC,CAAC"}

package/dist/catalog/core/web.tools.js

@@ -0,0 +1,34 @@
+import { Type } from "typebox";
+const webSearchParameters = Type.Object({
+    query: Type.String({ description: "The search query" }),
+    max_results: Type.Optional(Type.Number({
+        description: "Maximum number of results (default: 5)",
+        minimum: 1,
+        maximum: 20,
+    })),
+}, { additionalProperties: false });
+const webFetchParameters = Type.Object({
+    url: Type.String({ description: "The URL to fetch" }),
+    raw: Type.Optional(Type.Boolean({
+        description: "If true, save raw content to a temp file and return the path (default: false)",
+    })),
+}, { additionalProperties: false });
+export const webToolDefinitions = [
+    {
+        name: "web_search",
+        label: "Web Search",
+        description: "Search the web with Tavily; requires a configured API key in Nerve Settings.",
+        promptSnippet: "Search the web for current external information",
+        parameters: webSearchParameters,
+        executionMode: "parallel",
+    },
+    {
+        name: "web_fetch",
+        label: "Web Fetch",
+        description: "Fetch a URL. HTML converts to markdown unless raw=true; large or binary responses are saved.",
+        promptSnippet: "Fetch URL contents; HTML is converted to markdown",
+        parameters: webFetchParameters,
+        executionMode: "parallel",
+    },
+];
+//# sourceMappingURL=web.tools.js.map

package/dist/catalog/core/web.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.tools.js","sourceRoot":"","sources":["../../../src/catalog/core/web.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,CACrC;IACE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IACvD,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,wCAAwC;QACrD,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,EAAE;KACZ,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CACpC;IACE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IACrD,GAAG,EAAE,IAAI,CAAC,QAAQ,CAChB,IAAI,CAAC,OAAO,CAAC;QACX,WAAW,EACT,+EAA+E;KAClF,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,8EAA8E;QAChF,aAAa,EAAE,iDAAiD;QAChE,UAAU,EAAE,mBAAmB;QAC/B,aAAa,EAAE,UAAU;KAC1B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,8FAA8F;QAChG,aAAa,EAAE,mDAAmD;QAClE,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,UAAU;KAC1B;CAC6B,CAAC"}

package/dist/catalog/descriptors.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDescriptor } from "@nervekit/shared";
+export declare function coreToolDescriptorsFromDefinitions(): ToolDescriptor[];
+export declare function allToolDescriptorsFromDefinitions(): ToolDescriptor[];
+//# sourceMappingURL=descriptors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../src/catalog/descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,wBAAgB,kCAAkC,IAAI,cAAc,EAAE,CAMrE;AAED,wBAAgB,iCAAiC,IAAI,cAAc,EAAE,CAMpE"}

package/dist/catalog/descriptors.js

@@ -0,0 +1,17 @@
+import { allToolDefinitions, coreToolDefinitions } from "./index.js";
+import { coreToolRiskForName } from "./risk.js";
+export function coreToolDescriptorsFromDefinitions() {
+    return coreToolDefinitions.map((definition) => ({
+        name: definition.name,
+        risk: coreToolRiskForName(definition.name),
+        description: definition.description,
+    }));
+}
+export function allToolDescriptorsFromDefinitions() {
+    return allToolDefinitions.map((definition) => ({
+        name: definition.name,
+        risk: coreToolRiskForName(definition.name),
+        description: definition.description,
+    }));
+}
+//# sourceMappingURL=descriptors.js.map

package/dist/catalog/descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.js","sourceRoot":"","sources":["../../src/catalog/descriptors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,UAAU,kCAAkC;IAChD,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,IAAI,EAAE,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAAC;QAC1C,WAAW,EAAE,UAAU,CAAC,WAAW;KACpC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC7C,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,IAAI,EAAE,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAAC;QAC1C,WAAW,EAAE,UAAU,CAAC,WAAW;KACpC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/catalog/index.d.ts

@@ -0,0 +1,18 @@
+import type { CoreToolName } from "@nervekit/shared";
+import type { CoreToolDefinition } from "./types.js";
+export * from "./core/filesystem.tools.js";
+export * from "./core/interaction.tools.js";
+export * from "./core/python.tools.js";
+export * from "./core/shell.tools.js";
+export * from "./core/web.tools.js";
+export * from "./descriptors.js";
+export * from "./orchestration/explore.tools.js";
+export * from "./orchestration/plan-mode.tools.js";
+export * from "./orchestration/task.tools.js";
+export * from "./risk.js";
+export * from "./types.js";
+export declare const coreToolDefinitions: CoreToolDefinition[];
+export declare const orchestrationToolDefinitions: CoreToolDefinition[];
+export declare const allToolDefinitions: CoreToolDefinition[];
+export declare function coreToolDefinitionByName(name: CoreToolName): CoreToolDefinition;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AASrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAK3B,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,EAOnD,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,kBAAkB,EAI5D,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,EAGlD,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,YAAY,GACjB,kBAAkB,CAIpB"}

package/dist/catalog/index.js

@@ -0,0 +1,44 @@
+import { filesystemToolDefinitions } from "./core/filesystem.tools.js";
+import { interactionToolDefinitions } from "./core/interaction.tools.js";
+import { pythonToolDefinitions } from "./core/python.tools.js";
+import { shellToolDefinitions } from "./core/shell.tools.js";
+import { webToolDefinitions } from "./core/web.tools.js";
+import { exploreToolDefinitions } from "./orchestration/explore.tools.js";
+import { planModeToolDefinitions } from "./orchestration/plan-mode.tools.js";
+import { taskToolDefinitions } from "./orchestration/task.tools.js";
+export * from "./core/filesystem.tools.js";
+export * from "./core/interaction.tools.js";
+export * from "./core/python.tools.js";
+export * from "./core/shell.tools.js";
+export * from "./core/web.tools.js";
+export * from "./descriptors.js";
+export * from "./orchestration/explore.tools.js";
+export * from "./orchestration/plan-mode.tools.js";
+export * from "./orchestration/task.tools.js";
+export * from "./risk.js";
+export * from "./types.js";
+const [readToolDefinition, ...remainingFilesystemToolDefinitions] = filesystemToolDefinitions;
+export const coreToolDefinitions = [
+    ...(readToolDefinition ? [readToolDefinition] : []),
+    ...shellToolDefinitions,
+    ...pythonToolDefinitions,
+    ...remainingFilesystemToolDefinitions,
+    ...interactionToolDefinitions,
+    ...webToolDefinitions,
+];
+export const orchestrationToolDefinitions = [
+    ...taskToolDefinitions,
+    ...exploreToolDefinitions,
+    ...planModeToolDefinitions,
+];
+export const allToolDefinitions = [
+    ...coreToolDefinitions,
+    ...orchestrationToolDefinitions,
+];
+export function coreToolDefinitionByName(name) {
+    const definition = coreToolDefinitions.find((tool) => tool.name === name);
+    if (!definition)
+        throw new Error(`Unknown core tool: ${name}`);
+    return definition;
+}
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGpE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAE3B,MAAM,CAAC,kBAAkB,EAAE,GAAG,kCAAkC,CAAC,GAC/D,yBAAiD,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAyB;IACvD,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,GAAG,oBAAoB;IACvB,GAAG,qBAAqB;IACxB,GAAG,kCAAkC;IACrC,GAAG,0BAA0B;IAC7B,GAAG,kBAAkB;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAyB;IAChE,GAAG,mBAAmB;IACtB,GAAG,sBAAsB;IACzB,GAAG,uBAAuB;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAyB;IACtD,GAAG,mBAAmB;IACtB,GAAG,4BAA4B;CAChC,CAAC;AAEF,MAAM,UAAU,wBAAwB,CACtC,IAAkB;IAElB,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC1E,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAC/D,OAAO,UAAU,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,20 @@
+import { Type } from "typebox";
+export declare const exploreToolDefinitions: {
+    name: "explore";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        task: Type.TOptional<Type.TString>;
+        tasks: Type.TOptional<Type.TArray<Type.TObject<{
+            task: Type.TString;
+            label: Type.TOptional<Type.TString>;
+        }>>>;
+        context: Type.TString;
+        label: Type.TOptional<Type.TString>;
+        split_rationale: Type.TOptional<Type.TString>;
+    }>;
+    executionMode: "parallel";
+}[];
+//# sourceMappingURL=explore.tools.d.ts.map

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

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

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

@@ -0,0 +1,42 @@
+import { Type } from "typebox";
+const exploreTaskParameters = Type.Object({
+    task: Type.String({
+        description: "Specific independent codebase exploration task",
+        minLength: 15,
+    }),
+    label: Type.Optional(Type.String({ description: "Short label for this exploration task" })),
+}, { additionalProperties: false });
+const exploreParameters = Type.Object({
+    task: Type.Optional(Type.String({
+        description: "Specific codebase exploration task for single-agent mode",
+        minLength: 15,
+    })),
+    tasks: Type.Optional(Type.Array(exploreTaskParameters, {
+        minItems: 2,
+        maxItems: 5,
+        description: "Independent exploration tasks for parallel execution",
+    })),
+    context: Type.String({
+        minLength: 40,
+        description: "Required. Summarize the parent agent's own quick grep/find/read lookup, what it found, and what remains unresolved. Mention relevant files or symbols when possible.",
+    }),
+    label: Type.Optional(Type.String({ description: "Short label for the single task" })),
+    split_rationale: Type.Optional(Type.String({
+        minLength: 40,
+        description: "Required when using tasks. Explain why the tasks are independent enough to split and why this is the right number of sub-agents.",
+    })),
+}, { additionalProperties: false });
+export const exploreToolDefinitions = [
+    {
+        name: "explore",
+        label: "explore",
+        description: "Delegate substantial read-only codebase investigations to child agents after your own quick lookup. Use single { task, context, label? } or parallel { tasks, context, split_rationale } for 2-5 independent tasks.",
+        promptSnippet: "Delegate substantial, independent codebase investigations to read-only child agents after doing an initial lookup",
+        promptGuidelines: [
+            "Use explore only after a quick lookup, and only for substantial codebase investigations.",
+        ],
+        parameters: exploreParameters,
+        executionMode: "parallel",
+    },
+];
+//# sourceMappingURL=explore.tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explore.tools.js","sourceRoot":"","sources":["../../../src/catalog/orchestration/explore.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;QAChB,WAAW,EAAE,gDAAgD;QAC7D,SAAS,EAAE,EAAE;KACd,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC,CACtE;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CACnC;IACE,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,0DAA0D;QACvE,SAAS,EAAE,EAAE;KACd,CAAC,CACH;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE;QAChC,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,WAAW,EAAE,sDAAsD;KACpE,CAAC,CACH;IACD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,EAAE;QACb,WAAW,EACT,sKAAsK;KACzK,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC,CAChE;IACD,eAAe,EAAE,IAAI,CAAC,QAAQ,CAC5B,IAAI,CAAC,MAAM,CAAC;QACV,SAAS,EAAE,EAAE;QACb,WAAW,EACT,kIAAkI;KACrI,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,qNAAqN;QACvN,aAAa,EACX,mHAAmH;QACrH,gBAAgB,EAAE;YAChB,0FAA0F;SAC3F;QACD,UAAU,EAAE,iBAAiB;QAC7B,aAAa,EAAE,UAAU;KAC1B;CAC6B,CAAC"}

package/dist/catalog/orchestration/plan-mode.tools.d.ts

@@ -0,0 +1,32 @@
+import { Type } from "typebox";
+export declare const planModeToolDefinitions: ({
+    name: "plan_mode_enter";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        reason: Type.TOptional<Type.TString>;
+    }>;
+    executionMode: "sequential";
+} | {
+    name: "plan_mode_present";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        file_path: Type.TString;
+        title: Type.TOptional<Type.TString>;
+        summary: Type.TOptional<Type.TString>;
+    }>;
+    executionMode: "sequential";
+} | {
+    name: "plan_mode_force_exit";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        reason: Type.TOptional<Type.TString>;
+    }>;
+    executionMode: "sequential";
+})[];
+//# sourceMappingURL=plan-mode.tools.d.ts.map

package/dist/catalog/orchestration/plan-mode.tools.d.ts.map

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

package/dist/catalog/orchestration/plan-mode.tools.js

@@ -0,0 +1,43 @@
+import { Type } from "typebox";
+const planModeEnterParameters = Type.Object({
+    reason: Type.Optional(Type.String({ description: "Why planning mode is needed" })),
+}, { additionalProperties: false });
+const planModePresentParameters = Type.Object({
+    file_path: Type.String({
+        description: "Path to the markdown plan file inside Nerve plan storage",
+    }),
+    title: Type.Optional(Type.String({ description: "Optional display title" })),
+    summary: Type.Optional(Type.String({ description: "Short summary for the review UI" })),
+}, { additionalProperties: false });
+const planModeForceExitParameters = Type.Object({
+    reason: Type.Optional(Type.String({
+        description: "Why planning mode should be exited without an accepted plan",
+    })),
+}, { additionalProperties: false });
+export const planModeToolDefinitions = [
+    {
+        name: "plan_mode_enter",
+        label: "plan_mode_enter",
+        description: "Enter plan mode to research and prepare a reviewed plan before workspace edits.",
+        promptSnippet: "Enter planning mode before preparing a reviewed plan",
+        parameters: planModeEnterParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "plan_mode_present",
+        label: "plan_mode_present",
+        description: "Present a written plan for user review and wait for acceptance, changes, or discard.",
+        promptSnippet: "Present a written plan and wait for user review",
+        parameters: planModePresentParameters,
+        executionMode: "sequential",
+    },
+    {
+        name: "plan_mode_force_exit",
+        label: "plan_mode_force_exit",
+        description: "Exit plan mode without an accepted plan, recording a reason.",
+        promptSnippet: "Force exit planning mode with a reason",
+        parameters: planModeForceExitParameters,
+        executionMode: "sequential",
+    },
+];
+//# sourceMappingURL=plan-mode.tools.js.map

package/dist/catalog/orchestration/plan-mode.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode.tools.js","sourceRoot":"","sources":["../../../src/catalog/orchestration/plan-mode.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,MAAM,uBAAuB,GAAG,IAAI,CAAC,MAAM,CACzC;IACE,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC,CAC5D;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,yBAAyB,GAAG,IAAI,CAAC,MAAM,CAC3C;IACE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;QACrB,WAAW,EAAE,0DAA0D;KACxE,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC,CACvD;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC,CAChE;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,2BAA2B,GAAG,IAAI,CAAC,MAAM,CAC7C;IACE,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EACT,6DAA6D;KAChE,CAAC,CACH;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,iFAAiF;QACnF,aAAa,EAAE,sDAAsD;QACrE,UAAU,EAAE,uBAAuB;QACnC,aAAa,EAAE,YAAY;KAC5B;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,sFAAsF;QACxF,aAAa,EAAE,iDAAiD;QAChE,UAAU,EAAE,yBAAyB;QACrC,aAAa,EAAE,YAAY;KAC5B;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,8DAA8D;QAC3E,aAAa,EAAE,wCAAwC;QACvD,UAAU,EAAE,2BAA2B;QACvC,aAAa,EAAE,YAAY;KAC5B;CAC6B,CAAC"}

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

@@ -0,0 +1,68 @@
+import { Type } from "typebox";
+export declare const processToolDefinitions: ({
+    name: "process_start";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        name: Type.TOptional<Type.TString>;
+        cwd: Type.TOptional<Type.TString>;
+        command: Type.TString;
+        env: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+        readyOnUrl: Type.TOptional<Type.TBoolean>;
+        readyPattern: Type.TOptional<Type.TString>;
+        readyTimeoutMs: Type.TOptional<Type.TNumber>;
+    }>;
+    executionMode: "sequential";
+} | {
+    name: "process_stop";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        processId: Type.TOptional<Type.TString>;
+        name: Type.TOptional<Type.TString>;
+        signal: Type.TOptional<Type.TUnion<[Type.TLiteral<"SIGTERM">, Type.TLiteral<"SIGINT">, Type.TLiteral<"SIGKILL">]>>;
+        timeoutMs: Type.TOptional<Type.TNumber>;
+    }>;
+    executionMode: "sequential";
+} | {
+    name: "process_restart";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        processId: Type.TOptional<Type.TString>;
+        name: Type.TOptional<Type.TString>;
+    }>;
+    executionMode: "sequential";
+    promptGuidelines?: undefined;
+} | {
+    name: "process_list";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{}>;
+    executionMode: "parallel";
+    promptGuidelines?: undefined;
+} | {
+    name: "process_logs";
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TObject<{
+        processId: Type.TOptional<Type.TString>;
+        name: 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";
+})[];
+//# sourceMappingURL=process.tools.d.ts.map

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

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