@komputer-ai/sdk 0.11.2 → 0.11.5

package/.openapi-generator/FILES

@@ -0,0 +1,68 @@
+.gitignore
+docs/AgentListResponse.md
+docs/AgentResponse.md
+docs/AgentsApi.md
+docs/ConnectorResponse.md
+docs/ConnectorsApi.md
+docs/CreateAgentRequest.md
+docs/CreateConnectorRequest.md
+docs/CreateMemoryRequest.md
+docs/CreateScheduleAgentSpec.md
+docs/CreateScheduleRequest.md
+docs/CreateSecretRequest.md
+docs/CreateSkillRequest.md
+docs/MemoriesApi.md
+docs/MemoryResponse.md
+docs/OfficeListResponse.md
+docs/OfficeMemberResponse.md
+docs/OfficeResponse.md
+docs/OfficesApi.md
+docs/PatchAgentRequest.md
+docs/PatchMemoryRequest.md
+docs/PatchScheduleRequest.md
+docs/PatchSkillRequest.md
+docs/ScheduleListResponse.md
+docs/ScheduleResponse.md
+docs/SchedulesApi.md
+docs/SecretListResponse.md
+docs/SecretResponse.md
+docs/SecretsApi.md
+docs/SkillResponse.md
+docs/SkillsApi.md
+docs/TemplatesApi.md
+docs/UpdateSecretRequest.md
+src/apis/AgentsApi.ts
+src/apis/ConnectorsApi.ts
+src/apis/MemoriesApi.ts
+src/apis/OfficesApi.ts
+src/apis/SchedulesApi.ts
+src/apis/SecretsApi.ts
+src/apis/SkillsApi.ts
+src/apis/TemplatesApi.ts
+src/apis/index.ts
+src/models/AgentListResponse.ts
+src/models/AgentResponse.ts
+src/models/ConnectorResponse.ts
+src/models/CreateAgentRequest.ts
+src/models/CreateConnectorRequest.ts
+src/models/CreateMemoryRequest.ts
+src/models/CreateScheduleAgentSpec.ts
+src/models/CreateScheduleRequest.ts
+src/models/CreateSecretRequest.ts
+src/models/CreateSkillRequest.ts
+src/models/MemoryResponse.ts
+src/models/OfficeListResponse.ts
+src/models/OfficeMemberResponse.ts
+src/models/OfficeResponse.ts
+src/models/PatchAgentRequest.ts
+src/models/PatchMemoryRequest.ts
+src/models/PatchScheduleRequest.ts
+src/models/PatchSkillRequest.ts
+src/models/ScheduleListResponse.ts
+src/models/ScheduleResponse.ts
+src/models/SecretListResponse.ts
+src/models/SecretResponse.ts
+src/models/SkillResponse.ts
+src/models/UpdateSecretRequest.ts
+src/models/index.ts
+src/runtime.ts

package/.openapi-generator/VERSION

@@ -0,0 +1 @@
+7.21.0

package/README.md

@@ -1,6 +1,6 @@
-# komputer-ai TypeScript SDK
+# @komputer-ai/sdk
 
-TypeScript/JavaScript client for the [komputer.ai](https://github.com/kontroloop-ai/komputer-ai) platform.
+TypeScript SDK for the [komputer.ai](https://komputer.ai) platform. Create agents, send tasks, and stream real-time results.
 
 ## Installation
 
@@ -8,16 +8,9 @@ TypeScript/JavaScript client for the [komputer.ai](https://github.com/kontroloop
 npm install @komputer-ai/sdk
 ```
 
-Or install directly from the repository:
+## Quick start
 
-```bash
-git clone https://github.com/kontroloop-ai/komputer-ai.git
-cd komputer-ai/komputer-sdk/typescript && npm install && npm run build
-```
-
-## Quick Start
-
-```typescript
+```ts
 import { KomputerClient } from "@komputer-ai/sdk";
 
 const client = new KomputerClient("http://localhost:8080");
@@ -25,123 +18,126 @@ const client = new KomputerClient("http://localhost:8080");
 // Create an agent
 const agent = await client.createAgent({
   name: "my-agent",
-  instructions: "Summarize the latest Kubernetes release notes",
+  instructions: "Analyze our Kubernetes cluster",
   model: "claude-sonnet-4-6",
 });
 
-// Stream events as the agent works
-for await (const event of client.watchAgent("my-agent")) {
-  if (event.type === "text") {
-    console.log(event.payload.content);
-  } else if (event.type === "task_completed") {
-    console.log(`Done — cost: $${event.payload.cost_usd}`);
-    break;
-  }
+// Stream events
+for await (const event of await client.watchAgent("my-agent")) {
+  if (event.type === "text") console.log(event.payload.content);
+  if (event.type === "task_completed") break;
 }
 ```
 
-## Usage
-
-### Agents
+## Features
 
-```typescript
-// Create
-await client.createAgent({ name: "researcher", instructions: "Research AI trends", model: "claude-sonnet-4-6" });
+- Full REST API coverage: agents, memories, skills, schedules, secrets, connectors, offices, templates
+- WebSocket event streaming with automatic history prefetch
+- Idempotent create methods (safe to call twice without errors)
+- TypeScript types for all request/response models
 
-// List
-const agents = await client.listAgents();
+## API
 
-// Get
-const agent = await client.getAgent("researcher");
+### Client
 
-// Update
-await client.patchAgent({ name: "researcher", model: "claude-haiku-4-5-20251001", lifecycle: "Sleep" });
+```ts
+const client = new KomputerClient(baseUrl?: string);
+```
 
-// Cancel a running task
-await client.cancelAgentTask("researcher");
+### Agents
 
-// Delete
-await client.deleteAgent("researcher");
+```ts
+await client.createAgent({ name, instructions, model?, ... })
+await client.getAgent(name)
+await client.listAgents()
+await client.patchAgent({ name, instructions?, model?, ... })
+await client.deleteAgent(name)
+await client.cancelAgentTask(name)
+await client.getAgentEvents(name)
+const stream = await client.watchAgent(name)  // WebSocket + history
 ```
 
 ### Memories
 
-```typescript
-await client.createMemory({ name: "company-context", content: "We are a B2B SaaS company.", description: "Background" });
-await client.patchAgent({ name: "my-agent", memories: ["company-context"] });
-
-const memories = await client.listMemories();
-await client.patchMemory({ name: "company-context", content: "Updated context." });
-await client.deleteMemory("company-context");
+```ts
+await client.createMemory({ name, content, description? })
+await client.getMemory(name)
+await client.listMemories()
+await client.patchMemory({ name, content?, description? })
+await client.deleteMemory(name)
 ```
 
 ### Skills
 
-```typescript
-await client.createSkill({ name: "healthcheck", description: "Check service health", content: "curl -s http://api/healthz" });
-await client.patchAgent({ name: "my-agent", skills: ["healthcheck"] });
-
-const skills = await client.listSkills();
-await client.deleteSkill("healthcheck");
+```ts
+await client.createSkill({ name, content, description })
+await client.getSkill(name)
+await client.listSkills()
+await client.patchSkill({ name, content?, description? })
+await client.deleteSkill(name)
 ```
 
 ### Schedules
 
-```typescript
-await client.createSchedule({
-  name: "daily-report",
-  schedule: "0 9 * * *",
-  instructions: "Generate a daily status report",
-  timezone: "America/New_York",
-});
-
-const schedules = await client.listSchedules();
-await client.patchSchedule({ name: "daily-report", schedule: "0 10 * * *" });
-await client.deleteSchedule("daily-report");
+```ts
+await client.createSchedule({ name, instructions, schedule, ... })
+await client.getSchedule(name)
+await client.listSchedules()
+await client.patchSchedule({ name, schedule? })
+await client.deleteSchedule(name)
 ```
 
 ### Secrets
 
-```typescript
-await client.createSecret({ name: "api-keys", data: { GITHUB_TOKEN: "ghp_xxx", SLACK_TOKEN: "xoxb-xxx" } });
-await client.patchAgent({ name: "my-agent", secretRefs: ["api-keys"] });
-
-const secrets = await client.listSecrets();
-await client.deleteSecret("api-keys");
+```ts
+await client.createSecret({ name, data })
+await client.listSecrets()
+await client.updateSecret({ name, data })
+await client.deleteSecret(name)
 ```
 
 ### Connectors
 
-```typescript
-await client.createConnector({ name: "slack", service: "slack", url: "https://mcp.slack.com", authType: "token" });
-await client.patchAgent({ name: "my-agent", connectors: ["slack"] });
-
-const connectors = await client.listConnectors();
-await client.deleteConnector("slack");
+```ts
+await client.createConnector({ name, service, url, ... })
+await client.getConnector(name)
+await client.listConnectors()
+await client.deleteConnector(name)
+await client.listConnectorTools(name)
 ```
 
-### Streaming Events
+### Event streaming
+
+```ts
+import { KomputerClient } from "@komputer-ai/sdk";
+import type { AgentEvent } from "@komputer-ai/sdk";
+
+const stream = await client.watchAgent("my-agent");
 
-```typescript
-for await (const event of client.watchAgent("my-agent")) {
+for await (const event of stream) {
   switch (event.type) {
-    case "task_started":
-      console.log("Agent started working...");
-      break;
-    case "text":
-      console.log(event.payload.content);
-      break;
-    case "tool_use":
-      console.log(`Using tool: ${event.payload.name}`);
-      break;
-    case "task_completed":
-      console.log(`Done — cost: $${event.payload.cost_usd}`);
-      break;
-    case "error":
-      console.error(event.payload.error);
-      break;
+    case "task_started":   // Agent began working
+    case "thinking":       // Model is reasoning
+    case "text":           // Text output (event.payload.content)
+    case "tool_call":      // Tool invocation
+    case "tool_result":    // Tool response
+    case "task_completed": // Done (event.payload.cost_usd)
+    case "error":          // Error occurred
   }
 }
 ```
 
-Event types: `task_started`, `thinking`, `tool_use`, `tool_result`, `text`, `task_completed`, `task_cancelled`, `error`.
+### Direct API access
+
+For advanced use cases, the underlying generated API clients are available:
+
+```ts
+import { AgentsApi, Configuration } from "@komputer-ai/sdk";
+
+const config = new Configuration({ basePath: "http://localhost:8080/api/v1" });
+const agents = new AgentsApi(config);
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 /**
  * High-level convenience client for the komputer.ai API.
  *
- * Auto-generated by generate_client.py — do not edit manually.
+ * Hand-maintained — do not overwrite with generated output.
  *
  * @example
  * const client = new KomputerClient("http://localhost:8080");
@@ -124,7 +124,9 @@ export declare class KomputerClient {
         name: string;
         data: Record<string, string>;
         namespace?: string;
-    }): Promise<import("./models").SecretResponse>;
+    }): Promise<import("./models").SecretResponse | {
+        [key: string]: string;
+    }>;
     updateSecret(params: {
         name: string;
         data: Record<string, string>;
@@ -169,5 +171,5 @@ export declare class KomputerClient {
     listTemplates(): Promise<{
         [key: string]: any;
     }>;
-    watchAgent(name: string): AgentEventStream;
+    watchAgent(name: string): Promise<AgentEventStream>;
 }

package/dist/client.js

@@ -2,7 +2,7 @@
 /**
  * High-level convenience client for the komputer.ai API.
  *
- * Auto-generated by generate_client.py — do not edit manually.
+ * Hand-maintained — do not overwrite with generated output.
  *
  * @example
  * const client = new KomputerClient("http://localhost:8080");
@@ -47,7 +47,15 @@ class KomputerClient {
     }
     createAgent(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._agents.createAgent({ request: { connectors: params.connectors, instructions: params.instructions, lifecycle: params.lifecycle, memories: params.memories, model: params.model, name: params.name, namespace: params.namespace, officeManager: params.officeManager, role: params.role, secretRefs: params.secretRefs, skills: params.skills, systemPrompt: params.systemPrompt, templateRef: params.templateRef } });
+            try {
+                return yield this._agents.createAgent({ request: { connectors: params.connectors, instructions: params.instructions, lifecycle: params.lifecycle, memories: params.memories, model: params.model, name: params.name, namespace: params.namespace, officeManager: params.officeManager, role: params.role, secretRefs: params.secretRefs, skills: params.skills, systemPrompt: params.systemPrompt, templateRef: params.templateRef } });
+            }
+            catch (e) {
+                if (e instanceof runtime_1.ResponseError && e.response.status === 409) {
+                    return this._agents.patchAgent({ name: params.name, request: { connectors: params.connectors, instructions: params.instructions, lifecycle: params.lifecycle, memories: params.memories, model: params.model, secretRefs: params.secretRefs, skills: params.skills, systemPrompt: params.systemPrompt, templateRef: params.templateRef } });
+                }
+                throw e;
+            }
         });
     }
     getAgent(name) {
@@ -83,7 +91,15 @@ class KomputerClient {
     }
     createMemory(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._memories.createMemory({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+            try {
+                return yield this._memories.createMemory({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+            }
+            catch (e) {
+                if (e instanceof runtime_1.ResponseError && e.response.status === 409) {
+                    return this._memories.patchMemory({ name: params.name, request: { content: params.content, description: params.description } });
+                }
+                throw e;
+            }
         });
     }
     getMemory(name) {
@@ -109,7 +125,15 @@ class KomputerClient {
     }
     createSkill(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._skills.createSkill({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+            try {
+                return yield this._skills.createSkill({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+            }
+            catch (e) {
+                if (e instanceof runtime_1.ResponseError && e.response.status === 409) {
+                    return this._skills.patchSkill({ name: params.name, request: { content: params.content, description: params.description } });
+                }
+                throw e;
+            }
         });
     }
     getSkill(name) {
@@ -135,7 +159,15 @@ class KomputerClient {
     }
     createSchedule(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._schedules.createSchedule({ request: { agent: params.agent, agentName: params.agentName, autoDelete: params.autoDelete, instructions: params.instructions, keepAgents: params.keepAgents, name: params.name, namespace: params.namespace, schedule: params.schedule, timezone: params.timezone } });
+            try {
+                return yield this._schedules.createSchedule({ request: { agent: params.agent, agentName: params.agentName, autoDelete: params.autoDelete, instructions: params.instructions, keepAgents: params.keepAgents, name: params.name, namespace: params.namespace, schedule: params.schedule, timezone: params.timezone } });
+            }
+            catch (e) {
+                if (e instanceof runtime_1.ResponseError && e.response.status === 409) {
+                    return this._schedules.patchSchedule({ name: params.name, request: { schedule: params.schedule } });
+                }
+                throw e;
+            }
         });
     }
     getSchedule(name) {
@@ -161,7 +193,15 @@ class KomputerClient {
     }
     createSecret(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._secrets.createSecret({ request: { data: params.data, name: params.name, namespace: params.namespace } });
+            try {
+                return yield this._secrets.createSecret({ request: { data: params.data, name: params.name, namespace: params.namespace } });
+            }
+            catch (e) {
+                if (e instanceof runtime_1.ResponseError && e.response.status === 409) {
+                    return this._secrets.updateSecret({ name: params.name, request: { data: params.data, namespace: params.namespace } });
+                }
+                throw e;
+            }
         });
     }
     updateSecret(params) {
@@ -229,8 +269,25 @@ class KomputerClient {
     }
     // --- WebSocket ---
     watchAgent(name) {
-        const wsUrl = this._baseUrl.replace("http://", "ws://").replace("https://", "wss://");
-        return new watch_1.AgentEventStream(wsUrl, name);
+        return __awaiter(this, void 0, void 0, function* () {
+            const wsUrl = this._baseUrl.replace("http://", "ws://").replace("https://", "wss://");
+            let history = [];
+            try {
+                const resp = yield this._agents.getAgentEvents({ name, limit: 200 });
+                if (resp && Array.isArray(resp.events)) {
+                    history = resp.events.map((e) => ({
+                        agentName: e.agentName || name,
+                        type: e.type || "",
+                        timestamp: e.timestamp || "",
+                        payload: e.payload || {},
+                    }));
+                }
+            }
+            catch (_a) {
+                // History fetch failed — proceed with live-only.
+            }
+            return new watch_1.AgentEventStream(wsUrl, name, history);
+        });
     }
 }
 exports.KomputerClient = KomputerClient;

package/dist/esm/client.d.ts

@@ -1,7 +1,7 @@
 /**
  * High-level convenience client for the komputer.ai API.
  *
- * Auto-generated by generate_client.py — do not edit manually.
+ * Hand-maintained — do not overwrite with generated output.
  *
  * @example
  * const client = new KomputerClient("http://localhost:8080");
@@ -124,7 +124,9 @@ export declare class KomputerClient {
         name: string;
         data: Record<string, string>;
         namespace?: string;
-    }): Promise<import("./models").SecretResponse>;
+    }): Promise<import("./models").SecretResponse | {
+        [key: string]: string;
+    }>;
     updateSecret(params: {
         name: string;
         data: Record<string, string>;
@@ -169,5 +171,5 @@ export declare class KomputerClient {
     listTemplates(): Promise<{
         [key: string]: any;
     }>;
-    watchAgent(name: string): AgentEventStream;
+    watchAgent(name: string): Promise<AgentEventStream>;
 }

package/dist/esm/client.js

@@ -1,7 +1,7 @@
 /**
  * High-level convenience client for the komputer.ai API.
  *
- * Auto-generated by generate_client.py — do not edit manually.
+ * Hand-maintained — do not overwrite with generated output.
  *
  * @example
  * const client = new KomputerClient("http://localhost:8080");
@@ -20,7 +20,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { Configuration } from "./runtime";
+import { Configuration, ResponseError } from "./runtime";
 import { AgentsApi, ConnectorsApi, MemoriesApi, OfficesApi, SchedulesApi, SecretsApi, SkillsApi, TemplatesApi } from "./apis";
 import { AgentEventStream } from "./watch";
 export class KomputerClient {
@@ -44,7 +44,15 @@ export class KomputerClient {
     }
     createAgent(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._agents.createAgent({ request: { connectors: params.connectors, instructions: params.instructions, lifecycle: params.lifecycle, memories: params.memories, model: params.model, name: params.name, namespace: params.namespace, officeManager: params.officeManager, role: params.role, secretRefs: params.secretRefs, skills: params.skills, systemPrompt: params.systemPrompt, templateRef: params.templateRef } });
+            try {
+                return yield this._agents.createAgent({ request: { connectors: params.connectors, instructions: params.instructions, lifecycle: params.lifecycle, memories: params.memories, model: params.model, name: params.name, namespace: params.namespace, officeManager: params.officeManager, role: params.role, secretRefs: params.secretRefs, skills: params.skills, systemPrompt: params.systemPrompt, templateRef: params.templateRef } });
+            }
+            catch (e) {
+                if (e instanceof ResponseError && e.response.status === 409) {
+                    return this._agents.patchAgent({ name: params.name, request: { connectors: params.connectors, instructions: params.instructions, lifecycle: params.lifecycle, memories: params.memories, model: params.model, secretRefs: params.secretRefs, skills: params.skills, systemPrompt: params.systemPrompt, templateRef: params.templateRef } });
+                }
+                throw e;
+            }
         });
     }
     getAgent(name) {
@@ -80,7 +88,15 @@ export class KomputerClient {
     }
     createMemory(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._memories.createMemory({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+            try {
+                return yield this._memories.createMemory({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+            }
+            catch (e) {
+                if (e instanceof ResponseError && e.response.status === 409) {
+                    return this._memories.patchMemory({ name: params.name, request: { content: params.content, description: params.description } });
+                }
+                throw e;
+            }
         });
     }
     getMemory(name) {
@@ -106,7 +122,15 @@ export class KomputerClient {
     }
     createSkill(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._skills.createSkill({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+            try {
+                return yield this._skills.createSkill({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+            }
+            catch (e) {
+                if (e instanceof ResponseError && e.response.status === 409) {
+                    return this._skills.patchSkill({ name: params.name, request: { content: params.content, description: params.description } });
+                }
+                throw e;
+            }
         });
     }
     getSkill(name) {
@@ -132,7 +156,15 @@ export class KomputerClient {
     }
     createSchedule(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._schedules.createSchedule({ request: { agent: params.agent, agentName: params.agentName, autoDelete: params.autoDelete, instructions: params.instructions, keepAgents: params.keepAgents, name: params.name, namespace: params.namespace, schedule: params.schedule, timezone: params.timezone } });
+            try {
+                return yield this._schedules.createSchedule({ request: { agent: params.agent, agentName: params.agentName, autoDelete: params.autoDelete, instructions: params.instructions, keepAgents: params.keepAgents, name: params.name, namespace: params.namespace, schedule: params.schedule, timezone: params.timezone } });
+            }
+            catch (e) {
+                if (e instanceof ResponseError && e.response.status === 409) {
+                    return this._schedules.patchSchedule({ name: params.name, request: { schedule: params.schedule } });
+                }
+                throw e;
+            }
         });
     }
     getSchedule(name) {
@@ -158,7 +190,15 @@ export class KomputerClient {
     }
     createSecret(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._secrets.createSecret({ request: { data: params.data, name: params.name, namespace: params.namespace } });
+            try {
+                return yield this._secrets.createSecret({ request: { data: params.data, name: params.name, namespace: params.namespace } });
+            }
+            catch (e) {
+                if (e instanceof ResponseError && e.response.status === 409) {
+                    return this._secrets.updateSecret({ name: params.name, request: { data: params.data, namespace: params.namespace } });
+                }
+                throw e;
+            }
         });
     }
     updateSecret(params) {
@@ -226,7 +266,24 @@ export class KomputerClient {
     }
     // --- WebSocket ---
     watchAgent(name) {
-        const wsUrl = this._baseUrl.replace("http://", "ws://").replace("https://", "wss://");
-        return new AgentEventStream(wsUrl, name);
+        return __awaiter(this, void 0, void 0, function* () {
+            const wsUrl = this._baseUrl.replace("http://", "ws://").replace("https://", "wss://");
+            let history = [];
+            try {
+                const resp = yield this._agents.getAgentEvents({ name, limit: 200 });
+                if (resp && Array.isArray(resp.events)) {
+                    history = resp.events.map((e) => ({
+                        agentName: e.agentName || name,
+                        type: e.type || "",
+                        timestamp: e.timestamp || "",
+                        payload: e.payload || {},
+                    }));
+                }
+            }
+            catch (_a) {
+                // History fetch failed — proceed with live-only.
+            }
+            return new AgentEventStream(wsUrl, name, history);
+        });
     }
 }

package/dist/esm/watch.d.ts

@@ -9,6 +9,8 @@ export interface AgentEvent {
 }
 /**
  * Async iterable stream of agent events over WebSocket.
+ * Yields pre-fetched history events first, then live WebSocket events,
+ * deduplicating by timestamp+type.
  *
  * @example
  * for await (const event of client.watchAgent("my-agent")) {
@@ -22,7 +24,9 @@ export declare class AgentEventStream implements AsyncIterable<AgentEvent> {
     private queue;
     private resolve;
     private done;
-    constructor(wsUrl: string, agentName: string);
+    private seen;
+    constructor(wsUrl: string, agentName: string, historyEvents?: AgentEvent[]);
+    private dedupKey;
     [Symbol.asyncIterator](): AsyncIterator<AgentEvent>;
     close(): void;
 }

package/dist/esm/watch.js

@@ -3,6 +3,8 @@
  */
 /**
  * Async iterable stream of agent events over WebSocket.
+ * Yields pre-fetched history events first, then live WebSocket events,
+ * deduplicating by timestamp+type.
  *
  * @example
  * for await (const event of client.watchAgent("my-agent")) {
@@ -11,11 +13,20 @@
  * }
  */
 export class AgentEventStream {
-    constructor(wsUrl, agentName) {
+    constructor(wsUrl, agentName, historyEvents) {
         this.queue = [];
         this.resolve = null;
         this.done = false;
+        this.seen = new Set();
         this.agentName = agentName;
+        // Seed dedup set and queue with history events.
+        if (historyEvents) {
+            for (const e of historyEvents) {
+                const key = this.dedupKey(e);
+                this.seen.add(key);
+                this.queue.push(e);
+            }
+        }
         this.ws = new WebSocket(`${wsUrl}/api/v1/agents/${agentName}/ws`);
         this.ws.onmessage = (event) => {
             const data = JSON.parse(event.data);
@@ -25,6 +36,10 @@ export class AgentEventStream {
                 timestamp: data.timestamp || "",
                 payload: data.payload || {},
             };
+            const key = this.dedupKey(agentEvent);
+            if (this.seen.has(key))
+                return;
+            this.seen.add(key);
             if (this.resolve) {
                 const r = this.resolve;
                 this.resolve = null;
@@ -51,6 +66,10 @@ export class AgentEventStream {
             }
         };
     }
+    dedupKey(e) {
+        const normType = e.type === "task_started" ? "user_message" : e.type;
+        return `${e.timestamp}:${normType}`;
+    }
     [Symbol.asyncIterator]() {
         return {
             next: () => {

package/dist/watch.d.ts

@@ -9,6 +9,8 @@ export interface AgentEvent {
 }
 /**
  * Async iterable stream of agent events over WebSocket.
+ * Yields pre-fetched history events first, then live WebSocket events,
+ * deduplicating by timestamp+type.
  *
  * @example
  * for await (const event of client.watchAgent("my-agent")) {
@@ -22,7 +24,9 @@ export declare class AgentEventStream implements AsyncIterable<AgentEvent> {
     private queue;
     private resolve;
     private done;
-    constructor(wsUrl: string, agentName: string);
+    private seen;
+    constructor(wsUrl: string, agentName: string, historyEvents?: AgentEvent[]);
+    private dedupKey;
     [Symbol.asyncIterator](): AsyncIterator<AgentEvent>;
     close(): void;
 }

package/dist/watch.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentEventStream = void 0;
 /**
  * Async iterable stream of agent events over WebSocket.
+ * Yields pre-fetched history events first, then live WebSocket events,
+ * deduplicating by timestamp+type.
  *
  * @example
  * for await (const event of client.watchAgent("my-agent")) {
@@ -14,11 +16,20 @@ exports.AgentEventStream = void 0;
  * }
  */
 class AgentEventStream {
-    constructor(wsUrl, agentName) {
+    constructor(wsUrl, agentName, historyEvents) {
         this.queue = [];
         this.resolve = null;
         this.done = false;
+        this.seen = new Set();
         this.agentName = agentName;
+        // Seed dedup set and queue with history events.
+        if (historyEvents) {
+            for (const e of historyEvents) {
+                const key = this.dedupKey(e);
+                this.seen.add(key);
+                this.queue.push(e);
+            }
+        }
         this.ws = new WebSocket(`${wsUrl}/api/v1/agents/${agentName}/ws`);
         this.ws.onmessage = (event) => {
             const data = JSON.parse(event.data);
@@ -28,6 +39,10 @@ class AgentEventStream {
                 timestamp: data.timestamp || "",
                 payload: data.payload || {},
             };
+            const key = this.dedupKey(agentEvent);
+            if (this.seen.has(key))
+                return;
+            this.seen.add(key);
             if (this.resolve) {
                 const r = this.resolve;
                 this.resolve = null;
@@ -54,6 +69,10 @@ class AgentEventStream {
             }
         };
     }
+    dedupKey(e) {
+        const normType = e.type === "task_started" ? "user_message" : e.type;
+        return `${e.timestamp}:${normType}`;
+    }
     [Symbol.asyncIterator]() {
         return {
             next: () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@komputer-ai/sdk",
-  "version": "0.11.2",
+  "version": "0.11.5",
   "description": "TypeScript SDK for the komputer.ai platform",
   "author": "kontroloop-ai",
   "license": "MIT",
@@ -17,10 +17,14 @@
   "module": "./dist/esm/index.js",
   "sideEffects": false,
   "scripts": {
-    "build": "tsc && tsc -p tsconfig.esm.json"
+    "build": "tsc && tsc -p tsconfig.esm.json",
+    "test": "vitest run src/client.test.ts",
+    "test:integration": "vitest run src/integration.test.ts"
   },
   "devDependencies": {
+    "@types/ws": "^8.18.1",
     "typescript": "^4.0 || ^5.0",
-    "vitest": "^4.1.4"
+    "vitest": "^4.1.4",
+    "ws": "^8.20.0"
   }
 }