@komputer-ai/sdk 0.11.1 → 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/apis/AgentsApi.d.ts

@@ -0,0 +1,173 @@
+/**
+ * komputer.ai API
+ * API-first platform for running persistent Claude AI agents on Kubernetes. Designed to be driven by external systems — create agents, send tasks, and stream real-time results via REST + WebSocket.
+ *
+ * The version of the OpenAPI document: 1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime';
+import type { AgentListResponse, AgentResponse, CreateAgentRequest, PatchAgentRequest } from '../models/index';
+export interface AgentsNameWsGetRequest {
+    name: string;
+}
+export interface CancelAgentTaskRequest {
+    name: string;
+    namespace?: string;
+}
+export interface CreateAgentOperationRequest {
+    request: CreateAgentRequest;
+}
+export interface DeleteAgentRequest {
+    name: string;
+    namespace?: string;
+}
+export interface GetAgentRequest {
+    name: string;
+    namespace?: string;
+}
+export interface GetAgentEventsRequest {
+    name: string;
+    namespace?: string;
+    limit?: number;
+}
+export interface ListAgentsRequest {
+    namespace?: string;
+}
+export interface PatchAgentOperationRequest {
+    name: string;
+    request: PatchAgentRequest;
+    namespace?: string;
+}
+/**
+ *
+ */
+export declare class AgentsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for agentsNameWsGet without sending the request
+     */
+    agentsNameWsGetRequestOpts(requestParameters: AgentsNameWsGetRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Upgrades to a WebSocket connection to stream real-time agent events. Events include task_started, thinking, tool_call, tool_result, text, task_completed, task_cancelled, and error.
+     * Stream agent events (WebSocket)
+     */
+    agentsNameWsGetRaw(requestParameters: AgentsNameWsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Upgrades to a WebSocket connection to stream real-time agent events. Events include task_started, thinking, tool_call, tool_result, text, task_completed, task_cancelled, and error.
+     * Stream agent events (WebSocket)
+     */
+    agentsNameWsGet(requestParameters: AgentsNameWsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for cancelAgentTask without sending the request
+     */
+    cancelAgentTaskRequestOpts(requestParameters: CancelAgentTaskRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Gracefully cancels the currently running task. The agent pod stays alive for future tasks.
+     * Cancel agent task
+     */
+    cancelAgentTaskRaw(requestParameters: CancelAgentTaskRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<{
+        [key: string]: string;
+    }>>;
+    /**
+     * Gracefully cancels the currently running task. The agent pod stays alive for future tasks.
+     * Cancel agent task
+     */
+    cancelAgentTask(requestParameters: CancelAgentTaskRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<{
+        [key: string]: string;
+    }>;
+    /**
+     * Creates request options for createAgent without sending the request
+     */
+    createAgentRequestOpts(requestParameters: CreateAgentOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Creates a new agent or sends a task to an existing idle agent (upsert by name). If the agent doesn\'t exist, it is created. If it exists and is idle, the task is forwarded.
+     * Create agent or send task
+     */
+    createAgentRaw(requestParameters: CreateAgentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentResponse>>;
+    /**
+     * Creates a new agent or sends a task to an existing idle agent (upsert by name). If the agent doesn\'t exist, it is created. If it exists and is idle, the task is forwarded.
+     * Create agent or send task
+     */
+    createAgent(requestParameters: CreateAgentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentResponse>;
+    /**
+     * Creates request options for deleteAgent without sending the request
+     */
+    deleteAgentRequestOpts(requestParameters: DeleteAgentRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Deletes the agent CR, pod, PVC, secrets, and Redis event stream.
+     * Delete agent
+     */
+    deleteAgentRaw(requestParameters: DeleteAgentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<{
+        [key: string]: string;
+    }>>;
+    /**
+     * Deletes the agent CR, pod, PVC, secrets, and Redis event stream.
+     * Delete agent
+     */
+    deleteAgent(requestParameters: DeleteAgentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<{
+        [key: string]: string;
+    }>;
+    /**
+     * Creates request options for getAgent without sending the request
+     */
+    getAgentRequestOpts(requestParameters: GetAgentRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Returns the current status and metadata for a single agent.
+     * Get agent details
+     */
+    getAgentRaw(requestParameters: GetAgentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentResponse>>;
+    /**
+     * Returns the current status and metadata for a single agent.
+     * Get agent details
+     */
+    getAgent(requestParameters: GetAgentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentResponse>;
+    /**
+     * Creates request options for getAgentEvents without sending the request
+     */
+    getAgentEventsRequestOpts(requestParameters: GetAgentEventsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Returns recent events from the agent\'s Redis stream in chronological order.
+     * Get agent events
+     */
+    getAgentEventsRaw(requestParameters: GetAgentEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<{
+        [key: string]: any;
+    }>>;
+    /**
+     * Returns recent events from the agent\'s Redis stream in chronological order.
+     * Get agent events
+     */
+    getAgentEvents(requestParameters: GetAgentEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<{
+        [key: string]: any;
+    }>;
+    /**
+     * Creates request options for listAgents without sending the request
+     */
+    listAgentsRequestOpts(requestParameters: ListAgentsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Returns all agents with their current status in the specified namespace.
+     * List agents
+     */
+    listAgentsRaw(requestParameters: ListAgentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentListResponse>>;
+    /**
+     * Returns all agents with their current status in the specified namespace.
+     * List agents
+     */
+    listAgents(requestParameters?: ListAgentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentListResponse>;
+    /**
+     * Creates request options for patchAgent without sending the request
+     */
+    patchAgentRequestOpts(requestParameters: PatchAgentOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Updates model, lifecycle, instructions, secretRefs, memories, skills, or connectors on an existing agent.
+     * Patch agent
+     */
+    patchAgentRaw(requestParameters: PatchAgentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentResponse>>;
+    /**
+     * Updates model, lifecycle, instructions, secretRefs, memories, skills, or connectors on an existing agent.
+     * Patch agent
+     */
+    patchAgent(requestParameters: PatchAgentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentResponse>;
+}