@komputer-ai/sdk 0.11.2 → 0.11.3

package/.openapi-generator/FILES

@@ -0,0 +1,69 @@
+.gitignore
+README.md
+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,147 +1,172 @@
-# komputer-ai TypeScript SDK
+# @komputer-ai/sdk@0.1.0
 
-TypeScript/JavaScript client for the [komputer.ai](https://github.com/kontroloop-ai/komputer-ai) platform.
+A TypeScript SDK client for the localhost API.
 
-## Installation
-
-```bash
-npm install @komputer-ai/sdk
-```
+## Usage
 
-Or install directly from the repository:
+First, install the SDK from npm.
 
 ```bash
-git clone https://github.com/kontroloop-ai/komputer-ai.git
-cd komputer-ai/komputer-sdk/typescript && npm install && npm run build
+npm install @komputer-ai/sdk --save
 ```
 
-## Quick Start
+Next, try it out.
 
-```typescript
-import { KomputerClient } from "@komputer-ai/sdk";
 
-const client = new KomputerClient("http://localhost:8080");
+```ts
+import {
+  Configuration,
+  AgentsApi,
+} from '@komputer-ai/sdk';
+import type { AgentsNameWsGetRequest } from '@komputer-ai/sdk';
 
-// Create an agent
-const agent = await client.createAgent({
-  name: "my-agent",
-  instructions: "Summarize the latest Kubernetes release notes",
-  model: "claude-sonnet-4-6",
-});
+async function example() {
+  console.log("🚀 Testing @komputer-ai/sdk SDK...");
+  const api = new AgentsApi();
 
-// 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;
+  const body = {
+    // string | Agent name
+    name: name_example,
+  } satisfies AgentsNameWsGetRequest;
+
+  try {
+    const data = await api.agentsNameWsGet(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
   }
 }
-```
-
-## Usage
 
-### Agents
-
-```typescript
-// Create
-await client.createAgent({ name: "researcher", instructions: "Research AI trends", model: "claude-sonnet-4-6" });
-
-// List
-const agents = await client.listAgents();
-
-// Get
-const agent = await client.getAgent("researcher");
-
-// Update
-await client.patchAgent({ name: "researcher", model: "claude-haiku-4-5-20251001", lifecycle: "Sleep" });
-
-// Cancel a running task
-await client.cancelAgentTask("researcher");
-
-// Delete
-await client.deleteAgent("researcher");
+// Run the test
+example().catch(console.error);
 ```
 
-### 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");
-```
+## Documentation
+
+### API Endpoints
+
+All URIs are relative to *http://localhost:8080/api/v1*
+
+| Class | Method | HTTP request | Description
+| ----- | ------ | ------------ | -------------
+*AgentsApi* | [**agentsNameWsGet**](docs/AgentsApi.md#agentsnamewsget) | **GET** /agents/{name}/ws | Stream agent events (WebSocket)
+*AgentsApi* | [**cancelAgentTask**](docs/AgentsApi.md#cancelagenttask) | **POST** /agents/{name}/cancel | Cancel agent task
+*AgentsApi* | [**createAgent**](docs/AgentsApi.md#createagentoperation) | **POST** /agents | Create agent or send task
+*AgentsApi* | [**deleteAgent**](docs/AgentsApi.md#deleteagent) | **DELETE** /agents/{name} | Delete agent
+*AgentsApi* | [**getAgent**](docs/AgentsApi.md#getagent) | **GET** /agents/{name} | Get agent details
+*AgentsApi* | [**getAgentEvents**](docs/AgentsApi.md#getagentevents) | **GET** /agents/{name}/events | Get agent events
+*AgentsApi* | [**listAgents**](docs/AgentsApi.md#listagents) | **GET** /agents | List agents
+*AgentsApi* | [**patchAgent**](docs/AgentsApi.md#patchagentoperation) | **PATCH** /agents/{name} | Patch agent
+*ConnectorsApi* | [**createConnector**](docs/ConnectorsApi.md#createconnectoroperation) | **POST** /connectors | Create connector
+*ConnectorsApi* | [**deleteConnector**](docs/ConnectorsApi.md#deleteconnector) | **DELETE** /connectors/{name} | Delete connector
+*ConnectorsApi* | [**getConnector**](docs/ConnectorsApi.md#getconnector) | **GET** /connectors/{name} | Get connector details
+*ConnectorsApi* | [**listConnectorTools**](docs/ConnectorsApi.md#listconnectortools) | **GET** /connectors/{name}/tools | List connector tools
+*ConnectorsApi* | [**listConnectors**](docs/ConnectorsApi.md#listconnectors) | **GET** /connectors | List connectors
+*MemoriesApi* | [**createMemory**](docs/MemoriesApi.md#creatememoryoperation) | **POST** /memories | Create memory
+*MemoriesApi* | [**deleteMemory**](docs/MemoriesApi.md#deletememory) | **DELETE** /memories/{name} | Delete memory
+*MemoriesApi* | [**getMemory**](docs/MemoriesApi.md#getmemory) | **GET** /memories/{name} | Get memory details
+*MemoriesApi* | [**listMemories**](docs/MemoriesApi.md#listmemories) | **GET** /memories | List memories
+*MemoriesApi* | [**patchMemory**](docs/MemoriesApi.md#patchmemoryoperation) | **PATCH** /memories/{name} | Patch memory
+*OfficesApi* | [**deleteOffice**](docs/OfficesApi.md#deleteoffice) | **DELETE** /offices/{name} | Delete office
+*OfficesApi* | [**getOffice**](docs/OfficesApi.md#getoffice) | **GET** /offices/{name} | Get office details
+*OfficesApi* | [**getOfficeEvents**](docs/OfficesApi.md#getofficeevents) | **GET** /offices/{name}/events | Get office events
+*OfficesApi* | [**listOffices**](docs/OfficesApi.md#listoffices) | **GET** /offices | List offices
+*SchedulesApi* | [**createSchedule**](docs/SchedulesApi.md#createscheduleoperation) | **POST** /schedules | Create schedule
+*SchedulesApi* | [**deleteSchedule**](docs/SchedulesApi.md#deleteschedule) | **DELETE** /schedules/{name} | Delete schedule
+*SchedulesApi* | [**getSchedule**](docs/SchedulesApi.md#getschedule) | **GET** /schedules/{name} | Get schedule details
+*SchedulesApi* | [**listSchedules**](docs/SchedulesApi.md#listschedules) | **GET** /schedules | List schedules
+*SchedulesApi* | [**patchSchedule**](docs/SchedulesApi.md#patchscheduleoperation) | **PATCH** /schedules/{name} | Patch schedule
+*SecretsApi* | [**createSecret**](docs/SecretsApi.md#createsecretoperation) | **POST** /secrets | Create managed secret
+*SecretsApi* | [**deleteSecret**](docs/SecretsApi.md#deletesecret) | **DELETE** /secrets/{name} | Delete managed secret
+*SecretsApi* | [**listSecrets**](docs/SecretsApi.md#listsecrets) | **GET** /secrets | List secrets
+*SecretsApi* | [**updateSecret**](docs/SecretsApi.md#updatesecretoperation) | **PATCH** /secrets/{name} | Update managed secret
+*SkillsApi* | [**createSkill**](docs/SkillsApi.md#createskilloperation) | **POST** /skills | Create skill
+*SkillsApi* | [**deleteSkill**](docs/SkillsApi.md#deleteskill) | **DELETE** /skills/{name} | Delete skill
+*SkillsApi* | [**getSkill**](docs/SkillsApi.md#getskill) | **GET** /skills/{name} | Get skill details
+*SkillsApi* | [**listSkills**](docs/SkillsApi.md#listskills) | **GET** /skills | List skills
+*SkillsApi* | [**patchSkill**](docs/SkillsApi.md#patchskilloperation) | **PATCH** /skills/{name} | Patch skill
+*TemplatesApi* | [**listTemplates**](docs/TemplatesApi.md#listtemplates) | **GET** /templates | List agent templates
+*TemplatesApi* | [**namespacesGet**](docs/TemplatesApi.md#namespacesget) | **GET** /namespaces | List namespaces
+
+
+### Models
+
+- [AgentListResponse](docs/AgentListResponse.md)
+- [AgentResponse](docs/AgentResponse.md)
+- [ConnectorResponse](docs/ConnectorResponse.md)
+- [CreateAgentRequest](docs/CreateAgentRequest.md)
+- [CreateConnectorRequest](docs/CreateConnectorRequest.md)
+- [CreateMemoryRequest](docs/CreateMemoryRequest.md)
+- [CreateScheduleAgentSpec](docs/CreateScheduleAgentSpec.md)
+- [CreateScheduleRequest](docs/CreateScheduleRequest.md)
+- [CreateSecretRequest](docs/CreateSecretRequest.md)
+- [CreateSkillRequest](docs/CreateSkillRequest.md)
+- [MemoryResponse](docs/MemoryResponse.md)
+- [OfficeListResponse](docs/OfficeListResponse.md)
+- [OfficeMemberResponse](docs/OfficeMemberResponse.md)
+- [OfficeResponse](docs/OfficeResponse.md)
+- [PatchAgentRequest](docs/PatchAgentRequest.md)
+- [PatchMemoryRequest](docs/PatchMemoryRequest.md)
+- [PatchScheduleRequest](docs/PatchScheduleRequest.md)
+- [PatchSkillRequest](docs/PatchSkillRequest.md)
+- [ScheduleListResponse](docs/ScheduleListResponse.md)
+- [ScheduleResponse](docs/ScheduleResponse.md)
+- [SecretListResponse](docs/SecretListResponse.md)
+- [SecretResponse](docs/SecretResponse.md)
+- [SkillResponse](docs/SkillResponse.md)
+- [UpdateSecretRequest](docs/UpdateSecretRequest.md)
+
+### Authorization
+
+Endpoints do not require authorization.
+
+
+## About
+
+This TypeScript SDK client supports the [Fetch API](https://fetch.spec.whatwg.org/)
+and is automatically generated by the
+[OpenAPI Generator](https://openapi-generator.tech) project:
+
+- API version: `1.0`
+- Package version: `0.1.0`
+- Generator version: `7.21.0`
+- Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
+
+The generated npm module supports the following:
+
+- Environments
+  * Node.js
+  * Webpack
+  * Browserify
+- Language levels
+  * ES5 - you must have a Promises/A+ library installed
+  * ES6
+- Module systems
+  * CommonJS
+  * ES6 module system
+
+
+## Development
+
+### Building
+
+To build the TypeScript source code, you need to have Node.js and npm installed.
+After cloning the repository, navigate to the project directory and run:
 
-### 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");
-```
-
-### 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");
-```
-
-### 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");
+```bash
+npm install
+npm run build
 ```
 
-### Connectors
+### Publishing
 
-```typescript
-await client.createConnector({ name: "slack", service: "slack", url: "https://mcp.slack.com", authType: "token" });
-await client.patchAgent({ name: "my-agent", connectors: ["slack"] });
+Once you've built the package, you can publish it to npm:
 
-const connectors = await client.listConnectors();
-await client.deleteConnector("slack");
+```bash
+npm publish
 ```
 
-### Streaming Events
-
-```typescript
-for await (const event of client.watchAgent("my-agent")) {
-  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;
-  }
-}
-```
+## License
 
-Event types: `task_started`, `thinking`, `tool_use`, `tool_result`, `text`, `task_completed`, `task_cancelled`, `error`.
+[]()

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.3",
   "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"
   }
 }