open-agents-ai 0.185.75 → 0.185.76

package/dist/index.js

@@ -65977,6 +65977,98 @@ var init_logger = __esm({
   }
 });
 
+// packages/cli/dist/api/openapi.js
+function getOpenApiSpec() {
+  return {
+    openapi: "3.0.3",
+    info: {
+      title: "Open Agents REST API",
+      description: "AI coding agent powered by open-weight models. Enterprise REST API for agentic task execution, OpenAI-compatible inference, and system management.",
+      version: "0.185.75",
+      license: { name: "CC-BY-NC-4.0", url: "https://creativecommons.org/licenses/by-nc/4.0/" }
+    },
+    servers: [{ url: "http://localhost:11435", description: "Local development" }],
+    security: [{ BearerAuth: [] }],
+    components: {
+      securitySchemes: {
+        BearerAuth: { type: "http", scheme: "bearer", description: "API key with scope (read/run/admin)" }
+      }
+    },
+    paths: {
+      "/health": { get: { summary: "Liveness probe", tags: ["Health"], security: [], responses: { 200: { description: "Server is alive" } } } },
+      "/health/ready": { get: { summary: "Readiness probe (checks backend)", tags: ["Health"], security: [], responses: { 200: { description: "Backend reachable" }, 503: { description: "Backend unreachable" } } } },
+      "/health/startup": { get: { summary: "Startup complete", tags: ["Health"], security: [], responses: { 200: { description: "Started" } } } },
+      "/version": { get: { summary: "Version info", tags: ["Health"], security: [], responses: { 200: { description: "Version, node, platform" } } } },
+      "/metrics": { get: { summary: "Prometheus metrics", tags: ["Health"], security: [], responses: { 200: { description: "Prometheus text format" } } } },
+      "/v1/models": { get: { summary: "List available models", tags: ["Inference"], security: [{ BearerAuth: [] }], responses: { 200: { description: "OpenAI-format model list" } } } },
+      "/v1/chat/completions": { post: { summary: "Chat completion (OpenAI-compatible)", tags: ["Inference"], security: [{ BearerAuth: [] }], requestBody: { required: true, content: { "application/json": { schema: { type: "object", required: ["model", "messages"], properties: { model: { type: "string" }, messages: { type: "array" }, stream: { type: "boolean" }, max_tokens: { type: "integer" }, temperature: { type: "number" } } } } } }, responses: { 200: { description: "Chat response" } } } },
+      "/v1/embeddings": { post: { summary: "Generate embeddings", tags: ["Inference"], responses: { 200: { description: "Embedding vectors" } } } },
+      "/v1/run": { post: { summary: "Submit agentic task", tags: ["Agentic"], requestBody: { required: true, content: { "application/json": { schema: { type: "object", required: ["task"], properties: { task: { type: "string" }, model: { type: "string" }, stream: { type: "boolean" }, profile: { type: "string" }, working_directory: { type: "string" }, isolate: { type: "boolean" } } } } } }, responses: { 202: { description: "Task accepted" } } } },
+      "/v1/runs": { get: { summary: "List all runs", tags: ["Agentic"], parameters: [{ name: "limit", in: "query", schema: { type: "integer" } }, { name: "offset", in: "query", schema: { type: "integer" } }, { name: "status", in: "query", schema: { type: "string" } }], responses: { 200: { description: "Run list with pagination" } } } },
+      "/v1/runs/{id}": { get: { summary: "Get run status", tags: ["Agentic"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { 200: { description: "Run details" }, 404: { description: "Not found" } } }, delete: { summary: "Abort run", tags: ["Agentic"], responses: { 200: { description: "Aborted" } } } },
+      "/v1/config": { get: { summary: "Get configuration", tags: ["Config"], responses: { 200: { description: "Current config" } } }, patch: { summary: "Update configuration", tags: ["Config"], responses: { 200: { description: "Updated" } } } },
+      "/v1/config/model": { get: { summary: "Current model", tags: ["Config"], responses: { 200: { description: "Model name" } } }, put: { summary: "Switch model", tags: ["Config"], responses: { 200: { description: "Switched" } } } },
+      "/v1/config/endpoint": { get: { summary: "Current endpoint", tags: ["Config"], responses: { 200: { description: "Endpoint URL" } } }, put: { summary: "Switch endpoint", tags: ["Config"], responses: { 200: { description: "Switched" } } } },
+      "/v1/usage": { get: { summary: "Token usage and rate limits", tags: ["Metering"], responses: { 200: { description: "Usage stats" } } } },
+      "/v1/audit": { get: { summary: "Query audit log", tags: ["Audit"], parameters: [{ name: "since", in: "query", schema: { type: "string" } }, { name: "user", in: "query", schema: { type: "string" } }, { name: "limit", in: "query", schema: { type: "integer" } }], responses: { 200: { description: "Audit records" } } } },
+      "/v1/commands": { get: { summary: "List slash commands", tags: ["Commands"], responses: { 200: { description: "Command list" } } } },
+      "/v1/commands/{cmd}": { post: { summary: "Execute slash command", tags: ["Commands"], responses: { 200: { description: "Command output" } } } },
+      "/v1/profiles": { get: { summary: "List tool profiles", tags: ["Profiles"], responses: { 200: { description: "Profile list" } } }, post: { summary: "Create profile", tags: ["Profiles"], responses: { 201: { description: "Created" } } } },
+      "/v1/profiles/{name}": { get: { summary: "Get profile", tags: ["Profiles"], responses: { 200: { description: "Profile details" } } }, delete: { summary: "Delete profile", tags: ["Profiles"], responses: { 200: { description: "Deleted" } } } }
+    }
+  };
+}
+function getSwaggerUI() {
+  return `<!DOCTYPE html><html><head><title>OA API Docs</title>
+<style>body{font-family:'SF Mono',monospace;background:#1a1a1e;color:#b0b0b0;margin:0;padding:20px}
+h1{color:#b2920a;font-size:1.2rem}h2{color:#b2920a;font-size:0.9rem;margin-top:20px}
+.endpoint{background:#1e1e22;border:1px solid #2a2a30;border-radius:3px;padding:10px;margin:8px 0}
+.method{font-weight:bold;padding:2px 8px;border-radius:2px;font-size:0.75rem}
+.get{color:#4ec94e}.post{color:#b2920a}.put{color:#4e94c9}.patch{color:#c9944e}.delete{color:#c94e4e}
+.path{color:#b0b0b0;margin-left:8px}.summary{color:#888;font-size:0.75rem;margin-left:12px}
+.tag{margin-top:16px;border-bottom:1px solid #2a2a30;padding-bottom:4px}
+a{color:#b2920a}
+</style></head><body>
+<h1>Open Agents API</h1>
+<p>Interactive docs. For full spec: <a href="/openapi.json">/openapi.json</a></p>
+<div id="docs"></div>
+<script>
+fetch('/openapi.json').then(r=>r.json()).then(spec=>{
+  const docs=document.getElementById('docs');
+  const tags={};
+  for(const[path,methods]of Object.entries(spec.paths)){
+    for(const[method,op]of Object.entries(methods)){
+      const tag=(op.tags||['Other'])[0];
+      if(!tags[tag])tags[tag]=[];
+      tags[tag].push({method,path,summary:op.summary||''});
+    }
+  }
+  for(const[tag,endpoints]of Object.entries(tags)){
+    docs.innerHTML+='<div class="tag"><h2>'+tag+'</h2></div>';
+    for(const ep of endpoints){
+      docs.innerHTML+='<div class="endpoint"><span class="method '+ep.method+'">'+ep.method.toUpperCase()+'</span><span class="path">'+ep.path+'</span><span class="summary">'+ep.summary+'</span></div>';
+    }
+  }
+});
+</script></body></html>`;
+}
+var init_openapi = __esm({
+  "packages/cli/dist/api/openapi.js"() {
+    "use strict";
+  }
+});
+
+// packages/cli/dist/api/auth-oidc.js
+var OIDC_ISSUER, OIDC_AUDIENCE, OIDC_SCOPE_CLAIM;
+var init_auth_oidc = __esm({
+  "packages/cli/dist/api/auth-oidc.js"() {
+    "use strict";
+    OIDC_ISSUER = process.env["OA_OIDC_ISSUER"] || "";
+    OIDC_AUDIENCE = process.env["OA_OIDC_AUDIENCE"] || "";
+    OIDC_SCOPE_CLAIM = process.env["OA_OIDC_SCOPE_CLAIM"] || "scope";
+  }
+});
+
 // packages/cli/dist/api/profiles.js
 import { existsSync as existsSync53, readFileSync as readFileSync42, writeFileSync as writeFileSync25, mkdirSync as mkdirSync27, readdirSync as readdirSync20, unlinkSync as unlinkSync12 } from "node:fs";
 import { join as join70 } from "node:path";
@@ -66912,6 +67004,20 @@ async function handleV1Run(req, res) {
     jsonResponse(res, 400, { error: "Missing required field: task" });
     return;
   }
+  if (task.length > 5e4) {
+    jsonResponse(res, 400, { error: "Task too long", message: "Max 50,000 characters", length: task.length });
+    return;
+  }
+  const sandbox = requestBody["sandbox"] || process.env["OA_DEFAULT_SANDBOX"] || "none";
+  if (sandbox === "container") {
+    try {
+      const { execSync: es } = __require("node:child_process");
+      es("docker --version", { stdio: "pipe", timeout: 5e3 });
+    } catch {
+      jsonResponse(res, 400, { error: "Container sandbox unavailable", message: "Docker not found. Install Docker or use sandbox:'none'." });
+      return;
+    }
+  }
   const id = `job-${randomBytes16(3).toString("hex")}`;
   const dir = jobsDir();
   const workingDir = requestBody["working_directory"] || req.headers["x-working-directory"];
@@ -67278,6 +67384,15 @@ async function handleRequest(req, res, ollamaUrl, verbose) {
       handleMetrics(res);
       return;
     }
+    if (pathname === "/openapi.json" && method === "GET") {
+      jsonResponse(res, 200, getOpenApiSpec());
+      return;
+    }
+    if (pathname === "/docs" && method === "GET") {
+      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+      res.end(getSwaggerUI());
+      return;
+    }
     if (pathname === "/" && method === "GET" && req.headers.accept?.includes("text/html")) {
       res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
       res.end(getWebUI());
@@ -67707,6 +67822,8 @@ var init_serve = __esm({
     init_audit_log();
     init_web_ui();
     init_logger();
+    init_openapi();
+    init_auth_oidc();
     init_oa_directory();
     init_render();
     init_profiles();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-agents-ai",
-  "version": "0.185.75",
+  "version": "0.185.76",
   "description": "AI coding agent powered by open-source models (Ollama/vLLM) — interactive TUI with agentic tool-calling loop",
   "type": "module",
   "main": "./dist/index.js",