@lunora/agent 0.0.0 → 1.0.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/LICENSE.md +105 -0
  2. package/README.md +38 -31
  3. package/dist/channels.d.mts +74 -0
  4. package/dist/channels.d.ts +74 -0
  5. package/dist/channels.mjs +181 -0
  6. package/dist/component.d.mts +104 -0
  7. package/dist/component.d.ts +104 -0
  8. package/dist/component.mjs +418 -0
  9. package/dist/inbound.d.mts +34 -0
  10. package/dist/inbound.d.ts +34 -0
  11. package/dist/inbound.mjs +32 -0
  12. package/dist/index.d.mts +832 -0
  13. package/dist/index.d.ts +832 -0
  14. package/dist/index.mjs +18 -0
  15. package/dist/naming.d.mts +30 -0
  16. package/dist/naming.d.ts +30 -0
  17. package/dist/naming.mjs +8 -0
  18. package/dist/packem_shared/AGENT_MODULE-Dnt_-AAT.mjs +24 -0
  19. package/dist/packem_shared/VoiceSessionDO-BdwlLaXC.mjs +297 -0
  20. package/dist/packem_shared/adaptMcpResult-wtNMvLoP.mjs +65 -0
  21. package/dist/packem_shared/agentAsTool-CUHlWsmt.mjs +98 -0
  22. package/dist/packem_shared/base64-BVwtgRJV.mjs +18 -0
  23. package/dist/packem_shared/braintrustTelemetry-TP7Kwuuj.mjs +47 -0
  24. package/dist/packem_shared/buildModelMessages-BWFigaoo.mjs +69 -0
  25. package/dist/packem_shared/codeTool-CjgJOC9t.mjs +122 -0
  26. package/dist/packem_shared/collectAgenticMemoryTools-QrzpV-WX.mjs +97 -0
  27. package/dist/packem_shared/combineTelemetry-DCyaaWAI.mjs +43 -0
  28. package/dist/packem_shared/common-DQXayow6.mjs +89 -0
  29. package/dist/packem_shared/compileAgentWorkflow-DYFFyx7i.mjs +78 -0
  30. package/dist/packem_shared/consoleTelemetry--3sWfu1R.mjs +93 -0
  31. package/dist/packem_shared/createAgentContext-4xJGXNR4.mjs +50 -0
  32. package/dist/packem_shared/createAgentGenerate-DO7Z96zX.mjs +192 -0
  33. package/dist/packem_shared/createDispatchRunner-DSbp_dph-ZHTtxy3f.mjs +69 -0
  34. package/dist/packem_shared/defineAgent-DAwAZC9P.mjs +148 -0
  35. package/dist/packem_shared/defineSkill-Ctf_S-rz.mjs +22 -0
  36. package/dist/packem_shared/functionTool-D6lCa2jB.mjs +20 -0
  37. package/dist/packem_shared/graph-component-Bbaxxymp.mjs +217 -0
  38. package/dist/packem_shared/memory-D4FPcBsX.mjs +12 -0
  39. package/dist/packem_shared/normalizeEntityName-BouctxLC.mjs +3 -0
  40. package/dist/packem_shared/otlpTelemetry-DU5ZmoEV.mjs +177 -0
  41. package/dist/packem_shared/runAgentLoop-M8PKbtWT.mjs +493 -0
  42. package/dist/packem_shared/runVoiceTurn-LnqLvCRR.mjs +211 -0
  43. package/dist/packem_shared/sandboxComponent-DR3pTwBL.mjs +194 -0
  44. package/dist/packem_shared/sentryTelemetry-A4F5ndh9.mjs +36 -0
  45. package/dist/packem_shared/types.d-boAM2Yi1.d.mts +1114 -0
  46. package/dist/packem_shared/types.d-boAM2Yi1.d.ts +1114 -0
  47. package/dist/sandbox.d.mts +204 -0
  48. package/dist/sandbox.d.ts +204 -0
  49. package/dist/sandbox.mjs +113 -0
  50. package/dist/telemetry/index.d.mts +254 -0
  51. package/dist/telemetry/index.d.ts +254 -0
  52. package/dist/telemetry/index.mjs +5 -0
  53. package/package.json +88 -7
@@ -0,0 +1,254 @@
1
+ import { Telemetry } from 'ai';
2
+ /**
3
+ * Privacy options shared by every telemetry integration in this package.
4
+ *
5
+ * Both flags default to **FALSE**. Without an explicit opt-in, no prompt,
6
+ * message, tool input, generated model text, or tool output is ever forwarded
7
+ * to a downstream tracer — only structural metadata (model id, finish reason,
8
+ * token counts, tool name, timing, success/failure) is recorded. This is the
9
+ * privacy-safe default: turn recording on deliberately, per integration.
10
+ * @experimental
11
+ */
12
+ interface CommonOptions {
13
+ /**
14
+ * When `true`, record model/tool **input** — prompts, messages, and tool
15
+ * call arguments. Default `false`.
16
+ */
17
+ recordInputs?: boolean;
18
+ /**
19
+ * When `true`, record model/tool **output** — generated text and tool
20
+ * results. Default `false`.
21
+ */
22
+ recordOutputs?: boolean;
23
+ }
24
+ /**
25
+ * The span handle a {@link BraintrustLike.traced} callback receives.
26
+ * @experimental
27
+ */
28
+ interface BraintrustSpan {
29
+ /** Attach structured fields to the current span. */
30
+ log: (event: Record<string, unknown>) => void;
31
+ }
32
+ /**
33
+ * The minimal, **structural** slice of the `braintrust` SDK this bridge needs.
34
+ * `braintrust` is intentionally **not** a dependency — the app passes its own
35
+ * initialized logger, so this package stays dependency-free and works with any
36
+ * compatible Braintrust SDK version.
37
+ * @experimental
38
+ */
39
+ interface BraintrustLike {
40
+ /** Run `callback` inside a new traced span and return its result. */
41
+ traced: <T>(callback: (span: BraintrustSpan) => T, args?: {
42
+ name?: string;
43
+ type?: string;
44
+ }) => T;
45
+ }
46
+ /**
47
+ * Options for {@link braintrustTelemetry}.
48
+ * @experimental
49
+ */
50
+ interface BraintrustTelemetryOptions extends CommonOptions {
51
+ /** Span-name prefix for the language-model call (e.g. the agent name). */
52
+ functionId?: string;
53
+ /**
54
+ * The caller's initialized Braintrust logger (dependency-injected). Import
55
+ * and initialize `braintrust` in your app and pass it as `logger`.
56
+ */
57
+ logger: BraintrustLike;
58
+ }
59
+ /**
60
+ * A dependency-injected Braintrust bridge for the ai@7 telemetry surface.
61
+ *
62
+ * It wraps model calls (`type: "llm"`) and tool executions (`type: "tool"`) in
63
+ * `logger.traced` spans and logs structural metadata. Prompts / tool arguments
64
+ * are logged only when `recordInputs` is set; generated text / tool results
65
+ * only when `recordOutputs` is set. `onError` opens a span and logs the error.
66
+ *
67
+ * The app owns Braintrust initialization; pass the logger in as `logger`.
68
+ * @experimental
69
+ */
70
+ declare const braintrustTelemetry: (options: BraintrustTelemetryOptions) => Telemetry;
71
+ /**
72
+ * Combine several {@link Telemetry} integrations into a single one that fans
73
+ * every lifecycle callback out to all of them and nests the two execution
74
+ * wrappers so multiple span-context wrappers compose correctly.
75
+ *
76
+ * Value callbacks (`onStart`, `onStepEnd`, `onToolExecutionEnd`, …) invoke each
77
+ * integration's matching callback (guarding `undefined`) and await them all in
78
+ * parallel. The wrappers (`executeLanguageModelCall`, `executeTool`) are
79
+ * composed by nesting right-to-left; integrations without a wrapper are skipped,
80
+ * and with none defined the plain `execute` still runs.
81
+ * @experimental
82
+ */
83
+ declare const combineTelemetry: (...integrations: Telemetry[]) => Telemetry;
84
+ /**
85
+ * Severity level passed to a {@link ConsoleLogger}.
86
+ * @experimental
87
+ */
88
+ type ConsoleLogLevel = "error" | "info" | "warn";
89
+ /**
90
+ * Structured log sink. Receives a level, a static human message, and a bag of
91
+ * structured fields (never interpolated into the message, so log processors can
92
+ * index them). The default sink writes to `globalThis.console`.
93
+ * @experimental
94
+ */
95
+ type ConsoleLogger = (level: ConsoleLogLevel, message: string, fields: Record<string, unknown>) => void;
96
+ /**
97
+ * Options for {@link consoleTelemetry}.
98
+ * @experimental
99
+ */
100
+ interface ConsoleTelemetryOptions extends CommonOptions {
101
+ /**
102
+ * Identifier prefixed into every log message (e.g. the agent name). Helps
103
+ * correlate lines when several agents share one process. Optional.
104
+ */
105
+ functionId?: string;
106
+ /**
107
+ * Sink for structured log lines. Defaults to a `globalThis.console`-backed
108
+ * writer that routes `info`/`warn`/`error` to the matching console method.
109
+ */
110
+ logger?: ConsoleLogger;
111
+ }
112
+ /**
113
+ * A zero-dependency structured tracer for the ai@7 telemetry surface.
114
+ *
115
+ * It maps the generation lifecycle onto {@link ConsoleLogger} calls: operation
116
+ * start/end, per-step start/end, model-call end (model + finish reason +
117
+ * usage), and tool start/end (name, success, timing). By default it records
118
+ * **only structural metadata** — set `recordInputs` to also log prompts / tool
119
+ * arguments, and `recordOutputs` to log generated text / tool results.
120
+ *
121
+ * Every callback is defensive (event fields may be absent) and synchronous.
122
+ * @experimental
123
+ */
124
+ declare const consoleTelemetry: (options?: ConsoleTelemetryOptions) => Telemetry;
125
+ /**
126
+ * Options for {@link otlpTelemetry}.
127
+ * @experimental
128
+ */
129
+ interface OtlpTelemetryOptions extends CommonOptions {
130
+ /**
131
+ * Conversation / session id to tag each generation span with, emitted as the
132
+ * `gen_ai.conversation.id` semantic-convention attribute so a multi-turn
133
+ * conversation's model turns group in the trace store. On a deployed agent the
134
+ * platform wiring passes the run's `threadKey` here automatically (one thread =
135
+ * one conversation). Omitted → the attribute is absent (backward-compatible),
136
+ * and each turn's span is ungrouped.
137
+ */
138
+ conversationId?: string;
139
+ /**
140
+ * The OTLP-over-HTTP collector base endpoint (e.g. the Lunora Cloud's `/v1`
141
+ * base). Spans are POSTed to `${endpoint}/v1/traces`; a trailing slash is
142
+ * tolerated. On the platform this is the injected `LUNORA_OTLP_ENDPOINT`.
143
+ */
144
+ endpoint: string;
145
+ /**
146
+ * Extra headers merged onto every POST — typically the correlation headers
147
+ * the platform injects. `Content-Type: application/json` is set by default.
148
+ */
149
+ headers?: Record<string, string>;
150
+ /** `service.name` resource attribute on every span. Defaults to `lunora`. */
151
+ serviceName?: string;
152
+ /**
153
+ * Bearer token added as `Authorization: Bearer` (wins over any authorization
154
+ * in `headers`) — the injected `LUNORA_OTLP_TOKEN`. Omit for an
155
+ * unauthenticated collector.
156
+ */
157
+ token?: string;
158
+ /**
159
+ * Trace id (32-hex) to hang every span of this run under, so one agent run
160
+ * reads as one trace. Pass a stable id derived from the run (e.g. the
161
+ * workflow run id). Omitted → each span mints its own trace id (still valid,
162
+ * just ungrouped).
163
+ */
164
+ traceId?: string;
165
+ /**
166
+ * The Worker request's `waitUntil`, so a fire-and-forget export survives
167
+ * isolate teardown after the turn returns. Omit and the send degrades to
168
+ * best-effort.
169
+ */
170
+ waitUntil?: (promise: Promise<unknown>) => void;
171
+ }
172
+ /**
173
+ * An OTLP-over-HTTP telemetry integration for `@lunora/agent`.
174
+ *
175
+ * The OTLP counterpart to the `sentryTelemetry` / `braintrustTelemetry` bridges:
176
+ * it wraps each language-model call and tool execution in an OTLP **span**
177
+ * (`gen_ai.*` semantic-convention attributes — model, provider, token usage,
178
+ * tool name) and ships it to a collector, so agent generations land in the same
179
+ * trace store as the rest of an app's telemetry (the Lunora Cloud, or any OTel
180
+ * collector). Plug it into `defineAgent({ telemetry: { isEnabled: true,
181
+ * integrations: [otlpTelemetry({ endpoint, token })] } })`.
182
+ *
183
+ * Emitting inside the turn's execution wrapper means one span per **real** turn:
184
+ * the agent loop memoizes each `step.do('llm:turn:N')`, so a Workflow replay
185
+ * returns the cached result without re-invoking `execute`, and no duplicate span
186
+ * is emitted. Privacy-safe by default — `recordInputs`/`recordOutputs` both
187
+ * default `false`, so no prompt or generated text leaves the worker without an
188
+ * explicit opt-in; only structural metadata + token counts are recorded.
189
+ *
190
+ * Each export is fire-and-forget (registered with `waitUntil` when supplied);
191
+ * every rejection is swallowed so a flaky collector never surfaces to the run.
192
+ *
193
+ * Two deliberate differences from the SDK-backed bridges, which delegate to a
194
+ * host tracer. First, no `onError`: a failed call already emits a span with
195
+ * `status.code === 2`, so the failure is on the trace and there is no host client
196
+ * to also notify. Second, flat not nested: every span gets `traceId` (shared when
197
+ * `traceId` is set) but no `parentSpanId`, so model-call and tool spans are
198
+ * siblings under the run rather than a tree — OTLP has no ambient span context to
199
+ * parent to here.
200
+ * @param options `endpoint` (+ optional `token`/`headers`/`serviceName`),
201
+ * `traceId` to group a run's spans, `waitUntil`, and the `recordInputs`/
202
+ * `recordOutputs` privacy flags.
203
+ * @experimental
204
+ */
205
+ declare const otlpTelemetry: (options: OtlpTelemetryOptions) => Telemetry;
206
+ /**
207
+ * The minimal, **structural** slice of `@sentry/cloudflare` (equivalently
208
+ * `@sentry/node`/`@sentry/browser`) this bridge needs. `@sentry/cloudflare` is
209
+ * intentionally **not** a dependency — the app passes its own already-initialized
210
+ * Sentry namespace, so this package stays dependency-free and works with any
211
+ * compatible Sentry SDK version.
212
+ * @experimental
213
+ */
214
+ interface SentryLike {
215
+ /** Capture a thrown value / exception. */
216
+ captureException: (exception: unknown) => unknown;
217
+ /** Run `callback` inside a new span and return its result. */
218
+ startSpan: <T>(context: {
219
+ attributes?: Record<string, unknown>;
220
+ name: string;
221
+ op?: string;
222
+ }, callback: (span: {
223
+ setStatus?: (status: {
224
+ code: number;
225
+ } | string) => void;
226
+ }) => T) => T;
227
+ }
228
+ /**
229
+ * Options for {@link sentryTelemetry}.
230
+ * @experimental
231
+ */
232
+ interface SentryTelemetryOptions extends CommonOptions {
233
+ /** Span-name prefix for the language-model call (e.g. the agent name). */
234
+ functionId?: string;
235
+ /**
236
+ * The caller's already-initialized Sentry namespace (dependency-injected).
237
+ * `import * as Sentry from "@sentry/cloudflare"` and pass it as `Sentry`.
238
+ */
239
+ Sentry: SentryLike;
240
+ }
241
+ /**
242
+ * A dependency-injected Sentry bridge for the ai@7 telemetry surface.
243
+ *
244
+ * It wraps model calls and tool executions in Sentry spans (via
245
+ * `Sentry.startSpan`) so nested provider/tool work is correctly parented, and
246
+ * routes `onError` to `Sentry.captureException`. Span attributes carry only
247
+ * structural metadata (model, provider, tool name) unless `recordInputs` is
248
+ * set, in which case prompts / tool arguments are attached too.
249
+ *
250
+ * The app owns Sentry initialization; pass the namespace in as `Sentry`.
251
+ * @experimental
252
+ */
253
+ declare const sentryTelemetry: (options: SentryTelemetryOptions) => Telemetry;
254
+ export { type BraintrustLike, type BraintrustSpan, type BraintrustTelemetryOptions, type CommonOptions, type ConsoleLogLevel, type ConsoleLogger, type ConsoleTelemetryOptions, type OtlpTelemetryOptions, type SentryLike, type SentryTelemetryOptions, braintrustTelemetry, combineTelemetry, consoleTelemetry, otlpTelemetry, sentryTelemetry };
@@ -0,0 +1,254 @@
1
+ import { Telemetry } from 'ai';
2
+ /**
3
+ * Privacy options shared by every telemetry integration in this package.
4
+ *
5
+ * Both flags default to **FALSE**. Without an explicit opt-in, no prompt,
6
+ * message, tool input, generated model text, or tool output is ever forwarded
7
+ * to a downstream tracer — only structural metadata (model id, finish reason,
8
+ * token counts, tool name, timing, success/failure) is recorded. This is the
9
+ * privacy-safe default: turn recording on deliberately, per integration.
10
+ * @experimental
11
+ */
12
+ interface CommonOptions {
13
+ /**
14
+ * When `true`, record model/tool **input** — prompts, messages, and tool
15
+ * call arguments. Default `false`.
16
+ */
17
+ recordInputs?: boolean;
18
+ /**
19
+ * When `true`, record model/tool **output** — generated text and tool
20
+ * results. Default `false`.
21
+ */
22
+ recordOutputs?: boolean;
23
+ }
24
+ /**
25
+ * The span handle a {@link BraintrustLike.traced} callback receives.
26
+ * @experimental
27
+ */
28
+ interface BraintrustSpan {
29
+ /** Attach structured fields to the current span. */
30
+ log: (event: Record<string, unknown>) => void;
31
+ }
32
+ /**
33
+ * The minimal, **structural** slice of the `braintrust` SDK this bridge needs.
34
+ * `braintrust` is intentionally **not** a dependency — the app passes its own
35
+ * initialized logger, so this package stays dependency-free and works with any
36
+ * compatible Braintrust SDK version.
37
+ * @experimental
38
+ */
39
+ interface BraintrustLike {
40
+ /** Run `callback` inside a new traced span and return its result. */
41
+ traced: <T>(callback: (span: BraintrustSpan) => T, args?: {
42
+ name?: string;
43
+ type?: string;
44
+ }) => T;
45
+ }
46
+ /**
47
+ * Options for {@link braintrustTelemetry}.
48
+ * @experimental
49
+ */
50
+ interface BraintrustTelemetryOptions extends CommonOptions {
51
+ /** Span-name prefix for the language-model call (e.g. the agent name). */
52
+ functionId?: string;
53
+ /**
54
+ * The caller's initialized Braintrust logger (dependency-injected). Import
55
+ * and initialize `braintrust` in your app and pass it as `logger`.
56
+ */
57
+ logger: BraintrustLike;
58
+ }
59
+ /**
60
+ * A dependency-injected Braintrust bridge for the ai@7 telemetry surface.
61
+ *
62
+ * It wraps model calls (`type: "llm"`) and tool executions (`type: "tool"`) in
63
+ * `logger.traced` spans and logs structural metadata. Prompts / tool arguments
64
+ * are logged only when `recordInputs` is set; generated text / tool results
65
+ * only when `recordOutputs` is set. `onError` opens a span and logs the error.
66
+ *
67
+ * The app owns Braintrust initialization; pass the logger in as `logger`.
68
+ * @experimental
69
+ */
70
+ declare const braintrustTelemetry: (options: BraintrustTelemetryOptions) => Telemetry;
71
+ /**
72
+ * Combine several {@link Telemetry} integrations into a single one that fans
73
+ * every lifecycle callback out to all of them and nests the two execution
74
+ * wrappers so multiple span-context wrappers compose correctly.
75
+ *
76
+ * Value callbacks (`onStart`, `onStepEnd`, `onToolExecutionEnd`, …) invoke each
77
+ * integration's matching callback (guarding `undefined`) and await them all in
78
+ * parallel. The wrappers (`executeLanguageModelCall`, `executeTool`) are
79
+ * composed by nesting right-to-left; integrations without a wrapper are skipped,
80
+ * and with none defined the plain `execute` still runs.
81
+ * @experimental
82
+ */
83
+ declare const combineTelemetry: (...integrations: Telemetry[]) => Telemetry;
84
+ /**
85
+ * Severity level passed to a {@link ConsoleLogger}.
86
+ * @experimental
87
+ */
88
+ type ConsoleLogLevel = "error" | "info" | "warn";
89
+ /**
90
+ * Structured log sink. Receives a level, a static human message, and a bag of
91
+ * structured fields (never interpolated into the message, so log processors can
92
+ * index them). The default sink writes to `globalThis.console`.
93
+ * @experimental
94
+ */
95
+ type ConsoleLogger = (level: ConsoleLogLevel, message: string, fields: Record<string, unknown>) => void;
96
+ /**
97
+ * Options for {@link consoleTelemetry}.
98
+ * @experimental
99
+ */
100
+ interface ConsoleTelemetryOptions extends CommonOptions {
101
+ /**
102
+ * Identifier prefixed into every log message (e.g. the agent name). Helps
103
+ * correlate lines when several agents share one process. Optional.
104
+ */
105
+ functionId?: string;
106
+ /**
107
+ * Sink for structured log lines. Defaults to a `globalThis.console`-backed
108
+ * writer that routes `info`/`warn`/`error` to the matching console method.
109
+ */
110
+ logger?: ConsoleLogger;
111
+ }
112
+ /**
113
+ * A zero-dependency structured tracer for the ai@7 telemetry surface.
114
+ *
115
+ * It maps the generation lifecycle onto {@link ConsoleLogger} calls: operation
116
+ * start/end, per-step start/end, model-call end (model + finish reason +
117
+ * usage), and tool start/end (name, success, timing). By default it records
118
+ * **only structural metadata** — set `recordInputs` to also log prompts / tool
119
+ * arguments, and `recordOutputs` to log generated text / tool results.
120
+ *
121
+ * Every callback is defensive (event fields may be absent) and synchronous.
122
+ * @experimental
123
+ */
124
+ declare const consoleTelemetry: (options?: ConsoleTelemetryOptions) => Telemetry;
125
+ /**
126
+ * Options for {@link otlpTelemetry}.
127
+ * @experimental
128
+ */
129
+ interface OtlpTelemetryOptions extends CommonOptions {
130
+ /**
131
+ * Conversation / session id to tag each generation span with, emitted as the
132
+ * `gen_ai.conversation.id` semantic-convention attribute so a multi-turn
133
+ * conversation's model turns group in the trace store. On a deployed agent the
134
+ * platform wiring passes the run's `threadKey` here automatically (one thread =
135
+ * one conversation). Omitted → the attribute is absent (backward-compatible),
136
+ * and each turn's span is ungrouped.
137
+ */
138
+ conversationId?: string;
139
+ /**
140
+ * The OTLP-over-HTTP collector base endpoint (e.g. the Lunora Cloud's `/v1`
141
+ * base). Spans are POSTed to `${endpoint}/v1/traces`; a trailing slash is
142
+ * tolerated. On the platform this is the injected `LUNORA_OTLP_ENDPOINT`.
143
+ */
144
+ endpoint: string;
145
+ /**
146
+ * Extra headers merged onto every POST — typically the correlation headers
147
+ * the platform injects. `Content-Type: application/json` is set by default.
148
+ */
149
+ headers?: Record<string, string>;
150
+ /** `service.name` resource attribute on every span. Defaults to `lunora`. */
151
+ serviceName?: string;
152
+ /**
153
+ * Bearer token added as `Authorization: Bearer` (wins over any authorization
154
+ * in `headers`) — the injected `LUNORA_OTLP_TOKEN`. Omit for an
155
+ * unauthenticated collector.
156
+ */
157
+ token?: string;
158
+ /**
159
+ * Trace id (32-hex) to hang every span of this run under, so one agent run
160
+ * reads as one trace. Pass a stable id derived from the run (e.g. the
161
+ * workflow run id). Omitted → each span mints its own trace id (still valid,
162
+ * just ungrouped).
163
+ */
164
+ traceId?: string;
165
+ /**
166
+ * The Worker request's `waitUntil`, so a fire-and-forget export survives
167
+ * isolate teardown after the turn returns. Omit and the send degrades to
168
+ * best-effort.
169
+ */
170
+ waitUntil?: (promise: Promise<unknown>) => void;
171
+ }
172
+ /**
173
+ * An OTLP-over-HTTP telemetry integration for `@lunora/agent`.
174
+ *
175
+ * The OTLP counterpart to the `sentryTelemetry` / `braintrustTelemetry` bridges:
176
+ * it wraps each language-model call and tool execution in an OTLP **span**
177
+ * (`gen_ai.*` semantic-convention attributes — model, provider, token usage,
178
+ * tool name) and ships it to a collector, so agent generations land in the same
179
+ * trace store as the rest of an app's telemetry (the Lunora Cloud, or any OTel
180
+ * collector). Plug it into `defineAgent({ telemetry: { isEnabled: true,
181
+ * integrations: [otlpTelemetry({ endpoint, token })] } })`.
182
+ *
183
+ * Emitting inside the turn's execution wrapper means one span per **real** turn:
184
+ * the agent loop memoizes each `step.do('llm:turn:N')`, so a Workflow replay
185
+ * returns the cached result without re-invoking `execute`, and no duplicate span
186
+ * is emitted. Privacy-safe by default — `recordInputs`/`recordOutputs` both
187
+ * default `false`, so no prompt or generated text leaves the worker without an
188
+ * explicit opt-in; only structural metadata + token counts are recorded.
189
+ *
190
+ * Each export is fire-and-forget (registered with `waitUntil` when supplied);
191
+ * every rejection is swallowed so a flaky collector never surfaces to the run.
192
+ *
193
+ * Two deliberate differences from the SDK-backed bridges, which delegate to a
194
+ * host tracer. First, no `onError`: a failed call already emits a span with
195
+ * `status.code === 2`, so the failure is on the trace and there is no host client
196
+ * to also notify. Second, flat not nested: every span gets `traceId` (shared when
197
+ * `traceId` is set) but no `parentSpanId`, so model-call and tool spans are
198
+ * siblings under the run rather than a tree — OTLP has no ambient span context to
199
+ * parent to here.
200
+ * @param options `endpoint` (+ optional `token`/`headers`/`serviceName`),
201
+ * `traceId` to group a run's spans, `waitUntil`, and the `recordInputs`/
202
+ * `recordOutputs` privacy flags.
203
+ * @experimental
204
+ */
205
+ declare const otlpTelemetry: (options: OtlpTelemetryOptions) => Telemetry;
206
+ /**
207
+ * The minimal, **structural** slice of `@sentry/cloudflare` (equivalently
208
+ * `@sentry/node`/`@sentry/browser`) this bridge needs. `@sentry/cloudflare` is
209
+ * intentionally **not** a dependency — the app passes its own already-initialized
210
+ * Sentry namespace, so this package stays dependency-free and works with any
211
+ * compatible Sentry SDK version.
212
+ * @experimental
213
+ */
214
+ interface SentryLike {
215
+ /** Capture a thrown value / exception. */
216
+ captureException: (exception: unknown) => unknown;
217
+ /** Run `callback` inside a new span and return its result. */
218
+ startSpan: <T>(context: {
219
+ attributes?: Record<string, unknown>;
220
+ name: string;
221
+ op?: string;
222
+ }, callback: (span: {
223
+ setStatus?: (status: {
224
+ code: number;
225
+ } | string) => void;
226
+ }) => T) => T;
227
+ }
228
+ /**
229
+ * Options for {@link sentryTelemetry}.
230
+ * @experimental
231
+ */
232
+ interface SentryTelemetryOptions extends CommonOptions {
233
+ /** Span-name prefix for the language-model call (e.g. the agent name). */
234
+ functionId?: string;
235
+ /**
236
+ * The caller's already-initialized Sentry namespace (dependency-injected).
237
+ * `import * as Sentry from "@sentry/cloudflare"` and pass it as `Sentry`.
238
+ */
239
+ Sentry: SentryLike;
240
+ }
241
+ /**
242
+ * A dependency-injected Sentry bridge for the ai@7 telemetry surface.
243
+ *
244
+ * It wraps model calls and tool executions in Sentry spans (via
245
+ * `Sentry.startSpan`) so nested provider/tool work is correctly parented, and
246
+ * routes `onError` to `Sentry.captureException`. Span attributes carry only
247
+ * structural metadata (model, provider, tool name) unless `recordInputs` is
248
+ * set, in which case prompts / tool arguments are attached too.
249
+ *
250
+ * The app owns Sentry initialization; pass the namespace in as `Sentry`.
251
+ * @experimental
252
+ */
253
+ declare const sentryTelemetry: (options: SentryTelemetryOptions) => Telemetry;
254
+ export { type BraintrustLike, type BraintrustSpan, type BraintrustTelemetryOptions, type CommonOptions, type ConsoleLogLevel, type ConsoleLogger, type ConsoleTelemetryOptions, type OtlpTelemetryOptions, type SentryLike, type SentryTelemetryOptions, braintrustTelemetry, combineTelemetry, consoleTelemetry, otlpTelemetry, sentryTelemetry };
@@ -0,0 +1,5 @@
1
+ export { braintrustTelemetry } from '../packem_shared/braintrustTelemetry-TP7Kwuuj.mjs';
2
+ export { combineTelemetry } from '../packem_shared/combineTelemetry-DCyaaWAI.mjs';
3
+ export { consoleTelemetry } from '../packem_shared/consoleTelemetry--3sWfu1R.mjs';
4
+ export { otlpTelemetry } from '../packem_shared/otlpTelemetry-DU5ZmoEV.mjs';
5
+ export { sentryTelemetry } from '../packem_shared/sentryTelemetry-A4F5ndh9.mjs';
package/package.json CHANGED
@@ -1,10 +1,91 @@
1
1
  {
2
2
  "name": "@lunora/agent",
3
- "version": "0.0.0",
4
- "description": "OIDC trusted publishing setup package for @lunora/agent",
3
+ "version": "1.0.0-alpha.10",
4
+ "description": "Durable AI agents for Lunora: defineAgent compiles a replay-safe tool-loop onto Cloudflare Workflows, with DO SQLite threads and live message subscriptions",
5
5
  "keywords": [
6
- "oidc",
7
- "trusted-publishing",
8
- "setup"
9
- ]
10
- }
6
+ "agent",
7
+ "ai",
8
+ "ai-sdk",
9
+ "braintrust",
10
+ "cloudflare",
11
+ "durable-objects",
12
+ "llm",
13
+ "lunora",
14
+ "observability",
15
+ "sentry",
16
+ "telemetry",
17
+ "tool-use",
18
+ "tracing",
19
+ "workers",
20
+ "workflows"
21
+ ],
22
+ "homepage": "https://lunora.sh",
23
+ "bugs": "https://github.com/anolilab/lunora/issues",
24
+ "license": "FSL-1.1-Apache-2.0",
25
+ "author": {
26
+ "name": "Daniel Bannert",
27
+ "email": "d.bannert@anolilab.de"
28
+ },
29
+ "repository": {
30
+ "type": "git",
31
+ "url": "git+https://github.com/anolilab/lunora.git",
32
+ "directory": "packages/agent"
33
+ },
34
+ "files": [
35
+ "./dist",
36
+ "README.md",
37
+ "LICENSE.md"
38
+ ],
39
+ "type": "module",
40
+ "sideEffects": false,
41
+ "main": "./dist/index.mjs",
42
+ "module": "./dist/index.mjs",
43
+ "types": "./dist/index.d.ts",
44
+ "exports": {
45
+ ".": {
46
+ "types": "./dist/index.d.ts",
47
+ "import": "./dist/index.mjs"
48
+ },
49
+ "./channels": {
50
+ "types": "./dist/channels.d.ts",
51
+ "import": "./dist/channels.mjs"
52
+ },
53
+ "./component": {
54
+ "types": "./dist/component.d.ts",
55
+ "import": "./dist/component.mjs"
56
+ },
57
+ "./inbound": {
58
+ "types": "./dist/inbound.d.ts",
59
+ "import": "./dist/inbound.mjs"
60
+ },
61
+ "./naming": {
62
+ "types": "./dist/naming.d.ts",
63
+ "import": "./dist/naming.mjs"
64
+ },
65
+ "./sandbox": {
66
+ "types": "./dist/sandbox.d.ts",
67
+ "import": "./dist/sandbox.mjs"
68
+ },
69
+ "./telemetry": {
70
+ "types": "./dist/telemetry/index.d.ts",
71
+ "import": "./dist/telemetry/index.mjs"
72
+ },
73
+ "./package.json": "./package.json"
74
+ },
75
+ "publishConfig": {
76
+ "access": "public"
77
+ },
78
+ "dependencies": {
79
+ "@lunora/ai": "1.0.0-alpha.25",
80
+ "@lunora/errors": "1.0.0-alpha.8",
81
+ "@lunora/mail": "1.0.0-alpha.18",
82
+ "@lunora/server": "1.0.0-alpha.31",
83
+ "@lunora/values": "1.0.0-alpha.11",
84
+ "@lunora/workflow": "1.0.0-alpha.13",
85
+ "@modelcontextprotocol/sdk": "^1.29.0",
86
+ "ai": "7.0.31"
87
+ },
88
+ "engines": {
89
+ "node": "^22.15.0 || >=24.11.0"
90
+ }
91
+ }