@lunora/agent 0.0.0 → 1.0.0-alpha.2

package/dist/telemetry/index.d.ts

@@ -0,0 +1,173 @@
+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
+*/
+interface CommonOptions {
+  /**
+  * 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`.
+  */
+  recordOutputs?: boolean;
+}
+/**
+* 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
+*/
+interface BraintrustLike {
+  /** Run `callback` inside a new traced span and return its result. */
+  traced: <T>(callback: (span: BraintrustSpan) => T, args?: {
+    name?: string;
+    type?: string;
+  }) => T;
+}
+/**
+* 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`.
+  */
+  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
+*/
+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
+*/
+declare const combineTelemetry: (...integrations: Telemetry[]) => Telemetry;
+/**
+* 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}.
+* @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.
+  */
+  functionId?: string;
+  /**
+  * 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
+*/
+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
+*/
+interface SentryLike {
+  /** Capture a thrown value / exception. */
+  captureException: (exception: unknown) => unknown;
+  /** Run `callback` inside a new span and return its result. */
+  startSpan: <T>(context: {
+    attributes?: Record<string, unknown>;
+    name: string;
+    op?: string;
+  }, callback: (span: {
+    setStatus?: (status: {
+      code: number;
+    } | string) => void;
+  }) => T) => T;
+}
+/**
+* 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`.
+  */
+  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
+*/
+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.mjs

@@ -0,0 +1,4 @@
+export { braintrustTelemetry } from '../packem_shared/braintrustTelemetry-wuGDErob.mjs';
+export { combineTelemetry } from '../packem_shared/combineTelemetry-DCyaaWAI.mjs';
+export { consoleTelemetry } from '../packem_shared/consoleTelemetry-z2MiP1jt.mjs';
+export { sentryTelemetry } from '../packem_shared/sentryTelemetry-CgqFJyLO.mjs';

package/package.json

@@ -1,10 +1,91 @@
 {
   "name": "@lunora/agent",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @lunora/agent",
+  "version": "1.0.0-alpha.2",
+  "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": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "agent",
+    "ai",
+    "ai-sdk",
+    "braintrust",
+    "cloudflare",
+    "durable-objects",
+    "llm",
+    "lunora",
+    "observability",
+    "sentry",
+    "telemetry",
+    "tool-use",
+    "tracing",
+    "workers",
+    "workflows"
+  ],
+  "homepage": "https://lunora.sh",
+  "bugs": "https://github.com/anolilab/lunora/issues",
+  "license": "FSL-1.1-Apache-2.0",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anolilab/lunora.git",
+    "directory": "packages/agent"
+  },
+  "files": [
+    "./dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./channels": {
+      "types": "./dist/channels.d.ts",
+      "import": "./dist/channels.mjs"
+    },
+    "./component": {
+      "types": "./dist/component.d.ts",
+      "import": "./dist/component.mjs"
+    },
+    "./inbound": {
+      "types": "./dist/inbound.d.ts",
+      "import": "./dist/inbound.mjs"
+    },
+    "./naming": {
+      "types": "./dist/naming.d.ts",
+      "import": "./dist/naming.mjs"
+    },
+    "./sandbox": {
+      "types": "./dist/sandbox.d.ts",
+      "import": "./dist/sandbox.mjs"
+    },
+    "./telemetry": {
+      "types": "./dist/telemetry/index.d.ts",
+      "import": "./dist/telemetry/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@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.25",
+    "@lunora/values": "1.0.0-alpha.8",
+    "@lunora/workflow": "1.0.0-alpha.10",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "ai": "7.0.16"
+  },
+  "engines": {
+    "node": "^22.15.0 || >=24.11.0"
+  }
+}