@sprinterai/runtime 0.7.1 → 0.9.0

package/dist/adapters/mcp-adapter.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 /**
  * Discover and convert MCP server tools into platform ToolDefinitions.
  *
@@ -40,7 +40,7 @@ export async function discoverMCPTools(config) {
  */
 function jsonSchemaToPassthroughZod(schema) {
     if (!schema || schema.type !== 'object') {
-        return z.record(z.unknown());
+        return z.record(z.string(), z.unknown());
     }
     // Use z.object({}).passthrough() for object schemas -- accepts any keys
     return z.object({}).passthrough();

package/dist/adapters/mcp-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-adapter.js","sourceRoot":"","sources":["../../src/adapters/mcp-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+BxB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwB;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IAE1C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,aAAa,IAAI,CAAC,IAAI,EAAE;QACzD,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,0BAA0B,CAAC,IAAI,CAAC,WAAW,CAAC;QACzD,KAAK,CAAC,OAAO,CAAC,KAAc;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC,CAAC;YAC1F,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO;qBAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;qBACxB,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,aAAa,IAAI,CAAC,IAAI,UAAU,CAAC,CAAC;YACjE,CAAC;YACD,0EAA0E;YAC1E,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACrE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,0BAA0B,CAAC,MAAgC;IAClE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,wEAAwE;IACxE,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"mcp-adapter.js","sourceRoot":"","sources":["../../src/adapters/mcp-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AA+B3B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwB;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IAE1C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,aAAa,IAAI,CAAC,IAAI,EAAE;QACzD,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,0BAA0B,CAAC,IAAI,CAAC,WAAW,CAAC;QACzD,KAAK,CAAC,OAAO,CAAC,KAAc;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC,CAAC;YAC1F,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO;qBAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;qBACxB,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,aAAa,IAAI,CAAC,IAAI,UAAU,CAAC,CAAC;YACjE,CAAC;YACD,0EAA0E;YAC1E,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACrE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,0BAA0B,CAAC,MAAgC;IAClE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,wEAAwE;IACxE,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC"}

package/dist/agent/delegate.js

@@ -1,5 +1,5 @@
 import { defineTool } from '@sprinterai/core';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 /**
  * Create a tool that allows an agent to delegate tasks to other agents.
  * The tool presents available agents and routes the task.

package/dist/agent/delegate.js.map

@@ -1 +1 @@
-{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/agent/delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAkC;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5D,MAAM,iBAAiB,GAAG,OAAO,CAAC,eAAe;SAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;SACzC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,wDAAwD,iBAAiB,EAAE;QACxF,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SAC5E,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,KAIb,CAAC;YAEF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1C,OAAO;oBACL,KAAK,EAAE,kBAAkB,KAAK,CAAC,SAAS,gBAAgB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAChF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACzF,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/agent/delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAU3B;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAkC;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5D,MAAM,iBAAiB,GAAG,OAAO,CAAC,eAAe;SAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;SACzC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,wDAAwD,iBAAiB,EAAE;QACxF,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SAC5E,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,KAIb,CAAC;YAEF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1C,OAAO;oBACL,KAAK,EAAE,kBAAkB,KAAK,CAAC,SAAS,gBAAgB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAChF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACzF,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/agent/heartbeat-scheduler.d.ts

@@ -0,0 +1,36 @@
+import type { HeartbeatRunStore, HeartbeatRunRecord, CompleteHeartbeatRunMetrics } from '@sprinterai/core';
+export interface CreateHeartbeatRunOptions {
+    tenantId: string;
+    triggerType?: string;
+    prompt?: string;
+    /** Optional idempotency key (e.g. Inngest run ID) for deduplication. */
+    idempotencyKey?: string;
+}
+/**
+ * Create a new heartbeat run for an agent.
+ * If an idempotency key is provided and a run with that key already exists,
+ * the existing run is returned (safe for retry scenarios).
+ */
+export declare function createHeartbeatRun(store: HeartbeatRunStore, agentId: string, options: CreateHeartbeatRunOptions): Promise<HeartbeatRunRecord>;
+/**
+ * Mark a heartbeat run as completed with optional metrics.
+ */
+export declare function completeHeartbeatRun(store: HeartbeatRunStore, runId: string, metrics?: CompleteHeartbeatRunMetrics): Promise<void>;
+/**
+ * Mark a heartbeat run as failed with an error message.
+ */
+export declare function failHeartbeatRun(store: HeartbeatRunStore, runId: string, error: string | Error): Promise<void>;
+/**
+ * Get recent heartbeat run history for a specific agent.
+ */
+export declare function getHeartbeatRunHistory(store: HeartbeatRunStore, agentId: string, limit?: number): Promise<HeartbeatRunRecord[]>;
+/**
+ * Get all recent heartbeat runs across all agents for a tenant.
+ */
+export declare function getAllRecentHeartbeatRuns(store: HeartbeatRunStore, tenantId: string, limit?: number): Promise<HeartbeatRunRecord[]>;
+/**
+ * Mark all still-running heartbeat runs that have exceeded `maxDurationMs`
+ * as stale. Returns the number of runs cleaned up.
+ */
+export declare function cleanupStaleHeartbeatRuns(store: HeartbeatRunStore, maxDurationMs: number): Promise<number>;
+//# sourceMappingURL=heartbeat-scheduler.d.ts.map

package/dist/agent/heartbeat-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-scheduler.d.ts","sourceRoot":"","sources":["../../src/agent/heartbeat-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC5B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAiB7B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,KAAK,GACpB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,SAAK,GACT,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAK,GACT,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,iBAAiB,EACxB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/agent/heartbeat-scheduler.js

@@ -0,0 +1,57 @@
+/**
+ * Create a new heartbeat run for an agent.
+ * If an idempotency key is provided and a run with that key already exists,
+ * the existing run is returned (safe for retry scenarios).
+ */
+export async function createHeartbeatRun(store, agentId, options) {
+    if (options.idempotencyKey) {
+        const existing = await store.findByIdempotencyKey(agentId, options.tenantId, options.idempotencyKey);
+        if (existing)
+            return existing;
+    }
+    return store.createRun({
+        agentId,
+        tenantId: options.tenantId,
+        triggerType: options.triggerType,
+        prompt: options.prompt,
+        idempotencyKey: options.idempotencyKey,
+    });
+}
+/**
+ * Mark a heartbeat run as completed with optional metrics.
+ */
+export async function completeHeartbeatRun(store, runId, metrics) {
+    return store.completeRun(runId, metrics);
+}
+/**
+ * Mark a heartbeat run as failed with an error message.
+ */
+export async function failHeartbeatRun(store, runId, error) {
+    const message = error instanceof Error ? error.message : error;
+    return store.failRun(runId, message);
+}
+/**
+ * Get recent heartbeat run history for a specific agent.
+ */
+export async function getHeartbeatRunHistory(store, agentId, limit = 20) {
+    return store.getRunHistory(agentId, limit);
+}
+/**
+ * Get all recent heartbeat runs across all agents for a tenant.
+ */
+export async function getAllRecentHeartbeatRuns(store, tenantId, limit = 50) {
+    return store.getAllRecentRuns(tenantId, limit);
+}
+/**
+ * Mark all still-running heartbeat runs that have exceeded `maxDurationMs`
+ * as stale. Returns the number of runs cleaned up.
+ */
+export async function cleanupStaleHeartbeatRuns(store, maxDurationMs) {
+    const cutoff = new Date(Date.now() - maxDurationMs).toISOString();
+    const staleRuns = await store.getStaleRuns(cutoff);
+    if (staleRuns.length === 0)
+        return 0;
+    await store.markStale(staleRuns.map((r) => r.id));
+    return staleRuns.length;
+}
+//# sourceMappingURL=heartbeat-scheduler.js.map

package/dist/agent/heartbeat-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-scheduler.js","sourceRoot":"","sources":["../../src/agent/heartbeat-scheduler.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAwB,EACxB,OAAe,EACf,OAAkC;IAElC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAC/C,OAAO,EACP,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,cAAc,CACvB,CAAC;QACF,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IAED,OAAO,KAAK,CAAC,SAAS,CAAC;QACrB,OAAO;QACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAwB,EACxB,KAAa,EACb,OAAqC;IAErC,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAwB,EACxB,KAAa,EACb,KAAqB;IAErB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/D,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAwB,EACxB,OAAe,EACf,KAAK,GAAG,EAAE;IAEV,OAAO,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAwB,EACxB,QAAgB,EAChB,KAAK,GAAG,EAAE;IAEV,OAAO,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAwB,EACxB,aAAqB;IAErB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACrC,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC,MAAM,CAAC;AAC1B,CAAC"}

package/dist/agent/heartbeat-scheduler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=heartbeat-scheduler.test.d.ts.map

package/dist/agent/heartbeat-scheduler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-scheduler.test.d.ts","sourceRoot":"","sources":["../../src/agent/heartbeat-scheduler.test.ts"],"names":[],"mappings":""}

package/dist/agent/heartbeat-scheduler.test.js

@@ -0,0 +1,216 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { InMemoryHeartbeatRunStore } from '../testing/in-memory-heartbeat-run-store.js';
+import { createHeartbeatRun, completeHeartbeatRun, failHeartbeatRun, getHeartbeatRunHistory, getAllRecentHeartbeatRuns, cleanupStaleHeartbeatRuns, } from './heartbeat-scheduler.js';
+const AGENT_ID = 'agent-1';
+const TENANT_ID = 'tenant-1';
+describe('createHeartbeatRun', () => {
+    let store;
+    beforeEach(() => {
+        store = new InMemoryHeartbeatRunStore();
+    });
+    it('creates a new run with status running', async () => {
+        const run = await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+        expect(run.status).toBe('running');
+        expect(run.agent_id).toBe(AGENT_ID);
+        expect(run.tenant_id).toBe(TENANT_ID);
+        expect(run.id).toBeDefined();
+        expect(run.started_at).toBeDefined();
+        expect(run.completed_at).toBeNull();
+    });
+    it('sets trigger type and prompt', async () => {
+        const run = await createHeartbeatRun(store, AGENT_ID, {
+            tenantId: TENANT_ID,
+            triggerType: 'manual',
+            prompt: 'Check open tasks',
+        });
+        expect(run.trigger_type).toBe('manual');
+        expect(run.prompt).toBe('Check open tasks');
+    });
+    describe('idempotency', () => {
+        it('returns existing run when idempotency key matches', async () => {
+            const first = await createHeartbeatRun(store, AGENT_ID, {
+                tenantId: TENANT_ID,
+                idempotencyKey: 'run-abc-123',
+            });
+            const second = await createHeartbeatRun(store, AGENT_ID, {
+                tenantId: TENANT_ID,
+                idempotencyKey: 'run-abc-123',
+            });
+            expect(second.id).toBe(first.id);
+            expect(store.all()).toHaveLength(1);
+        });
+        it('creates a separate run for a different idempotency key', async () => {
+            await createHeartbeatRun(store, AGENT_ID, {
+                tenantId: TENANT_ID,
+                idempotencyKey: 'key-1',
+            });
+            await createHeartbeatRun(store, AGENT_ID, {
+                tenantId: TENANT_ID,
+                idempotencyKey: 'key-2',
+            });
+            expect(store.all()).toHaveLength(2);
+        });
+        it('creates a new run when no idempotency key is given', async () => {
+            await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+            await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+            expect(store.all()).toHaveLength(2);
+        });
+    });
+});
+describe('completeHeartbeatRun', () => {
+    let store;
+    beforeEach(() => {
+        store = new InMemoryHeartbeatRunStore();
+    });
+    it('marks a run as completed', async () => {
+        const run = await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+        await completeHeartbeatRun(store, run.id);
+        const updated = store.all().find((r) => r.id === run.id);
+        expect(updated?.status).toBe('completed');
+        expect(updated?.completed_at).not.toBeNull();
+    });
+    it('records token count and result metrics', async () => {
+        const run = await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+        await completeHeartbeatRun(store, run.id, {
+            tokenCount: 512,
+            result: { summary: 'done' },
+        });
+        const updated = store.all().find((r) => r.id === run.id);
+        expect(updated?.token_count).toBe(512);
+        expect(updated?.result).toEqual({ summary: 'done' });
+    });
+    it('records duration_ms', async () => {
+        const run = await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+        await completeHeartbeatRun(store, run.id, { durationMs: 3000 });
+        const updated = store.all().find((r) => r.id === run.id);
+        expect(updated?.duration_ms).toBe(3000);
+    });
+});
+describe('failHeartbeatRun', () => {
+    let store;
+    beforeEach(() => {
+        store = new InMemoryHeartbeatRunStore();
+    });
+    it('marks a run as failed with error string', async () => {
+        const run = await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+        await failHeartbeatRun(store, run.id, 'Timeout exceeded');
+        const updated = store.all().find((r) => r.id === run.id);
+        expect(updated?.status).toBe('failed');
+        expect(updated?.error_message).toBe('Timeout exceeded');
+        expect(updated?.completed_at).not.toBeNull();
+    });
+    it('accepts an Error object and extracts the message', async () => {
+        const run = await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+        await failHeartbeatRun(store, run.id, new Error('Model error'));
+        const updated = store.all().find((r) => r.id === run.id);
+        expect(updated?.error_message).toBe('Model error');
+    });
+});
+describe('getHeartbeatRunHistory', () => {
+    let store;
+    beforeEach(() => {
+        store = new InMemoryHeartbeatRunStore();
+    });
+    it('returns runs for the specified agent only', async () => {
+        await createHeartbeatRun(store, 'agent-1', { tenantId: TENANT_ID });
+        await createHeartbeatRun(store, 'agent-2', { tenantId: TENANT_ID });
+        const history = await getHeartbeatRunHistory(store, 'agent-1');
+        expect(history).toHaveLength(1);
+        expect(history[0]?.agent_id).toBe('agent-1');
+    });
+    it('returns empty array when no runs for agent', async () => {
+        const history = await getHeartbeatRunHistory(store, 'unknown-agent');
+        expect(history).toEqual([]);
+    });
+    it('respects the limit parameter', async () => {
+        for (let i = 0; i < 5; i++) {
+            await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+        }
+        const history = await getHeartbeatRunHistory(store, AGENT_ID, 3);
+        expect(history).toHaveLength(3);
+    });
+});
+describe('getAllRecentHeartbeatRuns', () => {
+    let store;
+    beforeEach(() => {
+        store = new InMemoryHeartbeatRunStore();
+    });
+    it('returns all runs for the tenant', async () => {
+        await createHeartbeatRun(store, 'agent-1', { tenantId: 'tenant-A' });
+        await createHeartbeatRun(store, 'agent-2', { tenantId: 'tenant-A' });
+        await createHeartbeatRun(store, 'agent-3', { tenantId: 'tenant-B' });
+        const runs = await getAllRecentHeartbeatRuns(store, 'tenant-A');
+        expect(runs).toHaveLength(2);
+        expect(runs.every((r) => r.tenant_id === 'tenant-A')).toBe(true);
+    });
+    it('respects the limit parameter', async () => {
+        for (let i = 0; i < 10; i++) {
+            await createHeartbeatRun(store, `agent-${i}`, { tenantId: TENANT_ID });
+        }
+        const runs = await getAllRecentHeartbeatRuns(store, TENANT_ID, 4);
+        expect(runs).toHaveLength(4);
+    });
+});
+describe('cleanupStaleHeartbeatRuns', () => {
+    let store;
+    beforeEach(() => {
+        store = new InMemoryHeartbeatRunStore();
+    });
+    it('marks runs exceeding maxDurationMs as stale', async () => {
+        const oldDate = new Date(Date.now() - 10 * 60 * 1000).toISOString(); // 10 min ago
+        const staleRun = {
+            id: 'old-run',
+            tenant_id: TENANT_ID,
+            agent_id: AGENT_ID,
+            status: 'running',
+            trigger_type: 'scheduled',
+            prompt: null,
+            result: null,
+            token_count: null,
+            duration_ms: null,
+            error_message: null,
+            started_at: oldDate,
+            completed_at: null,
+            created_at: oldDate,
+        };
+        store.seedRun(staleRun);
+        const count = await cleanupStaleHeartbeatRuns(store, 5 * 60 * 1000); // 5 min max
+        expect(count).toBe(1);
+        const updated = store.all().find((r) => r.id === 'old-run');
+        expect(updated?.status).toBe('stale');
+        expect(updated?.error_message).toBe('Run exceeded max duration');
+    });
+    it('does not mark recent runs as stale', async () => {
+        const run = await createHeartbeatRun(store, AGENT_ID, { tenantId: TENANT_ID });
+        const count = await cleanupStaleHeartbeatRuns(store, 5 * 60 * 1000);
+        expect(count).toBe(0);
+        const unchanged = store.all().find((r) => r.id === run.id);
+        expect(unchanged?.status).toBe('running');
+    });
+    it('returns 0 when there are no stale runs', async () => {
+        const count = await cleanupStaleHeartbeatRuns(store, 1000);
+        expect(count).toBe(0);
+    });
+    it('does not mark already-completed runs as stale', async () => {
+        const oldDate = new Date(Date.now() - 10 * 60 * 1000).toISOString();
+        const completedRun = {
+            id: 'completed-run',
+            tenant_id: TENANT_ID,
+            agent_id: AGENT_ID,
+            status: 'completed',
+            trigger_type: 'scheduled',
+            prompt: null,
+            result: null,
+            token_count: null,
+            duration_ms: null,
+            error_message: null,
+            started_at: oldDate,
+            completed_at: new Date().toISOString(),
+            created_at: oldDate,
+        };
+        store.seedRun(completedRun);
+        const count = await cleanupStaleHeartbeatRuns(store, 1000);
+        expect(count).toBe(0);
+    });
+});
+//# sourceMappingURL=heartbeat-scheduler.test.js.map

package/dist/agent/heartbeat-scheduler.test.js.map

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

package/dist/agent/index.d.ts

@@ -7,4 +7,7 @@ export { executeAgentStream, executeAgentGenerate } from './execute-agent.js';
 export type { ExecuteAgentConfig, ExecuteAgentResult, AgentStreamResult, AgentFinishEvent, } from './execute-agent.js';
 export { createDelegateToAgentTool } from './delegate.js';
 export type { CreateDelegateToolOptions } from './delegate.js';
+export { createHeartbeatRun, completeHeartbeatRun, failHeartbeatRun, getHeartbeatRunHistory, getAllRecentHeartbeatRuns, cleanupStaleHeartbeatRuns, } from './heartbeat-scheduler.js';
+export type { CreateHeartbeatRunOptions } from './heartbeat-scheduler.js';
+export { createAgentVersion, getVersionHistory, rollbackToVersion } from './versioning.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/agent/index.js

@@ -3,4 +3,6 @@ export { AgentRegistry } from './agent-registry.js';
 export { resolveAgent } from './agent-resolver.js';
 export { executeAgentStream, executeAgentGenerate } from './execute-agent.js';
 export { createDelegateToAgentTool } from './delegate.js';
+export { createHeartbeatRun, completeHeartbeatRun, failHeartbeatRun, getHeartbeatRunHistory, getAllRecentHeartbeatRuns, cleanupStaleHeartbeatRuns, } from './heartbeat-scheduler.js';
+export { createAgentVersion, getVersionHistory, rollbackToVersion } from './versioning.js';
 //# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAO3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAO3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/agent/versioning.d.ts

@@ -0,0 +1,22 @@
+import type { AgentVersionStore, AgentVersionRecord, AgentStore, AgentConfig } from '@sprinterai/core';
+/**
+ * Snapshot the current agent configuration as a new version.
+ * The version number is auto-incremented relative to the latest existing version.
+ */
+export declare function createAgentVersion(store: AgentVersionStore, agentId: string, config: {
+    agentConfig: AgentConfig | null;
+    systemPrompt: string;
+    model: string | null;
+    changeSummary?: string;
+}): Promise<AgentVersionRecord>;
+/**
+ * Return the version history for an agent, ordered newest first.
+ */
+export declare function getVersionHistory(store: AgentVersionStore, agentId: string, limit?: number): Promise<AgentVersionRecord[]>;
+/**
+ * Restore an agent to a previous configuration snapshot.
+ * Before applying the rollback, the current state is saved as a new version
+ * so the rollback itself is reversible.
+ */
+export declare function rollbackToVersion(versionStore: AgentVersionStore, agentStore: AgentStore, agentId: string, versionId: string): Promise<void>;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/agent/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/agent/versioning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;IACN,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAU7B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,SAAK,GACT,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,iBAAiB,EAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/agent/versioning.js

@@ -0,0 +1,47 @@
+/**
+ * Snapshot the current agent configuration as a new version.
+ * The version number is auto-incremented relative to the latest existing version.
+ */
+export async function createAgentVersion(store, agentId, config) {
+    const latestNumber = await store.getLatestVersionNumber(agentId);
+    return store.createVersion({
+        agent_id: agentId,
+        version_number: latestNumber + 1,
+        config: config.agentConfig,
+        system_prompt: config.systemPrompt,
+        model: config.model,
+        change_summary: config.changeSummary ?? null,
+    });
+}
+/**
+ * Return the version history for an agent, ordered newest first.
+ */
+export async function getVersionHistory(store, agentId, limit = 20) {
+    return store.getVersionHistory(agentId, limit);
+}
+/**
+ * Restore an agent to a previous configuration snapshot.
+ * Before applying the rollback, the current state is saved as a new version
+ * so the rollback itself is reversible.
+ */
+export async function rollbackToVersion(versionStore, agentStore, agentId, versionId) {
+    const target = await versionStore.getVersionById(versionId);
+    if (!target)
+        throw new Error(`Version not found: ${versionId}`);
+    // Snapshot current state before rolling back so it can be undone
+    const current = await agentStore.getAgentById(agentId);
+    if (current) {
+        await createAgentVersion(versionStore, agentId, {
+            agentConfig: current.config,
+            systemPrompt: current.system_prompt,
+            model: current.model,
+            changeSummary: `Pre-rollback snapshot (rolling back to v${String(target.version_number)})`,
+        });
+    }
+    await agentStore.updateAgent(agentId, {
+        config: target.config,
+        system_prompt: target.system_prompt,
+        model: target.model,
+    });
+}
+//# sourceMappingURL=versioning.js.map

package/dist/agent/versioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../../src/agent/versioning.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAwB,EACxB,OAAe,EACf,MAKC;IAED,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,OAAO;QACjB,cAAc,EAAE,YAAY,GAAG,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,aAAa,EAAE,MAAM,CAAC,YAAY;QAClC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,cAAc,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;KAC7C,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAe,EACf,KAAK,GAAG,EAAE;IAEV,OAAO,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAA+B,EAC/B,UAAsB,EACtB,OAAe,EACf,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;IAEhE,iEAAiE;IACjE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,kBAAkB,CAAC,YAAY,EAAE,OAAO,EAAE;YAC9C,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,YAAY,EAAE,OAAO,CAAC,aAAa;YACnC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,aAAa,EAAE,2CAA2C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG;SAC3F,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/agent/versioning.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=versioning.test.d.ts.map

package/dist/agent/versioning.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.test.d.ts","sourceRoot":"","sources":["../../src/agent/versioning.test.ts"],"names":[],"mappings":""}