@claudexor/harness-raw-api 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 joi-lab
+
+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,7 @@
+# @claudexor/harness-raw-api
+
+Internal package of [Claudexor](https://github.com/razzant/claudexor) — Raw-API harness: OpenAI-compatible chat completions (planner/reviewer; no native edit tools).
+
+Published as part of the Claudexor toolchain; it follows the monorepo's
+lockstep version and has no separate semver contract. Use the `claudexor`
+CLI (or `@claudexor/cli`) as the supported entry point.

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import type { ProviderFamily } from "@claudexor/schema";
+import type { HarnessAdapter } from "@claudexor/core";
+export interface RawApiConfig {
+    id?: string;
+    providerFamily?: ProviderFamily;
+    baseUrl?: string;
+    keyEnv?: string;
+    defaultModel?: string;
+}
+/**
+ * A raw-API harness backed by an OpenAI-compatible chat-completions endpoint.
+ * It has no native edit tools, so it serves as a planner/reviewer (useful as a
+ * cross-family reviewer via API key when no CLI of that family is installed).
+ */
+export declare function createRawApiAdapter(config?: RawApiConfig): HarnessAdapter;
+//# 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":"AACA,OAAO,KAAK,EAAkF,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExI,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,iBAAiB,CAAC;AA+BlE,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,YAAiB,GAAG,cAAc,CAmL7E"}

package/dist/index.js

@@ -0,0 +1,224 @@
+import { readFileSync } from "node:fs";
+import { ConformanceReport as ConformanceReportSchema, HarnessManifest as HarnessManifestSchema } from "@claudexor/schema";
+import { HarnessUnavailableError, abortSignalFromSpec } from "@claudexor/core";
+import { resolveSecret } from "@claudexor/secrets";
+import { CLAUDEXOR_VERSION, nowIso, redactSecrets } from "@claudexor/util";
+import { parseChatCompletion, parseModelsList } from "./parse.js";
+/** A stalled remote endpoint must not hang a run forever. */
+const RAW_API_TIMEOUT_MS = 180_000;
+/** Model enumeration is interactive (a picker waits on it): keep it snappy. */
+const RAW_API_MODELS_TIMEOUT_MS = 15_000;
+const RAW_API_TRANSIENT_STATUS = new Set([408, 502, 503, 504]);
+/**
+ * Build the chat-completions user `content`. With image attachments, switch
+ * from a plain string to the OpenAI-compatible parts array (`text` +
+ * `image_url` data URLs). Non-image attachments have no inline chat shape.
+ */
+function rawApiUserContent(spec) {
+    const images = (spec.attachments ?? []).filter((a) => a.kind === "image");
+    if (images.length === 0)
+        return spec.prompt;
+    const parts = [{ type: "text", text: spec.prompt }];
+    for (const a of images) {
+        try {
+            parts.push({ type: "image_url", image_url: { url: `data:${a.mime};base64,${readFileSync(a.path).toString("base64")}` } });
+        }
+        catch {
+            // Late-deleted attachment: skip; the text prompt still goes through.
+        }
+    }
+    return parts.length > 1 ? parts : spec.prompt;
+}
+/**
+ * A raw-API harness backed by an OpenAI-compatible chat-completions endpoint.
+ * It has no native edit tools, so it serves as a planner/reviewer (useful as a
+ * cross-family reviewer via API key when no CLI of that family is installed).
+ */
+export function createRawApiAdapter(config = {}) {
+    const id = config.id ?? "raw-api";
+    const providerFamily = config.providerFamily ?? "openai";
+    const baseUrl = config.baseUrl ?? process.env.CLAUDEXOR_RAWAPI_BASE_URL ?? "https://api.openai.com/v1";
+    const keyEnv = config.keyEnv ?? (process.env.CLAUDEXOR_RAWAPI_KEY ? "CLAUDEXOR_RAWAPI_KEY" : "OPENAI_API_KEY");
+    const defaultModel = config.defaultModel ?? process.env.CLAUDEXOR_RAWAPI_MODEL ?? "gpt-4o-mini";
+    function apiKey() {
+        const env = process.env[keyEnv];
+        if (env)
+            return env;
+        // Secret fallback is INSTANCE-SCOPED so a key for one provider is never sent
+        // to another (e.g. an OpenAI "raw" key must not reach openrouter.ai). The
+        // default OpenAI-compatible instance owns the managed "raw" (and "openai")
+        // secret; every named instance (openrouter, …) resolves ONLY its own slot.
+        if (id === "raw-api") {
+            return resolveSecret("raw") ?? (keyEnv === "OPENAI_API_KEY" ? (resolveSecret("openai") ?? undefined) : undefined);
+        }
+        return resolveSecret(id) ?? undefined;
+    }
+    return {
+        id,
+        async discover() {
+            if (!apiKey()) {
+                throw new HarnessUnavailableError(`raw-api unavailable: set ${keyEnv}`);
+            }
+            return HarnessManifestSchema.parse({
+                id,
+                display_name: `Raw API (${providerFamily})`,
+                kind: "remote_api",
+                // A remote HTTP API has no CLI binary version; the endpoint contract
+                // is the closest honest "version" (UIs render this field verbatim —
+                // a model id here would read as a bogus harness version).
+                version: `${providerFamily} chat-completions API`,
+                adapter_version: CLAUDEXOR_VERSION,
+                provider_family: providerFamily,
+                capabilities: {
+                    plan: true,
+                    implement: false,
+                    create_from_scratch: false,
+                    review: true,
+                    verify: false,
+                    synthesize: true,
+                    orchestrate: true,
+                    read_files: false,
+                    browser_tool: false,
+                    web_policy: "none",
+                    // The chat-completions request sends no `reasoning_effort` field
+                    // (body is {model, messages} only) -> effort is not a tunable surface.
+                    effort_levels: [],
+                },
+                capability_profile: {
+                    auth: {
+                        supported_sources: ["api_key_env"],
+                        preferred_source: "api_key_env",
+                        credential_transports: [{ source: "api_key_env", kind: "http_header", relocatable_by: ["ENV"] }],
+                    },
+                    access_control: { readonly_mechanism: "none" },
+                    isolation: { supported_containment: ["env_or_file_injection"] },
+                    // OpenAI-compatible chat-completions accept images as an inline `image_url` data URL part.
+                    image_input: "base64_inline",
+                },
+                auth_modes: ["api_key"],
+                access_profiles_supported: ["readonly"],
+            });
+        },
+        async doctor(_spec) {
+            if (!apiKey()) {
+                return ConformanceReportSchema.parse({
+                    harness_id: id,
+                    status: "unavailable",
+                    checks: [{ id: "api_key", status: "fail", detail: `${keyEnv} not set` }],
+                    reasons: [`set ${keyEnv} to enable the raw-api harness`],
+                });
+            }
+            // A key STRING is source availability, not proven readiness: no isolated
+            // smoke runs here (doctor must not spend paid API calls), so the honest
+            // status is degraded-with-reason rather than ok-by-key-presence.
+            return ConformanceReportSchema.parse({
+                harness_id: id,
+                status: "degraded",
+                checks: [
+                    { id: "api_key", status: "pass", detail: "key available (unproven without isolated smoke)" },
+                    { id: "isolated_smoke", status: "skip", detail: "doctor does not spend paid API calls" },
+                ],
+                // No native edit tools: planner/reviewer roles only.
+                enabled_intents: ["plan", "spec", "review", "synthesize", "explain", "orchestrate"],
+                disabled_intents: ["implement", "create_from_scratch", "repair", "verify"],
+                reasons: ["key present but route unproven (no isolated smoke)"],
+            });
+        },
+        // The REAL enumeration producer (ADP4): an OpenAI-compatible endpoint
+        // exposes `GET <baseURL>/models`. Fails SOFT — a picker must never see a
+        // throw, so network/auth/parse errors collapse to an empty list.
+        async models() {
+            const key = apiKey();
+            if (!key)
+                return [];
+            try {
+                const res = await fetch(`${baseUrl.replace(/\/$/, "")}/models`, {
+                    method: "GET",
+                    headers: { accept: "application/json", authorization: `Bearer ${key}` },
+                    signal: AbortSignal.timeout(RAW_API_MODELS_TIMEOUT_MS),
+                });
+                if (!res.ok)
+                    return [];
+                const json = await res.json();
+                return parseModelsList(json).map((m) => ({ id: m.id, label: m.label, context_window: m.context_window }));
+            }
+            catch {
+                return [];
+            }
+        },
+        async *run(spec) {
+            const key = apiKey();
+            if (!key) {
+                yield { type: "error", session_id: spec.session_id, ts: nowIso(), error: `raw-api: ${keyEnv} not set` };
+                yield { type: "completed", session_id: spec.session_id, ts: nowIso() };
+                return;
+            }
+            const model = spec.model_hint ?? defaultModel;
+            // The model is only REQUESTED here; the observed model comes from the response.
+            yield { type: "started", session_id: spec.session_id, ts: nowIso(), payload: { requested_model: model } };
+            try {
+                const specSignal = abortSignalFromSpec(spec);
+                const timeoutSignal = AbortSignal.timeout(RAW_API_TIMEOUT_MS);
+                const signal = specSignal ? AbortSignal.any([specSignal, timeoutSignal]) : timeoutSignal;
+                const res = await fetch(`${baseUrl.replace(/\/$/, "")}/chat/completions`, {
+                    method: "POST",
+                    headers: { "content-type": "application/json", authorization: `Bearer ${key}` },
+                    body: JSON.stringify({ model, messages: [{ role: "user", content: rawApiUserContent(spec) }] }),
+                    signal,
+                });
+                if (!res.ok) {
+                    const body = await res.text().catch(() => "");
+                    const retryAfter = res.headers.get("retry-after");
+                    const resetsAt = retryAfter ? resetsAtFromRetryAfter(retryAfter) : null;
+                    const retryDelayMs = retryAfter && Number.isFinite(Number(retryAfter)) ? Number(retryAfter) * 1000 : null;
+                    yield {
+                        type: "error",
+                        session_id: spec.session_id,
+                        ts: nowIso(),
+                        error: `raw-api HTTP ${res.status}`,
+                        // A 429 is a TYPED rate-limit signal (cooldown/fallback governance
+                        // reads ev.rate_limit, never prose), with the native reset when known.
+                        ...(res.status === 429 ? { rate_limit: { resets_at: resetsAt, retry_delay_ms: retryDelayMs } } : {}),
+                        ...(res.status === 429 || RAW_API_TRANSIENT_STATUS.has(res.status)
+                            ? { transient: { kind: res.status === 408 ? "timeout" : "service_unavailable", retry_delay_ms: retryDelayMs } }
+                            : {}),
+                        payload: res.status === 429 ? { resets_at: resetsAt } : { body: redactSecrets(body.slice(0, 500)) },
+                    };
+                    yield { type: "completed", session_id: spec.session_id, ts: nowIso() };
+                    return;
+                }
+                const json = await res.json();
+                const parsed = parseChatCompletion(json);
+                if (parsed.text)
+                    yield { type: "message", session_id: spec.session_id, ts: nowIso(), text: parsed.text };
+                yield {
+                    type: "usage",
+                    session_id: spec.session_id,
+                    ts: nowIso(),
+                    usage: { input_tokens: parsed.usage.input_tokens, output_tokens: parsed.usage.output_tokens },
+                    observed_model: parsed.model ?? undefined,
+                };
+                yield { type: "completed", session_id: spec.session_id, ts: nowIso(), observed_model: parsed.model ?? undefined };
+            }
+            catch (err) {
+                const message = redactSecrets(err instanceof Error ? err.message : String(err));
+                yield {
+                    type: "error",
+                    session_id: spec.session_id,
+                    ts: nowIso(),
+                    error: message,
+                    transient: { kind: err instanceof DOMException && err.name === "TimeoutError" ? "timeout" : "network", retry_delay_ms: null },
+                };
+                yield { type: "completed", session_id: spec.session_id, ts: nowIso() };
+            }
+        },
+    };
+}
+function resetsAtFromRetryAfter(header) {
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return new Date(Date.now() + seconds * 1000).toISOString();
+    const date = new Date(header);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,23 @@
+export interface ChatResult {
+    text: string;
+    model: string | null;
+    usage: {
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+}
+export interface ParsedModel {
+    id: string;
+    label: string | null;
+    context_window: number | null;
+}
+/**
+ * Parse an OpenAI-compatible `GET /v1/models` response: `{ data: [{ id, ... }] }`.
+ * Only `id` is guaranteed by the OpenAI shape; `context_window`/`label` are
+ * populated opportunistically (some compatible providers, e.g. OpenRouter,
+ * carry richer fields). Entries without a usable string `id` are dropped.
+ */
+export declare function parseModelsList(json: any): ParsedModel[];
+/** Parse an OpenAI-compatible /chat/completions response. */
+export declare function parseChatCompletion(json: any): ChatResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,WAAW,EAAE,CAYxD;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,UAAU,CAYzD"}

package/dist/parse.js

@@ -0,0 +1,35 @@
+/**
+ * Parse an OpenAI-compatible `GET /v1/models` response: `{ data: [{ id, ... }] }`.
+ * Only `id` is guaranteed by the OpenAI shape; `context_window`/`label` are
+ * populated opportunistically (some compatible providers, e.g. OpenRouter,
+ * carry richer fields). Entries without a usable string `id` are dropped.
+ */
+export function parseModelsList(json) {
+    const data = Array.isArray(json?.data) ? json.data : [];
+    const out = [];
+    for (const entry of data) {
+        const id = typeof entry?.id === "string" ? entry.id : null;
+        if (!id)
+            continue;
+        const label = typeof entry?.name === "string" ? entry.name : null;
+        const ctxRaw = entry?.context_length ?? entry?.context_window;
+        const context_window = typeof ctxRaw === "number" && Number.isInteger(ctxRaw) && ctxRaw > 0 ? ctxRaw : null;
+        out.push({ id, label, context_window });
+    }
+    return out;
+}
+/** Parse an OpenAI-compatible /chat/completions response. */
+export function parseChatCompletion(json) {
+    const choice = json?.choices?.[0];
+    const text = String(choice?.message?.content ?? "");
+    const usage = json?.usage ?? {};
+    return {
+        text,
+        model: typeof json?.model === "string" ? json.model : null,
+        usage: {
+            input_tokens: typeof usage.prompt_tokens === "number" ? usage.prompt_tokens : undefined,
+            output_tokens: typeof usage.completion_tokens === "number" ? usage.completion_tokens : undefined,
+        },
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAS;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,OAAO,KAAK,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,MAAM,KAAK,GAAG,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,MAAM,MAAM,GAAG,KAAK,EAAE,cAAc,IAAI,KAAK,EAAE,cAAc,CAAC;QAC9D,MAAM,cAAc,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5G,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CAAC,IAAS;IAC3C,MAAM,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IAChC,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QAC1D,KAAK,EAAE;YACL,YAAY,EAAE,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;YACvF,aAAa,EAAE,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;SACjG;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@claudexor/harness-raw-api",
+  "version": "1.0.0",
+  "license": "MIT",
+  "description": "Raw-API harness: OpenAI-compatible chat completions (planner/reviewer; no native edit tools).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@claudexor/schema": "1.0.0",
+    "@claudexor/core": "1.0.0",
+    "@claudexor/secrets": "1.0.0",
+    "@claudexor/util": "1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/razzant/claudexor.git",
+    "directory": "packages/harness-raw-api"
+  },
+  "homepage": "https://github.com/razzant/claudexor#readme",
+  "bugs": {
+    "url": "https://github.com/razzant/claudexor/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}