@sena-ai/core 0.0.1

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

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

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

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

package/dist/__tests__/agent.test.js

@@ -0,0 +1,25 @@
+import { describe, it, expect } from 'vitest';
+import { createAgent } from '../agent.js';
+import { defineConfig } from '../config.js';
+import { createMockRuntime, createMockHook } from './helpers.js';
+describe('createAgent()', () => {
+    it('creates an agent that can process turns', async () => {
+        const config = defineConfig({
+            name: 'test-bot',
+            runtime: createMockRuntime('I am test-bot'),
+            hooks: {
+                onTurnStart: [
+                    createMockHook('greeting', [
+                        { source: 'test:greeting', role: 'system', content: 'You are test-bot' },
+                    ]),
+                ],
+            },
+        });
+        const agent = createAgent(config);
+        const trace = await agent.processTurn({ input: 'hello' });
+        expect(trace.agentName).toBe('test-bot');
+        expect(trace.result?.text).toBe('I am test-bot');
+        expect(trace.assembledContext).toContain('You are test-bot');
+    });
+});
+//# sourceMappingURL=agent.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.test.js","sourceRoot":"","sources":["../../src/__tests__/agent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAEhE,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC;YAC3C,KAAK,EAAE;gBACL,WAAW,EAAE;oBACX,cAAc,CAAC,UAAU,EAAE;wBACzB,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;qBACzE,CAAC;iBACH;aACF;SACF,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QAEzD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACxC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QAChD,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

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

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

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

package/dist/__tests__/config.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest';
+import { defineConfig } from '../config.js';
+const mockRuntime = {
+    name: 'mock',
+    async *createStream() {
+        yield { type: 'result', text: 'hello' };
+    },
+};
+describe('defineConfig()', () => {
+    it('returns config as-is with defaults applied', () => {
+        const config = defineConfig({
+            name: 'test-agent',
+            runtime: mockRuntime,
+        });
+        expect(config.name).toBe('test-agent');
+        expect(config.runtime.name).toBe('mock');
+        expect(config.connectors).toEqual([]);
+        expect(config.tools).toEqual([]);
+        expect(config.hooks).toEqual({});
+        expect(config.schedules).toEqual([]);
+    });
+    it('preserves user-provided values', () => {
+        const config = defineConfig({
+            name: 'agent',
+            runtime: mockRuntime,
+            orchestrator: { port: 4000 },
+        });
+        expect(config.orchestrator?.port).toBe(4000);
+    });
+});
+//# sourceMappingURL=config.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,WAAW,GAAY;IAC3B,IAAI,EAAE,MAAM;IACZ,KAAK,CAAC,CAAC,YAAY;QACjB,MAAM,EAAE,IAAI,EAAE,QAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAClD,CAAC;CACF,CAAA;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,WAAW;SACrB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACxC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACrC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,WAAW;YACpB,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;SAC7B,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

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

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

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

package/dist/__tests__/engine.test.js

@@ -0,0 +1,208 @@
+import { describe, it, expect } from 'vitest';
+import { createTurnEngine } from '../engine.js';
+import { createMockRuntime, createMockHook, createSpyEndHook, createStreamingMockRuntime, createSpyErrorHook } from './helpers.js';
+describe('TurnEngine', () => {
+    it('executes a basic turn and returns a TurnTrace', async () => {
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: createMockRuntime('hello world'),
+            hooks: {},
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'hi' });
+        expect(trace.agentName).toBe('test');
+        expect(trace.trigger).toBe('programmatic');
+        expect(trace.input).toBe('hi');
+        expect(trace.result?.text).toBe('hello world');
+        expect(trace.result?.sessionId).toBe('sess-1');
+        expect(trace.error).toBeNull();
+    });
+    it('runs onTurnStart hooks and collects fragments', async () => {
+        const fragments = [
+            { source: 'test:soul', role: 'system', content: 'You are a test agent' },
+        ];
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: createMockRuntime(),
+            hooks: {
+                onTurnStart: [createMockHook('soul-loader', fragments)],
+            },
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'hello' });
+        expect(trace.hooks).toHaveLength(1);
+        expect(trace.hooks[0].name).toBe('soul-loader');
+        expect(trace.hooks[0].fragments).toEqual(fragments);
+        expect(trace.assembledContext).toContain('You are a test agent');
+    });
+    it('runs multiple onTurnStart hooks in order', async () => {
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: createMockRuntime(),
+            hooks: {
+                onTurnStart: [
+                    createMockHook('hook-a', [{ source: 'a', role: 'system', content: 'AAA' }]),
+                    createMockHook('hook-b', [{ source: 'b', role: 'context', content: 'BBB' }]),
+                ],
+            },
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'test' });
+        expect(trace.hooks).toHaveLength(2);
+        expect(trace.hooks[0].name).toBe('hook-a');
+        expect(trace.hooks[1].name).toBe('hook-b');
+        expect(trace.assembledContext).toMatch(/AAA[\s\S]*BBB/);
+    });
+    it('runs onTurnEnd hooks with result', async () => {
+        const endHook = createSpyEndHook('logger');
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: createMockRuntime('done'),
+            hooks: { onTurnEnd: [endHook] },
+            tools: [],
+        });
+        await engine.processTurn({ input: 'go' });
+        expect(endHook.calls).toHaveLength(1);
+        expect(endHook.calls[0].result.text).toBe('done');
+    });
+    it('records error in trace when runtime fails', async () => {
+        const failRuntime = {
+            name: 'fail',
+            async *createStream() {
+                throw new Error('runtime exploded');
+            },
+        };
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: failRuntime,
+            hooks: {},
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'boom' });
+        expect(trace.error).toBe('runtime exploded');
+        expect(trace.result).toBeNull();
+    });
+    it('tracks tool calls from tool.start/tool.end events', async () => {
+        const events = [
+            { type: 'session.init', sessionId: 'sess-tools' },
+            { type: 'tool.start', toolName: 'shell:ls' },
+            { type: 'tool.end', toolName: 'shell:ls', isError: false },
+            { type: 'result', text: 'done' },
+        ];
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: createStreamingMockRuntime(events),
+            hooks: {},
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'list files' });
+        expect(trace.result).not.toBeNull();
+        expect(trace.result.toolCalls).toHaveLength(1);
+        expect(trace.result.toolCalls[0].toolName).toBe('shell:ls');
+        expect(trace.result.toolCalls[0].isError).toBe(false);
+    });
+    it('accumulates progress.delta as result fallback when result is empty', async () => {
+        const events = [
+            { type: 'session.init', sessionId: 'sess-delta' },
+            { type: 'progress.delta', text: 'hel' },
+            { type: 'progress.delta', text: 'lo' },
+            { type: 'result', text: '' },
+        ];
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: createStreamingMockRuntime(events),
+            hooks: {},
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'stream' });
+        expect(trace.result).not.toBeNull();
+        expect(trace.result.text).toBe('hello');
+    });
+    it('progress event replaces previous progress (not accumulates)', async () => {
+        const events = [
+            { type: 'session.init', sessionId: 'sess-progress' },
+            { type: 'progress', text: 'first' },
+            { type: 'progress', text: 'second' },
+            { type: 'result', text: '' },
+        ];
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: createStreamingMockRuntime(events),
+            hooks: {},
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'progress' });
+        expect(trace.result).not.toBeNull();
+        expect(trace.result.text).toBe('second');
+    });
+    it('onError hooks execute when runtime fails', async () => {
+        const failRuntime = {
+            name: 'fail',
+            async *createStream() {
+                throw new Error('kaboom');
+            },
+        };
+        const errorHook = createSpyErrorHook('error-logger');
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: failRuntime,
+            hooks: { onError: [errorHook] },
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'fail' });
+        expect(trace.error).toBe('kaboom');
+        expect(errorHook.calls).toHaveLength(1);
+        expect(errorHook.calls[0].error.message).toBe('kaboom');
+    });
+    it('onEvent callback receives all events', async () => {
+        const events = [
+            { type: 'session.init', sessionId: 'sess-spy' },
+            { type: 'progress', text: 'working...' },
+            { type: 'tool.start', toolName: 'search' },
+            { type: 'tool.end', toolName: 'search', isError: false },
+            { type: 'result', text: 'found it' },
+        ];
+        const receivedEvents = [];
+        const onEvent = (event) => {
+            receivedEvents.push(event);
+        };
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: createStreamingMockRuntime(events),
+            hooks: {},
+            tools: [],
+        });
+        await engine.processTurn({ input: 'search', onEvent });
+        expect(receivedEvents).toHaveLength(5);
+        const types = receivedEvents.map(e => e.type);
+        expect(types).toEqual(['session.init', 'progress', 'tool.start', 'tool.end', 'result']);
+    });
+    it('abort signal stops turn', async () => {
+        const delayedRuntime = {
+            name: 'delayed',
+            async *createStream(options) {
+                if (options.abortSignal.aborted) {
+                    throw new Error('Aborted');
+                }
+                yield { type: 'session.init', sessionId: 'sess-abort' };
+                // Check abort before yielding result
+                if (options.abortSignal.aborted) {
+                    throw new Error('Aborted');
+                }
+                yield { type: 'result', text: 'should not reach' };
+            },
+        };
+        const controller = new AbortController();
+        controller.abort();
+        const engine = createTurnEngine({
+            name: 'test',
+            runtime: delayedRuntime,
+            hooks: {},
+            tools: [],
+        });
+        const trace = await engine.processTurn({ input: 'stop', abortSignal: controller.signal });
+        expect(trace.error).toBe('Aborted');
+        expect(trace.result).toBeNull();
+    });
+});
+//# sourceMappingURL=engine.test.js.map

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

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

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

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

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

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

package/dist/__tests__/env.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { env, validateEnv, resetEnvCollector } from '../env.js';
+describe('env()', () => {
+    beforeEach(() => {
+        resetEnvCollector();
+    });
+    it('returns env value when set', () => {
+        process.env.TEST_KEY = 'hello';
+        expect(env('TEST_KEY')).toBe('hello');
+        delete process.env.TEST_KEY;
+    });
+    it('returns default value when env is missing', () => {
+        delete process.env.MISSING_KEY;
+        expect(env('MISSING_KEY', 'fallback')).toBe('fallback');
+    });
+    it('collects missing required env vars', () => {
+        delete process.env.REQUIRED_A;
+        delete process.env.REQUIRED_B;
+        env('REQUIRED_A');
+        env('REQUIRED_B');
+        expect(() => validateEnv()).toThrow(/REQUIRED_A.*REQUIRED_B/s);
+    });
+    it('does not throw when all required vars are present', () => {
+        process.env.PRESENT = 'yes';
+        env('PRESENT');
+        expect(() => validateEnv()).not.toThrow();
+        delete process.env.PRESENT;
+    });
+});
+//# sourceMappingURL=env.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.test.js","sourceRoot":"","sources":["../../src/__tests__/env.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAE/D,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,UAAU,CAAC,GAAG,EAAE;QACd,iBAAiB,EAAE,CAAA;IACrB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAA;QAC9B,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;QAC9B,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAA;QAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAA;QAC7B,GAAG,CAAC,YAAY,CAAC,CAAA;QACjB,GAAG,CAAC,YAAY,CAAC,CAAA;QACjB,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,CAAA;QAC3B,GAAG,CAAC,SAAS,CAAC,CAAA;QACd,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QACzC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/full-config.test.d.ts

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

package/dist/__tests__/full-config.test.d.ts.map

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

package/dist/__tests__/full-config.test.js

@@ -0,0 +1,138 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { defineConfig, createAgent, env, createScheduler } from '../index.js';
+import { createMockRuntime, createMockHook, createSpyEndHook } from './helpers.js';
+// Simulate what a real sena.config.ts would look like
+describe('Full sena.config.ts pattern', () => {
+    it('works with the spec example pattern', async () => {
+        // This mirrors the spec Part 2 example, but with mock runtime
+        const config = defineConfig({
+            name: '테스트-에이전트',
+            runtime: createMockRuntime('안녕하세요, 저는 테스트 에이전트입니다.'),
+            connectors: [], // No real connectors in test
+            tools: [], // No real tools in test
+            hooks: {
+                onTurnStart: [
+                    createMockHook('system-prompt', [
+                        { source: 'file:system.md', role: 'system', content: '당신은 유능한 비서입니다.' },
+                    ]),
+                    createMockHook('soul', [
+                        { source: 'file:soul.md', role: 'system', content: '따뜻하고 친절한 성격입니다.' },
+                    ]),
+                    createMockHook('memory', [
+                        { source: 'file:memory/today.md', role: 'context', content: '오늘 할 일: 테스트 작성' },
+                    ]),
+                ],
+                onTurnEnd: [
+                    createSpyEndHook('trace-logger'),
+                ],
+            },
+            schedules: [
+                { name: '정각 알림', type: 'cron', expression: '0 * * * *', prompt: '정각 체크' },
+                { name: 'heartbeat', type: 'heartbeat', expression: '15m', prompt: '하트비트 체크' },
+            ],
+            orchestrator: { port: 3100 },
+        });
+        // Verify config resolution
+        expect(config.name).toBe('테스트-에이전트');
+        expect(config.connectors).toEqual([]);
+        expect(config.tools).toEqual([]);
+        expect(config.hooks.onTurnStart).toHaveLength(3);
+        expect(config.hooks.onTurnEnd).toHaveLength(1);
+        expect(config.schedules).toHaveLength(2);
+        expect(config.orchestrator?.port).toBe(3100);
+        // Create agent and process turn
+        const agent = createAgent(config);
+        const trace = await agent.processTurn({ input: '안녕하세요' });
+        // Verify full pipeline
+        expect(trace.agentName).toBe('테스트-에이전트');
+        expect(trace.trigger).toBe('programmatic');
+        expect(trace.input).toBe('안녕하세요');
+        // Verify context assembly order: system fragments first, then context
+        expect(trace.assembledContext).toContain('유능한 비서');
+        expect(trace.assembledContext).toContain('따뜻하고 친절한');
+        expect(trace.assembledContext).toContain('오늘 할 일');
+        const sysIdx = trace.assembledContext.indexOf('비서');
+        const ctxIdx = trace.assembledContext.indexOf('오늘 할 일');
+        expect(sysIdx).toBeLessThan(ctxIdx); // system before context
+        // Verify hook traces
+        expect(trace.hooks).toHaveLength(4); // 3 onTurnStart + 1 onTurnEnd
+        expect(trace.hooks[0].phase).toBe('onTurnStart');
+        expect(trace.hooks[3].phase).toBe('onTurnEnd');
+        // Verify result
+        expect(trace.result?.text).toBe('안녕하세요, 저는 테스트 에이전트입니다.');
+        expect(trace.result?.sessionId).toBe('sess-1');
+        expect(trace.error).toBeNull();
+        // Verify onTurnEnd hook was called
+        const endHook = config.hooks.onTurnEnd[0];
+        expect(endHook.calls).toHaveLength(1);
+        expect(endHook.calls[0].result.text).toBe('안녕하세요, 저는 테스트 에이전트입니다.');
+    });
+    it('works with schedule trigger', async () => {
+        const config = defineConfig({
+            name: 'scheduler-test',
+            runtime: createMockRuntime('heartbeat ok'),
+        });
+        const agent = createAgent(config);
+        const trace = await agent.processTurn({
+            input: 'heartbeat check',
+            trigger: 'schedule',
+            schedule: { name: 'test-heartbeat', type: 'heartbeat' },
+        });
+        expect(trace.trigger).toBe('schedule');
+        expect(trace.result?.text).toBe('heartbeat ok');
+    });
+    it('handles runtime errors gracefully', async () => {
+        const failRuntime = {
+            name: 'fail',
+            async *createStream() {
+                throw new Error('API key expired');
+            },
+        };
+        const errorHook = {
+            name: 'error-reporter',
+            calls: [],
+            async execute(ctx, err) {
+                errorHook.calls.push({ ctx, err });
+            },
+        };
+        const config = defineConfig({
+            name: 'error-test',
+            runtime: failRuntime,
+            hooks: { onError: [errorHook] },
+        });
+        const agent = createAgent(config);
+        const trace = await agent.processTurn({ input: 'test' });
+        expect(trace.error).toBe('API key expired');
+        expect(trace.result).toBeNull();
+        expect(errorHook.calls).toHaveLength(1);
+        expect(errorHook.calls[0].err.message).toBe('API key expired');
+    });
+});
+describe('Scheduler integration', () => {
+    beforeEach(() => { vi.useFakeTimers(); });
+    afterEach(() => { vi.useRealTimers(); });
+    it('scheduler triggers turns on the agent', async () => {
+        const turns = [];
+        const scheduler = createScheduler({
+            schedules: [
+                { name: 'fast', type: 'heartbeat', expression: '1s', prompt: 'heartbeat check' },
+            ],
+            onTurn: async (options) => {
+                turns.push(options.input);
+                return {
+                    turnId: 'turn-1', timestamp: new Date().toISOString(),
+                    agentName: 'test', trigger: 'schedule', input: options.input,
+                    hooks: [], assembledContext: '',
+                    result: { text: 'ok', sessionId: null, durationMs: 0, toolCalls: [] },
+                    error: null,
+                };
+            },
+        });
+        scheduler.start();
+        await vi.advanceTimersByTimeAsync(3000);
+        scheduler.stop();
+        expect(turns.length).toBeGreaterThanOrEqual(2);
+        expect(turns[0]).toBe('heartbeat check');
+    });
+});
+//# sourceMappingURL=full-config.test.js.map

package/dist/__tests__/full-config.test.js.map

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

package/dist/__tests__/helpers.d.ts

@@ -0,0 +1,16 @@
+import type { Runtime, RuntimeEvent, TurnStartHook, TurnEndHook, ErrorHook, TurnContext, ContextFragment, TurnResult } from '../types.js';
+export declare function createMockRuntime(response?: string): Runtime;
+export declare function createMockHook(name: string, fragments: ContextFragment[]): TurnStartHook;
+export declare function createSpyEndHook(name: string): TurnEndHook & {
+    calls: {
+        context: TurnContext;
+        result: TurnResult;
+    }[];
+};
+export declare function createStreamingMockRuntime(events: RuntimeEvent[]): Runtime;
+export declare function createSpyErrorHook(name: string): ErrorHook & {
+    calls: {
+        error: Error;
+    }[];
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/__tests__/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/__tests__/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEzI,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAwB,GAAG,OAAO,CAQ7E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,aAAa,CAOxF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG;IAAE,KAAK,EAAE;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,EAAE,CAAA;CAAE,CAStH;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAS1E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,CAAA;CAAE,CAS1F"}

package/dist/__tests__/helpers.js

@@ -0,0 +1,48 @@
+export function createMockRuntime(response = 'mock response') {
+    return {
+        name: 'mock',
+        async *createStream() {
+            yield { type: 'session.init', sessionId: 'sess-1' };
+            yield { type: 'result', text: response };
+        },
+    };
+}
+export function createMockHook(name, fragments) {
+    return {
+        name,
+        async execute(_ctx) {
+            return fragments;
+        },
+    };
+}
+export function createSpyEndHook(name) {
+    const hook = {
+        name,
+        calls: [],
+        async execute(context, result) {
+            hook.calls.push({ context, result });
+        },
+    };
+    return hook;
+}
+export function createStreamingMockRuntime(events) {
+    return {
+        name: 'mock-streaming',
+        async *createStream() {
+            for (const event of events) {
+                yield event;
+            }
+        },
+    };
+}
+export function createSpyErrorHook(name) {
+    const hook = {
+        name,
+        calls: [],
+        async execute(_ctx, error) {
+            hook.calls.push({ error });
+        },
+    };
+    return hook;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/__tests__/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/__tests__/helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,WAAmB,eAAe;IAClE,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK,CAAC,CAAC,YAAY;YACjB,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;YACnD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QAC1C,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,SAA4B;IACvE,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,OAAO,CAAC,IAAiB;YAC7B,OAAO,SAAS,CAAA;QAClB,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,KAAK,EAAE,EAAoD;QAC3D,KAAK,CAAC,OAAO,CAAC,OAAoB,EAAE,MAAkB;YACpD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QACtC,CAAC;KACF,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAsB;IAC/D,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,CAAC,CAAC,YAAY;YACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,KAAK,EAAE,EAAwB;QAC/B,KAAK,CAAC,OAAO,CAAC,IAAiB,EAAE,KAAY;YAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5B,CAAC;KACF,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

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

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

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

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