@stoneforge/smithy 0.1.0

package/dist/runtime/handoff.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Handoff Service (TB-O10e, TB-O10f)
+ *
+ * This service enables agent session handoffs for context preservation:
+ *
+ * - **Self-Handoff (TB-O10e)**: Agent hands off to fresh instance of itself
+ *   - Creates handoff message with context summary
+ *   - Suspends current session (available for predecessor query)
+ *   - New session finds handoff note in inbox
+ *
+ * - **Agent-Agent Handoff (TB-O10f)**: Agent hands off to another agent
+ *   - Sends handoff message to target agent's channel
+ *   - Optionally transfers tasks to target agent
+ *   - Triggers target agent to process handoff
+ *
+ * Key design decisions:
+ * - Handoff is manual-only (agent decides when to hand off)
+ * - Handoff messages stored as Documents for persistence
+ * - Uses existing inbox/channel system for delivery
+ *
+ * @module
+ */
+import type { EntityId, DocumentId, MessageId, Timestamp } from '@stoneforge/core';
+import type { QuarryAPI } from '@stoneforge/quarry';
+import type { SessionManager, SessionRecord } from './session-manager.js';
+import type { AgentRegistry } from '../services/agent-registry.js';
+/**
+ * Handoff message content structure
+ */
+export interface HandoffContent {
+    /** Type identifier for handoff messages */
+    readonly type: 'handoff';
+    /** Agent ID of the source (handing off) */
+    readonly fromAgentId: EntityId;
+    /** Agent ID of the target (receiving handoff), undefined for self-handoff */
+    readonly toAgentId?: EntityId;
+    /** Summary of the current context/state */
+    readonly contextSummary: string;
+    /** Recommended next steps */
+    readonly nextSteps?: string;
+    /** Reason for the handoff */
+    readonly reason?: string;
+    /** Task IDs being transferred (for agent-agent handoff) */
+    readonly taskIds?: string[];
+    /** Provider session ID for predecessor queries */
+    readonly providerSessionId?: string;
+    /** Timestamp when handoff was initiated */
+    readonly initiatedAt: Timestamp;
+}
+/**
+ * Options for self-handoff
+ */
+export interface SelfHandoffOptions {
+    /** Summary of current context to preserve */
+    readonly contextSummary: string;
+    /** Recommended next steps for the new session */
+    readonly nextSteps?: string;
+    /** Reason for triggering handoff */
+    readonly reason?: string;
+    /** Additional metadata to include */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Result of a self-handoff operation
+ */
+export interface SelfHandoffResult {
+    /** Whether the handoff was successful */
+    readonly success: boolean;
+    /** The handoff document ID */
+    readonly handoffDocumentId?: DocumentId;
+    /** The message ID sent to the agent's channel */
+    readonly messageId?: MessageId;
+    /** The suspended session record */
+    readonly suspendedSession?: SessionRecord;
+    /** Error message if failed */
+    readonly error?: string;
+    /** Timestamp when handoff completed */
+    readonly completedAt: Timestamp;
+}
+/**
+ * Options for agent-to-agent handoff
+ */
+export interface AgentHandoffOptions {
+    /** Summary of current context to preserve */
+    readonly contextSummary: string;
+    /** Recommended next steps for the target agent */
+    readonly nextSteps?: string;
+    /** Reason for triggering handoff */
+    readonly reason?: string;
+    /** Task IDs to transfer to the target agent */
+    readonly taskIds?: string[];
+    /** Additional metadata to include */
+    readonly metadata?: Record<string, unknown>;
+    /** Whether to trigger the target agent to wake up (default: true) */
+    readonly triggerTarget?: boolean;
+}
+/**
+ * Result of an agent-to-agent handoff operation
+ */
+export interface AgentHandoffResult {
+    /** Whether the handoff was successful */
+    readonly success: boolean;
+    /** The handoff document ID */
+    readonly handoffDocumentId?: DocumentId;
+    /** The message ID sent to the target agent's channel */
+    readonly messageId?: MessageId;
+    /** The suspended session record of the source agent */
+    readonly suspendedSession?: SessionRecord;
+    /** The target agent ID */
+    readonly targetAgentId?: EntityId;
+    /** Error message if failed */
+    readonly error?: string;
+    /** Timestamp when handoff completed */
+    readonly completedAt: Timestamp;
+}
+/**
+ * Handoff Service interface for agent session handoffs.
+ *
+ * The service provides methods for:
+ * - Self-handoff: Agent hands off to fresh instance of itself
+ * - Agent-agent handoff: Agent hands off to another agent (TB-O10f)
+ */
+export interface HandoffService {
+    /**
+     * Performs a self-handoff for an agent.
+     *
+     * This operation:
+     * 1. Creates a handoff document with context summary
+     * 2. Sends a handoff message to the agent's own channel
+     * 3. Suspends the current session (preserving provider session ID)
+     * 4. Terminates the process gracefully
+     *
+     * The new session can find the handoff note in its inbox and
+     * optionally query the suspended predecessor for more context.
+     *
+     * @param agentId - The agent performing the handoff
+     * @param sessionId - The current session ID
+     * @param options - Handoff options
+     * @returns Result of the handoff operation
+     */
+    selfHandoff(agentId: EntityId, sessionId: string, options: SelfHandoffOptions): Promise<SelfHandoffResult>;
+    /**
+     * Performs a handoff from one agent to another.
+     *
+     * This operation:
+     * 1. Creates a handoff document with context summary
+     * 2. Sends a handoff message to the target agent's channel
+     * 3. Optionally transfers task assignments to the target
+     * 4. Suspends the source session
+     * 5. Optionally triggers the target agent to wake up
+     *
+     * @param fromAgentId - The agent initiating the handoff
+     * @param toAgentId - The target agent receiving the handoff
+     * @param sessionId - The current session ID of the source agent
+     * @param options - Handoff options
+     * @returns Result of the handoff operation
+     */
+    handoffToAgent(fromAgentId: EntityId, toAgentId: EntityId, sessionId: string, options: AgentHandoffOptions): Promise<AgentHandoffResult>;
+    /**
+     * Gets the most recent handoff message for an agent.
+     *
+     * @param agentId - The agent to check for handoff messages
+     * @returns The most recent handoff content, or undefined if none
+     */
+    getLastHandoff(agentId: EntityId): Promise<HandoffContent | undefined>;
+    /**
+     * Checks if an agent has a pending handoff message.
+     *
+     * @param agentId - The agent to check
+     * @returns True if a handoff message is pending
+     */
+    hasPendingHandoff(agentId: EntityId): Promise<boolean>;
+}
+/** Tag used to identify handoff documents */
+export declare const HANDOFF_DOCUMENT_TAG = "handoff";
+/** Message type for handoff messages */
+export declare const HANDOFF_MESSAGE_TYPE = "handoff";
+/**
+ * Implementation of the Handoff Service.
+ */
+export declare class HandoffServiceImpl implements HandoffService {
+    private readonly sessionManager;
+    private readonly registry;
+    private readonly api;
+    constructor(sessionManager: SessionManager, registry: AgentRegistry, api: QuarryAPI);
+    selfHandoff(agentId: EntityId, sessionId: string, options: SelfHandoffOptions): Promise<SelfHandoffResult>;
+    handoffToAgent(fromAgentId: EntityId, toAgentId: EntityId, sessionId: string, options: AgentHandoffOptions): Promise<AgentHandoffResult>;
+    getLastHandoff(agentId: EntityId): Promise<HandoffContent | undefined>;
+    hasPendingHandoff(agentId: EntityId): Promise<boolean>;
+}
+/**
+ * Creates a HandoffService instance
+ */
+export declare function createHandoffService(sessionManager: SessionManager, registry: AgentRegistry, api: QuarryAPI): HandoffService;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/runtime/handoff.d.ts.map

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

package/dist/runtime/handoff.js

@@ -0,0 +1,332 @@
+/**
+ * Handoff Service (TB-O10e, TB-O10f)
+ *
+ * This service enables agent session handoffs for context preservation:
+ *
+ * - **Self-Handoff (TB-O10e)**: Agent hands off to fresh instance of itself
+ *   - Creates handoff message with context summary
+ *   - Suspends current session (available for predecessor query)
+ *   - New session finds handoff note in inbox
+ *
+ * - **Agent-Agent Handoff (TB-O10f)**: Agent hands off to another agent
+ *   - Sends handoff message to target agent's channel
+ *   - Optionally transfers tasks to target agent
+ *   - Triggers target agent to process handoff
+ *
+ * Key design decisions:
+ * - Handoff is manual-only (agent decides when to hand off)
+ * - Handoff messages stored as Documents for persistence
+ * - Uses existing inbox/channel system for delivery
+ *
+ * @module
+ */
+import { createTimestamp, createDocument, createMessage, ContentType } from '@stoneforge/core';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Tag used to identify handoff documents */
+export const HANDOFF_DOCUMENT_TAG = 'handoff';
+/** Message type for handoff messages */
+export const HANDOFF_MESSAGE_TYPE = 'handoff';
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Implementation of the Handoff Service.
+ */
+export class HandoffServiceImpl {
+    sessionManager;
+    registry;
+    api;
+    constructor(sessionManager, registry, api) {
+        this.sessionManager = sessionManager;
+        this.registry = registry;
+        this.api = api;
+    }
+    async selfHandoff(agentId, sessionId, options) {
+        const now = createTimestamp();
+        try {
+            // Get the current session
+            const session = this.sessionManager.getSession(sessionId);
+            if (!session) {
+                return {
+                    success: false,
+                    error: `Session not found: ${sessionId}`,
+                    completedAt: now,
+                };
+            }
+            // Verify the session belongs to the agent
+            if (session.agentId !== agentId) {
+                return {
+                    success: false,
+                    error: `Session ${sessionId} does not belong to agent ${agentId}`,
+                    completedAt: now,
+                };
+            }
+            // Verify the session is running
+            if (session.status !== 'running') {
+                return {
+                    success: false,
+                    error: `Cannot handoff session in status: ${session.status}`,
+                    completedAt: now,
+                };
+            }
+            // Get the agent's channel
+            const channelId = await this.registry.getAgentChannelId(agentId);
+            if (!channelId) {
+                return {
+                    success: false,
+                    error: `Agent ${agentId} has no channel`,
+                    completedAt: now,
+                };
+            }
+            // Create handoff content
+            const handoffContent = {
+                type: 'handoff',
+                fromAgentId: agentId,
+                toAgentId: undefined, // Self-handoff has no target
+                contextSummary: options.contextSummary,
+                nextSteps: options.nextSteps,
+                reason: options.reason,
+                providerSessionId: session.providerSessionId,
+                initiatedAt: now,
+            };
+            // Create handoff document
+            const handoffDocument = await createDocument({
+                content: JSON.stringify(handoffContent, null, 2),
+                contentType: ContentType.JSON,
+                createdBy: agentId,
+                tags: [HANDOFF_DOCUMENT_TAG, 'self-handoff'],
+                metadata: {
+                    handoffType: 'self',
+                    fromAgentId: agentId,
+                    providerSessionId: session.providerSessionId,
+                    ...options.metadata,
+                },
+            });
+            // Save the handoff document
+            const savedDocument = await this.api.create(handoffDocument);
+            const handoffDocumentId = savedDocument.id;
+            // Create and send handoff message to the agent's channel
+            const handoffMessage = await createMessage({
+                channelId: channelId,
+                sender: agentId,
+                contentRef: handoffDocumentId,
+                metadata: {
+                    type: HANDOFF_MESSAGE_TYPE,
+                    handoffType: 'self',
+                    fromAgentId: agentId,
+                    handoffDocumentId,
+                },
+            });
+            const savedMessage = await this.api.create(handoffMessage);
+            const messageId = savedMessage.id;
+            // Suspend the session (preserves provider session ID for predecessor queries)
+            const suspendReason = options.reason
+                ? `Self-handoff: ${options.reason}`
+                : 'Self-handoff initiated';
+            await this.sessionManager.suspendSession(sessionId, suspendReason);
+            // Get the updated session record
+            const suspendedSession = this.sessionManager.getSession(sessionId);
+            return {
+                success: true,
+                handoffDocumentId,
+                messageId,
+                suspendedSession: suspendedSession ?? undefined,
+                completedAt: createTimestamp(),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                completedAt: createTimestamp(),
+            };
+        }
+    }
+    async handoffToAgent(fromAgentId, toAgentId, sessionId, options) {
+        const now = createTimestamp();
+        try {
+            // Get the current session
+            const session = this.sessionManager.getSession(sessionId);
+            if (!session) {
+                return {
+                    success: false,
+                    error: `Session not found: ${sessionId}`,
+                    completedAt: now,
+                };
+            }
+            // Verify the session belongs to the source agent
+            if (session.agentId !== fromAgentId) {
+                return {
+                    success: false,
+                    error: `Session ${sessionId} does not belong to agent ${fromAgentId}`,
+                    completedAt: now,
+                };
+            }
+            // Verify the session is running
+            if (session.status !== 'running') {
+                return {
+                    success: false,
+                    error: `Cannot handoff session in status: ${session.status}`,
+                    completedAt: now,
+                };
+            }
+            // Verify target agent exists
+            const targetAgent = await this.registry.getAgent(toAgentId);
+            if (!targetAgent) {
+                return {
+                    success: false,
+                    error: `Target agent not found: ${toAgentId}`,
+                    completedAt: now,
+                };
+            }
+            // Get the target agent's channel
+            const targetChannelId = await this.registry.getAgentChannelId(toAgentId);
+            if (!targetChannelId) {
+                return {
+                    success: false,
+                    error: `Target agent ${toAgentId} has no channel`,
+                    completedAt: now,
+                };
+            }
+            // Create handoff content
+            const handoffContent = {
+                type: 'handoff',
+                fromAgentId,
+                toAgentId,
+                contextSummary: options.contextSummary,
+                nextSteps: options.nextSteps,
+                reason: options.reason,
+                taskIds: options.taskIds,
+                providerSessionId: session.providerSessionId,
+                initiatedAt: now,
+            };
+            // Create handoff document
+            const handoffDocument = await createDocument({
+                content: JSON.stringify(handoffContent, null, 2),
+                contentType: ContentType.JSON,
+                createdBy: fromAgentId,
+                tags: [HANDOFF_DOCUMENT_TAG, 'agent-handoff'],
+                metadata: {
+                    handoffType: 'agent-to-agent',
+                    fromAgentId,
+                    toAgentId,
+                    providerSessionId: session.providerSessionId,
+                    taskIds: options.taskIds,
+                    ...options.metadata,
+                },
+            });
+            // Save the handoff document
+            const savedDocument = await this.api.create(handoffDocument);
+            const handoffDocumentId = savedDocument.id;
+            // Create and send handoff message to the target agent's channel
+            const handoffMessage = await createMessage({
+                channelId: targetChannelId,
+                sender: fromAgentId,
+                contentRef: handoffDocumentId,
+                metadata: {
+                    type: HANDOFF_MESSAGE_TYPE,
+                    handoffType: 'agent-to-agent',
+                    fromAgentId,
+                    toAgentId,
+                    handoffDocumentId,
+                    taskIds: options.taskIds,
+                },
+            });
+            const savedMessage = await this.api.create(handoffMessage);
+            const messageId = savedMessage.id;
+            // Suspend the source session
+            const suspendReason = options.reason
+                ? `Handoff to ${toAgentId}: ${options.reason}`
+                : `Handoff to ${toAgentId}`;
+            await this.sessionManager.suspendSession(sessionId, suspendReason);
+            // Get the updated session record
+            const suspendedSession = this.sessionManager.getSession(sessionId);
+            // TODO: If options.triggerTarget !== false and target agent is idle,
+            // we could notify/wake up the target agent here.
+            // This would require integration with a notification system or
+            // direct session starting capability.
+            return {
+                success: true,
+                handoffDocumentId,
+                messageId,
+                suspendedSession: suspendedSession ?? undefined,
+                targetAgentId: toAgentId,
+                completedAt: createTimestamp(),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                completedAt: createTimestamp(),
+            };
+        }
+    }
+    async getLastHandoff(agentId) {
+        try {
+            // Get the agent's channel ID
+            const channelId = await this.registry.getAgentChannelId(agentId);
+            if (!channelId) {
+                return undefined;
+            }
+            // Search for handoff documents targeting this agent
+            const documents = await this.api.list({
+                type: 'document',
+                tags: [HANDOFF_DOCUMENT_TAG],
+            });
+            // Filter to handoff documents for this agent and sort by creation time
+            const handoffDocs = documents
+                .filter((doc) => {
+                const meta = doc.metadata;
+                // Match self-handoff (fromAgentId === agentId, no toAgentId) or
+                // agent-to-agent handoff (toAgentId === agentId)
+                return ((meta?.fromAgentId === agentId && meta?.handoffType === 'self') ||
+                    meta?.toAgentId === agentId);
+            })
+                .sort((a, b) => {
+                const aTime = typeof a.createdAt === 'number' ? a.createdAt : new Date(a.createdAt).getTime();
+                const bTime = typeof b.createdAt === 'number' ? b.createdAt : new Date(b.createdAt).getTime();
+                return bTime - aTime; // Most recent first
+            });
+            if (handoffDocs.length === 0) {
+                return undefined;
+            }
+            // Get the most recent handoff document
+            const latestDoc = handoffDocs[0];
+            const content = latestDoc.content;
+            if (!content) {
+                return undefined;
+            }
+            // Parse the handoff content
+            try {
+                const handoffContent = JSON.parse(content);
+                if (handoffContent.type !== 'handoff') {
+                    return undefined;
+                }
+                return handoffContent;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async hasPendingHandoff(agentId) {
+        const handoff = await this.getLastHandoff(agentId);
+        return handoff !== undefined;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Creates a HandoffService instance
+ */
+export function createHandoffService(sessionManager, registry, api) {
+    return new HandoffServiceImpl(sessionManager, registry, api);
+}
+//# sourceMappingURL=handoff.js.map

package/dist/runtime/handoff.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Orchestrator Runtime
+ *
+ * This module exports runtime management for Claude Code agent processes:
+ * - SpawnerService (TB-O9) - Spawns and manages Claude Code processes
+ * - SessionManager (TB-O10) - Session tracking with resume support
+ * - PredecessorQueryService (TB-O10d) - Query previous sessions for context
+ * - Handoff services (TB-O10e, TB-O10f) - TODO
+ */
+export { type SpawnMode, type SpawnConfig, type SpawnOptions, type StreamJsonEventType, type StreamJsonEvent, type SpawnedSessionEvent, type SessionStatus, type SpawnedSession, type SpawnResult, type SendInputOptions, type SpawnerService, type UWPCheckResult, type UWPCheckOptions, type UWPTaskInfo, SessionStatusTransitions, SpawnerServiceImpl, createSpawnerService, canReceiveInput, isTerminalStatus, getStatusDescription, } from './spawner.js';
+export { type SessionRecord, type StartSessionOptions, type ResumeSessionOptions, type StopSessionOptions, type MessageSessionOptions, type MessageSessionResult, type SessionFilter, type SessionHistoryEntry, type RoleSessionHistoryEntry, type SessionManager, type ResumeUWPCheckResult, SessionManagerImpl, createSessionManager, } from './session-manager.js';
+export { DEFAULT_QUERY_TIMEOUT_MS, MIN_QUERY_TIMEOUT_MS, MAX_QUERY_TIMEOUT_MS, type PredecessorQueryOptions, type PredecessorQueryResult, type PredecessorInfo, type PredecessorQueryStatus, type ActivePredecessorQuery, type PredecessorQueryService, PredecessorQueryServiceImpl, createPredecessorQueryService, TimeoutError, NoPredecessorError, } from './predecessor-query.js';
+export { trackListeners } from './event-utils.js';
+export { HANDOFF_DOCUMENT_TAG, HANDOFF_MESSAGE_TYPE, type HandoffContent, type SelfHandoffOptions, type SelfHandoffResult, type AgentHandoffOptions, type AgentHandoffResult, type HandoffService, HandoffServiceImpl, createHandoffService, } from './handoff.js';
+export { type SDKMessage, type SDKAssistantMessage, type SDKSystemMessage, type SDKResultMessage, type SDKErrorMessage, type SDKContentBlock, type AnySDKMessage, mapSDKMessageToEvent, mapToolResultToEvent, mapSDKMessagesToEvents, } from './message-mapper.js';
+export { type ProviderSessionId, type AgentProviderConfig, type AgentMessage, type HeadlessSession, type HeadlessSpawnOptions, type HeadlessProvider, type InteractiveSession, type InteractiveSpawnOptions, type InteractiveProvider, type AgentProvider, AgentProviderRegistry, getProviderRegistry, ClaudeAgentProvider, ClaudeHeadlessProvider, ClaudeInteractiveProvider, OpenCodeAgentProvider, OpenCodeHeadlessProvider, OpenCodeInteractiveProvider, ProviderError, } from '../providers/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAEnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAEhB,wBAAwB,EAExB,kBAAkB,EAElB,oBAAoB,EAEpB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAExB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAEzB,kBAAkB,EAElB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EAEpB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAE5B,2BAA2B,EAE3B,6BAA6B,EAE7B,YAAY,EACZ,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAEL,oBAAoB,EACpB,oBAAoB,EAEpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EAEnB,kBAAkB,EAElB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAElB,qBAAqB,EACrB,mBAAmB,EAEnB,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EAEzB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAE3B,aAAa,GACd,MAAM,uBAAuB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,60 @@
+/**
+ * Orchestrator Runtime
+ *
+ * This module exports runtime management for Claude Code agent processes:
+ * - SpawnerService (TB-O9) - Spawns and manages Claude Code processes
+ * - SessionManager (TB-O10) - Session tracking with resume support
+ * - PredecessorQueryService (TB-O10d) - Query previous sessions for context
+ * - Handoff services (TB-O10e, TB-O10f) - TODO
+ */
+// Spawner service (TB-O9)
+export { 
+// Constants
+SessionStatusTransitions, 
+// Implementation
+SpawnerServiceImpl, 
+// Factory
+createSpawnerService, 
+// Utilities
+canReceiveInput, isTerminalStatus, getStatusDescription, } from './spawner.js';
+// Session Manager (TB-O10)
+export { 
+// Implementation
+SessionManagerImpl, 
+// Factory
+createSessionManager, } from './session-manager.js';
+// Predecessor Query Service (TB-O10d)
+export { 
+// Constants
+DEFAULT_QUERY_TIMEOUT_MS, MIN_QUERY_TIMEOUT_MS, MAX_QUERY_TIMEOUT_MS, 
+// Implementation
+PredecessorQueryServiceImpl, 
+// Factory
+createPredecessorQueryService, 
+// Errors
+TimeoutError, NoPredecessorError, } from './predecessor-query.js';
+// Event utilities
+export { trackListeners } from './event-utils.js';
+// Handoff Service (TB-O10e, TB-O10f)
+export { 
+// Constants
+HANDOFF_DOCUMENT_TAG, HANDOFF_MESSAGE_TYPE, 
+// Implementation
+HandoffServiceImpl, 
+// Factory
+createHandoffService, } from './handoff.js';
+// Message Mapper (SDK to SpawnedSessionEvent conversion)
+export { 
+// Functions
+mapSDKMessageToEvent, mapToolResultToEvent, mapSDKMessagesToEvents, } from './message-mapper.js';
+// Provider Abstraction Layer
+export { 
+// Registry
+AgentProviderRegistry, getProviderRegistry, 
+// Claude provider (default)
+ClaudeAgentProvider, ClaudeHeadlessProvider, ClaudeInteractiveProvider, 
+// OpenCode provider (stubs)
+OpenCodeAgentProvider, OpenCodeHeadlessProvider, OpenCodeInteractiveProvider, 
+// Errors
+ProviderError, } from '../providers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0BAA0B;AAC1B,OAAO;AAiBL,YAAY;AACZ,wBAAwB;AACxB,iBAAiB;AACjB,kBAAkB;AAClB,UAAU;AACV,oBAAoB;AACpB,YAAY;AACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,2BAA2B;AAC3B,OAAO;AAeL,iBAAiB;AACjB,kBAAkB;AAClB,UAAU;AACV,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,sCAAsC;AACtC,OAAO;AACL,YAAY;AACZ,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB;AAQpB,iBAAiB;AACjB,2BAA2B;AAC3B,UAAU;AACV,6BAA6B;AAC7B,SAAS;AACT,YAAY,EACZ,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qCAAqC;AACrC,OAAO;AACL,YAAY;AACZ,oBAAoB,EACpB,oBAAoB;AAQpB,iBAAiB;AACjB,kBAAkB;AAClB,UAAU;AACV,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,yDAAyD;AACzD,OAAO;AASL,YAAY;AACZ,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,6BAA6B;AAC7B,OAAO;AAYL,WAAW;AACX,qBAAqB,EACrB,mBAAmB;AACnB,4BAA4B;AAC5B,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB;AACzB,4BAA4B;AAC5B,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B;AAC3B,SAAS;AACT,aAAa,GACd,MAAM,uBAAuB,CAAC"}