@nexface/tools 0.1.13 → 0.1.15-alpha.0

package/dist/index.d.ts

@@ -7,4 +7,4 @@ export type { AgentNavigation, AgentNavigationConfig, AgentNavigationExecutors,
 export type { AgentToolBinding, AgentToolChatConfirmationConfig, AgentToolPageConfirmationConfig, AgentUIActionChildProps, AgentUIActionEvent, AgentUIActionProps, UseAgentToolDefaultOptions, UseAgentToolPageConfirmationOptions, } from "./react.js";
 export type { AgentToolConfirmationConfig, RuntimeAgentTool, ToolRuntime, ToolOperation, ToolRuntimeOptions, ToolRuntimeToolChangeEvent, } from "./runtime.js";
 export type { AgentContextEntry, AgentContextValue, AgentToolDefinition, AgentToolEffect, AgentToolExecutionContext, AgentToolExecutor, AgentToolInputSchema, InferJsonSchema, JsonSchema, } from "./types.js";
-export { registerAgentTool, type RegisteredAgentTool } from "./registration.js";
+export { createAgentToolRegistry, registerAgentTool, type RegisteredAgentTool } from "./registration.js";

package/dist/index.js

@@ -3,5 +3,5 @@ export { defineAgentNavigation } from "./navigation.js";
 export { AgentOperationSurface } from "./operation-surface.js";
 export { createToolRuntime, isToolRuntimeError, } from "./runtime.js";
 export { AgentContext, ToolsProvider, AgentUIAction, useAgentContext, useAgentNavigation, useAgentTool, } from "./react.js";
-export { registerAgentTool } from "./registration.js";
+export { createAgentToolRegistry, registerAgentTool } from "./registration.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAmC,MAAM,wBAAwB,CAAC;AAChG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC;AAqCpB,OAAO,EAAE,iBAAiB,EAA4B,MAAM,mBAAmB,CAAC","sourcesContent":["export { defineAgentTool } from \"./definition.js\";\nexport { defineAgentNavigation } from \"./navigation.js\";\nexport { AgentOperationSurface, type AgentOperationSurfaceProps } from \"./operation-surface.js\";\nexport {\n  createToolRuntime,\n  isToolRuntimeError,\n} from \"./runtime.js\";\nexport {\n  AgentContext,\n  ToolsProvider,\n  AgentUIAction,\n  useAgentContext,\n  useAgentNavigation,\n  useAgentTool,\n} from \"./react.js\";\nexport type {\n  AgentNavigation,\n  AgentNavigationConfig,\n  AgentNavigationExecutors,\n  AgentNavigationRouteConfig,\n} from \"./navigation.js\";\nexport type {\n  AgentToolBinding,\n  AgentToolChatConfirmationConfig,\n  AgentToolPageConfirmationConfig,\n  AgentUIActionChildProps,\n  AgentUIActionEvent,\n  AgentUIActionProps,\n  UseAgentToolDefaultOptions,\n  UseAgentToolPageConfirmationOptions,\n} from \"./react.js\";\nexport type {\n  AgentToolConfirmationConfig,\n  RuntimeAgentTool,\n  ToolRuntime,\n  ToolOperation,\n  ToolRuntimeOptions,\n  ToolRuntimeToolChangeEvent,\n} from \"./runtime.js\";\nexport type {\n  AgentContextEntry,\n  AgentContextValue,\n  AgentToolDefinition,\n  AgentToolEffect,\n  AgentToolExecutionContext,\n  AgentToolExecutor,\n  AgentToolInputSchema,\n  InferJsonSchema,\n  JsonSchema,\n} from \"./types.js\";\n\nexport { registerAgentTool, type RegisteredAgentTool } from \"./registration.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAmC,MAAM,wBAAwB,CAAC;AAChG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC;AAqCpB,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAA4B,MAAM,mBAAmB,CAAC","sourcesContent":["export { defineAgentTool } from \"./definition.js\";\nexport { defineAgentNavigation } from \"./navigation.js\";\nexport { AgentOperationSurface, type AgentOperationSurfaceProps } from \"./operation-surface.js\";\nexport {\n  createToolRuntime,\n  isToolRuntimeError,\n} from \"./runtime.js\";\nexport {\n  AgentContext,\n  ToolsProvider,\n  AgentUIAction,\n  useAgentContext,\n  useAgentNavigation,\n  useAgentTool,\n} from \"./react.js\";\nexport type {\n  AgentNavigation,\n  AgentNavigationConfig,\n  AgentNavigationExecutors,\n  AgentNavigationRouteConfig,\n} from \"./navigation.js\";\nexport type {\n  AgentToolBinding,\n  AgentToolChatConfirmationConfig,\n  AgentToolPageConfirmationConfig,\n  AgentUIActionChildProps,\n  AgentUIActionEvent,\n  AgentUIActionProps,\n  UseAgentToolDefaultOptions,\n  UseAgentToolPageConfirmationOptions,\n} from \"./react.js\";\nexport type {\n  AgentToolConfirmationConfig,\n  RuntimeAgentTool,\n  ToolRuntime,\n  ToolOperation,\n  ToolRuntimeOptions,\n  ToolRuntimeToolChangeEvent,\n} from \"./runtime.js\";\nexport type {\n  AgentContextEntry,\n  AgentContextValue,\n  AgentToolDefinition,\n  AgentToolEffect,\n  AgentToolExecutionContext,\n  AgentToolExecutor,\n  AgentToolInputSchema,\n  InferJsonSchema,\n  JsonSchema,\n} from \"./types.js\";\n\nexport { createAgentToolRegistry, registerAgentTool, type RegisteredAgentTool } from \"./registration.js\";\n"]}

package/dist/registration.d.ts

@@ -9,3 +9,9 @@ export declare function registerAgentTool<TInput, TResult>(definition: AgentTool
     execute: RegisteredAgentTool<TInput, TResult>["execute"];
     requiresConfirmation?: never;
 }): RegisteredAgentTool<TInput, TResult>;
+export declare function createAgentToolRegistry(): {
+    register<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, options: {
+        execute: RegisteredAgentTool<TInput, TResult>["execute"];
+        requiresConfirmation?: never;
+    }): () => void;
+};

package/dist/registration.js

@@ -1,3 +1,5 @@
+import { defineAgentTool } from "./definition.js";
+import { toolRegistrySymbol } from "./shared/tool-registry.js";
 import { assertAgentToolInputSchema } from "./shared/schema.js";
 export function registerAgentTool(definition, options) {
     if (!definition || typeof definition.name !== "string" || typeof options?.execute !== "function") {
@@ -9,4 +11,25 @@ export function registerAgentTool(definition, options) {
     assertAgentToolInputSchema(definition.inputSchema, `Tool "${definition.name}".inputSchema`);
     return Object.freeze({ definition, execute: options.execute });
 }
+export function createAgentToolRegistry() {
+    const tools = new Map();
+    const registry = {
+        register(definition, options) {
+            const validated = registerAgentTool(definition, options);
+            if (tools.has(definition.name))
+                throw new TypeError(`Tool "${definition.name}" is already registered.`);
+            const copied = defineAgentTool(validated.definition);
+            const tool = Object.freeze({ definition: copied, execute: validated.execute });
+            tools.set(copied.name, tool);
+            return () => {
+                if (tools.get(copied.name) === tool)
+                    tools.delete(copied.name);
+            };
+        },
+    };
+    Object.defineProperty(registry, toolRegistrySymbol, {
+        value: Object.freeze({ getTools: () => [...tools.values()] }),
+    });
+    return Object.freeze(registry);
+}
 //# sourceMappingURL=registration.js.map

package/dist/registration.js.map

@@ -1 +1 @@
-{"version":3,"file":"registration.js","sourceRoot":"","sources":["../src/registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAQhE,MAAM,UAAU,iBAAiB,CAC/B,UAAgD,EAChD,OAAmG;IAEnG,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;QACjG,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,sBAAsB,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,SAAS,CAAC,6DAA6D,CAAC,CAAC;IACrF,CAAC;IACD,0BAA0B,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,UAAU,CAAC,IAAI,eAAe,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC","sourcesContent":["import { assertAgentToolInputSchema } from \"./shared/schema.js\";\nimport type { AgentToolDefinition } from \"./types.js\";\n\nexport interface RegisteredAgentTool<TInput = any, TResult = any> {\n  readonly definition: AgentToolDefinition<TInput, TResult>;\n  readonly execute: (input: TInput, context: { signal: AbortSignal }) => TResult | Promise<TResult>;\n}\n\nexport function registerAgentTool<TInput, TResult>(\n  definition: AgentToolDefinition<TInput, TResult>,\n  options: { execute: RegisteredAgentTool<TInput, TResult>[\"execute\"]; requiresConfirmation?: never },\n): RegisteredAgentTool<TInput, TResult> {\n  if (!definition || typeof definition.name !== \"string\" || typeof options?.execute !== \"function\") {\n    throw new TypeError(\"registerAgentTool requires a definition and execute function.\");\n  }\n  if (\"requiresConfirmation\" in options) {\n    throw new TypeError(\"Registered Agent tools do not support requiresConfirmation.\");\n  }\n  assertAgentToolInputSchema(definition.inputSchema, `Tool \"${definition.name}\".inputSchema`);\n  return Object.freeze({ definition, execute: options.execute });\n}\n"]}
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../src/registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAQhE,MAAM,UAAU,iBAAiB,CAC/B,UAAgD,EAChD,OAAmG;IAEnG,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;QACjG,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,sBAAsB,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,SAAS,CAAC,6DAA6D,CAAC,CAAC;IACrF,CAAC;IACD,0BAA0B,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,UAAU,CAAC,IAAI,eAAe,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,uBAAuB;IAMrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IACrD,MAAM,QAAQ,GAAG;QACf,QAAQ,CACN,UAAgD,EAChD,OAAmG;YAEnG,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACzD,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,SAAS,UAAU,CAAC,IAAI,0BAA0B,CAAC,CAAC;YACxG,MAAM,MAAM,GAAG,eAAe,CAAkB,SAAS,CAAC,UAAU,CAAC,CAAC;YACtE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/E,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO,GAAG,EAAE;gBACV,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI;oBAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjE,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE;QAClD,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;KAC9D,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC","sourcesContent":["import { defineAgentTool } from \"./definition.js\";\nimport { toolRegistrySymbol } from \"./shared/tool-registry.js\";\nimport { assertAgentToolInputSchema } from \"./shared/schema.js\";\nimport type { AgentToolDefinition } from \"./types.js\";\n\nexport interface RegisteredAgentTool<TInput = any, TResult = any> {\n  readonly definition: AgentToolDefinition<TInput, TResult>;\n  readonly execute: (input: TInput, context: { signal: AbortSignal }) => TResult | Promise<TResult>;\n}\n\nexport function registerAgentTool<TInput, TResult>(\n  definition: AgentToolDefinition<TInput, TResult>,\n  options: { execute: RegisteredAgentTool<TInput, TResult>[\"execute\"]; requiresConfirmation?: never },\n): RegisteredAgentTool<TInput, TResult> {\n  if (!definition || typeof definition.name !== \"string\" || typeof options?.execute !== \"function\") {\n    throw new TypeError(\"registerAgentTool requires a definition and execute function.\");\n  }\n  if (\"requiresConfirmation\" in options) {\n    throw new TypeError(\"Registered Agent tools do not support requiresConfirmation.\");\n  }\n  assertAgentToolInputSchema(definition.inputSchema, `Tool \"${definition.name}\".inputSchema`);\n  return Object.freeze({ definition, execute: options.execute });\n}\n\nexport function createAgentToolRegistry(): {\n  register<TInput, TResult>(\n    definition: AgentToolDefinition<TInput, TResult>,\n    options: { execute: RegisteredAgentTool<TInput, TResult>[\"execute\"]; requiresConfirmation?: never },\n  ): () => void;\n} {\n  const tools = new Map<string, RegisteredAgentTool>();\n  const registry = {\n    register<TInput, TResult>(\n      definition: AgentToolDefinition<TInput, TResult>,\n      options: { execute: RegisteredAgentTool<TInput, TResult>[\"execute\"]; requiresConfirmation?: never },\n    ): () => void {\n      const validated = registerAgentTool(definition, options);\n      if (tools.has(definition.name)) throw new TypeError(`Tool \"${definition.name}\" is already registered.`);\n      const copied = defineAgentTool<TInput, TResult>(validated.definition);\n      const tool = Object.freeze({ definition: copied, execute: validated.execute });\n      tools.set(copied.name, tool);\n      return () => {\n        if (tools.get(copied.name) === tool) tools.delete(copied.name);\n      };\n    },\n  };\n  Object.defineProperty(registry, toolRegistrySymbol, {\n    value: Object.freeze({ getTools: () => [...tools.values()] }),\n  });\n  return Object.freeze(registry);\n}\n"]}

package/dist/shared/tool-registry.d.ts

@@ -0,0 +1,6 @@
+import type { createAgentToolRegistry, RegisteredAgentTool } from "../registration.js";
+export declare const toolRegistrySymbol: unique symbol;
+export interface ToolRegistryController {
+    getTools(): readonly RegisteredAgentTool[];
+}
+export declare function getToolRegistryController(registry: ReturnType<typeof createAgentToolRegistry>): ToolRegistryController;

package/dist/shared/tool-registry.js

@@ -0,0 +1,10 @@
+// Generated from shared/tool-registry.ts. Do not edit manually.
+export const toolRegistrySymbol = Symbol.for("@nexface/tools/tool-registry");
+export function getToolRegistryController(registry) {
+    const controller = registry?.[toolRegistrySymbol];
+    if (!controller || typeof controller.getTools !== "function") {
+        throw new TypeError("toolRegistry must be created by createAgentToolRegistry(). Use matching Nexface package versions.");
+    }
+    return controller;
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/shared/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/shared/tool-registry.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAIhE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAM7E,MAAM,UAAU,yBAAyB,CAAC,QAAoD;IAC5F,MAAM,UAAU,GAAI,QAAgF,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC3H,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC7D,MAAM,IAAI,SAAS,CAAC,mGAAmG,CAAC,CAAC;IAC3H,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["// Generated from shared/tool-registry.ts. Do not edit manually.\n\nimport type { createAgentToolRegistry, RegisteredAgentTool } from \"../registration.js\";\n\nexport const toolRegistrySymbol = Symbol.for(\"@nexface/tools/tool-registry\");\n\nexport interface ToolRegistryController {\n  getTools(): readonly RegisteredAgentTool[];\n}\n\nexport function getToolRegistryController(registry: ReturnType<typeof createAgentToolRegistry>): ToolRegistryController {\n  const controller = (registry as typeof registry & { [toolRegistrySymbol]?: ToolRegistryController })?.[toolRegistrySymbol];\n  if (!controller || typeof controller.getTools !== \"function\") {\n    throw new TypeError(\"toolRegistry must be created by createAgentToolRegistry(). Use matching Nexface package versions.\");\n  }\n  return controller;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexface/tools",
-  "version": "0.1.13",
+  "version": "0.1.15-alpha.0",
   "type": "module",
   "exports": {
     ".": {