@roj-ai/sdk 0.1.1 → 0.1.4

package/dist/core/agents/agent-config.test.js.map

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

package/dist/core/agents/agent-roles.js

@@ -0,0 +1,25 @@
+/**
+ * Agent role constants.
+ *
+ * These constants define the special agent roles in the system:
+ * - ORCHESTRATOR: The main agent that coordinates work and spawns sub-agents
+ * - COMMUNICATOR: Optional agent that handles user communication in communication-agent mode
+ */
+/** Orchestrator agent role - the main coordinating agent */
+export const ORCHESTRATOR_ROLE = 'orchestrator';
+/** Communicator agent role - handles user communication */
+export const COMMUNICATOR_ROLE = 'communicator';
+/**
+ * Determine an agent's prompt role from its state and session context.
+ */
+export function getAgentRole(agentState, sessionState) {
+    if (agentState.definitionName === COMMUNICATOR_ROLE)
+        return 'communicator';
+    const hasCommunicator = Array.from(sessionState.agents.values())
+        .some(a => a.definitionName === COMMUNICATOR_ROLE);
+    if (agentState.definitionName === ORCHESTRATOR_ROLE) {
+        return hasCommunicator ? 'orchestrator' : 'entry';
+    }
+    return 'child';
+}
+//# sourceMappingURL=agent-roles.js.map

package/dist/core/agents/agent-roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-roles.js","sourceRoot":"","sources":["../../../src/core/agents/agent-roles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAuB,CAAA;AAExD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAuB,CAAA;AAcxD;;GAEG;AACH,MAAM,UAAU,YAAY,CAC3B,UAA+D,EAC/D,YAAiE;IAEjE,IAAI,UAAU,CAAC,cAAc,KAAK,iBAAiB;QAAE,OAAO,cAAc,CAAA;IAC1E,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;SAC9D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,iBAAiB,CAAC,CAAA;IACnD,IAAI,UAAU,CAAC,cAAc,KAAK,iBAAiB,EAAE,CAAC;QACrD,OAAO,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAA;IAClD,CAAC;IACD,OAAO,OAAO,CAAA;AACf,CAAC"}

package/dist/core/agents/agent-shutdown.test.js

@@ -0,0 +1,180 @@
+/**
+ * Tests for Agent shutdown behavior - verifying that session close
+ * prevents re-scheduling and aborts in-flight work.
+ */
+import { describe, expect, it } from 'bun:test';
+import { AgentId } from '../../core/agents/schema.js';
+import { agentEvents } from '../../core/agents/state.js';
+import { MemoryEventStore } from '../../core/events';
+import { withSessionId } from '../../core/events/test-helpers.js';
+import { MockLLMProvider } from '../../core/llm/index.js';
+import { ModelId } from '../../core/llm/schema.js';
+import { createApplyEvent } from '../../core/sessions/apply-event.js';
+import { SessionId } from '../../core/sessions/schema.js';
+import { sessionEvents } from '../../core/sessions/state.js';
+import { ToolCallId } from '../../core/tools/schema.js';
+import { mailboxPlugin } from '../../plugins/mailbox/plugin.js';
+import { generateTestMessageId } from '../../plugins/mailbox/schema.js';
+import { mailboxEvents } from '../../plugins/mailbox/state.js';
+import { createNodePlatform } from '../../testing/node-platform.js';
+import { ConsoleLogger } from '../../lib/logger/console.js';
+import { SessionFileStore } from '../file-store/file-store.js';
+import { SessionStore } from '../sessions/session-store.js';
+import { ToolExecutor } from '../tools/executor.js';
+import { Agent } from './agent.js';
+// ============================================================================
+// Test Helpers
+// ============================================================================
+const TEST_SESSION_ID = SessionId('test-session');
+const TEST_AGENT_ID = AgentId('test-agent-1');
+function createLogger() {
+    return new ConsoleLogger({ level: 'error' });
+}
+async function createTestAgent(config = {}, llmResponse) {
+    const eventStore = new MemoryEventStore();
+    const logger = createLogger();
+    // Create session
+    const sessionCreatedEvent = withSessionId(TEST_SESSION_ID, sessionEvents.create('session_created', { presetId: 'test-preset' }));
+    await eventStore.append(TEST_SESSION_ID, sessionCreatedEvent);
+    // Spawn agent
+    const agentSpawnedEvent = withSessionId(TEST_SESSION_ID, agentEvents.create('agent_spawned', {
+        agentId: TEST_AGENT_ID,
+        definitionName: 'test-agent',
+        parentId: null,
+    }));
+    await eventStore.append(TEST_SESSION_ID, agentSpawnedEvent);
+    const composedReducer = createApplyEvent([mailboxPlugin.create({})]);
+    const store = await SessionStore.load(TEST_SESSION_ID, eventStore, composedReducer);
+    if (!store) {
+        throw new Error('Failed to create SessionStore');
+    }
+    const defaultConfig = {
+        systemPrompt: 'Test system prompt',
+        tools: [],
+        model: ModelId('test-model'),
+        spawnableAgents: [],
+        debounceMs: 0,
+        ...config,
+    };
+    const llmProvider = MockLLMProvider.withFixedResponse({
+        content: llmResponse?.content ?? 'Test response',
+        toolCalls: llmResponse?.toolCalls ?? [],
+        finishReason: llmResponse?.finishReason ?? 'stop',
+    });
+    const fileStore = new SessionFileStore('/tmp/test', undefined, false, createNodePlatform().fs);
+    const sessionContext = {
+        sessionId: TEST_SESSION_ID,
+        sessionState: store.getState(),
+        sessionInput: undefined,
+        environment: { sessionDir: '/tmp/test', sandboxed: false },
+        llm: llmProvider,
+        files: fileStore,
+        eventStore,
+        platform: createNodePlatform(),
+        logger,
+        emitEvent: async (event) => {
+            await store.emit(withSessionId(TEST_SESSION_ID, event));
+        },
+        notify: () => { },
+    };
+    const deps = {
+        id: TEST_AGENT_ID,
+        sessionContext,
+        store,
+        llmProvider,
+        toolExecutor: new ToolExecutor(logger),
+        logger,
+        config: defaultConfig,
+        plugins: [mailboxPlugin.create({})],
+        environment: { sessionDir: '/tmp/test', sandboxed: false },
+        fileStore,
+    };
+    const agent = new Agent(deps);
+    return { agent, store, eventStore, llmProvider };
+}
+async function addMailboxMessage(store, content) {
+    await store.emit(withSessionId(TEST_SESSION_ID, mailboxEvents.create('mailbox_message', {
+        toAgentId: TEST_AGENT_ID,
+        message: {
+            id: generateTestMessageId(),
+            from: 'user',
+            content,
+            timestamp: Date.now(),
+            consumed: false,
+        },
+    })));
+}
+async function closeSession(store) {
+    await store.emit(withSessionId(TEST_SESSION_ID, sessionEvents.create('session_closed', {})));
+}
+/**
+ * Wait for any scheduled timers to fire.
+ */
+async function flushTimers() {
+    await new Promise((resolve) => setTimeout(resolve, 10));
+}
+// ============================================================================
+// Tests
+// ============================================================================
+describe('Agent Shutdown', () => {
+    it('continue() is no-op when session is closed', async () => {
+        const { agent, store, llmProvider, eventStore } = await createTestAgent();
+        await addMailboxMessage(store, 'Hello');
+        await closeSession(store);
+        await agent.continue();
+        expect(llmProvider.getCallCount()).toBe(0);
+        const events = await eventStore.load(TEST_SESSION_ID);
+        const inferenceStarted = events.filter(e => e.type === 'inference_started');
+        expect(inferenceStarted).toHaveLength(0);
+    });
+    it('agent does not continue after session closes', async () => {
+        const { agent, store, llmProvider } = await createTestAgent();
+        await addMailboxMessage(store, 'Hello');
+        // While loop runs full cycle: onStart → inference → onComplete
+        await agent.continue();
+        expect(llmProvider.getCallCount()).toBe(1);
+        // Close session
+        await closeSession(store);
+        // Add another message that would trigger work if continue() ran
+        await addMailboxMessage(store, 'Another message');
+        // Let any scheduled timers fire
+        await flushTimers();
+        // No additional inference should have occurred — isClosed() guard blocks re-entry
+        expect(llmProvider.getCallCount()).toBe(1);
+    });
+    it('agent does not run additional inference after session is closed', async () => {
+        const { agent, store, llmProvider } = await createTestAgent({}, { toolCalls: [{ id: ToolCallId('tc-1'), name: 'test_tool', input: {} }] });
+        await addMailboxMessage(store, 'Hello');
+        // While loop runs full cycle: inference → tool_exec → scheduleProcessing
+        await agent.continue();
+        expect(llmProvider.getCallCount()).toBe(1);
+        // Close session — any scheduled timer will find isClosed() and stop
+        await closeSession(store);
+        // Calling continue() again is a no-op when session is closed
+        await agent.continue();
+        // No additional inference should have occurred
+        expect(llmProvider.getCallCount()).toBe(1);
+    });
+    it('scheduleProcessing() is no-op when session is closed', async () => {
+        const { agent, store } = await createTestAgent();
+        await addMailboxMessage(store, 'Hello');
+        await closeSession(store);
+        agent.scheduleProcessing();
+        expect(agent.isScheduled()).toBe(false);
+    });
+    it('shutdown() stops scheduled processing', async () => {
+        const { agent, store, llmProvider } = await createTestAgent({
+            debounceMs: 100,
+        });
+        await addMailboxMessage(store, 'Hello');
+        agent.scheduleProcessing();
+        expect(agent.isScheduled()).toBe(true);
+        agent.shutdown();
+        expect(agent.isScheduled()).toBe(false);
+        // Wait longer than the debounce time
+        await new Promise((resolve) => setTimeout(resolve, 150));
+        // LLM should never have been called
+        expect(llmProvider.getCallCount()).toBe(0);
+    });
+});
+//# sourceMappingURL=agent-shutdown.test.js.map

package/dist/core/agents/agent-shutdown.test.js.map

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