@komputer-ai/sdk 0.11.1

package/src/client.test.ts

@@ -0,0 +1,88 @@
+import { describe, it, expect } from "vitest";
+import { KomputerClient } from "./client";
+
+describe("KomputerClient", () => {
+  it("instantiates with default URL", () => {
+    const client = new KomputerClient();
+    expect(client).toBeDefined();
+  });
+
+  it("instantiates with custom URL", () => {
+    const client = new KomputerClient("http://example.com:8080");
+    expect(client).toBeDefined();
+  });
+
+  it("strips trailing slash from URL", () => {
+    const client = new KomputerClient("http://localhost:8080/");
+    expect(client).toBeDefined();
+  });
+});
+
+describe("Agent methods exist", () => {
+  const client = new KomputerClient();
+
+  it("has createAgent", () => expect(typeof client.createAgent).toBe("function"));
+  it("has listAgents", () => expect(typeof client.listAgents).toBe("function"));
+  it("has getAgent", () => expect(typeof client.getAgent).toBe("function"));
+  it("has patchAgent", () => expect(typeof client.patchAgent).toBe("function"));
+  it("has deleteAgent", () => expect(typeof client.deleteAgent).toBe("function"));
+  it("has cancelAgentTask", () => expect(typeof client.cancelAgentTask).toBe("function"));
+  it("has getAgentEvents", () => expect(typeof client.getAgentEvents).toBe("function"));
+  it("has watchAgent", () => expect(typeof client.watchAgent).toBe("function"));
+});
+
+describe("Memory methods exist", () => {
+  const client = new KomputerClient();
+
+  it("has createMemory", () => expect(typeof client.createMemory).toBe("function"));
+  it("has listMemories", () => expect(typeof client.listMemories).toBe("function"));
+  it("has getMemory", () => expect(typeof client.getMemory).toBe("function"));
+  it("has patchMemory", () => expect(typeof client.patchMemory).toBe("function"));
+  it("has deleteMemory", () => expect(typeof client.deleteMemory).toBe("function"));
+});
+
+describe("Skill methods exist", () => {
+  const client = new KomputerClient();
+
+  it("has createSkill", () => expect(typeof client.createSkill).toBe("function"));
+  it("has listSkills", () => expect(typeof client.listSkills).toBe("function"));
+  it("has getSkill", () => expect(typeof client.getSkill).toBe("function"));
+  it("has patchSkill", () => expect(typeof client.patchSkill).toBe("function"));
+  it("has deleteSkill", () => expect(typeof client.deleteSkill).toBe("function"));
+});
+
+describe("Schedule methods exist", () => {
+  const client = new KomputerClient();
+
+  it("has createSchedule", () => expect(typeof client.createSchedule).toBe("function"));
+  it("has listSchedules", () => expect(typeof client.listSchedules).toBe("function"));
+  it("has getSchedule", () => expect(typeof client.getSchedule).toBe("function"));
+  it("has patchSchedule", () => expect(typeof client.patchSchedule).toBe("function"));
+  it("has deleteSchedule", () => expect(typeof client.deleteSchedule).toBe("function"));
+});
+
+describe("Secret methods exist", () => {
+  const client = new KomputerClient();
+
+  it("has createSecret", () => expect(typeof client.createSecret).toBe("function"));
+  it("has listSecrets", () => expect(typeof client.listSecrets).toBe("function"));
+  it("has updateSecret", () => expect(typeof client.updateSecret).toBe("function"));
+  it("has deleteSecret", () => expect(typeof client.deleteSecret).toBe("function"));
+});
+
+describe("Connector methods exist", () => {
+  const client = new KomputerClient();
+
+  it("has createConnector", () => expect(typeof client.createConnector).toBe("function"));
+  it("has listConnectors", () => expect(typeof client.listConnectors).toBe("function"));
+  it("has getConnector", () => expect(typeof client.getConnector).toBe("function"));
+  it("has deleteConnector", () => expect(typeof client.deleteConnector).toBe("function"));
+});
+
+describe("Office methods exist", () => {
+  const client = new KomputerClient();
+
+  it("has listOffices", () => expect(typeof client.listOffices).toBe("function"));
+  it("has getOffice", () => expect(typeof client.getOffice).toBe("function"));
+  it("has deleteOffice", () => expect(typeof client.deleteOffice).toBe("function"));
+});

package/src/client.ts

@@ -0,0 +1,212 @@
+/**
+ * High-level convenience client for the komputer.ai API.
+ *
+ * Auto-generated by generate_client.py — do not edit manually.
+ *
+ * @example
+ * const client = new KomputerClient("http://localhost:8080");
+ * const agent = await client.createAgent({
+ *   name: "my-agent",
+ *   instructions: "Say hello",
+ *   model: "claude-sonnet-4-6",
+ * });
+ */
+
+import { Configuration } from "./runtime";
+import { AgentsApi, ConnectorsApi, MemoriesApi, OfficesApi, SchedulesApi, SecretsApi, SkillsApi, TemplatesApi } from "./apis";
+import type { CreateAgentRequest, CreateConnectorRequest, CreateMemoryRequest, CreateScheduleAgentSpec, CreateScheduleRequest, CreateSecretRequest, CreateSkillRequest, PatchAgentRequest, PatchMemoryRequest, PatchScheduleRequest, PatchSkillRequest, UpdateSecretRequest } from "./models";
+import { AgentEventStream } from "./watch";
+export type { AgentEvent } from "./watch";
+
+export class KomputerClient {
+  private _agents: AgentsApi;
+  private _connectors: ConnectorsApi;
+  private _memories: MemoriesApi;
+  private _offices: OfficesApi;
+  private _schedules: SchedulesApi;
+  private _secrets: SecretsApi;
+  private _skills: SkillsApi;
+  private _templates: TemplatesApi;
+  private _baseUrl: string;
+
+  constructor(baseUrl: string = "http://localhost:8080") {
+    this._baseUrl = baseUrl.replace(/\/$/, "");
+    const config = new Configuration({ basePath: this._baseUrl + "/api/v1" });
+    this._agents = new AgentsApi(config);
+    this._connectors = new ConnectorsApi(config);
+    this._memories = new MemoriesApi(config);
+    this._offices = new OfficesApi(config);
+    this._schedules = new SchedulesApi(config);
+    this._secrets = new SecretsApi(config);
+    this._skills = new SkillsApi(config);
+    this._templates = new TemplatesApi(config);
+  }
+
+  // --- Agents ---
+
+  async listAgents() {
+    return this._agents.listAgents({});
+  }
+
+  async createAgent(params: { name: string; instructions: string; connectors?: string[]; lifecycle?: string; memories?: string[]; model?: string; namespace?: string; officeManager?: string; role?: string; secretRefs?: string[]; skills?: string[]; systemPrompt?: string; templateRef?: string }) {
+    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 } });
+  }
+
+  async getAgent(name: string) {
+    return this._agents.getAgent({ name });
+  }
+
+  async patchAgent(params: { name: string; connectors?: string[]; instructions?: string; lifecycle?: string; memories?: string[]; model?: string; secretRefs?: string[]; skills?: string[]; systemPrompt?: string; templateRef?: string }) {
+    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 } });
+  }
+
+  async deleteAgent(name: string) {
+    return this._agents.deleteAgent({ name });
+  }
+
+  async cancelAgentTask(name: string) {
+    return this._agents.cancelAgentTask({ name });
+  }
+
+  async getAgentEvents(name: string) {
+    return this._agents.getAgentEvents({ name });
+  }
+
+  // --- Memories ---
+
+  async listMemories() {
+    return this._memories.listMemories({});
+  }
+
+  async createMemory(params: { name: string; content: string; description?: string; namespace?: string }) {
+    return this._memories.createMemory({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+  }
+
+  async getMemory(name: string) {
+    return this._memories.getMemory({ name });
+  }
+
+  async patchMemory(params: { name: string; content?: string; description?: string }) {
+    return this._memories.patchMemory({ name: params.name, request: { content: params.content, description: params.description } });
+  }
+
+  async deleteMemory(name: string) {
+    return this._memories.deleteMemory({ name });
+  }
+
+  // --- Skills ---
+
+  async listSkills() {
+    return this._skills.listSkills({});
+  }
+
+  async createSkill(params: { name: string; content: string; description: string; namespace?: string }) {
+    return this._skills.createSkill({ request: { content: params.content, description: params.description, name: params.name, namespace: params.namespace } });
+  }
+
+  async getSkill(name: string) {
+    return this._skills.getSkill({ name });
+  }
+
+  async patchSkill(params: { name: string; content?: string; description?: string }) {
+    return this._skills.patchSkill({ name: params.name, request: { content: params.content, description: params.description } });
+  }
+
+  async deleteSkill(name: string) {
+    return this._skills.deleteSkill({ name });
+  }
+
+  // --- Schedules ---
+
+  async listSchedules() {
+    return this._schedules.listSchedules({});
+  }
+
+  async createSchedule(params: { name: string; instructions: string; schedule: string; agent?: CreateScheduleAgentSpec; agentName?: string; autoDelete?: boolean; keepAgents?: boolean; namespace?: string; timezone?: string }) {
+    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 } });
+  }
+
+  async getSchedule(name: string) {
+    return this._schedules.getSchedule({ name });
+  }
+
+  async patchSchedule(params: { name: string; schedule?: string }) {
+    return this._schedules.patchSchedule({ name: params.name, request: { schedule: params.schedule } });
+  }
+
+  async deleteSchedule(name: string) {
+    return this._schedules.deleteSchedule({ name });
+  }
+
+  // --- Secrets ---
+
+  async listSecrets() {
+    return this._secrets.listSecrets({});
+  }
+
+  async createSecret(params: { name: string; data: Record<string, string>; namespace?: string }) {
+    return this._secrets.createSecret({ request: { data: params.data, name: params.name, namespace: params.namespace } });
+  }
+
+  async updateSecret(params: { name: string; data: Record<string, string>; namespace?: string }) {
+    return this._secrets.updateSecret({ name: params.name, request: { data: params.data, namespace: params.namespace } });
+  }
+
+  async deleteSecret(name: string) {
+    return this._secrets.deleteSecret({ name });
+  }
+
+  // --- Connectors ---
+
+  async listConnectors() {
+    return this._connectors.listConnectors({});
+  }
+
+  async createConnector(params: { name: string; service: string; url: string; authSecretKey?: string; authSecretName?: string; authType?: string; displayName?: string; namespace?: string; oauthClientId?: string; oauthClientSecret?: string; type?: string }) {
+    return this._connectors.createConnector({ request: { authSecretKey: params.authSecretKey, authSecretName: params.authSecretName, authType: params.authType, displayName: params.displayName, name: params.name, namespace: params.namespace, oauthClientId: params.oauthClientId, oauthClientSecret: params.oauthClientSecret, service: params.service, type: params.type, url: params.url } });
+  }
+
+  async getConnector(name: string) {
+    return this._connectors.getConnector({ name });
+  }
+
+  async deleteConnector(name: string) {
+    return this._connectors.deleteConnector({ name });
+  }
+
+  async listConnectorTools(name: string) {
+    return this._connectors.listConnectorTools({ name });
+  }
+
+  // --- Offices ---
+
+  async listOffices() {
+    return this._offices.listOffices({});
+  }
+
+  async getOffice(name: string) {
+    return this._offices.getOffice({ name });
+  }
+
+  async deleteOffice(name: string) {
+    return this._offices.deleteOffice({ name });
+  }
+
+  async getOfficeEvents(name: string) {
+    return this._offices.getOfficeEvents({ name });
+  }
+
+  // --- Templates ---
+
+  async listTemplates() {
+    return this._templates.listTemplates({});
+  }
+
+
+  // --- WebSocket ---
+
+  watchAgent(name: string): AgentEventStream {
+    const wsUrl = this._baseUrl.replace("http://", "ws://").replace("https://", "wss://");
+    return new AgentEventStream(wsUrl, name);
+  }
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+/* tslint:disable */
+/* eslint-disable */
+export * from './runtime';
+export * from './apis/index';
+export * from './models/index';
+export { KomputerClient } from './client';
+export type { AgentEvent } from './watch';

package/src/models/AgentListResponse.ts

@@ -0,0 +1,73 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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 { mapValues } from '../runtime';
+import type { AgentResponse } from './AgentResponse';
+import {
+    AgentResponseFromJSON,
+    AgentResponseFromJSONTyped,
+    AgentResponseToJSON,
+    AgentResponseToJSONTyped,
+} from './AgentResponse';
+
+/**
+ * 
+ * @export
+ * @interface AgentListResponse
+ */
+export interface AgentListResponse {
+    /**
+     * 
+     * @type {Array<AgentResponse>}
+     * @memberof AgentListResponse
+     */
+    agents?: Array<AgentResponse>;
+}
+
+/**
+ * Check if a given object implements the AgentListResponse interface.
+ */
+export function instanceOfAgentListResponse(value: object): value is AgentListResponse {
+    return true;
+}
+
+export function AgentListResponseFromJSON(json: any): AgentListResponse {
+    return AgentListResponseFromJSONTyped(json, false);
+}
+
+export function AgentListResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentListResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'agents': json['agents'] == null ? undefined : ((json['agents'] as Array<any>).map(AgentResponseFromJSON)),
+    };
+}
+
+export function AgentListResponseToJSON(json: any): AgentListResponse {
+    return AgentListResponseToJSONTyped(json, false);
+}
+
+export function AgentListResponseToJSONTyped(value?: AgentListResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'agents': value['agents'] == null ? undefined : ((value['agents'] as Array<any>).map(AgentResponseToJSON)),
+    };
+}
+

package/src/models/AgentResponse.ts

@@ -0,0 +1,201 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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 { mapValues } from '../runtime';
+/**
+ * 
+ * @export
+ * @interface AgentResponse
+ */
+export interface AgentResponse {
+    /**
+     * KomputerConnector names attached to this agent
+     * @type {Array<string>}
+     * @memberof AgentResponse
+     */
+    connectors?: Array<string>;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    createdAt?: string;
+    /**
+     * User task (spec.instructions)
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    instructions?: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    lastTaskCostUSD?: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    lastTaskMessage?: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    lifecycle?: string;
+    /**
+     * KomputerMemory names attached to this agent
+     * @type {Array<string>}
+     * @memberof AgentResponse
+     */
+    memories?: Array<string>;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    model?: string;
+    /**
+     * 
+     * @type {number}
+     * @memberof AgentResponse
+     */
+    modelContextWindow?: number;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    name?: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    namespace?: string;
+    /**
+     * Key names from K8s Secrets (not values)
+     * @type {Array<string>}
+     * @memberof AgentResponse
+     */
+    secrets?: Array<string>;
+    /**
+     * KomputerSkill names attached to this agent
+     * @type {Array<string>}
+     * @memberof AgentResponse
+     */
+    skills?: Array<string>;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    status?: string;
+    /**
+     * Custom system prompt (spec.systemPrompt)
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    systemPrompt?: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    taskStatus?: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof AgentResponse
+     */
+    totalCostUSD?: string;
+    /**
+     * 
+     * @type {number}
+     * @memberof AgentResponse
+     */
+    totalTokens?: number;
+}
+
+/**
+ * Check if a given object implements the AgentResponse interface.
+ */
+export function instanceOfAgentResponse(value: object): value is AgentResponse {
+    return true;
+}
+
+export function AgentResponseFromJSON(json: any): AgentResponse {
+    return AgentResponseFromJSONTyped(json, false);
+}
+
+export function AgentResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'connectors': json['connectors'] == null ? undefined : json['connectors'],
+        'createdAt': json['createdAt'] == null ? undefined : json['createdAt'],
+        'instructions': json['instructions'] == null ? undefined : json['instructions'],
+        'lastTaskCostUSD': json['lastTaskCostUSD'] == null ? undefined : json['lastTaskCostUSD'],
+        'lastTaskMessage': json['lastTaskMessage'] == null ? undefined : json['lastTaskMessage'],
+        'lifecycle': json['lifecycle'] == null ? undefined : json['lifecycle'],
+        'memories': json['memories'] == null ? undefined : json['memories'],
+        'model': json['model'] == null ? undefined : json['model'],
+        'modelContextWindow': json['modelContextWindow'] == null ? undefined : json['modelContextWindow'],
+        'name': json['name'] == null ? undefined : json['name'],
+        'namespace': json['namespace'] == null ? undefined : json['namespace'],
+        'secrets': json['secrets'] == null ? undefined : json['secrets'],
+        'skills': json['skills'] == null ? undefined : json['skills'],
+        'status': json['status'] == null ? undefined : json['status'],
+        'systemPrompt': json['systemPrompt'] == null ? undefined : json['systemPrompt'],
+        'taskStatus': json['taskStatus'] == null ? undefined : json['taskStatus'],
+        'totalCostUSD': json['totalCostUSD'] == null ? undefined : json['totalCostUSD'],
+        'totalTokens': json['totalTokens'] == null ? undefined : json['totalTokens'],
+    };
+}
+
+export function AgentResponseToJSON(json: any): AgentResponse {
+    return AgentResponseToJSONTyped(json, false);
+}
+
+export function AgentResponseToJSONTyped(value?: AgentResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'connectors': value['connectors'],
+        'createdAt': value['createdAt'],
+        'instructions': value['instructions'],
+        'lastTaskCostUSD': value['lastTaskCostUSD'],
+        'lastTaskMessage': value['lastTaskMessage'],
+        'lifecycle': value['lifecycle'],
+        'memories': value['memories'],
+        'model': value['model'],
+        'modelContextWindow': value['modelContextWindow'],
+        'name': value['name'],
+        'namespace': value['namespace'],
+        'secrets': value['secrets'],
+        'skills': value['skills'],
+        'status': value['status'],
+        'systemPrompt': value['systemPrompt'],
+        'taskStatus': value['taskStatus'],
+        'totalCostUSD': value['totalCostUSD'],
+        'totalTokens': value['totalTokens'],
+    };
+}
+