@webless/agent 0.8.0 → 0.9.1

package/dist/index.js

@@ -1,3 +1,14 @@
+import {
+  AGENT_STRUCTURED_TOOL_INPUT_HEADER,
+  AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION,
+  AGENT_TOOL_UI_SCHEMA_VERSION,
+  completeConnectedToolWork,
+  connectedToolWork,
+  formatAgentStructuredToolInput,
+  parseAgentToolResultEnvelope,
+  parseAgentToolUiSurface
+} from "./chunk-TCO62TRN.js";
+
 // src/runtime/client.ts
 import {
   Client,
@@ -299,6 +310,18 @@ function parseChildStreamEvent(value) {
       return { childStreamPath, type: "subagent.called" };
     }
   }
+  if (value.type === "actions.requested" && isRecord2(value.data) && Array.isArray(value.data.actions)) {
+    const items = value.data.actions.flatMap((action) => {
+      if (!isRecord2(action) || action.kind !== "tool-call" || typeof action.callId !== "string" || typeof action.toolName !== "string" || !isRecord2(action.input)) return [];
+      const item = connectedToolWork({
+        callId: action.callId,
+        toolName: action.toolName,
+        input: action.input
+      });
+      return item ? [item] : [];
+    });
+    return { type: "actions.requested", items };
+  }
   if (value.type !== "action.result" || !isRecord2(value.data)) {
     return { type: "other" };
   }
@@ -320,7 +343,7 @@ function parseChildStreamEvent(value) {
     result: {
       callId: result.callId,
       toolName: result.toolName,
-      status: data.status,
+      status: result.isError === true ? "failed" : data.status,
       ...Object.hasOwn(result, "output") ? { output: result.output } : {},
       ...error ? { error } : {}
     }
@@ -421,6 +444,7 @@ var SubagentChildStreamCoordinator = class {
     this.tasks.set(childStreamPath, task);
   }
   async consume(path, signal) {
+    const workItems = /* @__PURE__ */ new Map();
     let streamIndex = 0;
     let consecutiveRetries = 0;
     let retryDelayMs = INITIAL_RETRY_DELAY_MS;
@@ -449,7 +473,18 @@ var SubagentChildStreamCoordinator = class {
             this.beginPath(event.childStreamPath);
             continue;
           }
+          if (event.type === "actions.requested") {
+            for (const item2 of event.items) {
+              workItems.set(item2.id, item2);
+              this.handlers.onWork?.(item2);
+            }
+            continue;
+          }
           if (event.type !== "action.result") continue;
+          const item = workItems.get(event.result.callId);
+          if (item) {
+            this.handlers.onWork?.(completeConnectedToolWork(item, event.result));
+          }
           this.handlers.onToolResult?.(event.result);
           if (event.hasOutput) {
             this.handlers.onActionResult?.(event.result.output);
@@ -465,237 +500,6 @@ var SubagentChildStreamCoordinator = class {
   }
 };
 
-// src/runtime/tool-ui.ts
-var AGENT_TOOL_UI_SCHEMA_VERSION = "webless.tool-ui.v1";
-var AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION = "webless.structured-tool-input.v1";
-var AGENT_STRUCTURED_TOOL_INPUT_HEADER = "Webless-Structured-Tool-Input-JSON:";
-function formatAgentStructuredToolInput(surface, values) {
-  const payload = {
-    schemaVersion: AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION,
-    toolSlug: surface.toolSlug,
-    ...surface.operationId ? { operationId: surface.operationId } : {},
-    values
-  };
-  return `${AGENT_STRUCTURED_TOOL_INPUT_HEADER} ${JSON.stringify(payload)}`;
-}
-function isRecord3(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function isJsonValue(value, seen = /* @__PURE__ */ new Set()) {
-  if (value === null || typeof value === "string" || typeof value === "boolean") {
-    return true;
-  }
-  if (typeof value === "number") return Number.isFinite(value);
-  if (typeof value !== "object") return false;
-  if (seen.has(value)) return false;
-  seen.add(value);
-  const valid = Array.isArray(value) ? value.every((item) => isJsonValue(item, seen)) : Object.entries(value).every(
-    ([key, item]) => typeof key === "string" && isJsonValue(item, seen)
-  );
-  seen.delete(value);
-  return valid;
-}
-function boundedString(value, max) {
-  if (typeof value !== "string" || value.trim().length === 0 || value.length > max) {
-    return void 0;
-  }
-  return value.trim();
-}
-function numberValue(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
-}
-function integerValue(value) {
-  return typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 8e3 ? value : void 0;
-}
-function isFieldKind(value) {
-  return typeof value === "string" && [
-    "text",
-    "textarea",
-    "email",
-    "number",
-    "select",
-    "multi-select",
-    "checkbox",
-    "confirmation",
-    "radio",
-    "date",
-    "time",
-    "date-time",
-    "calendar",
-    "range",
-    "json"
-  ].includes(value);
-}
-function parseField(value) {
-  if (!isRecord3(value)) return null;
-  if (!hasOnlyKeys(value, [
-    "description",
-    "kind",
-    "label",
-    "max",
-    "maxItems",
-    "maxLength",
-    "min",
-    "minLength",
-    "options",
-    "path",
-    "placeholder",
-    "required",
-    "step",
-    "defaultValue"
-  ])) {
-    return null;
-  }
-  if (!isFieldKind(value.kind)) return null;
-  const path = boundedString(value.path, 160);
-  const label = boundedString(value.label, 160);
-  const description = value.description === void 0 ? void 0 : boundedString(value.description, 500);
-  const placeholder = value.placeholder === void 0 || typeof value.placeholder !== "string" ? void 0 : value.placeholder;
-  const required = value.required === void 0 || typeof value.required !== "boolean" ? void 0 : value.required;
-  const min = value.min === void 0 ? void 0 : numberValue(value.min);
-  const max = value.max === void 0 ? void 0 : numberValue(value.max);
-  const maxItems = value.maxItems === void 0 ? void 0 : integerValue(value.maxItems);
-  const step = value.step === void 0 ? void 0 : numberValue(value.step);
-  const minLength = value.minLength === void 0 ? void 0 : integerValue(value.minLength);
-  const maxLength = value.maxLength === void 0 ? void 0 : integerValue(value.maxLength);
-  const defaultValue = value.defaultValue === void 0 || !isJsonValue(value.defaultValue) ? void 0 : value.defaultValue;
-  if (!path || !/^[A-Za-z0-9_.[\]-]+$/u.test(path) || !label) {
-    return null;
-  }
-  if (value.description !== void 0 && !description) return null;
-  if (value.placeholder !== void 0 && placeholder === void 0) return null;
-  if (value.required !== void 0 && required === void 0) return null;
-  if (value.min !== void 0 && min === void 0) return null;
-  if (value.max !== void 0 && max === void 0) return null;
-  if (value.maxItems !== void 0 && (maxItems === void 0 || maxItems < 1 || maxItems > 100))
-    return null;
-  if (value.step !== void 0 && step === void 0) return null;
-  if (value.minLength !== void 0 && minLength === void 0) return null;
-  if (value.maxLength !== void 0 && maxLength === void 0) return null;
-  if (value.defaultValue !== void 0 && defaultValue === void 0)
-    return null;
-  if (value.options !== void 0) {
-    if (!Array.isArray(value.options) || value.options.length > 100)
-      return null;
-    for (const option of value.options) {
-      if (!isRecord3(option) || !boundedString(option.label, 160) || !isJsonValue(option.value)) {
-        return null;
-      }
-    }
-  }
-  return {
-    kind: value.kind,
-    path,
-    label,
-    ...description ? { description } : {},
-    ...placeholder !== void 0 ? { placeholder } : {},
-    ...required !== void 0 ? { required } : {},
-    ...defaultValue !== void 0 ? { defaultValue } : {},
-    ...value.options !== void 0 ? { options: value.options } : {},
-    ...min !== void 0 ? { min } : {},
-    ...max !== void 0 ? { max } : {},
-    ...maxItems !== void 0 ? { maxItems } : {},
-    ...step !== void 0 ? { step } : {},
-    ...minLength !== void 0 ? { minLength } : {},
-    ...maxLength !== void 0 ? { maxLength } : {}
-  };
-}
-function parseStep(value) {
-  if (!isRecord3(value)) return null;
-  if (!hasOnlyKeys(value, ["description", "fieldPaths", "id", "label"])) {
-    return null;
-  }
-  const id = boundedString(value.id, 80);
-  const label = boundedString(value.label, 160);
-  const description = value.description === void 0 ? void 0 : boundedString(value.description, 500);
-  if (!id || !/^[A-Za-z0-9][A-Za-z0-9_-]*$/u.test(id) || !label || value.description !== void 0 && !description || !Array.isArray(value.fieldPaths) || value.fieldPaths.length < 1 || value.fieldPaths.length > 32 || value.fieldPaths.some(
-    (path) => typeof path !== "string" || !/^[A-Za-z0-9_.[\]-]+$/u.test(path) || path.length > 160
-  )) {
-    return null;
-  }
-  return {
-    id,
-    label,
-    fieldPaths: value.fieldPaths,
-    ...description ? { description } : {}
-  };
-}
-function parseAction(value) {
-  if (!isRecord3(value)) return null;
-  if (!hasOnlyKeys(value, ["id", "label"])) return null;
-  const label = boundedString(value.label, 80);
-  if (value.id !== "submit" && value.id !== "back" && value.id !== "next" && value.id !== "reset" || !label) {
-    return null;
-  }
-  return {
-    id: value.id,
-    label
-  };
-}
-function parseAgentToolUiSurface(value) {
-  if (!isRecord3(value) || value.schemaVersion !== AGENT_TOOL_UI_SCHEMA_VERSION)
-    return null;
-  if (!hasOnlyKeys(value, [
-    "actions",
-    "description",
-    "fields",
-    "id",
-    "operationId",
-    "requestId",
-    "schemaVersion",
-    "steps",
-    "submitLabel",
-    "title",
-    "toolSlug",
-    "values"
-  ])) {
-    return null;
-  }
-  const id = boundedString(value.id, 200);
-  const title = boundedString(value.title, 200);
-  const toolSlug = boundedString(value.toolSlug, 200);
-  const description = value.description === void 0 ? void 0 : boundedString(value.description, 800);
-  const operationId = value.operationId === void 0 ? void 0 : boundedString(value.operationId, 200);
-  const requestId = value.requestId === void 0 ? void 0 : boundedString(value.requestId, 200);
-  const submitLabel = value.submitLabel === void 0 ? void 0 : boundedString(value.submitLabel, 80);
-  if (!id || !title || !toolSlug || !Array.isArray(value.fields) || value.fields.length < 1 || value.fields.length > 32) {
-    return null;
-  }
-  const fields = value.fields.map(parseField);
-  if (fields.some((field) => field === null)) return null;
-  const steps = value.steps === void 0 ? void 0 : Array.isArray(value.steps) && value.steps.length <= 8 ? value.steps.map(parseStep) : null;
-  if (steps?.some((step) => step === null)) return null;
-  const actions = value.actions === void 0 ? void 0 : Array.isArray(value.actions) && value.actions.length <= 8 ? value.actions.map(parseAction) : null;
-  if (actions?.some((action) => action === null)) return null;
-  if (value.description !== void 0 && !description) return null;
-  if (value.operationId !== void 0 && !operationId) return null;
-  if (value.requestId !== void 0 && !requestId) return null;
-  if (value.submitLabel !== void 0 && !submitLabel) return null;
-  const values = value.values !== void 0 && isRecord3(value.values) ? value.values : void 0;
-  if (value.values !== void 0) {
-    if (!values || !Object.values(values).every((item) => isJsonValue(item)))
-      return null;
-  }
-  return {
-    schemaVersion: AGENT_TOOL_UI_SCHEMA_VERSION,
-    id,
-    title,
-    toolSlug,
-    fields,
-    ...actions ? { actions } : {},
-    ...description ? { description } : {},
-    ...operationId ? { operationId } : {},
-    ...requestId ? { requestId } : {},
-    ...submitLabel ? { submitLabel } : {},
-    ...steps ? { steps } : {},
-    ...values ? { values } : {}
-  };
-}
-function hasOnlyKeys(value, allowed) {
-  const allowedKeys = new Set(allowed);
-  return Object.keys(value).every((key) => allowedKeys.has(key));
-}
-
 // src/runtime/client.ts
 function isTurnBoundary(event) {
   return event.type === "session.waiting" || event.type === "session.completed" || event.type === "session.failed";
@@ -728,7 +532,7 @@ function emitActionResult(event, handlers) {
     handlers.onToolResult?.({
       callId: result.callId,
       toolName: result.toolName,
-      status: event.data.status,
+      status: result.isError ? "failed" : event.data.status,
       output: result.output,
       ...event.data.error ? { error: event.data.error } : {}
     });
@@ -854,9 +658,13 @@ function requestedWorkItem(action) {
       state: "active"
     };
   }
-  return null;
+  return action.kind === "tool-call" ? connectedToolWork(action) : null;
 }
 function applyWorkEvent(event, handlers, workItems) {
+  if (event.type === "subagent.event") {
+    applyWorkEvent(event.data.event, handlers, workItems);
+    return;
+  }
   if (event.type === "step.started" && workItems.size === 0) {
     emitWorkItem(
       {
@@ -915,6 +723,15 @@ function applyWorkEvent(event, handlers, workItems) {
   const { result, status } = event.data;
   const current = workItems.get(result.callId);
   if (!current) return;
+  if (current.kind === "tool" && result.kind === "tool-result") {
+    emitWorkItem(completeConnectedToolWork(current, {
+      callId: result.callId,
+      toolName: result.toolName,
+      status: result.isError ? "failed" : status,
+      output: result.output
+    }), handlers, workItems);
+    return;
+  }
   const failed = status !== "completed" || result.isError === true;
   emitWorkItem(
     {
@@ -1402,63 +1219,6 @@ function formatAgentError(error) {
   return TRANSIENT_AGENT_ERROR_MESSAGE;
 }
 
-// src/runtime/tool-result-envelope.ts
-var ENVELOPE_KEYS = /* @__PURE__ */ new Set([
-  "schemaVersion",
-  "output",
-  "presentationKinds",
-  "ui"
-]);
-function isRecord4(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function isJsonValue2(value, seen = /* @__PURE__ */ new Set()) {
-  if (value === null || typeof value === "string" || typeof value === "boolean") {
-    return true;
-  }
-  if (typeof value === "number") return Number.isFinite(value);
-  if (typeof value !== "object") return false;
-  if (seen.has(value)) return false;
-  seen.add(value);
-  const valid = Array.isArray(value) ? value.every((item) => isJsonValue2(item, seen)) : Object.entries(value).every(
-    ([key, item]) => typeof key === "string" && isJsonValue2(item, seen)
-  );
-  seen.delete(value);
-  return valid;
-}
-function decodeEnvelope(value) {
-  if (typeof value !== "string") return value;
-  try {
-    return JSON.parse(value);
-  } catch {
-    return null;
-  }
-}
-function parseAgentToolResultEnvelope(value) {
-  const decoded = decodeEnvelope(value);
-  if (!isRecord4(decoded)) return null;
-  const keys = Object.keys(decoded);
-  if (keys.some((key) => !ENVELOPE_KEYS.has(key)) || decoded.schemaVersion !== "webless.tool-result.v1" || !isJsonValue2(decoded.output) || !Array.isArray(decoded.presentationKinds) || decoded.presentationKinds.length < 1 || decoded.presentationKinds.length > 16) {
-    return null;
-  }
-  const presentationKinds = decoded.presentationKinds.flatMap((kind) => {
-    if (typeof kind !== "string") return [];
-    const normalized = kind.trim();
-    return normalized && normalized.length <= 128 ? [normalized] : [];
-  });
-  if (presentationKinds.length !== decoded.presentationKinds.length) {
-    return null;
-  }
-  const ui = decoded.ui === void 0 ? void 0 : parseAgentToolUiSurface(decoded.ui);
-  if (decoded.ui !== void 0 && !ui) return null;
-  return {
-    schemaVersion: "webless.tool-result.v1",
-    output: decoded.output,
-    presentationKinds,
-    ...ui ? { ui } : {}
-  };
-}
-
 // src/runtime/health.ts
 async function pingAgentHealth(runtimeOrigin, fetchImpl = fetch) {
   const healthUrl = agentHealthUrl(runtimeOrigin);