@komputer-ai/sdk 0.11.1

package/.openapi-generator-ignore

@@ -0,0 +1,31 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md
+
+# Preserve hand-written and customized files
+src/watch.ts
+src/client.ts
+src/**/*.test.ts
+tsconfig.json
+tsconfig.esm.json
+package.json

package/README.md

@@ -0,0 +1,147 @@
+# komputer-ai TypeScript SDK
+
+TypeScript/JavaScript client for the [komputer.ai](https://github.com/kontroloop-ai/komputer-ai) platform.
+
+## Installation
+
+```bash
+npm install @komputer-ai/sdk
+```
+
+Or install directly from the repository:
+
+```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
+import { KomputerClient } from "@komputer-ai/sdk";
+
+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",
+  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;
+  }
+}
+```
+
+## 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");
+```
+
+### 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");
+```
+
+### 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");
+```
+
+### 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");
+```
+
+### 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;
+  }
+}
+```
+
+Event types: `task_started`, `thinking`, `tool_use`, `tool_result`, `text`, `task_completed`, `task_cancelled`, `error`.

package/docs/AgentListResponse.md

@@ -0,0 +1,34 @@
+
+# AgentListResponse
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`agents` | [Array<AgentResponse>](AgentResponse.md)
+
+## Example
+
+```typescript
+import type { AgentListResponse } from 'komputer-ai'
+
+// TODO: Update the object below with actual values
+const example = {
+  "agents": null,
+} satisfies AgentListResponse
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as AgentListResponse
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/AgentResponse.md

@@ -0,0 +1,68 @@
+
+# AgentResponse
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`connectors` | Array<string>
+`createdAt` | string
+`instructions` | string
+`lastTaskCostUSD` | string
+`lastTaskMessage` | string
+`lifecycle` | string
+`memories` | Array<string>
+`model` | string
+`modelContextWindow` | number
+`name` | string
+`namespace` | string
+`secrets` | Array<string>
+`skills` | Array<string>
+`status` | string
+`systemPrompt` | string
+`taskStatus` | string
+`totalCostUSD` | string
+`totalTokens` | number
+
+## Example
+
+```typescript
+import type { AgentResponse } from 'komputer-ai'
+
+// TODO: Update the object below with actual values
+const example = {
+  "connectors": null,
+  "createdAt": null,
+  "instructions": null,
+  "lastTaskCostUSD": null,
+  "lastTaskMessage": null,
+  "lifecycle": null,
+  "memories": null,
+  "model": null,
+  "modelContextWindow": null,
+  "name": null,
+  "namespace": null,
+  "secrets": null,
+  "skills": null,
+  "status": null,
+  "systemPrompt": null,
+  "taskStatus": null,
+  "totalCostUSD": null,
+  "totalTokens": null,
+} satisfies AgentResponse
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as AgentResponse
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+