veryfront 0.1.345 → 0.1.347

package/esm/deno.js

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

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

@@ -46,6 +46,8 @@ import "../../_dnt.polyfills.js";
 export type { RemoteToolSource, Tool, ToolConfig, ToolDefinition, ToolExecutionContext, ToolExecutionDataEvent, ToolSet, } from "./types.js";
 export { dynamicTool, tool } from "./factory.js";
 export type { DynamicToolConfig } from "./factory.js";
+export { createSleepTool, DEFAULT_SLEEP_TOOL_MAX_SECONDS, sleepTool } from "./sleep.js";
+export type { CreateSleepToolOptions, SleepToolInput, SleepToolOutput, SleepToolWait, } from "./sleep.js";
 export { createRemoteMCPToolSource } from "./remote-mcp.js";
 export type { RemoteMCPToolSourceConfig } from "./remote-mcp.js";
 export { createContext7ToolSource } from "./context7.js";
@@ -54,6 +56,8 @@ export { createToolsFromHostDefinitions } from "./host-tools.js";
 export type { HostToolDefinition, HostToolMaterializationOptions, HostToolSet, } from "./host-tools.js";
 export { createToolsFromRemoteDefinitions, loadRemoteToolsFromSource, } from "./remote-source-tools.js";
 export type { RemoteToolMaterializationOptions } from "./remote-source-tools.js";
+export { traceHostTools } from "./tracing.js";
+export type { HostToolTraceAttributeInput, HostToolTraceAttributes, HostToolTraceRunner, TraceHostToolsOptions, } from "./tracing.js";
 export { filterProjectScopedRemoteToolDefinitions, hydrateProjectScopedRemoteToolInput, isProjectNavigationRemoteTool, } from "./project-scoped-remote-tools.js";
 export type { ProjectScopedRemoteToolOptions } from "./project-scoped-remote-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,EACtB,OAAO,GACR,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,EACV,kBAAkB,EAClB,8BAA8B,EAC9B,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EACL,wCAAwC,EACxC,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAEvF,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,EACtB,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,8BAA8B,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxF,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,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,EACV,kBAAkB,EAClB,8BAA8B,EAC9B,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wCAAwC,EACxC,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAEvF,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

@@ -44,10 +44,12 @@
  */
 import "../../_dnt.polyfills.js";
 export { dynamicTool, tool } from "./factory.js";
+export { createSleepTool, DEFAULT_SLEEP_TOOL_MAX_SECONDS, sleepTool } from "./sleep.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 { traceHostTools } from "./tracing.js";
 export { filterProjectScopedRemoteToolDefinitions, hydrateProjectScopedRemoteToolInput, isProjectNavigationRemoteTool, } from "./project-scoped-remote-tools.js";
 export { toolRegistry } from "./registry.js";
 export { executeTool } from "./executor.js";

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

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const DEFAULT_SLEEP_TOOL_MAX_SECONDS = 60;
+export type SleepToolWait = (milliseconds: number) => Promise<void> | void;
+export type CreateSleepToolOptions = {
+    maxSeconds?: number;
+    wait?: SleepToolWait;
+};
+declare function createSleepToolInputSchema(maxSeconds: number): z.ZodObject<{
+    seconds: z.ZodNumber;
+}, z.core.$strip>;
+export type SleepToolInput = z.infer<ReturnType<typeof createSleepToolInputSchema>>;
+export type SleepToolOutput = {
+    sleptFor: number;
+    message: string;
+};
+export declare function createSleepTool(options?: CreateSleepToolOptions): import("./types.js").Tool<{
+    seconds: number;
+}, SleepToolOutput>;
+export declare const sleepTool: import("./types.js").Tool<{
+    seconds: number;
+}, SleepToolOutput>;
+export {};
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/src/tool/sleep.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE3E,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAOF,iBAAS,0BAA0B,CAAC,UAAU,EAAE,MAAM;;kBAMrD;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC;AAEpF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B;;oBAkBnE;AAED,eAAO,MAAM,SAAS;;mBAAoB,CAAC"}

package/esm/src/tool/sleep.js

@@ -0,0 +1,30 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { z } from "zod";
+import { tool } from "./factory.js";
+export const DEFAULT_SLEEP_TOOL_MAX_SECONDS = 60;
+const defaultSleepToolWait = (milliseconds) => new Promise((resolve) => {
+    dntShim.setTimeout(resolve, milliseconds);
+});
+function createSleepToolInputSchema(maxSeconds) {
+    return z.object({
+        seconds: z.number().min(1).max(maxSeconds).describe(`Number of seconds to wait (1-${maxSeconds})`),
+    });
+}
+export function createSleepTool(options = {}) {
+    const maxSeconds = options.maxSeconds ?? DEFAULT_SLEEP_TOOL_MAX_SECONDS;
+    const wait = options.wait ?? defaultSleepToolWait;
+    return tool({
+        id: "sleep",
+        description: `Wait for a specified number of seconds before continuing. Use this when a task needs to pause execution, such as waiting for an external process to complete or adding a delay between operations. Maximum sleep time is ${maxSeconds} seconds.`,
+        inputSchema: createSleepToolInputSchema(maxSeconds),
+        execute: async ({ seconds }) => {
+            const clampedSeconds = Math.min(Math.max(1, seconds), maxSeconds);
+            await wait(clampedSeconds * 1000);
+            return {
+                sleptFor: clampedSeconds,
+                message: `Waited for ${clampedSeconds} second${clampedSeconds === 1 ? "" : "s"}`,
+            };
+        },
+    });
+}
+export const sleepTool = createSleepTool();

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

@@ -0,0 +1,17 @@
+import type { HostToolSet } from "./host-tools.js";
+import type { ToolExecutionContext } from "./types.js";
+export type HostToolTraceRunner = <TResult>(spanName: string, operation: () => TResult) => TResult;
+export type HostToolTraceAttributes = Record<string, unknown>;
+export type HostToolTraceAttributeInput = {
+    toolName: string;
+    toolCallId: string | undefined;
+    context: ToolExecutionContext | undefined;
+};
+export type TraceHostToolsOptions = {
+    trace: HostToolTraceRunner;
+    buildAttributes?: (input: HostToolTraceAttributeInput) => HostToolTraceAttributes | undefined;
+    setAttributes?: (attributes: HostToolTraceAttributes) => void;
+    getSpanName?: (toolName: string) => string;
+};
+export declare function traceHostTools(tools: HostToolSet, options: TraceHostToolsOptions): HostToolSet;
+//# sourceMappingURL=tracing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/src/tool/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,OAAO,KACrB,OAAO,CAAC;AAEb,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,2BAA2B,KAC/B,uBAAuB,GAAG,SAAS,CAAC;IACzC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC9D,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAUF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,qBAAqB,GAC7B,WAAW,CA6Bb"}

package/esm/src/tool/tracing.js

@@ -0,0 +1,32 @@
+function defaultSpanName(toolName) {
+    return `tool.${toolName}`;
+}
+function getToolCallId(context) {
+    return typeof context?.toolCallId === "string" ? context.toolCallId : undefined;
+}
+export function traceHostTools(tools, options) {
+    const traced = {};
+    const getSpanName = options.getSpanName ?? defaultSpanName;
+    for (const [toolName, definition] of Object.entries(tools)) {
+        if (!definition.execute) {
+            traced[toolName] = definition;
+            continue;
+        }
+        const originalExecute = definition.execute;
+        traced[toolName] = {
+            ...definition,
+            execute: (input, context) => options.trace(getSpanName(toolName), () => {
+                const attributes = options.buildAttributes?.({
+                    toolName,
+                    toolCallId: getToolCallId(context),
+                    context,
+                });
+                if (attributes) {
+                    options.setAttributes?.(attributes);
+                }
+                return originalExecute(input, context);
+            }),
+        };
+    }
+    return traced;
+}

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.345";
+export declare const VERSION = "0.1.347";
 //# 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.345";
+export const VERSION = "0.1.347";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.345",
+  "version": "0.1.347",
   "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.345",
+  "version": "0.1.347",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/tool/index.ts

@@ -57,6 +57,13 @@ export type {
 
 export { dynamicTool, tool } from "./factory.js";
 export type { DynamicToolConfig } from "./factory.js";
+export { createSleepTool, DEFAULT_SLEEP_TOOL_MAX_SECONDS, sleepTool } from "./sleep.js";
+export type {
+  CreateSleepToolOptions,
+  SleepToolInput,
+  SleepToolOutput,
+  SleepToolWait,
+} from "./sleep.js";
 export { createRemoteMCPToolSource } from "./remote-mcp.js";
 export type { RemoteMCPToolSourceConfig } from "./remote-mcp.js";
 export { createContext7ToolSource } from "./context7.js";
@@ -72,6 +79,13 @@ export {
   loadRemoteToolsFromSource,
 } from "./remote-source-tools.js";
 export type { RemoteToolMaterializationOptions } from "./remote-source-tools.js";
+export { traceHostTools } from "./tracing.js";
+export type {
+  HostToolTraceAttributeInput,
+  HostToolTraceAttributes,
+  HostToolTraceRunner,
+  TraceHostToolsOptions,
+} from "./tracing.js";
 export {
   filterProjectScopedRemoteToolDefinitions,
   hydrateProjectScopedRemoteToolInput,

package/src/src/tool/sleep.ts

@@ -0,0 +1,54 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { z } from "zod";
+import { tool } from "./factory.js";
+
+export const DEFAULT_SLEEP_TOOL_MAX_SECONDS = 60;
+
+export type SleepToolWait = (milliseconds: number) => Promise<void> | void;
+
+export type CreateSleepToolOptions = {
+  maxSeconds?: number;
+  wait?: SleepToolWait;
+};
+
+const defaultSleepToolWait: SleepToolWait = (milliseconds) =>
+  new Promise((resolve) => {
+    dntShim.setTimeout(resolve, milliseconds);
+  });
+
+function createSleepToolInputSchema(maxSeconds: number) {
+  return z.object({
+    seconds: z.number().min(1).max(maxSeconds).describe(
+      `Number of seconds to wait (1-${maxSeconds})`,
+    ),
+  });
+}
+
+export type SleepToolInput = z.infer<ReturnType<typeof createSleepToolInputSchema>>;
+
+export type SleepToolOutput = {
+  sleptFor: number;
+  message: string;
+};
+
+export function createSleepTool(options: CreateSleepToolOptions = {}) {
+  const maxSeconds = options.maxSeconds ?? DEFAULT_SLEEP_TOOL_MAX_SECONDS;
+  const wait = options.wait ?? defaultSleepToolWait;
+
+  return tool<SleepToolInput, SleepToolOutput>({
+    id: "sleep",
+    description:
+      `Wait for a specified number of seconds before continuing. Use this when a task needs to pause execution, such as waiting for an external process to complete or adding a delay between operations. Maximum sleep time is ${maxSeconds} seconds.`,
+    inputSchema: createSleepToolInputSchema(maxSeconds),
+    execute: async ({ seconds }) => {
+      const clampedSeconds = Math.min(Math.max(1, seconds), maxSeconds);
+      await wait(clampedSeconds * 1000);
+      return {
+        sleptFor: clampedSeconds,
+        message: `Waited for ${clampedSeconds} second${clampedSeconds === 1 ? "" : "s"}`,
+      };
+    },
+  });
+}
+
+export const sleepTool = createSleepTool();

package/src/src/tool/tracing.ts

@@ -0,0 +1,66 @@
+import type { HostToolSet } from "./host-tools.js";
+import type { ToolExecutionContext } from "./types.js";
+
+export type HostToolTraceRunner = <TResult>(
+  spanName: string,
+  operation: () => TResult,
+) => TResult;
+
+export type HostToolTraceAttributes = Record<string, unknown>;
+
+export type HostToolTraceAttributeInput = {
+  toolName: string;
+  toolCallId: string | undefined;
+  context: ToolExecutionContext | undefined;
+};
+
+export type TraceHostToolsOptions = {
+  trace: HostToolTraceRunner;
+  buildAttributes?: (
+    input: HostToolTraceAttributeInput,
+  ) => HostToolTraceAttributes | undefined;
+  setAttributes?: (attributes: HostToolTraceAttributes) => void;
+  getSpanName?: (toolName: string) => string;
+};
+
+function defaultSpanName(toolName: string): string {
+  return `tool.${toolName}`;
+}
+
+function getToolCallId(context: ToolExecutionContext | undefined): string | undefined {
+  return typeof context?.toolCallId === "string" ? context.toolCallId : undefined;
+}
+
+export function traceHostTools(
+  tools: HostToolSet,
+  options: TraceHostToolsOptions,
+): HostToolSet {
+  const traced: HostToolSet = {};
+  const getSpanName = options.getSpanName ?? defaultSpanName;
+
+  for (const [toolName, definition] of Object.entries(tools)) {
+    if (!definition.execute) {
+      traced[toolName] = definition;
+      continue;
+    }
+
+    const originalExecute = definition.execute;
+    traced[toolName] = {
+      ...definition,
+      execute: (input: unknown, context: ToolExecutionContext | undefined) =>
+        options.trace(getSpanName(toolName), () => {
+          const attributes = options.buildAttributes?.({
+            toolName,
+            toolCallId: getToolCallId(context),
+            context,
+          });
+          if (attributes) {
+            options.setAttributes?.(attributes);
+          }
+          return originalExecute(input, context);
+        }),
+    };
+  }
+
+  return traced;
+}

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.345";
+export const VERSION = "0.1.347";