sylas-opencode-runner 0.2.21

package/dist/adapters.d.ts

@@ -0,0 +1,245 @@
+/**
+ * OpenCode Event Adapters
+ *
+ * Converts OpenCode SSE events to SDKMessage format for compatibility
+ * with the Sylas infrastructure. Follows the adapter pattern used in gemini-runner.
+ *
+ * @packageDocumentation
+ */
+import type { AssistantMessage, Event, EventMessagePartUpdated, EventMessageUpdated, EventSessionError, EventSessionIdle, EventSessionStatus, Part, TextPart, ToolPart, ToolStateCompleted, ToolStateError } from "@opencode-ai/sdk";
+import type { SDKAssistantMessage, SDKMessage, SDKResultMessage, SDKUserMessage } from "sylas-core";
+/**
+ * Accumulated message state for building complete messages from parts.
+ */
+export interface AccumulatedMessage {
+    messageId: string;
+    sessionId: string;
+    role: "user" | "assistant";
+    contentBlocks: Array<{
+        type: "text" | "tool_use" | "tool_result";
+        id?: string;
+        text?: string;
+        name?: string;
+        input?: Record<string, unknown>;
+        tool_use_id?: string;
+        content?: string;
+        is_error?: boolean;
+    }>;
+    tokenMetrics?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/**
+ * OpenCode event that we process - a subset of all Event types.
+ */
+export type ProcessableEvent = EventMessagePartUpdated | EventMessageUpdated | EventSessionIdle | EventSessionError | EventSessionStatus;
+/**
+ * CLI events are structurally different from SDK SSE events:
+ *   SDK:  { type: "message.part.updated", properties: { part: {...} } }
+ *   CLI:  { type: "text", sessionID: "ses_...", timestamp: 123, ... }
+ *
+ * The CLI outputs newline-delimited JSON with these event types:
+ *   step_start, text, tool_use, step_finish
+ */
+interface CLIEventBase {
+    type: string;
+    timestamp: number;
+    sessionID: string;
+}
+export interface CLIStepStartEvent extends CLIEventBase {
+    type: "step_start";
+    part?: {
+        id?: string;
+        sessionID?: string;
+        messageID?: string;
+    };
+}
+export interface CLITextEvent extends CLIEventBase {
+    type: "text";
+    content?: string;
+    part?: {
+        id?: string;
+        sessionID?: string;
+        messageID?: string;
+        type?: string;
+        text?: string;
+    };
+}
+export interface CLIToolUseEvent extends CLIEventBase {
+    type: "tool_use";
+    part?: {
+        id?: string;
+        sessionID?: string;
+        messageID?: string;
+        type?: string;
+        tool?: string;
+        callID?: string;
+        state?: {
+            status?: string;
+            input?: Record<string, unknown>;
+            output?: string;
+            error?: string;
+        };
+    };
+}
+export interface CLIStepFinishEvent extends CLIEventBase {
+    type: "step_finish";
+    part?: {
+        id?: string;
+        sessionID?: string;
+        messageID?: string;
+    };
+}
+export type CLIEvent = CLIStepStartEvent | CLITextEvent | CLIToolUseEvent | CLIStepFinishEvent;
+export declare function isCLIEvent(event: unknown): event is CLIEvent;
+export declare function isCLIStepStart(event: CLIEvent): event is CLIStepStartEvent;
+export declare function isCLIText(event: CLIEvent): event is CLITextEvent;
+export declare function isCLIToolUse(event: CLIEvent): event is CLIToolUseEvent;
+export declare function isCLIStepFinish(event: CLIEvent): event is CLIStepFinishEvent;
+/**
+ * Check if event is a message part update.
+ */
+export declare function isMessagePartUpdated(event: Event): event is EventMessagePartUpdated;
+/**
+ * Check if event is a message update.
+ */
+export declare function isMessageUpdated(event: Event): event is EventMessageUpdated;
+/**
+ * Check if event is a session idle event.
+ */
+export declare function isSessionIdle(event: Event): event is EventSessionIdle;
+/**
+ * Check if event is a session error event.
+ */
+export declare function isSessionError(event: Event): event is EventSessionError;
+/**
+ * Check if event is a session status event.
+ */
+export declare function isSessionStatus(event: Event): event is EventSessionStatus;
+/**
+ * Check if a part is a text part.
+ */
+export declare function isTextPart(part: Part): part is TextPart;
+/**
+ * Check if a part is a tool part.
+ */
+export declare function isToolPart(part: Part): part is ToolPart;
+/**
+ * Check if tool state is completed.
+ */
+export declare function isToolStateCompleted(state: ToolPart["state"]): state is ToolStateCompleted;
+/**
+ * Check if tool state is error.
+ */
+export declare function isToolStateError(state: ToolPart["state"]): state is ToolStateError;
+/**
+ * Convert an OpenCode TextPart to SDK text content block.
+ */
+export declare function textPartToContentBlock(part: TextPart): {
+    type: "text";
+    text: string;
+};
+/**
+ * Convert an OpenCode ToolPart to SDK tool_use content block.
+ *
+ * Note: Only tool parts in "running" or later states have meaningful data.
+ * "pending" state may have incomplete input (raw JSON string).
+ */
+export declare function toolPartToToolUseBlock(part: ToolPart): {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+};
+/**
+ * Convert a completed ToolPart to SDK tool_result content block.
+ *
+ * This is used when we need to emit the tool result as a user message.
+ */
+export declare function toolPartToToolResultBlock(part: ToolPart): {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    is_error: boolean;
+};
+/**
+ * Convert an OpenCode message part update event to SDK message.
+ *
+ * This handles individual part updates as they stream in.
+ * The caller is responsible for accumulating parts into complete messages.
+ *
+ * @param event - The message.part.updated event
+ * @param sessionId - Current session ID
+ * @returns SDKMessage or null if part type doesn't map to a message
+ */
+export declare function partEventToSDKMessage(event: EventMessagePartUpdated, sessionId: string | null): SDKMessage | null;
+/**
+ * Convert an OpenCode message update event to SDK message.
+ *
+ * This handles complete message updates (not individual parts).
+ *
+ * @param event - The message.updated event
+ * @param sessionId - Current session ID
+ * @returns SDKMessage or null
+ */
+export declare function messageEventToSDKMessage(event: EventMessageUpdated, sessionId: string | null): SDKMessage | null;
+/**
+ * Synthesize an SDKResultMessage from completion state.
+ *
+ * OpenCode doesn't have a dedicated result message - we synthesize from:
+ * - AssistantMessage.finish === "stop"
+ * - AssistantMessage.time.completed set
+ * - session.idle event
+ *
+ * @param sessionId - Current session ID
+ * @param lastAssistantMessage - Last assistant message for content extraction
+ * @param assistantInfo - Optional AssistantMessage info for token metrics
+ * @returns SDKResultMessage
+ */
+export declare function synthesizeResultMessage(sessionId: string | null, lastAssistantMessage?: SDKAssistantMessage | null, assistantInfo?: AssistantMessage | null): SDKResultMessage;
+/**
+ * Convert a session error event to SDKResultMessage.
+ *
+ * @param event - The session.error event
+ * @param sessionId - Current session ID
+ * @returns SDKResultMessage with error info
+ */
+export declare function errorEventToSDKMessage(event: EventSessionError, sessionId: string | null): SDKResultMessage;
+/**
+ * Convert an OpenCode event to sylas-core SDKMessage format.
+ *
+ * This adapter maps OpenCode's SSE events to the sylas-core SDKMessage format,
+ * allowing OpenCodeRunner to implement the IAgentRunner interface.
+ *
+ * NOTE: This adapter is stateless for most events. For complete message
+ * accumulation, the caller (OpenCodeRunner) should track parts and build
+ * complete messages.
+ *
+ * @param event - OpenCode SSE event
+ * @param sessionId - Current session ID (may be null initially)
+ * @param lastAssistantMessage - Last assistant message for result coercion (optional)
+ * @param lastAssistantInfo - Last assistant message info for metrics (optional)
+ * @returns SDKMessage or null if event type doesn't map to a message
+ */
+export declare function openCodeEventToSDKMessage(event: Event, sessionId: string | null, lastAssistantMessage?: SDKAssistantMessage | null, lastAssistantInfo?: AssistantMessage | null): SDKMessage | null;
+/**
+ * Extract session ID from an OpenCode event.
+ *
+ * @param event - OpenCode event
+ * @returns Session ID if available, null otherwise
+ */
+export declare function extractSessionId(event: Event): string | null;
+/**
+ * Create a Sylas Core SDK UserMessage from a plain string prompt.
+ *
+ * Helper function to create properly formatted SDKUserMessage objects
+ * for sending to OpenCode.
+ *
+ * @param content - The prompt text
+ * @param sessionId - Current session ID (may be null for initial message)
+ * @returns Formatted SDKUserMessage
+ */
+export declare function createUserMessage(content: string, sessionId: string | null): SDKUserMessage;
+export {};
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

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