@lunora/agent 1.0.0-alpha.7 → 1.0.0-alpha.9
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.
- package/dist/index.mjs +4 -4
- package/dist/packem_shared/{VoiceSessionDO-DLoXsHGF.mjs → VoiceSessionDO-BdwlLaXC.mjs} +2 -2
- package/dist/packem_shared/{braintrustTelemetry-wuGDErob.mjs → braintrustTelemetry-TP7Kwuuj.mjs} +1 -1
- package/dist/packem_shared/{common-DAeFCot5.mjs → common-DQXayow6.mjs} +29 -1
- package/dist/packem_shared/compileAgentWorkflow-DAfyUuI5.mjs +78 -0
- package/dist/packem_shared/{consoleTelemetry-z2MiP1jt.mjs → consoleTelemetry--3sWfu1R.mjs} +1 -1
- package/dist/packem_shared/{createAgentGenerate-BQv9YJ01.mjs → createAgentGenerate-DO7Z96zX.mjs} +1 -1
- package/dist/packem_shared/{otlpTelemetry-DL6iZ9e2.mjs → otlpTelemetry-CKgmWVLg.mjs} +24 -18
- package/dist/packem_shared/{runAgentLoop-B3Q2o-Uz.mjs → runAgentLoop-M8PKbtWT.mjs} +1 -1
- package/dist/packem_shared/{sentryTelemetry-CgqFJyLO.mjs → sentryTelemetry-A4F5ndh9.mjs} +1 -1
- package/dist/telemetry/index.d.mts +17 -8
- package/dist/telemetry/index.d.ts +17 -8
- package/dist/telemetry/index.mjs +4 -4
- package/package.json +7 -7
- package/dist/packem_shared/compileAgentWorkflow-DX90058f.mjs +0 -55
package/dist/index.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { runAgentLoop, splitForCompaction } from './packem_shared/runAgentLoop-
|
|
1
|
+
export { runAgentLoop, splitForCompaction } from './packem_shared/runAgentLoop-M8PKbtWT.mjs';
|
|
2
2
|
export { collectAgenticMemoryTools, toSearchResults } from './packem_shared/collectAgenticMemoryTools-QrzpV-WX.mjs';
|
|
3
3
|
export { agentAsTool } from './packem_shared/agentAsTool-CUHlWsmt.mjs';
|
|
4
4
|
export { codeTool } from './packem_shared/codeTool-CjgJOC9t.mjs';
|
|
@@ -6,13 +6,13 @@ export { agentComponent, agentExtension } from './component.mjs';
|
|
|
6
6
|
export { default as createAgentContext } from './packem_shared/createAgentContext-4xJGXNR4.mjs';
|
|
7
7
|
export { defineAgent, defineAgentTool, isAgentDefinition } from './packem_shared/defineAgent-DAwAZC9P.mjs';
|
|
8
8
|
export { functionTool } from './packem_shared/functionTool-D6lCa2jB.mjs';
|
|
9
|
-
export { createAgentGenerate, createEpisodeExtract, createGraphExtract, createStreamGenerate, resolveAgentModel } from './packem_shared/createAgentGenerate-
|
|
9
|
+
export { createAgentGenerate, createEpisodeExtract, createGraphExtract, createStreamGenerate, resolveAgentModel } from './packem_shared/createAgentGenerate-DO7Z96zX.mjs';
|
|
10
10
|
export { adaptMcpResult, mcpTools } from './packem_shared/adaptMcpResult-wtNMvLoP.mjs';
|
|
11
11
|
export { buildModelMessages } from './packem_shared/buildModelMessages-BWFigaoo.mjs';
|
|
12
12
|
export { agentBindingName, agentClassName, agentDefaultName, voiceBindingName, voiceClassName } from './naming.mjs';
|
|
13
13
|
export { AGENT_MODULE, DEFAULT_AGENT_FUNCTION_PATHS, SANDBOX_INVOKE_PATH, SANDBOX_MODULE, toFunctionReference } from './packem_shared/AGENT_MODULE-Dnt_-AAT.mjs';
|
|
14
14
|
export { browserTool, containerTool, fsTool } from './sandbox.mjs';
|
|
15
15
|
export { defineSkill, isSkillDefinition } from './packem_shared/defineSkill-Ctf_S-rz.mjs';
|
|
16
|
-
export { default as VoiceSessionDO } from './packem_shared/VoiceSessionDO-
|
|
16
|
+
export { default as VoiceSessionDO } from './packem_shared/VoiceSessionDO-BdwlLaXC.mjs';
|
|
17
17
|
export { runVoiceTurn } from './packem_shared/runVoiceTurn-LnqLvCRR.mjs';
|
|
18
|
-
export { default as compileAgentWorkflow } from './packem_shared/compileAgentWorkflow-
|
|
18
|
+
export { default as compileAgentWorkflow } from './packem_shared/compileAgentWorkflow-DAfyUuI5.mjs';
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { createAi } from '@lunora/ai';
|
|
2
2
|
import { c as createDispatchRunner } from './createDispatchRunner-DSbp_dph-ZHTtxy3f.mjs';
|
|
3
3
|
import { t as toBase64 } from './base64-BVwtgRJV.mjs';
|
|
4
|
-
import { createStreamGenerate } from './createAgentGenerate-
|
|
4
|
+
import { createStreamGenerate } from './createAgentGenerate-DO7Z96zX.mjs';
|
|
5
5
|
import { DEFAULT_AGENT_FUNCTION_PATHS, toFunctionReference } from './AGENT_MODULE-Dnt_-AAT.mjs';
|
|
6
6
|
import { parseIdentity, pcmToWav, readTranscriptionText, readSynthesisAudio, runVoiceTurn, toByteIterable } from './runVoiceTurn-LnqLvCRR.mjs';
|
|
7
7
|
|
|
@@ -30,7 +30,7 @@ class VoiceSessionDO {
|
|
|
30
30
|
this.agent = agent;
|
|
31
31
|
this.exportName = exportName;
|
|
32
32
|
this.paths = DEFAULT_AGENT_FUNCTION_PATHS;
|
|
33
|
-
this.ai = createAi({ binding: env["AI"] });
|
|
33
|
+
this.ai = createAi({ binding: env["AI"], env });
|
|
34
34
|
this.streamGenerate = createStreamGenerate(agent, env);
|
|
35
35
|
this.sttModel = agent.voice?.stt ?? DEFAULT_STT_MODEL;
|
|
36
36
|
this.ttsModel = agent.voice?.tts ?? DEFAULT_TTS_MODEL;
|
package/dist/packem_shared/{braintrustTelemetry-wuGDErob.mjs → braintrustTelemetry-TP7Kwuuj.mjs}
RENAMED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { d as describeError, t as toolInputOf, r as readField } from './common-
|
|
1
|
+
import { d as describeError, t as toolInputOf, r as readField } from './common-DQXayow6.mjs';
|
|
2
2
|
|
|
3
3
|
const stringOr = (value, fallback) => typeof value === "string" && value.length > 0 ? value : fallback;
|
|
4
4
|
const braintrustTelemetry = (options) => {
|
|
@@ -14,6 +14,34 @@ const summarizeUsage = (usage) => {
|
|
|
14
14
|
}
|
|
15
15
|
return Object.keys(summary).length > 0 ? summary : void 0;
|
|
16
16
|
};
|
|
17
|
+
const summarizeGatewayTelemetry = (result) => {
|
|
18
|
+
const gateway = readField(readField(result, "providerMetadata"), "gateway");
|
|
19
|
+
const headers = readField(readField(result, "response"), "headers");
|
|
20
|
+
const readHeader = (name) => {
|
|
21
|
+
const getter = readField(headers, "get");
|
|
22
|
+
const value = typeof getter === "function" ? getter.call(headers, name) : readField(headers, name);
|
|
23
|
+
return typeof value === "string" && value.length > 0 ? value : void 0;
|
|
24
|
+
};
|
|
25
|
+
const summary = {};
|
|
26
|
+
const cost = readField(gateway, "cost");
|
|
27
|
+
if (typeof cost === "number" && Number.isFinite(cost)) {
|
|
28
|
+
summary.cost = cost;
|
|
29
|
+
}
|
|
30
|
+
const cachedField = readField(gateway, "cached");
|
|
31
|
+
const cacheStatusField = readField(gateway, "cacheStatus");
|
|
32
|
+
const cacheStatus = typeof cacheStatusField === "string" ? cacheStatusField : readHeader("cf-aig-cache-status");
|
|
33
|
+
if (typeof cachedField === "boolean") {
|
|
34
|
+
summary.cached = cachedField;
|
|
35
|
+
} else if (typeof cacheStatus === "string") {
|
|
36
|
+
summary.cached = cacheStatus.toUpperCase() === "HIT";
|
|
37
|
+
}
|
|
38
|
+
const metadataLogId = readField(gateway, "logId") ?? readField(gateway, "log_id");
|
|
39
|
+
const logId = typeof metadataLogId === "string" && metadataLogId.length > 0 ? metadataLogId : readHeader("cf-aig-log-id");
|
|
40
|
+
if (typeof logId === "string" && logId.length > 0) {
|
|
41
|
+
summary.logId = logId;
|
|
42
|
+
}
|
|
43
|
+
return Object.keys(summary).length > 0 ? summary : void 0;
|
|
44
|
+
};
|
|
17
45
|
const describeToolOutcome = (event) => {
|
|
18
46
|
const toolCall = readField(event, "toolCall");
|
|
19
47
|
const nameValue = readField(toolCall, "toolName");
|
|
@@ -58,4 +86,4 @@ const describeError = (error) => {
|
|
|
58
86
|
return error;
|
|
59
87
|
};
|
|
60
88
|
|
|
61
|
-
export { toolNameOf as a, describeToolOutcome as b, contentText as c, describeError as d, readField as r, summarizeUsage as s, toolInputOf as t };
|
|
89
|
+
export { toolNameOf as a, describeToolOutcome as b, contentText as c, describeError as d, summarizeGatewayTelemetry as e, readField as r, summarizeUsage as s, toolInputOf as t };
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { defineWorkflow } from '@lunora/workflow';
|
|
2
|
+
import { runAgentLoop } from './runAgentLoop-M8PKbtWT.mjs';
|
|
3
|
+
import { createStreamGenerate, createAgentGenerate, createEpisodeExtract, createGraphExtract, createCompact } from './createAgentGenerate-DO7Z96zX.mjs';
|
|
4
|
+
import { agentDefaultName } from '../naming.mjs';
|
|
5
|
+
import { DEFAULT_AGENT_FUNCTION_PATHS } from './AGENT_MODULE-Dnt_-AAT.mjs';
|
|
6
|
+
import { c as createDispatchRunner } from './createDispatchRunner-DSbp_dph-ZHTtxy3f.mjs';
|
|
7
|
+
import { otlpTelemetry } from './otlpTelemetry-CKgmWVLg.mjs';
|
|
8
|
+
|
|
9
|
+
const resolveAgentRun = (contextRun, owner, env) => {
|
|
10
|
+
if (owner === void 0) {
|
|
11
|
+
return contextRun;
|
|
12
|
+
}
|
|
13
|
+
return createDispatchRunner({ env, identity: { userId: owner }, label: "@lunora/agent" });
|
|
14
|
+
};
|
|
15
|
+
|
|
16
|
+
const withAutoOtlpTelemetry = (agent, env, conversationId) => {
|
|
17
|
+
const endpoint = env.LUNORA_OTLP_ENDPOINT;
|
|
18
|
+
if (typeof endpoint !== "string" || endpoint === "" || agent.telemetry?.isEnabled === false) {
|
|
19
|
+
return agent;
|
|
20
|
+
}
|
|
21
|
+
const token = typeof env.LUNORA_OTLP_TOKEN === "string" ? env.LUNORA_OTLP_TOKEN : void 0;
|
|
22
|
+
const existingList = [agent.telemetry?.integrations].flat().filter((integration) => integration !== void 0);
|
|
23
|
+
return {
|
|
24
|
+
...agent,
|
|
25
|
+
telemetry: {
|
|
26
|
+
...agent.telemetry,
|
|
27
|
+
// Tag every generation span with the run's thread as its conversation
|
|
28
|
+
// id (one thread = one multi-turn conversation), so the cloud groups a
|
|
29
|
+
// deployed agent's turns with no app wiring. Absent → ungrouped, as before.
|
|
30
|
+
integrations: [...existingList, otlpTelemetry({ conversationId, endpoint, token })],
|
|
31
|
+
isEnabled: true
|
|
32
|
+
}
|
|
33
|
+
};
|
|
34
|
+
};
|
|
35
|
+
const compileAgentWorkflow = (agent, exportName, options) => defineWorkflow({
|
|
36
|
+
handler: async (context) => {
|
|
37
|
+
const runtimeAgent = withAutoOtlpTelemetry(agent, context.env, context.params.threadKey);
|
|
38
|
+
return runAgentLoop({
|
|
39
|
+
agent: runtimeAgent,
|
|
40
|
+
// Automatic history compaction. Dormant unless the agent declares
|
|
41
|
+
// a `compaction` config; the loop gates on it, so any other agent
|
|
42
|
+
// takes the byte-identical no-compaction path.
|
|
43
|
+
compact: createCompact(),
|
|
44
|
+
env: context.env,
|
|
45
|
+
exportName,
|
|
46
|
+
// Run-end graph extraction. Dormant unless the agent declares a
|
|
47
|
+
// `kind: "graph"` memory source AND the run carries an owner — the
|
|
48
|
+
// loop gates on both, so a semantic-only agent takes the
|
|
49
|
+
// byte-identical no-extraction path.
|
|
50
|
+
extractGraph: createGraphExtract(),
|
|
51
|
+
// Run-end episode recording. Dormant unless the agent declares a
|
|
52
|
+
// `kind: "episodic"` memory source AND the run carries an owner —
|
|
53
|
+
// the loop gates on both, so any other agent is byte-identical.
|
|
54
|
+
extractEpisode: createEpisodeExtract(),
|
|
55
|
+
generate: createAgentGenerate(runtimeAgent, context.env),
|
|
56
|
+
instanceId: context.event.instanceId,
|
|
57
|
+
params: context.params,
|
|
58
|
+
paths: options?.paths ?? DEFAULT_AGENT_FUNCTION_PATHS,
|
|
59
|
+
// The loop reads its own owner-gated thread back through
|
|
60
|
+
// `agents:*` queries. The default `context.run` forwards no
|
|
61
|
+
// identity, so on an OWNED thread those reads would come back
|
|
62
|
+
// empty and the model would answer blind. `resolveAgentRun`
|
|
63
|
+
// dispatches an owner-scoped run under that verified identity so
|
|
64
|
+
// the owner gate admits the loop's reads (ownerless runs keep the
|
|
65
|
+
// identity-free `context.run`). See `resolve-run.ts`.
|
|
66
|
+
run: resolveAgentRun(context.run, context.params.owner, context.env),
|
|
67
|
+
step: context.step,
|
|
68
|
+
// The streaming seam is wired and ready, but stays dormant until a
|
|
69
|
+
// live token sink is threaded onto the run (a follow-up wires
|
|
70
|
+
// `onTokenDelta` to the stream transport). With no sink the loop
|
|
71
|
+
// takes the byte-identical non-streaming `generate` path.
|
|
72
|
+
streamGenerate: createStreamGenerate(runtimeAgent, context.env)
|
|
73
|
+
});
|
|
74
|
+
},
|
|
75
|
+
name: agent.name ?? agentDefaultName(exportName)
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
export { compileAgentWorkflow as default };
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { s as summarizeUsage, c as contentText, t as toolInputOf, d as describeError, r as readField, a as toolNameOf, b as describeToolOutcome } from './common-
|
|
1
|
+
import { s as summarizeUsage, c as contentText, t as toolInputOf, d as describeError, r as readField, a as toolNameOf, b as describeToolOutcome } from './common-DQXayow6.mjs';
|
|
2
2
|
|
|
3
3
|
const defaultLogger = (level, message, fields) => {
|
|
4
4
|
const target = globalThis.console;
|
package/dist/packem_shared/{createAgentGenerate-BQv9YJ01.mjs → createAgentGenerate-DO7Z96zX.mjs}
RENAMED
|
@@ -33,7 +33,7 @@ const resolveAgentModel = (model, env) => {
|
|
|
33
33
|
`@lunora/agent: the agent model "${model}" is a Workers AI id but there is no \`AI\` binding on the workflow env — declare the ai binding in wrangler.jsonc`
|
|
34
34
|
);
|
|
35
35
|
}
|
|
36
|
-
return createAi({ binding }).model(model);
|
|
36
|
+
return createAi({ binding, env }).model(model);
|
|
37
37
|
}
|
|
38
38
|
return model;
|
|
39
39
|
};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { s as summarizeUsage,
|
|
1
|
+
import { s as summarizeUsage, r as readField, e as summarizeGatewayTelemetry, c as contentText, t as toolInputOf, a as toolNameOf } from './common-DQXayow6.mjs';
|
|
2
2
|
|
|
3
3
|
const otlpUnixNano = (ms) => `${String(Math.round(ms))}000000`;
|
|
4
4
|
const otlpRandomHex = (bytes) => {
|
|
@@ -67,8 +67,21 @@ const pushAttribute = (attributes, key, value) => {
|
|
|
67
67
|
}
|
|
68
68
|
attributes.push(encodeAttribute(key, JSON.stringify(value)));
|
|
69
69
|
};
|
|
70
|
+
const observeSettled = (promise, onSettle) => {
|
|
71
|
+
const run = async () => {
|
|
72
|
+
let result;
|
|
73
|
+
try {
|
|
74
|
+
result = await promise;
|
|
75
|
+
} catch (error) {
|
|
76
|
+
onSettle(false, error instanceof Error ? error.message : String(error), void 0);
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
onSettle(true, void 0, result);
|
|
80
|
+
};
|
|
81
|
+
run().catch(() => void 0);
|
|
82
|
+
};
|
|
70
83
|
const otlpTelemetry = (options) => {
|
|
71
|
-
const { endpoint, headers, recordInputs = false, recordOutputs = false, token, traceId: fixedTraceId, waitUntil } = options;
|
|
84
|
+
const { conversationId, endpoint, headers, recordInputs = false, recordOutputs = false, token, traceId: fixedTraceId, waitUntil } = options;
|
|
72
85
|
const serviceName = options.serviceName ?? "lunora";
|
|
73
86
|
let base = endpoint;
|
|
74
87
|
while (base.endsWith("/")) {
|
|
@@ -110,12 +123,19 @@ const otlpTelemetry = (options) => {
|
|
|
110
123
|
pushAttribute(attributes, "gen_ai.operation.name", "chat");
|
|
111
124
|
pushAttribute(attributes, "gen_ai.request.model", modelId);
|
|
112
125
|
pushAttribute(attributes, "gen_ai.system", readField(options_, "provider"));
|
|
126
|
+
pushAttribute(attributes, "gen_ai.conversation.id", conversationId);
|
|
113
127
|
const usage = summarizeUsage(readField(result, "usage"));
|
|
114
128
|
if (usage) {
|
|
115
129
|
pushAttribute(attributes, "gen_ai.usage.input_tokens", usage.inputTokens);
|
|
116
130
|
pushAttribute(attributes, "gen_ai.usage.output_tokens", usage.outputTokens);
|
|
117
131
|
pushAttribute(attributes, "gen_ai.usage.total_tokens", usage.totalTokens);
|
|
118
132
|
}
|
|
133
|
+
const gateway = summarizeGatewayTelemetry(result);
|
|
134
|
+
if (gateway) {
|
|
135
|
+
pushAttribute(attributes, "gen_ai.usage.cost", gateway.cost);
|
|
136
|
+
pushAttribute(attributes, "gen_ai.response.cached", gateway.cached);
|
|
137
|
+
pushAttribute(attributes, "cf.aig.log_id", gateway.logId);
|
|
138
|
+
}
|
|
119
139
|
if (recordInputs) {
|
|
120
140
|
pushAttribute(attributes, "gen_ai.prompt", readField(options_, "messages"));
|
|
121
141
|
}
|
|
@@ -124,14 +144,7 @@ const otlpTelemetry = (options) => {
|
|
|
124
144
|
}
|
|
125
145
|
emitSpan(typeof modelId === "string" ? `chat ${modelId}` : "language_model_call", startTs, ok, message, attributes);
|
|
126
146
|
};
|
|
127
|
-
promise
|
|
128
|
-
(result) => {
|
|
129
|
-
emit(true, void 0, result);
|
|
130
|
-
},
|
|
131
|
-
(error) => {
|
|
132
|
-
emit(false, error instanceof Error ? error.message : String(error), void 0);
|
|
133
|
-
}
|
|
134
|
-
);
|
|
147
|
+
observeSettled(promise, emit);
|
|
135
148
|
return promise;
|
|
136
149
|
},
|
|
137
150
|
executeTool: (options_) => {
|
|
@@ -148,14 +161,7 @@ const otlpTelemetry = (options) => {
|
|
|
148
161
|
}
|
|
149
162
|
emitSpan(typeof toolName === "string" ? `execute_tool ${toolName}` : "execute_tool", startTs, ok, message, attributes);
|
|
150
163
|
};
|
|
151
|
-
promise
|
|
152
|
-
() => {
|
|
153
|
-
emit(true, void 0);
|
|
154
|
-
},
|
|
155
|
-
(error) => {
|
|
156
|
-
emit(false, error instanceof Error ? error.message : String(error));
|
|
157
|
-
}
|
|
158
|
-
);
|
|
164
|
+
observeSettled(promise, emit);
|
|
159
165
|
return promise;
|
|
160
166
|
}
|
|
161
167
|
};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { resolveAgentModel } from './createAgentGenerate-
|
|
1
|
+
import { resolveAgentModel } from './createAgentGenerate-DO7Z96zX.mjs';
|
|
2
2
|
import { f as firstGraphSource, m as memoryStepName, a as firstEpisodicSource, r as resolveInjectedSources } from './memory-D4FPcBsX.mjs';
|
|
3
3
|
import { buildModelMessages } from './buildModelMessages-BWFigaoo.mjs';
|
|
4
4
|
import { agentBindingName } from '../naming.mjs';
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { r as readField, t as toolInputOf } from './common-
|
|
1
|
+
import { r as readField, t as toolInputOf } from './common-DQXayow6.mjs';
|
|
2
2
|
|
|
3
3
|
const stringOr = (value, fallback) => typeof value === "string" && value.length > 0 ? value : fallback;
|
|
4
4
|
const sentryTelemetry = (options) => {
|
|
@@ -127,6 +127,15 @@ declare const consoleTelemetry: (options?: ConsoleTelemetryOptions) => Telemetry
|
|
|
127
127
|
* @experimental
|
|
128
128
|
*/
|
|
129
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;
|
|
130
139
|
/**
|
|
131
140
|
* The OTLP-over-HTTP collector base endpoint (e.g. the Lunora Cloud's `/v1`
|
|
132
141
|
* base). Spans are POSTed to `${endpoint}/v1/traces`; a trailing slash is
|
|
@@ -163,7 +172,7 @@ interface OtlpTelemetryOptions extends CommonOptions {
|
|
|
163
172
|
/**
|
|
164
173
|
* An OTLP-over-HTTP telemetry integration for `@lunora/agent`.
|
|
165
174
|
*
|
|
166
|
-
* The OTLP counterpart to
|
|
175
|
+
* The OTLP counterpart to the `sentryTelemetry` / `braintrustTelemetry` bridges:
|
|
167
176
|
* it wraps each language-model call and tool execution in an OTLP **span**
|
|
168
177
|
* (`gen_ai.*` semantic-convention attributes — model, provider, token usage,
|
|
169
178
|
* tool name) and ships it to a collector, so agent generations land in the same
|
|
@@ -181,13 +190,13 @@ interface OtlpTelemetryOptions extends CommonOptions {
|
|
|
181
190
|
* Each export is fire-and-forget (registered with `waitUntil` when supplied);
|
|
182
191
|
* every rejection is swallowed so a flaky collector never surfaces to the run.
|
|
183
192
|
*
|
|
184
|
-
* Two deliberate differences from the SDK-backed
|
|
185
|
-
*
|
|
186
|
-
*
|
|
187
|
-
*
|
|
188
|
-
*
|
|
189
|
-
*
|
|
190
|
-
*
|
|
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.
|
|
191
200
|
* @param options `endpoint` (+ optional `token`/`headers`/`serviceName`),
|
|
192
201
|
* `traceId` to group a run's spans, `waitUntil`, and the `recordInputs`/
|
|
193
202
|
* `recordOutputs` privacy flags.
|
|
@@ -127,6 +127,15 @@ declare const consoleTelemetry: (options?: ConsoleTelemetryOptions) => Telemetry
|
|
|
127
127
|
* @experimental
|
|
128
128
|
*/
|
|
129
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;
|
|
130
139
|
/**
|
|
131
140
|
* The OTLP-over-HTTP collector base endpoint (e.g. the Lunora Cloud's `/v1`
|
|
132
141
|
* base). Spans are POSTed to `${endpoint}/v1/traces`; a trailing slash is
|
|
@@ -163,7 +172,7 @@ interface OtlpTelemetryOptions extends CommonOptions {
|
|
|
163
172
|
/**
|
|
164
173
|
* An OTLP-over-HTTP telemetry integration for `@lunora/agent`.
|
|
165
174
|
*
|
|
166
|
-
* The OTLP counterpart to
|
|
175
|
+
* The OTLP counterpart to the `sentryTelemetry` / `braintrustTelemetry` bridges:
|
|
167
176
|
* it wraps each language-model call and tool execution in an OTLP **span**
|
|
168
177
|
* (`gen_ai.*` semantic-convention attributes — model, provider, token usage,
|
|
169
178
|
* tool name) and ships it to a collector, so agent generations land in the same
|
|
@@ -181,13 +190,13 @@ interface OtlpTelemetryOptions extends CommonOptions {
|
|
|
181
190
|
* Each export is fire-and-forget (registered with `waitUntil` when supplied);
|
|
182
191
|
* every rejection is swallowed so a flaky collector never surfaces to the run.
|
|
183
192
|
*
|
|
184
|
-
* Two deliberate differences from the SDK-backed
|
|
185
|
-
*
|
|
186
|
-
*
|
|
187
|
-
*
|
|
188
|
-
*
|
|
189
|
-
*
|
|
190
|
-
*
|
|
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.
|
|
191
200
|
* @param options `endpoint` (+ optional `token`/`headers`/`serviceName`),
|
|
192
201
|
* `traceId` to group a run's spans, `waitUntil`, and the `recordInputs`/
|
|
193
202
|
* `recordOutputs` privacy flags.
|
package/dist/telemetry/index.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
export { braintrustTelemetry } from '../packem_shared/braintrustTelemetry-
|
|
1
|
+
export { braintrustTelemetry } from '../packem_shared/braintrustTelemetry-TP7Kwuuj.mjs';
|
|
2
2
|
export { combineTelemetry } from '../packem_shared/combineTelemetry-DCyaaWAI.mjs';
|
|
3
|
-
export { consoleTelemetry } from '../packem_shared/consoleTelemetry
|
|
4
|
-
export { otlpTelemetry } from '../packem_shared/otlpTelemetry-
|
|
5
|
-
export { sentryTelemetry } from '../packem_shared/sentryTelemetry-
|
|
3
|
+
export { consoleTelemetry } from '../packem_shared/consoleTelemetry--3sWfu1R.mjs';
|
|
4
|
+
export { otlpTelemetry } from '../packem_shared/otlpTelemetry-CKgmWVLg.mjs';
|
|
5
|
+
export { sentryTelemetry } from '../packem_shared/sentryTelemetry-A4F5ndh9.mjs';
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lunora/agent",
|
|
3
|
-
"version": "1.0.0-alpha.
|
|
3
|
+
"version": "1.0.0-alpha.9",
|
|
4
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
6
|
"agent",
|
|
@@ -76,12 +76,12 @@
|
|
|
76
76
|
"access": "public"
|
|
77
77
|
},
|
|
78
78
|
"dependencies": {
|
|
79
|
-
"@lunora/ai": "1.0.0-alpha.
|
|
80
|
-
"@lunora/errors": "1.0.0-alpha.
|
|
81
|
-
"@lunora/mail": "1.0.0-alpha.
|
|
82
|
-
"@lunora/server": "1.0.0-alpha.
|
|
83
|
-
"@lunora/values": "1.0.0-alpha.
|
|
84
|
-
"@lunora/workflow": "1.0.0-alpha.
|
|
79
|
+
"@lunora/ai": "1.0.0-alpha.24",
|
|
80
|
+
"@lunora/errors": "1.0.0-alpha.7",
|
|
81
|
+
"@lunora/mail": "1.0.0-alpha.17",
|
|
82
|
+
"@lunora/server": "1.0.0-alpha.30",
|
|
83
|
+
"@lunora/values": "1.0.0-alpha.10",
|
|
84
|
+
"@lunora/workflow": "1.0.0-alpha.12",
|
|
85
85
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
86
86
|
"ai": "7.0.31"
|
|
87
87
|
},
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
import { defineWorkflow } from '@lunora/workflow';
|
|
2
|
-
import { runAgentLoop } from './runAgentLoop-B3Q2o-Uz.mjs';
|
|
3
|
-
import { createStreamGenerate, createAgentGenerate, createEpisodeExtract, createGraphExtract, createCompact } from './createAgentGenerate-BQv9YJ01.mjs';
|
|
4
|
-
import { agentDefaultName } from '../naming.mjs';
|
|
5
|
-
import { DEFAULT_AGENT_FUNCTION_PATHS } from './AGENT_MODULE-Dnt_-AAT.mjs';
|
|
6
|
-
import { c as createDispatchRunner } from './createDispatchRunner-DSbp_dph-ZHTtxy3f.mjs';
|
|
7
|
-
|
|
8
|
-
const resolveAgentRun = (contextRun, owner, env) => {
|
|
9
|
-
if (owner === void 0) {
|
|
10
|
-
return contextRun;
|
|
11
|
-
}
|
|
12
|
-
return createDispatchRunner({ env, identity: { userId: owner }, label: "@lunora/agent" });
|
|
13
|
-
};
|
|
14
|
-
|
|
15
|
-
const compileAgentWorkflow = (agent, exportName, options) => defineWorkflow({
|
|
16
|
-
handler: async (context) => runAgentLoop({
|
|
17
|
-
agent,
|
|
18
|
-
// Automatic history compaction. Dormant unless the agent declares
|
|
19
|
-
// a `compaction` config; the loop gates on it, so any other agent
|
|
20
|
-
// takes the byte-identical no-compaction path.
|
|
21
|
-
compact: createCompact(),
|
|
22
|
-
env: context.env,
|
|
23
|
-
exportName,
|
|
24
|
-
// Run-end graph extraction. Dormant unless the agent declares a
|
|
25
|
-
// `kind: "graph"` memory source AND the run carries an owner — the
|
|
26
|
-
// loop gates on both, so a semantic-only agent takes the
|
|
27
|
-
// byte-identical no-extraction path.
|
|
28
|
-
extractGraph: createGraphExtract(),
|
|
29
|
-
// Run-end episode recording. Dormant unless the agent declares a
|
|
30
|
-
// `kind: "episodic"` memory source AND the run carries an owner —
|
|
31
|
-
// the loop gates on both, so any other agent is byte-identical.
|
|
32
|
-
extractEpisode: createEpisodeExtract(),
|
|
33
|
-
generate: createAgentGenerate(agent, context.env),
|
|
34
|
-
instanceId: context.event.instanceId,
|
|
35
|
-
params: context.params,
|
|
36
|
-
paths: options?.paths ?? DEFAULT_AGENT_FUNCTION_PATHS,
|
|
37
|
-
// The loop reads its own owner-gated thread back through
|
|
38
|
-
// `agents:*` queries. The default `context.run` forwards no
|
|
39
|
-
// identity, so on an OWNED thread those reads would come back
|
|
40
|
-
// empty and the model would answer blind. `resolveAgentRun`
|
|
41
|
-
// dispatches an owner-scoped run under that verified identity so
|
|
42
|
-
// the owner gate admits the loop's reads (ownerless runs keep the
|
|
43
|
-
// identity-free `context.run`). See `resolve-run.ts`.
|
|
44
|
-
run: resolveAgentRun(context.run, context.params.owner, context.env),
|
|
45
|
-
step: context.step,
|
|
46
|
-
// The streaming seam is wired and ready, but stays dormant until a
|
|
47
|
-
// live token sink is threaded onto the run (a follow-up wires
|
|
48
|
-
// `onTokenDelta` to the stream transport). With no sink the loop
|
|
49
|
-
// takes the byte-identical non-streaming `generate` path.
|
|
50
|
-
streamGenerate: createStreamGenerate(agent, context.env)
|
|
51
|
-
}),
|
|
52
|
-
name: agent.name ?? agentDefaultName(exportName)
|
|
53
|
-
});
|
|
54
|
-
|
|
55
|
-
export { compileAgentWorkflow as default };
|