veryfront 0.1.519 → 0.1.521

package/esm/src/agent/service/node-telemetry.js

@@ -1,3 +1,5 @@
+import { tryResolve } from "../../extensions/contracts.js";
+import { NodeTelemetryProviderName, } from "../../extensions/tracing/index.js";
 function resolveEnabled(env, defaultEnabled) {
     const envValue = env.OTEL_ENABLED;
     if (envValue !== undefined) {
@@ -74,44 +76,23 @@ export async function initializeNodeHostedAgentServiceOpenTelemetry(options) {
         return false;
     }
     try {
-        const { NodeSDK } = await import("@opentelemetry/sdk-node");
-        const { resourceFromAttributes } = await import("@opentelemetry/resources");
-        const { BatchSpanProcessor, ParentBasedSampler, TraceIdRatioBasedSampler } = await import("@opentelemetry/sdk-trace-base");
-        const { OTLPTraceExporter } = await import("@opentelemetry/exporter-trace-otlp-http");
-        const { getNodeAutoInstrumentations } = await import("@opentelemetry/auto-instrumentations-node");
-        const resource = resourceFromAttributes({
-            "service.name": options.serviceName,
-            "service.version": options.serviceVersion,
-            "deployment.environment": options.deploymentEnvironment,
-        });
-        const traceExporter = new OTLPTraceExporter({ headers: options.exporterHeaders });
-        const sdk = new NodeSDK({
-            resource,
-            sampler: new ParentBasedSampler({
-                root: new TraceIdRatioBasedSampler(options.samplingRatio),
-            }),
-            spanProcessor: new BatchSpanProcessor(traceExporter, {
-                maxExportBatchSize: 100,
-                scheduledDelayMillis: 500,
-            }),
-            instrumentations: [
-                getNodeAutoInstrumentations({
-                    "@opentelemetry/instrumentation-fs": { enabled: options.instrumentation.fs },
-                    "@opentelemetry/instrumentation-http": { enabled: options.instrumentation.http },
-                    "@opentelemetry/instrumentation-express": { enabled: options.instrumentation.express },
-                }),
-            ],
-        });
-        sdk.start();
-        logInfo(options.logger, "OpenTelemetry initialized", {
+        const telemetryProvider = options.telemetryProvider ??
+            tryResolve(NodeTelemetryProviderName);
+        if (!telemetryProvider) {
+            logError(options.logger, "Failed to initialize OpenTelemetry", 'Missing extension for contract "NodeTelemetryProvider"');
+            return false;
+        }
+        const initializeOptions = {
             serviceName: options.serviceName,
+            serviceVersion: options.serviceVersion,
+            deploymentEnvironment: options.deploymentEnvironment,
             samplingRatio: options.samplingRatio,
-        });
-        options.processTarget?.on("SIGTERM", async () => {
-            await sdk.shutdown();
-            logInfo(options.logger, "OpenTelemetry shutdown complete");
-        });
-        return true;
+            exporterHeaders: options.exporterHeaders,
+            instrumentation: options.instrumentation,
+            logger: options.logger,
+            processTarget: options.processTarget,
+        };
+        return await telemetryProvider.initialize(initializeOptions);
     }
     catch (error) {
         logError(options.logger, "Failed to initialize OpenTelemetry", error);

package/esm/src/agent/service/registration.d.ts

@@ -1,87 +1,65 @@
-import { z } from "zod";
-export declare const agentServiceRegistrationModeSchema: z.ZodEnum<{
-    auto: "auto";
-    enabled: "enabled";
-    disabled: "disabled";
-}>;
-export declare const agentServiceRegistrationConfigSchema: z.ZodObject<{
-    VERYFRONT_API_URL: z.ZodString;
-    VERYFRONT_API_TOKEN: z.ZodOptional<z.ZodString>;
-    VERYFRONT_PROJECT_ID: z.ZodOptional<z.ZodString>;
-    VERYFRONT_AGENT_SERVICE_URL: z.ZodOptional<z.ZodString>;
-    VERYFRONT_AGENT_SERVICE_KEY: z.ZodOptional<z.ZodString>;
-    VERYFRONT_AGENT_SERVICE_REGISTRATION: z.ZodEnum<{
-        auto: "auto";
-        enabled: "enabled";
-        disabled: "disabled";
-    }>;
-    VERYFRONT_AGENT_SERVICE_HEARTBEAT_INTERVAL_MS: z.ZodNumber;
-    VERYFRONT_AGENT_SERVICE_REGION: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const resolvedAgentServiceRegistrationInputSchema: z.ZodObject<{
-    apiUrl: z.ZodString;
-    authToken: z.ZodString;
-    serviceName: z.ZodString;
-    serviceKey: z.ZodString;
-    scopeKind: z.ZodEnum<{
-        global: "global";
-        project: "project";
-    }>;
-    projectId: z.ZodOptional<z.ZodString>;
-    agentId: z.ZodOptional<z.ZodString>;
-    baseUrl: z.ZodString;
-    invokeUrl: z.ZodString;
-    version: z.ZodOptional<z.ZodString>;
-    runtime: z.ZodOptional<z.ZodString>;
-    region: z.ZodOptional<z.ZodString>;
-    heartbeatIntervalMs: z.ZodNumber;
-}, z.core.$strip>;
-declare const agentPushRuntimeServiceRestSchema: z.ZodObject<{
-    id: z.ZodString;
-    service_name: z.ZodString;
-    service_key: z.ZodString;
-    scope_kind: z.ZodEnum<{
-        global: "global";
-        project: "project";
-    }>;
-    scope_key: z.ZodString;
-    project_id: z.ZodNullable<z.ZodString>;
-    agent_id: z.ZodNullable<z.ZodString>;
-    base_url: z.ZodString;
-    invoke_url: z.ZodString;
-    status: z.ZodEnum<{
-        disabled: "disabled";
-        active: "active";
-    }>;
-    capabilities: z.ZodNullable<z.ZodUnknown>;
-    metadata: z.ZodNullable<z.ZodUnknown>;
-    version: z.ZodNullable<z.ZodString>;
-    runtime: z.ZodNullable<z.ZodString>;
-    region: z.ZodNullable<z.ZodString>;
-    last_heartbeat_at: z.ZodNullable<z.ZodString>;
-    created_at: z.ZodString;
-    updated_at: z.ZodString;
-}, z.core.$strip>;
-declare const registerAgentPushRuntimeServiceRequestSchema: z.ZodObject<{
-    service_name: z.ZodString;
-    service_key: z.ZodString;
-    scope_kind: z.ZodEnum<{
-        global: "global";
-        project: "project";
-    }>;
-    project_id: z.ZodOptional<z.ZodString>;
-    agent_id: z.ZodOptional<z.ZodString>;
-    base_url: z.ZodString;
-    invoke_url: z.ZodString;
-    version: z.ZodOptional<z.ZodString>;
-    runtime: z.ZodOptional<z.ZodString>;
-    region: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type AgentServiceRegistrationMode = z.infer<typeof agentServiceRegistrationModeSchema>;
-export type AgentServiceRegistrationConfig = z.infer<typeof agentServiceRegistrationConfigSchema>;
-export type ResolvedAgentServiceRegistrationInput = z.infer<typeof resolvedAgentServiceRegistrationInputSchema>;
-export type AgentPushRuntimeServiceRest = z.infer<typeof agentPushRuntimeServiceRestSchema>;
-export type RegisterAgentPushRuntimeServiceRequest = z.infer<typeof registerAgentPushRuntimeServiceRequestSchema>;
+import type { Schema } from "../../extensions/schema/index.js";
+export type AgentServiceRegistrationMode = "auto" | "enabled" | "disabled";
+export type AgentServiceRegistrationConfig = {
+    VERYFRONT_API_URL: string;
+    VERYFRONT_API_TOKEN?: string;
+    VERYFRONT_PROJECT_ID?: string;
+    VERYFRONT_AGENT_SERVICE_URL?: string;
+    VERYFRONT_AGENT_SERVICE_KEY?: string;
+    VERYFRONT_AGENT_SERVICE_REGISTRATION: AgentServiceRegistrationMode;
+    VERYFRONT_AGENT_SERVICE_HEARTBEAT_INTERVAL_MS: number;
+    VERYFRONT_AGENT_SERVICE_REGION?: string;
+};
+export type ResolvedAgentServiceRegistrationInput = {
+    apiUrl: string;
+    authToken: string;
+    serviceName: string;
+    serviceKey: string;
+    scopeKind: "global" | "project";
+    projectId?: string;
+    agentId?: string;
+    baseUrl: string;
+    invokeUrl: string;
+    version?: string;
+    runtime?: string;
+    region?: string;
+    heartbeatIntervalMs: number;
+};
+export type AgentPushRuntimeServiceRest = {
+    id: string;
+    service_name: string;
+    service_key: string;
+    scope_kind: "global" | "project";
+    scope_key: string;
+    project_id: string | null;
+    agent_id: string | null;
+    base_url: string;
+    invoke_url: string;
+    status: "active" | "disabled";
+    capabilities?: unknown | null;
+    metadata?: unknown | null;
+    version: string | null;
+    runtime: string | null;
+    region: string | null;
+    last_heartbeat_at: string | null;
+    created_at: string;
+    updated_at: string;
+};
+export type RegisterAgentPushRuntimeServiceRequest = {
+    service_name: string;
+    service_key: string;
+    scope_kind: "global" | "project";
+    project_id?: string;
+    agent_id?: string;
+    base_url: string;
+    invoke_url: string;
+    version?: string;
+    runtime?: string;
+    region?: string;
+};
+export declare const agentServiceRegistrationModeSchema: Schema<AgentServiceRegistrationMode>;
+export declare const agentServiceRegistrationConfigSchema: Schema<AgentServiceRegistrationConfig>;
+export declare const resolvedAgentServiceRegistrationInputSchema: Schema<ResolvedAgentServiceRegistrationInput>;
 export type AgentServiceRegistrationLogger = {
     info?: (message: string, metadata?: Record<string, unknown>) => void;
     warn?: (message: string, metadata?: Record<string, unknown>) => void;
@@ -106,5 +84,4 @@ export type CreateAgentServiceRegistrationLifecycleOptions = ResolvedAgentServic
 };
 export declare function resolveAgentServiceRegistrationInput(options: ResolveAgentServiceRegistrationInputOptions): Promise<ResolvedAgentServiceRegistrationInput | null>;
 export declare function createAgentServiceRegistrationLifecycle(options: CreateAgentServiceRegistrationLifecycleOptions): Promise<AgentServiceRegistrationLifecycle>;
-export {};
 //# sourceMappingURL=registration.d.ts.map

package/esm/src/agent/service/registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/service/registration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kCAAkC;;;;EAI7C,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;iBAS/C,CAAC;AAEH,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;iBActD,CAAC;AAEH,QAAA,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBrC,CAAC;AAMH,QAAA,MAAM,4CAA4C;;;;;;;;;;;;;;iBAWhD,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAC9F,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAClG,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CACzD,OAAO,2CAA2C,CACnD,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,4CAA4C,CACpD,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACvE,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,MAAM,EAAE,8BAA8B,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,2BAA2B,CAAC;IACrC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,8CAA8C,GACtD,qCAAqC,GACrC;IACA,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,MAAM,CAAC,EAAE,8BAA8B,CAAC;CACzC,CAAC;AA0DJ,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,2CAA2C,GACnD,OAAO,CAAC,qCAAqC,GAAG,IAAI,CAAC,CA6CvD;AA4DD,wBAAsB,uCAAuC,CAC3D,OAAO,EAAE,8CAA8C,GACtD,OAAO,CAAC,iCAAiC,CAAC,CA0C5C"}
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/service/registration.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/service/registration.js

@@ -1,70 +1,72 @@
 import * as dntShim from "../../../_dnt.shims.js";
-import { z } from "zod";
-export const agentServiceRegistrationModeSchema = z.enum([
-    "auto",
-    "enabled",
-    "disabled",
-]);
-export const agentServiceRegistrationConfigSchema = z.object({
-    VERYFRONT_API_URL: z.string().url(),
-    VERYFRONT_API_TOKEN: z.string().min(1).optional(),
-    VERYFRONT_PROJECT_ID: z.string().min(1).optional(),
-    VERYFRONT_AGENT_SERVICE_URL: z.string().url().optional(),
-    VERYFRONT_AGENT_SERVICE_KEY: z.string().min(1).max(128).optional(),
-    VERYFRONT_AGENT_SERVICE_REGISTRATION: agentServiceRegistrationModeSchema,
-    VERYFRONT_AGENT_SERVICE_HEARTBEAT_INTERVAL_MS: z.number().positive(),
-    VERYFRONT_AGENT_SERVICE_REGION: z.string().min(1).max(128).optional(),
-});
-export const resolvedAgentServiceRegistrationInputSchema = z.object({
-    apiUrl: z.string().url(),
-    authToken: z.string().min(1),
-    serviceName: z.string().min(1).max(128),
-    serviceKey: z.string().min(1).max(128),
-    scopeKind: z.enum(["global", "project"]),
-    projectId: z.string().min(1).optional(),
-    agentId: z.string().min(1).max(128).optional(),
-    baseUrl: z.string().url(),
-    invokeUrl: z.string().url(),
-    version: z.string().min(1).max(128).optional(),
-    runtime: z.string().min(1).max(128).optional(),
-    region: z.string().min(1).max(128).optional(),
-    heartbeatIntervalMs: z.number().positive(),
-});
-const agentPushRuntimeServiceRestSchema = z.object({
-    id: z.string().uuid(),
-    service_name: z.string(),
-    service_key: z.string(),
-    scope_kind: z.enum(["global", "project"]),
-    scope_key: z.string(),
-    project_id: z.string().nullable(),
-    agent_id: z.string().nullable(),
-    base_url: z.string().url(),
-    invoke_url: z.string().url(),
-    status: z.enum(["active", "disabled"]),
-    capabilities: z.unknown().nullable(),
-    metadata: z.unknown().nullable(),
-    version: z.string().nullable(),
-    runtime: z.string().nullable(),
-    region: z.string().nullable(),
-    last_heartbeat_at: z.string().nullable(),
-    created_at: z.string(),
-    updated_at: z.string(),
-});
-const agentPushRuntimeServiceResponseSchema = z.object({
-    service: agentPushRuntimeServiceRestSchema,
-});
-const registerAgentPushRuntimeServiceRequestSchema = z.object({
-    service_name: z.string().min(1).max(128),
-    service_key: z.string().min(1).max(128),
-    scope_kind: z.enum(["global", "project"]),
-    project_id: z.string().optional(),
-    agent_id: z.string().optional(),
-    base_url: z.string().url(),
-    invoke_url: z.string().url(),
-    version: z.string().optional(),
-    runtime: z.string().optional(),
-    region: z.string().optional(),
-});
+import { defineSchema } from "../../schemas/define.js";
+import { lazySchema } from "../../schemas/lazy.js";
+function agentServiceRegistrationMode(v) {
+    return v.enum(["auto", "enabled", "disabled"]);
+}
+export const agentServiceRegistrationModeSchema = lazySchema(defineSchema(agentServiceRegistrationMode));
+export const agentServiceRegistrationConfigSchema = lazySchema(defineSchema((v) => v.object({
+    VERYFRONT_API_URL: v.string().url(),
+    VERYFRONT_API_TOKEN: v.string().min(1).optional(),
+    VERYFRONT_PROJECT_ID: v.string().min(1).optional(),
+    VERYFRONT_AGENT_SERVICE_URL: v.string().url().optional(),
+    VERYFRONT_AGENT_SERVICE_KEY: v.string().min(1).max(128).optional(),
+    VERYFRONT_AGENT_SERVICE_REGISTRATION: agentServiceRegistrationMode(v),
+    VERYFRONT_AGENT_SERVICE_HEARTBEAT_INTERVAL_MS: v.number().positive(),
+    VERYFRONT_AGENT_SERVICE_REGION: v.string().min(1).max(128).optional(),
+})));
+export const resolvedAgentServiceRegistrationInputSchema = lazySchema(defineSchema((v) => v.object({
+    apiUrl: v.string().url(),
+    authToken: v.string().min(1),
+    serviceName: v.string().min(1).max(128),
+    serviceKey: v.string().min(1).max(128),
+    scopeKind: v.enum(["global", "project"]),
+    projectId: v.string().min(1).optional(),
+    agentId: v.string().min(1).max(128).optional(),
+    baseUrl: v.string().url(),
+    invokeUrl: v.string().url(),
+    version: v.string().min(1).max(128).optional(),
+    runtime: v.string().min(1).max(128).optional(),
+    region: v.string().min(1).max(128).optional(),
+    heartbeatIntervalMs: v.number().positive(),
+})));
+function agentPushRuntimeServiceRest(v) {
+    return v.object({
+        id: v.string().uuid(),
+        service_name: v.string(),
+        service_key: v.string(),
+        scope_kind: v.enum(["global", "project"]),
+        scope_key: v.string(),
+        project_id: v.string().nullable(),
+        agent_id: v.string().nullable(),
+        base_url: v.string().url(),
+        invoke_url: v.string().url(),
+        status: v.enum(["active", "disabled"]),
+        capabilities: v.unknown().nullable(),
+        metadata: v.unknown().nullable(),
+        version: v.string().nullable(),
+        runtime: v.string().nullable(),
+        region: v.string().nullable(),
+        last_heartbeat_at: v.string().nullable(),
+        created_at: v.string(),
+        updated_at: v.string(),
+    });
+}
+const agentPushRuntimeServiceResponseSchema = lazySchema(defineSchema((v) => v.object({
+    service: agentPushRuntimeServiceRest(v),
+})));
+const registerAgentPushRuntimeServiceRequestSchema = lazySchema(defineSchema((v) => v.object({
+    service_name: v.string().min(1).max(128),
+    service_key: v.string().min(1).max(128),
+    scope_kind: v.enum(["global", "project"]),
+    project_id: v.string().optional(),
+    agent_id: v.string().optional(),
+    base_url: v.string().url(),
+    invoke_url: v.string().url(),
+    version: v.string().optional(),
+    runtime: v.string().optional(),
+    region: v.string().optional(),
+})));
 function normalizeBaseUrl(value) {
     const url = new URL(value);
     url.pathname = url.pathname.replace(/\/+$/, "");

package/esm/src/agent/testing/agent-tester.d.ts

@@ -0,0 +1,45 @@
+import type { Agent, AgentResponse, Message } from "../types.js";
+export interface TestCase {
+    /** Test name */
+    name: string;
+    /** Input to agent */
+    input: string | Message[];
+    /** Expected output pattern (regex or string) */
+    expected?: RegExp | string;
+    /** Expected tool calls */
+    expectToolCalls?: string[];
+    /** Maximum execution time (ms) */
+    timeout?: number;
+    /** Custom validator */
+    validate?: (response: AgentResponse) => boolean | Promise<boolean>;
+}
+export interface TestResult {
+    /** Test case name */
+    name: string;
+    /** Pass/fail */
+    passed: boolean;
+    /** Response from agent */
+    response?: AgentResponse;
+    /** Error if test failed */
+    error?: string;
+    /** Execution time */
+    executionTime: number;
+    /** Tool calls made */
+    toolCalls: string[];
+}
+export interface TestSuite {
+    /** Suite name */
+    name: string;
+    /** Test results */
+    results: TestResult[];
+    /** Overall pass/fail */
+    passed: boolean;
+    /** Total execution time */
+    totalTime: number;
+}
+export declare function testAgent(agent: Agent, testCases: TestCase[]): Promise<TestSuite>;
+export declare function printTestResults(suite: TestSuite): void;
+export declare function assertContains(response: AgentResponse, text: string): boolean;
+export declare function assertToolCalled(response: AgentResponse, toolName: string): boolean;
+export declare function assertCompleted(response: AgentResponse): boolean;
+//# sourceMappingURL=agent-tester.d.ts.map

package/esm/src/agent/testing/agent-tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tester.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/testing/agent-tester.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACvB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAE1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE3B,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAEhB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,sBAAsB;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb,mBAAmB;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB,wBAAwB;IACxB,MAAM,EAAE,OAAO,CAAC;IAEhB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAWvF;AA6FD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAmBvD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEhE"}

package/esm/src/agent/testing/agent-tester.js

@@ -0,0 +1,127 @@
+/**************************
+ * Agent Testing Utilities
+ *
+ * Utilities for testing agents in development and CI/CD.
+ *
+ * @module veryfront/agent/testing
+ **************************/
+import * as dntShim from "../../../_dnt.shims.js";
+export async function testAgent(agent, testCases) {
+    const suiteStartTime = Date.now();
+    const results = await Promise.all(testCases.map((testCase) => runTestCase(agent, testCase)));
+    const passed = results.every((r) => r.passed);
+    return {
+        name: agent.id,
+        results,
+        passed,
+        totalTime: Date.now() - suiteStartTime,
+    };
+}
+async function runTestCase(agent, testCase) {
+    const startTime = Date.now();
+    try {
+        const timeoutMs = testCase.timeout ?? 30000;
+        let timeoutId;
+        let response;
+        try {
+            response = await Promise.race([
+                agent.generate({ input: testCase.input }),
+                new Promise((_, reject) => {
+                    timeoutId = dntShim.setTimeout(() => reject(new Error("Test timeout")), timeoutMs);
+                }),
+            ]);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        const executionTime = Date.now() - startTime;
+        const toolCalls = response.toolCalls.map((tc) => tc.name);
+        const { passed, error } = await validateTestCase(testCase, response, toolCalls);
+        return {
+            name: testCase.name,
+            passed,
+            response,
+            error,
+            executionTime,
+            toolCalls,
+        };
+    }
+    catch (error) {
+        return {
+            name: testCase.name,
+            passed: false,
+            error: error instanceof Error ? error.message : String(error),
+            executionTime: Date.now() - startTime,
+            toolCalls: [],
+        };
+    }
+}
+async function validateTestCase(testCase, response, toolCalls) {
+    const expected = testCase.expected;
+    if (expected instanceof RegExp) {
+        if (!expected.test(response.text)) {
+            return {
+                passed: false,
+                error: `Output "${response.text}" does not match pattern ${expected}`,
+            };
+        }
+    }
+    else if (typeof expected === "string") {
+        if (!response.text.includes(expected)) {
+            return {
+                passed: false,
+                error: `Output does not contain expected text: "${expected}"`,
+            };
+        }
+    }
+    const expectedTools = testCase.expectToolCalls;
+    if (expectedTools?.length) {
+        const missingTools = expectedTools.filter((t) => !toolCalls.includes(t));
+        if (missingTools.length) {
+            return {
+                passed: false,
+                error: `Expected tool calls not found: ${missingTools.join(", ")}`,
+            };
+        }
+    }
+    if (testCase.validate) {
+        try {
+            const passed = await testCase.validate(response);
+            if (!passed)
+                return { passed: false, error: "Custom validation failed" };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                error: `Custom validation error: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    return { passed: true };
+}
+export function printTestResults(suite) {
+    console.log(`\n=== Test Suite: ${suite.name} ===\n`);
+    const passed = suite.results.filter((r) => r.passed).length;
+    const total = suite.results.length;
+    for (const [index, result] of suite.results.entries()) {
+        const icon = result.passed ? "✅" : "❌";
+        console.log(`${icon} ${index + 1}. ${result.name}`);
+        if (!result.passed && result.error)
+            console.log(`   Error: ${result.error}`);
+        if (result.toolCalls.length)
+            console.log(`   Tools used: ${result.toolCalls.join(", ")}`);
+        console.log(`   Time: ${result.executionTime}ms\n`);
+    }
+    console.log(`Results: ${passed}/${total} passed`);
+    console.log(`Total time: ${suite.totalTime}ms`);
+    console.log(`Status: ${suite.passed ? "✅ PASSED" : "❌ FAILED"}\n`);
+}
+export function assertContains(response, text) {
+    return response.text.toLowerCase().includes(text.toLowerCase());
+}
+export function assertToolCalled(response, toolName) {
+    return response.toolCalls.some((tc) => tc.name === toolName);
+}
+export function assertCompleted(response) {
+    return response.status === "completed";
+}

package/esm/src/agent/testing/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent Testing Utilities
+ *
+ * @module veryfront/agent/testing
+ */
+import "../../../_dnt.polyfills.js";
+export { assertCompleted, assertContains, assertToolCalled, printTestResults, testAgent, type TestCase, type TestResult, type TestSuite, } from "./agent-tester.js";
+export { buildFailureSuffix, buildLiveEvalCaseTagSummary, buildLiveEvalRequestBody, type BuildLiveEvalRequestBodyInput, buildLiveEvalRuntimeSummary, buildLiveEvalStatusSummary, buildProgressLine, buildRuntimePerformanceSummary, containsOrderedSubsequence, createFailedEvalResult, createPassedEvalResult, createPlainTextPdf, createSkippedEvalResult, hasEveryLiveEvalTag, type LiveEvalCaseMetadata, type LiveEvalCaseSelectionInput, type LiveEvalResultForPerformance, type LiveEvalResultForReport, type LiveEvalResultRecord, type LiveEvalRuntime, resolveLiveEvalRequestedCaseIds, type RuntimePerformanceSummary, selectLiveEvalCases, } from "./live-evals/index.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/agent/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/testing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,4BAA4B,CAAC;AAGpC,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,6BAA6B,EAClC,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,8BAA8B,EAC9B,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,+BAA+B,EAC/B,KAAK,yBAAyB,EAC9B,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/esm/src/agent/testing/index.js

@@ -0,0 +1,8 @@
+/**
+ * Agent Testing Utilities
+ *
+ * @module veryfront/agent/testing
+ */
+import "../../../_dnt.polyfills.js";
+export { assertCompleted, assertContains, assertToolCalled, printTestResults, testAgent, } from "./agent-tester.js";
+export { buildFailureSuffix, buildLiveEvalCaseTagSummary, buildLiveEvalRequestBody, buildLiveEvalRuntimeSummary, buildLiveEvalStatusSummary, buildProgressLine, buildRuntimePerformanceSummary, containsOrderedSubsequence, createFailedEvalResult, createPassedEvalResult, createPlainTextPdf, createSkippedEvalResult, hasEveryLiveEvalTag, resolveLiveEvalRequestedCaseIds, selectLiveEvalCases, } from "./live-evals/index.js";

package/esm/src/agent/testing/live-evals/formatting.d.ts

@@ -0,0 +1,11 @@
+import { Buffer } from "node:buffer";
+import type { AgUiSseProgressSnapshot as EvalProgressSnapshot } from "../../index.js";
+export declare function createPlainTextPdf(lines: string[]): Buffer;
+export declare function buildProgressLine(input: {
+    caseId: string;
+    startedAt: number;
+    progress: EvalProgressSnapshot;
+}): string;
+export declare function buildFailureSuffix(progress: EvalProgressSnapshot): string;
+export declare function containsOrderedSubsequence(haystack: string[], needle: string[]): boolean;
+//# sourceMappingURL=formatting.d.ts.map

package/esm/src/agent/testing/live-evals/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/testing/live-evals/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,uBAAuB,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAStF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CA4C1D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,oBAAoB,CAAC;CAChC,GAAG,MAAM,CAcT;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAUzE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAcT"}