@octavus/server-sdk 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Octavus AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/dist/index.d.ts

@@ -0,0 +1,272 @@
+import { ZodType, z } from 'zod';
+import { ToolHandlers, ChatMessage } from '@octavus/core';
+export { ChatMessage, ToolHandler, ToolHandlers } from '@octavus/core';
+
+/**
+ * Error thrown when API request fails
+ */
+declare class ApiError extends Error {
+    status: number;
+    code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+
+interface ApiClientConfig {
+    baseUrl: string;
+    getHeaders: () => Record<string, string>;
+}
+/** Base class for API clients with shared HTTP utilities */
+declare abstract class BaseApiClient {
+    protected readonly config: ApiClientConfig;
+    constructor(config: ApiClientConfig);
+    protected httpGet<T>(path: string, schema: ZodType<T>): Promise<T>;
+    protected httpPost<T>(path: string, body: unknown, schema: ZodType<T>): Promise<T>;
+    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 settings input - used when creating/updating agents
+ */
+interface AgentSettingsInput {
+    slug: string;
+    name: string;
+    description?: string;
+    format: AgentFormat;
+}
+/**
+ * Agent prompt - shared between input and response
+ */
+interface AgentPrompt {
+    name: string;
+    content: string;
+}
+/**
+ * Input for creating/updating an agent definition
+ */
+interface AgentDefinitionInput {
+    settings: AgentSettingsInput;
+    protocol: string;
+    prompts: AgentPrompt[];
+}
+/**
+ * Agent summary returned from list endpoint
+ */
+interface Agent {
+    /** Agent slug (human-readable identifier within project) */
+    slug: string;
+    /** Database ID - use this for API calls */
+    id: string;
+    name: string;
+    description: string | null;
+    format: AgentFormat;
+    createdAt: string;
+    updatedAt: string;
+    projectId: string;
+}
+/**
+ * Full agent definition returned from get endpoint
+ */
+interface AgentDefinition {
+    settings: AgentSettingsInput;
+    protocol: string;
+    prompts: AgentPrompt[];
+    /** Database ID - use this for API calls like createSession */
+    id: string;
+}
+declare const agentFormatSchema: z.ZodEnum<{
+    interactive: "interactive";
+    generation: "generation";
+}>;
+declare const agentSettingsInputSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    format: z.ZodEnum<{
+        interactive: "interactive";
+        generation: "generation";
+    }>;
+}, z.core.$strip>;
+declare const agentPromptSchema: z.ZodObject<{
+    name: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+declare const agentDefinitionInputSchema: z.ZodObject<{
+    settings: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        format: z.ZodEnum<{
+            interactive: "interactive";
+            generation: "generation";
+        }>;
+    }, z.core.$strip>;
+    protocol: z.ZodString;
+    prompts: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const agentSchema: z.ZodObject<{
+    slug: z.ZodString;
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    format: z.ZodEnum<{
+        interactive: "interactive";
+        generation: "generation";
+    }>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    projectId: z.ZodString;
+}, z.core.$strip>;
+declare const agentsResponseSchema: z.ZodObject<{
+    agents: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        format: z.ZodEnum<{
+            interactive: "interactive";
+            generation: "generation";
+        }>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        projectId: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const agentDefinitionSchema: z.ZodObject<{
+    settings: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        format: z.ZodEnum<{
+            interactive: "interactive";
+            generation: "generation";
+        }>;
+    }, z.core.$strip>;
+    protocol: z.ZodString;
+    prompts: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+    id: z.ZodString;
+}, z.core.$strip>;
+declare const agentCreateResponseSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+declare const agentUpdateResponseSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+
+interface AgentUpdateInput {
+    protocol?: string;
+    prompts?: AgentPrompt[];
+}
+/** API for managing agent definitions */
+declare class AgentsApi extends BaseApiClient {
+    /** List all agents */
+    list(): Promise<Agent[]>;
+    /** Get a single agent by ID */
+    get(agentId: string): Promise<AgentDefinition>;
+    /** Get a single agent by slug */
+    getBySlug(slug: string): Promise<AgentDefinition | null>;
+    /** Create a new agent. Throws if agent with same slug exists. */
+    create(definition: AgentDefinitionInput): Promise<string>;
+    /** Partial update of an existing agent by ID */
+    update(agentId: string, update: AgentUpdateInput): Promise<string>;
+    /** Partial update of an existing agent by slug */
+    updateBySlug(slug: string, update: AgentUpdateInput): Promise<string>;
+    /**
+     * Sync an agent definition - creates if new, updates if exists
+     * Returns { agentId, created: boolean }
+     */
+    sync(definition: AgentDefinitionInput): Promise<{
+        agentId: string;
+        created: boolean;
+    }>;
+}
+
+/**
+ * Base class for agent-managed resources.
+ * Extend this class to define how each resource should be persisted when the agent updates it.
+ */
+declare abstract class Resource {
+    /** The resource name as defined in the agent protocol */
+    abstract readonly name: string;
+    /** Called when the agent updates this resource */
+    abstract onUpdate(value: unknown): Promise<void> | void;
+}
+
+interface SessionConfig {
+    sessionId: string;
+    config: ApiClientConfig;
+    tools?: ToolHandlers;
+    resources?: Resource[];
+}
+/** Handles streaming and tool continuation for agent sessions */
+declare class AgentSession {
+    private sessionId;
+    private config;
+    private toolHandlers;
+    private resourceMap;
+    constructor(sessionConfig: SessionConfig);
+    /**
+     * Trigger an agent action and stream the response.
+     *
+     * This method:
+     * 1. POSTs to the platform trigger endpoint
+     * 2. Reads the SSE stream, forwarding events to consumer
+     * 3. When tool-request event is received: executes tools locally
+     * 4. POSTs a new request with toolResults to continue
+     * 5. Repeats until done (no more tool requests)
+     */
+    trigger(triggerName: string, triggerInput?: Record<string, unknown>): {
+        stream: ReadableStream<Uint8Array>;
+    };
+    getSessionId(): string;
+    private handleResourceUpdate;
+}
+
+interface SessionState {
+    id: string;
+    agentId: string;
+    input: Record<string, unknown>;
+    variables: Record<string, unknown>;
+    resources: Record<string, unknown>;
+    messages: ChatMessage[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface SessionAttachOptions {
+    tools?: ToolHandlers;
+    resources?: Resource[];
+}
+/** API for managing agent sessions */
+declare class AgentSessionsApi extends BaseApiClient {
+    /** Create a new session for an agent */
+    create(agentId: string, input?: Record<string, unknown>): Promise<string>;
+    /** Get session state */
+    get(sessionId: string): Promise<SessionState>;
+    /** Attach to an existing session for triggering events */
+    attach(sessionId: string, options?: SessionAttachOptions): AgentSession;
+}
+
+interface OctavusClientConfig {
+    baseUrl: string;
+    apiKey?: string;
+}
+/** Client for interacting with the Octavus platform API */
+declare class OctavusClient {
+    readonly agents: AgentsApi;
+    readonly agentSessions: AgentSessionsApi;
+    readonly baseUrl: string;
+    private readonly apiKey?;
+    constructor(config: OctavusClientConfig);
+    getHeaders(): Record<string, string>;
+}
+
+export { type Agent, type AgentDefinition, type AgentDefinitionInput, type AgentFormat, type AgentPrompt, AgentSession, AgentSessionsApi, type AgentSettingsInput, type AgentUpdateInput, AgentsApi, ApiError, OctavusClient, type OctavusClientConfig, Resource, type SessionAttachOptions, type SessionState, agentCreateResponseSchema, agentDefinitionInputSchema, agentDefinitionSchema, agentFormatSchema, agentPromptSchema, agentSchema, agentSettingsInputSchema, agentUpdateResponseSchema, agentsResponseSchema };

package/dist/index.js

@@ -0,0 +1,472 @@
+// src/api-error.ts
+import { z } from "zod";
+var ApiErrorResponseSchema = z.object({
+  error: z.string().optional(),
+  message: z.string().optional(),
+  code: z.string().optional()
+});
+var ApiError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "ApiError";
+  }
+};
+async function parseApiError(response, defaultMessage) {
+  const fallbackMessage = `${defaultMessage}: ${response.statusText}`;
+  try {
+    const json = await response.json();
+    const parsed = ApiErrorResponseSchema.safeParse(json);
+    if (parsed.success) {
+      return {
+        message: parsed.data.error ?? parsed.data.message ?? fallbackMessage,
+        code: parsed.data.code
+      };
+    }
+  } catch {
+  }
+  return { message: fallbackMessage };
+}
+async function throwApiError(response, defaultMessage) {
+  const { message, code } = await parseApiError(response, defaultMessage);
+  throw new ApiError(message, response.status, code);
+}
+
+// src/base-api-client.ts
+var BaseApiClient = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  async httpGet(path, schema) {
+    const response = await fetch(`${this.config.baseUrl}${path}`, {
+      method: "GET",
+      headers: this.config.getHeaders()
+    });
+    if (!response.ok) {
+      await throwApiError(response, "Request failed");
+    }
+    const data = await response.json();
+    return schema.parse(data);
+  }
+  async httpPost(path, body, schema) {
+    const response = await fetch(`${this.config.baseUrl}${path}`, {
+      method: "POST",
+      headers: this.config.getHeaders(),
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      await throwApiError(response, "Request failed");
+    }
+    const data = await response.json();
+    return schema.parse(data);
+  }
+  async httpPatch(path, body, schema) {
+    const response = await fetch(`${this.config.baseUrl}${path}`, {
+      method: "PATCH",
+      headers: this.config.getHeaders(),
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      await throwApiError(response, "Request failed");
+    }
+    const data = await response.json();
+    return schema.parse(data);
+  }
+};
+
+// src/agent-types.ts
+import { z as z2 } from "zod";
+var agentFormatSchema = z2.enum(["interactive", "generation"]);
+var agentSettingsInputSchema = z2.object({
+  slug: z2.string().min(1),
+  name: z2.string().min(1),
+  description: z2.string().optional(),
+  format: agentFormatSchema
+});
+var agentPromptSchema = z2.object({
+  name: z2.string().min(1),
+  content: z2.string()
+});
+var agentDefinitionInputSchema = z2.object({
+  settings: agentSettingsInputSchema,
+  protocol: z2.string().min(1),
+  prompts: z2.array(agentPromptSchema)
+});
+var agentSchema = z2.object({
+  slug: z2.string(),
+  id: z2.string(),
+  name: z2.string(),
+  description: z2.string().nullable(),
+  format: agentFormatSchema,
+  createdAt: z2.string(),
+  updatedAt: z2.string(),
+  projectId: z2.string()
+});
+var agentsResponseSchema = z2.object({
+  agents: z2.array(agentSchema)
+});
+var agentDefinitionSchema = z2.object({
+  settings: agentSettingsInputSchema,
+  protocol: z2.string(),
+  prompts: z2.array(agentPromptSchema),
+  id: z2.string()
+});
+var agentCreateResponseSchema = z2.object({
+  agentId: z2.string(),
+  message: z2.string()
+});
+var agentUpdateResponseSchema = z2.object({
+  agentId: z2.string(),
+  message: z2.string()
+});
+
+// src/agents.ts
+var AgentsApi = class extends BaseApiClient {
+  /** List all agents */
+  async list() {
+    const response = await this.httpGet("/api/agents", agentsResponseSchema);
+    return response.agents;
+  }
+  /** Get a single agent by ID */
+  async get(agentId) {
+    return await this.httpGet(`/api/agents/${agentId}`, agentDefinitionSchema);
+  }
+  /** Get a single agent by slug */
+  async getBySlug(slug) {
+    try {
+      return await this.httpGet(`/api/agents/${slug}?by=slug`, agentDefinitionSchema);
+    } catch (error) {
+      if (error instanceof ApiError && error.status === 404) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  /** Create a new agent. Throws if agent with same slug exists. */
+  async create(definition) {
+    const response = await this.httpPost("/api/agents", definition, agentCreateResponseSchema);
+    return response.agentId;
+  }
+  /** Partial update of an existing agent by ID */
+  async update(agentId, update) {
+    const response = await this.httpPatch(
+      `/api/agents/${agentId}`,
+      update,
+      agentUpdateResponseSchema
+    );
+    return response.agentId;
+  }
+  /** Partial update of an existing agent by slug */
+  async updateBySlug(slug, update) {
+    const response = await this.httpPatch(
+      `/api/agents/${slug}?by=slug`,
+      update,
+      agentUpdateResponseSchema
+    );
+    return response.agentId;
+  }
+  /**
+   * Sync an agent definition - creates if new, updates if exists
+   * Returns { agentId, created: boolean }
+   */
+  async sync(definition) {
+    const existing = await this.getBySlug(definition.settings.slug);
+    if (existing) {
+      const agentId2 = await this.update(existing.id, {
+        protocol: definition.protocol,
+        prompts: definition.prompts
+      });
+      return { agentId: agentId2, created: false };
+    }
+    const agentId = await this.create(definition);
+    return { agentId, created: true };
+  }
+};
+
+// src/agent-sessions.ts
+import { z as z3 } from "zod";
+import { chatMessageSchema } from "@octavus/core";
+
+// src/session.ts
+import {
+  safeParseStreamEvent
+} from "@octavus/core";
+var AgentSession = class {
+  sessionId;
+  config;
+  toolHandlers;
+  resourceMap;
+  constructor(sessionConfig) {
+    this.sessionId = sessionConfig.sessionId;
+    this.config = sessionConfig.config;
+    this.toolHandlers = sessionConfig.tools ?? {};
+    this.resourceMap = /* @__PURE__ */ new Map();
+    for (const resource of sessionConfig.resources ?? []) {
+      this.resourceMap.set(resource.name, resource);
+    }
+  }
+  /**
+   * Trigger an agent action and stream the response.
+   *
+   * This method:
+   * 1. POSTs to the platform trigger endpoint
+   * 2. Reads the SSE stream, forwarding events to consumer
+   * 3. When tool-request event is received: executes tools locally
+   * 4. POSTs a new request with toolResults to continue
+   * 5. Repeats until done (no more tool requests)
+   */
+  trigger(triggerName, triggerInput) {
+    const encoder = new TextEncoder();
+    const sessionId = this.sessionId;
+    const config = this.config;
+    const tools = this.toolHandlers;
+    const onResourceUpdate = (name, value) => this.handleResourceUpdate(name, value);
+    const { readable, writable } = new TransformStream();
+    const streamWriter = writable.getWriter();
+    async function executeContinuationLoop() {
+      let toolResults;
+      let continueLoop = true;
+      try {
+        while (continueLoop) {
+          const response = await fetch(
+            `${config.baseUrl}/api/agent-sessions/${sessionId}/trigger`,
+            {
+              method: "POST",
+              headers: config.getHeaders(),
+              body: JSON.stringify({ triggerName, input: triggerInput, toolResults })
+            }
+          );
+          if (!response.ok) {
+            const { message } = await parseApiError(response, "Failed to trigger");
+            await streamWriter.write(
+              encoder.encode(`data: ${JSON.stringify({ type: "error", message })}
+
+`)
+            );
+            await streamWriter.close();
+            return;
+          }
+          if (!response.body) {
+            throw new Error("Response body is not readable");
+          }
+          toolResults = void 0;
+          const reader = response.body.getReader();
+          const decoder = new TextDecoder();
+          let buffer = "";
+          let pendingToolCalls = null;
+          let streamDone = false;
+          while (!streamDone) {
+            const { done, value } = await reader.read();
+            if (done) {
+              streamDone = true;
+              continue;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+              if (line.startsWith("data: ") && line !== "data: [DONE]") {
+                try {
+                  const parsed = safeParseStreamEvent(JSON.parse(line.slice(6)));
+                  if (!parsed.success) {
+                    continue;
+                  }
+                  const event = parsed.data;
+                  if (event.type === "tool-request") {
+                    pendingToolCalls = event.toolCalls;
+                    continue;
+                  }
+                  if (event.type === "done") {
+                    if (event.finishReason === "tool-calls" && pendingToolCalls) {
+                      continue;
+                    }
+                    await streamWriter.write(encoder.encode(`data: ${JSON.stringify(event)}
+
+`));
+                    continueLoop = false;
+                    continue;
+                  }
+                  if (event.type === "resource-update") {
+                    onResourceUpdate(event.name, event.value);
+                  }
+                  await streamWriter.write(encoder.encode(`data: ${JSON.stringify(event)}
+
+`));
+                } catch {
+                }
+              } else if (line === "data: [DONE]") {
+              }
+            }
+          }
+          if (pendingToolCalls && pendingToolCalls.length > 0) {
+            toolResults = await Promise.all(
+              pendingToolCalls.map(async (tc) => {
+                const handler = tools[tc.toolName];
+                if (!handler) {
+                  return {
+                    toolCallId: tc.toolCallId,
+                    toolName: tc.toolName,
+                    error: `No handler for tool: ${tc.toolName}`,
+                    outputVariable: tc.outputVariable,
+                    blockIndex: tc.blockIndex
+                  };
+                }
+                try {
+                  const result = await handler(tc.args);
+                  return {
+                    toolCallId: tc.toolCallId,
+                    toolName: tc.toolName,
+                    result,
+                    outputVariable: tc.outputVariable,
+                    blockIndex: tc.blockIndex
+                  };
+                } catch (err) {
+                  return {
+                    toolCallId: tc.toolCallId,
+                    toolName: tc.toolName,
+                    error: err instanceof Error ? err.message : "Tool execution failed",
+                    outputVariable: tc.outputVariable,
+                    blockIndex: tc.blockIndex
+                  };
+                }
+              })
+            );
+            for (const tr of toolResults) {
+              if (tr.error) {
+                await streamWriter.write(
+                  encoder.encode(
+                    `data: ${JSON.stringify({ type: "tool-call-error", toolCallId: tr.toolCallId, error: tr.error })}
+
+`
+                  )
+                );
+              } else {
+                await streamWriter.write(
+                  encoder.encode(
+                    `data: ${JSON.stringify({ type: "tool-call-result", toolCallId: tr.toolCallId, result: tr.result })}
+
+`
+                  )
+                );
+              }
+            }
+          } else {
+            continueLoop = false;
+          }
+        }
+        await streamWriter.write(encoder.encode("data: [DONE]\n\n"));
+        await streamWriter.close();
+      } catch (err) {
+        await streamWriter.write(
+          encoder.encode(
+            `data: ${JSON.stringify({ type: "error", message: err instanceof Error ? err.message : "Unknown error" })}
+
+`
+          )
+        );
+        await streamWriter.close();
+      }
+    }
+    void executeContinuationLoop();
+    return { stream: readable };
+  }
+  getSessionId() {
+    return this.sessionId;
+  }
+  handleResourceUpdate(name, value) {
+    const resource = this.resourceMap.get(name);
+    if (resource) {
+      void resource.onUpdate(value);
+    }
+  }
+};
+
+// src/agent-sessions.ts
+var createSessionResponseSchema = z3.object({
+  sessionId: z3.string()
+});
+var sessionStateSchema = z3.object({
+  id: z3.string(),
+  agentId: z3.string(),
+  input: z3.record(z3.string(), z3.unknown()),
+  variables: z3.record(z3.string(), z3.unknown()),
+  resources: z3.record(z3.string(), z3.unknown()),
+  messages: z3.array(chatMessageSchema),
+  createdAt: z3.string(),
+  updatedAt: z3.string()
+});
+var AgentSessionsApi = class extends BaseApiClient {
+  /** Create a new session for an agent */
+  async create(agentId, input) {
+    const response = await this.httpPost(
+      "/api/agent-sessions",
+      { agentId, input },
+      createSessionResponseSchema
+    );
+    return response.sessionId;
+  }
+  /** Get session state */
+  async get(sessionId) {
+    return await this.httpGet(`/api/agent-sessions/${sessionId}`, sessionStateSchema);
+  }
+  /** Attach to an existing session for triggering events */
+  attach(sessionId, options = {}) {
+    return new AgentSession({
+      sessionId,
+      config: this.config,
+      tools: options.tools,
+      resources: options.resources
+    });
+  }
+};
+
+// src/client.ts
+var OctavusClient = class {
+  agents;
+  agentSessions;
+  baseUrl;
+  apiKey;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    const apiConfig = {
+      baseUrl: this.baseUrl,
+      getHeaders: () => this.getHeaders()
+    };
+    this.agents = new AgentsApi(apiConfig);
+    this.agentSessions = new AgentSessionsApi(apiConfig);
+  }
+  getHeaders() {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers.Authorization = `Bearer ${this.apiKey}`;
+    }
+    return headers;
+  }
+};
+
+// src/resource.ts
+var Resource = class {
+};
+export {
+  AgentSession,
+  AgentSessionsApi,
+  AgentsApi,
+  ApiError,
+  OctavusClient,
+  Resource,
+  agentCreateResponseSchema,
+  agentDefinitionInputSchema,
+  agentDefinitionSchema,
+  agentFormatSchema,
+  agentPromptSchema,
+  agentSchema,
+  agentSettingsInputSchema,
+  agentUpdateResponseSchema,
+  agentsResponseSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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/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/**\n * Agent settings input - used when creating/updating agents\n */\nexport interface AgentSettingsInput {\n  slug: string;\n  name: string;\n  description?: string;\n  format: AgentFormat;\n}\n\n/**\n * Agent prompt - shared between input and response\n */\nexport interface AgentPrompt {\n  name: string;\n  content: string;\n}\n\n/**\n * Input for creating/updating an agent definition\n */\nexport interface AgentDefinitionInput {\n  settings: AgentSettingsInput;\n  protocol: string;\n  prompts: AgentPrompt[];\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  /** Database 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: AgentSettingsInput;\n  protocol: string;\n  prompts: AgentPrompt[];\n  /** Database ID - use this for API calls like createSession */\n  id: string;\n}\n\n// Schemas\n\nexport const agentFormatSchema = z.enum(['interactive', 'generation']);\n\nexport const agentSettingsInputSchema = z.object({\n  slug: z.string().min(1),\n  name: z.string().min(1),\n  description: z.string().optional(),\n  format: agentFormatSchema,\n});\n\nexport const agentPromptSchema = z.object({\n  name: z.string().min(1),\n  content: z.string(),\n});\n\nexport const agentDefinitionInputSchema = z.object({\n  settings: agentSettingsInputSchema,\n  protocol: z.string().min(1),\n  prompts: z.array(agentPromptSchema),\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: agentSettingsInputSchema,\n  protocol: z.string(),\n  prompts: z.array(agentPromptSchema),\n  id: z.string(),\n});\n\nexport const agentCreateResponseSchema = z.object({\n  agentId: z.string(),\n  message: z.string(),\n});\n\nexport const agentUpdateResponseSchema = z.object({\n  agentId: z.string(),\n  message: z.string(),\n});\n","import { BaseApiClient, ApiError } from '@/base-api-client.js';\nimport {\n  agentsResponseSchema,\n  agentDefinitionSchema,\n  agentCreateResponseSchema,\n  agentUpdateResponseSchema,\n  type Agent,\n  type AgentDefinition,\n  type AgentDefinitionInput,\n  type AgentPrompt,\n} from '@/agent-types.js';\n\nexport interface AgentUpdateInput {\n  protocol?: string;\n  prompts?: AgentPrompt[];\n}\n\n/** API for managing agent definitions */\nexport class AgentsApi extends BaseApiClient {\n  /** List all agents */\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  /** Get a single agent by slug */\n  async getBySlug(slug: string): Promise<AgentDefinition | null> {\n    try {\n      return await this.httpGet(`/api/agents/${slug}?by=slug`, agentDefinitionSchema);\n    } catch (error) {\n      if (error instanceof ApiError && error.status === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  /** Create a new agent. Throws if agent with same slug exists. */\n  async create(definition: AgentDefinitionInput): Promise<string> {\n    const response = await this.httpPost('/api/agents', definition, agentCreateResponseSchema);\n    return response.agentId;\n  }\n\n  /** Partial update of an existing agent by ID */\n  async update(agentId: string, update: AgentUpdateInput): Promise<string> {\n    const response = await this.httpPatch(\n      `/api/agents/${agentId}`,\n      update,\n      agentUpdateResponseSchema,\n    );\n    return response.agentId;\n  }\n\n  /** Partial update of an existing agent by slug */\n  async updateBySlug(slug: string, update: AgentUpdateInput): Promise<string> {\n    const response = await this.httpPatch(\n      `/api/agents/${slug}?by=slug`,\n      update,\n      agentUpdateResponseSchema,\n    );\n    return response.agentId;\n  }\n\n  /**\n   * Sync an agent definition - creates if new, updates if exists\n   * Returns { agentId, created: boolean }\n   */\n  async sync(definition: AgentDefinitionInput): Promise<{ agentId: string; created: boolean }> {\n    const existing = await this.getBySlug(definition.settings.slug);\n\n    if (existing) {\n      // Update existing agent\n      const agentId = await this.update(existing.id, {\n        protocol: definition.protocol,\n        prompts: definition.prompts,\n      });\n      return { agentId, created: false };\n    }\n    // Create new agent\n    const agentId = await this.create(definition);\n    return { agentId, created: true };\n  }\n}\n","import { z } from 'zod';\nimport { chatMessageSchema, type ChatMessage, type ToolHandlers } 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\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 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  /** Get session state */\n  async get(sessionId: string): Promise<SessionState> {\n    return await this.httpGet(`/api/agent-sessions/${sessionId}`, sessionStateSchema);\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  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\nexport interface SessionConfig {\n  sessionId: string;\n  config: ApiClientConfig;\n  tools?: ToolHandlers;\n  resources?: Resource[];\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.\n   *\n   * This method:\n   * 1. POSTs to the platform trigger endpoint\n   * 2. Reads the SSE stream, forwarding events to 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  trigger(\n    triggerName: string,\n    triggerInput?: Record<string, unknown>,\n  ): {\n    stream: ReadableStream<Uint8Array>;\n  } {\n    const encoder = new TextEncoder();\n    const sessionId = this.sessionId;\n    const config = this.config;\n    const tools = this.toolHandlers;\n    const onResourceUpdate = (name: string, value: unknown) =>\n      this.handleResourceUpdate(name, value);\n\n    // Use a TransformStream to create a controllable output\n    const { readable, writable } = new TransformStream<Uint8Array, Uint8Array>();\n    const streamWriter = writable.getWriter();\n\n    // Execute the continuation loop in the background\n    async function executeContinuationLoop() {\n      let toolResults: ToolResult[] | undefined;\n      let continueLoop = true;\n\n      try {\n        while (continueLoop) {\n          // Make request to platform (with toolResults on continuation)\n          const response = await fetch(\n            `${config.baseUrl}/api/agent-sessions/${sessionId}/trigger`,\n            {\n              method: 'POST',\n              headers: config.getHeaders(),\n              body: JSON.stringify({ triggerName, input: triggerInput, toolResults }),\n            },\n          );\n\n          if (!response.ok) {\n            const { message } = await parseApiError(response, 'Failed to trigger');\n            await streamWriter.write(\n              encoder.encode(`data: ${JSON.stringify({ type: 'error', message })}\\n\\n`),\n            );\n            await streamWriter.close();\n            return;\n          }\n\n          if (!response.body) {\n            throw new Error('Response body is not readable');\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            const { done, value } = await reader.read();\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                  // Handle done event\n                  if (event.type === 'done') {\n                    if (event.finishReason === 'tool-calls' && pendingToolCalls) {\n                      // Tools need execution - don't forward done yet\n                      continue;\n                    }\n                    // Forward done event and exit loop\n                    await streamWriter.write(encoder.encode(`data: ${JSON.stringify(event)}\\n\\n`));\n                    continueLoop = false;\n                    continue;\n                  }\n\n                  // Handle resource updates\n                  if (event.type === 'resource-update') {\n                    onResourceUpdate(event.name, event.value);\n                  }\n\n                  // Forward all other events to the consumer\n                  await streamWriter.write(encoder.encode(`data: ${JSON.stringify(event)}\\n\\n`));\n                } catch {\n                  // Skip malformed JSON\n                }\n              } else if (line === 'data: [DONE]') {\n                // Platform stream closed\n              }\n            }\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 = tools[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-call-result events immediately so UI updates right away\n            // (before making continuation request)\n            for (const tr of toolResults) {\n              if (tr.error) {\n                await streamWriter.write(\n                  encoder.encode(\n                    `data: ${JSON.stringify({ type: 'tool-call-error', toolCallId: tr.toolCallId, error: tr.error })}\\n\\n`,\n                  ),\n                );\n              } else {\n                await streamWriter.write(\n                  encoder.encode(\n                    `data: ${JSON.stringify({ type: 'tool-call-result', toolCallId: tr.toolCallId, result: tr.result })}\\n\\n`,\n                  ),\n                );\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        // Send final DONE marker\n        await streamWriter.write(encoder.encode('data: [DONE]\\n\\n'));\n        await streamWriter.close();\n      } catch (err) {\n        await streamWriter.write(\n          encoder.encode(\n            `data: ${JSON.stringify({ type: 'error', message: err instanceof Error ? err.message : 'Unknown error' })}\\n\\n`,\n          ),\n        );\n        await streamWriter.close();\n      }\n    }\n\n    void executeContinuationLoop();\n\n    return { stream: readable };\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 type { ApiClientConfig } from '@/base-api-client.js';\nimport { AgentsApi } from '@/agents.js';\nimport { AgentSessionsApi } from '@/agent-sessions.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 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  }\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","agentId","z","z"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@octavus/server-sdk",
+  "version": "0.0.1",
+  "description": "Server SDK for integrating Octavus agents",
+  "license": "MIT",
+  "author": "Octavus AI <hello@octavus.ai>",
+  "homepage": "https://octavus.dev",
+  "keywords": [
+    "octavus",
+    "ai",
+    "agents",
+    "sdk",
+    "server",
+    "tools"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.1.13",
+    "@octavus/core": "^0.0.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/ --max-warnings 0",
+    "lint:fix": "eslint src/ --max-warnings 0 --fix",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}