openpond-sdk 0.12.3 → 0.12.5

package/dist/index.js

@@ -1,13 +1,13 @@
 import {
   OpenPondLearningClient,
   OpenPondLearningError
-} from "./chunk-3LP7DNLQ.js";
+} from "./chunk-H4NTJFEE.js";
 import {
   OpenPondProfileActionsClient
-} from "./chunk-2DMYAJLS.js";
+} from "./chunk-3DWPLYFJ.js";
 import {
   OpenPondWorkflowsClient
-} from "./chunk-MEKWESBF.js";
+} from "./chunk-FBZTDDRC.js";
 import {
   DEFAULT_REFINER_REVIEW_PROFILE,
   REFINER_CORE_VERSION,
@@ -20,19 +20,19 @@ import {
   defineReviewProfile,
   refinerProfilePrompt,
   serializeReviewProfile
-} from "./chunk-O4GE6VTR.js";
+} from "./chunk-PWW5QKZS.js";
 import {
   OpenPondProjectActionsClient
-} from "./chunk-IWT6JUZD.js";
+} from "./chunk-L6EJX2VQ.js";
 import {
   OpenPondApiError,
   apiFetch,
   readApiJson
-} from "./chunk-CEZEVILU.js";
+} from "./chunk-HJ2AIAKX.js";
 import {
   HumanReviewClientError,
   OpenPondHumanReviewClient
-} from "./chunk-AG5DDL7T.js";
+} from "./chunk-DH6O4JFB.js";
 import {
   AgentImportPreviewSchema,
   AgentImportReceiptSchema,
@@ -66,7 +66,7 @@ import {
   hashCollectorEligibleBoundaries,
   summarizeCollectorCoverage,
   verifyConnectedRecordedExecution
-} from "./chunk-VY5AFE7A.js";
+} from "./chunk-BYNVSWIQ.js";
 import {
   AgentImportCommitRequestSchema,
   AgentImportFileSchema,
@@ -83,7 +83,7 @@ import {
   ConnectedStartingAssetsReceiptSchema,
   ConnectedStartingAssetsRequestSchema,
   verifyConnectedStartingAssetsReceipt
-} from "./chunk-QEIT5VXJ.js";
+} from "./chunk-F4GITADW.js";
 import {
   CandidateEvaluationControlSchema,
   CandidateEvaluationOptionSchema,
@@ -91,7 +91,7 @@ import {
   CandidateEvaluationPreparationSchema,
   CandidateEvaluationRequestSchema,
   createCandidateEvaluationClient
-} from "./chunk-BSK3VLM3.js";
+} from "./chunk-6MFFKAU6.js";
 import {
   ExperimentImprovementClient,
   HostedProfileCandidateCommandSchema,
@@ -99,7 +99,7 @@ import {
   HostedProfileCandidateReceiptSchema,
   verifyHostedProfileCandidateExport,
   verifyHostedProfileCandidateReceipt
-} from "./chunk-77N3QEIL.js";
+} from "./chunk-25L5IXHA.js";
 import {
   ExperimentEvaluationFireSchema,
   ExperimentEvaluationScheduleCommandSchema,
@@ -110,7 +110,7 @@ import {
   scheduledExperimentHash,
   sealExperimentEvaluationSchedule,
   verifyExperimentEvaluationSchedule
-} from "./chunk-G6Y6CQYV.js";
+} from "./chunk-AUNNXJQE.js";
 import {
   AdvancedRefinerEvaluationAccountingSchema,
   AdvancedRefinerEvaluationCommandSchema,
@@ -125,7 +125,7 @@ import {
   sealAdvancedRefinerEvaluationPin,
   sealAdvancedRefinerReviewReceipt,
   verifyAdvancedRefinerEvaluationPin
-} from "./chunk-YUKV7RCD.js";
+} from "./chunk-GWGDWZVN.js";
 import {
   ExperimentImprovementCommandSchema,
   ExperimentImprovementHumanOptionsSchema,
@@ -139,37 +139,42 @@ import {
   sealExperimentImprovementState,
   verifyExperimentImprovementHumanOptions,
   verifyExperimentImprovementState
-} from "./chunk-TSMGMA6R.js";
-import "./chunk-YCQVVFE5.js";
+} from "./chunk-KKL6OICH.js";
+import "./chunk-3B5KSH3V.js";
 import {
   OpenPondExperimentsClient
-} from "./chunk-K5WRVSOL.js";
-import "./chunk-UPS52OPZ.js";
-import "./chunk-HKWX624G.js";
-import "./chunk-YVUIHH6Z.js";
-import "./chunk-FY7NHCEH.js";
-import "./chunk-36WJTS5V.js";
-import "./chunk-BFR3VC25.js";
-import "./chunk-K3JCP4FO.js";
-import "./chunk-ROBAX5TN.js";
-import "./chunk-CWXM57QR.js";
+} from "./chunk-BJ5MKLWH.js";
+import "./chunk-6Y67YHVH.js";
+import "./chunk-QFBSNSUL.js";
+import "./chunk-GPQLBVQC.js";
+import "./chunk-FLNWE5ZA.js";
+import "./chunk-6KKM2XRR.js";
+import "./chunk-HOOHJCE7.js";
+import "./chunk-Z252BNAZ.js";
+import "./chunk-WQFU635Q.js";
+import "./chunk-ZFYI4P6C.js";
 import {
-  ConnectedDatasetSourceRefSchema
-} from "./chunk-FHCSDXIA.js";
-import "./chunk-2U54EOXJ.js";
-import "./chunk-TMUAKJWX.js";
-import "./chunk-MLPPSCDQ.js";
-import "./chunk-G53MA5XX.js";
-import "./chunk-DUKW3R7O.js";
-import "./chunk-KAE7AMYE.js";
-import "./chunk-CTVKI3BV.js";
-import "./chunk-T4APHDES.js";
-import "./chunk-QTJQIHDZ.js";
-import "./chunk-ZJ3H3VS7.js";
-import "./chunk-CK3ONRRC.js";
-import "./chunk-TCHAWJMB.js";
-import "./chunk-3KXDH6OB.js";
-import "./chunk-COPVBJPL.js";
+  ConnectedDatasetSourceRefSchema,
+  serializeStructuredOutput,
+  structuredOutputTools,
+  structuredToolOutput,
+  validateOutputBytes
+} from "./chunk-EJZ7HOIS.js";
+import "./chunk-TK3DXH7A.js";
+import "./chunk-XACJ63U4.js";
+import "./chunk-RE426Q7Y.js";
+import "./chunk-T3MFWGMX.js";
+import "./chunk-Q4TKI2MV.js";
+import "./chunk-H3367ISL.js";
+import "./chunk-DBKCSQVH.js";
+import "./chunk-O6FKHAWN.js";
+import "./chunk-MJELLVQP.js";
+import "./chunk-6GQ3GIAP.js";
+import "./chunk-O54KGALH.js";
+import "./chunk-CAMLCKSF.js";
+import "./chunk-CL3IOOVL.js";
+import "./chunk-H3JZ3P5T.js";
+import "./chunk-YLJ4XMA6.js";
 
 // ../cloud/dist/sandbox/client-handles.js
 function createSandboxRuntimeNamespace(client) {
@@ -1787,13 +1792,17 @@ function requireToken(value) {
     throw new Error("OpenPond API key is required");
   return trimmed;
 }
-function hostedHeaders(token, accept, requestId) {
+function hostedHeaders(token, accept, requestId, teamId) {
   const headers = new Headers();
   headers.set("Authorization", `Bearer ${requireToken(token)}`);
   headers.set("Content-Type", "application/json");
   headers.set("Accept", accept);
   headers.set("x-openpond-client", "openpond-code");
-  headers.set("x-openpond-request-id", requestId || randomUUID());
+  const operationId = requestId || randomUUID();
+  headers.set("x-openpond-request-id", operationId);
+  headers.set("x-request-id", operationId);
+  if (teamId)
+    headers.set("x-openpond-team-id", teamId);
   return headers;
 }
 async function readError(response) {
@@ -1845,7 +1854,8 @@ async function listOpChatModels(options) {
   const requestUrl = `${apiBaseUrl}/models`;
   const response = await fetch(requestUrl, {
     method: "GET",
-    headers: hostedHeaders(options.token, "application/json"),
+    redirect: "error",
+    headers: hostedHeaders(options.token, "application/json", void 0, options.teamId),
     signal: options.signal
   });
   if (!response.ok) {
@@ -1858,7 +1868,8 @@ async function getOpChatModel(options) {
   const requestUrl = `${apiBaseUrl}/models/${encodeURIComponent(options.model)}`;
   const response = await fetch(requestUrl, {
     method: "GET",
-    headers: hostedHeaders(options.token, "application/json"),
+    redirect: "error",
+    headers: hostedHeaders(options.token, "application/json", void 0, options.teamId),
     signal: options.signal
   });
   if (!response.ok) {
@@ -1871,7 +1882,8 @@ async function listOpChatProviders(options) {
   const requestUrl = `${apiBaseUrl}/providers`;
   const response = await fetch(requestUrl, {
     method: "GET",
-    headers: hostedHeaders(options.token, "application/json"),
+    redirect: "error",
+    headers: hostedHeaders(options.token, "application/json", void 0, options.teamId),
     signal: options.signal
   });
   if (!response.ok) {
@@ -1884,7 +1896,8 @@ async function getOpChatProvider(options) {
   const requestUrl = `${apiBaseUrl}/providers/${encodeURIComponent(options.provider)}`;
   const response = await fetch(requestUrl, {
     method: "GET",
-    headers: hostedHeaders(options.token, "application/json"),
+    redirect: "error",
+    headers: hostedHeaders(options.token, "application/json", void 0, options.teamId),
     signal: options.signal
   });
   if (!response.ok) {
@@ -1897,7 +1910,8 @@ async function sendHostedChatTurn(options) {
   const requestUrl = `${apiBaseUrl}/chat/completions`;
   const response = await fetch(requestUrl, {
     method: "POST",
-    headers: hostedHeaders(options.token, "application/json", options.requestId),
+    redirect: "error",
+    headers: hostedHeaders(options.token, "application/json", options.requestId, options.teamId),
     body: JSON.stringify(buildHostedChatBody(options, false)),
     signal: options.signal
   });
@@ -1906,10 +1920,11 @@ async function sendHostedChatTurn(options) {
   }
   return await response.json();
 }
-async function* parseOpenAISSE(stream, signal) {
+async function* parseOpenAISSE(stream, signal, observe) {
   const reader = stream.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
+  let sawDone = false;
   const readAbortError = () => signal?.reason instanceof Error ? signal.reason : new Error("hosted_chat_aborted");
   try {
     while (true) {
@@ -1918,22 +1933,38 @@ async function* parseOpenAISSE(stream, signal) {
       const result = await reader.read();
       if (result.done)
         break;
+      observe?.({ type: "bytes", byteLength: result.value.byteLength });
       buffer += decoder.decode(result.value, { stream: true });
       const lines = buffer.split("\n");
       buffer = lines.pop() || "";
       for (const line of lines) {
         const trimmed = line.trim();
+        if (trimmed.startsWith(":"))
+          observe?.({ type: "comment" });
         if (!trimmed.startsWith("data:"))
           continue;
         const data = trimmed.slice(5).trim();
         if (!data)
           continue;
-        if (data === "[DONE]")
+        if (data === "[DONE]") {
+          sawDone = true;
+          observe?.({ type: "done" });
           return;
-        yield JSON.parse(data);
+        }
+        const parsed = JSON.parse(data);
+        observe?.({
+          type: "data",
+          errorFrame: Boolean(parsed && typeof parsed === "object" && "error" in parsed)
+        });
+        yield parsed;
       }
     }
+    throw new Error("Hosted chat stream ended before [DONE].");
   } finally {
+    if (!sawDone) {
+      await reader.cancel().catch(() => {
+      });
+    }
     try {
       reader.releaseLock();
     } catch {
@@ -1943,16 +1974,34 @@ async function* parseOpenAISSE(stream, signal) {
 async function* streamHostedChatTurn(options) {
   const apiBaseUrl = normalizeApiBaseUrl(options.apiBaseUrl);
   const requestUrl = `${apiBaseUrl}/chat/completions`;
+  const started = performance.now();
+  const observe = (event) => {
+    try {
+      options.onStreamDiagnostic?.({ ...event, elapsedMs: Math.round(performance.now() - started) });
+    } catch {
+    }
+  };
+  observe({ type: "request" });
   const response = await fetch(requestUrl, {
     method: "POST",
-    headers: hostedHeaders(options.token, "text/event-stream", options.requestId),
+    redirect: "error",
+    headers: hostedHeaders(options.token, "text/event-stream", options.requestId, options.teamId),
     body: JSON.stringify(buildHostedChatBody(options, true)),
     signal: options.signal
   });
+  const cacheControl = response.headers.get("cache-control")?.toLowerCase().split(",").map((value) => value.trim()) ?? [];
+  observe({
+    type: "headers",
+    status: response.status,
+    eventStream: response.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase() === "text/event-stream",
+    noCache: cacheControl.includes("no-cache"),
+    noTransform: cacheControl.includes("no-transform"),
+    bufferingDisabled: response.headers.get("x-accel-buffering")?.toLowerCase() === "no"
+  });
   if (!response.ok || !response.body) {
     throw new Error(`Hosted chat stream failed: ${response.status} ${await readError(response)}`);
   }
-  for await (const raw of parseOpenAISSE(response.body, options.signal)) {
+  for await (const raw of parseOpenAISSE(response.body, options.signal, observe)) {
     const chunk = raw;
     if (chunk.error) {
       throw new Error(chunk.error.message || "Hosted chat stream error");
@@ -1981,6 +2030,9 @@ async function* streamHostedChatTurn(options) {
   }
 }
 
+// src/work.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+
 // src/work-sandbox.ts
 function workSandbox(client, custom) {
   return {
@@ -2082,6 +2134,7 @@ var OpenPondWorkClient = class {
     const prompt = input.prompt.trim();
     if (!prompt) throw new Error("Work prompt is required");
     input.signal?.throwIfAborted();
+    const submissionTools = structuredOutputTools(input.requiredOutputs ?? []);
     const emit = async (event) => input.onEvent?.(event);
     const cleanupPolicy = input.cleanup ?? "keep";
     const lifecycle = initialLifecycle(cleanupPolicy);
@@ -2106,7 +2159,7 @@ var OpenPondWorkClient = class {
           content: systemPrompt(sandbox.id, (input.inputs?.length ?? 0) > 0)
         },
         ...(input.history ?? []).map((message) => ({ ...message })),
-        { role: "user", content: prompt }
+        { role: "user", content: prompt + (input.requiredOutputs?.length ? "\nRequired outputs under outputs/: " + JSON.stringify(input.requiredOutputs) : "") }
       ];
       for (let step = 1; step <= maxSteps; step += 1) {
         input.signal?.throwIfAborted();
@@ -2116,7 +2169,7 @@ var OpenPondWorkClient = class {
           token: this.#apiKey,
           model: input.model?.trim() || this.#defaultModel,
           messages,
-          tools: WORK_TOOLS,
+          tools: [...WORK_TOOLS, ...submissionTools],
           toolChoice: "auto",
           signal: input.signal,
           metadata: {
@@ -2139,7 +2192,13 @@ var OpenPondWorkClient = class {
           await emit({ type: "assistant", text: assistantText });
         }
         if (toolCalls.length === 0) {
-          const outputs = await this.#collectOutputs(sandbox.id, outputBaseline);
+          let outputs;
+          try {
+            outputs = await this.#collectOutputs(sandbox.id, outputBaseline, input.requiredOutputs);
+          } catch (error) {
+            messages.push({ role: "user", content: "Output acceptance failed. Correct the required outputs and submit again: " + errorMessage(error) });
+            continue;
+          }
           for (const output of outputs) await emit({ type: "output", output });
           finalizationAttempted = true;
           await this.#finalizeSandbox(sandbox.id, outputs, input, lifecycle, emit);
@@ -2160,7 +2219,8 @@ var OpenPondWorkClient = class {
             toolCall,
             index,
             input.timeoutSeconds,
-            emit
+            emit,
+            input.requiredOutputs
           );
           messages.push(result);
         }
@@ -2169,7 +2229,7 @@ var OpenPondWorkClient = class {
     } catch (error) {
       if (sandbox && outputBaseline && !finalizationAttempted) {
         try {
-          const outputs = await this.#collectOutputs(sandbox.id, outputBaseline);
+          const outputs = await this.#collectOutputs(sandbox.id, outputBaseline, input.requiredOutputs);
           for (const output of outputs) await emit({ type: "output", output });
           await this.#finalizeSandbox(sandbox.id, outputs, input, lifecycle, emit);
         } catch (finalizationError) {
@@ -2241,7 +2301,16 @@ var OpenPondWorkClient = class {
       for (const output of outputs) {
         await emit({ type: "persistence", output, status: "started" });
         try {
-          const download = lazyOutputDownload(this.#sandboxes, sandboxId, output);
+          const originalDownload = lazyOutputDownload(this.#sandboxes, sandboxId, output);
+          const download = async () => {
+            const result = await originalDownload();
+            const required = input.requiredOutputs?.find((item) => normalizedOutputPath(output.path) === `${WORK_OUTPUT_DIRECTORY}/${item.path}`);
+            if (required) {
+              const validation = validateOutputBytes(required, Buffer.from(result.file.contentsBase64, "base64"));
+              if (output.validation && validation?.artifactHash !== output.validation.artifactHash) throw new Error("work_saved_output_changed");
+            }
+            return result;
+          };
           await input.persistOutput({ output, download });
           lifecycle.persistence.persistedCount += 1;
           await emit({ type: "persistence", output, status: "succeeded" });
@@ -2322,9 +2391,17 @@ var OpenPondWorkClient = class {
     });
     return outputSignatures(await this.#listOutputFiles(sandboxId));
   }
-  async #collectOutputs(sandboxId, baseline) {
+  async #collectOutputs(sandboxId, baseline, requiredOutputs) {
     const files = await this.#listOutputFiles(sandboxId);
-    return files.filter((file) => baseline.get(file.path) !== outputSignature(file)).sort((left, right) => left.path.localeCompare(right.path)).slice(0, MAX_WORK_OUTPUTS).map(workOutputFromFile);
+    const outputs = files.filter((file) => baseline.get(file.path) !== outputSignature(file)).sort((left, right) => left.path.localeCompare(right.path)).slice(0, MAX_WORK_OUTPUTS).map(workOutputFromFile);
+    for (const required of requiredOutputs ?? []) {
+      const output = outputs.find((item) => normalizedOutputPath(item.path) === `${WORK_OUTPUT_DIRECTORY}/${required.path}`);
+      if (!output) throw new Error("work_required_output_missing:" + required.path);
+      const downloaded = await this.#sandboxes.downloadFileResponse(sandboxId, output.path);
+      if (downloaded.file.truncated) throw new Error("work_output_download_truncated");
+      output.validation = validateOutputBytes(required, Buffer.from(downloaded.file.contentsBase64, "base64"));
+    }
+    return outputs;
   }
   async #listOutputFiles(sandboxId) {
     const listed = await this.#sandboxes.listFiles(sandboxId, {
@@ -2366,9 +2443,24 @@ var OpenPondWorkClient = class {
     }
     throw new Error(`Sandbox ${sandboxId} did not become ready before timeout`);
   }
-  async #executeTool(sandboxId, toolCall, index, timeoutSeconds, emit) {
+  async #executeTool(sandboxId, toolCall, index, timeoutSeconds, emit, requiredOutputs) {
     const toolCallId = toolCall.id || `work_tool_${index}`;
     const name = toolCall.function?.name;
+    const structured = structuredToolOutput(requiredOutputs ?? [], name ?? "");
+    if (structured) {
+      try {
+        const bytes = serializeStructuredOutput(structured, JSON.parse(toolCall.function?.arguments || "{}"));
+        const path = `${WORK_OUTPUT_DIRECTORY}/${structured.path}`;
+        const temporary = `${WORK_OUTPUT_DIRECTORY}/.openpond-${randomUUID2()}`;
+        await this.#sandboxes.uploadFileBase64(sandboxId, temporary, Buffer.from(bytes).toString("base64"));
+        const quote = (value) => "'" + value.replaceAll("'", "'\\''") + "'";
+        const moved = await this.#sandboxes.exec(sandboxId, { command: `mkdir -p -- ${quote(path.slice(0, path.lastIndexOf("/")))} && mv -f -- ${quote(temporary)} ${quote(path)}`, timeoutSeconds: 30 });
+        if (moved.command.exitCode !== 0) throw new Error("work_output_registration_failed");
+        return toolMessage(toolCallId, { ok: true, path, validation: validateOutputBytes(structured, bytes) });
+      } catch (error) {
+        return toolMessage(toolCallId, { ok: false, error: errorMessage(error) });
+      }
+    }
     if (name !== "run_command") {
       return toolMessage(toolCallId, { error: `Unknown tool: ${name ?? "missing"}` });
     }