veryfront 0.1.322 → 0.1.323

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.322",
+    "version": "0.1.323",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [

package/esm/src/tool/host-tools.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import type { JsonSchema } from "./schema/json-schema.js";
+import type { Tool, ToolConfig, ToolExecutionContext } from "./types.js";
+export interface HostToolDefinition {
+    description: string;
+    inputSchema: z.ZodSchema<unknown>;
+    inputSchemaJson?: JsonSchema;
+    execute: (input: unknown, context: ToolExecutionContext) => Promise<unknown> | unknown;
+    mcp?: ToolConfig["mcp"];
+}
+export interface HostToolMaterializationOptions {
+    generateToolCallId?: (toolName: string) => string;
+}
+export declare function createToolsFromHostDefinitions(definitions: Record<string, unknown>, options?: HostToolMaterializationOptions): Record<string, Tool<unknown, unknown>>;
+//# sourceMappingURL=host-tools.d.ts.map

package/esm/src/tool/host-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-tools.d.ts","sourceRoot":"","sources":["../../../src/src/tool/host-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACvF,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAwCD,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,GAAE,8BAAmC,GAC3C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAgCxC"}

package/esm/src/tool/host-tools.js

@@ -0,0 +1,60 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { dynamicTool, tool } from "./factory.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isZodSchema(value) {
+    if (!isRecord(value) || typeof value.parse !== "function")
+        return false;
+    if (!isRecord(value._def))
+        return false;
+    return typeof value._def.typeName === "string" || typeof value._def.type === "string";
+}
+function isHostToolDefinition(value) {
+    return (isRecord(value) &&
+        typeof value.description === "string" &&
+        isZodSchema(value.inputSchema) &&
+        typeof value.execute === "function");
+}
+function defaultToolCallId(toolName) {
+    return `${toolName}-${dntShim.crypto.randomUUID()}`;
+}
+function normalizeExecutionContext(toolName, context, options) {
+    const toolCallId = typeof context?.toolCallId === "string" && context.toolCallId.length > 0
+        ? context.toolCallId
+        : (options.generateToolCallId ?? defaultToolCallId)(toolName);
+    return {
+        ...(isRecord(context) ? context : {}),
+        toolCallId,
+    };
+}
+export function createToolsFromHostDefinitions(definitions, options = {}) {
+    const tools = {};
+    for (const [toolName, definition] of Object.entries(definitions)) {
+        if (!isHostToolDefinition(definition))
+            continue;
+        const execute = async (input, context) => await definition.execute(input, normalizeExecutionContext(toolName, context, options));
+        try {
+            tools[toolName] = definition.inputSchemaJson
+                ? dynamicTool({
+                    id: toolName,
+                    description: definition.description,
+                    inputSchema: definition.inputSchema,
+                    inputSchemaJson: definition.inputSchemaJson,
+                    execute,
+                    mcp: definition.mcp,
+                })
+                : tool({
+                    id: toolName,
+                    description: definition.description,
+                    inputSchema: definition.inputSchema,
+                    execute,
+                    mcp: definition.mcp,
+                });
+        }
+        catch {
+            continue;
+        }
+    }
+    return tools;
+}

package/esm/src/tool/index.d.ts

@@ -50,6 +50,8 @@ export { createRemoteMCPToolSource } from "./remote-mcp.js";
 export type { RemoteMCPToolSourceConfig } from "./remote-mcp.js";
 export { createContext7ToolSource } from "./context7.js";
 export type { Context7ToolSourceConfig } from "./context7.js";
+export { createToolsFromHostDefinitions } from "./host-tools.js";
+export type { HostToolDefinition, HostToolMaterializationOptions } from "./host-tools.js";
 export { createToolsFromRemoteDefinitions, loadRemoteToolsFromSource, } from "./remote-source-tools.js";
 export type { RemoteToolMaterializationOptions } from "./remote-source-tools.js";
 export { toolRegistry } from "./registry.js";

package/esm/src/tool/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/esm/src/tool/index.js

@@ -46,6 +46,7 @@ import "../../_dnt.polyfills.js";
 export { dynamicTool, tool } from "./factory.js";
 export { createRemoteMCPToolSource } from "./remote-mcp.js";
 export { createContext7ToolSource } from "./context7.js";
+export { createToolsFromHostDefinitions } from "./host-tools.js";
 export { createToolsFromRemoteDefinitions, loadRemoteToolsFromSource, } from "./remote-source-tools.js";
 export { toolRegistry } from "./registry.js";
 export { executeTool } from "./executor.js";

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.322";
+export declare const VERSION = "0.1.323";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.322";
+export const VERSION = "0.1.323";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.322",
+  "version": "0.1.323",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.322",
+  "version": "0.1.323",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/tool/host-tools.ts

@@ -0,0 +1,92 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { z } from "zod";
+import { dynamicTool, tool } from "./factory.js";
+import type { JsonSchema } from "./schema/json-schema.js";
+import type { Tool, ToolConfig, ToolExecutionContext } from "./types.js";
+
+export interface HostToolDefinition {
+  description: string;
+  inputSchema: z.ZodSchema<unknown>;
+  inputSchemaJson?: JsonSchema;
+  execute: (input: unknown, context: ToolExecutionContext) => Promise<unknown> | unknown;
+  mcp?: ToolConfig["mcp"];
+}
+
+export interface HostToolMaterializationOptions {
+  generateToolCallId?: (toolName: string) => string;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function isZodSchema(value: unknown): value is z.ZodSchema<unknown> {
+  if (!isRecord(value) || typeof value.parse !== "function") return false;
+  if (!isRecord(value._def)) return false;
+  return typeof value._def.typeName === "string" || typeof value._def.type === "string";
+}
+
+function isHostToolDefinition(value: unknown): value is HostToolDefinition {
+  return (
+    isRecord(value) &&
+    typeof value.description === "string" &&
+    isZodSchema(value.inputSchema) &&
+    typeof value.execute === "function"
+  );
+}
+
+function defaultToolCallId(toolName: string): string {
+  return `${toolName}-${dntShim.crypto.randomUUID()}`;
+}
+
+function normalizeExecutionContext(
+  toolName: string,
+  context: ToolExecutionContext | undefined,
+  options: HostToolMaterializationOptions,
+): ToolExecutionContext {
+  const toolCallId = typeof context?.toolCallId === "string" && context.toolCallId.length > 0
+    ? context.toolCallId
+    : (options.generateToolCallId ?? defaultToolCallId)(toolName);
+
+  return {
+    ...(isRecord(context) ? context : {}),
+    toolCallId,
+  };
+}
+
+export function createToolsFromHostDefinitions(
+  definitions: Record<string, unknown>,
+  options: HostToolMaterializationOptions = {},
+): Record<string, Tool<unknown, unknown>> {
+  const tools: Record<string, Tool<unknown, unknown>> = {};
+
+  for (const [toolName, definition] of Object.entries(definitions)) {
+    if (!isHostToolDefinition(definition)) continue;
+
+    const execute = async (input: unknown, context: ToolExecutionContext | undefined) =>
+      await definition.execute(input, normalizeExecutionContext(toolName, context, options));
+
+    try {
+      tools[toolName] = definition.inputSchemaJson
+        ? dynamicTool({
+          id: toolName,
+          description: definition.description,
+          inputSchema: definition.inputSchema,
+          inputSchemaJson: definition.inputSchemaJson,
+          execute,
+          mcp: definition.mcp,
+        })
+        : tool({
+          id: toolName,
+          description: definition.description,
+          inputSchema: definition.inputSchema,
+          execute,
+          mcp: definition.mcp,
+        });
+    } catch {
+      continue;
+    }
+  }
+
+  return tools;
+}

package/src/src/tool/index.ts

@@ -60,6 +60,8 @@ export { createRemoteMCPToolSource } from "./remote-mcp.js";
 export type { RemoteMCPToolSourceConfig } from "./remote-mcp.js";
 export { createContext7ToolSource } from "./context7.js";
 export type { Context7ToolSourceConfig } from "./context7.js";
+export { createToolsFromHostDefinitions } from "./host-tools.js";
+export type { HostToolDefinition, HostToolMaterializationOptions } from "./host-tools.js";
 export {
   createToolsFromRemoteDefinitions,
   loadRemoteToolsFromSource,

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.322";
+export const VERSION = "0.1.323";