@operator-labs/sdk 0.1.0

package/README.md

@@ -0,0 +1,212 @@
+# @operator-labs/sdk
+
+TypeScript SDK for the Operator platform. Manage agents, chat, instances, automations, and webhooks programmatically using a Chat API key.
+
+## Installation
+
+```bash
+npm install @operator-labs/sdk
+```
+
+Or link locally during development:
+
+```bash
+cd sdk && npm link
+```
+
+## Quick Start
+
+```ts
+import { Operator } from "@operator-labs/sdk";
+
+const op = new Operator({ apiKey: "ck_live_..." });
+
+// Check auth
+const status = await op.health();
+console.log(status.planName, status.email);
+
+// Send a message to the AI fleet manager
+const stream = await op.chat.send("List my instances");
+for await (const event of stream) {
+  if (event.type === "text-delta") process.stdout.write(event.text);
+}
+console.log();
+
+// Or collect the full response
+const { text } = await op.chat.sendAndWait("What's my current plan?");
+console.log(text);
+```
+
+## Configuration
+
+```ts
+const op = new Operator({
+  apiKey: "ck_live_...",               // Required — Chat API key from the dashboard
+  baseUrl: "https://www.operator.io",  // Optional — defaults to production
+});
+```
+
+For local development, set `baseUrl` to `http://localhost:3000`.
+
+## Getting an API Key
+
+1. Go to **Settings > API Keys** in the Operator dashboard
+2. Click **Create Key**
+3. Copy the key (starts with `ck_live_` or `ck_dev_`)
+
+## API Reference
+
+### Health
+
+```ts
+const status = await op.health();
+// { authenticated: true, userId: "...", planSlug: "pro", planName: "Pro", ... }
+```
+
+### Chat
+
+```ts
+// List all chats
+const chats = await op.chat.list();
+
+// Get a chat with messages
+const detail = await op.chat.get("chat-uuid");
+
+// Send a streaming message
+const stream = await op.chat.send("Create a new instance called my-agent");
+for await (const event of stream) {
+  switch (event.type) {
+    case "text-delta":
+      process.stdout.write(event.text);
+      break;
+    case "tool-call":
+      console.log(`Tool: ${event.toolName}`, event.args);
+      break;
+    case "tool-result":
+      console.log(`Result: ${event.toolName}`, event.result);
+      break;
+  }
+}
+
+// Send and wait for full response
+const { chatId, text } = await op.chat.sendAndWait("Restart instance abc");
+
+// Continue a conversation
+const stream2 = await op.chat.send("Now check its logs", { chatId });
+
+// Update title / delete
+await op.chat.updateTitle("chat-uuid", "Deployment Chat");
+await op.chat.delete("chat-uuid");
+```
+
+### Instances
+
+```ts
+// List instances
+const instances = await op.instances.list();
+
+// Get instance details
+const instance = await op.instances.get("instance-uuid");
+
+// Create a new instance
+const newInstance = await op.instances.create({ name: "my-agent" });
+
+// Create from a checkpoint repo
+const cloned = await op.instances.create({
+  name: "from-checkpoint",
+  checkpointRepo: "owner/repo",
+});
+
+// Update instance
+await op.instances.update("instance-uuid", { name: "renamed-agent" });
+
+// Restart (syncs config + secrets first)
+await op.instances.restart("instance-uuid");
+
+// Get logs
+const logs = await op.instances.logs("instance-uuid");
+
+// Config management
+const config = await op.instances.getConfig("instance-uuid");
+await op.instances.updateConfig("instance-uuid", { ...config, name: "updated" });
+
+// Delete
+await op.instances.delete("instance-uuid");
+```
+
+### Automations
+
+```ts
+// List automations
+const automations = await op.automations.list();
+
+// Create a scheduled automation
+const automation = await op.automations.create({
+  name: "Daily health check",
+  prompt: "Check all instances and report any issues",
+  cronExpression: "0 9 * * *",
+  timezone: "America/New_York",
+});
+
+// Update
+await op.automations.update(automation.id, {
+  cronExpression: "0 */6 * * *",
+  enabled: false,
+});
+
+// Delete
+await op.automations.delete(automation.id);
+```
+
+### Webhooks
+
+```ts
+// List webhooks
+const webhooks = await op.webhooks.list();
+
+// Create a webhook
+const webhook = await op.webhooks.create({
+  name: "GitHub PR Handler",
+  promptTemplate: "A new PR was opened: {{payload}}. Review and summarize it.",
+});
+
+// Update
+await op.webhooks.update(webhook.id, { enabled: false });
+
+// Delete
+await op.webhooks.delete(webhook.id);
+```
+
+## Error Handling
+
+All API errors throw `OperatorApiError` with `status` and `body`:
+
+```ts
+import { Operator, OperatorApiError } from "@operator-labs/sdk";
+
+try {
+  await op.instances.get("nonexistent");
+} catch (err) {
+  if (err instanceof OperatorApiError) {
+    console.error(`HTTP ${err.status}: ${err.message}`);
+  }
+}
+```
+
+## Stream Events
+
+When using `op.chat.send()`, the returned `ChatStream` yields these event types:
+
+| Type | Fields | Description |
+|------|--------|-------------|
+| `text-delta` | `text` | Incremental text from the AI |
+| `tool-call` | `toolName`, `args` | AI is calling a tool |
+| `tool-result` | `toolName`, `result` | Tool execution result |
+| `step-finish` | | A processing step completed |
+| `finish` | `messages` | Stream finished |
+| `error` | `error` | Error occurred |
+
+## Requirements
+
+- Node.js 18+ (uses native `fetch`)
+- A valid Operator Chat API key

package/dist/client.d.ts

@@ -0,0 +1,18 @@
+import { type OperatorOptions } from "./types.js";
+export declare class HttpClient {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    constructor(options: OperatorOptions);
+    private headers;
+    request<T = unknown>(method: string, path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
+    /**
+     * Make a streaming POST request. Returns the raw Response for SSE parsing.
+     */
+    streamPost(path: string, body: unknown): Promise<Response>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAIpE,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,eAAe;IAQpC,OAAO,CAAC,OAAO;IAQT,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC;IA+BP,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1C,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5D,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAInD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CA0BjE"}

package/dist/client.js

@@ -0,0 +1,90 @@
+import { OperatorApiError } from "./types.js";
+const DEFAULT_BASE_URL = "https://www.operator.io";
+export class HttpClient {
+    baseUrl;
+    apiKey;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new Error("operator-sdk: apiKey is required");
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    }
+    headers(extra) {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            ...extra,
+        };
+    }
+    async request(method, path, body, extraHeaders) {
+        const url = `${this.baseUrl}${path}`;
+        const init = {
+            method,
+            headers: this.headers(extraHeaders),
+        };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        const res = await fetch(url, init);
+        if (!res.ok) {
+            let errorBody;
+            try {
+                errorBody = await res.json();
+            }
+            catch {
+                errorBody = await res.text().catch(() => null);
+            }
+            const message = typeof errorBody === "object" &&
+                errorBody !== null &&
+                "error" in errorBody
+                ? String(errorBody.error)
+                : `Request failed with status ${res.status}`;
+            throw new OperatorApiError(message, res.status, errorBody);
+        }
+        return res.json();
+    }
+    async get(path) {
+        return this.request("GET", path);
+    }
+    async post(path, body, extraHeaders) {
+        return this.request("POST", path, body, extraHeaders);
+    }
+    async put(path, body) {
+        return this.request("PUT", path, body);
+    }
+    async patch(path, body) {
+        return this.request("PATCH", path, body);
+    }
+    async delete(path) {
+        return this.request("DELETE", path);
+    }
+    /**
+     * Make a streaming POST request. Returns the raw Response for SSE parsing.
+     */
+    async streamPost(path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            let errorBody;
+            try {
+                errorBody = await res.json();
+            }
+            catch {
+                errorBody = await res.text().catch(() => null);
+            }
+            const message = typeof errorBody === "object" &&
+                errorBody !== null &&
+                "error" in errorBody
+                ? String(errorBody.error)
+                : `Request failed with status ${res.status}`;
+            throw new OperatorApiError(message, res.status, errorBody);
+        }
+        return res;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { ChatResource } from "./resources/chat.js";
+import { InstancesResource } from "./resources/instances.js";
+import { AutomationsResource } from "./resources/automations.js";
+import { WebhooksResource } from "./resources/webhooks.js";
+import type { OperatorOptions, HealthResponse } from "./types.js";
+export declare class Operator {
+    private readonly http;
+    /** Chat conversations — send messages, list history, manage threads */
+    readonly chat: ChatResource;
+    /** Agent instances — create, configure, restart, view logs */
+    readonly instances: InstancesResource;
+    /** Cron-scheduled automations */
+    readonly automations: AutomationsResource;
+    /** HTTP webhooks that trigger AI processing */
+    readonly webhooks: WebhooksResource;
+    private readonly healthResource;
+    constructor(options: OperatorOptions);
+    /**
+     * Check authentication status and plan info.
+     *
+     * @example
+     * ```ts
+     * const status = await op.health();
+     * console.log(status.authenticated, status.planName);
+     * ```
+     */
+    health(): Promise<HealthResponse>;
+}
+export type { OperatorOptions, HealthResponse, Chat, ChatMessage, ChatDetail, MessagePart, SendMessageOptions, SendMessageResponse, StreamEvent, Instance, CreateInstanceOptions, LogEntry, Automation, CreateAutomationOptions, UpdateAutomationOptions, Webhook, CreateWebhookOptions, UpdateWebhookOptions, } from "./types.js";
+export { OperatorApiError } from "./types.js";
+export { ChatStream } from "./stream.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAEtC,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAE1C,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAEpC,OAAO,EAAE,eAAe;IASpC;;;;;;;;OAQG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;CAGxC;AAGD,YAAY,EACV,eAAe,EACf,cAAc,EACd,IAAI,EACJ,WAAW,EACX,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,qBAAqB,EACrB,QAAQ,EACR,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,OAAO,EACP,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,41 @@
+import { HttpClient } from "./client.js";
+import { HealthResource } from "./resources/health.js";
+import { ChatResource } from "./resources/chat.js";
+import { InstancesResource } from "./resources/instances.js";
+import { AutomationsResource } from "./resources/automations.js";
+import { WebhooksResource } from "./resources/webhooks.js";
+export class Operator {
+    http;
+    /** Chat conversations — send messages, list history, manage threads */
+    chat;
+    /** Agent instances — create, configure, restart, view logs */
+    instances;
+    /** Cron-scheduled automations */
+    automations;
+    /** HTTP webhooks that trigger AI processing */
+    webhooks;
+    healthResource;
+    constructor(options) {
+        this.http = new HttpClient(options);
+        this.chat = new ChatResource(this.http);
+        this.instances = new InstancesResource(this.http);
+        this.automations = new AutomationsResource(this.http);
+        this.webhooks = new WebhooksResource(this.http);
+        this.healthResource = new HealthResource(this.http);
+    }
+    /**
+     * Check authentication status and plan info.
+     *
+     * @example
+     * ```ts
+     * const status = await op.health();
+     * console.log(status.authenticated, status.planName);
+     * ```
+     */
+    async health() {
+        return this.healthResource.check();
+    }
+}
+export { OperatorApiError } from "./types.js";
+export { ChatStream } from "./stream.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,OAAO,QAAQ;IACF,IAAI,CAAa;IAElC,uEAAuE;IAC9D,IAAI,CAAe;IAE5B,8DAA8D;IACrD,SAAS,CAAoB;IAEtC,iCAAiC;IACxB,WAAW,CAAsB;IAE1C,+CAA+C;IACtC,QAAQ,CAAmB;IAEnB,cAAc,CAAiB;IAEhD,YAAY,OAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;CACF;AAwBD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/resources/automations.d.ts

@@ -0,0 +1,27 @@
+import type { HttpClient } from "../client.js";
+import type { Automation, CreateAutomationOptions, UpdateAutomationOptions } from "../types.js";
+export declare class AutomationsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all automations for the authenticated user.
+     */
+    list(): Promise<Automation[]>;
+    /**
+     * Get a single automation by ID.
+     */
+    get(automationId: string): Promise<Automation>;
+    /**
+     * Create a new automation with a cron schedule.
+     */
+    create(options: CreateAutomationOptions): Promise<Automation>;
+    /**
+     * Update an existing automation.
+     */
+    update(automationId: string, options: UpdateAutomationOptions): Promise<Automation>;
+    /**
+     * Delete an automation and its associated schedule.
+     */
+    delete(automationId: string): Promise<void>;
+}
+//# sourceMappingURL=automations.d.ts.map

package/dist/resources/automations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../src/resources/automations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAErB,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAOnC;;OAEG;IACG,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAanE;;OAEG;IACG,MAAM,CACV,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,UAAU,CAAC;IAQtB;;OAEG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD"}

package/dist/resources/automations.js

@@ -0,0 +1,45 @@
+export class AutomationsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List all automations for the authenticated user.
+     */
+    async list() {
+        const data = await this.http.get("/api/automations");
+        return data.automations;
+    }
+    /**
+     * Get a single automation by ID.
+     */
+    async get(automationId) {
+        return this.http.get(`/api/automations/${automationId}`);
+    }
+    /**
+     * Create a new automation with a cron schedule.
+     */
+    async create(options) {
+        const data = await this.http.post("/api/automations", {
+            name: options.name,
+            prompt: options.prompt,
+            cronExpression: options.cronExpression,
+            timezone: options.timezone ?? "UTC",
+        });
+        return data.automation;
+    }
+    /**
+     * Update an existing automation.
+     */
+    async update(automationId, options) {
+        const data = await this.http.put(`/api/automations/${automationId}`, options);
+        return data.automation;
+    }
+    /**
+     * Delete an automation and its associated schedule.
+     */
+    async delete(automationId) {
+        await this.http.delete(`/api/automations/${automationId}`);
+    }
+}
+//# sourceMappingURL=automations.js.map

package/dist/resources/automations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations.js","sourceRoot":"","sources":["../../src/resources/automations.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,kBAAkB,CACnB,CAAC;QACF,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,YAAoB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAa,oBAAoB,YAAY,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAgC;QAC3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAC/B,kBAAkB,EAClB;YACE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;SACpC,CACF,CAAC;QACF,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,OAAgC;QAEhC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,oBAAoB,YAAY,EAAE,EAClC,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,YAAoB;QAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,oBAAoB,YAAY,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/resources/chat.d.ts

@@ -0,0 +1,58 @@
+import type { HttpClient } from "../client.js";
+import type { Chat, ChatDetail, SendMessageOptions, SendMessageResponse } from "../types.js";
+import { ChatStream } from "../stream.js";
+export declare class ChatResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all chats for the authenticated user.
+     */
+    list(): Promise<Chat[]>;
+    /**
+     * Get a chat with its messages.
+     */
+    get(chatId: string): Promise<ChatDetail>;
+    /**
+     * Delete a chat.
+     */
+    delete(chatId: string): Promise<void>;
+    /**
+     * Update a chat's title.
+     */
+    updateTitle(chatId: string, title: string): Promise<void>;
+    /**
+     * Send a message and receive the complete AI response as JSON.
+     *
+     * Waits for the full response (including any tool calls) before returning.
+     * Use `stream()` if you need incremental token-by-token output.
+     *
+     * @example
+     * ```ts
+     * const { chatId, text } = await op.chat.send("List my instances");
+     * console.log(text);
+     * ```
+     *
+     * @example Continue a conversation
+     * ```ts
+     * const first = await op.chat.send("Create an instance called my-agent");
+     * const second = await op.chat.send("Now restart it", { chatId: first.chatId });
+     * ```
+     */
+    send(message: string, options?: SendMessageOptions): Promise<SendMessageResponse>;
+    /**
+     * Send a message and get a real-time streaming response.
+     *
+     * The returned ChatStream is an async iterable of StreamEvents.
+     * Use `stream.textStream()` for text deltas only, or `stream.toText()` to collect.
+     *
+     * @example
+     * ```ts
+     * const stream = await op.chat.stream("List my instances");
+     * for await (const event of stream) {
+     *   if (event.type === "text-delta") process.stdout.write(event.text);
+     * }
+     * ```
+     */
+    stream(message: string, options?: SendMessageOptions): Promise<ChatStream>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/resources/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EAEV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAK7B;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAiB/B;;;;;;;;;;;;;OAaG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,CAAC;CAiBvB"}

package/dist/resources/chat.js

@@ -0,0 +1,90 @@
+import { ChatStream } from "../stream.js";
+const JSON_MODE_HEADER = { "x-response-format": "json" };
+export class ChatResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List all chats for the authenticated user.
+     */
+    async list() {
+        const data = await this.http.get("/api/chat/history");
+        return data.chats;
+    }
+    /**
+     * Get a chat with its messages.
+     */
+    async get(chatId) {
+        return this.http.get(`/api/chat/${chatId}`);
+    }
+    /**
+     * Delete a chat.
+     */
+    async delete(chatId) {
+        await this.http.delete(`/api/chat/${chatId}`);
+    }
+    /**
+     * Update a chat's title.
+     */
+    async updateTitle(chatId, title) {
+        await this.http.patch(`/api/chat/${chatId}`, { title });
+    }
+    /**
+     * Send a message and receive the complete AI response as JSON.
+     *
+     * Waits for the full response (including any tool calls) before returning.
+     * Use `stream()` if you need incremental token-by-token output.
+     *
+     * @example
+     * ```ts
+     * const { chatId, text } = await op.chat.send("List my instances");
+     * console.log(text);
+     * ```
+     *
+     * @example Continue a conversation
+     * ```ts
+     * const first = await op.chat.send("Create an instance called my-agent");
+     * const second = await op.chat.send("Now restart it", { chatId: first.chatId });
+     * ```
+     */
+    async send(message, options) {
+        const chatId = options?.chatId ?? crypto.randomUUID();
+        const messages = [
+            {
+                role: "user",
+                parts: [{ type: "text", text: message }],
+            },
+        ];
+        return this.http.post("/api/chat", { id: chatId, messages }, JSON_MODE_HEADER);
+    }
+    /**
+     * Send a message and get a real-time streaming response.
+     *
+     * The returned ChatStream is an async iterable of StreamEvents.
+     * Use `stream.textStream()` for text deltas only, or `stream.toText()` to collect.
+     *
+     * @example
+     * ```ts
+     * const stream = await op.chat.stream("List my instances");
+     * for await (const event of stream) {
+     *   if (event.type === "text-delta") process.stdout.write(event.text);
+     * }
+     * ```
+     */
+    async stream(message, options) {
+        const chatId = options?.chatId ?? crypto.randomUUID();
+        const messages = [
+            {
+                role: "user",
+                parts: [{ type: "text", text: message }],
+            },
+        ];
+        const response = await this.http.streamPost("/api/chat", {
+            id: chatId,
+            messages,
+        });
+        return new ChatStream(response);
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/resources/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,gBAAgB,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAW,CAAC;AAElE,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAoB,mBAAmB,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAa,aAAa,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,KAAa;QAC7C,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,IAAI,CACR,OAAe,EACf,OAA4B;QAE5B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAEtD,MAAM,QAAQ,GAAG;YACf;gBACE,IAAI,EAAE,MAAe;gBACrB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAyB;aACjE;SACF,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,WAAW,EACX,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EACxB,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,OAA4B;QAE5B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAEtD,MAAM,QAAQ,GAAG;YACf;gBACE,IAAI,EAAE,MAAe;gBACrB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAyB;aACjE;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;YACvD,EAAE,EAAE,MAAM;YACV,QAAQ;SACT,CAAC,CAAC;QAEH,OAAO,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/resources/health.d.ts

@@ -0,0 +1,11 @@
+import type { HttpClient } from "../client.js";
+import type { HealthResponse } from "../types.js";
+export declare class HealthResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Check authentication status and plan info.
+     */
+    check(): Promise<HealthResponse>;
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/resources/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/resources/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;CAGvC"}