@sena-ai/hooks 0.0.1

package/dist/__tests__/fileContext.test.d.ts

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

package/dist/__tests__/fileContext.test.d.ts.map

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

package/dist/__tests__/fileContext.test.js

@@ -0,0 +1,60 @@
+import { describe, it, expect } from 'vitest';
+import { fileContext } from '../fileContext.js';
+import { join } from 'node:path';
+const fixturesDir = join(import.meta.dirname, 'fixtures');
+function mockContext(overrides) {
+    return {
+        turnId: 'turn-1',
+        agentName: 'test',
+        trigger: 'programmatic',
+        input: 'hello',
+        sessionId: null,
+        metadata: {},
+        ...overrides,
+    };
+}
+describe('fileContext', () => {
+    it('loads a single file', async () => {
+        const hook = fileContext({
+            path: join(fixturesDir, 'soul.md'),
+            as: 'system',
+        });
+        const fragments = await hook.execute(mockContext());
+        expect(fragments).toHaveLength(1);
+        expect(fragments[0].role).toBe('system');
+        expect(fragments[0].content).toContain('테스트 에이전트');
+        expect(fragments[0].source).toContain('soul.md');
+    });
+    it('loads directory with glob filter', async () => {
+        const hook = fileContext({
+            path: join(fixturesDir, 'memory'),
+            as: 'context',
+            glob: '*.md',
+        });
+        const fragments = await hook.execute(mockContext());
+        expect(fragments).toHaveLength(2);
+        expect(fragments.every(f => f.role === 'context')).toBe(true);
+        expect(fragments.every(f => !f.content.includes('무시'))).toBe(true);
+    });
+    it('respects when condition', async () => {
+        const hook = fileContext({
+            path: join(fixturesDir, 'soul.md'),
+            as: 'system',
+            when: (ctx) => ctx.trigger === 'schedule',
+        });
+        const fragments = await hook.execute(mockContext({ trigger: 'programmatic' }));
+        expect(fragments).toHaveLength(0);
+        const fragments2 = await hook.execute(mockContext({ trigger: 'schedule' }));
+        expect(fragments2).toHaveLength(1);
+    });
+    it('respects maxLength', async () => {
+        const hook = fileContext({
+            path: join(fixturesDir, 'soul.md'),
+            as: 'system',
+            maxLength: 10,
+        });
+        const fragments = await hook.execute(mockContext());
+        expect(fragments[0].content.length).toBeLessThanOrEqual(10);
+    });
+});
+//# sourceMappingURL=fileContext.test.js.map

package/dist/__tests__/fileContext.test.js.map

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

package/dist/__tests__/schedule.test.d.ts

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

package/dist/__tests__/schedule.test.d.ts.map

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

package/dist/__tests__/schedule.test.js

@@ -0,0 +1,34 @@
+import { describe, it, expect } from 'vitest';
+import { cronSchedule } from '../cronSchedule.js';
+import { heartbeat } from '../heartbeat.js';
+describe('cronSchedule', () => {
+    it('creates a cron schedule', () => {
+        const schedule = cronSchedule('0 * * * *', {
+            name: 'hourly-check',
+            prompt: 'Do the hourly check',
+        });
+        expect(schedule.name).toBe('hourly-check');
+        expect(schedule.type).toBe('cron');
+        expect(schedule.expression).toBe('0 * * * *');
+        expect(schedule.prompt).toBe('Do the hourly check');
+    });
+});
+describe('heartbeat', () => {
+    it('creates a heartbeat schedule', () => {
+        const schedule = heartbeat('15m', {
+            prompt: 'Check heartbeat',
+        });
+        expect(schedule.name).toBe('heartbeat:15m');
+        expect(schedule.type).toBe('heartbeat');
+        expect(schedule.expression).toBe('15m');
+        expect(schedule.prompt).toBe('Check heartbeat');
+    });
+    it('allows custom name', () => {
+        const schedule = heartbeat('30s', {
+            name: 'fast-poll',
+            prompt: 'Poll fast',
+        });
+        expect(schedule.name).toBe('fast-poll');
+    });
+});
+//# sourceMappingURL=schedule.test.js.map

package/dist/__tests__/schedule.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.test.js","sourceRoot":"","sources":["../../src/__tests__/schedule.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,EAAE;YACzC,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAA;QAEF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC7C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE;YAChC,MAAM,EAAE,iBAAiB;SAC1B,CAAC,CAAA;QAEF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QAC3C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACvC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE;YAChC,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,WAAW;SACpB,CAAC,CAAA;QAEF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/traceLogger.test.d.ts

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

package/dist/__tests__/traceLogger.test.d.ts.map

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

package/dist/__tests__/traceLogger.test.js

@@ -0,0 +1,41 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { traceLogger } from '../traceLogger.js';
+import { readFile, rm, mkdir, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+const testDir = join(tmpdir(), 'sena-trace-test-' + Date.now());
+function mockContext() {
+    return {
+        turnId: 'turn-123',
+        agentName: 'test',
+        trigger: 'programmatic',
+        input: 'hello',
+        sessionId: null,
+        metadata: {},
+    };
+}
+function mockResult() {
+    return {
+        text: 'response',
+        sessionId: 'sess-1',
+        durationMs: 100,
+        toolCalls: [],
+    };
+}
+describe('traceLogger', () => {
+    afterEach(async () => {
+        await rm(testDir, { recursive: true, force: true });
+    });
+    it('writes trace as JSON file', async () => {
+        await mkdir(testDir, { recursive: true });
+        const hook = traceLogger({ dir: testDir });
+        await hook.execute(mockContext(), mockResult());
+        const entries = await readdir(testDir);
+        expect(entries).toHaveLength(1);
+        expect(entries[0]).toMatch(/turn-123.*\.json$/);
+        const content = JSON.parse(await readFile(join(testDir, entries[0]), 'utf-8'));
+        expect(content.turnId).toBe('turn-123');
+        expect(content.result.text).toBe('response');
+    });
+});
+//# sourceMappingURL=traceLogger.test.js.map

package/dist/__tests__/traceLogger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceLogger.test.js","sourceRoot":"","sources":["../../src/__tests__/traceLogger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAGhC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;AAE/D,SAAS,WAAW;IAClB,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,EAAE;KACb,CAAA;AACH,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,EAAE;KACd,CAAA;AACH,CAAC;AAED,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACzC,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;QAE1C,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;QAE/C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;QAE/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;QAC9E,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACvC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/cronSchedule.d.ts

@@ -0,0 +1,12 @@
+import type { Schedule } from '@sena-ai/core';
+export type CronScheduleOptions = {
+    name: string;
+    prompt: string;
+};
+/**
+ * Creates a cron-based schedule.
+ * Expression uses 5-field cron format (minute hour day month weekday).
+ * Timezone defaults to Asia/Seoul.
+ */
+export declare function cronSchedule(expression: string, options: CronScheduleOptions): Schedule;
+//# sourceMappingURL=cronSchedule.d.ts.map

package/dist/cronSchedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronSchedule.d.ts","sourceRoot":"","sources":["../src/cronSchedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,QAAQ,CAOvF"}

package/dist/cronSchedule.js

@@ -0,0 +1,14 @@
+/**
+ * Creates a cron-based schedule.
+ * Expression uses 5-field cron format (minute hour day month weekday).
+ * Timezone defaults to Asia/Seoul.
+ */
+export function cronSchedule(expression, options) {
+    return {
+        name: options.name,
+        type: 'cron',
+        expression,
+        prompt: options.prompt,
+    };
+}
+//# sourceMappingURL=cronSchedule.js.map

package/dist/cronSchedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronSchedule.js","sourceRoot":"","sources":["../src/cronSchedule.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,OAA4B;IAC3E,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,MAAM;QACZ,UAAU;QACV,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAA;AACH,CAAC"}

package/dist/fileContext.d.ts

@@ -0,0 +1,10 @@
+import type { TurnStartHook, TurnContext } from '@sena-ai/core';
+export type FileContextOptions = {
+    path: string;
+    as: 'system' | 'context';
+    glob?: string;
+    when?: (ctx: TurnContext) => boolean;
+    maxLength?: number;
+};
+export declare function fileContext(options: FileContextOptions): TurnStartHook;
+//# sourceMappingURL=fileContext.d.ts.map

package/dist/fileContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileContext.d.ts","sourceRoot":"","sources":["../src/fileContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAmB,MAAM,eAAe,CAAA;AAIhF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,QAAQ,GAAG,SAAS,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAmCtE"}

package/dist/fileContext.js

@@ -0,0 +1,49 @@
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+export function fileContext(options) {
+    const { path, as: role, glob, when, maxLength } = options;
+    return {
+        name: `fileContext:${path}`,
+        async execute(ctx) {
+            if (when && !when(ctx))
+                return [];
+            const info = await stat(path);
+            if (info.isFile()) {
+                const content = await readFile(path, 'utf-8');
+                return [makeFragment(path, role, content, maxLength)];
+            }
+            if (info.isDirectory()) {
+                const entries = await readdir(path);
+                const filtered = glob
+                    ? entries.filter(e => matchGlob(e, glob))
+                    : entries;
+                const fragments = [];
+                for (const entry of filtered.sort()) {
+                    const filePath = join(path, entry);
+                    const fileStat = await stat(filePath);
+                    if (!fileStat.isFile())
+                        continue;
+                    const content = await readFile(filePath, 'utf-8');
+                    fragments.push(makeFragment(filePath, role, content, maxLength));
+                }
+                return fragments;
+            }
+            return [];
+        },
+    };
+}
+function makeFragment(filePath, role, content, maxLength) {
+    const trimmed = maxLength ? content.slice(0, maxLength) : content;
+    return {
+        source: `file:${basename(filePath)}`,
+        role,
+        content: trimmed,
+    };
+}
+function matchGlob(filename, pattern) {
+    if (pattern.startsWith('*')) {
+        return filename.endsWith(pattern.slice(1));
+    }
+    return filename === pattern;
+}
+//# sourceMappingURL=fileContext.js.map

package/dist/fileContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileContext.js","sourceRoot":"","sources":["../src/fileContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAU1C,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAEzD,OAAO;QACL,IAAI,EAAE,eAAe,IAAI,EAAE;QAC3B,KAAK,CAAC,OAAO,CAAC,GAAgB;YAC5B,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,CAAA;YAEjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;YAE7B,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBAClB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;gBAC7C,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;YACvD,CAAC;YAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;gBACnC,MAAM,QAAQ,GAAG,IAAI;oBACnB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;oBACzC,CAAC,CAAC,OAAO,CAAA;gBAEX,MAAM,SAAS,GAAsB,EAAE,CAAA;gBACvC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;oBACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;oBAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAA;oBACrC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;wBAAE,SAAQ;oBAChC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;oBACjD,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;gBAClE,CAAC;gBACD,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,OAAO,EAAE,CAAA;QACX,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CACnB,QAAgB,EAChB,IAA0B,EAC1B,OAAe,EACf,SAAkB;IAElB,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IACjE,OAAO;QACL,MAAM,EAAE,QAAQ,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACpC,IAAI;QACJ,OAAO,EAAE,OAAO;KACjB,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,OAAe;IAClD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,QAAQ,KAAK,OAAO,CAAA;AAC7B,CAAC"}

package/dist/heartbeat.d.ts

@@ -0,0 +1,11 @@
+import type { Schedule } from '@sena-ai/core';
+export type HeartbeatOptions = {
+    prompt: string;
+    name?: string;
+};
+/**
+ * Creates a fixed-interval heartbeat schedule.
+ * Interval format: '15m', '1h', '30s', etc.
+ */
+export declare function heartbeat(interval: string, options: HeartbeatOptions): Schedule;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAO/E"}

package/dist/heartbeat.js

@@ -0,0 +1,13 @@
+/**
+ * Creates a fixed-interval heartbeat schedule.
+ * Interval format: '15m', '1h', '30s', etc.
+ */
+export function heartbeat(interval, options) {
+    return {
+        name: options.name ?? `heartbeat:${interval}`,
+        type: 'heartbeat',
+        expression: interval,
+        prompt: options.prompt,
+    };
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAyB;IACnE,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,aAAa,QAAQ,EAAE;QAC7C,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export declare const VERSION = "0.0.1";
+export { fileContext } from './fileContext.js';
+export type { FileContextOptions } from './fileContext.js';
+export { traceLogger } from './traceLogger.js';
+export type { TraceLoggerOptions } from './traceLogger.js';
+export { cronSchedule } from './cronSchedule.js';
+export type { CronScheduleOptions } from './cronSchedule.js';
+export { heartbeat } from './heartbeat.js';
+export type { HeartbeatOptions } from './heartbeat.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export const VERSION = '0.0.1';
+export { fileContext } from './fileContext.js';
+export { traceLogger } from './traceLogger.js';
+export { cronSchedule } from './cronSchedule.js';
+export { heartbeat } from './heartbeat.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/traceLogger.d.ts

@@ -0,0 +1,7 @@
+import type { TurnEndHook } from '@sena-ai/core';
+export type TraceLoggerOptions = {
+    dir: string;
+    format?: 'json';
+};
+export declare function traceLogger(options: TraceLoggerOptions): TurnEndHook;
+//# sourceMappingURL=traceLogger.d.ts.map

package/dist/traceLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceLogger.d.ts","sourceRoot":"","sources":["../src/traceLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,eAAe,CAAA;AAIzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAqBpE"}

package/dist/traceLogger.js

@@ -0,0 +1,22 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+export function traceLogger(options) {
+    const { dir } = options;
+    return {
+        name: 'traceLogger',
+        async execute(context, result) {
+            await mkdir(dir, { recursive: true });
+            const filename = `${context.turnId}-${Date.now()}.json`;
+            const trace = {
+                turnId: context.turnId,
+                agentName: context.agentName,
+                trigger: context.trigger,
+                input: context.input,
+                timestamp: new Date().toISOString(),
+                result,
+            };
+            await writeFile(join(dir, filename), JSON.stringify(trace, null, 2), 'utf-8');
+        },
+    };
+}
+//# sourceMappingURL=traceLogger.js.map

package/dist/traceLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceLogger.js","sourceRoot":"","sources":["../src/traceLogger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAOhC,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAA;IAEvB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,CAAC,OAAO,CAAC,OAAoB,EAAE,MAAkB;YACpD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAErC,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,CAAA;YACvD,MAAM,KAAK,GAAG;gBACZ,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,MAAM;aACP,CAAA;YAED,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QAC/E,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@sena-ai/hooks",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch"
+  },
+  "dependencies": {
+    "@sena-ai/core": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  }
+}