@octavus/server-sdk 2.0.0 → 2.2.0

package/dist/index.d.ts

@@ -103,6 +103,19 @@ interface ContinueRequest {
 }
 /** All request types supported by the session */
 type SessionRequest = TriggerRequest | ContinueRequest;
+/** Stop message to abort in-flight requests */
+interface StopMessage {
+    type: 'stop';
+}
+/** All socket protocol messages (trigger, continue, stop) */
+type SocketMessage = TriggerRequest | ContinueRequest | StopMessage;
+/** Handlers for socket message streaming */
+interface SocketMessageHandlers {
+    /** Called for each stream event */
+    onEvent: (event: StreamEvent) => void;
+    /** Called after streaming completes (not called if aborted) */
+    onFinish?: () => void | Promise<void>;
+}
 /**
  * Converts an async iterable of stream events to an SSE-formatted ReadableStream.
  * Use this when you need to return an SSE response (e.g., HTTP endpoints).
@@ -135,6 +148,7 @@ declare class AgentSession {
     private config;
     private toolHandlers;
     private resourceMap;
+    private socketAbortController;
     constructor(sessionConfig: SessionConfig);
     /**
      * Execute a session request and stream the response.
@@ -163,6 +177,21 @@ declare class AgentSession {
      */
     execute(request: SessionRequest, options?: TriggerOptions): AsyncGenerator<StreamEvent>;
     getSessionId(): string;
+    /**
+     * Handle a WebSocket protocol message (trigger, continue, or stop).
+     * Manages abort controller lifecycle internally.
+     *
+     * @example
+     * ```typescript
+     * conn.on('data', (raw) => {
+     *   session.handleSocketMessage(JSON.parse(raw), {
+     *     onEvent: (event) => conn.write(JSON.stringify(event)),
+     *     onFinish: () => sendMessagesUpdate(),
+     *   });
+     * });
+     * ```
+     */
+    handleSocketMessage(message: SocketMessage, handlers: SocketMessageHandlers): Promise<void>;
     private executeStream;
     private handleResourceUpdate;
 }
@@ -332,4 +361,4 @@ declare class OctavusClient {
     getHeaders(): Record<string, string>;
 }
 
-export { type Agent, type AgentDefinition, type AgentFormat, type AgentPrompt, AgentSession, AgentSessionsApi, type AgentSettings, AgentsApi, ApiError, type ContinueRequest, type ExpiredSessionState, type FileUploadInfo, type FileUploadRequest, FilesApi, OctavusClient, type OctavusClientConfig, Resource, type RestoreSessionResult, type SessionAttachOptions, type SessionConfig, type SessionRequest, type SessionState, type SessionStatus, type TriggerOptions, type TriggerRequest, type UISessionState, type UploadUrlsResponse, toSSEStream };
+export { type Agent, type AgentDefinition, type AgentFormat, type AgentPrompt, AgentSession, AgentSessionsApi, type AgentSettings, AgentsApi, ApiError, type ContinueRequest, type ExpiredSessionState, type FileUploadInfo, type FileUploadRequest, FilesApi, OctavusClient, type OctavusClientConfig, Resource, type RestoreSessionResult, type SessionAttachOptions, type SessionConfig, type SessionRequest, type SessionState, type SessionStatus, type SocketMessage, type SocketMessageHandlers, type StopMessage, type TriggerOptions, type TriggerRequest, type UISessionState, type UploadUrlsResponse, toSSEStream };

package/dist/index.js

@@ -165,6 +165,7 @@ var AgentSession = class {
   config;
   toolHandlers;
   resourceMap;
+  socketAbortController = null;
   constructor(sessionConfig) {
     this.sessionId = sessionConfig.sessionId;
     this.config = sessionConfig.config;
@@ -215,6 +216,46 @@ var AgentSession = class {
   getSessionId() {
     return this.sessionId;
   }
+  /**
+   * Handle a WebSocket protocol message (trigger, continue, or stop).
+   * Manages abort controller lifecycle internally.
+   *
+   * @example
+   * ```typescript
+   * conn.on('data', (raw) => {
+   *   session.handleSocketMessage(JSON.parse(raw), {
+   *     onEvent: (event) => conn.write(JSON.stringify(event)),
+   *     onFinish: () => sendMessagesUpdate(),
+   *   });
+   * });
+   * ```
+   */
+  async handleSocketMessage(message, handlers) {
+    if (message.type === "stop") {
+      this.socketAbortController?.abort();
+      return;
+    }
+    this.socketAbortController?.abort();
+    this.socketAbortController = new AbortController();
+    const localController = this.socketAbortController;
+    try {
+      const events = this.execute(message, { signal: localController.signal });
+      for await (const event of events) {
+        if (localController.signal.aborted) break;
+        handlers.onEvent(event);
+      }
+      if (!localController.signal.aborted && handlers.onFinish) {
+        await handlers.onFinish();
+      }
+    } catch (err) {
+      if (!localController.signal.aborted) {
+        const errorEvent = createInternalErrorEvent(
+          err instanceof Error ? err.message : "Unknown error"
+        );
+        handlers.onEvent(errorEvent);
+      }
+    }
+  }
   async *executeStream(payload, signal) {
     let toolResults = payload.toolResults;
     let executionId = payload.executionId;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/api-error.ts","../src/base-api-client.ts","../src/agent-types.ts","../src/agents.ts","../src/agent-sessions.ts","../src/session.ts","../src/files.ts","../src/client.ts","../src/resource.ts","../src/index.ts"],"sourcesContent":["import { z } from 'zod';\n\nconst ApiErrorResponseSchema = z.object({\n  error: z.string().optional(),\n  message: z.string().optional(),\n  code: z.string().optional(),\n});\n\n/**\n * Error thrown when API request fails\n */\nexport class ApiError extends Error {\n  constructor(\n    message: string,\n    public status: number,\n    public code?: string,\n  ) {\n    super(message);\n    this.name = 'ApiError';\n  }\n}\n\ninterface ParsedApiError {\n  message: string;\n  code?: string;\n}\n\n/**\n * Parse error from API response using Zod\n */\nexport async function parseApiError(\n  response: Response,\n  defaultMessage: string,\n): Promise<ParsedApiError> {\n  const fallbackMessage = `${defaultMessage}: ${response.statusText}`;\n\n  try {\n    const json: unknown = await response.json();\n    const parsed = ApiErrorResponseSchema.safeParse(json);\n\n    if (parsed.success) {\n      return {\n        message: parsed.data.error ?? parsed.data.message ?? fallbackMessage,\n        code: parsed.data.code,\n      };\n    }\n  } catch {\n    // Use default message\n  }\n\n  return { message: fallbackMessage };\n}\n\n/**\n * Parse error from API response and throw ApiError\n */\nexport async function throwApiError(response: Response, defaultMessage: string): Promise<never> {\n  const { message, code } = await parseApiError(response, defaultMessage);\n  throw new ApiError(message, response.status, code);\n}\n","import type { ZodType } from 'zod';\nimport { throwApiError } from '@/api-error.js';\n\nexport { ApiError } from '@/api-error.js';\n\nexport interface ApiClientConfig {\n  baseUrl: string;\n  getHeaders: () => Record<string, string>;\n}\n\n/** Base class for API clients with shared HTTP utilities */\nexport abstract class BaseApiClient {\n  protected readonly config: ApiClientConfig;\n\n  constructor(config: ApiClientConfig) {\n    this.config = config;\n  }\n\n  protected async httpGet<T>(path: string, schema: ZodType<T>): Promise<T> {\n    const response = await fetch(`${this.config.baseUrl}${path}`, {\n      method: 'GET',\n      headers: this.config.getHeaders(),\n    });\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n    return schema.parse(data);\n  }\n\n  protected async httpPost<T>(path: string, body: unknown, schema: ZodType<T>): Promise<T> {\n    const response = await fetch(`${this.config.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.config.getHeaders(),\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n    return schema.parse(data);\n  }\n\n  protected async httpPatch<T>(path: string, body: unknown, schema: ZodType<T>): Promise<T> {\n    const response = await fetch(`${this.config.baseUrl}${path}`, {\n      method: 'PATCH',\n      headers: this.config.getHeaders(),\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n    return schema.parse(data);\n  }\n}\n","import { z } from 'zod';\n\n/** Agent format - interactive (chat) or worker (background task) */\nexport type AgentFormat = 'interactive' | 'worker';\n\n/** Agent settings */\nexport interface AgentSettings {\n  slug: string;\n  name: string;\n  description?: string;\n  format: AgentFormat;\n}\n\n/** Agent prompt */\nexport interface AgentPrompt {\n  name: string;\n  content: string;\n}\n\n/**\n * Agent summary returned from list endpoint\n */\nexport interface Agent {\n  /** Agent slug (human-readable identifier within project) */\n  slug: string;\n  /** Agent ID - use this for API calls */\n  id: string;\n  name: string;\n  description: string | null;\n  format: AgentFormat;\n  createdAt: string;\n  updatedAt: string;\n  projectId: string;\n}\n\n/**\n * Full agent definition returned from get endpoint\n */\nexport interface AgentDefinition {\n  settings: AgentSettings;\n  protocol: string;\n  prompts: AgentPrompt[];\n  /** Agent ID - use this for API calls like createSession */\n  id: string;\n}\n\n// Schemas\n\nexport const agentFormatSchema = z.enum(['interactive', 'worker']);\n\nconst agentSettingsSchema = z.object({\n  slug: z.string(),\n  name: z.string(),\n  description: z.string().optional(),\n  format: agentFormatSchema,\n});\n\nconst agentPromptSchema = z.object({\n  name: z.string(),\n  content: z.string(),\n});\n\nexport const agentSchema = z.object({\n  slug: z.string(),\n  id: z.string(),\n  name: z.string(),\n  description: z.string().nullable(),\n  format: agentFormatSchema,\n  createdAt: z.string(),\n  updatedAt: z.string(),\n  projectId: z.string(),\n});\n\nexport const agentsResponseSchema = z.object({\n  agents: z.array(agentSchema),\n});\n\nexport const agentDefinitionSchema = z.object({\n  settings: agentSettingsSchema,\n  protocol: z.string(),\n  prompts: z.array(agentPromptSchema),\n  id: z.string(),\n});\n","import { BaseApiClient } from '@/base-api-client.js';\nimport {\n  agentsResponseSchema,\n  agentDefinitionSchema,\n  type Agent,\n  type AgentDefinition,\n} from '@/agent-types.js';\n\n/**\n * API for listing and retrieving agent definitions.\n *\n * Note: Agent management (create, update, sync) should be done via the @octavus/cli package.\n * This API uses agent IDs only - use CLI for slug-based operations.\n */\nexport class AgentsApi extends BaseApiClient {\n  /** List all agents in the project */\n  async list(): Promise<Agent[]> {\n    const response = await this.httpGet('/api/agents', agentsResponseSchema);\n    return response.agents;\n  }\n\n  /** Get a single agent by ID */\n  async get(agentId: string): Promise<AgentDefinition> {\n    return await this.httpGet(`/api/agents/${agentId}`, agentDefinitionSchema);\n  }\n}\n","import { z } from 'zod';\nimport {\n  chatMessageSchema,\n  uiMessageSchema,\n  type ChatMessage,\n  type ToolHandlers,\n  type UIMessage,\n} from '@octavus/core';\nimport { BaseApiClient } from '@/base-api-client.js';\nimport { throwApiError } from '@/api-error.js';\nimport { AgentSession } from '@/session.js';\nimport type { Resource } from '@/resource.js';\n\nconst createSessionResponseSchema = z.object({\n  sessionId: z.string(),\n});\n\nconst sessionStateSchema = z.object({\n  id: z.string(),\n  agentId: z.string(),\n  input: z.record(z.string(), z.unknown()),\n  variables: z.record(z.string(), z.unknown()),\n  resources: z.record(z.string(), z.unknown()),\n  messages: z.array(chatMessageSchema),\n  status: z.literal('active').optional(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n});\n\nconst uiSessionResponseSchema = z.object({\n  sessionId: z.string(),\n  agentId: z.string(),\n  messages: z.array(uiMessageSchema),\n  status: z.literal('active').optional(),\n});\n\nconst expiredSessionResponseSchema = z.object({\n  sessionId: z.string(),\n  agentId: z.string(),\n  status: z.literal('expired'),\n  createdAt: z.string(),\n});\n\nconst restoreSessionResponseSchema = z.object({\n  sessionId: z.string(),\n  restored: z.boolean(),\n});\n\n/** Session status indicating whether it's active or expired */\nexport type SessionStatus = 'active' | 'expired';\n\nexport interface SessionState {\n  id: string;\n  agentId: string;\n  input: Record<string, unknown>;\n  variables: Record<string, unknown>;\n  resources: Record<string, unknown>;\n  messages: ChatMessage[];\n  status?: 'active';\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface UISessionState {\n  sessionId: string;\n  agentId: string;\n  messages: UIMessage[];\n  status?: 'active';\n}\n\nexport interface ExpiredSessionState {\n  sessionId: string;\n  agentId: string;\n  status: 'expired';\n  createdAt: string;\n}\n\nexport interface RestoreSessionResult {\n  sessionId: string;\n  /** True if session was restored from messages, false if already active */\n  restored: boolean;\n}\n\nexport interface SessionAttachOptions {\n  tools?: ToolHandlers;\n  resources?: Resource[];\n}\n\n/** API for managing agent sessions */\nexport class AgentSessionsApi extends BaseApiClient {\n  /** Create a new session for an agent */\n  async create(agentId: string, input?: Record<string, unknown>): Promise<string> {\n    const response = await this.httpPost(\n      '/api/agent-sessions',\n      { agentId, input },\n      createSessionResponseSchema,\n    );\n    return response.sessionId;\n  }\n\n  /**\n   * Get full session state (for internal/debug use)\n   * Note: Contains all messages including hidden content\n   *\n   * Returns SessionState for active sessions, ExpiredSessionState for expired sessions.\n   * Check `status` field to determine which type was returned.\n   */\n  async get(sessionId: string): Promise<SessionState | ExpiredSessionState> {\n    const response = await fetch(`${this.config.baseUrl}/api/agent-sessions/${sessionId}`, {\n      method: 'GET',\n      headers: this.config.getHeaders(),\n    });\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n\n    const expiredResult = expiredSessionResponseSchema.safeParse(data);\n    if (expiredResult.success) {\n      return expiredResult.data;\n    }\n\n    return sessionStateSchema.parse(data);\n  }\n\n  /**\n   * Get UI-ready session messages (for client display)\n   * Returns only visible messages with hidden content filtered out.\n   *\n   * For expired sessions, returns status: 'expired' without messages.\n   * Use restore() to restore from stored messages before continuing.\n   */\n  async getMessages(sessionId: string): Promise<UISessionState | ExpiredSessionState> {\n    const response = await fetch(\n      `${this.config.baseUrl}/api/agent-sessions/${sessionId}?format=ui`,\n      {\n        method: 'GET',\n        headers: this.config.getHeaders(),\n      },\n    );\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n\n    const expiredResult = expiredSessionResponseSchema.safeParse(data);\n    if (expiredResult.success) {\n      return expiredResult.data;\n    }\n\n    return uiSessionResponseSchema.parse(data);\n  }\n\n  /**\n   * Restore an expired session from stored messages.\n   *\n   * Use this to restore a session after its state has expired.\n   * The consumer should have stored the UIMessage[] array from previous interactions.\n   *\n   * @param sessionId - The session ID to restore\n   * @param messages - Previously stored UIMessage[] array\n   * @param input - Optional session input for system prompt interpolation (same as create)\n   * @returns { sessionId, restored: true } if restored, { sessionId, restored: false } if already active\n   */\n  async restore(\n    sessionId: string,\n    messages: UIMessage[],\n    input?: Record<string, unknown>,\n  ): Promise<RestoreSessionResult> {\n    return await this.httpPost(\n      `/api/agent-sessions/${sessionId}/restore`,\n      { messages, input },\n      restoreSessionResponseSchema,\n    );\n  }\n\n  /** Attach to an existing session for triggering events */\n  attach(sessionId: string, options: SessionAttachOptions = {}): AgentSession {\n    return new AgentSession({\n      sessionId,\n      config: this.config,\n      tools: options.tools,\n      resources: options.resources,\n    });\n  }\n}\n","import {\n  safeParseStreamEvent,\n  isAbortError,\n  createInternalErrorEvent,\n  createApiErrorEvent,\n  type StreamEvent,\n  type ToolHandlers,\n  type PendingToolCall,\n  type ToolResult,\n} from '@octavus/core';\nimport { parseApiError } from '@/api-error.js';\nimport type { ApiClientConfig } from '@/base-api-client.js';\nimport type { Resource } from '@/resource.js';\n\n// =============================================================================\n// Request Types\n// =============================================================================\n\n/** Start a new trigger execution */\nexport interface TriggerRequest {\n  type: 'trigger';\n  triggerName: string;\n  input?: Record<string, unknown>;\n}\n\n/** Continue execution after client-side tool handling */\nexport interface ContinueRequest {\n  type: 'continue';\n  executionId: string;\n  toolResults: ToolResult[];\n}\n\n/** All request types supported by the session */\nexport type SessionRequest = TriggerRequest | ContinueRequest;\n\n/**\n * Converts an async iterable of stream events to an SSE-formatted ReadableStream.\n * Use this when you need to return an SSE response (e.g., HTTP endpoints).\n *\n * @example\n * ```typescript\n * const events = session.trigger('user-message', input);\n * return new Response(toSSEStream(events), {\n *   headers: { 'Content-Type': 'text/event-stream' },\n * });\n * ```\n */\nexport function toSSEStream(events: AsyncIterable<StreamEvent>): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder();\n\n  return new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const event of events) {\n          controller.enqueue(encoder.encode(`data: ${JSON.stringify(event)}\\n\\n`));\n        }\n        controller.enqueue(encoder.encode('data: [DONE]\\n\\n'));\n        controller.close();\n      } catch (err) {\n        const errorEvent = createInternalErrorEvent(\n          err instanceof Error ? err.message : 'Unknown error',\n        );\n        controller.enqueue(encoder.encode(`data: ${JSON.stringify(errorEvent)}\\n\\n`));\n        controller.close();\n      }\n    },\n  });\n}\n\nexport interface SessionConfig {\n  sessionId: string;\n  config: ApiClientConfig;\n  tools?: ToolHandlers;\n  resources?: Resource[];\n}\n\n/**\n * Options for trigger execution.\n */\nexport interface TriggerOptions {\n  /** Abort signal to cancel the trigger execution */\n  signal?: AbortSignal;\n}\n\n/** Handles streaming and tool continuation for agent sessions */\nexport class AgentSession {\n  private sessionId: string;\n  private config: ApiClientConfig;\n  private toolHandlers: ToolHandlers;\n  private resourceMap: Map<string, Resource>;\n\n  constructor(sessionConfig: SessionConfig) {\n    this.sessionId = sessionConfig.sessionId;\n    this.config = sessionConfig.config;\n    this.toolHandlers = sessionConfig.tools ?? {};\n    this.resourceMap = new Map();\n\n    // Index resources by name for fast lookup\n    for (const resource of sessionConfig.resources ?? []) {\n      this.resourceMap.set(resource.name, resource);\n    }\n  }\n\n  /**\n   * Execute a session request and stream the response.\n   *\n   * This is the unified method that handles both triggers and continuations.\n   * Use this when you want to pass through requests from the client directly.\n   *\n   * @param request - The request (check `request.type` for the kind)\n   * @param options - Optional configuration including abort signal\n   *\n   * @example HTTP route (simple passthrough)\n   * ```typescript\n   * const events = session.execute(body, { signal: request.signal });\n   * return new Response(toSSEStream(events));\n   * ```\n   *\n   * @example WebSocket handler\n   * ```typescript\n   * socket.on('message', (data) => {\n   *   const events = session.execute(data);\n   *   for await (const event of events) {\n   *     socket.send(JSON.stringify(event));\n   *   }\n   * });\n   * ```\n   */\n  async *execute(request: SessionRequest, options?: TriggerOptions): AsyncGenerator<StreamEvent> {\n    if (request.type === 'continue') {\n      yield* this.executeStream(\n        { executionId: request.executionId, toolResults: request.toolResults },\n        options?.signal,\n      );\n    } else {\n      yield* this.executeStream(\n        { triggerName: request.triggerName, input: request.input },\n        options?.signal,\n      );\n    }\n  }\n\n  getSessionId(): string {\n    return this.sessionId;\n  }\n\n  private async *executeStream(\n    payload: {\n      triggerName?: string;\n      input?: Record<string, unknown>;\n      executionId?: string;\n      toolResults?: ToolResult[];\n    },\n    signal?: AbortSignal,\n  ): AsyncGenerator<StreamEvent> {\n    let toolResults = payload.toolResults;\n    let executionId = payload.executionId;\n    let continueLoop = true;\n\n    while (continueLoop) {\n      // Check if aborted before making request\n      if (signal?.aborted) {\n        yield { type: 'finish', finishReason: 'stop' };\n        return;\n      }\n\n      // Build request body - only include defined fields\n      const body: Record<string, unknown> = {};\n      if (payload.triggerName !== undefined) body.triggerName = payload.triggerName;\n      if (payload.input !== undefined) body.input = payload.input;\n      if (executionId !== undefined) body.executionId = executionId;\n      if (toolResults !== undefined) body.toolResults = toolResults;\n\n      // Make request to platform\n      let response: Response;\n      try {\n        response = await fetch(\n          `${this.config.baseUrl}/api/agent-sessions/${this.sessionId}/trigger`,\n          {\n            method: 'POST',\n            headers: this.config.getHeaders(),\n            body: JSON.stringify(body),\n            signal,\n          },\n        );\n      } catch (err) {\n        // Handle abort errors gracefully\n        if (isAbortError(err)) {\n          yield { type: 'finish', finishReason: 'stop' };\n          return;\n        }\n        throw err;\n      }\n\n      if (!response.ok) {\n        const { message } = await parseApiError(response, 'Failed to trigger');\n        yield createApiErrorEvent(response.status, message);\n        return;\n      }\n\n      if (!response.body) {\n        yield createInternalErrorEvent('Response body is not readable');\n        return;\n      }\n\n      // Reset tool results for next iteration (executionId persists through the loop)\n      toolResults = undefined;\n\n      // Read and process the SSE stream\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      let buffer = '';\n      let pendingToolCalls: PendingToolCall[] | null = null;\n\n      // Read stream until done\n      let streamDone = false;\n      while (!streamDone) {\n        // Check if aborted during stream reading\n        if (signal?.aborted) {\n          reader.releaseLock();\n          yield { type: 'finish', finishReason: 'stop' };\n          return;\n        }\n\n        let readResult: ReadableStreamReadResult<Uint8Array>;\n        try {\n          readResult = await reader.read();\n        } catch (err) {\n          // Handle abort errors gracefully during read\n          if (isAbortError(err)) {\n            reader.releaseLock();\n            yield { type: 'finish', finishReason: 'stop' };\n            return;\n          }\n          throw err;\n        }\n\n        const { done, value } = readResult;\n\n        if (done) {\n          streamDone = true;\n          continue;\n        }\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ') && line !== 'data: [DONE]') {\n            try {\n              const parsed = safeParseStreamEvent(JSON.parse(line.slice(6)));\n              if (!parsed.success) {\n                // Skip malformed events\n                continue;\n              }\n              const event = parsed.data;\n\n              // Capture executionId from start event\n              if (event.type === 'start' && event.executionId) {\n                executionId = event.executionId;\n              }\n\n              // Handle tool-request - split into server and client tools\n              if (event.type === 'tool-request') {\n                pendingToolCalls = event.toolCalls;\n                // Don't forward tool-request to consumer\n                continue;\n              }\n\n              if (event.type === 'finish') {\n                if (event.finishReason === 'tool-calls' && pendingToolCalls) {\n                  continue;\n                }\n                yield event;\n                continueLoop = false;\n                continue;\n              }\n\n              if (event.type === 'resource-update') {\n                this.handleResourceUpdate(event.name, event.value);\n              }\n\n              yield event;\n            } catch {\n              // Skip malformed JSON\n            }\n          }\n        }\n      }\n\n      // Check if aborted before tool execution\n      if (signal?.aborted) {\n        yield { type: 'finish', finishReason: 'stop' };\n        return;\n      }\n\n      // If we have pending tool calls, split into server and client tools\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        const serverTools = pendingToolCalls.filter((tc) => this.toolHandlers[tc.toolName]);\n        const clientTools = pendingToolCalls.filter((tc) => !this.toolHandlers[tc.toolName]);\n\n        const serverResults = await Promise.all(\n          serverTools.map(async (tc): Promise<ToolResult> => {\n            // Handler is guaranteed to exist since we filtered by handler presence\n            const handler = this.toolHandlers[tc.toolName]!;\n            try {\n              const result = await handler(tc.args);\n              return {\n                toolCallId: tc.toolCallId,\n                toolName: tc.toolName,\n                result,\n                outputVariable: tc.outputVariable,\n                blockIndex: tc.blockIndex,\n              };\n            } catch (err) {\n              return {\n                toolCallId: tc.toolCallId,\n                toolName: tc.toolName,\n                error: err instanceof Error ? err.message : 'Tool execution failed',\n                outputVariable: tc.outputVariable,\n                blockIndex: tc.blockIndex,\n              };\n            }\n          }),\n        );\n\n        // Emit tool-output events for server tools immediately\n        for (const tr of serverResults) {\n          if (tr.error) {\n            yield { type: 'tool-output-error', toolCallId: tr.toolCallId, error: tr.error };\n          } else {\n            yield { type: 'tool-output-available', toolCallId: tr.toolCallId, output: tr.result };\n          }\n        }\n\n        // If there are client tools, emit client-tool-request and stop the loop\n        if (clientTools.length > 0) {\n          if (!executionId) {\n            yield createInternalErrorEvent('Missing executionId for client-tool-request');\n            return;\n          }\n          // Include executionId and server results in event\n          yield {\n            type: 'client-tool-request',\n            executionId,\n            toolCalls: clientTools,\n            serverToolResults: serverResults.length > 0 ? serverResults : undefined,\n          };\n          yield { type: 'finish', finishReason: 'client-tool-calls', executionId };\n          continueLoop = false;\n        } else {\n          // All tools handled server-side, continue loop\n          toolResults = serverResults;\n        }\n      } else {\n        // No pending tools, we're done\n        continueLoop = false;\n      }\n    }\n  }\n\n  private handleResourceUpdate(name: string, value: unknown): void {\n    const resource = this.resourceMap.get(name);\n    if (resource) {\n      void resource.onUpdate(value);\n    }\n  }\n}\n","import { z } from 'zod';\nimport { BaseApiClient } from '@/base-api-client.js';\n\n// =============================================================================\n// Schemas\n// =============================================================================\n\n/**\n * Schema for a single file upload request\n */\nexport const fileUploadRequestSchema = z.object({\n  filename: z.string().min(1).max(255),\n  mediaType: z.string().min(1),\n  size: z.number().int().positive(),\n});\n\n/**\n * Schema for a single file upload response\n */\nexport const fileUploadInfoSchema = z.object({\n  /** File ID to reference in messages */\n  id: z.string(),\n  /** Presigned PUT URL for uploading to S3 */\n  uploadUrl: z.url(),\n  /** Presigned GET URL for downloading after upload */\n  downloadUrl: z.url(),\n});\n\n/**\n * Schema for the upload URLs response\n */\nexport const uploadUrlsResponseSchema = z.object({\n  files: z.array(fileUploadInfoSchema),\n});\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type FileUploadRequest = z.infer<typeof fileUploadRequestSchema>;\nexport type FileUploadInfo = z.infer<typeof fileUploadInfoSchema>;\nexport type UploadUrlsResponse = z.infer<typeof uploadUrlsResponseSchema>;\n\n// =============================================================================\n// API\n// =============================================================================\n\n/**\n * API for file operations.\n *\n * Provides methods to generate presigned URLs for file uploads.\n * Files are uploaded directly to S3, not through the platform.\n *\n * @example\n * ```typescript\n * // Get upload URLs\n * const { files } = await client.files.getUploadUrls(sessionId, [\n *   { filename: 'image.png', mediaType: 'image/png', size: 12345 }\n * ]);\n *\n * // Upload directly to S3\n * await fetch(files[0].uploadUrl, {\n *   method: 'PUT',\n *   body: imageFile,\n *   headers: { 'Content-Type': 'image/png' }\n * });\n *\n * // Use downloadUrl as FileReference in trigger input\n * ```\n */\nexport class FilesApi extends BaseApiClient {\n  /**\n   * Get presigned URLs for uploading files to a session.\n   *\n   * Returns upload URLs (PUT) and download URLs (GET) for each file.\n   * Upload URLs expire in 15 minutes, download URLs match session TTL (24 hours).\n   *\n   * @param sessionId - The session ID to associate files with\n   * @param files - Array of file metadata (filename, mediaType, size)\n   * @returns Upload info with presigned URLs for each file\n   *\n   * @throws ApiError if session doesn't exist or validation fails\n   *\n   * @example\n   * ```typescript\n   * const { files } = await client.files.getUploadUrls(sessionId, [\n   *   { filename: 'photo.jpg', mediaType: 'image/jpeg', size: 102400 },\n   *   { filename: 'doc.pdf', mediaType: 'application/pdf', size: 204800 },\n   * ]);\n   *\n   * // files[0].id - Use in FileReference\n   * // files[0].uploadUrl - PUT to this URL\n   * // files[0].downloadUrl - Use as FileReference.url\n   * ```\n   */\n  async getUploadUrls(sessionId: string, files: FileUploadRequest[]): Promise<UploadUrlsResponse> {\n    return await this.httpPost(\n      '/api/files/upload-urls',\n      { sessionId, files },\n      uploadUrlsResponseSchema,\n    );\n  }\n}\n","import type { ApiClientConfig } from '@/base-api-client.js';\nimport { AgentsApi } from '@/agents.js';\nimport { AgentSessionsApi } from '@/agent-sessions.js';\nimport { FilesApi } from '@/files.js';\n\nexport interface OctavusClientConfig {\n  baseUrl: string;\n  apiKey?: string;\n}\n\n/** Client for interacting with the Octavus platform API */\nexport class OctavusClient {\n  readonly agents: AgentsApi;\n  readonly agentSessions: AgentSessionsApi;\n  readonly files: FilesApi;\n  readonly baseUrl: string;\n  private readonly apiKey?: string;\n\n  constructor(config: OctavusClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, '');\n    this.apiKey = config.apiKey;\n\n    const apiConfig: ApiClientConfig = {\n      baseUrl: this.baseUrl,\n      getHeaders: () => this.getHeaders(),\n    };\n\n    this.agents = new AgentsApi(apiConfig);\n    this.agentSessions = new AgentSessionsApi(apiConfig);\n    this.files = new FilesApi(apiConfig);\n  }\n\n  getHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    };\n\n    if (this.apiKey) {\n      headers.Authorization = `Bearer ${this.apiKey}`;\n    }\n\n    return headers;\n  }\n}\n","/**\n * Base class for agent-managed resources.\n * Extend this class to define how each resource should be persisted when the agent updates it.\n */\nexport abstract class Resource {\n  /** The resource name as defined in the agent protocol */\n  abstract readonly name: string;\n\n  /** Called when the agent updates this resource */\n  abstract onUpdate(value: unknown): Promise<void> | void;\n}\n","export { OctavusClient, type OctavusClientConfig } from '@/client.js';\nexport { AgentsApi } from '@/agents.js';\nexport {\n  AgentSessionsApi,\n  type SessionState,\n  type UISessionState,\n  type ExpiredSessionState,\n  type RestoreSessionResult,\n  type SessionStatus,\n  type SessionAttachOptions,\n} from '@/agent-sessions.js';\nexport {\n  FilesApi,\n  type FileUploadRequest,\n  type FileUploadInfo,\n  type UploadUrlsResponse,\n} from '@/files.js';\nexport {\n  AgentSession,\n  toSSEStream,\n  type SessionConfig,\n  type TriggerOptions,\n  type SessionRequest,\n  type TriggerRequest,\n  type ContinueRequest,\n} from '@/session.js';\nexport { Resource } from '@/resource.js';\nexport { ApiError } from '@/api-error.js';\n\n// Agent types (read-only - use @octavus/cli for agent management)\nexport type {\n  AgentFormat,\n  AgentSettings,\n  AgentPrompt,\n  Agent,\n  AgentDefinition,\n} from '@/agent-types.js';\n\nexport type * from '@octavus/core';\nexport {\n  // Error classes\n  AppError,\n  NotFoundError,\n  ValidationError,\n  ConflictError,\n  ForbiddenError,\n  OctavusError,\n  // Error type guards\n  isRateLimitError,\n  isAuthenticationError,\n  isProviderError,\n  isToolError,\n  isRetryableError,\n  isValidationError,\n  // Error event helpers\n  createErrorEvent,\n  errorToStreamEvent,\n  createInternalErrorEvent,\n  createApiErrorEvent,\n  // Utilities\n  generateId,\n  isAbortError,\n  // Thread helpers\n  MAIN_THREAD,\n  resolveThread,\n  isMainThread,\n  threadForPart,\n  isOtherThread,\n  // Type guards\n  isFileReference,\n  isFileReferenceArray,\n  // Safe parse helpers\n  safeParseStreamEvent,\n  safeParseUIMessage,\n  safeParseUIMessages,\n  // Skills\n  OCTAVUS_SKILL_TOOLS,\n  isOctavusSkillTool,\n  getSkillSlugFromToolCall,\n} from '@octavus/core';\n"],"mappings":"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","names":["z","z","z","z","z","createInternalErrorEvent","createApiErrorEvent","isAbortError","safeParseStreamEvent"]}
+{"version":3,"sources":["../src/api-error.ts","../src/base-api-client.ts","../src/agent-types.ts","../src/agents.ts","../src/agent-sessions.ts","../src/session.ts","../src/files.ts","../src/client.ts","../src/resource.ts","../src/index.ts"],"sourcesContent":["import { z } from 'zod';\n\nconst ApiErrorResponseSchema = z.object({\n  error: z.string().optional(),\n  message: z.string().optional(),\n  code: z.string().optional(),\n});\n\n/**\n * Error thrown when API request fails\n */\nexport class ApiError extends Error {\n  constructor(\n    message: string,\n    public status: number,\n    public code?: string,\n  ) {\n    super(message);\n    this.name = 'ApiError';\n  }\n}\n\ninterface ParsedApiError {\n  message: string;\n  code?: string;\n}\n\n/**\n * Parse error from API response using Zod\n */\nexport async function parseApiError(\n  response: Response,\n  defaultMessage: string,\n): Promise<ParsedApiError> {\n  const fallbackMessage = `${defaultMessage}: ${response.statusText}`;\n\n  try {\n    const json: unknown = await response.json();\n    const parsed = ApiErrorResponseSchema.safeParse(json);\n\n    if (parsed.success) {\n      return {\n        message: parsed.data.error ?? parsed.data.message ?? fallbackMessage,\n        code: parsed.data.code,\n      };\n    }\n  } catch {\n    // Use default message\n  }\n\n  return { message: fallbackMessage };\n}\n\n/**\n * Parse error from API response and throw ApiError\n */\nexport async function throwApiError(response: Response, defaultMessage: string): Promise<never> {\n  const { message, code } = await parseApiError(response, defaultMessage);\n  throw new ApiError(message, response.status, code);\n}\n","import type { ZodType } from 'zod';\nimport { throwApiError } from '@/api-error.js';\n\nexport { ApiError } from '@/api-error.js';\n\nexport interface ApiClientConfig {\n  baseUrl: string;\n  getHeaders: () => Record<string, string>;\n}\n\n/** Base class for API clients with shared HTTP utilities */\nexport abstract class BaseApiClient {\n  protected readonly config: ApiClientConfig;\n\n  constructor(config: ApiClientConfig) {\n    this.config = config;\n  }\n\n  protected async httpGet<T>(path: string, schema: ZodType<T>): Promise<T> {\n    const response = await fetch(`${this.config.baseUrl}${path}`, {\n      method: 'GET',\n      headers: this.config.getHeaders(),\n    });\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n    return schema.parse(data);\n  }\n\n  protected async httpPost<T>(path: string, body: unknown, schema: ZodType<T>): Promise<T> {\n    const response = await fetch(`${this.config.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.config.getHeaders(),\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n    return schema.parse(data);\n  }\n\n  protected async httpPatch<T>(path: string, body: unknown, schema: ZodType<T>): Promise<T> {\n    const response = await fetch(`${this.config.baseUrl}${path}`, {\n      method: 'PATCH',\n      headers: this.config.getHeaders(),\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n    return schema.parse(data);\n  }\n}\n","import { z } from 'zod';\n\n/** Agent format - interactive (chat) or worker (background task) */\nexport type AgentFormat = 'interactive' | 'worker';\n\n/** Agent settings */\nexport interface AgentSettings {\n  slug: string;\n  name: string;\n  description?: string;\n  format: AgentFormat;\n}\n\n/** Agent prompt */\nexport interface AgentPrompt {\n  name: string;\n  content: string;\n}\n\n/**\n * Agent summary returned from list endpoint\n */\nexport interface Agent {\n  /** Agent slug (human-readable identifier within project) */\n  slug: string;\n  /** Agent ID - use this for API calls */\n  id: string;\n  name: string;\n  description: string | null;\n  format: AgentFormat;\n  createdAt: string;\n  updatedAt: string;\n  projectId: string;\n}\n\n/**\n * Full agent definition returned from get endpoint\n */\nexport interface AgentDefinition {\n  settings: AgentSettings;\n  protocol: string;\n  prompts: AgentPrompt[];\n  /** Agent ID - use this for API calls like createSession */\n  id: string;\n}\n\n// Schemas\n\nexport const agentFormatSchema = z.enum(['interactive', 'worker']);\n\nconst agentSettingsSchema = z.object({\n  slug: z.string(),\n  name: z.string(),\n  description: z.string().optional(),\n  format: agentFormatSchema,\n});\n\nconst agentPromptSchema = z.object({\n  name: z.string(),\n  content: z.string(),\n});\n\nexport const agentSchema = z.object({\n  slug: z.string(),\n  id: z.string(),\n  name: z.string(),\n  description: z.string().nullable(),\n  format: agentFormatSchema,\n  createdAt: z.string(),\n  updatedAt: z.string(),\n  projectId: z.string(),\n});\n\nexport const agentsResponseSchema = z.object({\n  agents: z.array(agentSchema),\n});\n\nexport const agentDefinitionSchema = z.object({\n  settings: agentSettingsSchema,\n  protocol: z.string(),\n  prompts: z.array(agentPromptSchema),\n  id: z.string(),\n});\n","import { BaseApiClient } from '@/base-api-client.js';\nimport {\n  agentsResponseSchema,\n  agentDefinitionSchema,\n  type Agent,\n  type AgentDefinition,\n} from '@/agent-types.js';\n\n/**\n * API for listing and retrieving agent definitions.\n *\n * Note: Agent management (create, update, sync) should be done via the @octavus/cli package.\n * This API uses agent IDs only - use CLI for slug-based operations.\n */\nexport class AgentsApi extends BaseApiClient {\n  /** List all agents in the project */\n  async list(): Promise<Agent[]> {\n    const response = await this.httpGet('/api/agents', agentsResponseSchema);\n    return response.agents;\n  }\n\n  /** Get a single agent by ID */\n  async get(agentId: string): Promise<AgentDefinition> {\n    return await this.httpGet(`/api/agents/${agentId}`, agentDefinitionSchema);\n  }\n}\n","import { z } from 'zod';\nimport {\n  chatMessageSchema,\n  uiMessageSchema,\n  type ChatMessage,\n  type ToolHandlers,\n  type UIMessage,\n} from '@octavus/core';\nimport { BaseApiClient } from '@/base-api-client.js';\nimport { throwApiError } from '@/api-error.js';\nimport { AgentSession } from '@/session.js';\nimport type { Resource } from '@/resource.js';\n\nconst createSessionResponseSchema = z.object({\n  sessionId: z.string(),\n});\n\nconst sessionStateSchema = z.object({\n  id: z.string(),\n  agentId: z.string(),\n  input: z.record(z.string(), z.unknown()),\n  variables: z.record(z.string(), z.unknown()),\n  resources: z.record(z.string(), z.unknown()),\n  messages: z.array(chatMessageSchema),\n  status: z.literal('active').optional(),\n  createdAt: z.string(),\n  updatedAt: z.string(),\n});\n\nconst uiSessionResponseSchema = z.object({\n  sessionId: z.string(),\n  agentId: z.string(),\n  messages: z.array(uiMessageSchema),\n  status: z.literal('active').optional(),\n});\n\nconst expiredSessionResponseSchema = z.object({\n  sessionId: z.string(),\n  agentId: z.string(),\n  status: z.literal('expired'),\n  createdAt: z.string(),\n});\n\nconst restoreSessionResponseSchema = z.object({\n  sessionId: z.string(),\n  restored: z.boolean(),\n});\n\n/** Session status indicating whether it's active or expired */\nexport type SessionStatus = 'active' | 'expired';\n\nexport interface SessionState {\n  id: string;\n  agentId: string;\n  input: Record<string, unknown>;\n  variables: Record<string, unknown>;\n  resources: Record<string, unknown>;\n  messages: ChatMessage[];\n  status?: 'active';\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface UISessionState {\n  sessionId: string;\n  agentId: string;\n  messages: UIMessage[];\n  status?: 'active';\n}\n\nexport interface ExpiredSessionState {\n  sessionId: string;\n  agentId: string;\n  status: 'expired';\n  createdAt: string;\n}\n\nexport interface RestoreSessionResult {\n  sessionId: string;\n  /** True if session was restored from messages, false if already active */\n  restored: boolean;\n}\n\nexport interface SessionAttachOptions {\n  tools?: ToolHandlers;\n  resources?: Resource[];\n}\n\n/** API for managing agent sessions */\nexport class AgentSessionsApi extends BaseApiClient {\n  /** Create a new session for an agent */\n  async create(agentId: string, input?: Record<string, unknown>): Promise<string> {\n    const response = await this.httpPost(\n      '/api/agent-sessions',\n      { agentId, input },\n      createSessionResponseSchema,\n    );\n    return response.sessionId;\n  }\n\n  /**\n   * Get full session state (for internal/debug use)\n   * Note: Contains all messages including hidden content\n   *\n   * Returns SessionState for active sessions, ExpiredSessionState for expired sessions.\n   * Check `status` field to determine which type was returned.\n   */\n  async get(sessionId: string): Promise<SessionState | ExpiredSessionState> {\n    const response = await fetch(`${this.config.baseUrl}/api/agent-sessions/${sessionId}`, {\n      method: 'GET',\n      headers: this.config.getHeaders(),\n    });\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n\n    const expiredResult = expiredSessionResponseSchema.safeParse(data);\n    if (expiredResult.success) {\n      return expiredResult.data;\n    }\n\n    return sessionStateSchema.parse(data);\n  }\n\n  /**\n   * Get UI-ready session messages (for client display)\n   * Returns only visible messages with hidden content filtered out.\n   *\n   * For expired sessions, returns status: 'expired' without messages.\n   * Use restore() to restore from stored messages before continuing.\n   */\n  async getMessages(sessionId: string): Promise<UISessionState | ExpiredSessionState> {\n    const response = await fetch(\n      `${this.config.baseUrl}/api/agent-sessions/${sessionId}?format=ui`,\n      {\n        method: 'GET',\n        headers: this.config.getHeaders(),\n      },\n    );\n\n    if (!response.ok) {\n      await throwApiError(response, 'Request failed');\n    }\n\n    const data: unknown = await response.json();\n\n    const expiredResult = expiredSessionResponseSchema.safeParse(data);\n    if (expiredResult.success) {\n      return expiredResult.data;\n    }\n\n    return uiSessionResponseSchema.parse(data);\n  }\n\n  /**\n   * Restore an expired session from stored messages.\n   *\n   * Use this to restore a session after its state has expired.\n   * The consumer should have stored the UIMessage[] array from previous interactions.\n   *\n   * @param sessionId - The session ID to restore\n   * @param messages - Previously stored UIMessage[] array\n   * @param input - Optional session input for system prompt interpolation (same as create)\n   * @returns { sessionId, restored: true } if restored, { sessionId, restored: false } if already active\n   */\n  async restore(\n    sessionId: string,\n    messages: UIMessage[],\n    input?: Record<string, unknown>,\n  ): Promise<RestoreSessionResult> {\n    return await this.httpPost(\n      `/api/agent-sessions/${sessionId}/restore`,\n      { messages, input },\n      restoreSessionResponseSchema,\n    );\n  }\n\n  /** Attach to an existing session for triggering events */\n  attach(sessionId: string, options: SessionAttachOptions = {}): AgentSession {\n    return new AgentSession({\n      sessionId,\n      config: this.config,\n      tools: options.tools,\n      resources: options.resources,\n    });\n  }\n}\n","import {\n  safeParseStreamEvent,\n  isAbortError,\n  createInternalErrorEvent,\n  createApiErrorEvent,\n  type StreamEvent,\n  type ToolHandlers,\n  type PendingToolCall,\n  type ToolResult,\n} from '@octavus/core';\nimport { parseApiError } from '@/api-error.js';\nimport type { ApiClientConfig } from '@/base-api-client.js';\nimport type { Resource } from '@/resource.js';\n\n// =============================================================================\n// Request Types\n// =============================================================================\n\n/** Start a new trigger execution */\nexport interface TriggerRequest {\n  type: 'trigger';\n  triggerName: string;\n  input?: Record<string, unknown>;\n}\n\n/** Continue execution after client-side tool handling */\nexport interface ContinueRequest {\n  type: 'continue';\n  executionId: string;\n  toolResults: ToolResult[];\n}\n\n/** All request types supported by the session */\nexport type SessionRequest = TriggerRequest | ContinueRequest;\n\n/** Stop message to abort in-flight requests */\nexport interface StopMessage {\n  type: 'stop';\n}\n\n/** All socket protocol messages (trigger, continue, stop) */\nexport type SocketMessage = TriggerRequest | ContinueRequest | StopMessage;\n\n// =============================================================================\n// Socket Message Handler Types\n// =============================================================================\n\n/** Handlers for socket message streaming */\nexport interface SocketMessageHandlers {\n  /** Called for each stream event */\n  onEvent: (event: StreamEvent) => void;\n  /** Called after streaming completes (not called if aborted) */\n  onFinish?: () => void | Promise<void>;\n}\n\n/**\n * Converts an async iterable of stream events to an SSE-formatted ReadableStream.\n * Use this when you need to return an SSE response (e.g., HTTP endpoints).\n *\n * @example\n * ```typescript\n * const events = session.trigger('user-message', input);\n * return new Response(toSSEStream(events), {\n *   headers: { 'Content-Type': 'text/event-stream' },\n * });\n * ```\n */\nexport function toSSEStream(events: AsyncIterable<StreamEvent>): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder();\n\n  return new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const event of events) {\n          controller.enqueue(encoder.encode(`data: ${JSON.stringify(event)}\\n\\n`));\n        }\n        controller.enqueue(encoder.encode('data: [DONE]\\n\\n'));\n        controller.close();\n      } catch (err) {\n        const errorEvent = createInternalErrorEvent(\n          err instanceof Error ? err.message : 'Unknown error',\n        );\n        controller.enqueue(encoder.encode(`data: ${JSON.stringify(errorEvent)}\\n\\n`));\n        controller.close();\n      }\n    },\n  });\n}\n\nexport interface SessionConfig {\n  sessionId: string;\n  config: ApiClientConfig;\n  tools?: ToolHandlers;\n  resources?: Resource[];\n}\n\n/**\n * Options for trigger execution.\n */\nexport interface TriggerOptions {\n  /** Abort signal to cancel the trigger execution */\n  signal?: AbortSignal;\n}\n\n/** Handles streaming and tool continuation for agent sessions */\nexport class AgentSession {\n  private sessionId: string;\n  private config: ApiClientConfig;\n  private toolHandlers: ToolHandlers;\n  private resourceMap: Map<string, Resource>;\n  private socketAbortController: AbortController | null = null;\n\n  constructor(sessionConfig: SessionConfig) {\n    this.sessionId = sessionConfig.sessionId;\n    this.config = sessionConfig.config;\n    this.toolHandlers = sessionConfig.tools ?? {};\n    this.resourceMap = new Map();\n\n    // Index resources by name for fast lookup\n    for (const resource of sessionConfig.resources ?? []) {\n      this.resourceMap.set(resource.name, resource);\n    }\n  }\n\n  /**\n   * Execute a session request and stream the response.\n   *\n   * This is the unified method that handles both triggers and continuations.\n   * Use this when you want to pass through requests from the client directly.\n   *\n   * @param request - The request (check `request.type` for the kind)\n   * @param options - Optional configuration including abort signal\n   *\n   * @example HTTP route (simple passthrough)\n   * ```typescript\n   * const events = session.execute(body, { signal: request.signal });\n   * return new Response(toSSEStream(events));\n   * ```\n   *\n   * @example WebSocket handler\n   * ```typescript\n   * socket.on('message', (data) => {\n   *   const events = session.execute(data);\n   *   for await (const event of events) {\n   *     socket.send(JSON.stringify(event));\n   *   }\n   * });\n   * ```\n   */\n  async *execute(request: SessionRequest, options?: TriggerOptions): AsyncGenerator<StreamEvent> {\n    if (request.type === 'continue') {\n      yield* this.executeStream(\n        { executionId: request.executionId, toolResults: request.toolResults },\n        options?.signal,\n      );\n    } else {\n      yield* this.executeStream(\n        { triggerName: request.triggerName, input: request.input },\n        options?.signal,\n      );\n    }\n  }\n\n  getSessionId(): string {\n    return this.sessionId;\n  }\n\n  /**\n   * Handle a WebSocket protocol message (trigger, continue, or stop).\n   * Manages abort controller lifecycle internally.\n   *\n   * @example\n   * ```typescript\n   * conn.on('data', (raw) => {\n   *   session.handleSocketMessage(JSON.parse(raw), {\n   *     onEvent: (event) => conn.write(JSON.stringify(event)),\n   *     onFinish: () => sendMessagesUpdate(),\n   *   });\n   * });\n   * ```\n   */\n  async handleSocketMessage(\n    message: SocketMessage,\n    handlers: SocketMessageHandlers,\n  ): Promise<void> {\n    if (message.type === 'stop') {\n      this.socketAbortController?.abort();\n      return;\n    }\n\n    // Abort any previous request before starting new one\n    this.socketAbortController?.abort();\n    this.socketAbortController = new AbortController();\n\n    // Capture local reference - controller might change if another request comes in\n    const localController = this.socketAbortController;\n\n    try {\n      const events = this.execute(message, { signal: localController.signal });\n\n      for await (const event of events) {\n        if (localController.signal.aborted) break;\n        handlers.onEvent(event);\n      }\n\n      if (!localController.signal.aborted && handlers.onFinish) {\n        await handlers.onFinish();\n      }\n    } catch (err) {\n      if (!localController.signal.aborted) {\n        const errorEvent = createInternalErrorEvent(\n          err instanceof Error ? err.message : 'Unknown error',\n        );\n        handlers.onEvent(errorEvent);\n      }\n    }\n  }\n\n  private async *executeStream(\n    payload: {\n      triggerName?: string;\n      input?: Record<string, unknown>;\n      executionId?: string;\n      toolResults?: ToolResult[];\n    },\n    signal?: AbortSignal,\n  ): AsyncGenerator<StreamEvent> {\n    let toolResults = payload.toolResults;\n    let executionId = payload.executionId;\n    let continueLoop = true;\n\n    while (continueLoop) {\n      // Check if aborted before making request\n      if (signal?.aborted) {\n        yield { type: 'finish', finishReason: 'stop' };\n        return;\n      }\n\n      // Build request body - only include defined fields\n      const body: Record<string, unknown> = {};\n      if (payload.triggerName !== undefined) body.triggerName = payload.triggerName;\n      if (payload.input !== undefined) body.input = payload.input;\n      if (executionId !== undefined) body.executionId = executionId;\n      if (toolResults !== undefined) body.toolResults = toolResults;\n\n      // Make request to platform\n      let response: Response;\n      try {\n        response = await fetch(\n          `${this.config.baseUrl}/api/agent-sessions/${this.sessionId}/trigger`,\n          {\n            method: 'POST',\n            headers: this.config.getHeaders(),\n            body: JSON.stringify(body),\n            signal,\n          },\n        );\n      } catch (err) {\n        // Handle abort errors gracefully\n        if (isAbortError(err)) {\n          yield { type: 'finish', finishReason: 'stop' };\n          return;\n        }\n        throw err;\n      }\n\n      if (!response.ok) {\n        const { message } = await parseApiError(response, 'Failed to trigger');\n        yield createApiErrorEvent(response.status, message);\n        return;\n      }\n\n      if (!response.body) {\n        yield createInternalErrorEvent('Response body is not readable');\n        return;\n      }\n\n      // Reset tool results for next iteration (executionId persists through the loop)\n      toolResults = undefined;\n\n      // Read and process the SSE stream\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      let buffer = '';\n      let pendingToolCalls: PendingToolCall[] | null = null;\n\n      // Read stream until done\n      let streamDone = false;\n      while (!streamDone) {\n        // Check if aborted during stream reading\n        if (signal?.aborted) {\n          reader.releaseLock();\n          yield { type: 'finish', finishReason: 'stop' };\n          return;\n        }\n\n        let readResult: ReadableStreamReadResult<Uint8Array>;\n        try {\n          readResult = await reader.read();\n        } catch (err) {\n          // Handle abort errors gracefully during read\n          if (isAbortError(err)) {\n            reader.releaseLock();\n            yield { type: 'finish', finishReason: 'stop' };\n            return;\n          }\n          throw err;\n        }\n\n        const { done, value } = readResult;\n\n        if (done) {\n          streamDone = true;\n          continue;\n        }\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ') && line !== 'data: [DONE]') {\n            try {\n              const parsed = safeParseStreamEvent(JSON.parse(line.slice(6)));\n              if (!parsed.success) {\n                // Skip malformed events\n                continue;\n              }\n              const event = parsed.data;\n\n              // Capture executionId from start event\n              if (event.type === 'start' && event.executionId) {\n                executionId = event.executionId;\n              }\n\n              // Handle tool-request - split into server and client tools\n              if (event.type === 'tool-request') {\n                pendingToolCalls = event.toolCalls;\n                // Don't forward tool-request to consumer\n                continue;\n              }\n\n              if (event.type === 'finish') {\n                if (event.finishReason === 'tool-calls' && pendingToolCalls) {\n                  continue;\n                }\n                yield event;\n                continueLoop = false;\n                continue;\n              }\n\n              if (event.type === 'resource-update') {\n                this.handleResourceUpdate(event.name, event.value);\n              }\n\n              yield event;\n            } catch {\n              // Skip malformed JSON\n            }\n          }\n        }\n      }\n\n      // Check if aborted before tool execution\n      if (signal?.aborted) {\n        yield { type: 'finish', finishReason: 'stop' };\n        return;\n      }\n\n      // If we have pending tool calls, split into server and client tools\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        const serverTools = pendingToolCalls.filter((tc) => this.toolHandlers[tc.toolName]);\n        const clientTools = pendingToolCalls.filter((tc) => !this.toolHandlers[tc.toolName]);\n\n        const serverResults = await Promise.all(\n          serverTools.map(async (tc): Promise<ToolResult> => {\n            // Handler is guaranteed to exist since we filtered by handler presence\n            const handler = this.toolHandlers[tc.toolName]!;\n            try {\n              const result = await handler(tc.args);\n              return {\n                toolCallId: tc.toolCallId,\n                toolName: tc.toolName,\n                result,\n                outputVariable: tc.outputVariable,\n                blockIndex: tc.blockIndex,\n              };\n            } catch (err) {\n              return {\n                toolCallId: tc.toolCallId,\n                toolName: tc.toolName,\n                error: err instanceof Error ? err.message : 'Tool execution failed',\n                outputVariable: tc.outputVariable,\n                blockIndex: tc.blockIndex,\n              };\n            }\n          }),\n        );\n\n        // Emit tool-output events for server tools immediately\n        for (const tr of serverResults) {\n          if (tr.error) {\n            yield { type: 'tool-output-error', toolCallId: tr.toolCallId, error: tr.error };\n          } else {\n            yield { type: 'tool-output-available', toolCallId: tr.toolCallId, output: tr.result };\n          }\n        }\n\n        // If there are client tools, emit client-tool-request and stop the loop\n        if (clientTools.length > 0) {\n          if (!executionId) {\n            yield createInternalErrorEvent('Missing executionId for client-tool-request');\n            return;\n          }\n          // Include executionId and server results in event\n          yield {\n            type: 'client-tool-request',\n            executionId,\n            toolCalls: clientTools,\n            serverToolResults: serverResults.length > 0 ? serverResults : undefined,\n          };\n          yield { type: 'finish', finishReason: 'client-tool-calls', executionId };\n          continueLoop = false;\n        } else {\n          // All tools handled server-side, continue loop\n          toolResults = serverResults;\n        }\n      } else {\n        // No pending tools, we're done\n        continueLoop = false;\n      }\n    }\n  }\n\n  private handleResourceUpdate(name: string, value: unknown): void {\n    const resource = this.resourceMap.get(name);\n    if (resource) {\n      void resource.onUpdate(value);\n    }\n  }\n}\n","import { z } from 'zod';\nimport { BaseApiClient } from '@/base-api-client.js';\n\n// =============================================================================\n// Schemas\n// =============================================================================\n\n/**\n * Schema for a single file upload request\n */\nexport const fileUploadRequestSchema = z.object({\n  filename: z.string().min(1).max(255),\n  mediaType: z.string().min(1),\n  size: z.number().int().positive(),\n});\n\n/**\n * Schema for a single file upload response\n */\nexport const fileUploadInfoSchema = z.object({\n  /** File ID to reference in messages */\n  id: z.string(),\n  /** Presigned PUT URL for uploading to S3 */\n  uploadUrl: z.url(),\n  /** Presigned GET URL for downloading after upload */\n  downloadUrl: z.url(),\n});\n\n/**\n * Schema for the upload URLs response\n */\nexport const uploadUrlsResponseSchema = z.object({\n  files: z.array(fileUploadInfoSchema),\n});\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type FileUploadRequest = z.infer<typeof fileUploadRequestSchema>;\nexport type FileUploadInfo = z.infer<typeof fileUploadInfoSchema>;\nexport type UploadUrlsResponse = z.infer<typeof uploadUrlsResponseSchema>;\n\n// =============================================================================\n// API\n// =============================================================================\n\n/**\n * API for file operations.\n *\n * Provides methods to generate presigned URLs for file uploads.\n * Files are uploaded directly to S3, not through the platform.\n *\n * @example\n * ```typescript\n * // Get upload URLs\n * const { files } = await client.files.getUploadUrls(sessionId, [\n *   { filename: 'image.png', mediaType: 'image/png', size: 12345 }\n * ]);\n *\n * // Upload directly to S3\n * await fetch(files[0].uploadUrl, {\n *   method: 'PUT',\n *   body: imageFile,\n *   headers: { 'Content-Type': 'image/png' }\n * });\n *\n * // Use downloadUrl as FileReference in trigger input\n * ```\n */\nexport class FilesApi extends BaseApiClient {\n  /**\n   * Get presigned URLs for uploading files to a session.\n   *\n   * Returns upload URLs (PUT) and download URLs (GET) for each file.\n   * Upload URLs expire in 15 minutes, download URLs match session TTL (24 hours).\n   *\n   * @param sessionId - The session ID to associate files with\n   * @param files - Array of file metadata (filename, mediaType, size)\n   * @returns Upload info with presigned URLs for each file\n   *\n   * @throws ApiError if session doesn't exist or validation fails\n   *\n   * @example\n   * ```typescript\n   * const { files } = await client.files.getUploadUrls(sessionId, [\n   *   { filename: 'photo.jpg', mediaType: 'image/jpeg', size: 102400 },\n   *   { filename: 'doc.pdf', mediaType: 'application/pdf', size: 204800 },\n   * ]);\n   *\n   * // files[0].id - Use in FileReference\n   * // files[0].uploadUrl - PUT to this URL\n   * // files[0].downloadUrl - Use as FileReference.url\n   * ```\n   */\n  async getUploadUrls(sessionId: string, files: FileUploadRequest[]): Promise<UploadUrlsResponse> {\n    return await this.httpPost(\n      '/api/files/upload-urls',\n      { sessionId, files },\n      uploadUrlsResponseSchema,\n    );\n  }\n}\n","import type { ApiClientConfig } from '@/base-api-client.js';\nimport { AgentsApi } from '@/agents.js';\nimport { AgentSessionsApi } from '@/agent-sessions.js';\nimport { FilesApi } from '@/files.js';\n\nexport interface OctavusClientConfig {\n  baseUrl: string;\n  apiKey?: string;\n}\n\n/** Client for interacting with the Octavus platform API */\nexport class OctavusClient {\n  readonly agents: AgentsApi;\n  readonly agentSessions: AgentSessionsApi;\n  readonly files: FilesApi;\n  readonly baseUrl: string;\n  private readonly apiKey?: string;\n\n  constructor(config: OctavusClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, '');\n    this.apiKey = config.apiKey;\n\n    const apiConfig: ApiClientConfig = {\n      baseUrl: this.baseUrl,\n      getHeaders: () => this.getHeaders(),\n    };\n\n    this.agents = new AgentsApi(apiConfig);\n    this.agentSessions = new AgentSessionsApi(apiConfig);\n    this.files = new FilesApi(apiConfig);\n  }\n\n  getHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    };\n\n    if (this.apiKey) {\n      headers.Authorization = `Bearer ${this.apiKey}`;\n    }\n\n    return headers;\n  }\n}\n","/**\n * Base class for agent-managed resources.\n * Extend this class to define how each resource should be persisted when the agent updates it.\n */\nexport abstract class Resource {\n  /** The resource name as defined in the agent protocol */\n  abstract readonly name: string;\n\n  /** Called when the agent updates this resource */\n  abstract onUpdate(value: unknown): Promise<void> | void;\n}\n","export { OctavusClient, type OctavusClientConfig } from '@/client.js';\nexport { AgentsApi } from '@/agents.js';\nexport {\n  AgentSessionsApi,\n  type SessionState,\n  type UISessionState,\n  type ExpiredSessionState,\n  type RestoreSessionResult,\n  type SessionStatus,\n  type SessionAttachOptions,\n} from '@/agent-sessions.js';\nexport {\n  FilesApi,\n  type FileUploadRequest,\n  type FileUploadInfo,\n  type UploadUrlsResponse,\n} from '@/files.js';\nexport {\n  AgentSession,\n  toSSEStream,\n  type SessionConfig,\n  type TriggerOptions,\n  type SessionRequest,\n  type TriggerRequest,\n  type ContinueRequest,\n  type StopMessage,\n  type SocketMessage,\n  type SocketMessageHandlers,\n} from '@/session.js';\nexport { Resource } from '@/resource.js';\nexport { ApiError } from '@/api-error.js';\n\n// Agent types (read-only - use @octavus/cli for agent management)\nexport type {\n  AgentFormat,\n  AgentSettings,\n  AgentPrompt,\n  Agent,\n  AgentDefinition,\n} from '@/agent-types.js';\n\nexport type * from '@octavus/core';\nexport {\n  // Error classes\n  AppError,\n  NotFoundError,\n  ValidationError,\n  ConflictError,\n  ForbiddenError,\n  OctavusError,\n  // Error type guards\n  isRateLimitError,\n  isAuthenticationError,\n  isProviderError,\n  isToolError,\n  isRetryableError,\n  isValidationError,\n  // Error event helpers\n  createErrorEvent,\n  errorToStreamEvent,\n  createInternalErrorEvent,\n  createApiErrorEvent,\n  // Utilities\n  generateId,\n  isAbortError,\n  // Thread helpers\n  MAIN_THREAD,\n  resolveThread,\n  isMainThread,\n  threadForPart,\n  isOtherThread,\n  // Type guards\n  isFileReference,\n  isFileReferenceArray,\n  // Safe parse helpers\n  safeParseStreamEvent,\n  safeParseUIMessage,\n  safeParseUIMessages,\n  // Skills\n  OCTAVUS_SKILL_TOOLS,\n  isOctavusSkillTool,\n  getSkillSlugFromToolCall,\n} from '@octavus/core';\n"],"mappings":"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","names":["z","z","z","z","z","createInternalErrorEvent","createApiErrorEvent","isAbortError","safeParseStreamEvent"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octavus/server-sdk",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "Server SDK for integrating Octavus agents",
   "license": "MIT",
   "author": "Octavus AI <dev@octavus.ai>",
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "zod": "^4.1.13",
-    "@octavus/core": "^2.0.0"
+    "@octavus/core": "^2.2.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",