@octavus/server-sdk 0.2.0 → 1.0.0

package/README.md

@@ -0,0 +1,227 @@
+# @octavus/server-sdk
+
+Server SDK for integrating Octavus agents into your backend.
+
+## Installation
+
+```bash
+npm install @octavus/server-sdk
+```
+
+## Overview
+
+This package provides a server-side SDK for interacting with the Octavus platform. Use it to:
+
+- Create and manage agent sessions
+- Execute triggers with tool handling
+- Stream responses to clients
+
+## Quick Start
+
+```typescript
+import { OctavusClient, toSSEStream } from '@octavus/server-sdk';
+
+// Initialize client
+const client = new OctavusClient({
+  baseUrl: process.env.OCTAVUS_BASE_URL!,
+  apiKey: process.env.OCTAVUS_API_KEY,
+});
+
+// Create a session
+const sessionId = await client.agentSessions.create(agentId, {
+  COMPANY_NAME: 'Acme Corp',
+});
+
+// Attach to session with tool handlers
+const session = client.agentSessions.attach(sessionId, {
+  tools: {
+    'get-user': async (args) => {
+      return await db.users.findById(args.userId);
+    },
+    'create-ticket': async (args) => {
+      return await ticketService.create(args);
+    },
+  },
+});
+
+// Trigger and stream response
+const events = session.trigger('user-message', { USER_MESSAGE: 'Hello!' });
+return new Response(toSSEStream(events), {
+  headers: { 'Content-Type': 'text/event-stream' },
+});
+```
+
+## OctavusClient
+
+### Configuration
+
+```typescript
+const client = new OctavusClient({
+  baseUrl: 'https://api.octavus.ai', // Or your self-hosted URL
+  apiKey: 'your-api-key', // Optional: for authenticated requests
+});
+```
+
+### Agent Sessions API
+
+```typescript
+// Create a new session
+const sessionId = await client.agentSessions.create(agentId, input);
+
+// Get session state (for debugging)
+const state = await client.agentSessions.get(sessionId);
+
+// Get UI-ready messages
+const { messages, status } = await client.agentSessions.getMessages(sessionId);
+
+// Restore expired session
+await client.agentSessions.restore(sessionId, storedMessages, input);
+
+// Attach to session for triggering
+const session = client.agentSessions.attach(sessionId, options);
+```
+
+### Agents API
+
+```typescript
+// List all agents
+const agents = await client.agents.list();
+
+// Get agent by ID
+const agent = await client.agents.get(agentId);
+```
+
+### Files API
+
+```typescript
+// Get presigned upload URLs
+const { files } = await client.files.getUploadUrls(sessionId, [
+  { filename: 'photo.jpg', mediaType: 'image/jpeg', size: 102400 },
+]);
+
+// Upload directly to S3
+await fetch(files[0].uploadUrl, {
+  method: 'PUT',
+  body: imageFile,
+  headers: { 'Content-Type': 'image/jpeg' },
+});
+
+// Use downloadUrl in trigger input
+await session.trigger('user-message', {
+  FILES: [{ id: files[0].id, url: files[0].downloadUrl, mediaType: 'image/jpeg' }],
+});
+```
+
+## AgentSession
+
+### Triggering Events
+
+```typescript
+const session = client.agentSessions.attach(sessionId, {
+  tools: {
+    'tool-name': async (args) => {
+      // Execute tool and return result
+      return { success: true };
+    },
+  },
+});
+
+// Stream events (for WebSocket/Socket.io)
+for await (const event of session.trigger('user-message', input)) {
+  socket.emit('stream-event', event);
+}
+
+// Convert to SSE (for HTTP endpoints)
+const events = session.trigger('user-message', input);
+return new Response(toSSEStream(events), {
+  headers: { 'Content-Type': 'text/event-stream' },
+});
+```
+
+### Tool Handlers
+
+The SDK automatically handles the tool execution loop:
+
+1. Platform requests tool execution via `tool-request` event
+2. SDK executes your tool handlers locally
+3. SDK sends results back to continue the conversation
+
+```typescript
+const session = client.agentSessions.attach(sessionId, {
+  tools: {
+    'get-user-account': async (args) => {
+      // Access your database, APIs, etc.
+      return await db.users.findById(args.userId);
+    },
+    'create-support-ticket': async (args) => {
+      // Execute with full access to your backend
+      return await ticketService.create({
+        summary: args.summary,
+        priority: args.priority,
+      });
+    },
+  },
+});
+```
+
+### Resource Handlers
+
+Track resource updates from the agent:
+
+```typescript
+import { Resource } from '@octavus/server-sdk';
+
+class ConversationSummaryResource extends Resource {
+  readonly name = 'CONVERSATION_SUMMARY';
+
+  async onUpdate(value: unknown) {
+    // Persist to database, trigger webhooks, etc.
+    await db.sessions.update(sessionId, { summary: value });
+  }
+}
+
+const session = client.agentSessions.attach(sessionId, {
+  resources: [new ConversationSummaryResource()],
+});
+```
+
+### Abort Support
+
+```typescript
+const events = session.trigger('user-message', input, {
+  signal: request.signal, // AbortSignal from request
+});
+```
+
+## Session Lifecycle
+
+### Active Sessions
+
+Sessions remain active for 24 hours (configurable). Use `getMessages()` for UI display.
+
+### Expired Sessions
+
+When Redis state expires:
+
+```typescript
+const result = await client.agentSessions.getMessages(sessionId);
+
+if (result.status === 'expired') {
+  // Restore from your stored messages
+  await client.agentSessions.restore(sessionId, storedMessages);
+}
+```
+
+## Re-exports
+
+This package re-exports everything from `@octavus/core`, so you don't need to install it separately.
+
+## Related Packages
+
+- [`@octavus/react`](https://www.npmjs.com/package/@octavus/react) - React hooks
+- [`@octavus/client-sdk`](https://www.npmjs.com/package/@octavus/client-sdk) - Client-side SDK
+- [`@octavus/cli`](https://www.npmjs.com/package/@octavus/cli) - CLI for agent management
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -24,8 +24,8 @@ declare abstract class BaseApiClient {
     protected httpPatch<T>(path: string, body: unknown, schema: ZodType<T>): Promise<T>;
 }
 
-/** Agent format - interactive (chat) or generation (background task) */
-type AgentFormat = 'interactive' | 'generation';
+/** Agent format - interactive (chat) or worker (background task) */
+type AgentFormat = 'interactive' | 'worker';
 /** Agent settings */
 interface AgentSettings {
     slug: string;
@@ -65,7 +65,7 @@ interface AgentDefinition {
 }
 declare const agentFormatSchema: z.ZodEnum<{
     interactive: "interactive";
-    generation: "generation";
+    worker: "worker";
 }>;
 declare const agentSchema: z.ZodObject<{
     slug: z.ZodString;
@@ -74,7 +74,7 @@ declare const agentSchema: z.ZodObject<{
     description: z.ZodNullable<z.ZodString>;
     format: z.ZodEnum<{
         interactive: "interactive";
-        generation: "generation";
+        worker: "worker";
     }>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -88,7 +88,7 @@ declare const agentsResponseSchema: z.ZodObject<{
         description: z.ZodNullable<z.ZodString>;
         format: z.ZodEnum<{
             interactive: "interactive";
-            generation: "generation";
+            worker: "worker";
         }>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
@@ -102,7 +102,7 @@ declare const agentDefinitionSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         format: z.ZodEnum<{
             interactive: "interactive";
-            generation: "generation";
+            worker: "worker";
         }>;
     }, z.core.$strip>;
     protocol: z.ZodString;
@@ -203,6 +203,8 @@ declare class AgentSession {
     private handleResourceUpdate;
 }
 
+/** Session status indicating whether it's active or expired */
+type SessionStatus = 'active' | 'expired';
 interface SessionState {
     id: string;
     agentId: string;
@@ -210,6 +212,7 @@ interface SessionState {
     variables: Record<string, unknown>;
     resources: Record<string, unknown>;
     messages: ChatMessage[];
+    status?: 'active';
     createdAt: string;
     updatedAt: string;
 }
@@ -217,6 +220,18 @@ interface UISessionState {
     sessionId: string;
     agentId: string;
     messages: UIMessage[];
+    status?: 'active';
+}
+interface ExpiredSessionState {
+    sessionId: string;
+    agentId: string;
+    status: 'expired';
+    createdAt: string;
+}
+interface RestoreSessionResult {
+    sessionId: string;
+    /** True if session was restored from messages, false if already active */
+    restored: boolean;
 }
 interface SessionAttachOptions {
     tools?: ToolHandlers;
@@ -229,13 +244,31 @@ declare class AgentSessionsApi extends BaseApiClient {
     /**
      * Get full session state (for internal/debug use)
      * Note: Contains all messages including hidden content
+     *
+     * Returns SessionState for active sessions, ExpiredSessionState for expired sessions.
+     * Check `status` field to determine which type was returned.
      */
-    get(sessionId: string): Promise<SessionState>;
+    get(sessionId: string): Promise<SessionState | ExpiredSessionState>;
     /**
      * Get UI-ready session messages (for client display)
-     * Returns only visible messages with hidden content filtered out
+     * Returns only visible messages with hidden content filtered out.
+     *
+     * For expired sessions, returns status: 'expired' without messages.
+     * Use restore() to restore from stored messages before continuing.
+     */
+    getMessages(sessionId: string): Promise<UISessionState | ExpiredSessionState>;
+    /**
+     * Restore an expired session from stored messages.
+     *
+     * Use this to restore a session after its state has expired.
+     * The consumer should have stored the UIMessage[] array from previous interactions.
+     *
+     * @param sessionId - The session ID to restore
+     * @param messages - Previously stored UIMessage[] array
+     * @param input - Optional session input for system prompt interpolation (same as create)
+     * @returns { sessionId, restored: true } if restored, { sessionId, restored: false } if already active
      */
-    getMessages(sessionId: string): Promise<UISessionState>;
+    restore(sessionId: string, messages: UIMessage[], input?: Record<string, unknown>): Promise<RestoreSessionResult>;
     /** Attach to an existing session for triggering events */
     attach(sessionId: string, options?: SessionAttachOptions): AgentSession;
 }
@@ -335,4 +368,4 @@ declare class OctavusClient {
     getHeaders(): Record<string, string>;
 }
 
-export { type Agent, type AgentDefinition, type AgentFormat, type AgentPrompt, AgentSession, AgentSessionsApi, type AgentSettings, AgentsApi, ApiError, type FileUploadInfo, type FileUploadRequest, FilesApi, OctavusClient, type OctavusClientConfig, Resource, type SessionAttachOptions, type SessionConfig, type SessionState, type TriggerOptions, type UISessionState, type UploadUrlsResponse, agentDefinitionSchema, agentFormatSchema, agentSchema, agentsResponseSchema, fileUploadInfoSchema, fileUploadRequestSchema, toSSEStream, uploadUrlsResponseSchema };
+export { type Agent, type AgentDefinition, type AgentFormat, type AgentPrompt, AgentSession, AgentSessionsApi, type AgentSettings, AgentsApi, ApiError, type ExpiredSessionState, type FileUploadInfo, type FileUploadRequest, FilesApi, OctavusClient, type OctavusClientConfig, Resource, type RestoreSessionResult, type SessionAttachOptions, type SessionConfig, type SessionState, type SessionStatus, type TriggerOptions, type UISessionState, type UploadUrlsResponse, agentDefinitionSchema, agentFormatSchema, agentSchema, agentsResponseSchema, fileUploadInfoSchema, fileUploadRequestSchema, toSSEStream, uploadUrlsResponseSchema };

package/dist/index.js

@@ -78,7 +78,7 @@ var BaseApiClient = class {
 
 // src/agent-types.ts
 import { z as z2 } from "zod";
-var agentFormatSchema = z2.enum(["interactive", "generation"]);
+var agentFormatSchema = z2.enum(["interactive", "worker"]);
 var agentSettingsSchema = z2.object({
   slug: z2.string(),
   name: z2.string(),
@@ -132,7 +132,9 @@ import {
 // src/session.ts
 import {
   safeParseStreamEvent,
-  isAbortError
+  isAbortError,
+  createInternalErrorEvent,
+  createApiErrorEvent
 } from "@octavus/core";
 function toSSEStream(events) {
   const encoder = new TextEncoder();
@@ -147,13 +149,12 @@ function toSSEStream(events) {
         controller.enqueue(encoder.encode("data: [DONE]\n\n"));
         controller.close();
       } catch (err) {
-        controller.enqueue(
-          encoder.encode(
-            `data: ${JSON.stringify({ type: "error", errorText: err instanceof Error ? err.message : "Unknown error" })}
-
-`
-          )
+        const errorEvent = createInternalErrorEvent(
+          err instanceof Error ? err.message : "Unknown error"
         );
+        controller.enqueue(encoder.encode(`data: ${JSON.stringify(errorEvent)}
+
+`));
         controller.close();
       }
     }
@@ -233,11 +234,11 @@ var AgentSession = class {
       }
       if (!response.ok) {
         const { message } = await parseApiError(response, "Failed to trigger");
-        yield { type: "error", errorText: message };
+        yield createApiErrorEvent(response.status, message);
         return;
       }
       if (!response.body) {
-        yield { type: "error", errorText: "Response body is not readable" };
+        yield createInternalErrorEvent("Response body is not readable");
         return;
       }
       toolResults = void 0;
@@ -339,7 +340,7 @@ var AgentSession = class {
         );
         for (const tr of toolResults) {
           if (tr.error) {
-            yield { type: "tool-output-error", toolCallId: tr.toolCallId, errorText: tr.error };
+            yield { type: "tool-output-error", toolCallId: tr.toolCallId, error: tr.error };
           } else {
             yield { type: "tool-output-available", toolCallId: tr.toolCallId, output: tr.result };
           }
@@ -371,13 +372,25 @@ var sessionStateSchema = z3.object({
   variables: z3.record(z3.string(), z3.unknown()),
   resources: z3.record(z3.string(), z3.unknown()),
   messages: z3.array(chatMessageSchema),
+  status: z3.literal("active").optional(),
   createdAt: z3.string(),
   updatedAt: z3.string()
 });
 var uiSessionResponseSchema = z3.object({
   sessionId: z3.string(),
   agentId: z3.string(),
-  messages: z3.array(uiMessageSchema)
+  messages: z3.array(uiMessageSchema),
+  status: z3.literal("active").optional()
+});
+var expiredSessionResponseSchema = z3.object({
+  sessionId: z3.string(),
+  agentId: z3.string(),
+  status: z3.literal("expired"),
+  createdAt: z3.string()
+});
+var restoreSessionResponseSchema = z3.object({
+  sessionId: z3.string(),
+  restored: z3.boolean()
 });
 var AgentSessionsApi = class extends BaseApiClient {
   /** Create a new session for an agent */
@@ -392,18 +405,66 @@ var AgentSessionsApi = class extends BaseApiClient {
   /**
    * Get full session state (for internal/debug use)
    * Note: Contains all messages including hidden content
+   *
+   * Returns SessionState for active sessions, ExpiredSessionState for expired sessions.
+   * Check `status` field to determine which type was returned.
    */
   async get(sessionId) {
-    return await this.httpGet(`/api/agent-sessions/${sessionId}`, sessionStateSchema);
+    const response = await fetch(`${this.config.baseUrl}/api/agent-sessions/${sessionId}`, {
+      method: "GET",
+      headers: this.config.getHeaders()
+    });
+    if (!response.ok) {
+      await throwApiError(response, "Request failed");
+    }
+    const data = await response.json();
+    const expiredResult = expiredSessionResponseSchema.safeParse(data);
+    if (expiredResult.success) {
+      return expiredResult.data;
+    }
+    return sessionStateSchema.parse(data);
   }
   /**
    * Get UI-ready session messages (for client display)
-   * Returns only visible messages with hidden content filtered out
+   * Returns only visible messages with hidden content filtered out.
+   *
+   * For expired sessions, returns status: 'expired' without messages.
+   * Use restore() to restore from stored messages before continuing.
    */
   async getMessages(sessionId) {
-    return await this.httpGet(
-      `/api/agent-sessions/${sessionId}?format=ui`,
-      uiSessionResponseSchema
+    const response = await fetch(
+      `${this.config.baseUrl}/api/agent-sessions/${sessionId}?format=ui`,
+      {
+        method: "GET",
+        headers: this.config.getHeaders()
+      }
+    );
+    if (!response.ok) {
+      await throwApiError(response, "Request failed");
+    }
+    const data = await response.json();
+    const expiredResult = expiredSessionResponseSchema.safeParse(data);
+    if (expiredResult.success) {
+      return expiredResult.data;
+    }
+    return uiSessionResponseSchema.parse(data);
+  }
+  /**
+   * Restore an expired session from stored messages.
+   *
+   * Use this to restore a session after its state has expired.
+   * The consumer should have stored the UIMessage[] array from previous interactions.
+   *
+   * @param sessionId - The session ID to restore
+   * @param messages - Previously stored UIMessage[] array
+   * @param input - Optional session input for system prompt interpolation (same as create)
+   * @returns { sessionId, restored: true } if restored, { sessionId, restored: false } if already active
+   */
+  async restore(sessionId, messages, input) {
+    return await this.httpPost(
+      `/api/agent-sessions/${sessionId}/restore`,
+      { messages, input },
+      restoreSessionResponseSchema
     );
   }
   /** Attach to an existing session for triggering events */
@@ -501,6 +562,9 @@ var OctavusClient = class {
 // src/resource.ts
 var Resource = class {
 };
+
+// src/index.ts
+export * from "@octavus/core";
 export {
   AgentSession,
   AgentSessionsApi,

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"],"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 generation (background task) */\nexport type AgentFormat = 'interactive' | 'generation';\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', 'generation']);\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 { 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  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});\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  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface UISessionState {\n  sessionId: string;\n  agentId: string;\n  messages: UIMessage[];\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  async get(sessionId: string): Promise<SessionState> {\n    return await this.httpGet(`/api/agent-sessions/${sessionId}`, sessionStateSchema);\n  }\n\n  /**\n   * Get UI-ready session messages (for client display)\n   * Returns only visible messages with hidden content filtered out\n   */\n  async getMessages(sessionId: string): Promise<UISessionState> {\n    return await this.httpGet(\n      `/api/agent-sessions/${sessionId}?format=ui`,\n      uiSessionResponseSchema,\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  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 * 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        controller.enqueue(\n          encoder.encode(\n            `data: ${JSON.stringify({ type: 'error', errorText: err instanceof Error ? err.message : 'Unknown error' })}\\n\\n`,\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   * Trigger an agent action and stream the response as parsed events.\n   *\n   * This method:\n   * 1. POSTs to the platform trigger endpoint\n   * 2. Yields parsed stream events to the consumer\n   * 3. When tool-request event is received: executes tools locally\n   * 4. POSTs a new request with toolResults to continue\n   * 5. Repeats until done (no more tool requests)\n   *\n   * @param triggerName - The trigger name defined in the agent's protocol\n   * @param triggerInput - Input parameters for the trigger\n   * @param options - Optional configuration including abort signal\n   *\n   * @example\n   * ```typescript\n   * // For sockets: iterate events directly\n   * for await (const event of session.trigger('user-message', input)) {\n   *   conn.write(JSON.stringify(event));\n   * }\n   *\n   * // For HTTP: convert to SSE stream with abort support\n   * const events = session.trigger('user-message', input, { signal: request.signal });\n   * return new Response(toSSEStream(events), {\n   *   headers: { 'Content-Type': 'text/event-stream' },\n   * });\n   * ```\n   */\n  async *trigger(\n    triggerName: string,\n    triggerInput?: Record<string, unknown>,\n    options?: TriggerOptions,\n  ): AsyncGenerator<StreamEvent> {\n    let toolResults: ToolResult[] | undefined;\n    let continueLoop = true;\n\n    while (continueLoop) {\n      // Check if aborted before making request\n      if (options?.signal?.aborted) {\n        yield { type: 'finish', finishReason: 'stop' };\n        return;\n      }\n\n      // Make request to platform (with toolResults on continuation)\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({\n              triggerName,\n              input: triggerInput,\n              toolResults,\n            }),\n            signal: options?.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 { type: 'error', errorText: message };\n        return;\n      }\n\n      if (!response.body) {\n        yield { type: 'error', errorText: 'Response body is not readable' };\n        return;\n      }\n\n      // Reset tool results for next iteration\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 (options?.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              // Handle tool-request - execute tools and prepare continuation\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              // Handle resource updates\n              if (event.type === 'resource-update') {\n                this.handleResourceUpdate(event.name, event.value);\n              }\n\n              // Yield all other events to the consumer\n              yield event;\n            } catch {\n              // Skip malformed JSON\n            }\n          }\n        }\n      }\n\n      // Check if aborted before tool execution\n      if (options?.signal?.aborted) {\n        yield { type: 'finish', finishReason: 'stop' };\n        return;\n      }\n\n      // If we have pending tool calls, execute them and continue\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        toolResults = await Promise.all(\n          pendingToolCalls.map(async (tc): Promise<ToolResult> => {\n            const handler = this.toolHandlers[tc.toolName];\n            if (!handler) {\n              return {\n                toolCallId: tc.toolCallId,\n                toolName: tc.toolName,\n                error: `No handler for tool: ${tc.toolName}`,\n                outputVariable: tc.outputVariable,\n                blockIndex: tc.blockIndex,\n              };\n            }\n\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 immediately so UI updates right away\n        // (before making continuation request)\n        for (const tr of toolResults) {\n          if (tr.error) {\n            yield { type: 'tool-output-error', toolCallId: tr.toolCallId, errorText: tr.error };\n          } else {\n            yield { type: 'tool-output-available', toolCallId: tr.toolCallId, output: tr.result };\n          }\n        }\n\n        // Continue loop with tool results\n      } else {\n        // No pending tools, we're done\n        continueLoop = false;\n      }\n    }\n  }\n\n  getSessionId(): string {\n    return this.sessionId;\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"],"mappings":"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","names":["z","z","z","z","z"]}
+{"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 * 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   * Trigger an agent action and stream the response as parsed events.\n   *\n   * This method:\n   * 1. POSTs to the platform trigger endpoint\n   * 2. Yields parsed stream events to the consumer\n   * 3. When tool-request event is received: executes tools locally\n   * 4. POSTs a new request with toolResults to continue\n   * 5. Repeats until done (no more tool requests)\n   *\n   * @param triggerName - The trigger name defined in the agent's protocol\n   * @param triggerInput - Input parameters for the trigger\n   * @param options - Optional configuration including abort signal\n   *\n   * @example\n   * ```typescript\n   * // For sockets: iterate events directly\n   * for await (const event of session.trigger('user-message', input)) {\n   *   conn.write(JSON.stringify(event));\n   * }\n   *\n   * // For HTTP: convert to SSE stream with abort support\n   * const events = session.trigger('user-message', input, { signal: request.signal });\n   * return new Response(toSSEStream(events), {\n   *   headers: { 'Content-Type': 'text/event-stream' },\n   * });\n   * ```\n   */\n  async *trigger(\n    triggerName: string,\n    triggerInput?: Record<string, unknown>,\n    options?: TriggerOptions,\n  ): AsyncGenerator<StreamEvent> {\n    let toolResults: ToolResult[] | undefined;\n    let continueLoop = true;\n\n    while (continueLoop) {\n      // Check if aborted before making request\n      if (options?.signal?.aborted) {\n        yield { type: 'finish', finishReason: 'stop' };\n        return;\n      }\n\n      // Make request to platform (with toolResults on continuation)\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({\n              triggerName,\n              input: triggerInput,\n              toolResults,\n            }),\n            signal: options?.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\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 (options?.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              // Handle tool-request - execute tools and prepare continuation\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              // Handle resource updates\n              if (event.type === 'resource-update') {\n                this.handleResourceUpdate(event.name, event.value);\n              }\n\n              // Yield all other events to the consumer\n              yield event;\n            } catch {\n              // Skip malformed JSON\n            }\n          }\n        }\n      }\n\n      // Check if aborted before tool execution\n      if (options?.signal?.aborted) {\n        yield { type: 'finish', finishReason: 'stop' };\n        return;\n      }\n\n      // If we have pending tool calls, execute them and continue\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        toolResults = await Promise.all(\n          pendingToolCalls.map(async (tc): Promise<ToolResult> => {\n            const handler = this.toolHandlers[tc.toolName];\n            if (!handler) {\n              return {\n                toolCallId: tc.toolCallId,\n                toolName: tc.toolName,\n                error: `No handler for tool: ${tc.toolName}`,\n                outputVariable: tc.outputVariable,\n                blockIndex: tc.blockIndex,\n              };\n            }\n\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 immediately so UI updates right away\n        // (before making continuation request)\n        for (const tr of toolResults) {\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        // Continue loop with tool results\n      } else {\n        // No pending tools, we're done\n        continueLoop = false;\n      }\n    }\n  }\n\n  getSessionId(): string {\n    return this.sessionId;\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  fileUploadRequestSchema,\n  fileUploadInfoSchema,\n  uploadUrlsResponseSchema,\n} from '@/files.js';\nexport { AgentSession, toSSEStream, type SessionConfig, type TriggerOptions } from '@/session.js';\nexport { Resource } from '@/resource.js';\nexport { ApiError } from '@/api-error.js';\n\n// Agent types and schemas (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 {\n  agentFormatSchema,\n  agentSchema,\n  agentsResponseSchema,\n  agentDefinitionSchema,\n} from '@/agent-types.js';\n\n// Re-export everything from core so consumers don't need to install @octavus/core separately\nexport * from '@octavus/core';\n"],"mappings":"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","names":["z","z","z","z","z"]}

package/package.json

@@ -1,16 +1,26 @@
 {
   "name": "@octavus/server-sdk",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "description": "Server SDK for integrating Octavus agents",
   "license": "MIT",
   "author": "Octavus AI <dev@octavus.ai>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/octavus-ai/js-sdk.git",
+    "directory": "packages/server-sdk"
+  },
+  "homepage": "https://octavus.ai",
+  "bugs": {
+    "url": "https://github.com/octavus-ai/js-sdk/issues"
+  },
   "keywords": [
     "octavus",
     "ai",
     "agents",
     "sdk",
     "server",
-    "tools"
+    "tools",
+    "nodejs"
   ],
   "type": "module",
   "sideEffects": false,
@@ -30,7 +40,7 @@
   },
   "dependencies": {
     "zod": "^4.1.13",
-    "@octavus/core": "^0.2.0"
+    "@octavus/core": "^1.0.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",