@operator-labs/sdk 0.1.6 → 0.1.7

package/README.md

@@ -1,8 +1,12 @@
 # @operator-labs/sdk
 
-TypeScript SDK for [Operator.io](https://operator.io). 
+TypeScript SDK for [Operator.io](https://operator.io).
 
-Manage [OpenClaw](https://openclaw.ai) agents programmatically using an API key from [Operator.io](https://operator.io). Design experiments, deploy [OpenClaw](https://openclaw.ai) across multiple usecases, and more.
+[Operator.io](https://operator.io) is the API for building, managing, and hosting [OpenClaw](https://openclaw.ai) agents using AI.
+
+Use `op.chat` when you want [Operator.io](https://operator.io) to create agents, update files and skills, inspect instances, run web searches, or handle multi-step work. 
+
+Use the typed methods for direct control over instances, config, automations, and webhooks.
 
 ## Installation
 
@@ -21,12 +25,17 @@ const op = new Operator({ apiKey: "ck_live_..." });
 const status = await op.health();
 console.log(status.planName, status.email);
 
-// Send a message to the AI fleet manager
-const { chatId, text } = await op.chat.send("List my instances");
+// Ask Operator.io to build and manage agents for you
+const { chatId, text } = await op.chat.send(
+  "Create a new OpenClaw agent for outbound sales research and install the skills it needs."
+);
 console.log(text);
 
 // Continue the conversation
-const followUp = await op.chat.send("Restart the first one", { chatId });
+const followUp = await op.chat.send(
+  "Now update its state files so it posts a daily summary at 9am Bangkok time.",
+  { chatId }
+);
 console.log(followUp.text);
 ```
 
@@ -34,13 +43,13 @@ console.log(followUp.text);
 
 ```ts
 const op = new Operator({
-  apiKey: "ck_live_...",  // Required — Chat API key from the dashboard
+  apiKey: "ck_live_...", // Required: Chat API key from the dashboard
 });
 ```
 
 ## Getting an API Key
 
-1. Go to **Settings > API Keys** in the Operator dashboard
+1. Go to **Settings > API Keys** in the [Operator.io](https://operator.io) dashboard
 2. Click **Create Key**
 3. Copy the key (starts with `ck_live_` or `ck_dev_`)
 
@@ -55,6 +64,8 @@ const status = await op.health();
 
 ### Chat
 
+`op.chat` is the main agent surface. Use it when you want [Operator.io](https://operator.io) to create agents, inspect an instance, read or mutate files, install or author skills, change agent behavior, run web research, or coordinate multi-step work. Use the typed resources below when you want direct control over common API objects.
+
 ```ts
 // List all chats
 const chats = await op.chat.list();
@@ -66,6 +77,12 @@ const detail = await op.chat.get("chat-uuid");
 const { chatId, text } = await op.chat.send("Create a new instance called my-agent");
 console.log(text);
 
+// Update agent files and skills through the agent
+const edit = await op.chat.send(
+  "Open the my-agent instance, update its core files for a stricter review style, install any missing skills, and summarize what changed."
+);
+console.log(edit.text);
+
 // Continue a conversation
 const followUp = await op.chat.send("Now check its logs", { chatId });
 console.log(followUp.text);
@@ -77,6 +94,8 @@ await op.chat.delete("chat-uuid");
 
 ### Instances
 
+Use `op.instances` for direct lifecycle and config management. If you want [Operator.io](https://operator.io) to inspect or evolve an instance filesystem or state, use `op.chat.send(...)`.
+
 ```ts
 // List instances
 const instances = await op.instances.list();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@operator-labs/sdk",
-  "version": "0.1.6",
-  "description": "TypeScript SDK for the Operator platform — manage agents, chat, instances, automations, and webhooks programmatically.",
+  "version": "0.1.7",
+  "description": "TypeScript SDK for Operator.io platform: manage agents, chat, instances, automations, and webhooks programmatically.",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",