@stoneforge/smithy 0.1.0

package/dist/runtime/message-mapper.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Message Mapper
+ *
+ * Maps SDK message types to the existing SpawnedSessionEvent format
+ * for backward compatibility with the orchestrator's event handling.
+ *
+ * SDK Message Type Mappings:
+ * | SDK Message Type      | Current Event Type |
+ * |-----------------------|-------------------|
+ * | SDKAssistantMessage   | assistant         |
+ * | SDKUserMessage        | user              |
+ * | tool_use content      | tool_use          |
+ * | tool_result content   | tool_result       |
+ * | SDKSystemMessage      | system            |
+ * | SDKResultMessage      | result            |
+ *
+ * @module
+ */
+import type { Timestamp } from '@stoneforge/core';
+import type { SpawnedSessionEvent } from './spawner.js';
+/**
+ * Base SDK message interface
+ */
+export interface SDKMessage {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * SDK assistant message
+ */
+export interface SDKAssistantMessage extends SDKMessage {
+    type: 'assistant';
+    content: string | SDKContentBlock[];
+}
+/**
+ * SDK user message
+ */
+export interface SDKUserMessage extends SDKMessage {
+    type: 'user';
+    content: string;
+}
+/**
+ * SDK system message
+ */
+export interface SDKSystemMessage extends SDKMessage {
+    type: 'system';
+    subtype?: string;
+    session_id?: string;
+    message?: string;
+}
+/**
+ * SDK result message (completion)
+ */
+export interface SDKResultMessage extends SDKMessage {
+    type: 'result';
+    result?: string;
+    status?: string;
+}
+/**
+ * SDK error message
+ */
+export interface SDKErrorMessage extends SDKMessage {
+    type: 'error';
+    error: string;
+    message?: string;
+}
+/**
+ * SDK content block (for structured content like tool use)
+ */
+export interface SDKContentBlock {
+    type: 'text' | 'tool_use' | 'tool_result';
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: unknown;
+    tool_use_id?: string;
+    content?: string;
+    is_error?: boolean;
+}
+export type AnySDKMessage = SDKAssistantMessage | SDKUserMessage | SDKSystemMessage | SDKResultMessage | SDKErrorMessage;
+/**
+ * Maps an SDK message to a SpawnedSessionEvent.
+ *
+ * @param sdkMessage - The SDK message to map
+ * @returns The mapped SpawnedSessionEvent
+ */
+export declare function mapSDKMessageToEvent(sdkMessage: AnySDKMessage): SpawnedSessionEvent;
+/**
+ * Maps a tool_result content block to SpawnedSessionEvent.
+ */
+export declare function mapToolResultToEvent(toolUseId: string, content: string, isError?: boolean, receivedAt?: Timestamp): SpawnedSessionEvent;
+/**
+ * Maps an array of SDK messages to SpawnedSessionEvents.
+ *
+ * @param messages - Array of SDK messages
+ * @returns Array of mapped events
+ */
+export declare function mapSDKMessagesToEvents(messages: AnySDKMessage[]): SpawnedSessionEvent[];
+//# sourceMappingURL=message-mapper.d.ts.map

package/dist/runtime/message-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-mapper.d.ts","sourceRoot":"","sources":["../../src/runtime/message-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAuB,MAAM,cAAc,CAAC;AAM7E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAGD,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,CAAC;AAMpB;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,aAAa,GAAG,mBAAmB,CA2BnF;AAoJD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAe,EACxB,UAAU,GAAE,SAA6B,GACxC,mBAAmB,CAerB;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,mBAAmB,EAAE,CAEvF"}

package/dist/runtime/message-mapper.js

@@ -0,0 +1,202 @@
+/**
+ * Message Mapper
+ *
+ * Maps SDK message types to the existing SpawnedSessionEvent format
+ * for backward compatibility with the orchestrator's event handling.
+ *
+ * SDK Message Type Mappings:
+ * | SDK Message Type      | Current Event Type |
+ * |-----------------------|-------------------|
+ * | SDKAssistantMessage   | assistant         |
+ * | SDKUserMessage        | user              |
+ * | tool_use content      | tool_use          |
+ * | tool_result content   | tool_result       |
+ * | SDKSystemMessage      | system            |
+ * | SDKResultMessage      | result            |
+ *
+ * @module
+ */
+import { createTimestamp } from '@stoneforge/core';
+// ============================================================================
+// Mapper Functions
+// ============================================================================
+/**
+ * Maps an SDK message to a SpawnedSessionEvent.
+ *
+ * @param sdkMessage - The SDK message to map
+ * @returns The mapped SpawnedSessionEvent
+ */
+export function mapSDKMessageToEvent(sdkMessage) {
+    const receivedAt = createTimestamp();
+    switch (sdkMessage.type) {
+        case 'assistant':
+            return mapAssistantMessage(sdkMessage, receivedAt);
+        case 'user':
+            return mapUserMessage(sdkMessage, receivedAt);
+        case 'system':
+            return mapSystemMessage(sdkMessage, receivedAt);
+        case 'result':
+            return mapResultMessage(sdkMessage, receivedAt);
+        case 'error':
+            return mapErrorMessage(sdkMessage, receivedAt);
+        default:
+            // Unknown message type - pass through as raw
+            return {
+                type: (sdkMessage.type || 'system'),
+                receivedAt,
+                raw: sdkMessage,
+            };
+    }
+}
+/**
+ * Maps an SDK assistant message to SpawnedSessionEvent.
+ * Assistant messages may contain text or tool_use blocks.
+ */
+function mapAssistantMessage(message, receivedAt) {
+    // If content is a string, it's simple text
+    if (typeof message.content === 'string') {
+        return {
+            type: 'assistant',
+            receivedAt,
+            raw: {
+                type: 'assistant',
+                message: message.content,
+            },
+            message: message.content,
+        };
+    }
+    // Content is an array of content blocks
+    const blocks = message.content;
+    // Find text content
+    const textBlocks = blocks.filter((b) => b.type === 'text');
+    const textContent = textBlocks.map((b) => b.text || '').join('\n');
+    // Find tool_use blocks
+    const toolUseBlocks = blocks.filter((b) => b.type === 'tool_use');
+    if (toolUseBlocks.length > 0) {
+        // Return tool_use event for the first tool use block
+        // (In practice, Claude typically uses one tool at a time)
+        const toolBlock = toolUseBlocks[0];
+        return {
+            type: 'tool_use',
+            receivedAt,
+            raw: {
+                type: 'tool_use',
+                tool: toolBlock.name,
+                tool_use_id: toolBlock.id,
+                tool_input: toolBlock.input,
+                message: textContent || undefined,
+            },
+            message: textContent || undefined,
+            tool: {
+                name: toolBlock.name,
+                id: toolBlock.id,
+                input: toolBlock.input,
+            },
+        };
+    }
+    // No tool use, return as assistant message
+    return {
+        type: 'assistant',
+        receivedAt,
+        raw: {
+            type: 'assistant',
+            message: textContent,
+        },
+        message: textContent,
+    };
+}
+/**
+ * Maps an SDK user message to SpawnedSessionEvent.
+ */
+function mapUserMessage(message, receivedAt) {
+    return {
+        type: 'user',
+        receivedAt,
+        raw: {
+            type: 'user',
+            message: message.content,
+        },
+        message: message.content,
+    };
+}
+/**
+ * Maps an SDK system message to SpawnedSessionEvent.
+ */
+function mapSystemMessage(message, receivedAt) {
+    return {
+        type: 'system',
+        subtype: message.subtype,
+        receivedAt,
+        raw: {
+            type: 'system',
+            subtype: message.subtype,
+            session_id: message.session_id,
+            message: message.message,
+        },
+        message: message.message,
+    };
+}
+/**
+ * Maps an SDK result message to SpawnedSessionEvent.
+ */
+function mapResultMessage(message, receivedAt) {
+    return {
+        type: 'result',
+        receivedAt,
+        raw: {
+            type: 'result',
+            result: message.result,
+        },
+        message: message.result,
+    };
+}
+/**
+ * Maps an SDK error message to SpawnedSessionEvent.
+ */
+function mapErrorMessage(message, receivedAt) {
+    return {
+        type: 'error',
+        receivedAt,
+        raw: {
+            type: 'error',
+            error: message.error,
+            message: message.message,
+        },
+        message: message.message || message.error,
+    };
+}
+// ============================================================================
+// Content Block Mappers
+// ============================================================================
+/**
+ * Maps a tool_result content block to SpawnedSessionEvent.
+ */
+export function mapToolResultToEvent(toolUseId, content, isError = false, receivedAt = createTimestamp()) {
+    return {
+        type: 'tool_result',
+        receivedAt,
+        raw: {
+            type: 'tool_result',
+            tool_use_id: toolUseId,
+            content,
+            is_error: isError,
+        },
+        message: content,
+        tool: {
+            id: toolUseId,
+        },
+    };
+}
+// ============================================================================
+// Batch Processing
+// ============================================================================
+/**
+ * Maps an array of SDK messages to SpawnedSessionEvents.
+ *
+ * @param messages - Array of SDK messages
+ * @returns Array of mapped events
+ */
+export function mapSDKMessagesToEvents(messages) {
+    return messages.map(mapSDKMessageToEvent);
+}
+//# sourceMappingURL=message-mapper.js.map

package/dist/runtime/message-mapper.js.map

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

package/dist/runtime/predecessor-query.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Predecessor Query Service
+ *
+ * This service enables agents to consult previous sessions for context and guidance.
+ * It implements the predecessor query pattern from the orchestration spec:
+ *
+ * 1. Find most recent session for a given role
+ * 2. Resume that previous session using Claude Code's --resume flag
+ * 3. Send a message to the predecessor
+ * 4. Capture the response
+ * 5. Suspend the predecessor session again
+ * 6. Return the response to the current agent
+ *
+ * This allows collaborative problem-solving between agents by enabling new sessions
+ * to query previous session holders for historical context.
+ *
+ * @module
+ */
+import { EventEmitter } from 'node:events';
+import type { EntityId, Timestamp } from '@stoneforge/core';
+import type { AgentRole } from '../types/agent.js';
+import type { SessionManager } from './session-manager.js';
+/**
+ * Options for querying a predecessor
+ */
+export interface PredecessorQueryOptions {
+    /** Maximum time to wait for a response in milliseconds (default: 60000) */
+    readonly timeout?: number;
+    /** Whether to suspend the predecessor after getting a response (default: true) */
+    readonly suspendAfterResponse?: boolean;
+    /** Additional context to provide to the predecessor */
+    readonly context?: string;
+    /** Working directory for the resumed session */
+    readonly workingDirectory?: string;
+}
+/**
+ * Result of a predecessor query
+ */
+export interface PredecessorQueryResult {
+    /** Whether the query was successful */
+    readonly success: boolean;
+    /** The response message from the predecessor */
+    readonly response?: string;
+    /** The predecessor session information */
+    readonly predecessor?: PredecessorInfo;
+    /** Error message if the query failed */
+    readonly error?: string;
+    /** Timestamp when the query completed */
+    readonly completedAt: Timestamp;
+    /** Duration of the query in milliseconds */
+    readonly durationMs: number;
+}
+/**
+ * Information about the predecessor session
+ */
+export interface PredecessorInfo {
+    /** The agent ID of the predecessor */
+    readonly agentId: EntityId;
+    /** The agent name */
+    readonly agentName?: string;
+    /** The role of the predecessor */
+    readonly role: AgentRole;
+    /** The provider session ID used for resume */
+    readonly providerSessionId: string;
+    /** The internal session ID */
+    readonly sessionId: string;
+    /** The working directory of the predecessor session */
+    readonly workingDirectory: string;
+    /** When the predecessor session was originally started */
+    readonly originalStartedAt?: Timestamp;
+    /** When the predecessor session was suspended */
+    readonly suspendedAt?: Timestamp;
+}
+/**
+ * Status of a predecessor query
+ */
+export type PredecessorQueryStatus = 'pending' | 'resuming' | 'waiting_response' | 'completed' | 'failed' | 'timed_out';
+/**
+ * Active predecessor query tracking
+ */
+export interface ActivePredecessorQuery {
+    /** Unique query ID */
+    readonly id: string;
+    /** The requesting agent ID */
+    readonly requestingAgentId: EntityId;
+    /** The role being queried */
+    readonly targetRole: AgentRole;
+    /** The message sent to the predecessor */
+    readonly message: string;
+    /** Current status of the query */
+    status: PredecessorQueryStatus;
+    /** The predecessor session ID (once resumed) */
+    predecessorSessionId?: string;
+    /** Query started timestamp */
+    readonly startedAt: Timestamp;
+    /** Query completed timestamp */
+    completedAt?: Timestamp;
+    /** Accumulated response text */
+    responseAccumulator: string;
+    /** Event emitter for query events */
+    readonly events: EventEmitter;
+}
+/**
+ * Predecessor Query Service interface.
+ *
+ * This service enables agents to consult previous sessions of a given role
+ * for context, guidance, or to understand historical decisions.
+ */
+export interface PredecessorQueryService {
+    /**
+     * Queries a predecessor session of a given role.
+     *
+     * This method:
+     * 1. Finds the most recent suspended/terminated session for the role
+     * 2. Resumes that session using Claude Code's --resume flag
+     * 3. Sends the provided message to the predecessor
+     * 4. Waits for and captures the response
+     * 5. Suspends the predecessor session again
+     * 6. Returns the response
+     *
+     * @param requestingAgentId - The agent making the query
+     * @param role - The role to query (e.g., 'director', 'worker')
+     * @param message - The message/question to send to the predecessor
+     * @param options - Query options
+     * @returns The query result with the predecessor's response
+     */
+    consultPredecessor(requestingAgentId: EntityId, role: AgentRole, message: string, options?: PredecessorQueryOptions): Promise<PredecessorQueryResult>;
+    /**
+     * Gets information about the most recent predecessor for a role.
+     *
+     * This is useful for checking if a predecessor exists before querying,
+     * or for getting context about who held the role previously.
+     *
+     * @param role - The role to find the predecessor for
+     * @returns The predecessor info or undefined if none exists
+     */
+    getPredecessorInfo(role: AgentRole): Promise<PredecessorInfo | undefined>;
+    /**
+     * Checks if a predecessor exists and can be queried for a given role.
+     *
+     * A predecessor is queryable if:
+     * - A previous session exists for the role
+     * - The session was suspended (not terminated) OR has a Claude session ID
+     *
+     * @param role - The role to check
+     * @returns True if a queryable predecessor exists
+     */
+    hasPredecessor(role: AgentRole): Promise<boolean>;
+    /**
+     * Gets the status of an active predecessor query.
+     *
+     * @param queryId - The query ID
+     * @returns The active query or undefined if not found
+     */
+    getActiveQuery(queryId: string): ActivePredecessorQuery | undefined;
+    /**
+     * Lists all active predecessor queries.
+     *
+     * @returns Array of active queries
+     */
+    listActiveQueries(): ActivePredecessorQuery[];
+    /**
+     * Cancels an active predecessor query.
+     *
+     * This will attempt to gracefully stop the resumed predecessor session
+     * and clean up resources.
+     *
+     * @param queryId - The query ID to cancel
+     */
+    cancelQuery(queryId: string): Promise<void>;
+}
+/** Default timeout for predecessor queries (60 seconds) */
+export declare const DEFAULT_QUERY_TIMEOUT_MS = 60000;
+/** Minimum timeout for predecessor queries (10 seconds) */
+export declare const MIN_QUERY_TIMEOUT_MS = 10000;
+/** Maximum timeout for predecessor queries (5 minutes) */
+export declare const MAX_QUERY_TIMEOUT_MS = 300000;
+/**
+ * Implementation of the Predecessor Query Service.
+ */
+export declare class PredecessorQueryServiceImpl implements PredecessorQueryService {
+    private readonly sessionManager;
+    private readonly activeQueries;
+    private queryCounter;
+    constructor(sessionManager: SessionManager);
+    consultPredecessor(requestingAgentId: EntityId, role: AgentRole, message: string, options?: PredecessorQueryOptions): Promise<PredecessorQueryResult>;
+    getPredecessorInfo(role: AgentRole): Promise<PredecessorInfo | undefined>;
+    hasPredecessor(role: AgentRole): Promise<boolean>;
+    getActiveQuery(queryId: string): ActivePredecessorQuery | undefined;
+    listActiveQueries(): ActivePredecessorQuery[];
+    cancelQuery(queryId: string): Promise<void>;
+    private generateQueryId;
+    private normalizeTimeout;
+    private captureResponse;
+}
+/**
+ * Error thrown when a predecessor query times out
+ */
+export declare class TimeoutError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when no predecessor is found for a role
+ */
+export declare class NoPredecessorError extends Error {
+    constructor(role: AgentRole);
+}
+/**
+ * Creates a PredecessorQueryService instance
+ */
+export declare function createPredecessorQueryService(sessionManager: SessionManager): PredecessorQueryService;
+//# sourceMappingURL=predecessor-query.d.ts.map

package/dist/runtime/predecessor-query.d.ts.map

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