@agentuity/runtime 0.1.14 → 0.1.16

package/dist/_tokens.js

@@ -0,0 +1,96 @@
+import { inAgentContext, inHTTPContext, getHTTPContext } from './_context';
+import { SpanAttributes } from '@traceloop/ai-semantic-conventions';
+export const TOKENS_HEADER = 'x-agentuity-tokens';
+export const DURATION_HEADER = 'x-agentuity-duration';
+// AI SDK span names: ai.generateText, ai.streamText, ai.generateObject, ai.streamObject, ai.embed, ai.embedMany
+const AI_SDK_SPAN_PREFIX = 'ai.';
+const AI_SDK_MODEL_NAME = 'ai.model.id';
+const AI_SDK_USAGE_PROMPT_TOKENS = 'ai.usage.promptTokens';
+const AI_SDK_USAGE_COMPLETION_TOKENS = 'ai.usage.completionTokens';
+const parseTokenHeader = (val) => {
+    const kv = new Map();
+    if (val) {
+        // format is: [model]:[count] [model:count]
+        const tok = val.split(' ');
+        for (const entry of tok) {
+            const [name, count] = entry.split(':');
+            if (name) {
+                kv.set(name, parseInt(count ?? '0') ?? 0);
+            }
+        }
+    }
+    return kv;
+};
+const serializeTokenHeader = (kv) => {
+    const lines = [];
+    for (const [k, v] of kv) {
+        lines.push(`${k}:${v}`);
+    }
+    return lines.join(' ');
+};
+const getTokenValue = (val) => {
+    if (val) {
+        const v = val.valueOf();
+        switch (typeof v) {
+            case 'number':
+                return v;
+            case 'string':
+                return parseInt(v, 10);
+            default:
+        }
+    }
+    return 0;
+};
+export class TokenSpanProcessor {
+    onStart(_span, _context) {
+        return;
+    }
+    onEnd(span) {
+        if (inAgentContext() && inHTTPContext()) {
+            const ctx = getHTTPContext();
+            const tokenLine = ctx.res.headers.get(TOKENS_HEADER) ?? undefined;
+            const tokens = parseTokenHeader(tokenLine);
+            let mutated = false;
+            // AI SDK uses ai.* span names but doesn't use the semantic attribute names
+            if (span.name.startsWith(AI_SDK_SPAN_PREFIX) && AI_SDK_MODEL_NAME in span.attributes) {
+                const model = span.attributes[AI_SDK_MODEL_NAME].toString();
+                let totalTokens = tokens.get(model) ?? 0;
+                if (AI_SDK_USAGE_PROMPT_TOKENS in span.attributes) {
+                    totalTokens += getTokenValue(span.attributes[AI_SDK_USAGE_PROMPT_TOKENS]);
+                }
+                if (AI_SDK_USAGE_COMPLETION_TOKENS in span.attributes) {
+                    totalTokens += getTokenValue(span.attributes[AI_SDK_USAGE_COMPLETION_TOKENS]);
+                }
+                if (totalTokens > 0) {
+                    tokens.set(model, totalTokens);
+                    mutated = true;
+                }
+            }
+            else if (SpanAttributes.LLM_SYSTEM in span.attributes &&
+                SpanAttributes.LLM_RESPONSE_MODEL in span.attributes) {
+                const model = span.attributes[SpanAttributes.LLM_RESPONSE_MODEL].toString();
+                let totalTokens = tokens.get(model) ?? 0;
+                if (SpanAttributes.LLM_USAGE_PROMPT_TOKENS in span.attributes) {
+                    totalTokens += getTokenValue(span.attributes[SpanAttributes.LLM_USAGE_PROMPT_TOKENS]);
+                }
+                if (SpanAttributes.LLM_USAGE_COMPLETION_TOKENS in span.attributes) {
+                    totalTokens += getTokenValue(span.attributes[SpanAttributes.LLM_USAGE_COMPLETION_TOKENS]);
+                }
+                if (totalTokens > 0) {
+                    tokens.set(model, totalTokens);
+                    mutated = true;
+                }
+            }
+            if (mutated) {
+                ctx.header(TOKENS_HEADER, serializeTokenHeader(tokens));
+            }
+        }
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=_tokens.js.map

package/dist/_tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_tokens.js","sourceRoot":"","sources":["../src/_tokens.ts"],"names":[],"mappings":"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"}

package/dist/_util.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from 'hono';
+export declare function returnResponse(ctx: Context, result: unknown): Response;
+/**
+ * SHA256 hash of the given values
+ *
+ * @param val one or more strings to hash
+ * @returns hash string in hex format
+ */
+export declare function hash(...val: string[]): string;
+/**
+ * Safely stringify an object to JSON, handling circular references
+ * @param obj - The object to stringify
+ * @returns JSON string representation
+ */
+export declare function safeStringify(obj: unknown): string;
+//# sourceMappingURL=_util.d.ts.map

package/dist/_util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_util.d.ts","sourceRoot":"","sources":["../src/_util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,YAM3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAI7C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAkClD"}

package/dist/_util.js

@@ -0,0 +1,54 @@
+export function returnResponse(ctx, result) {
+    if (result instanceof ReadableStream)
+        return ctx.body(result);
+    if (result instanceof Response)
+        return result;
+    if (typeof result === 'string')
+        return ctx.text(result);
+    if (typeof result === 'number' || typeof result === 'boolean')
+        return ctx.text(String(result));
+    return ctx.json(result);
+}
+/**
+ * SHA256 hash of the given values
+ *
+ * @param val one or more strings to hash
+ * @returns hash string in hex format
+ */
+export function hash(...val) {
+    const hasher = new Bun.CryptoHasher('sha256');
+    val.map((val) => hasher.update(val));
+    return hasher.digest().toHex();
+}
+/**
+ * Safely stringify an object to JSON, handling circular references
+ * @param obj - The object to stringify
+ * @returns JSON string representation
+ */
+export function safeStringify(obj) {
+    const stack = [];
+    function replacer(_key, value) {
+        if (typeof value === 'bigint') {
+            return value.toString();
+        }
+        if (typeof value === 'object' && value !== null) {
+            // Check if this object is already in our ancestor chain
+            if (stack.includes(value)) {
+                return '[Circular]';
+            }
+            // Add to stack before processing
+            stack.push(value);
+            // Process the object
+            const result = Array.isArray(value) ? [] : {};
+            for (const [k, v] of Object.entries(value)) {
+                result[k] = replacer(k, v);
+            }
+            // Remove from stack after processing
+            stack.pop();
+            return result;
+        }
+        return value;
+    }
+    return JSON.stringify(replacer('', obj));
+}
+//# sourceMappingURL=_util.js.map

package/dist/_util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_util.js","sourceRoot":"","sources":["../src/_util.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,GAAY,EAAE,MAAe;IAC3D,IAAI,MAAM,YAAY,cAAc;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,MAAM,YAAY,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/F,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,GAAG,GAAa;IACpC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACzC,MAAM,KAAK,GAAc,EAAE,CAAC;IAE5B,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAc;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjD,wDAAwD;YACxD,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO,YAAY,CAAC;YACrB,CAAC;YAED,iCAAiC;YACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAElB,qBAAqB;YACrB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAE9C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAkC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACzD,CAAC;YAED,qCAAqC;YACrC,KAAK,CAAC,GAAG,EAAE,CAAC;YAEZ,OAAO,MAAM,CAAC;QACf,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/_validation.d.ts

@@ -0,0 +1,89 @@
+import type { StandardSchemaV1, InferInput, InferOutput } from '@agentuity/core';
+/**
+ * Schema definition for routes that can have input (POST, PUT, PATCH, DELETE).
+ * Both input and output are optional, but output is recommended.
+ *
+ * @template TInput - Input schema (StandardSchemaV1 or undefined)
+ * @template TOutput - Output schema (StandardSchemaV1 or undefined)
+ *
+ * @example
+ * ```typescript
+ * const schema: RouteSchema<z.ZodObject<{name: z.ZodString}>, z.ZodString> = {
+ *   input: z.object({ name: z.string() }),
+ *   output: z.string()
+ * };
+ * ```
+ */
+export type RouteSchema<TInput extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined, TOutput extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined> = {
+    input?: TInput;
+    output?: TOutput;
+};
+/**
+ * Schema definition for GET routes.
+ * Input is not allowed (enforced as never), only output validation is supported.
+ *
+ * @template TOutput - Output schema (StandardSchemaV1 or undefined)
+ *
+ * @example
+ * ```typescript
+ * const schema: GetRouteSchema<z.ZodString> = {
+ *   output: z.string()
+ * };
+ * ```
+ */
+export type GetRouteSchema<TOutput extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined> = {
+    input?: never;
+    output?: TOutput;
+};
+/**
+ * Infer the input type from a StandardSchema.
+ * Returns the input type of the schema (before validation/transformation).
+ *
+ * @template T - Schema type
+ */
+export type InferSchemaInput<T> = T extends StandardSchemaV1 ? InferInput<T> : undefined;
+/**
+ * Infer the output type from a StandardSchema.
+ * Returns the output type of the schema (after validation/transformation).
+ *
+ * @template T - Schema type
+ */
+export type InferSchemaOutput<T> = T extends StandardSchemaV1 ? InferOutput<T> : undefined;
+/**
+ * Extract input schema from RouteSchema or GetRouteSchema.
+ *
+ * @template T - RouteSchema or GetRouteSchema type
+ */
+export type ExtractInputSchema<T> = T extends RouteSchema<infer I, any> ? I : T extends GetRouteSchema<any> ? never : never;
+/**
+ * Extract output schema from RouteSchema or GetRouteSchema.
+ *
+ * @template T - RouteSchema or GetRouteSchema type
+ */
+export type ExtractOutputSchema<T> = T extends RouteSchema<any, infer O> ? O : T extends GetRouteSchema<infer O> ? O : never;
+/**
+ * Validation result from StandardSchema validation.
+ */
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    issues: StandardSchemaV1.Issue[];
+};
+/**
+ * Validates a value against a StandardSchema.
+ *
+ * @param schema - The StandardSchema to validate against
+ * @param value - The value to validate
+ * @returns ValidationResult with success/failure and data/issues
+ */
+export declare function validateSchema<T>(schema: StandardSchemaV1, value: unknown): Promise<ValidationResult<T>>;
+/**
+ * Format validation issues into a readable error message.
+ *
+ * @param issues - Array of validation issues
+ * @returns Formatted error message
+ */
+export declare function formatValidationIssues(issues: StandardSchemaV1.Issue[]): string;
+//# sourceMappingURL=_validation.d.ts.map

package/dist/_validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_validation.d.ts","sourceRoot":"","sources":["../src/_validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,CACtB,MAAM,SAAS,gBAAgB,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,EAC1E,OAAO,SAAS,gBAAgB,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,IACxE;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,CACzB,OAAO,SAAS,gBAAgB,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,IACxE;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,gBAAgB,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAE3F;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC/B,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;AAEzF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAChC,CAAC,SAAS,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAA;CAAE,CAAC;AAExD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACrC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAQ9B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,GAAG,MAAM,CAO/E"}

package/dist/_validation.js

@@ -0,0 +1,29 @@
+/**
+ * Validates a value against a StandardSchema.
+ *
+ * @param schema - The StandardSchema to validate against
+ * @param value - The value to validate
+ * @returns ValidationResult with success/failure and data/issues
+ */
+export async function validateSchema(schema, value) {
+    const result = await schema['~standard'].validate(value);
+    if ('issues' in result && result.issues) {
+        return { success: false, issues: Array.from(result.issues) };
+    }
+    return { success: true, data: result.value };
+}
+/**
+ * Format validation issues into a readable error message.
+ *
+ * @param issues - Array of validation issues
+ * @returns Formatted error message
+ */
+export function formatValidationIssues(issues) {
+    return issues
+        .map((issue) => {
+        const path = issue.path?.map((p) => (typeof p === 'object' ? p.key : p)).join('.') || '';
+        return path ? `${path}: ${issue.message}` : issue.message;
+    })
+        .join(', ');
+}
+//# sourceMappingURL=_validation.js.map

package/dist/_validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_validation.js","sourceRoot":"","sources":["../src/_validation.ts"],"names":[],"mappings":"AAqFA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,MAAwB,EACxB,KAAc;IAEd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEzD,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAU,EAAE,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAgC;IACtE,OAAO,MAAM;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzF,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IAC3D,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/_waituntil.d.ts

@@ -0,0 +1,18 @@
+import { type Tracer } from '@opentelemetry/api';
+import type { Logger } from './logger';
+/**
+ * returns true if wait until is pending
+ * @returns boolean
+ */
+export declare function hasWaitUntilPending(): boolean;
+export default class WaitUntilHandler {
+    private promises;
+    private tracer;
+    private started;
+    private hasCalledWaitUntilAll;
+    constructor(tracer: Tracer);
+    waitUntil(promise: Promise<void> | (() => void | Promise<void>)): void;
+    hasPending(): boolean;
+    waitUntilAll(logger: Logger, sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=_waituntil.d.ts.map

package/dist/_waituntil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_waituntil.d.ts","sourceRoot":"","sources":["../src/_waituntil.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,MAAM,EAAS,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMvC;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAYD,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACpC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,qBAAqB,CAAS;gBAEnB,MAAM,EAAE,MAAM;IAK1B,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;IAsCtE,UAAU,IAAI,OAAO;IAIf,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsC3E"}

package/dist/_waituntil.js

@@ -0,0 +1,97 @@
+import { context, SpanStatusCode, trace } from '@opentelemetry/api';
+import { internal } from './logger/internal';
+import { StructuredError } from '@agentuity/core';
+let running = 0;
+/**
+ * returns true if wait until is pending
+ * @returns boolean
+ */
+export function hasWaitUntilPending() {
+    internal.debug('hasWaitUntilPending called: %d', running);
+    return running > 0;
+}
+const WaitUntilInvalidStateError = StructuredError('WaitUntilInvalidStateError', 'waitUntil cannot be called after waitUntilAll has been called');
+const WaitUntilAllInvalidStateError = StructuredError('WaitUntilAllInvalidStateError', 'waitUntilAll can only be called once per instance');
+export default class WaitUntilHandler {
+    promises;
+    tracer;
+    started;
+    hasCalledWaitUntilAll = false;
+    constructor(tracer) {
+        this.tracer = tracer;
+        this.promises = [];
+    }
+    waitUntil(promise) {
+        if (this.hasCalledWaitUntilAll) {
+            throw new WaitUntilInvalidStateError();
+        }
+        running++;
+        internal.debug('wait until called, running: %d', running);
+        const currentContext = context.active();
+        // Start execution immediately, don't defer it
+        const executingPromise = (async () => {
+            if (this.started === undefined) {
+                this.started = Date.now(); /// this first execution marks the start time
+            }
+            const span = this.tracer.startSpan('waitUntil', {}, currentContext);
+            const spanContext = trace.setSpan(currentContext, span);
+            try {
+                internal.debug('starting waituntil');
+                await context.with(spanContext, async () => {
+                    const resolvedPromise = typeof promise === 'function' ? promise() : promise;
+                    return await Promise.resolve(resolvedPromise);
+                });
+                internal.debug('completed waituntil');
+                span.setStatus({ code: SpanStatusCode.OK });
+            }
+            catch (ex) {
+                span.recordException(ex);
+                span.setStatus({ code: SpanStatusCode.ERROR });
+                // Log the error but don't re-throw - background tasks should never crash the server
+                internal.error('Background task error: %s', ex);
+            }
+            finally {
+                span.end();
+            }
+            // NOTE: we only decrement when the promise is removed from the array in waitUntilAll
+        })();
+        // Store the executing promise for cleanup tracking
+        this.promises.push(executingPromise);
+    }
+    hasPending() {
+        return this.promises.length > 0;
+    }
+    async waitUntilAll(logger, sessionId) {
+        internal.debug(`🔍 waitUntilAll() called for session ${sessionId} (count: %d)`, running);
+        if (this.hasCalledWaitUntilAll) {
+            throw new WaitUntilAllInvalidStateError();
+        }
+        this.hasCalledWaitUntilAll = true;
+        if (this.promises.length === 0) {
+            internal.debug('No promises to wait for, executing evals directly');
+            // await this.executeEvalsForSession(logger, sessionId);
+            return;
+        }
+        internal.debug(`⏳ Waiting for ${this.promises.length} promises to complete...`);
+        try {
+            // Promises are already executing, just wait for them to complete
+            // Use allSettled so one failing promise doesn't stop others
+            const results = await Promise.allSettled(this.promises);
+            const duration = Date.now() - this.started;
+            // Log any failures
+            const failures = results.filter((r) => r.status === 'rejected');
+            if (failures.length > 0) {
+                logger.error('%d background task(s) failed during execution', failures.length);
+            }
+            internal.debug('✅ All promises completed, marking session completed (duration %dms)', duration);
+        }
+        catch (ex) {
+            logger.error('error sending session completed', ex);
+        }
+        finally {
+            running -= this.promises.length;
+            this.promises.length = 0;
+        }
+    }
+}
+//# sourceMappingURL=_waituntil.js.map

package/dist/_waituntil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_waituntil.js","sourceRoot":"","sources":["../src/_waituntil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAe,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,gCAAgC,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,OAAO,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,0BAA0B,GAAG,eAAe,CACjD,4BAA4B,EAC5B,+DAA+D,CAC/D,CAAC;AAEF,MAAM,6BAA6B,GAAG,eAAe,CACpD,+BAA+B,EAC/B,mDAAmD,CACnD,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,gBAAgB;IAC5B,QAAQ,CAAkB;IAC1B,MAAM,CAAS;IACf,OAAO,CAAqB;IAC5B,qBAAqB,GAAG,KAAK,CAAC;IAEtC,YAAmB,MAAc;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACpB,CAAC;IAEM,SAAS,CAAC,OAAqD;QACrE,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,IAAI,0BAA0B,EAAE,CAAC;QACxC,CAAC;QACD,OAAO,EAAE,CAAC;QACV,QAAQ,CAAC,KAAK,CAAC,gCAAgC,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAExC,8CAA8C;QAC9C,MAAM,gBAAgB,GAAG,CAAC,KAAK,IAAI,EAAE;YACpC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,6CAA6C;YACzE,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC;YACpE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YACxD,IAAI,CAAC;gBACJ,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBACrC,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;oBAC1C,MAAM,eAAe,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;oBAC5E,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;gBAC/C,CAAC,CAAC,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBACtC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,EAAW,EAAE,CAAC;gBACtB,IAAI,CAAC,eAAe,CAAC,EAAW,CAAC,CAAC;gBAClC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC/C,oFAAoF;gBACpF,QAAQ,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;YACjD,CAAC;oBAAS,CAAC;gBACV,IAAI,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;YACD,qFAAqF;QACtF,CAAC,CAAC,EAAE,CAAC;QAEL,mDAAmD;QACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACtC,CAAC;IAEM,UAAU;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,SAAiB;QAC1D,QAAQ,CAAC,KAAK,CAAC,wCAAwC,SAAS,cAAc,EAAE,OAAO,CAAC,CAAC;QAEzF,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,IAAI,6BAA6B,EAAE,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAElC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACpE,wDAAwD;YACxD,OAAO;QACR,CAAC;QAED,QAAQ,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,MAAM,0BAA0B,CAAC,CAAC;QAChF,IAAI,CAAC;YACJ,iEAAiE;YACjE,4DAA4D;YAC5D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAI,IAAI,CAAC,OAAkB,CAAC;YAEvD,mBAAmB;YACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;YAChE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,KAAK,CAAC,+CAA+C,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAChF,CAAC;YAED,QAAQ,CAAC,KAAK,CACb,qEAAqE,EACrE,QAAQ,CACR,CAAC;QACH,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;gBAAS,CAAC;YACV,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,CAAC;IACF,CAAC;CACD"}