@bang404/openagent-harness 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BANG404
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# OpenAgent Harness Client
+
+Thin TypeScript client for the private OpenAgent runtime. The package contains
+only the public wire contract and process-management helpers; the agent loop,
+prompts, providers, tools, persistence, and checkpoint implementation remain in
+the private `openagent-server` binary.
+
+```ts
+import { spawnOpenAgent } from "@bang404/openagent-harness/node";
+
+const agent = await spawnOpenAgent({ workspace: process.cwd() });
+const [workspace] = await agent.client.listWorkspaces();
+const session = await agent.client.createSession(workspace.id);
+const result = await agent.client.runToCompletion(session.session_id, {
+  input: "Fix the failing tests",
+});
+console.log(result.status);
+await agent.stop();
+```
+
+The daemon listens on an ephemeral loopback port and uses a process-scoped
+Bearer token. Do not expose the endpoint or token to untrusted code.

package/dist/client.d.ts

@@ -0,0 +1,28 @@
+import { type CreateRunRequest, type HarnessCapabilities, type HarnessClientOptions, type HarnessEventEnvelope, type HarnessRunAccepted, type HarnessRunState, type HarnessSession, type HarnessWorkspace, type RunEventOptions, type UploadedAttachment } from "./types.js";
+export declare class OpenAgentHarnessError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export declare class OpenAgentHarnessClient {
+    private readonly endpoint;
+    private readonly token;
+    private readonly fetchRequest;
+    constructor(options: HarnessClientOptions);
+    capabilities(): Promise<HarnessCapabilities>;
+    listWorkspaces(): Promise<HarnessWorkspace[]>;
+    createSession(workspaceId: string, roleId?: string): Promise<HarnessSession>;
+    getSession(sessionId: string): Promise<HarnessSession>;
+    deleteSession(sessionId: string): Promise<void>;
+    uploadAttachment(name: string, contentBase64: string): Promise<UploadedAttachment>;
+    createRun(sessionId: string, input: CreateRunRequest): Promise<HarnessRunAccepted>;
+    getRun(runId: string): Promise<HarnessRunState>;
+    cancelRun(runId: string): Promise<void>;
+    respondToInterrupt(runId: string, interruptId: string, response: unknown): Promise<void>;
+    events(runId: string, options?: RunEventOptions): AsyncGenerator<HarnessEventEnvelope>;
+    runToCompletion(sessionId: string, input: CreateRunRequest, options?: RunEventOptions): Promise<HarnessRunState>;
+    private request;
+    private headers;
+    private url;
+    private responseError;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAEzB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AAEpB,qBAAa,qBAAsB,SAAQ,KAAK;IAG5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;gBADxB,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,OAAO,EAAE,oBAAoB;IAMnC,YAAY,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAUlD,cAAc,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI7C,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAO5E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOlF,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYlF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvF,MAAM,CACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC5B,cAAc,CAAC,oBAAoB,CAAC;IAyCjC,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC;YAUb,OAAO;IAcrB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,GAAG;YAIG,aAAa;CAO5B"}

package/dist/client.js

@@ -0,0 +1,140 @@
+import { OPENAGENT_HARNESS_PROTOCOL_VERSION, } from "./types.js";
+export class OpenAgentHarnessError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "OpenAgentHarnessError";
+    }
+}
+export class OpenAgentHarnessClient {
+    endpoint;
+    token;
+    fetchRequest;
+    constructor(options) {
+        this.endpoint = options.endpoint.replace(/\/$/, "");
+        this.token = options.token;
+        this.fetchRequest = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async capabilities() {
+        const capabilities = await this.request("/v1/capabilities");
+        if (capabilities.protocol_version !== OPENAGENT_HARNESS_PROTOCOL_VERSION) {
+            throw new OpenAgentHarnessError(`OpenAgent protocol mismatch: server ${capabilities.protocol_version}, client ${OPENAGENT_HARNESS_PROTOCOL_VERSION}`);
+        }
+        return capabilities;
+    }
+    listWorkspaces() {
+        return this.request("/v1/workspaces");
+    }
+    createSession(workspaceId, roleId) {
+        return this.request("/v1/sessions", {
+            method: "POST",
+            body: JSON.stringify({ workspace_id: workspaceId, role_id: roleId }),
+        });
+    }
+    getSession(sessionId) {
+        return this.request(`/v1/sessions/${encodeURIComponent(sessionId)}`);
+    }
+    async deleteSession(sessionId) {
+        await this.request(`/v1/sessions/${encodeURIComponent(sessionId)}`, { method: "DELETE" });
+    }
+    uploadAttachment(name, contentBase64) {
+        return this.request("/v1/attachments", {
+            method: "POST",
+            body: JSON.stringify({ name, content_base64: contentBase64 }),
+        });
+    }
+    createRun(sessionId, input) {
+        return this.request(`/v1/sessions/${encodeURIComponent(sessionId)}/runs`, {
+            method: "POST",
+            body: JSON.stringify({
+                input: input.input,
+                attachments: input.attachments ?? [],
+                model: input.model,
+                idempotency_key: input.idempotencyKey,
+            }),
+        });
+    }
+    getRun(runId) {
+        return this.request(`/v1/runs/${encodeURIComponent(runId)}`);
+    }
+    async cancelRun(runId) {
+        await this.request(`/v1/runs/${encodeURIComponent(runId)}/cancel`, { method: "POST" });
+    }
+    async respondToInterrupt(runId, interruptId, response) {
+        await this.request(`/v1/runs/${encodeURIComponent(runId)}/interrupts/${encodeURIComponent(interruptId)}/response`, { method: "POST", body: JSON.stringify({ response }) });
+    }
+    async *events(runId, options = {}) {
+        const response = await this.fetchRequest(this.url(`/v1/runs/${encodeURIComponent(runId)}/events`), { headers: this.headers(), signal: options.signal });
+        if (!response.ok || !response.body) {
+            throw await this.responseError(response);
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { value, done } = await reader.read();
+                buffer += decoder.decode(value, { stream: !done });
+                buffer = buffer.replace(/\r\n/g, "\n");
+                let boundary;
+                while ((boundary = buffer.indexOf("\n\n")) >= 0) {
+                    const block = buffer.slice(0, boundary).replace(/\r/g, "");
+                    buffer = buffer.slice(boundary + 2);
+                    const data = block
+                        .split("\n")
+                        .filter((line) => line.startsWith("data:"))
+                        .map((line) => line.slice(5).trimStart())
+                        .join("\n");
+                    if (!data)
+                        continue;
+                    const event = JSON.parse(data);
+                    if (event.protocol_version !== OPENAGENT_HARNESS_PROTOCOL_VERSION) {
+                        throw new OpenAgentHarnessError(`OpenAgent event protocol mismatch: ${event.protocol_version}`);
+                    }
+                    yield event;
+                }
+                if (done)
+                    break;
+            }
+        }
+        finally {
+            await reader.cancel().catch(() => undefined);
+        }
+    }
+    async runToCompletion(sessionId, input, options = {}) {
+        const accepted = await this.createRun(sessionId, input);
+        for await (const event of this.events(accepted.run_id, options)) {
+            if (["completed", "cancelled", "failed"].includes(event.data.status)) {
+                return event.data;
+            }
+        }
+        return this.getRun(accepted.run_id);
+    }
+    async request(path, init = {}) {
+        const response = await this.fetchRequest(this.url(path), {
+            ...init,
+            headers: {
+                ...this.headers(),
+                ...(init.body ? { "content-type": "application/json" } : {}),
+                ...init.headers,
+            },
+        });
+        if (!response.ok)
+            throw await this.responseError(response);
+        if (response.status === 204)
+            return undefined;
+        return response.json();
+    }
+    headers() {
+        return { authorization: `Bearer ${this.token}` };
+    }
+    url(path) {
+        return `${this.endpoint}${path}`;
+    }
+    async responseError(response) {
+        const payload = (await response.json().catch(() => null));
+        return new OpenAgentHarnessError(payload?.error ?? `${response.status} ${response.statusText}`, response.status);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { OpenAgentHarnessClient, OpenAgentHarnessError } from "./client.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5E,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { OpenAgentHarnessClient, OpenAgentHarnessError } from "./client.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5E,cAAc,YAAY,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,19 @@
+import { type ChildProcessWithoutNullStreams } from "node:child_process";
+import { OpenAgentHarnessClient } from "./client.js";
+export interface SpawnOpenAgentOptions {
+    binaryPath?: string;
+    workspace: string;
+    listen?: string;
+    env?: NodeJS.ProcessEnv;
+    startupTimeoutMs?: number;
+}
+export interface SpawnedOpenAgent {
+    client: OpenAgentHarnessClient;
+    endpoint: string;
+    /** Process-scoped credential. Keep it out of logs and untrusted child processes. */
+    token: string;
+    process: ChildProcessWithoutNullStreams;
+    stop(): Promise<void>;
+}
+export declare function spawnOpenAgent(options: SpawnOpenAgentOptions): Promise<SpawnedOpenAgent>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,8BAA8B,CAAC;IACxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAUD,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAyE3B"}

package/dist/node.js

@@ -0,0 +1,75 @@
+import { randomBytes } from "node:crypto";
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { OpenAgentHarnessClient } from "./client.js";
+export async function spawnOpenAgent(options) {
+    const binaryPath = options.binaryPath ?? "openagent-server";
+    const token = randomBytes(32).toString("hex");
+    const tokenEnv = `OPENAGENT_HARNESS_TOKEN_${process.pid}_${Date.now()}`;
+    const child = spawn(binaryPath, [
+        "--workspace",
+        options.workspace,
+        "--listen",
+        options.listen ?? "127.0.0.1:0",
+        "--token-env",
+        tokenEnv,
+        "--output",
+        "json",
+    ], {
+        env: { ...process.env, ...options.env, [tokenEnv]: token },
+        stdio: ["pipe", "pipe", "pipe"],
+        windowsHide: true,
+    });
+    const timeoutMs = options.startupTimeoutMs ?? 30_000;
+    const ready = await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            child.kill();
+            reject(new Error(`OpenAgent server did not become ready within ${timeoutMs}ms`));
+        }, timeoutMs);
+        const lines = createInterface({ input: child.stdout });
+        const fail = (error) => {
+            clearTimeout(timeout);
+            lines.close();
+            reject(error);
+        };
+        child.once("error", fail);
+        child.once("exit", (code) => fail(new Error(`OpenAgent server exited before ready (${code})`)));
+        lines.on("line", (line) => {
+            try {
+                const message = JSON.parse(line);
+                if (message.type !== "ready")
+                    return;
+                clearTimeout(timeout);
+                child.removeListener("error", fail);
+                lines.close();
+                resolve(message);
+            }
+            catch {
+                // Tracing output may precede the machine-readable ready message.
+            }
+        });
+    });
+    const stop = async () => {
+        if (child.exitCode !== null)
+            return;
+        child.kill("SIGTERM");
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                child.kill("SIGKILL");
+                resolve();
+            }, 5_000);
+            child.once("exit", () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+        });
+    };
+    return {
+        client: new OpenAgentHarnessClient({ endpoint: ready.endpoint, token }),
+        endpoint: ready.endpoint,
+        token,
+        process: child,
+        stop,
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,77 @@
+export declare const OPENAGENT_HARNESS_PROTOCOL_VERSION = 2;
+export interface HarnessCapabilities {
+    protocol_version: number;
+    server_version: string;
+    capabilities: string[];
+}
+export interface HarnessWorkspace {
+    id: string;
+    name: string;
+}
+export interface HarnessSession {
+    session_id: string;
+    title?: string | null;
+    status?: "idle" | "running" | "interrupted";
+}
+export interface ModelBinding {
+    provider_id: string;
+    model: string;
+}
+export interface CreateRunRequest {
+    input: string;
+    attachments?: string[];
+    model?: ModelBinding;
+    idempotencyKey?: string;
+}
+export interface HarnessRunAccepted {
+    run_id: string;
+    session_id: string;
+    status: "accepted";
+}
+export type HarnessRunStatus = "accepted" | "running" | "interrupted" | "completed" | "cancelled" | "failed";
+export interface HarnessMessage {
+    id: string;
+    role: "user" | "assistant" | string;
+    text: string;
+    status: "completed" | "aborted";
+    timestamp: number;
+}
+export interface HarnessInterrupt {
+    id: string;
+    kind: "ask_user" | "tool_approval" | "render_mermaid" | string;
+    tool_name: string;
+    arguments: unknown;
+    fields: unknown[];
+}
+export interface HarnessRunState {
+    run_id: string;
+    session_id: string;
+    status: HarnessRunStatus;
+    checkpoint_id?: string | null;
+    messages: HarnessMessage[];
+    interrupts: HarnessInterrupt[];
+    created_at: number;
+}
+export interface HarnessEventEnvelope {
+    protocol_version: number;
+    run_id: string;
+    sequence: number;
+    event_type: "run.state";
+    data: HarnessRunState;
+}
+export interface UploadedAttachment {
+    path: string;
+    name: string;
+    kind: "image" | "document";
+    mime_type: string;
+}
+export interface HarnessClientOptions {
+    endpoint: string;
+    token: string;
+    fetch?: HarnessFetch;
+}
+export type HarnessFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export interface RunEventOptions {
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,SAAS,GACT,aAAa,GACb,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,gBAAgB,GAAG,MAAM,CAAC;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,WAAW,CAAC;IACxB,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE/F,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const OPENAGENT_HARNESS_PROTOCOL_VERSION = 2;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC"}

package/openapi.yaml

@@ -0,0 +1,294 @@
+openapi: 3.1.0
+info:
+  title: OpenAgent Harness API
+  version: 0.1.0
+  description: >-
+    Behavior-free public contract for a private OpenAgent runtime process.
+    All endpoints require a process-scoped Bearer token and are served only on
+    loopback interfaces.
+servers:
+  - url: http://127.0.0.1:{port}
+    variables:
+      port:
+        default: "32123"
+security:
+  - bearerAuth: []
+paths:
+  /v1/capabilities:
+    get:
+      operationId: getCapabilities
+      responses:
+        "200":
+          description: Supported protocol and runtime capabilities
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Capabilities"
+  /v1/workspaces:
+    get:
+      operationId: listWorkspaces
+      responses:
+        "200":
+          description: Workspaces authorized when the daemon started
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/Workspace"
+  /v1/attachments:
+    post:
+      operationId: uploadAttachment
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [name, content_base64]
+              properties:
+                name: { type: string, maxLength: 255 }
+                content_base64: { type: string }
+      responses:
+        "200":
+          description: Stored attachment locator
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Attachment"
+  /v1/sessions:
+    post:
+      operationId: createSession
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [workspace_id]
+              properties:
+                workspace_id: { type: string }
+                role_id: { type: [string, "null"] }
+      responses:
+        "201":
+          description: Created harness session
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Session"
+  /v1/sessions/{session_id}:
+    parameters:
+      - $ref: "#/components/parameters/SessionId"
+    get:
+      operationId: getSession
+      responses:
+        "200":
+          description: Session state without private transcript records
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SessionState"
+    delete:
+      operationId: deleteSession
+      responses:
+        "204": { description: Session deleted }
+  /v1/sessions/{session_id}/runs:
+    parameters:
+      - $ref: "#/components/parameters/SessionId"
+    post:
+      operationId: createRun
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateRun"
+      responses:
+        "202":
+          description: Run accepted
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RunAccepted"
+  /v1/runs/{run_id}:
+    parameters:
+      - $ref: "#/components/parameters/RunId"
+    get:
+      operationId: getRun
+      responses:
+        "200":
+          description: Public projection of one run
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RunState"
+  /v1/runs/{run_id}/events:
+    parameters:
+      - $ref: "#/components/parameters/RunId"
+    get:
+      operationId: streamRunEvents
+      responses:
+        "200":
+          description: SSE stream of run.state envelopes
+          content:
+            text/event-stream:
+              schema:
+                $ref: "#/components/schemas/EventEnvelope"
+  /v1/runs/{run_id}/cancel:
+    parameters:
+      - $ref: "#/components/parameters/RunId"
+    post:
+      operationId: cancelRun
+      responses:
+        "202": { description: Cancellation accepted }
+  /v1/runs/{run_id}/interrupts/{interrupt_id}/response:
+    parameters:
+      - $ref: "#/components/parameters/RunId"
+      - name: interrupt_id
+        in: path
+        required: true
+        schema: { type: string }
+    post:
+      operationId: respondToInterrupt
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [response]
+              properties:
+                response: {}
+      responses:
+        "202": { description: Response accepted }
+components:
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+  parameters:
+    SessionId:
+      name: session_id
+      in: path
+      required: true
+      schema: { type: string, format: uuid }
+    RunId:
+      name: run_id
+      in: path
+      required: true
+      schema: { type: string, format: uuid }
+  schemas:
+    Capabilities:
+      type: object
+      required: [protocol_version, server_version, capabilities]
+      properties:
+        protocol_version: { type: integer, const: 2 }
+        server_version: { type: string }
+        capabilities:
+          type: array
+          items: { type: string }
+    Workspace:
+      type: object
+      required: [id, name]
+      properties:
+        id: { type: string }
+        name: { type: string }
+    Session:
+      type: object
+      required: [session_id]
+      properties:
+        session_id: { type: string, format: uuid }
+    SessionState:
+      allOf:
+        - $ref: "#/components/schemas/Session"
+        - type: object
+          required: [status]
+          properties:
+            title: { type: [string, "null"] }
+            status: { enum: [idle, running, interrupted] }
+    ModelBinding:
+      type: object
+      required: [provider_id, model]
+      properties:
+        provider_id: { type: string }
+        model: { type: string }
+    CreateRun:
+      type: object
+      required: [input]
+      properties:
+        input: { type: string, maxLength: 65536 }
+        attachments:
+          type: array
+          maxItems: 8
+          items: { type: string }
+        model:
+          $ref: "#/components/schemas/ModelBinding"
+        idempotency_key: { type: string, minLength: 1, maxLength: 128 }
+    RunAccepted:
+      type: object
+      required: [run_id, session_id, status]
+      properties:
+        run_id: { type: string, format: uuid }
+        session_id: { type: string, format: uuid }
+        status: { const: accepted }
+    Message:
+      type: object
+      required: [id, role, text, status, timestamp]
+      properties:
+        id: { type: string }
+        role: { type: string }
+        text: { type: string }
+        status: { enum: [completed, aborted] }
+        timestamp: { type: integer }
+    Interrupt:
+      type: object
+      required: [id, kind, tool_name, arguments, fields]
+      properties:
+        id: { type: string }
+        kind: { type: string }
+        tool_name: { type: string }
+        arguments: {}
+        fields:
+          type: array
+          items: {}
+    RunState:
+      type: object
+      required: [run_id, session_id, status, messages, interrupts, created_at]
+      properties:
+        run_id: { type: string, format: uuid }
+        session_id: { type: string, format: uuid }
+        status:
+          enum: [accepted, running, interrupted, completed, cancelled, failed]
+        checkpoint_id: { type: [string, "null"] }
+        messages:
+          type: array
+          items:
+            $ref: "#/components/schemas/Message"
+        interrupts:
+          type: array
+          items:
+            $ref: "#/components/schemas/Interrupt"
+        created_at: { type: integer }
+    Attachment:
+      type: object
+      required: [path, name, kind, mime_type]
+      properties:
+        path: { type: string }
+        name: { type: string }
+        kind: { enum: [image, document] }
+        mime_type: { type: string }
+    EventEnvelope:
+      type: object
+      required: [protocol_version, run_id, sequence, event_type, data]
+      properties:
+        protocol_version: { type: integer, const: 2 }
+        run_id: { type: string, format: uuid }
+        sequence: { type: integer, minimum: 1 }
+        event_type: { const: run.state }
+        data:
+          $ref: "#/components/schemas/RunState"
+    Error:
+      type: object
+      required: [error]
+      properties:
+        error: { type: string }

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@bang404/openagent-harness",
+  "version": "0.1.0",
+  "description": "Thin client for the private OpenAgent harness runtime",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BANG404/openagent-sdk.git",
+    "directory": "harness-typescript"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "openapi.yaml"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "check:openapi": "bun scripts/verify-openapi.ts",
+    "test": "bun test",
+    "prepack": "bun run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^24.0.0",
+    "typescript": "~5.6.2"
+  }
+}