@nodetool-ai/agents 0.8.1 → 0.8.2

package/dist/capabilities/index.d.ts

@@ -6,12 +6,12 @@
 export { PERMISSION_CATEGORIES } from "./types.js";
 export type { AvailableSecretsResolver, CapabilitySpec, CapabilityImpl, CapabilityRun, CapabilityModule, CapabilityExport, CapabilityGate, CapabilityLoaders, ClientToolRouter, SecretPrompt, SecretPromptRequest, SecretPromptStatus, SubAgentRuntime, PermissionCategory } from "./types.js";
 export { toolFromLazyCapability, toolForCapabilityName } from "./lazy-tool.js";
-export { DECLARED_CAPABILITY_MODULES, listCapabilitySpecs, capabilitySpec, capabilityCategoryFor, capabilityModuleOf, capabilityModuleSpecTable, loadCapabilityImpl, eagerSpecDrift, loadCapabilityModule, listCapabilityModules, loadAllCapabilityModules, findCapability, capabilityCategorySnapshot, capabilityModuleIssues, capabilityModuleDrift } from "./registry.js";
+export { DECLARED_CAPABILITY_MODULES, listCapabilitySpecs, capabilityForName, capabilitySpec, capabilityCategoryFor, capabilityModuleOf, capabilityModuleSpecTable, loadCapabilityImpl, eagerSpecDrift, loadCapabilityModule, listCapabilityModules, loadAllCapabilityModules, findCapability, capabilityCategorySnapshot, capabilityModuleIssues, capabilityModuleDrift } from "./registry.js";
 export { SandboxCapabilityError, capabilityModuleSpecs, createCapabilityDispatcher } from "./dispatcher.js";
 export type { SandboxCapabilityDispatcher } from "./dispatcher.js";
 export { toolFromCapability, capabilityFromTool } from "./adapters.js";
 export type { CapabilityRunSource } from "./adapters.js";
-export { UNGATED, contextSecretAvailability, createCapabilityRun, resolveCapabilityMessage, ungatedCapabilityRun } from "./invoke.js";
+export { UNGATED, contextSecretAvailability, createCapabilityRun, capabilityProviderTool, resolveCapabilityMessage, ungatedCapabilityRun } from "./invoke.js";
 export type { CreateCapabilityRunOptions } from "./invoke.js";
 export { gateFromContext } from "./gate-from-context.js";
 export { VIDEO_PRODUCTION_SCHEMA_VERSION, preflightVideoProduction, prepareVideoProduction, validateVideoProductionAcceptance } from "./video-production.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,OAAO,EACP,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,8BAA8B,EAC9B,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,OAAO,EACP,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,8BAA8B,EAC9B,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC"}

package/dist/capabilities/index.js

@@ -5,10 +5,10 @@
  */
 export { PERMISSION_CATEGORIES } from "./types.js";
 export { toolFromLazyCapability, toolForCapabilityName } from "./lazy-tool.js";
-export { DECLARED_CAPABILITY_MODULES, listCapabilitySpecs, capabilitySpec, capabilityCategoryFor, capabilityModuleOf, capabilityModuleSpecTable, loadCapabilityImpl, eagerSpecDrift, loadCapabilityModule, listCapabilityModules, loadAllCapabilityModules, findCapability, capabilityCategorySnapshot, capabilityModuleIssues, capabilityModuleDrift } from "./registry.js";
+export { DECLARED_CAPABILITY_MODULES, listCapabilitySpecs, capabilityForName, capabilitySpec, capabilityCategoryFor, capabilityModuleOf, capabilityModuleSpecTable, loadCapabilityImpl, eagerSpecDrift, loadCapabilityModule, listCapabilityModules, loadAllCapabilityModules, findCapability, capabilityCategorySnapshot, capabilityModuleIssues, capabilityModuleDrift } from "./registry.js";
 export { SandboxCapabilityError, capabilityModuleSpecs, createCapabilityDispatcher } from "./dispatcher.js";
 export { toolFromCapability, capabilityFromTool } from "./adapters.js";
-export { UNGATED, contextSecretAvailability, createCapabilityRun, resolveCapabilityMessage, ungatedCapabilityRun } from "./invoke.js";
+export { UNGATED, contextSecretAvailability, createCapabilityRun, capabilityProviderTool, resolveCapabilityMessage, ungatedCapabilityRun } from "./invoke.js";
 export { gateFromContext } from "./gate-from-context.js";
 export { VIDEO_PRODUCTION_SCHEMA_VERSION, preflightVideoProduction, prepareVideoProduction, validateVideoProductionAcceptance } from "./video-production.js";
 //# sourceMappingURL=index.js.map

package/dist/capabilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAiBnD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,OAAO,EACP,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAiBnD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,OAAO,EACP,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,uBAAuB,CAAC"}

package/dist/capabilities/invoke.d.ts

@@ -1,33 +1,11 @@
-/**
- * `CapabilityRun.invoke` — the single choke point: lookup → gate → impl.
- *
- * The gate used to be a wrapper class applied where someone remembered
- * `gateTools`. It lives here now, in the one place lookup already happens, so a
- * direct call and an in-sandbox call cannot take different paths. `gateTools`
- * survives as a shim that routes a `Tool` through this ladder
- * (`tools/tool-permissions.ts`); `tests/capabilities-gate-parity.test.ts`
- * drives both entrances and compares transcripts.
- *
- * Design: docs/tool-class-retirement-design.md § "Where the permission gate
- * lives".
- */
-import type { BaseProvider, ProcessingContext, RunBudget } from "@nodetool-ai/runtime";
+/** Capability invocation validates arguments and runs the single permission gate. */
+import type { BaseProvider, ProcessingContext, RunBudget, ProviderTool } from "@nodetool-ai/runtime";
 import type { NodeRegistry } from "@nodetool-ai/node-sdk";
 import type { VectorCollection } from "@nodetool-ai/vectorstore";
 import type { AvailableSecretsResolver, CapabilityExport, CapabilityGate, CapabilityLoaders, CapabilityRun, CapabilitySpec, ClientToolRouter, SecretPrompt, SubAgentRuntime } from "./types.js";
 import type { ExampleWorkflowCatalog, ModelCatalogs, PackageAssetLister, ProjectDeleter, WorkflowDslExporter, WorkflowEnvironmentProvider } from "../tools/mcp-tools.js";
-/**
- * The gate a directly-constructed tool carries. Those tools are gated from the
- * outside — `gateTools` wraps them per turn — and the adapter calls the
- * implementation without consulting the run's own gate, so this exists only to
- * satisfy the run's shape. `auto` keeps the two paths equivalent if anything
- * ever reaches {@link CapabilityRun.invoke} through one of them.
- */
+/** Explicit ungated compatibility runs still use normal validation. */
 export declare const UNGATED: CapabilityGate;
-/**
- * A run over one call's context and nothing else — what every ported tool
- * class whose capability needs only the context builds in its `process()`.
- */
 export declare function ungatedCapabilityRun(context: ProcessingContext): CapabilityRun;
 /**
  * The availability callback for a run whose context can reach a secret store,
@@ -41,6 +19,8 @@ export declare function ungatedCapabilityRun(context: ProcessingContext): Capabi
 export declare function contextSecretAvailability(context: ProcessingContext): AvailableSecretsResolver | undefined;
 export interface CreateCapabilityRunOptions {
     context: ProcessingContext;
+    /** Invocation-local cancellation without copying the processing context. */
+    signal?: AbortSignal;
     gate: CapabilityGate;
     client?: ClientToolRouter;
     /** The project this run works in; see {@link CapabilityRun.projectId}. */
@@ -80,10 +60,19 @@ export interface CreateCapabilityRunOptions {
 }
 /** Build a run whose `invoke` runs the gate before every implementation. */
 export declare function createCapabilityRun(options: CreateCapabilityRunOptions): CapabilityRun;
+/**
+ * The one decide/ask/block ladder: the read-class fast path first (a read is
+ * never prompted and never consulted by the monitor, even when one is wired
+ * in), then the mode decision, then the session allow-set, then the approval
+ * round trip.
+ */
+export declare function invokeCapability(run: CapabilityRun, entry: CapabilityExport, rawArgs: Record<string, unknown>): Promise<unknown>;
 /**
  * The user-facing message for an approval prompt: the LLM-authored `_message`
  * wins, else the spec's template, else the generic fallback — the same order
  * `Tool.resolveMessage` applies.
  */
 export declare function resolveCapabilityMessage(spec: CapabilitySpec, args: Record<string, unknown> | null | undefined): string;
+/** Provider declarations need metadata, not a legacy Tool instance. */
+export declare function capabilityProviderTool(spec: CapabilitySpec): ProviderTool;
 //# sourceMappingURL=invoke.d.ts.map

package/dist/capabilities/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/capabilities/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAQjE,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,cAIrB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,GACzB,aAAa,CAMf;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,iBAAiB,GACzB,wBAAwB,GAAG,SAAS,CAStC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IACvC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CAC3C;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,aAAa,CAmCf;AAuID;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,CAKR"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/capabilities/invoke.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,YAAY,EACb,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAQjE,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,uEAAuE;AACvE,eAAO,MAAM,OAAO,EAAE,cAIrB,CAAC;AAKF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,GACzB,aAAa,CAWf;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,iBAAiB,GACzB,wBAAwB,GAAG,SAAS,CAStC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IACvC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CAC3C;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,aAAa,CAsCf;AAoBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAgClB;AAoHD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,CAKR;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAMzE"}

package/dist/capabilities/invoke.js

@@ -1,43 +1,30 @@
-/**
- * `CapabilityRun.invoke` — the single choke point: lookup → gate → impl.
- *
- * The gate used to be a wrapper class applied where someone remembered
- * `gateTools`. It lives here now, in the one place lookup already happens, so a
- * direct call and an in-sandbox call cannot take different paths. `gateTools`
- * survives as a shim that routes a `Tool` through this ladder
- * (`tools/tool-permissions.ts`); `tests/capabilities-gate-parity.test.ts`
- * drives both entrances and compares transcripts.
- *
- * Design: docs/tool-class-retirement-design.md § "Where the permission gate
- * lives".
- */
+/** Capability invocation validates arguments and runs the single permission gate. */
+import { SpanStatusCode } from "@opentelemetry/api";
+import { getTracer, getRunTraceScope, suppressRunTraceContent, stringifyTraceContent } from "@nodetool-ai/runtime";
 import { budgetFromContext } from "@nodetool-ai/runtime";
-import { Tool } from "../tools/base-tool.js";
+import { injectUserMessageField, Tool } from "../tools/base-tool.js";
 import { decidePermission } from "../tools/tool-permissions.js";
 import { validateCapabilityArgs, withSnakeCaseAliases } from "./args.js";
-import { findCapability } from "./registry.js";
-/**
- * The gate a directly-constructed tool carries. Those tools are gated from the
- * outside — `gateTools` wraps them per turn — and the adapter calls the
- * implementation without consulting the run's own gate, so this exists only to
- * satisfy the run's shape. `auto` keeps the two paths equivalent if anything
- * ever reaches {@link CapabilityRun.invoke} through one of them.
- */
+import { capabilitySpec, capabilityForName, capabilityModuleOf } from "./registry.js";
+/** Explicit ungated compatibility runs still use normal validation. */
 export const UNGATED = {
     mode: "auto",
     sessionAllow: new Set(),
     requestApproval: async () => "allow"
 };
-/**
- * A run over one call's context and nothing else — what every ported tool
- * class whose capability needs only the context builds in its `process()`.
- */
+/** Compatibility consumers reuse one context-only run per context. */
+const ungatedRuns = new WeakMap();
 export function ungatedCapabilityRun(context) {
-    return createCapabilityRun({
-        context,
-        gate: UNGATED,
-        availableSecrets: contextSecretAvailability(context)
-    });
+    let run = ungatedRuns.get(context);
+    if (!run) {
+        run = createCapabilityRun({
+            context,
+            gate: UNGATED,
+            availableSecrets: contextSecretAvailability(context)
+        });
+        ungatedRuns.set(context, run);
+    }
+    return run;
 }
 /**
  * The availability callback for a run whose context can reach a secret store,
@@ -68,6 +55,7 @@ export function createCapabilityRun(options) {
     }
     const run = {
         context: options.context,
+        signal: options.signal,
         gate: options.gate,
         client: options.client,
         projectId: options.projectId ?? options.context.projectId ?? undefined,
@@ -86,11 +74,12 @@ export function createCapabilityRun(options) {
         workflowEnvironment: options.workflowEnvironment,
         loaders: options.loaders,
         invoke: async (name, args) => {
-            const entry = local.get(name) ?? (await findCapability(name));
+            const entry = local.get(name) ??
+                (capabilitySpec(name) ? capabilityForName(name) : undefined);
             if (entry === undefined) {
                 throw new Error(`no capability is registered for "${name}"`);
             }
-            return gatedCall(run, entry, args ?? {});
+            return invokeCapability(run, entry, args ?? {});
         }
     };
     return run;
@@ -116,7 +105,43 @@ async function offTheClock(gate, work) {
  * in), then the mode decision, then the session allow-set, then the approval
  * round trip.
  */
-async function gatedCall(run, entry, rawArgs) {
+export async function invokeCapability(run, entry, rawArgs) {
+    const moduleName = capabilityModuleOf(entry.spec.name);
+    if (moduleName === "email" || moduleName === "google" || moduleName === "browser") {
+        suppressRunTraceContent();
+    }
+    const tracer = getTracer();
+    if (!tracer) {
+        return invokeCapabilityImpl(run, entry, rawArgs);
+    }
+    return tracer.startActiveSpan("capability.call", async (span) => {
+        span.setAttribute("capability.name", entry.spec.name);
+        span.setAttribute("tool.argument_names", Object.keys(rawArgs));
+        const scope = getRunTraceScope();
+        if (scope && scope.origin !== "public" && !scope.policy.contentSuppressed) {
+            span.setAttribute("tool.arguments", stringifyTraceContent(rawArgs));
+        }
+        try {
+            const result = await invokeCapabilityImpl(run, entry, rawArgs);
+            const failed = result !== null && typeof result === "object" && "error" in result;
+            span.setStatus({ code: failed ? SpanStatusCode.ERROR : SpanStatusCode.OK });
+            if (scope && scope.origin !== "public" && !scope.policy.contentSuppressed) {
+                span.setAttribute("tool.result", stringifyTraceContent(result));
+            }
+            return result;
+        }
+        catch (error) {
+            span.setStatus({ code: SpanStatusCode.ERROR });
+            span.recordException(error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+async function invokeCapabilityImpl(run, entry, rawArgs) {
+    run.signal?.throwIfAborted();
     const { spec, impl } = entry;
     const checked = validateCapabilityArgs(spec, withSnakeCaseAliases(rawArgs));
     if (!checked.ok)
@@ -148,7 +173,10 @@ async function gatedCall(run, entry, rawArgs) {
         toolName: spec.name,
         category,
         args: Tool.stripMessage(args),
-        message: resolveCapabilityMessage(spec, args)
+        message: resolveCapabilityMessage(spec, {
+            ...args,
+            _message: rawArgs["_message"]
+        })
     }));
     if (answer === "deny") {
         return {
@@ -197,6 +225,7 @@ async function runImpl(run, entry, args, category) {
             };
         }
     }
+    run.signal?.throwIfAborted();
     return entry.impl(run, args);
 }
 /**
@@ -211,4 +240,12 @@ export function resolveCapabilityMessage(spec, args) {
     const template = spec.userMessage?.(Tool.stripMessage(args ?? {}));
     return template && template.trim() ? template : `Running ${spec.name}`;
 }
+/** Provider declarations need metadata, not a legacy Tool instance. */
+export function capabilityProviderTool(spec) {
+    return {
+        name: spec.name,
+        description: spec.description,
+        inputSchema: injectUserMessageField(spec.inputSchema)
+    };
+}
 //# sourceMappingURL=invoke.js.map

package/dist/capabilities/invoke.js.map

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

package/dist/capabilities/jobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/capabilities/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAerE,QAAA,MAAM,QAAQ,EAAE,gBAgBf,CAAC;AAMF,QAAA,MAAM,MAAM,EAAE,gBAsBb,CAAC;AAEF,QAAA,MAAM,UAAU,EAAE,gBAqBjB,CAAC;AAMF;;;;;;;;GAQG;AACH,QAAA,MAAM,SAAS,EAAE,gBAiBhB,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,SAAS,gBAAgB,EAKvD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/capabilities/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAerE,QAAA,MAAM,QAAQ,EAAE,gBAgBf,CAAC;AAMF,QAAA,MAAM,MAAM,EAAE,gBAsBb,CAAC;AAEF,QAAA,MAAM,UAAU,EAAE,gBA+DjB,CAAC;AAMF;;;;;;;;GAQG;AACH,QAAA,MAAM,SAAS,EAAE,gBAiBhB,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,SAAS,gBAAgB,EAKvD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC"}

package/dist/capabilities/jobs.js

@@ -66,16 +66,60 @@ const getJobLogs = {
         const job = await Job.find(userIdOf(run.context), jobId);
         if (!job)
             return { error: `Job ${jobId} was not found.` };
+        const { findRunForSource, getRun, getRunLogs } = await import("@nodetool-ai/execution");
+        const trace = await findRunForSource(userIdOf(run.context), "workflow", job.id);
+        if (trace) {
+            const owner = userIdOf(run.context);
+            const tail = await getRunLogs(owner, trace.id, {
+                limit: Math.max(1, Math.min(500, Number(params["limit"] ?? 200))),
+                newest: true,
+                include_content: true
+            });
+            const { summary } = await getRun(owner, trace.id);
+            return {
+                job_id: job.id,
+                run_id: tail.run.id,
+                status: tail.run.status,
+                job_error: tail.run.error,
+                total_logs: summary.event_count,
+                logs: tail.logs,
+                content_state: tail.content_state,
+                content_expired: tail.content_expired,
+                truncated: tail.truncated,
+                incomplete: tail.incomplete,
+                limited: tail.limited
+            };
+        }
+        // Deletion can mark an older traced job after the first read, then remove
+        // its directory before the lookup above. Re-read before allowing fallback.
+        const historyJob = await Job.find(userIdOf(run.context), job.id);
+        if (!historyJob) {
+            return { error: `Job ${jobId} was not found.` };
+        }
+        if (historyJob.has_run_trace !== 0) {
+            return {
+                job_id: job.id,
+                status: historyJob.status,
+                job_error: null,
+                total_logs: 0,
+                logs: [],
+                content_state: "expired",
+                content_expired: true,
+                truncated: false,
+                incomplete: false,
+                limited: false
+            };
+        }
         // `limit` keeps the most recent entries — the tail is what explains a
         // failure. Previously it was forwarded to an endpoint that ignored it.
         const limit = Number(params["limit"] ?? 200);
-        const logs = job.logs ?? [];
+        const logs = historyJob.logs ?? [];
         // `job_error`, not `error`: the call succeeded even when the job did not,
         // and a root-level `error` string reads as a tool failure downstream.
         return {
             job_id: job.id,
-            status: job.status,
-            job_error: job.error_message ?? job.error ?? null,
+            status: historyJob.status,
+            job_error: historyJob.error_message ?? historyJob.error ?? null,
             total_logs: logs.length,
             logs: logs.slice(Math.max(0, logs.length - limit))
         };

package/dist/capabilities/jobs.js.map

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

package/dist/capabilities/jobs.specs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/jobs.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,gBAAgB,EAAE,UAc9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,UAcjC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,cAa1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAiBxB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAQ5B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAkB3B,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,SAAS,EAAE,SAAS,cAAc,EAK9C,CAAC"}
+{"version":3,"file":"jobs.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/jobs.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,gBAAgB,EAAE,UAc9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,UAcjC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,cAa1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAiBxB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAU5B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAkB3B,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,SAAS,EAAE,SAAS,cAAc,EAK9C,CAAC"}

package/dist/capabilities/jobs.specs.js

@@ -70,7 +70,9 @@ export const getJobSpec = {
 export const getJobLogsSpec = {
     name: "get_job_logs",
     description: "Get logs for a job to debug workflow executions. Answers the log tail " +
-        "even when the job failed; its failure message is under `job_error`.",
+        "even when the job failed; its failure message is under `job_error`. " +
+        "Reads recorded run events when the job has a trace, including expiry " +
+        "and truncation flags. Uses legacy job logs only when no run trace exists.",
     inputSchema: GET_JOB_LOGS_SCHEMA,
     category: "read",
     userMessage: (params) => `Getting logs for job ${params["job_id"]}`

package/dist/capabilities/jobs.specs.js.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.specs.js","sourceRoot":"","sources":["../../src/capabilities/jobs.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mCAAmC;SACjD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kCAAkC;YAC/C,OAAO,EAAE,GAAG;SACb;KACF;IACD,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,YAAY;SAC1B;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;YACtD,OAAO,EAAE,GAAG;SACb;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,sEAAsE;QACtE,qEAAqE;QACrE,qEAAqE;QACrE,SAAS;IACX,WAAW,EAAE,gBAAgB;IAC7B,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,CAAC,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IACrE,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,SAAS;IACf,WAAW,EACT,yEAAyE;QACzE,mCAAmC;IACrC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,YAAY;aAC1B;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,EAAE;CAC3D,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,wEAAwE;QACxE,qEAAqE;IACvE,WAAW,EAAE,mBAAmB;IAChC,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,wBAAwB,MAAM,CAAC,QAAQ,CAAC,EAAE;CACpE,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,qEAAqE;QACrE,kEAAkE;QAClE,cAAc;IAChB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,YAAY;aAC1B;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,EAAE;CAC9D,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAA8B;IAClD,YAAY;IACZ,UAAU;IACV,cAAc;IACd,aAAa;CACd,CAAC"}
+{"version":3,"file":"jobs.specs.js","sourceRoot":"","sources":["../../src/capabilities/jobs.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mCAAmC;SACjD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kCAAkC;YAC/C,OAAO,EAAE,GAAG;SACb;KACF;IACD,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,YAAY;SAC1B;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;YACtD,OAAO,EAAE,GAAG;SACb;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,sEAAsE;QACtE,qEAAqE;QACrE,qEAAqE;QACrE,SAAS;IACX,WAAW,EAAE,gBAAgB;IAC7B,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,CAAC,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IACrE,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,SAAS;IACf,WAAW,EACT,yEAAyE;QACzE,mCAAmC;IACrC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,YAAY;aAC1B;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,EAAE;CAC3D,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,wEAAwE;QACxE,sEAAsE;QACtE,uEAAuE;QACvE,2EAA2E;IAC7E,WAAW,EAAE,mBAAmB;IAChC,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,wBAAwB,MAAM,CAAC,QAAQ,CAAC,EAAE;CACpE,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,qEAAqE;QACrE,kEAAkE;QAClE,cAAc;IAChB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,YAAY;aAC1B;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,EAAE;CAC9D,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAA8B;IAClD,YAAY;IACZ,UAAU;IACV,cAAc;IACd,aAAa;CACd,CAAC"}

package/dist/capabilities/js-scripts.d.ts

@@ -43,6 +43,9 @@ export declare const JS_SCRIPT_CHAIN_KEY = "__js_script_chain";
  * narrow the envelope, never widen it.
  */
 export declare const JS_SCRIPT_SECRET_ALLOWANCE_KEY = "__js_script_secret_allowance";
+type ToolError = {
+    error: string;
+};
 interface ScriptDepthGate {
     ok: boolean;
     refusal?: Record<string, unknown>;
@@ -67,6 +70,21 @@ export declare function undeclaredStreamHandles(document: JsScriptDocument, stag
 declare const listJsScripts: CapabilityExport;
 declare const getJsScript: CapabilityExport;
 declare const saveJsScript: CapabilityExport;
+export interface JsScriptEditOp {
+    old: string;
+    new: string;
+}
+/** Parse `ops` into `{old, new}` pairs, or an error naming the bad index. */
+export declare function parseJsScriptEditOps(value: unknown): JsScriptEditOp[] | ToolError;
+/**
+ * Apply `ops` in order against `code`, each requiring an exact, unambiguous
+ * match against the result of the ops before it — the same contract a code
+ * editor's find/replace makes.
+ */
+export declare function applyJsScriptEditOps(code: string, ops: readonly JsScriptEditOp[]): {
+    code: string;
+} | ToolError;
+declare const editJsScript: CapabilityExport;
 declare const validateJsScript: CapabilityExport;
 declare const runJsScript: CapabilityExport;
 declare const testJsScript: CapabilityExport;
@@ -86,5 +104,5 @@ declare const restoreJsScriptVersion: CapabilityExport;
 declare const deleteJsScriptVersion: CapabilityExport;
 export declare const JS_SCRIPT_CAPABILITIES: readonly CapabilityExport[];
 export declare const module: CapabilityModule;
-export { listJsScripts, getJsScript, saveJsScript, validateJsScript, runJsScript, testJsScript, listJsScriptVersions, getJsScriptVersion, createJsScriptVersion, restoreJsScriptVersion, deleteJsScriptVersion, deleteJsScript };
+export { listJsScripts, getJsScript, saveJsScript, editJsScript, validateJsScript, runJsScript, testJsScript, listJsScriptVersions, getJsScriptVersion, createJsScriptVersion, restoreJsScriptVersion, deleteJsScriptVersion, deleteJsScript };
 //# sourceMappingURL=js-scripts.d.ts.map

package/dist/capabilities/js-scripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"js-scripts.d.ts","sourceRoot":"","sources":["../../src/capabilities/js-scripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,iDAAiD,CAAC;AAGzD,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAuBpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,iCAAiC,CAAC;AA0F7E,UAAU,eAAe;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAA4B,GACrC,eAAe,CAoCjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,EAAE,CAKV;AAmBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAChC,MAAM,EAAE,CAGV;AAyCD,QAAA,MAAM,aAAa,EAAE,gBAmCpB,CAAC;AAEF,QAAA,MAAM,WAAW,EAAE,gBAalB,CAAC;AA6EF,QAAA,MAAM,YAAY,EAAE,gBAkGnB,CAAC;AAEF,QAAA,MAAM,gBAAgB,EAAE,gBAwCvB,CAAC;AAEF,QAAA,MAAM,WAAW,EAAE,gBAgClB,CAAC;AAEF,QAAA,MAAM,YAAY,EAAE,gBA0BnB,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,cAAc,EAAE,gBAYrB,CAAC;AA0CF,QAAA,MAAM,oBAAoB,EAAE,gBAqB3B,CAAC;AAEF,QAAA,MAAM,kBAAkB,EAAE,gBA0BzB,CAAC;AAEF,QAAA,MAAM,qBAAqB,EAAE,gBAiB5B,CAAC;AAEF,QAAA,MAAM,sBAAsB,EAAE,gBAkE7B,CAAC;AAEF,QAAA,MAAM,qBAAqB,EAAE,gBAmB5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAAS,gBAAgB,EAa7D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACf,CAAC"}
+{"version":3,"file":"js-scripts.d.ts","sourceRoot":"","sources":["../../src/capabilities/js-scripts.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/js-scripts.js

@@ -30,7 +30,7 @@
  */
 import { gradeCodeCases } from "./code-grading.js";
 import { runCodeBody } from "./code.js";
-import { listJsScriptsSpec, getJsScriptSpec, saveJsScriptSpec, validateJsScriptSpec, runJsScriptSpec, testJsScriptSpec, listJsScriptVersionsSpec, getJsScriptVersionSpec, createJsScriptVersionSpec, restoreJsScriptVersionSpec, deleteJsScriptVersionSpec, DEFAULT_VERSION_LIMIT, MAX_VERSION_LIMIT, MAX_JS_SCRIPT_DEPTH, MAX_JS_SCRIPT_TIMEOUT_SECONDS, deleteJsScriptSpec } from "./js-scripts.specs.js";
+import { listJsScriptsSpec, getJsScriptSpec, saveJsScriptSpec, editJsScriptSpec, validateJsScriptSpec, runJsScriptSpec, testJsScriptSpec, listJsScriptVersionsSpec, getJsScriptVersionSpec, createJsScriptVersionSpec, restoreJsScriptVersionSpec, deleteJsScriptVersionSpec, DEFAULT_VERSION_LIMIT, MAX_VERSION_LIMIT, MAX_JS_SCRIPT_DEPTH, MAX_JS_SCRIPT_TIMEOUT_SECONDS, deleteJsScriptSpec } from "./js-scripts.specs.js";
 import { isNonBlankString, isRecord } from "../utils/type-guards.js";
 export { MAX_JS_SCRIPT_DEPTH } from "./js-scripts.specs.js";
 /** Context variable carrying how many script invocations deep this run is. */
@@ -396,6 +396,112 @@ const saveJsScript = {
         };
     }
 };
+/** Parse `ops` into `{old, new}` pairs, or an error naming the bad index. */
+export function parseJsScriptEditOps(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        return { error: "ops must be a non-empty array of {old, new}." };
+    }
+    const ops = [];
+    for (let i = 0; i < value.length; i++) {
+        const entry = value[i];
+        if (!isRecord(entry) ||
+            typeof entry["old"] !== "string" ||
+            typeof entry["new"] !== "string") {
+            return { error: `ops[${i}] must be {old: string, new: string}.` };
+        }
+        if (entry["old"] === "") {
+            return { error: `ops[${i}].old is empty — nothing to match.` };
+        }
+        ops.push({ old: entry["old"], new: entry["new"] });
+    }
+    return ops;
+}
+/** How many non-overlapping times `needle` occurs in `haystack`. */
+function countOccurrences(haystack, needle) {
+    let count = 0;
+    let from = 0;
+    for (;;) {
+        const at = haystack.indexOf(needle, from);
+        if (at === -1)
+            break;
+        count++;
+        from = at + needle.length;
+    }
+    return count;
+}
+/**
+ * Apply `ops` in order against `code`, each requiring an exact, unambiguous
+ * match against the result of the ops before it — the same contract a code
+ * editor's find/replace makes.
+ */
+export function applyJsScriptEditOps(code, ops) {
+    let next = code;
+    for (let i = 0; i < ops.length; i++) {
+        const { old, new: replacement } = ops[i];
+        const count = countOccurrences(next, old);
+        if (count === 0) {
+            return {
+                error: `ops[${i}]: "old" does not match the current code (after the ` +
+                    "previous ops in this call). Read the script again with " +
+                    "get_js_script and re-derive the exact text, including whitespace."
+            };
+        }
+        if (count > 1) {
+            return {
+                error: `ops[${i}]: "old" matches ${count} places in the code — ` +
+                    "ambiguous. Include more surrounding context so it matches " +
+                    "exactly once."
+            };
+        }
+        const at = next.indexOf(old);
+        next = next.slice(0, at) + replacement + next.slice(at + old.length);
+    }
+    return { code: next };
+}
+const editJsScript = {
+    spec: editJsScriptSpec,
+    impl: async (run, params) => {
+        const script = await loadScript(run, params);
+        if (isError(script))
+            return script;
+        const ops = parseJsScriptEditOps(params["ops"]);
+        if (isError(ops))
+            return ops;
+        const document = script.toDocument();
+        const applied = applyJsScriptEditOps(document.code, ops);
+        if (isError(applied))
+            return applied;
+        const nextDocument = { ...document, code: applied.code };
+        const validation = await validateDocument(run, nextDocument);
+        if (!validation.ok) {
+            return {
+                ok: false,
+                saved: false,
+                error: "The revised code has validation errors, so nothing was saved: " +
+                    validation.errors.map((issue) => issue.message).join("; "),
+                validation
+            };
+        }
+        const expected = stringParam(params["base_updated_at"]);
+        const { JsScript } = await import("@nodetool-ai/models");
+        const updated = await JsScript.updateFieldsIfUnchanged(script.id, expected ?? script.updated_at, { document: JSON.stringify(nextDocument) });
+        if (!updated) {
+            return {
+                error: `JS script ${script.id} was modified since it was read ` +
+                    "(optimistic concurrency conflict); nothing was saved. Re-read it " +
+                    "with get_js_script and retry."
+            };
+        }
+        return {
+            ok: true,
+            saved: true,
+            id: updated.id,
+            applied: ops.length,
+            updated_at: updated.updated_at,
+            validation
+        };
+    }
+};
 const validateJsScript = {
     spec: validateJsScriptSpec,
     impl: async (run, params) => {
@@ -682,6 +788,7 @@ export const JS_SCRIPT_CAPABILITIES = [
     listJsScripts,
     getJsScript,
     saveJsScript,
+    editJsScript,
     validateJsScript,
     runJsScript,
     testJsScript,
@@ -696,5 +803,5 @@ export const module = {
     module: "js-scripts",
     exports: JS_SCRIPT_CAPABILITIES
 };
-export { listJsScripts, getJsScript, saveJsScript, validateJsScript, runJsScript, testJsScript, listJsScriptVersions, getJsScriptVersion, createJsScriptVersion, restoreJsScriptVersion, deleteJsScriptVersion, deleteJsScript };
+export { listJsScripts, getJsScript, saveJsScript, editJsScript, validateJsScript, runJsScript, testJsScript, listJsScriptVersions, getJsScriptVersion, createJsScriptVersion, restoreJsScriptVersion, deleteJsScriptVersion, deleteJsScript };
 //# sourceMappingURL=js-scripts.js.map