@orkestrel/toolbox 0.0.13 → 0.0.14

package/dist/src/core/index.cjs

@@ -591,7 +591,7 @@ var INFER_TOOL_DESCRIPTION = [
 * @remarks
 * Carries a machine-readable `code` (see {@link import('./types.js').ToolboxErrorCode}) and
 * an optional `context` bag for structured diagnostics. They are readable through an in-process
-* catch, including around a direct `tool.execute(args)` call. The `ToolManagerInterface`
+* catch, including around a direct `tool.execute(args, context)` call. The `ToolManagerInterface`
 * (`@orkestrel/tool`) instead flattens every throw to the canonical tool result's top-level
 * `error` message string under AGENTS' “narrow untrusted input with guards” rule.
 *
@@ -2059,7 +2059,9 @@ var DatabaseResolver = class {
 * (`{ publish: createToolFunction(tools, 'publish') }`); the pure workflow runner has no
 * knowledge of tools itself. The returned function executes `name` against `tools` with the
 * task's `controller.input` as the call arguments. The adapter resolves the live tool, calls its
-* `execute` method directly, and deep-gates the returned unknown through `parseJSONValue`.
+* `execute` method directly, and deep-gates the returned unknown through `parseJSONValue`. The
+* execution context it passes carries the task's own `controller.signal`, so a handler that
+* reads `context.signal` observes the caller's cancellation.
 * Genuine execution throws retain identity. An unregistered name or non-JSON return throws this
 * package's typed `TOOL` `ToolboxError`.
 *
@@ -2084,7 +2086,7 @@ function createToolFunction(tools, name) {
 	return async (controller) => {
 		const tool = tools.tool(name);
 		if (tool === void 0) throw new ToolboxError("TOOL", `tool '${name}' is not registered`, { tool: name });
-		const result = (0, _orkestrel_contract.parseJSONValue)(await tool.execute(controller.input));
+		const result = (0, _orkestrel_contract.parseJSONValue)(await tool.execute(controller.input, { signal: controller.signal }));
 		if (result === void 0) throw new ToolboxError("TOOL", `tool '${name}' returned a non-JSON value`, { tool: name });
 		return result;
 	};
@@ -2886,11 +2888,14 @@ function createDatabaseDefinitionStore(driver = (0, _orkestrel_database.createMe
 * import { createDatabaseTool } from '@src/core'
 *
 * const tool = createDatabaseTool()
-* await tool.execute({
-* 	operation: 'create',
-* 	id: 'shop',
-* 	tables: { products: { columns: { name: 'string', price: 'number' } } },
-* })
+* await tool.execute(
+* 	{
+* 		operation: 'create',
+* 		id: 'shop',
+* 		tables: { products: { columns: { name: 'string', price: 'number' } } },
+* 	},
+* 	{ signal: new AbortController().signal },
+* )
 * ```
 */
 function createDatabaseTool(options = {}) {
@@ -3086,7 +3091,10 @@ function createDatabaseTool(options = {}) {
 * import { createRelationTool } from '@src/core'
 *
 * const tool = createRelationTool({ managers: { shop: manager } })
-* await tool.execute({ operation: 'load', model: 'accounts', key: 'acc1', include: ['contacts'] })
+* await tool.execute(
+* 	{ operation: 'load', model: 'accounts', key: 'acc1', include: ['contacts'] },
+* 	{ signal: new AbortController().signal },
+* )
 * ```
 */
 function createRelationTool(options) {
@@ -3305,8 +3313,10 @@ function createInferTool(options) {
 * never asserted, and a key outside the closed inferred schema is silently dropped rather than
 * rejected (see {@link import('./types.js').EndpointToolOptions.validate}). With
 * `validate: false`, the tool's `execute` passes through the model-supplied `args` to
-* `definition.execute` without re-validation — the raw-passthrough opt-out. Either way, the
-* definition's return flows back as the tool call's plain result; a throw propagates uncaught,
+* `definition.execute` without re-validation — the raw-passthrough opt-out. The execution context
+* the tool's `execute` receives reaches `definition.execute` unchanged whichever way `args` are
+* handled, so a handler that reads `context.signal` observes the caller's cancellation. Either way,
+* the definition's return flows back as the tool call's plain result; a throw propagates uncaught,
 * isolated by the `ToolManagerInterface` (`@orkestrel/tool`) into the canonical error envelope
 * — never caught or re-wrapped here.
 *
@@ -3359,8 +3369,8 @@ function createEndpointTool(definition, options) {
 		name: definition.name,
 		description: definition.description,
 		...parameters === void 0 ? {} : { parameters },
-		execute(args) {
-			return definition.execute(args);
+		execute(args, context) {
+			return definition.execute(args, context);
 		}
 	});
 	const contract = (0, _orkestrel_contract.createContract)((0, _orkestrel_contract.schemaToShape)(objectSchema));
@@ -3368,13 +3378,13 @@ function createEndpointTool(definition, options) {
 		name: definition.name,
 		description: definition.description,
 		...parameters === void 0 ? {} : { parameters },
-		execute(args) {
+		execute(args, context) {
 			const parsed = contract.parse(args);
 			if (parsed === void 0 || !(0, _orkestrel_contract.isRecord)(parsed)) throw new ToolboxError("TOOL", "malformed endpoint call arguments", {
 				name: definition.name,
 				faults: contract.explain(args)
 			});
-			return definition.execute(parsed);
+			return definition.execute(parsed, context);
 		}
 	});
 }