@animalabs/agent-framework 0.6.3 → 0.6.4

package/dist/test/agent-cache-ttl.test.js

@@ -15,11 +15,27 @@ describe('Agent cacheTtl forwarding', () => {
         assert.equal(request.promptCaching, true);
         assert.equal(request.cacheTtl, '1h');
     });
-    it('omits cacheTtl entirely when unset, leaving the provider default', async () => {
+    it('defaults cacheTtl to 1h when unset', async () => {
         const agent = createAgent({});
         const request = await agent.buildActivationRequest([]);
         assert.equal(request.promptCaching, true);
-        assert.equal('cacheTtl' in request, false);
+        assert.equal(request.cacheTtl, '1h');
+    });
+    it('preserves an explicit 5m override', async () => {
+        const agent = createAgent({ cacheTtl: '5m' });
+        const request = await agent.buildActivationRequest([]);
+        assert.equal(request.cacheTtl, '5m');
+    });
+});
+describe('Agent provider parameter forwarding', () => {
+    it('forwards stateless Responses reasoning and compaction settings unchanged', async () => {
+        const providerParams = {
+            reasoning: { effort: 'high', context: 'all_turns' },
+            context_management: [{ type: 'compaction', compact_threshold: 850000 }],
+        };
+        const agent = createAgent({ providerParams });
+        const request = await agent.buildActivationRequest([]);
+        assert.deepEqual(request.providerParams, providerParams);
     });
 });
 //# sourceMappingURL=agent-cache-ttl.test.js.map

package/dist/test/agent-cache-ttl.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-cache-ttl.test.js","sourceRoot":"","sources":["../../test/agent-cache-ttl.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAKxC,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG;IACzB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;CACjC,CAAC;AAE/B,SAAS,WAAW,CAAC,MAA4B;IAC/C,OAAO,IAAI,KAAK,CACd,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EACvE,kBAAkB,EAClB,EAAc,CACf,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"agent-cache-ttl.test.js","sourceRoot":"","sources":["../../test/agent-cache-ttl.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAKxC,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG;IACzB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;CACjC,CAAC;AAE/B,SAAS,WAAW,CAAC,MAA4B;IAC/C,OAAO,IAAI,KAAK,CACd,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EACvE,kBAAkB,EAClB,EAAc,CACf,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,cAAc,GAAG;YACrB,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;YACnD,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;SACxE,CAAC;QACF,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/health-snapshot.test.d.ts

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

package/dist/test/health-snapshot.test.d.ts.map

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

package/dist/test/health-snapshot.test.js

@@ -0,0 +1,74 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { HealthModule } from '../src/modules/health/index.js';
+/**
+ * buildSnapshot only needs queryInferenceLogs (store/ctx paths are skipped
+ * when includeSubagents=false and no ctx is bound), so a minimal framework
+ * stub exercises the projectSummary presentation path directly.
+ */
+function frameworkStub(entries) {
+    return {
+        queryInferenceLogs: () => ({ entries, total: entries.length, hasMore: false }),
+    };
+}
+function snapshotCall() {
+    return {
+        id: 'call-1',
+        name: 'snapshot',
+        input: { includeSubagents: false, includeTokens: false },
+    };
+}
+describe('HealthModule snapshot timestamp resilience', () => {
+    it('degrades gracefully when a legacy record lacks a timestamp', async () => {
+        const entries = [
+            {
+                sequence: 0,
+                // Legacy persisted record: no timestamp field at all.
+                entry: { agentName: 'legacy', requestId: 'r0', success: false, error: 'boom', request: {}, durationMs: 1 },
+            },
+            {
+                sequence: 1,
+                entry: { timestamp: 1751900000000, agentName: 'ok', requestId: 'r1', success: true, request: {}, durationMs: 1 },
+            },
+        ];
+        const health = new HealthModule({ timeZone: 'UTC' });
+        health.bind(frameworkStub(entries), {});
+        const result = await health.handleToolCall(snapshotCall());
+        // One bad record must not sink the whole snapshot.
+        assert.equal(result.success, true, `snapshot failed: ${result.error}`);
+        const data = result.data;
+        assert.equal(data.inferences.successCount, 1);
+        assert.equal(data.inferences.errorCount, 1);
+        // The bad record's timestamp degrades to null (undefined ?? null).
+        assert.equal(data.inferences.recentErrors[0].timestamp, null);
+    });
+    it('emits the raw value for a non-numeric timestamp instead of throwing', async () => {
+        const entries = [
+            {
+                sequence: 0,
+                entry: { timestamp: 'not-a-date', agentName: 'weird', requestId: 'r2', success: false, error: 'x', request: {}, durationMs: 1 },
+            },
+        ];
+        const health = new HealthModule({ timeZone: 'UTC' });
+        health.bind(frameworkStub(entries), {});
+        const result = await health.handleToolCall(snapshotCall());
+        assert.equal(result.success, true, `snapshot failed: ${result.error}`);
+        const data = result.data;
+        assert.equal(data.inferences.recentErrors[0].timestamp, 'not-a-date');
+    });
+    it('still formats valid timestamps in the configured zone', async () => {
+        const entries = [
+            {
+                sequence: 0,
+                entry: { timestamp: Date.UTC(2026, 0, 2, 3, 4, 5), agentName: 'ok', requestId: 'r3', success: false, error: 'y', request: {}, durationMs: 1 },
+            },
+        ];
+        const health = new HealthModule({ timeZone: 'UTC' });
+        health.bind(frameworkStub(entries), {});
+        const result = await health.handleToolCall(snapshotCall());
+        assert.equal(result.success, true, `snapshot failed: ${result.error}`);
+        const data = result.data;
+        assert.equal(data.inferences.recentErrors[0].timestamp, '2026-01-02T03:04:05.000+00:00 [UTC]');
+    });
+});
+//# sourceMappingURL=health-snapshot.test.js.map

package/dist/test/health-snapshot.test.js.map

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

package/dist/test/timezone.test.d.ts

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

package/dist/test/timezone.test.d.ts.map

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

package/dist/test/timezone.test.js

@@ -0,0 +1,18 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { formatZonedDateTime, formatZonedTime, isValidTimeZone, resolveTimeZone } from '../src/timezone.js';
+describe('agent-visible timezone formatting', () => {
+    const winter = new Date('2026-01-15T12:34:56.789Z');
+    const summer = new Date('2026-07-15T12:34:56.789Z');
+    it('renders the configured zone with the correct DST offset', () => {
+        assert.equal(formatZonedDateTime(winter, 'America/Los_Angeles'), '2026-01-15T04:34:56.789-08:00 [America/Los_Angeles]');
+        assert.equal(formatZonedDateTime(summer, 'America/Los_Angeles'), '2026-07-15T05:34:56.789-07:00 [America/Los_Angeles]');
+        assert.equal(formatZonedTime(summer, 'America/Los_Angeles'), '05:34');
+    });
+    it('validates IANA zones', () => {
+        assert.equal(isValidTimeZone('Europe/Paris'), true);
+        assert.equal(isValidTimeZone('Definitely/Not_A_Zone'), false);
+        assert.throws(() => resolveTimeZone('Definitely/Not_A_Zone'), /Invalid IANA time zone/);
+    });
+});
+//# sourceMappingURL=timezone.test.js.map

package/dist/test/timezone.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.test.js","sourceRoot":"","sources":["../../test/timezone.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE5G,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAEpD,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,KAAK,CACV,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAClD,qDAAqD,CACtD,CAAC;QACF,MAAM,CAAC,KAAK,CACV,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAClD,qDAAqD,CACtD,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,uBAAuB,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,uBAAuB,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}