@lunora/agent 1.0.0-alpha.4 → 1.0.0-alpha.5

package/dist/telemetry/index.d.mts

@@ -1,41 +1,41 @@
 import { Telemetry } from 'ai';
 /**
-* Privacy options shared by every telemetry integration in this package.
-*
-* Both flags default to **FALSE**. Without an explicit opt-in, no prompt,
-* message, tool input, generated model text, or tool output is ever forwarded
-* to a downstream tracer — only structural metadata (model id, finish reason,
-* token counts, tool name, timing, success/failure) is recorded. This is the
-* privacy-safe default: turn recording on deliberately, per integration.
-* @experimental
-*/
+ * Privacy options shared by every telemetry integration in this package.
+ *
+ * Both flags default to **FALSE**. Without an explicit opt-in, no prompt,
+ * message, tool input, generated model text, or tool output is ever forwarded
+ * to a downstream tracer — only structural metadata (model id, finish reason,
+ * token counts, tool name, timing, success/failure) is recorded. This is the
+ * privacy-safe default: turn recording on deliberately, per integration.
+ * @experimental
+ */
 interface CommonOptions {
   /**
-  * When `true`, record model/tool **input** — prompts, messages, and tool
-  * call arguments. Default `false`.
-  */
+   * When `true`, record model/tool **input** — prompts, messages, and tool
+   * call arguments. Default `false`.
+   */
   recordInputs?: boolean;
   /**
-  * When `true`, record model/tool **output** — generated text and tool
-  * results. Default `false`.
-  */
+   * When `true`, record model/tool **output** — generated text and tool
+   * results. Default `false`.
+   */
   recordOutputs?: boolean;
 }
 /**
-* The span handle a {@link BraintrustLike.traced} callback receives.
-* @experimental
-*/
+ * The span handle a {@link BraintrustLike.traced} callback receives.
+ * @experimental
+ */
 interface BraintrustSpan {
   /** Attach structured fields to the current span. */
   log: (event: Record<string, unknown>) => void;
 }
 /**
-* The minimal, **structural** slice of the `braintrust` SDK this bridge needs.
-* `braintrust` is intentionally **not** a dependency — the app passes its own
-* initialized logger, so this package stays dependency-free and works with any
-* compatible Braintrust SDK version.
-* @experimental
-*/
+ * The minimal, **structural** slice of the `braintrust` SDK this bridge needs.
+ * `braintrust` is intentionally **not** a dependency — the app passes its own
+ * initialized logger, so this package stays dependency-free and works with any
+ * compatible Braintrust SDK version.
+ * @experimental
+ */
 interface BraintrustLike {
   /** Run `callback` inside a new traced span and return its result. */
   traced: <T>(callback: (span: BraintrustSpan) => T, args?: {
@@ -44,92 +44,92 @@ interface BraintrustLike {
   }) => T;
 }
 /**
-* Options for {@link braintrustTelemetry}.
-* @experimental
-*/
+ * Options for {@link braintrustTelemetry}.
+ * @experimental
+ */
 interface BraintrustTelemetryOptions extends CommonOptions {
   /** Span-name prefix for the language-model call (e.g. the agent name). */
   functionId?: string;
   /**
-  * The caller's initialized Braintrust logger (dependency-injected). Import
-  * and initialize `braintrust` in your app and pass it as `logger`.
-  */
+   * The caller's initialized Braintrust logger (dependency-injected). Import
+   * and initialize `braintrust` in your app and pass it as `logger`.
+   */
   logger: BraintrustLike;
 }
 /**
-* A dependency-injected Braintrust bridge for the ai@7 telemetry surface.
-*
-* It wraps model calls (`type: "llm"`) and tool executions (`type: "tool"`) in
-* `logger.traced` spans and logs structural metadata. Prompts / tool arguments
-* are logged only when `recordInputs` is set; generated text / tool results
-* only when `recordOutputs` is set. `onError` opens a span and logs the error.
-*
-* The app owns Braintrust initialization; pass the logger in as `logger`.
-* @experimental
-*/
+ * A dependency-injected Braintrust bridge for the ai@7 telemetry surface.
+ *
+ * It wraps model calls (`type: "llm"`) and tool executions (`type: "tool"`) in
+ * `logger.traced` spans and logs structural metadata. Prompts / tool arguments
+ * are logged only when `recordInputs` is set; generated text / tool results
+ * only when `recordOutputs` is set. `onError` opens a span and logs the error.
+ *
+ * The app owns Braintrust initialization; pass the logger in as `logger`.
+ * @experimental
+ */
 declare const braintrustTelemetry: (options: BraintrustTelemetryOptions) => Telemetry;
 /**
-* Combine several {@link Telemetry} integrations into a single one that fans
-* every lifecycle callback out to all of them and nests the two execution
-* wrappers so multiple span-context wrappers compose correctly.
-*
-* Value callbacks (`onStart`, `onStepEnd`, `onToolExecutionEnd`, …) invoke each
-* integration's matching callback (guarding `undefined`) and await them all in
-* parallel. The wrappers (`executeLanguageModelCall`, `executeTool`) are
-* composed by nesting right-to-left; integrations without a wrapper are skipped,
-* and with none defined the plain `execute` still runs.
-* @experimental
-*/
+ * Combine several {@link Telemetry} integrations into a single one that fans
+ * every lifecycle callback out to all of them and nests the two execution
+ * wrappers so multiple span-context wrappers compose correctly.
+ *
+ * Value callbacks (`onStart`, `onStepEnd`, `onToolExecutionEnd`, …) invoke each
+ * integration's matching callback (guarding `undefined`) and await them all in
+ * parallel. The wrappers (`executeLanguageModelCall`, `executeTool`) are
+ * composed by nesting right-to-left; integrations without a wrapper are skipped,
+ * and with none defined the plain `execute` still runs.
+ * @experimental
+ */
 declare const combineTelemetry: (...integrations: Telemetry[]) => Telemetry;
 /**
-* Severity level passed to a {@link ConsoleLogger}.
-* @experimental
-*/
+ * Severity level passed to a {@link ConsoleLogger}.
+ * @experimental
+ */
 type ConsoleLogLevel = "error" | "info" | "warn";
 /**
-* Structured log sink. Receives a level, a static human message, and a bag of
-* structured fields (never interpolated into the message, so log processors can
-* index them). The default sink writes to `globalThis.console`.
-* @experimental
-*/
+ * Structured log sink. Receives a level, a static human message, and a bag of
+ * structured fields (never interpolated into the message, so log processors can
+ * index them). The default sink writes to `globalThis.console`.
+ * @experimental
+ */
 type ConsoleLogger = (level: ConsoleLogLevel, message: string, fields: Record<string, unknown>) => void;
 /**
-* Options for {@link consoleTelemetry}.
-* @experimental
-*/
+ * Options for {@link consoleTelemetry}.
+ * @experimental
+ */
 interface ConsoleTelemetryOptions extends CommonOptions {
   /**
-  * Identifier prefixed into every log message (e.g. the agent name). Helps
-  * correlate lines when several agents share one process. Optional.
-  */
+   * Identifier prefixed into every log message (e.g. the agent name). Helps
+   * correlate lines when several agents share one process. Optional.
+   */
   functionId?: string;
   /**
-  * Sink for structured log lines. Defaults to a `globalThis.console`-backed
-  * writer that routes `info`/`warn`/`error` to the matching console method.
-  */
+   * Sink for structured log lines. Defaults to a `globalThis.console`-backed
+   * writer that routes `info`/`warn`/`error` to the matching console method.
+   */
   logger?: ConsoleLogger;
 }
 /**
-* A zero-dependency structured tracer for the ai@7 telemetry surface.
-*
-* It maps the generation lifecycle onto {@link ConsoleLogger} calls: operation
-* start/end, per-step start/end, model-call end (model + finish reason +
-* usage), and tool start/end (name, success, timing). By default it records
-* **only structural metadata** — set `recordInputs` to also log prompts / tool
-* arguments, and `recordOutputs` to log generated text / tool results.
-*
-* Every callback is defensive (event fields may be absent) and synchronous.
-* @experimental
-*/
+ * A zero-dependency structured tracer for the ai@7 telemetry surface.
+ *
+ * It maps the generation lifecycle onto {@link ConsoleLogger} calls: operation
+ * start/end, per-step start/end, model-call end (model + finish reason +
+ * usage), and tool start/end (name, success, timing). By default it records
+ * **only structural metadata** — set `recordInputs` to also log prompts / tool
+ * arguments, and `recordOutputs` to log generated text / tool results.
+ *
+ * Every callback is defensive (event fields may be absent) and synchronous.
+ * @experimental
+ */
 declare const consoleTelemetry: (options?: ConsoleTelemetryOptions) => Telemetry;
 /**
-* The minimal, **structural** slice of `@sentry/cloudflare` (equivalently
-* `@sentry/node`/`@sentry/browser`) this bridge needs. `@sentry/cloudflare` is
-* intentionally **not** a dependency — the app passes its own already-initialized
-* Sentry namespace, so this package stays dependency-free and works with any
-* compatible Sentry SDK version.
-* @experimental
-*/
+ * The minimal, **structural** slice of `@sentry/cloudflare` (equivalently
+ * `@sentry/node`/`@sentry/browser`) this bridge needs. `@sentry/cloudflare` is
+ * intentionally **not** a dependency — the app passes its own already-initialized
+ * Sentry namespace, so this package stays dependency-free and works with any
+ * compatible Sentry SDK version.
+ * @experimental
+ */
 interface SentryLike {
   /** Capture a thrown value / exception. */
   captureException: (exception: unknown) => unknown;
@@ -145,29 +145,29 @@ interface SentryLike {
   }) => T) => T;
 }
 /**
-* Options for {@link sentryTelemetry}.
-* @experimental
-*/
+ * Options for {@link sentryTelemetry}.
+ * @experimental
+ */
 interface SentryTelemetryOptions extends CommonOptions {
   /** Span-name prefix for the language-model call (e.g. the agent name). */
   functionId?: string;
   /**
-  * The caller's already-initialized Sentry namespace (dependency-injected).
-  * `import * as Sentry from "@sentry/cloudflare"` and pass it as `Sentry`.
-  */
+   * The caller's already-initialized Sentry namespace (dependency-injected).
+   * `import * as Sentry from "@sentry/cloudflare"` and pass it as `Sentry`.
+   */
   Sentry: SentryLike;
 }
 /**
-* A dependency-injected Sentry bridge for the ai@7 telemetry surface.
-*
-* It wraps model calls and tool executions in Sentry spans (via
-* `Sentry.startSpan`) so nested provider/tool work is correctly parented, and
-* routes `onError` to `Sentry.captureException`. Span attributes carry only
-* structural metadata (model, provider, tool name) unless `recordInputs` is
-* set, in which case prompts / tool arguments are attached too.
-*
-* The app owns Sentry initialization; pass the namespace in as `Sentry`.
-* @experimental
-*/
+ * A dependency-injected Sentry bridge for the ai@7 telemetry surface.
+ *
+ * It wraps model calls and tool executions in Sentry spans (via
+ * `Sentry.startSpan`) so nested provider/tool work is correctly parented, and
+ * routes `onError` to `Sentry.captureException`. Span attributes carry only
+ * structural metadata (model, provider, tool name) unless `recordInputs` is
+ * set, in which case prompts / tool arguments are attached too.
+ *
+ * The app owns Sentry initialization; pass the namespace in as `Sentry`.
+ * @experimental
+ */
 declare const sentryTelemetry: (options: SentryTelemetryOptions) => Telemetry;
 export { type BraintrustLike, type BraintrustSpan, type BraintrustTelemetryOptions, type CommonOptions, type ConsoleLogLevel, type ConsoleLogger, type ConsoleTelemetryOptions, type SentryLike, type SentryTelemetryOptions, braintrustTelemetry, combineTelemetry, consoleTelemetry, sentryTelemetry };

package/dist/telemetry/index.d.ts

@@ -1,41 +1,41 @@
 import { Telemetry } from 'ai';
 /**
-* Privacy options shared by every telemetry integration in this package.
-*
-* Both flags default to **FALSE**. Without an explicit opt-in, no prompt,
-* message, tool input, generated model text, or tool output is ever forwarded
-* to a downstream tracer — only structural metadata (model id, finish reason,
-* token counts, tool name, timing, success/failure) is recorded. This is the
-* privacy-safe default: turn recording on deliberately, per integration.
-* @experimental
-*/
+ * Privacy options shared by every telemetry integration in this package.
+ *
+ * Both flags default to **FALSE**. Without an explicit opt-in, no prompt,
+ * message, tool input, generated model text, or tool output is ever forwarded
+ * to a downstream tracer — only structural metadata (model id, finish reason,
+ * token counts, tool name, timing, success/failure) is recorded. This is the
+ * privacy-safe default: turn recording on deliberately, per integration.
+ * @experimental
+ */
 interface CommonOptions {
   /**
-  * When `true`, record model/tool **input** — prompts, messages, and tool
-  * call arguments. Default `false`.
-  */
+   * When `true`, record model/tool **input** — prompts, messages, and tool
+   * call arguments. Default `false`.
+   */
   recordInputs?: boolean;
   /**
-  * When `true`, record model/tool **output** — generated text and tool
-  * results. Default `false`.
-  */
+   * When `true`, record model/tool **output** — generated text and tool
+   * results. Default `false`.
+   */
   recordOutputs?: boolean;
 }
 /**
-* The span handle a {@link BraintrustLike.traced} callback receives.
-* @experimental
-*/
+ * The span handle a {@link BraintrustLike.traced} callback receives.
+ * @experimental
+ */
 interface BraintrustSpan {
   /** Attach structured fields to the current span. */
   log: (event: Record<string, unknown>) => void;
 }
 /**
-* The minimal, **structural** slice of the `braintrust` SDK this bridge needs.
-* `braintrust` is intentionally **not** a dependency — the app passes its own
-* initialized logger, so this package stays dependency-free and works with any
-* compatible Braintrust SDK version.
-* @experimental
-*/
+ * The minimal, **structural** slice of the `braintrust` SDK this bridge needs.
+ * `braintrust` is intentionally **not** a dependency — the app passes its own
+ * initialized logger, so this package stays dependency-free and works with any
+ * compatible Braintrust SDK version.
+ * @experimental
+ */
 interface BraintrustLike {
   /** Run `callback` inside a new traced span and return its result. */
   traced: <T>(callback: (span: BraintrustSpan) => T, args?: {
@@ -44,92 +44,92 @@ interface BraintrustLike {
   }) => T;
 }
 /**
-* Options for {@link braintrustTelemetry}.
-* @experimental
-*/
+ * Options for {@link braintrustTelemetry}.
+ * @experimental
+ */
 interface BraintrustTelemetryOptions extends CommonOptions {
   /** Span-name prefix for the language-model call (e.g. the agent name). */
   functionId?: string;
   /**
-  * The caller's initialized Braintrust logger (dependency-injected). Import
-  * and initialize `braintrust` in your app and pass it as `logger`.
-  */
+   * The caller's initialized Braintrust logger (dependency-injected). Import
+   * and initialize `braintrust` in your app and pass it as `logger`.
+   */
   logger: BraintrustLike;
 }
 /**
-* A dependency-injected Braintrust bridge for the ai@7 telemetry surface.
-*
-* It wraps model calls (`type: "llm"`) and tool executions (`type: "tool"`) in
-* `logger.traced` spans and logs structural metadata. Prompts / tool arguments
-* are logged only when `recordInputs` is set; generated text / tool results
-* only when `recordOutputs` is set. `onError` opens a span and logs the error.
-*
-* The app owns Braintrust initialization; pass the logger in as `logger`.
-* @experimental
-*/
+ * A dependency-injected Braintrust bridge for the ai@7 telemetry surface.
+ *
+ * It wraps model calls (`type: "llm"`) and tool executions (`type: "tool"`) in
+ * `logger.traced` spans and logs structural metadata. Prompts / tool arguments
+ * are logged only when `recordInputs` is set; generated text / tool results
+ * only when `recordOutputs` is set. `onError` opens a span and logs the error.
+ *
+ * The app owns Braintrust initialization; pass the logger in as `logger`.
+ * @experimental
+ */
 declare const braintrustTelemetry: (options: BraintrustTelemetryOptions) => Telemetry;
 /**
-* Combine several {@link Telemetry} integrations into a single one that fans
-* every lifecycle callback out to all of them and nests the two execution
-* wrappers so multiple span-context wrappers compose correctly.
-*
-* Value callbacks (`onStart`, `onStepEnd`, `onToolExecutionEnd`, …) invoke each
-* integration's matching callback (guarding `undefined`) and await them all in
-* parallel. The wrappers (`executeLanguageModelCall`, `executeTool`) are
-* composed by nesting right-to-left; integrations without a wrapper are skipped,
-* and with none defined the plain `execute` still runs.
-* @experimental
-*/
+ * Combine several {@link Telemetry} integrations into a single one that fans
+ * every lifecycle callback out to all of them and nests the two execution
+ * wrappers so multiple span-context wrappers compose correctly.
+ *
+ * Value callbacks (`onStart`, `onStepEnd`, `onToolExecutionEnd`, …) invoke each
+ * integration's matching callback (guarding `undefined`) and await them all in
+ * parallel. The wrappers (`executeLanguageModelCall`, `executeTool`) are
+ * composed by nesting right-to-left; integrations without a wrapper are skipped,
+ * and with none defined the plain `execute` still runs.
+ * @experimental
+ */
 declare const combineTelemetry: (...integrations: Telemetry[]) => Telemetry;
 /**
-* Severity level passed to a {@link ConsoleLogger}.
-* @experimental
-*/
+ * Severity level passed to a {@link ConsoleLogger}.
+ * @experimental
+ */
 type ConsoleLogLevel = "error" | "info" | "warn";
 /**
-* Structured log sink. Receives a level, a static human message, and a bag of
-* structured fields (never interpolated into the message, so log processors can
-* index them). The default sink writes to `globalThis.console`.
-* @experimental
-*/
+ * Structured log sink. Receives a level, a static human message, and a bag of
+ * structured fields (never interpolated into the message, so log processors can
+ * index them). The default sink writes to `globalThis.console`.
+ * @experimental
+ */
 type ConsoleLogger = (level: ConsoleLogLevel, message: string, fields: Record<string, unknown>) => void;
 /**
-* Options for {@link consoleTelemetry}.
-* @experimental
-*/
+ * Options for {@link consoleTelemetry}.
+ * @experimental
+ */
 interface ConsoleTelemetryOptions extends CommonOptions {
   /**
-  * Identifier prefixed into every log message (e.g. the agent name). Helps
-  * correlate lines when several agents share one process. Optional.
-  */
+   * Identifier prefixed into every log message (e.g. the agent name). Helps
+   * correlate lines when several agents share one process. Optional.
+   */
   functionId?: string;
   /**
-  * Sink for structured log lines. Defaults to a `globalThis.console`-backed
-  * writer that routes `info`/`warn`/`error` to the matching console method.
-  */
+   * Sink for structured log lines. Defaults to a `globalThis.console`-backed
+   * writer that routes `info`/`warn`/`error` to the matching console method.
+   */
   logger?: ConsoleLogger;
 }
 /**
-* A zero-dependency structured tracer for the ai@7 telemetry surface.
-*
-* It maps the generation lifecycle onto {@link ConsoleLogger} calls: operation
-* start/end, per-step start/end, model-call end (model + finish reason +
-* usage), and tool start/end (name, success, timing). By default it records
-* **only structural metadata** — set `recordInputs` to also log prompts / tool
-* arguments, and `recordOutputs` to log generated text / tool results.
-*
-* Every callback is defensive (event fields may be absent) and synchronous.
-* @experimental
-*/
+ * A zero-dependency structured tracer for the ai@7 telemetry surface.
+ *
+ * It maps the generation lifecycle onto {@link ConsoleLogger} calls: operation
+ * start/end, per-step start/end, model-call end (model + finish reason +
+ * usage), and tool start/end (name, success, timing). By default it records
+ * **only structural metadata** — set `recordInputs` to also log prompts / tool
+ * arguments, and `recordOutputs` to log generated text / tool results.
+ *
+ * Every callback is defensive (event fields may be absent) and synchronous.
+ * @experimental
+ */
 declare const consoleTelemetry: (options?: ConsoleTelemetryOptions) => Telemetry;
 /**
-* The minimal, **structural** slice of `@sentry/cloudflare` (equivalently
-* `@sentry/node`/`@sentry/browser`) this bridge needs. `@sentry/cloudflare` is
-* intentionally **not** a dependency — the app passes its own already-initialized
-* Sentry namespace, so this package stays dependency-free and works with any
-* compatible Sentry SDK version.
-* @experimental
-*/
+ * The minimal, **structural** slice of `@sentry/cloudflare` (equivalently
+ * `@sentry/node`/`@sentry/browser`) this bridge needs. `@sentry/cloudflare` is
+ * intentionally **not** a dependency — the app passes its own already-initialized
+ * Sentry namespace, so this package stays dependency-free and works with any
+ * compatible Sentry SDK version.
+ * @experimental
+ */
 interface SentryLike {
   /** Capture a thrown value / exception. */
   captureException: (exception: unknown) => unknown;
@@ -145,29 +145,29 @@ interface SentryLike {
   }) => T) => T;
 }
 /**
-* Options for {@link sentryTelemetry}.
-* @experimental
-*/
+ * Options for {@link sentryTelemetry}.
+ * @experimental
+ */
 interface SentryTelemetryOptions extends CommonOptions {
   /** Span-name prefix for the language-model call (e.g. the agent name). */
   functionId?: string;
   /**
-  * The caller's already-initialized Sentry namespace (dependency-injected).
-  * `import * as Sentry from "@sentry/cloudflare"` and pass it as `Sentry`.
-  */
+   * The caller's already-initialized Sentry namespace (dependency-injected).
+   * `import * as Sentry from "@sentry/cloudflare"` and pass it as `Sentry`.
+   */
   Sentry: SentryLike;
 }
 /**
-* A dependency-injected Sentry bridge for the ai@7 telemetry surface.
-*
-* It wraps model calls and tool executions in Sentry spans (via
-* `Sentry.startSpan`) so nested provider/tool work is correctly parented, and
-* routes `onError` to `Sentry.captureException`. Span attributes carry only
-* structural metadata (model, provider, tool name) unless `recordInputs` is
-* set, in which case prompts / tool arguments are attached too.
-*
-* The app owns Sentry initialization; pass the namespace in as `Sentry`.
-* @experimental
-*/
+ * A dependency-injected Sentry bridge for the ai@7 telemetry surface.
+ *
+ * It wraps model calls and tool executions in Sentry spans (via
+ * `Sentry.startSpan`) so nested provider/tool work is correctly parented, and
+ * routes `onError` to `Sentry.captureException`. Span attributes carry only
+ * structural metadata (model, provider, tool name) unless `recordInputs` is
+ * set, in which case prompts / tool arguments are attached too.
+ *
+ * The app owns Sentry initialization; pass the namespace in as `Sentry`.
+ * @experimental
+ */
 declare const sentryTelemetry: (options: SentryTelemetryOptions) => Telemetry;
 export { type BraintrustLike, type BraintrustSpan, type BraintrustTelemetryOptions, type CommonOptions, type ConsoleLogLevel, type ConsoleLogger, type ConsoleTelemetryOptions, type SentryLike, type SentryTelemetryOptions, braintrustTelemetry, combineTelemetry, consoleTelemetry, sentryTelemetry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/agent",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.5",
   "description": "Durable AI agents for Lunora: defineAgent compiles a replay-safe tool-loop onto Cloudflare Workflows, with DO SQLite threads and live message subscriptions",
   "keywords": [
     "agent",
@@ -76,14 +76,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/ai": "1.0.0-alpha.16",
-    "@lunora/errors": "1.0.0-alpha.5",
-    "@lunora/mail": "1.0.0-alpha.15",
-    "@lunora/server": "1.0.0-alpha.27",
-    "@lunora/values": "1.0.0-alpha.8",
-    "@lunora/workflow": "1.0.0-alpha.10",
+    "@lunora/ai": "1.0.0-alpha.17",
+    "@lunora/errors": "1.0.0-alpha.6",
+    "@lunora/mail": "1.0.0-alpha.16",
+    "@lunora/server": "1.0.0-alpha.28",
+    "@lunora/values": "1.0.0-alpha.9",
+    "@lunora/workflow": "1.0.0-alpha.11",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "ai": "7.0.16"
+    "ai": "7.0.31"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"