@operator-labs/sdk 0.1.0

package/dist/resources/health.js

@@ -0,0 +1,13 @@
+export class HealthResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Check authentication status and plan info.
+     */
+    async check() {
+        return this.http.get("/api/cli/health");
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/resources/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/resources/health.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,iBAAiB,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/resources/instances.d.ts

@@ -0,0 +1,48 @@
+import type { HttpClient } from "../client.js";
+import type { Instance, CreateInstanceOptions, LogEntry } from "../types.js";
+export declare class InstancesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all instances for the authenticated user.
+     */
+    list(): Promise<Instance[]>;
+    /**
+     * Get a single instance by ID.
+     */
+    get(instanceId: string): Promise<Instance>;
+    /**
+     * Create a new instance. Returns immediately while provisioning happens in the background.
+     */
+    create(options: CreateInstanceOptions): Promise<Instance>;
+    /**
+     * Update an instance (name, config, allowUserConfig, avatarUrl).
+     */
+    update(instanceId: string, updates: {
+        name?: string;
+        config?: Record<string, unknown>;
+        allowUserConfig?: boolean;
+        avatarUrl?: string;
+    }): Promise<Instance>;
+    /**
+     * Delete an instance. The container is cleaned up asynchronously.
+     */
+    delete(instanceId: string): Promise<void>;
+    /**
+     * Restart an instance. Syncs config and secrets before restarting.
+     */
+    restart(instanceId: string): Promise<void>;
+    /**
+     * Get recent logs for an instance.
+     */
+    logs(instanceId: string): Promise<LogEntry[]>;
+    /**
+     * Get an instance's config.
+     */
+    getConfig(instanceId: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Update an instance's config (full replace).
+     */
+    updateConfig(instanceId: string, config: Record<string, unknown>): Promise<Instance>;
+}
+//# sourceMappingURL=instances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/resources/instances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,QAAQ,EACT,MAAM,aAAa,CAAC;AAErB,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKjC;;OAEG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOhD;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ/D;;OAEG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,QAAQ,CAAC;IAQpB;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOnD;;OAEG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAO5E;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,QAAQ,CAAC;CAOrB"}

package/dist/resources/instances.js

@@ -0,0 +1,71 @@
+export class InstancesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List all instances for the authenticated user.
+     */
+    async list() {
+        const data = await this.http.get("/api/instances");
+        return data.instances;
+    }
+    /**
+     * Get a single instance by ID.
+     */
+    async get(instanceId) {
+        const data = await this.http.get(`/api/instances/${instanceId}`);
+        return data.instance;
+    }
+    /**
+     * Create a new instance. Returns immediately while provisioning happens in the background.
+     */
+    async create(options) {
+        const data = await this.http.post("/api/instances", {
+            name: options.name,
+            ...(options.checkpointRepo ? { checkpointRepo: options.checkpointRepo } : {}),
+        });
+        return data.instance;
+    }
+    /**
+     * Update an instance (name, config, allowUserConfig, avatarUrl).
+     */
+    async update(instanceId, updates) {
+        const data = await this.http.patch(`/api/instances/${instanceId}`, updates);
+        return data.instance;
+    }
+    /**
+     * Delete an instance. The container is cleaned up asynchronously.
+     */
+    async delete(instanceId) {
+        await this.http.delete(`/api/instances/${instanceId}`);
+    }
+    /**
+     * Restart an instance. Syncs config and secrets before restarting.
+     */
+    async restart(instanceId) {
+        await this.http.post(`/api/instances/${instanceId}/restart`);
+    }
+    /**
+     * Get recent logs for an instance.
+     */
+    async logs(instanceId) {
+        const data = await this.http.get(`/api/instances/${instanceId}/logs`);
+        return data.logs;
+    }
+    /**
+     * Get an instance's config.
+     */
+    async getConfig(instanceId) {
+        const data = await this.http.get(`/api/instances/${instanceId}`);
+        return data.instance.config ?? null;
+    }
+    /**
+     * Update an instance's config (full replace).
+     */
+    async updateConfig(instanceId, config) {
+        const data = await this.http.put(`/api/instances/${instanceId}/config`, { config });
+        return data.instance;
+    }
+}
+//# sourceMappingURL=instances.js.map

package/dist/resources/instances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../src/resources/instances.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,iBAAiB;IACC;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,CAA4B,gBAAgB,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,UAAkB;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,kBAAkB,UAAU,EAAE,CAC/B,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAA8B;QACzC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAyB,gBAAgB,EAAE;YAC1E,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9E,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,UAAkB,EAClB,OAKC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAChC,kBAAkB,UAAU,EAAE,EAC9B,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,UAAU,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,UAAU,UAAU,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,kBAAkB,UAAU,OAAO,CACpC,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,UAAkB;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,kBAAkB,UAAU,EAAE,CAC/B,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,MAA+B;QAE/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,kBAAkB,UAAU,SAAS,EACrC,EAAE,MAAM,EAAE,CACX,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/resources/webhooks.d.ts

@@ -0,0 +1,27 @@
+import type { HttpClient } from "../client.js";
+import type { Webhook, CreateWebhookOptions, UpdateWebhookOptions } from "../types.js";
+export declare class WebhooksResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all webhooks for the authenticated user.
+     */
+    list(): Promise<Webhook[]>;
+    /**
+     * Get a single webhook by ID.
+     */
+    get(webhookId: string): Promise<Webhook>;
+    /**
+     * Create a new webhook. The promptTemplate must include {{payload}}.
+     */
+    create(options: CreateWebhookOptions): Promise<Webhook>;
+    /**
+     * Update an existing webhook.
+     */
+    update(webhookId: string, options: UpdateWebhookOptions): Promise<Webhook>;
+    /**
+     * Delete a webhook.
+     */
+    delete(webhookId: string): Promise<void>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAOhC;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAW7D;;OAEG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC;IAQnB;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}

package/dist/resources/webhooks.js

@@ -0,0 +1,43 @@
+export class WebhooksResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List all webhooks for the authenticated user.
+     */
+    async list() {
+        const data = await this.http.get("/api/webhooks");
+        return data.webhooks;
+    }
+    /**
+     * Get a single webhook by ID.
+     */
+    async get(webhookId) {
+        return this.http.get(`/api/webhooks/${webhookId}`);
+    }
+    /**
+     * Create a new webhook. The promptTemplate must include {{payload}}.
+     */
+    async create(options) {
+        const data = await this.http.post("/api/webhooks", {
+            name: options.name,
+            promptTemplate: options.promptTemplate,
+        });
+        return data.webhook;
+    }
+    /**
+     * Update an existing webhook.
+     */
+    async update(webhookId, options) {
+        const data = await this.http.put(`/api/webhooks/${webhookId}`, options);
+        return data.webhook;
+    }
+    /**
+     * Delete a webhook.
+     */
+    async delete(webhookId) {
+        await this.http.delete(`/api/webhooks/${webhookId}`);
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/resources/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,gBAAgB;IACE;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,eAAe,CAChB,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAU,iBAAiB,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAA6B;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAC/B,eAAe,EACf;YACE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CACF,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,OAA6B;QAE7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,iBAAiB,SAAS,EAAE,EAC5B,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/stream.d.ts

@@ -0,0 +1,27 @@
+import type { StreamEvent } from "./types.js";
+/**
+ * ChatStream wraps the SSE response from the Vercel AI SDK's
+ * `toUIMessageStreamResponse()` into a consumable async iterable.
+ *
+ * Supports:
+ * - `for await (const event of stream)` — iterate over parsed events
+ * - `stream.textStream()` — iterate over text deltas only
+ * - `stream.toText()` — collect the full text response
+ */
+export declare class ChatStream implements AsyncIterable<StreamEvent> {
+    private readonly response;
+    constructor(response: Response);
+    /**
+     * Iterate over all parsed stream events.
+     */
+    [Symbol.asyncIterator](): AsyncGenerator<StreamEvent>;
+    /**
+     * Iterate over text deltas only.
+     */
+    textStream(): AsyncGenerator<string>;
+    /**
+     * Collect the full text response.
+     */
+    toText(): Promise<string>;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;GAQG;AACH,qBAAa,UAAW,YAAW,aAAa,CAAC,WAAW,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAExB,QAAQ,EAAE,QAAQ;IAI9B;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,WAAW,CAAC;IAqC5D;;OAEG;IACI,UAAU,IAAI,cAAc,CAAC,MAAM,CAAC;IAQ3C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAOhC"}

package/dist/stream.js

@@ -0,0 +1,140 @@
+/**
+ * ChatStream wraps the SSE response from the Vercel AI SDK's
+ * `toUIMessageStreamResponse()` into a consumable async iterable.
+ *
+ * Supports:
+ * - `for await (const event of stream)` — iterate over parsed events
+ * - `stream.textStream()` — iterate over text deltas only
+ * - `stream.toText()` — collect the full text response
+ */
+export class ChatStream {
+    response;
+    constructor(response) {
+        this.response = response;
+    }
+    /**
+     * Iterate over all parsed stream events.
+     */
+    async *[Symbol.asyncIterator]() {
+        const body = this.response.body;
+        if (!body)
+            return;
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                // Keep the last incomplete line in the buffer
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed)
+                        continue;
+                    const event = parseLine(trimmed);
+                    if (event)
+                        yield event;
+                }
+            }
+            // Process any remaining buffer
+            if (buffer.trim()) {
+                const event = parseLine(buffer.trim());
+                if (event)
+                    yield event;
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /**
+     * Iterate over text deltas only.
+     */
+    async *textStream() {
+        for await (const event of this) {
+            if (event.type === "text-delta") {
+                yield event.text;
+            }
+        }
+    }
+    /**
+     * Collect the full text response.
+     */
+    async toText() {
+        let result = "";
+        for await (const chunk of this.textStream()) {
+            result += chunk;
+        }
+        return result;
+    }
+}
+/**
+ * Parse a single line from the Vercel AI SDK UIMessage stream protocol.
+ *
+ * The protocol uses lines like:
+ *   0:"text chunk"          — text delta
+ *   9:{...}                 — tool call
+ *   a:{...}                 — tool result
+ *   e:{...}                 — step finish
+ *   d:{...}                 — finish
+ *   3:"error message"       — error
+ */
+function parseLine(line) {
+    // Format: TYPE_CODE:JSON_VALUE
+    const colonIdx = line.indexOf(":");
+    if (colonIdx < 1)
+        return null;
+    const code = line.slice(0, colonIdx);
+    const payload = line.slice(colonIdx + 1);
+    try {
+        switch (code) {
+            case "0": {
+                // Text delta — payload is a JSON string
+                const text = JSON.parse(payload);
+                return { type: "text-delta", text };
+            }
+            case "9": {
+                // Tool call
+                const data = JSON.parse(payload);
+                return {
+                    type: "tool-call",
+                    toolName: data.toolName ?? "unknown",
+                    args: data.args ?? {},
+                };
+            }
+            case "a": {
+                // Tool result
+                const data = JSON.parse(payload);
+                return {
+                    type: "tool-result",
+                    toolName: data.toolName ?? "unknown",
+                    result: data.result,
+                };
+            }
+            case "e": {
+                // Step finish
+                return { type: "step-finish" };
+            }
+            case "d": {
+                // Finish
+                const data = JSON.parse(payload);
+                return { type: "finish", messages: data.messages ?? [] };
+            }
+            case "3": {
+                // Error
+                const error = JSON.parse(payload);
+                return { type: "error", error };
+            }
+            default:
+                return { type: "unknown", raw: line };
+        }
+    }
+    catch {
+        return { type: "unknown", raw: line };
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,148 @@
+export interface OperatorOptions {
+    /** Chat API key (ck_live_... or ck_dev_...) */
+    apiKey: string;
+    /** Base URL of the Operator app (defaults to https://www.operator.io) */
+    baseUrl?: string;
+}
+export interface HealthResponse {
+    authenticated: boolean;
+    userId?: string;
+    email?: string;
+    planSlug?: string | null;
+    planName?: string | null;
+    hasPlan?: boolean;
+    tokenLimit?: number;
+    error?: string;
+}
+export interface Chat {
+    id: string;
+    userId: string;
+    title: string;
+    automationId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ChatMessage {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    parts: MessagePart[];
+    createdAt: string;
+}
+export interface MessagePart {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+export interface ChatDetail {
+    chat: Chat;
+    messages: ChatMessage[];
+}
+export interface SendMessageOptions {
+    /** Existing chat ID to continue a conversation */
+    chatId?: string;
+}
+export interface SendMessageResponse {
+    /** The chat ID (new or existing) */
+    chatId: string;
+    /** The full text response from the AI */
+    text: string;
+}
+export type StreamEvent = {
+    type: "text-delta";
+    text: string;
+} | {
+    type: "tool-call";
+    toolName: string;
+    args: Record<string, unknown>;
+} | {
+    type: "tool-result";
+    toolName: string;
+    result: unknown;
+} | {
+    type: "step-finish";
+} | {
+    type: "finish";
+    messages: unknown[];
+} | {
+    type: "error";
+    error: string;
+} | {
+    type: "unknown";
+    raw: string;
+};
+export interface Instance {
+    id: string;
+    userId: string;
+    name: string;
+    status: string;
+    imageTag?: string | null;
+    azureServerName?: string | null;
+    allowUserConfig?: boolean;
+    config?: Record<string, unknown> | null;
+    checkpoint?: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt?: string;
+}
+export interface CreateInstanceOptions {
+    name: string;
+    checkpointRepo?: string;
+}
+export interface LogEntry {
+    timestamp: string;
+    message: string;
+}
+export interface Automation {
+    id: string;
+    userId: string;
+    name: string;
+    prompt: string;
+    cronExpression: string;
+    timezone: string;
+    enabled: boolean;
+    triggerScheduleId?: string | null;
+    chatId?: string | null;
+    lastRunAt?: string | null;
+    createdAt: string;
+    updatedAt?: string;
+}
+export interface CreateAutomationOptions {
+    name: string;
+    prompt: string;
+    cronExpression: string;
+    timezone?: string;
+}
+export interface UpdateAutomationOptions {
+    name?: string;
+    prompt?: string;
+    cronExpression?: string;
+    timezone?: string;
+    enabled?: boolean;
+}
+export interface Webhook {
+    id: string;
+    userId: string;
+    name: string;
+    promptTemplate: string;
+    enabled: boolean;
+    token: string;
+    triggerUrl?: string;
+    lastTriggeredAt?: string | null;
+    createdAt: string;
+    updatedAt?: string;
+}
+export interface CreateWebhookOptions {
+    name: string;
+    promptTemplate: string;
+}
+export interface UpdateWebhookOptions {
+    name?: string;
+    promptTemplate?: string;
+    enabled?: boolean;
+}
+export declare class OperatorApiError extends Error {
+    readonly status: number;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status: number, body?: unknown | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+// ─── Client Options ──────────────────────────────────────
+// ─── API Error ───────────────────────────────────────────
+export class OperatorApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "OperatorApiError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AA+J5D,4DAA4D;AAE5D,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,MAAc,EACd,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAU;QAG9B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@operator-labs/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Operator platform — manage agents, chat, instances, automations, and webhooks programmatically.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "tsx tests/integration.test.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "dotenv": "^16.4.5",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "operator",
+    "openclaw",
+    "sdk",
+    "ai",
+    "agents"
+  ]
+}