@openhands/agent-canvas 1.19.0 → 1.20.0

package/dist/manifests/manifest-local-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-local-validation.js","names":[],"sources":["../../src/manifests/manifest-local-validation.ts"],"sourcesContent":["/**\n * The form model, and the host's own check of what the user typed into it.\n *\n * Local validation is a convenience, not the authority: it is instant and needs\n * no round trip, so it catches empty required fields and obvious typos.\n * Deployment-specific questions (\"is a one-minute schedule allowed here?\")\n * belong to preflight, which is authoritative.\n *\n * Errors are returned as codes rather than sentences so the host can render\n * them through its own translations; only manifest-authored copy is literal.\n */\n\nimport type {\n  DeploymentCapabilities,\n  SetupActionKind,\n  SetupBlock,\n  SetupFieldOption,\n  SetupFormField,\n  SetupFormFields,\n  SetupFormValue,\n  SetupFormValues,\n} from \"./types\";\n\n/** Characters that would break out of an expression string literal. */\nconst UNSAFE_EXPRESSION_LITERAL_PATTERN = /[\"'\\\\]/;\n\nexport type SetupFieldError =\n  | { code: \"required\" }\n  | { code: \"minLength\"; length: number }\n  | { code: \"maxLength\"; length: number }\n  | { code: \"min\"; value: number }\n  | { code: \"max\"; value: number }\n  | { code: \"invalidOption\" }\n  | { code: \"unsafeExpressionLiteral\" };\n\nexport type SetupFieldErrors = Record<string, SetupFieldError>;\n\n/** Field constraints supplied by the deployment rather than by the manifest. */\nexport interface SetupFieldOverride {\n  options?: SetupFieldOption[];\n}\n\nexport function triggerKinds(setup: SetupBlock): string[] {\n  return Object.keys(setup.form.triggers ?? {});\n}\n\nexport function initialTriggerKind(setup: SetupBlock): string | null {\n  return triggerKinds(setup)[0] ?? null;\n}\n\nexport function actionKinds(setup: SetupBlock): SetupActionKind[] {\n  return Object.keys(setup.actions ?? {}) as SetupActionKind[];\n}\n\nexport function initialActionKind(setup: SetupBlock): SetupActionKind | null {\n  return actionKinds(setup)[0] ?? null;\n}\n\nexport type SetupFieldOverrides = Record<string, SetupFieldOverride>;\n\n/**\n * Every input the form declares, keyed by name, whichever half it is in.\n *\n * Trigger inputs come first so the user is asked when it runs before what it\n * runs on, and so every derived view of the form keeps that order. Admission\n * rejects a name declared in both halves, so the merge cannot lose a field.\n */\nexport function collectFields(\n  setup: SetupBlock,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFormFields {\n  const triggers = setup.form.triggers ?? {};\n  const triggerEntries = Object.entries(triggers);\n  const activeTrigger =\n    selectedTrigger && selectedTrigger in triggers\n      ? triggers[selectedTrigger as keyof typeof triggers]\n      : triggerEntries.length === 1\n        ? triggerEntries[0][1]\n        : {};\n  const actions = setup.actions ?? {};\n  const actionEntries = Object.entries(actions);\n  const activeAction =\n    selectedAction && selectedAction in actions\n      ? actions[selectedAction as SetupActionKind]?.args\n      : actionEntries.length === 1\n        ? actionEntries[0][1]?.args\n        : {};\n  return Object.assign(\n    {},\n    activeTrigger,\n    setup.form.args,\n    activeAction,\n  ) as SetupFormFields;\n}\n\n/**\n * Feed deployment values into form field constraints, so the form offers only\n * what the deployment accepts.\n *\n * A `timezone` field is the case that needs it: a manifest declares no options\n * for one, because the accepted zones belong to the deployment. The cron\n * interval floor is deliberately left to preflight — the deployment owns that\n * limit and states it in its own words, and a local approximation would\n * pre-empt the authoritative message with a worse one.\n */\nexport function resolveFieldOverrides(\n  setup: SetupBlock,\n  capabilities: DeploymentCapabilities | null,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFieldOverrides {\n  const overrides: SetupFieldOverrides = {};\n  const fields = collectFields(setup, selectedTrigger, selectedAction);\n  const timezones = capabilities?.triggers?.cron?.timezones;\n  if (timezones?.length) {\n    const options = timezones.map((zone) => ({ value: zone, label: zone }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"timezone\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  if (capabilities?.eventSources?.length) {\n    const options = capabilities.eventSources.map((source) => ({\n      value: source,\n      label: source,\n    }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"event-source\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  if (capabilities?.eventTypes?.length) {\n    const options = capabilities.eventTypes.map((type) => ({\n      value: type,\n      label: type,\n    }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"event-type\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  return overrides;\n}\n\n/** The options a field offers, after deployment constraints are applied. */\nexport function getFieldOptions(\n  name: string,\n  field: SetupFormField,\n  overrides: SetupFieldOverrides = {},\n): SetupFieldOption[] {\n  return overrides[name]?.options ?? field.options ?? [];\n}\n\n/**\n * Every value a field holds, whether it collects one or many.\n *\n * Reading both shapes as a list is what keeps validation, interpolation and\n * the payload mapping from branching on `multiple` at every use.\n */\nfunction isFileValue(value: SetupFormValue | undefined): value is File {\n  return typeof File !== \"undefined\" && value instanceof File;\n}\n\nexport function fieldValues(value: SetupFormValue | undefined): string[] {\n  if (Array.isArray(value)) return value.filter((item) => item.trim() !== \"\");\n  if (isFileValue(value)) return value.name ? [value.name] : [];\n  if (typeof value === \"string\" && value.trim() === \"\") return [];\n  if (value === undefined || value === null) return [];\n  return [String(value)];\n}\n\n/** The single value a field holds, or \"\" for a field collecting several. */\nexport function fieldText(value: SetupFormValue | undefined): string {\n  if (Array.isArray(value) || value === undefined || value === null) return \"\";\n  if (isFileValue(value)) return value.name;\n  return String(value);\n}\n\n/** Initial form state: every declared field, seeded with its declared default. */\nexport function getInitialFormValues(\n  setup: SetupBlock,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFormValues {\n  return Object.fromEntries(\n    Object.entries(collectFields(setup, selectedTrigger, selectedAction)).map(\n      ([name, field]) => [\n        name,\n        // A field collecting several values starts empty rather than holding one\n        // blank entry, so \"required\" means \"add one\" rather than \"fill this in\".\n        field.multiple ? [] : (field.default ?? \"\"),\n      ],\n    ),\n  );\n}\n\nfunction validateField(\n  name: string,\n  field: SetupFormField,\n  rawValue: SetupFormValue | undefined,\n  overrides: SetupFieldOverrides,\n): SetupFieldError | null {\n  const entered = fieldValues(rawValue);\n\n  if (entered.length === 0) {\n    return field.required ? { code: \"required\" } : null;\n  }\n\n  // Every entry of a multi-value field answers the same field, so each is held\n  // to the same rules and the first failure is the one reported.\n  const failures = entered\n    .map((item) => validateValue(name, field, item.trim(), overrides))\n    .filter((error): error is SetupFieldError => error !== null);\n  return failures[0] ?? null;\n}\n\nfunction validateValue(\n  name: string,\n  field: SetupFormField,\n  value: string,\n  overrides: SetupFieldOverrides,\n): SetupFieldError | null {\n  const { minLength, maxLength, min, max, format } = field.constraints ?? {};\n  if (minLength !== undefined && value.length < minLength) {\n    return { code: \"minLength\", length: minLength };\n  }\n  if (maxLength !== undefined && value.length > maxLength) {\n    return { code: \"maxLength\", length: maxLength };\n  }\n  if (field.type === \"number\") {\n    const numeric = Number(value);\n    if (Number.isNaN(numeric)) return { code: \"invalidOption\" };\n    if (min !== undefined && numeric < min) return { code: \"min\", value: min };\n    if (max !== undefined && numeric > max) return { code: \"max\", value: max };\n  }\n  if (\n    format === \"safeExpressionLiteral\" &&\n    UNSAFE_EXPRESSION_LITERAL_PATTERN.test(value)\n  ) {\n    return { code: \"unsafeExpressionLiteral\" };\n  }\n\n  // Any field offering a closed set of values, whether the manifest declared it\n  // or the deployment supplied it, must be answered from that set.\n  const options = getFieldOptions(name, field, overrides);\n  if (options.length > 0 && !options.some((option) => option.value === value)) {\n    return { code: \"invalidOption\" };\n  }\n\n  return null;\n}\n\n/** Check every declared field. Returns only the fields that failed. */\nexport function validateFormValues(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  overrides: SetupFieldOverrides = {},\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFieldErrors {\n  return Object.entries(\n    collectFields(setup, selectedTrigger, selectedAction),\n  ).reduce<SetupFieldErrors>((errors, [name, field]) => {\n    const error = validateField(name, field, values[name], overrides);\n    return error ? { ...errors, [name]: error } : errors;\n  }, {});\n}\n"],"mappings":";AAkDA,SAAgB,EAAY,GAAsC;CAChE,OAAO,OAAO,KAAK,EAAM,WAAW,CAAC,CAAC;AACxC"}
+{"version":3,"file":"manifest-local-validation.js","names":[],"sources":["../../src/manifests/manifest-local-validation.ts"],"sourcesContent":["/**\n * The form model, and the host's own check of what the user typed into it.\n *\n * Local validation is a convenience, not the authority: it is instant and needs\n * no round trip, so it catches empty required fields and obvious typos.\n * Deployment-specific questions (\"is a one-minute schedule allowed here?\")\n * belong to preflight, which is authoritative.\n *\n * Errors are returned as codes rather than sentences so the host can render\n * them through its own translations; only manifest-authored copy is literal.\n */\n\nimport type {\n  DeploymentCapabilities,\n  SetupActionKind,\n  SetupBlock,\n  SetupFieldOption,\n  SetupFormField,\n  SetupFormFields,\n  SetupFormValue,\n  SetupFormValues,\n} from \"./types\";\n\n/** Characters that would break out of an expression string literal. */\nconst UNSAFE_EXPRESSION_LITERAL_PATTERN = /[\"'\\\\]/;\n\nexport type SetupFieldError =\n  | { code: \"required\" }\n  | { code: \"minLength\"; length: number }\n  | { code: \"maxLength\"; length: number }\n  | { code: \"min\"; value: number }\n  | { code: \"max\"; value: number }\n  | { code: \"invalidOption\" }\n  | { code: \"unsafeExpressionLiteral\" };\n\nexport type SetupFieldErrors = Record<string, SetupFieldError>;\n\n/** Field constraints supplied by the deployment rather than by the manifest. */\nexport interface SetupFieldOverride {\n  options?: SetupFieldOption[];\n}\n\nexport function triggerKinds(setup: SetupBlock): string[] {\n  return Object.keys(setup.form.triggers ?? {});\n}\n\nexport function initialTriggerKind(setup: SetupBlock): string | null {\n  return triggerKinds(setup)[0] ?? null;\n}\n\nexport function actionKinds(setup: SetupBlock): SetupActionKind[] {\n  return Object.keys(setup.actions ?? {}) as SetupActionKind[];\n}\n\nexport function initialActionKind(setup: SetupBlock): SetupActionKind | null {\n  return actionKinds(setup)[0] ?? null;\n}\n\nexport type SetupFieldOverrides = Record<string, SetupFieldOverride>;\n\n/**\n * Every input the form declares, keyed by name, whichever half it is in.\n *\n * Trigger inputs come first so the user is asked when it runs before what it\n * runs on, and so every derived view of the form keeps that order. Admission\n * rejects a name declared in both halves, so the merge cannot lose a field.\n */\nexport function collectFields(\n  setup: SetupBlock,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFormFields {\n  const triggers = setup.form.triggers ?? {};\n  const triggerEntries = Object.entries(triggers);\n  const activeTrigger =\n    selectedTrigger && selectedTrigger in triggers\n      ? triggers[selectedTrigger as keyof typeof triggers]\n      : triggerEntries.length === 1\n        ? triggerEntries[0][1]\n        : {};\n  const actions = setup.actions ?? {};\n  const actionEntries = Object.entries(actions);\n  const activeAction =\n    selectedAction && selectedAction in actions\n      ? actions[selectedAction as SetupActionKind]?.args\n      : actionEntries.length === 1\n        ? actionEntries[0][1]?.args\n        : {};\n  return Object.assign(\n    {},\n    activeTrigger,\n    setup.form.args,\n    activeAction,\n  ) as SetupFormFields;\n}\n\n/**\n * Feed deployment values into form field constraints, so the form offers only\n * what the deployment accepts.\n *\n * A `timezone` field is the case that needs it: a manifest declares no options\n * for one, because the accepted zones belong to the deployment. The cron\n * interval floor is deliberately left to preflight — the deployment owns that\n * limit and states it in its own words, and a local approximation would\n * pre-empt the authoritative message with a worse one.\n */\nexport function resolveFieldOverrides(\n  setup: SetupBlock,\n  capabilities: DeploymentCapabilities | null,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFieldOverrides {\n  const overrides: SetupFieldOverrides = {};\n  const fields = collectFields(setup, selectedTrigger, selectedAction);\n  const timezones = capabilities?.triggers?.cron?.timezones;\n  if (timezones?.length) {\n    const options = timezones.map((zone) => ({ value: zone, label: zone }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"timezone\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  if (capabilities?.eventSources?.length) {\n    const options = capabilities.eventSources.map((source) => ({\n      value: source,\n      label: source,\n    }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"event-source\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  if (capabilities?.eventTypes?.length) {\n    const options = capabilities.eventTypes.map((type) => ({\n      value: type,\n      label: type,\n    }));\n    Object.entries(fields)\n      .filter(([, field]) => field.type === \"event-type\")\n      .forEach(([name]) => {\n        overrides[name] = { options };\n      });\n  }\n\n  return overrides;\n}\n\n/** The options a field offers, after deployment constraints are applied. */\nexport function getFieldOptions(\n  name: string,\n  field: SetupFormField,\n  overrides: SetupFieldOverrides = {},\n): SetupFieldOption[] {\n  return overrides[name]?.options ?? field.options ?? [];\n}\n\n/**\n * Every value a field holds, whether it collects one or many.\n *\n * Reading both shapes as a list is what keeps validation, interpolation and\n * the payload mapping from branching on `multiple` at every use.\n */\nfunction isFileValue(value: SetupFormValue | undefined): value is File {\n  return typeof File !== \"undefined\" && value instanceof File;\n}\n\nexport function fieldValues(value: SetupFormValue | undefined): string[] {\n  if (Array.isArray(value)) return value.filter((item) => item.trim() !== \"\");\n  if (isFileValue(value)) return value.name ? [value.name] : [];\n  if (typeof value === \"string\" && value.trim() === \"\") return [];\n  if (value === undefined || value === null) return [];\n  return [String(value)];\n}\n\n/** The single value a field holds, or \"\" for a field collecting several. */\nexport function fieldText(value: SetupFormValue | undefined): string {\n  if (Array.isArray(value) || value === undefined || value === null) return \"\";\n  if (isFileValue(value)) return value.name;\n  return String(value);\n}\n\n/** Initial form state: every declared field, seeded with its declared default. */\nexport function getInitialFormValues(\n  setup: SetupBlock,\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFormValues {\n  return Object.fromEntries(\n    Object.entries(collectFields(setup, selectedTrigger, selectedAction)).map(\n      ([name, field]) => [\n        name,\n        // A field collecting several values starts empty rather than holding one\n        // blank entry, so \"required\" means \"add one\" rather than \"fill this in\".\n        field.multiple ? [] : (field.default ?? \"\"),\n      ],\n    ),\n  );\n}\n\nfunction validateField(\n  name: string,\n  field: SetupFormField,\n  rawValue: SetupFormValue | undefined,\n  overrides: SetupFieldOverrides,\n): SetupFieldError | null {\n  const entered = fieldValues(rawValue);\n\n  if (entered.length === 0) {\n    return field.required ? { code: \"required\" } : null;\n  }\n\n  // Every entry of a multi-value field answers the same field, so each is held\n  // to the same rules and the first failure is the one reported.\n  const failures = entered\n    .map((item) => validateValue(name, field, item.trim(), overrides))\n    .filter((error): error is SetupFieldError => error !== null);\n  return failures[0] ?? null;\n}\n\nfunction validateValue(\n  name: string,\n  field: SetupFormField,\n  value: string,\n  overrides: SetupFieldOverrides,\n): SetupFieldError | null {\n  const { minLength, maxLength, min, max, format } = field.constraints ?? {};\n  if (minLength !== undefined && value.length < minLength) {\n    return { code: \"minLength\", length: minLength };\n  }\n  if (maxLength !== undefined && value.length > maxLength) {\n    return { code: \"maxLength\", length: maxLength };\n  }\n  if (field.type === \"number\") {\n    const numeric = Number(value);\n    if (Number.isNaN(numeric)) return { code: \"invalidOption\" };\n    if (min !== undefined && numeric < min) return { code: \"min\", value: min };\n    if (max !== undefined && numeric > max) return { code: \"max\", value: max };\n  }\n  if (\n    format === \"safeExpressionLiteral\" &&\n    UNSAFE_EXPRESSION_LITERAL_PATTERN.test(value)\n  ) {\n    return { code: \"unsafeExpressionLiteral\" };\n  }\n\n  // Any field offering a closed set of values, whether the manifest declared it\n  // or the deployment supplied it, must be answered from that set.\n  const options = getFieldOptions(name, field, overrides);\n  if (options.length > 0 && !options.some((option) => option.value === value)) {\n    return { code: \"invalidOption\" };\n  }\n\n  return null;\n}\n\n/** Check every declared field. Returns only the fields that failed. */\nexport function validateFormValues(\n  setup: SetupBlock,\n  values: SetupFormValues,\n  overrides: SetupFieldOverrides = {},\n  selectedTrigger?: string | null,\n  selectedAction?: string | null,\n): SetupFieldErrors {\n  return Object.entries(\n    collectFields(setup, selectedTrigger, selectedAction),\n  ).reduce<SetupFieldErrors>((errors, [name, field]) => {\n    if (values.agent_profile_id && field.type === \"llm-profile\") return errors;\n    const error = validateField(name, field, values[name], overrides);\n    return error ? { ...errors, [name]: error } : errors;\n  }, {});\n}\n"],"mappings":";AAkDA,SAAgB,EAAY,GAAsC;CAChE,OAAO,OAAO,KAAK,EAAM,WAAW,CAAC,CAAC;AACxC"}