@webless/agent 0.8.0 → 0.9.0

package/dist/index.js

@@ -1,3 +1,12 @@
+import {
+  AGENT_STRUCTURED_TOOL_INPUT_HEADER,
+  AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION,
+  AGENT_TOOL_UI_SCHEMA_VERSION,
+  formatAgentStructuredToolInput,
+  parseAgentToolResultEnvelope,
+  parseAgentToolUiSurface
+} from "./chunk-5BCSXCLT.js";
+
 // src/runtime/client.ts
 import {
   Client,
@@ -465,237 +474,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";
@@ -1402,63 +1180,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);