convex-langfuse 0.0.1
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/LICENSE +201 -0
- package/README.md +334 -0
- package/dist/client/_generated/_ignore.d.ts +1 -0
- package/dist/client/_generated/_ignore.d.ts.map +1 -0
- package/dist/client/_generated/_ignore.js +3 -0
- package/dist/client/_generated/_ignore.js.map +1 -0
- package/dist/client/index.d.ts +166 -0
- package/dist/client/index.d.ts.map +1 -0
- package/dist/client/index.js +223 -0
- package/dist/client/index.js.map +1 -0
- package/dist/component/_generated/api.d.ts +34 -0
- package/dist/component/_generated/api.d.ts.map +1 -0
- package/dist/component/_generated/api.js +31 -0
- package/dist/component/_generated/api.js.map +1 -0
- package/dist/component/_generated/component.d.ts +157 -0
- package/dist/component/_generated/component.d.ts.map +1 -0
- package/dist/component/_generated/component.js +11 -0
- package/dist/component/_generated/component.js.map +1 -0
- package/dist/component/_generated/dataModel.d.ts +46 -0
- package/dist/component/_generated/dataModel.d.ts.map +1 -0
- package/dist/component/_generated/dataModel.js +11 -0
- package/dist/component/_generated/dataModel.js.map +1 -0
- package/dist/component/_generated/server.d.ts +133 -0
- package/dist/component/_generated/server.d.ts.map +1 -0
- package/dist/component/_generated/server.js +80 -0
- package/dist/component/_generated/server.js.map +1 -0
- package/dist/component/convex.config.d.ts +3 -0
- package/dist/component/convex.config.d.ts.map +1 -0
- package/dist/component/convex.config.js +4 -0
- package/dist/component/convex.config.js.map +1 -0
- package/dist/component/lib.d.ts +133 -0
- package/dist/component/lib.d.ts.map +1 -0
- package/dist/component/lib.js +214 -0
- package/dist/component/lib.js.map +1 -0
- package/dist/component/schema.d.ts +83 -0
- package/dist/component/schema.d.ts.map +1 -0
- package/dist/component/schema.js +48 -0
- package/dist/component/schema.js.map +1 -0
- package/package.json +106 -0
- package/src/client/_generated/_ignore.ts +1 -0
- package/src/client/index.ts +322 -0
- package/src/client/setup.test.ts +26 -0
- package/src/component/_generated/api.ts +50 -0
- package/src/component/_generated/component.ts +222 -0
- package/src/component/_generated/dataModel.ts +60 -0
- package/src/component/_generated/server.ts +169 -0
- package/src/component/convex.config.ts +5 -0
- package/src/component/lib.test.ts +130 -0
- package/src/component/lib.ts +252 -0
- package/src/component/schema.ts +66 -0
- package/src/component/setup.test.ts +11 -0
- package/src/test.ts +18 -0
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
import type { GenericActionCtx, GenericDataModel } from "convex/server";
|
|
2
|
+
import type { ComponentApi } from "../component/_generated/component.js";
|
|
3
|
+
export type LangfuseOptions = {
|
|
4
|
+
publicKey: string;
|
|
5
|
+
secretKey: string;
|
|
6
|
+
/** Defaults to the EU Langfuse Cloud region. */
|
|
7
|
+
baseUrl?: string;
|
|
8
|
+
};
|
|
9
|
+
export type ObservationLevel = "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
|
|
10
|
+
export type LogObservationArgs = {
|
|
11
|
+
/** Continue an existing trace, or omit to start a new one. */
|
|
12
|
+
traceId?: string;
|
|
13
|
+
traceName?: string;
|
|
14
|
+
userId?: string;
|
|
15
|
+
sessionId?: string;
|
|
16
|
+
tags?: string[];
|
|
17
|
+
release?: string;
|
|
18
|
+
traceMetadata?: Record<string, unknown>;
|
|
19
|
+
name: string;
|
|
20
|
+
input?: unknown;
|
|
21
|
+
output?: unknown;
|
|
22
|
+
model?: string;
|
|
23
|
+
inputTokens?: number;
|
|
24
|
+
outputTokens?: number;
|
|
25
|
+
level?: ObservationLevel;
|
|
26
|
+
statusMessage?: string;
|
|
27
|
+
metadata?: Record<string, unknown>;
|
|
28
|
+
startTime?: number;
|
|
29
|
+
endTime?: number;
|
|
30
|
+
};
|
|
31
|
+
export type LogObservationResult = {
|
|
32
|
+
traceId: string;
|
|
33
|
+
observationId: string;
|
|
34
|
+
};
|
|
35
|
+
/**
|
|
36
|
+
* Send LLM traces, generations, and scores to Langfuse over its OpenTelemetry
|
|
37
|
+
* ingestion endpoint (the legacy `/api/public/ingestion` batch API sunsets on
|
|
38
|
+
* Langfuse Cloud in November 2026), while keeping a reactive local copy in Convex.
|
|
39
|
+
*/
|
|
40
|
+
export declare class Langfuse {
|
|
41
|
+
private component;
|
|
42
|
+
private options;
|
|
43
|
+
constructor(component: ComponentApi, options: LangfuseOptions);
|
|
44
|
+
private authHeader;
|
|
45
|
+
private baseUrl;
|
|
46
|
+
private exportSpan;
|
|
47
|
+
private logObservation;
|
|
48
|
+
/** Log a completed LLM call (model, input, output, token usage) as a Langfuse generation. */
|
|
49
|
+
logGeneration(ctx: GenericActionCtx<GenericDataModel>, args: LogObservationArgs): Promise<LogObservationResult>;
|
|
50
|
+
/** Log a non-LLM step (a tool call, a retrieval, a chain step) as a Langfuse span. */
|
|
51
|
+
logSpan(ctx: GenericActionCtx<GenericDataModel>, args: LogObservationArgs): Promise<LogObservationResult>;
|
|
52
|
+
/** Attach an evaluation score to a trace, via Langfuse's Scores API. */
|
|
53
|
+
recordScore(ctx: GenericActionCtx<GenericDataModel>, args: {
|
|
54
|
+
traceId: string;
|
|
55
|
+
name: string;
|
|
56
|
+
value: number;
|
|
57
|
+
comment?: string;
|
|
58
|
+
}): Promise<{
|
|
59
|
+
scoreId: string;
|
|
60
|
+
}>;
|
|
61
|
+
getTrace(ctx: RunQueryCtx, args: {
|
|
62
|
+
traceId: string;
|
|
63
|
+
}): Promise<{
|
|
64
|
+
_creationTime: number;
|
|
65
|
+
_id: string;
|
|
66
|
+
createdAt: number;
|
|
67
|
+
metadata?: string;
|
|
68
|
+
name: string;
|
|
69
|
+
release?: string;
|
|
70
|
+
sessionId?: string;
|
|
71
|
+
tags?: Array<string>;
|
|
72
|
+
traceId: string;
|
|
73
|
+
updatedAt: number;
|
|
74
|
+
userId?: string;
|
|
75
|
+
} | null>;
|
|
76
|
+
listTracesByUser(ctx: RunQueryCtx, args: {
|
|
77
|
+
userId: string;
|
|
78
|
+
limit?: number;
|
|
79
|
+
}): Promise<{
|
|
80
|
+
_creationTime: number;
|
|
81
|
+
_id: string;
|
|
82
|
+
createdAt: number;
|
|
83
|
+
metadata?: string;
|
|
84
|
+
name: string;
|
|
85
|
+
release?: string;
|
|
86
|
+
sessionId?: string;
|
|
87
|
+
tags?: Array<string>;
|
|
88
|
+
traceId: string;
|
|
89
|
+
updatedAt: number;
|
|
90
|
+
userId?: string;
|
|
91
|
+
}[]>;
|
|
92
|
+
listTracesBySession(ctx: RunQueryCtx, args: {
|
|
93
|
+
sessionId: string;
|
|
94
|
+
limit?: number;
|
|
95
|
+
}): Promise<{
|
|
96
|
+
_creationTime: number;
|
|
97
|
+
_id: string;
|
|
98
|
+
createdAt: number;
|
|
99
|
+
metadata?: string;
|
|
100
|
+
name: string;
|
|
101
|
+
release?: string;
|
|
102
|
+
sessionId?: string;
|
|
103
|
+
tags?: Array<string>;
|
|
104
|
+
traceId: string;
|
|
105
|
+
updatedAt: number;
|
|
106
|
+
userId?: string;
|
|
107
|
+
}[]>;
|
|
108
|
+
listObservations(ctx: RunQueryCtx, args: {
|
|
109
|
+
traceId: string;
|
|
110
|
+
}): Promise<{
|
|
111
|
+
_creationTime: number;
|
|
112
|
+
_id: string;
|
|
113
|
+
createdAt: number;
|
|
114
|
+
endedAt: number;
|
|
115
|
+
input?: string;
|
|
116
|
+
inputTokens?: number;
|
|
117
|
+
level: "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
|
|
118
|
+
metadata?: string;
|
|
119
|
+
model?: string;
|
|
120
|
+
name: string;
|
|
121
|
+
observationId: string;
|
|
122
|
+
output?: string;
|
|
123
|
+
outputTokens?: number;
|
|
124
|
+
startedAt: number;
|
|
125
|
+
statusMessage?: string;
|
|
126
|
+
traceId: string;
|
|
127
|
+
type: "span" | "generation" | "event" | "embedding" | "agent" | "tool" | "chain" | "retriever" | "guardrail" | "evaluator";
|
|
128
|
+
}[]>;
|
|
129
|
+
listScores(ctx: RunQueryCtx, args: {
|
|
130
|
+
traceId: string;
|
|
131
|
+
}): Promise<{
|
|
132
|
+
_creationTime: number;
|
|
133
|
+
_id: string;
|
|
134
|
+
comment?: string;
|
|
135
|
+
createdAt: number;
|
|
136
|
+
name: string;
|
|
137
|
+
scoreId: string;
|
|
138
|
+
traceId: string;
|
|
139
|
+
value: number;
|
|
140
|
+
}[]>;
|
|
141
|
+
getStats(ctx: RunQueryCtx): Promise<{
|
|
142
|
+
observations: number;
|
|
143
|
+
scores: number;
|
|
144
|
+
traces: number;
|
|
145
|
+
}>;
|
|
146
|
+
listRecentTraces(ctx: RunQueryCtx, args?: {
|
|
147
|
+
limit?: number;
|
|
148
|
+
}): Promise<{
|
|
149
|
+
_creationTime: number;
|
|
150
|
+
_id: string;
|
|
151
|
+
createdAt: number;
|
|
152
|
+
metadata?: string;
|
|
153
|
+
name: string;
|
|
154
|
+
release?: string;
|
|
155
|
+
sessionId?: string;
|
|
156
|
+
tags?: Array<string>;
|
|
157
|
+
traceId: string;
|
|
158
|
+
updatedAt: number;
|
|
159
|
+
userId?: string;
|
|
160
|
+
}[]>;
|
|
161
|
+
}
|
|
162
|
+
type RunQueryCtx = {
|
|
163
|
+
runQuery: GenericActionCtx<GenericDataModel>["runQuery"];
|
|
164
|
+
};
|
|
165
|
+
export {};
|
|
166
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
function randomHex(byteLength) {
|
|
2
|
+
const bytes = new Uint8Array(byteLength);
|
|
3
|
+
crypto.getRandomValues(bytes);
|
|
4
|
+
return Array.from(bytes)
|
|
5
|
+
.map((b) => b.toString(16).padStart(2, "0"))
|
|
6
|
+
.join("");
|
|
7
|
+
}
|
|
8
|
+
function attr(key, value) {
|
|
9
|
+
if (value === undefined || value === null)
|
|
10
|
+
return null;
|
|
11
|
+
if (typeof value === "string")
|
|
12
|
+
return { key, value: { stringValue: value } };
|
|
13
|
+
if (typeof value === "number") {
|
|
14
|
+
return Number.isInteger(value)
|
|
15
|
+
? { key, value: { intValue: String(value) } }
|
|
16
|
+
: { key, value: { doubleValue: value } };
|
|
17
|
+
}
|
|
18
|
+
if (typeof value === "boolean")
|
|
19
|
+
return { key, value: { boolValue: value } };
|
|
20
|
+
if (Array.isArray(value)) {
|
|
21
|
+
return {
|
|
22
|
+
key,
|
|
23
|
+
value: {
|
|
24
|
+
arrayValue: {
|
|
25
|
+
values: value.map((v) => ({ stringValue: String(v) })),
|
|
26
|
+
},
|
|
27
|
+
},
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
return { key, value: { stringValue: JSON.stringify(value) } };
|
|
31
|
+
}
|
|
32
|
+
function flattenMetadata(prefix, metadata) {
|
|
33
|
+
if (!metadata)
|
|
34
|
+
return [];
|
|
35
|
+
return Object.entries(metadata)
|
|
36
|
+
.map(([k, v]) => attr(`${prefix}.${k}`, typeof v === "object" ? JSON.stringify(v) : v))
|
|
37
|
+
.filter((a) => a !== null);
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Send LLM traces, generations, and scores to Langfuse over its OpenTelemetry
|
|
41
|
+
* ingestion endpoint (the legacy `/api/public/ingestion` batch API sunsets on
|
|
42
|
+
* Langfuse Cloud in November 2026), while keeping a reactive local copy in Convex.
|
|
43
|
+
*/
|
|
44
|
+
export class Langfuse {
|
|
45
|
+
component;
|
|
46
|
+
options;
|
|
47
|
+
constructor(component, options) {
|
|
48
|
+
this.component = component;
|
|
49
|
+
this.options = options;
|
|
50
|
+
}
|
|
51
|
+
authHeader() {
|
|
52
|
+
return `Basic ${btoa(`${this.options.publicKey}:${this.options.secretKey}`)}`;
|
|
53
|
+
}
|
|
54
|
+
baseUrl() {
|
|
55
|
+
return this.options.baseUrl ?? "https://cloud.langfuse.com";
|
|
56
|
+
}
|
|
57
|
+
async exportSpan(args) {
|
|
58
|
+
const body = {
|
|
59
|
+
resourceSpans: [
|
|
60
|
+
{
|
|
61
|
+
resource: {
|
|
62
|
+
attributes: [{ key: "service.name", value: { stringValue: "convex-langfuse" } }],
|
|
63
|
+
},
|
|
64
|
+
scopeSpans: [
|
|
65
|
+
{
|
|
66
|
+
scope: { name: "convex-langfuse" },
|
|
67
|
+
spans: [
|
|
68
|
+
{
|
|
69
|
+
traceId: args.traceId,
|
|
70
|
+
spanId: args.spanId,
|
|
71
|
+
name: args.name,
|
|
72
|
+
kind: 1,
|
|
73
|
+
startTimeUnixNano: args.startTimeUnixNano,
|
|
74
|
+
endTimeUnixNano: args.endTimeUnixNano,
|
|
75
|
+
attributes: args.attributes,
|
|
76
|
+
},
|
|
77
|
+
],
|
|
78
|
+
},
|
|
79
|
+
],
|
|
80
|
+
},
|
|
81
|
+
],
|
|
82
|
+
};
|
|
83
|
+
const res = await fetch(`${this.baseUrl()}/api/public/otel/v1/traces`, {
|
|
84
|
+
method: "POST",
|
|
85
|
+
headers: {
|
|
86
|
+
Authorization: this.authHeader(),
|
|
87
|
+
"Content-Type": "application/json",
|
|
88
|
+
"x-langfuse-ingestion-version": "4",
|
|
89
|
+
},
|
|
90
|
+
body: JSON.stringify(body),
|
|
91
|
+
});
|
|
92
|
+
if (!res.ok) {
|
|
93
|
+
throw new Error(`Failed to export span to Langfuse: ${res.status} ${await res.text()}`);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
async logObservation(ctx, type, args) {
|
|
97
|
+
const traceId = args.traceId ?? randomHex(16);
|
|
98
|
+
const spanId = randomHex(8);
|
|
99
|
+
const startTime = args.startTime ?? Date.now();
|
|
100
|
+
const endTime = args.endTime ?? startTime;
|
|
101
|
+
const attributes = [
|
|
102
|
+
attr("langfuse.trace.name", args.traceName ?? args.name),
|
|
103
|
+
attr("langfuse.user.id", args.userId),
|
|
104
|
+
attr("langfuse.session.id", args.sessionId),
|
|
105
|
+
attr("langfuse.trace.tags", args.tags),
|
|
106
|
+
attr("langfuse.release", args.release),
|
|
107
|
+
attr("langfuse.observation.type", type),
|
|
108
|
+
attr("langfuse.observation.input", args.input !== undefined ? JSON.stringify(args.input) : undefined),
|
|
109
|
+
attr("langfuse.observation.output", args.output !== undefined ? JSON.stringify(args.output) : undefined),
|
|
110
|
+
attr("langfuse.observation.model.name", args.model),
|
|
111
|
+
attr("langfuse.observation.level", args.level ?? "DEFAULT"),
|
|
112
|
+
attr("langfuse.observation.status_message", args.statusMessage),
|
|
113
|
+
...(args.inputTokens !== undefined || args.outputTokens !== undefined
|
|
114
|
+
? [
|
|
115
|
+
attr("langfuse.observation.usage_details",
|
|
116
|
+
// Langfuse's usage details object uses "input"/"output"/"total",
|
|
117
|
+
// not "input_tokens"/"output_tokens" — the latter is silently
|
|
118
|
+
// ignored, so the generation shows no token usage or cost.
|
|
119
|
+
JSON.stringify({
|
|
120
|
+
input: args.inputTokens ?? 0,
|
|
121
|
+
output: args.outputTokens ?? 0,
|
|
122
|
+
total: (args.inputTokens ?? 0) + (args.outputTokens ?? 0),
|
|
123
|
+
})),
|
|
124
|
+
]
|
|
125
|
+
: []),
|
|
126
|
+
...flattenMetadata("langfuse.trace.metadata", args.traceMetadata),
|
|
127
|
+
...flattenMetadata("langfuse.observation.metadata", args.metadata),
|
|
128
|
+
].filter((a) => a !== null);
|
|
129
|
+
await this.exportSpan({
|
|
130
|
+
traceId,
|
|
131
|
+
spanId,
|
|
132
|
+
name: args.name,
|
|
133
|
+
startTimeUnixNano: String(startTime * 1_000_000),
|
|
134
|
+
endTimeUnixNano: String(endTime * 1_000_000),
|
|
135
|
+
attributes,
|
|
136
|
+
});
|
|
137
|
+
await ctx.runMutation(this.component.lib.recordTrace, {
|
|
138
|
+
traceId,
|
|
139
|
+
name: args.traceName ?? args.name,
|
|
140
|
+
userId: args.userId,
|
|
141
|
+
sessionId: args.sessionId,
|
|
142
|
+
tags: args.tags,
|
|
143
|
+
metadata: args.traceMetadata ? JSON.stringify(args.traceMetadata) : undefined,
|
|
144
|
+
release: args.release,
|
|
145
|
+
});
|
|
146
|
+
await ctx.runMutation(this.component.lib.recordObservation, {
|
|
147
|
+
observationId: spanId,
|
|
148
|
+
traceId,
|
|
149
|
+
type,
|
|
150
|
+
name: args.name,
|
|
151
|
+
input: args.input !== undefined ? JSON.stringify(args.input) : undefined,
|
|
152
|
+
output: args.output !== undefined ? JSON.stringify(args.output) : undefined,
|
|
153
|
+
model: args.model,
|
|
154
|
+
inputTokens: args.inputTokens,
|
|
155
|
+
outputTokens: args.outputTokens,
|
|
156
|
+
level: args.level ?? "DEFAULT",
|
|
157
|
+
statusMessage: args.statusMessage,
|
|
158
|
+
metadata: args.metadata ? JSON.stringify(args.metadata) : undefined,
|
|
159
|
+
startedAt: startTime,
|
|
160
|
+
endedAt: endTime,
|
|
161
|
+
});
|
|
162
|
+
return { traceId, observationId: spanId };
|
|
163
|
+
}
|
|
164
|
+
/** Log a completed LLM call (model, input, output, token usage) as a Langfuse generation. */
|
|
165
|
+
async logGeneration(ctx, args) {
|
|
166
|
+
return await this.logObservation(ctx, "generation", args);
|
|
167
|
+
}
|
|
168
|
+
/** Log a non-LLM step (a tool call, a retrieval, a chain step) as a Langfuse span. */
|
|
169
|
+
async logSpan(ctx, args) {
|
|
170
|
+
return await this.logObservation(ctx, "span", args);
|
|
171
|
+
}
|
|
172
|
+
/** Attach an evaluation score to a trace, via Langfuse's Scores API. */
|
|
173
|
+
async recordScore(ctx, args) {
|
|
174
|
+
const scoreId = randomHex(16);
|
|
175
|
+
const res = await fetch(`${this.baseUrl()}/api/public/scores`, {
|
|
176
|
+
method: "POST",
|
|
177
|
+
headers: {
|
|
178
|
+
Authorization: this.authHeader(),
|
|
179
|
+
"Content-Type": "application/json",
|
|
180
|
+
},
|
|
181
|
+
body: JSON.stringify({
|
|
182
|
+
id: scoreId,
|
|
183
|
+
traceId: args.traceId,
|
|
184
|
+
name: args.name,
|
|
185
|
+
value: args.value,
|
|
186
|
+
comment: args.comment,
|
|
187
|
+
}),
|
|
188
|
+
});
|
|
189
|
+
if (!res.ok) {
|
|
190
|
+
throw new Error(`Failed to record Langfuse score: ${res.status} ${await res.text()}`);
|
|
191
|
+
}
|
|
192
|
+
await ctx.runMutation(this.component.lib.recordScore, {
|
|
193
|
+
scoreId,
|
|
194
|
+
traceId: args.traceId,
|
|
195
|
+
name: args.name,
|
|
196
|
+
value: args.value,
|
|
197
|
+
comment: args.comment,
|
|
198
|
+
});
|
|
199
|
+
return { scoreId };
|
|
200
|
+
}
|
|
201
|
+
async getTrace(ctx, args) {
|
|
202
|
+
return await ctx.runQuery(this.component.lib.getTrace, args);
|
|
203
|
+
}
|
|
204
|
+
async listTracesByUser(ctx, args) {
|
|
205
|
+
return await ctx.runQuery(this.component.lib.listTracesByUser, args);
|
|
206
|
+
}
|
|
207
|
+
async listTracesBySession(ctx, args) {
|
|
208
|
+
return await ctx.runQuery(this.component.lib.listTracesBySession, args);
|
|
209
|
+
}
|
|
210
|
+
async listObservations(ctx, args) {
|
|
211
|
+
return await ctx.runQuery(this.component.lib.listObservations, args);
|
|
212
|
+
}
|
|
213
|
+
async listScores(ctx, args) {
|
|
214
|
+
return await ctx.runQuery(this.component.lib.listScores, args);
|
|
215
|
+
}
|
|
216
|
+
async getStats(ctx) {
|
|
217
|
+
return await ctx.runQuery(this.component.lib.getStats, {});
|
|
218
|
+
}
|
|
219
|
+
async listRecentTraces(ctx, args = {}) {
|
|
220
|
+
return await ctx.runQuery(this.component.lib.listRecentTraces, args);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Generated `api` utility.
|
|
3
|
+
*
|
|
4
|
+
* THIS CODE IS AUTOMATICALLY GENERATED.
|
|
5
|
+
*
|
|
6
|
+
* To regenerate, run `npx convex dev`.
|
|
7
|
+
* @module
|
|
8
|
+
*/
|
|
9
|
+
import type * as lib from "../lib.js";
|
|
10
|
+
import type { ApiFromModules, FilterApi, FunctionReference } from "convex/server";
|
|
11
|
+
declare const fullApi: ApiFromModules<{
|
|
12
|
+
lib: typeof lib;
|
|
13
|
+
}>;
|
|
14
|
+
/**
|
|
15
|
+
* A utility for referencing Convex functions in your app's public API.
|
|
16
|
+
*
|
|
17
|
+
* Usage:
|
|
18
|
+
* ```js
|
|
19
|
+
* const myFunctionReference = api.myModule.myFunction;
|
|
20
|
+
* ```
|
|
21
|
+
*/
|
|
22
|
+
export declare const api: FilterApi<typeof fullApi, FunctionReference<any, "public">>;
|
|
23
|
+
/**
|
|
24
|
+
* A utility for referencing Convex functions in your app's internal API.
|
|
25
|
+
*
|
|
26
|
+
* Usage:
|
|
27
|
+
* ```js
|
|
28
|
+
* const myFunctionReference = internal.myModule.myFunction;
|
|
29
|
+
* ```
|
|
30
|
+
*/
|
|
31
|
+
export declare const internal: FilterApi<typeof fullApi, FunctionReference<any, "internal">>;
|
|
32
|
+
export declare const components: {};
|
|
33
|
+
export {};
|
|
34
|
+
//# sourceMappingURL=api.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAGvB,QAAA,MAAM,OAAO,EAAE,cAAc,CAAC;IAC5B,GAAG,EAAE,OAAO,GAAG,CAAC;CACjB,CAAiB,CAAC;AAEnB;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,EAAE,SAAS,CACzB,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CACjB,CAAC;AAElB;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAC9B,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CACnB,CAAC;AAElB,eAAO,MAAM,UAAU,EAAqC,EAAE,CAAC"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/* eslint-disable */
|
|
2
|
+
/**
|
|
3
|
+
* Generated `api` utility.
|
|
4
|
+
*
|
|
5
|
+
* THIS CODE IS AUTOMATICALLY GENERATED.
|
|
6
|
+
*
|
|
7
|
+
* To regenerate, run `npx convex dev`.
|
|
8
|
+
* @module
|
|
9
|
+
*/
|
|
10
|
+
import { anyApi, componentsGeneric } from "convex/server";
|
|
11
|
+
const fullApi = anyApi;
|
|
12
|
+
/**
|
|
13
|
+
* A utility for referencing Convex functions in your app's public API.
|
|
14
|
+
*
|
|
15
|
+
* Usage:
|
|
16
|
+
* ```js
|
|
17
|
+
* const myFunctionReference = api.myModule.myFunction;
|
|
18
|
+
* ```
|
|
19
|
+
*/
|
|
20
|
+
export const api = anyApi;
|
|
21
|
+
/**
|
|
22
|
+
* A utility for referencing Convex functions in your app's internal API.
|
|
23
|
+
*
|
|
24
|
+
* Usage:
|
|
25
|
+
* ```js
|
|
26
|
+
* const myFunctionReference = internal.myModule.myFunction;
|
|
27
|
+
* ```
|
|
28
|
+
*/
|
|
29
|
+
export const internal = anyApi;
|
|
30
|
+
export const components = componentsGeneric();
|
|
31
|
+
//# sourceMappingURL=api.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AASH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,OAAO,GAER,MAAa,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAGZ,MAAa,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAGjB,MAAa,CAAC;AAElB,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAmB,CAAC"}
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Generated `ComponentApi` utility.
|
|
3
|
+
*
|
|
4
|
+
* THIS CODE IS AUTOMATICALLY GENERATED.
|
|
5
|
+
*
|
|
6
|
+
* To regenerate, run `npx convex dev`.
|
|
7
|
+
* @module
|
|
8
|
+
*/
|
|
9
|
+
import type { FunctionReference } from "convex/server";
|
|
10
|
+
/**
|
|
11
|
+
* A utility for referencing a Convex component's exposed API.
|
|
12
|
+
*
|
|
13
|
+
* Useful when expecting a parameter like `components.myComponent`.
|
|
14
|
+
* Usage:
|
|
15
|
+
* ```ts
|
|
16
|
+
* async function myFunction(ctx: QueryCtx, component: ComponentApi) {
|
|
17
|
+
* return ctx.runQuery(component.someFile.someQuery, { ...args });
|
|
18
|
+
* }
|
|
19
|
+
* ```
|
|
20
|
+
*/
|
|
21
|
+
export type ComponentApi<Name extends string | undefined = string | undefined> = {
|
|
22
|
+
lib: {
|
|
23
|
+
getStats: FunctionReference<"query", "internal", {}, {
|
|
24
|
+
observations: number;
|
|
25
|
+
scores: number;
|
|
26
|
+
traces: number;
|
|
27
|
+
}, Name>;
|
|
28
|
+
getTrace: FunctionReference<"query", "internal", {
|
|
29
|
+
traceId: string;
|
|
30
|
+
}, null | {
|
|
31
|
+
_creationTime: number;
|
|
32
|
+
_id: string;
|
|
33
|
+
createdAt: number;
|
|
34
|
+
metadata?: string;
|
|
35
|
+
name: string;
|
|
36
|
+
release?: string;
|
|
37
|
+
sessionId?: string;
|
|
38
|
+
tags?: Array<string>;
|
|
39
|
+
traceId: string;
|
|
40
|
+
updatedAt: number;
|
|
41
|
+
userId?: string;
|
|
42
|
+
}, Name>;
|
|
43
|
+
listObservations: FunctionReference<"query", "internal", {
|
|
44
|
+
traceId: string;
|
|
45
|
+
}, Array<{
|
|
46
|
+
_creationTime: number;
|
|
47
|
+
_id: string;
|
|
48
|
+
createdAt: number;
|
|
49
|
+
endedAt: number;
|
|
50
|
+
input?: string;
|
|
51
|
+
inputTokens?: number;
|
|
52
|
+
level: "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
|
|
53
|
+
metadata?: string;
|
|
54
|
+
model?: string;
|
|
55
|
+
name: string;
|
|
56
|
+
observationId: string;
|
|
57
|
+
output?: string;
|
|
58
|
+
outputTokens?: number;
|
|
59
|
+
startedAt: number;
|
|
60
|
+
statusMessage?: string;
|
|
61
|
+
traceId: string;
|
|
62
|
+
type: "span" | "generation" | "event" | "embedding" | "agent" | "tool" | "chain" | "retriever" | "guardrail" | "evaluator";
|
|
63
|
+
}>, Name>;
|
|
64
|
+
listRecentTraces: FunctionReference<"query", "internal", {
|
|
65
|
+
limit?: number;
|
|
66
|
+
}, Array<{
|
|
67
|
+
_creationTime: number;
|
|
68
|
+
_id: string;
|
|
69
|
+
createdAt: number;
|
|
70
|
+
metadata?: string;
|
|
71
|
+
name: string;
|
|
72
|
+
release?: string;
|
|
73
|
+
sessionId?: string;
|
|
74
|
+
tags?: Array<string>;
|
|
75
|
+
traceId: string;
|
|
76
|
+
updatedAt: number;
|
|
77
|
+
userId?: string;
|
|
78
|
+
}>, Name>;
|
|
79
|
+
listScores: FunctionReference<"query", "internal", {
|
|
80
|
+
traceId: string;
|
|
81
|
+
}, Array<{
|
|
82
|
+
_creationTime: number;
|
|
83
|
+
_id: string;
|
|
84
|
+
comment?: string;
|
|
85
|
+
createdAt: number;
|
|
86
|
+
name: string;
|
|
87
|
+
scoreId: string;
|
|
88
|
+
traceId: string;
|
|
89
|
+
value: number;
|
|
90
|
+
}>, Name>;
|
|
91
|
+
listTracesBySession: FunctionReference<"query", "internal", {
|
|
92
|
+
limit?: number;
|
|
93
|
+
sessionId: string;
|
|
94
|
+
}, Array<{
|
|
95
|
+
_creationTime: number;
|
|
96
|
+
_id: string;
|
|
97
|
+
createdAt: number;
|
|
98
|
+
metadata?: string;
|
|
99
|
+
name: string;
|
|
100
|
+
release?: string;
|
|
101
|
+
sessionId?: string;
|
|
102
|
+
tags?: Array<string>;
|
|
103
|
+
traceId: string;
|
|
104
|
+
updatedAt: number;
|
|
105
|
+
userId?: string;
|
|
106
|
+
}>, Name>;
|
|
107
|
+
listTracesByUser: FunctionReference<"query", "internal", {
|
|
108
|
+
limit?: number;
|
|
109
|
+
userId: string;
|
|
110
|
+
}, Array<{
|
|
111
|
+
_creationTime: number;
|
|
112
|
+
_id: string;
|
|
113
|
+
createdAt: number;
|
|
114
|
+
metadata?: string;
|
|
115
|
+
name: string;
|
|
116
|
+
release?: string;
|
|
117
|
+
sessionId?: string;
|
|
118
|
+
tags?: Array<string>;
|
|
119
|
+
traceId: string;
|
|
120
|
+
updatedAt: number;
|
|
121
|
+
userId?: string;
|
|
122
|
+
}>, Name>;
|
|
123
|
+
recordObservation: FunctionReference<"mutation", "internal", {
|
|
124
|
+
endedAt: number;
|
|
125
|
+
input?: string;
|
|
126
|
+
inputTokens?: number;
|
|
127
|
+
level: "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
|
|
128
|
+
metadata?: string;
|
|
129
|
+
model?: string;
|
|
130
|
+
name: string;
|
|
131
|
+
observationId: string;
|
|
132
|
+
output?: string;
|
|
133
|
+
outputTokens?: number;
|
|
134
|
+
startedAt: number;
|
|
135
|
+
statusMessage?: string;
|
|
136
|
+
traceId: string;
|
|
137
|
+
type: "span" | "generation" | "event" | "embedding" | "agent" | "tool" | "chain" | "retriever" | "guardrail" | "evaluator";
|
|
138
|
+
}, string, Name>;
|
|
139
|
+
recordScore: FunctionReference<"mutation", "internal", {
|
|
140
|
+
comment?: string;
|
|
141
|
+
name: string;
|
|
142
|
+
scoreId: string;
|
|
143
|
+
traceId: string;
|
|
144
|
+
value: number;
|
|
145
|
+
}, string, Name>;
|
|
146
|
+
recordTrace: FunctionReference<"mutation", "internal", {
|
|
147
|
+
metadata?: string;
|
|
148
|
+
name: string;
|
|
149
|
+
release?: string;
|
|
150
|
+
sessionId?: string;
|
|
151
|
+
tags?: Array<string>;
|
|
152
|
+
traceId: string;
|
|
153
|
+
userId?: string;
|
|
154
|
+
}, string, Name>;
|
|
155
|
+
};
|
|
156
|
+
};
|
|
157
|
+
//# sourceMappingURL=component.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/component.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../src/component/_generated/component.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG"}
|