veryfront 0.1.346 → 0.1.348

package/esm/deno.js

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

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

@@ -56,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,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,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

@@ -49,6 +49,7 @@ 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/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<TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes> = {
+    trace: HostToolTraceRunner;
+    buildAttributes?: (input: HostToolTraceAttributeInput) => TAttributes | undefined;
+    setAttributes?: (attributes: TAttributes) => void;
+    getSpanName?: (toolName: string) => string;
+};
+export declare function traceHostTools<TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes>(tools: HostToolSet, options: TraceHostToolsOptions<TAttributes>): 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,CAC/B,WAAW,SAAS,uBAAuB,GAAG,uBAAuB,IACnE;IACF,KAAK,EAAE,mBAAmB,CAAC;IAC3B,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,2BAA2B,KAC/B,WAAW,GAAG,SAAS,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,IAAI,CAAC;IAClD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAUF,wBAAgB,cAAc,CAC5B,WAAW,SAAS,uBAAuB,GAAG,uBAAuB,EAErE,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC1C,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.346";
+export declare const VERSION = "0.1.348";
 //# 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.346";
+export const VERSION = "0.1.348";

package/package.json

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

package/src/src/tool/index.ts

@@ -79,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/tracing.ts

@@ -0,0 +1,70 @@
+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<
+  TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes,
+> = {
+  trace: HostToolTraceRunner;
+  buildAttributes?: (
+    input: HostToolTraceAttributeInput,
+  ) => TAttributes | undefined;
+  setAttributes?: (attributes: TAttributes) => 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<
+  TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes,
+>(
+  tools: HostToolSet,
+  options: TraceHostToolsOptions<TAttributes>,
+): 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.346";
+export const VERSION = "0.1.348";