@lunora/agent 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/telemetry/index.d.mts

@@ -7,6 +7,7 @@ import { Telemetry } from 'ai';
 * 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 {
   /**
@@ -20,7 +21,10 @@ interface CommonOptions {
   */
   recordOutputs?: boolean;
 }
-/** The span handle a {@link BraintrustLike.traced} callback receives. */
+/**
+* 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;
@@ -30,6 +34,7 @@ interface BraintrustSpan {
 * `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. */
@@ -38,7 +43,10 @@ interface BraintrustLike {
     type?: string;
   }) => T;
 }
-/** Options for {@link braintrustTelemetry}. */
+/**
+* Options for {@link braintrustTelemetry}.
+* @experimental
+*/
 interface BraintrustTelemetryOptions extends CommonOptions {
   /** Span-name prefix for the language-model call (e.g. the agent name). */
   functionId?: string;
@@ -57,6 +65,7 @@ interface BraintrustTelemetryOptions extends CommonOptions {
 * 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;
 /**
@@ -69,17 +78,25 @@ declare const braintrustTelemetry: (options: BraintrustTelemetryOptions) => Tele
 * 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}. */
+/**
+* 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
 */
 type ConsoleLogger = (level: ConsoleLogLevel, message: string, fields: Record<string, unknown>) => void;
-/** Options for {@link consoleTelemetry}. */
+/**
+* Options for {@link consoleTelemetry}.
+* @experimental
+*/
 interface ConsoleTelemetryOptions extends CommonOptions {
   /**
   * Identifier prefixed into every log message (e.g. the agent name). Helps
@@ -102,6 +119,7 @@ interface ConsoleTelemetryOptions extends CommonOptions {
 * 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;
 /**
@@ -110,6 +128,7 @@ declare const consoleTelemetry: (options?: ConsoleTelemetryOptions) => Telemetry
 * 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. */
@@ -125,7 +144,10 @@ interface SentryLike {
     } | string) => void;
   }) => T) => T;
 }
-/** Options for {@link sentryTelemetry}. */
+/**
+* Options for {@link sentryTelemetry}.
+* @experimental
+*/
 interface SentryTelemetryOptions extends CommonOptions {
   /** Span-name prefix for the language-model call (e.g. the agent name). */
   functionId?: string;
@@ -145,6 +167,7 @@ interface SentryTelemetryOptions extends CommonOptions {
 * 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

@@ -7,6 +7,7 @@ import { Telemetry } from 'ai';
 * 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 {
   /**
@@ -20,7 +21,10 @@ interface CommonOptions {
   */
   recordOutputs?: boolean;
 }
-/** The span handle a {@link BraintrustLike.traced} callback receives. */
+/**
+* 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;
@@ -30,6 +34,7 @@ interface BraintrustSpan {
 * `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. */
@@ -38,7 +43,10 @@ interface BraintrustLike {
     type?: string;
   }) => T;
 }
-/** Options for {@link braintrustTelemetry}. */
+/**
+* Options for {@link braintrustTelemetry}.
+* @experimental
+*/
 interface BraintrustTelemetryOptions extends CommonOptions {
   /** Span-name prefix for the language-model call (e.g. the agent name). */
   functionId?: string;
@@ -57,6 +65,7 @@ interface BraintrustTelemetryOptions extends CommonOptions {
 * 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;
 /**
@@ -69,17 +78,25 @@ declare const braintrustTelemetry: (options: BraintrustTelemetryOptions) => Tele
 * 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}. */
+/**
+* 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
 */
 type ConsoleLogger = (level: ConsoleLogLevel, message: string, fields: Record<string, unknown>) => void;
-/** Options for {@link consoleTelemetry}. */
+/**
+* Options for {@link consoleTelemetry}.
+* @experimental
+*/
 interface ConsoleTelemetryOptions extends CommonOptions {
   /**
   * Identifier prefixed into every log message (e.g. the agent name). Helps
@@ -102,6 +119,7 @@ interface ConsoleTelemetryOptions extends CommonOptions {
 * 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;
 /**
@@ -110,6 +128,7 @@ declare const consoleTelemetry: (options?: ConsoleTelemetryOptions) => Telemetry
 * 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. */
@@ -125,7 +144,10 @@ interface SentryLike {
     } | string) => void;
   }) => T) => T;
 }
-/** Options for {@link sentryTelemetry}. */
+/**
+* Options for {@link sentryTelemetry}.
+* @experimental
+*/
 interface SentryTelemetryOptions extends CommonOptions {
   /** Span-name prefix for the language-model call (e.g. the agent name). */
   functionId?: string;
@@ -145,6 +167,7 @@ interface SentryTelemetryOptions extends CommonOptions {
 * 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.1",
+  "version": "1.0.0-alpha.3",
   "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,12 +76,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/ai": "1.0.0-alpha.14",
-    "@lunora/errors": "1.0.0-alpha.4",
-    "@lunora/mail": "1.0.0-alpha.14",
-    "@lunora/server": "1.0.0-alpha.24",
-    "@lunora/values": "1.0.0-alpha.7",
-    "@lunora/workflow": "1.0.0-alpha.9",
+    "@lunora/ai": "1.0.0-alpha.15",
+    "@lunora/errors": "1.0.0-alpha.5",
+    "@lunora/mail": "1.0.0-alpha.15",
+    "@lunora/server": "1.0.0-alpha.26",
+    "@lunora/values": "1.0.0-alpha.8",
+    "@lunora/workflow": "1.0.0-alpha.10",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ai": "7.0.16"
   },