@arbidocs/blocks 0.4.141 → 0.4.143

package/dist/chunk-76L6LOP3.cjs

@@ -0,0 +1,308 @@
+"use client";
+'use strict';
+
+var chunk32HW2Q33_cjs = require('./chunk-32HW2Q33.cjs');
+
+// src/agents/workflows/types.ts
+var EMPTY_WORKFLOW_SCOPE = { folders: [], labels: [] };
+
+// src/agents/workflows/workflow.ts
+var isWorkflowScope = (value) => typeof value === "object" && value !== null && Array.isArray(value.folders) && Array.isArray(value.labels);
+var isEmptyWorkflowScope = (scope) => scope.folders.length === 0 && scope.labels.length === 0 && !scope.documents?.length;
+var isFileField = (field) => field.type === "scope" || field.type === "documents";
+function emptyValue(field) {
+  switch (field.type) {
+    case "boolean":
+      return false;
+    case "scope":
+      return { folders: [], labels: [] };
+    case "documents":
+      return { folders: [], labels: [], documents: [] };
+    default:
+      return "";
+  }
+}
+function defaultInputs(workflow) {
+  const inputs = {};
+  for (const field of workflow.inputs) {
+    const d = field.default;
+    inputs[field.name] = d === void 0 ? emptyValue(field) : isWorkflowScope(d) ? { ...d } : d;
+  }
+  return inputs;
+}
+function validateInputs(workflow, inputs) {
+  const errors = {};
+  for (const field of workflow.inputs) {
+    const value = inputs[field.name];
+    if (field.type === "number") {
+      const blank = value === "" || value === void 0;
+      if (blank) {
+        if (field.required) errors[field.name] = "required";
+        continue;
+      }
+      const n = Number(value);
+      if (Number.isNaN(n)) errors[field.name] = "number";
+      else if (field.min !== void 0 && n < field.min) errors[field.name] = "min";
+      else if (field.max !== void 0 && n > field.max) errors[field.name] = "max";
+      continue;
+    }
+    if (!field.required) continue;
+    if (field.type === "documents") {
+      if (!isWorkflowScope(value) || !value.documents?.length) errors[field.name] = "required";
+      continue;
+    }
+    if (field.type === "boolean" || field.type === "scope") continue;
+    if (typeof value !== "string" || value.trim() === "") errors[field.name] = "required";
+  }
+  return errors;
+}
+function promptFieldName(workflow) {
+  return workflow.inputs.find((f) => !f.advanced && (f.type === "text" || f.type === "longtext"))?.name;
+}
+var quoteList = (names) => {
+  const quoted = names.map((n) => `"${n}"`);
+  return quoted.length <= 1 ? quoted[0] ?? "" : `${quoted.slice(0, -1).join(", ")} and ${quoted[quoted.length - 1]}`;
+};
+function fragment(field, value, ctx) {
+  switch (field.type) {
+    case "documents": {
+      const ids = isWorkflowScope(value) ? value.documents ?? [] : [];
+      const names = ids.flatMap((id) => {
+        const title = ctx?.documentTitles?.[id];
+        return title ? [title] : [];
+      });
+      return quoteList(names);
+    }
+    case "boolean":
+      return value ? field.trueText ?? "yes" : field.falseText ?? "no";
+    case "select": {
+      const option = field.options?.find((o) => o.value === value);
+      return option ? option.text ?? option.label : String(value ?? "");
+    }
+    case "scope":
+      return "";
+    default:
+      return typeof value === "string" ? value.trim() : String(value ?? "");
+  }
+}
+function composeWorkflowPrompt(workflow, inputs, ctx) {
+  if (workflow.run.kind !== "prompt") return "";
+  const byName = new Map(workflow.inputs.map((f) => [f.name, f]));
+  const template = workflow.run.promptTemplate;
+  let out = "";
+  let last = 0;
+  const append = (text, isValue) => {
+    let t = text;
+    if (!isValue) {
+      t = t.replace(/[ \t]{2,}/g, " ");
+      if (/[ \t]$/.test(out)) t = t.replace(/^[ \t]+/, "");
+    }
+    out += t;
+  };
+  for (const m of template.matchAll(/\{\{\s*([a-z][a-z0-9_]*)\s*\}\}/gi)) {
+    append(template.slice(last, m.index), false);
+    const field = byName.get(m[1]);
+    append(field ? fragment(field, inputs[m[1]], ctx) : "", true);
+    last = m.index + m[0].length;
+  }
+  append(template.slice(last), false);
+  return out.trim();
+}
+function buildLaunch(workflow, inputs, agentId) {
+  const scopeField = workflow.inputs.find(isFileField);
+  const raw = scopeField ? inputs[scopeField.name] : void 0;
+  const scope = isWorkflowScope(raw) ? raw : { ...EMPTY_WORKFLOW_SCOPE };
+  return { workflow, inputs, scope, agentId: agentId || workflow.defaultAgentId || void 0 };
+}
+function workflowAccepts(workflow) {
+  const kinds = /* @__PURE__ */ new Set();
+  for (const field of workflow.inputs) if (field.context) kinds.add(field.context);
+  return [...kinds];
+}
+function workflowsAccepting(workflows, supplied) {
+  return workflows.filter((w) => workflowAccepts(w).some((k) => supplied.includes(k)));
+}
+function workflowsForHost(workflows, host) {
+  return workflows.filter((w) => !w.host || w.host === host);
+}
+function inputsFromContext(workflow, context) {
+  const inputs = {};
+  for (const field of workflow.inputs) {
+    if (!field.context) continue;
+    if (field.context === "selection") {
+      if (context.selection) inputs[field.name] = context.selection;
+      continue;
+    }
+    const ids = field.context === "image" ? context.image ? [context.image] : [] : context.documents;
+    if (ids?.length && isFileField(field)) {
+      inputs[field.name] = { folders: [], labels: [], documents: ids.slice(0, field.max ?? 1) };
+    }
+  }
+  return inputs;
+}
+var SKILL_PROMPT_LABEL = "What should it work on?";
+var SKILL_PROMPT_FALLBACK_PLACEHOLDER = "Describe what you want";
+var plainHint = (hint) => hint.replace(/^[<[]\s*|\s*[>\]]$/g, "").trim();
+function skillToWorkflow(skill) {
+  const hint = plainHint((skill.arg_hint ?? "").trim());
+  const inputs = [
+    {
+      name: "args",
+      type: "longtext",
+      label: SKILL_PROMPT_LABEL,
+      placeholder: hint || SKILL_PROMPT_FALLBACK_PLACEHOLDER,
+      required: true
+    }
+  ];
+  return {
+    id: skill.slug,
+    skill: skill.slug,
+    title: skill.name || skill.slug,
+    description: skill.description ?? "",
+    inputs,
+    run: { kind: "prompt", promptTemplate: `/${skill.slug} {{args}}` },
+    landing: "chat",
+    schedulable: true
+  };
+}
+function skillTitle(name) {
+  if (!/^[a-z0-9]+(?:[-_][a-z0-9]+)*$/.test(name)) return name;
+  const words = name.replace(/[-_]+/g, " ");
+  return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function mergeSkillWorkflows(host, listings) {
+  const hostIds = new Set(host.map((w) => w.id));
+  const skills = listings.filter((s) => !(s.visibility === "builtin" && hostIds.has(s.slug))).map((s) => ({
+    ...skillToWorkflow({
+      name: skillTitle(s.name || s.slug),
+      slug: s.slug,
+      description: s.description ?? void 0,
+      arg_hint: s.arg_hint ?? void 0
+    }),
+    icon: "skill"
+  })).sort((a, b) => a.id.localeCompare(b.id));
+  const shadowed = new Set(skills.map((w) => w.id));
+  return { host: host.filter((w) => !shadowed.has(w.id)), skills };
+}
+var FIELD_TYPES = [
+  "text",
+  "longtext",
+  "boolean",
+  "select",
+  "number",
+  "date",
+  "scope",
+  "documents"
+];
+var str = (v) => typeof v === "string" ? v : void 0;
+var num = (v) => typeof v === "number" ? v : void 0;
+var bool = (v) => typeof v === "boolean" ? v : void 0;
+function fieldFromFrontmatter(raw) {
+  if (typeof raw !== "object" || raw === null) return null;
+  const r = raw;
+  const name = str(r.name);
+  const type = FIELD_TYPES.find((t) => t === r.type);
+  if (!name || !/^[a-z][a-z0-9_]*$/.test(name) || !type) return null;
+  const options = Array.isArray(r.options) ? r.options.flatMap((o) => {
+    const ro = o;
+    const value = str(ro?.value);
+    const label = str(ro?.label);
+    return value && label ? [
+      {
+        value,
+        label,
+        description: str(ro.description),
+        text: str(ro.text),
+        icon: str(ro.icon),
+        tone: chunk32HW2Q33_cjs.isTone(ro.tone) ? ro.tone : void 0
+      }
+    ] : [];
+  }) : void 0;
+  return {
+    name,
+    type,
+    label: str(r.label) ?? name,
+    description: str(r.description),
+    placeholder: str(r.placeholder),
+    required: bool(r.required),
+    default: r.default,
+    options,
+    min: num(r.min),
+    max: num(r.max),
+    trueText: str(r.true_text),
+    falseText: str(r.false_text),
+    advanced: bool(r.advanced),
+    accept: r.accept === "image" ? "image" : void 0,
+    context: r.context === "documents" || r.context === "selection" || r.context === "image" ? r.context : void 0,
+    by: Array.isArray(r.by) ? r.by.filter((b) => b === "folders" || b === "labels") : void 0
+  };
+}
+function workflowFromFrontmatter(id, frontmatter, body) {
+  const inputs = Array.isArray(frontmatter.inputs) ? frontmatter.inputs.flatMap((f) => {
+    const field = fieldFromFrontmatter(f);
+    return field ? [field] : [];
+  }) : [];
+  return {
+    id,
+    title: str(frontmatter.name) ?? id,
+    description: str(frontmatter.description) ?? "",
+    icon: str(frontmatter.icon),
+    inputs,
+    run: { kind: "prompt", promptTemplate: body.trim() },
+    landing: frontmatter.landing === "files" ? "files" : "chat",
+    requiresFiles: bool(frontmatter.requires_files),
+    schedulable: bool(frontmatter.schedulable) ?? true
+  };
+}
+function fieldToFrontmatter(field) {
+  return compact({
+    name: field.name,
+    type: field.type,
+    label: field.label,
+    description: field.description,
+    placeholder: field.placeholder,
+    required: field.required,
+    default: field.default,
+    options: field.options?.map(
+      (o) => compact({
+        value: o.value,
+        label: o.label,
+        description: o.description,
+        text: o.text,
+        icon: o.icon,
+        tone: o.tone
+      })
+    ),
+    min: field.min,
+    max: field.max,
+    true_text: field.trueText,
+    false_text: field.falseText,
+    advanced: field.advanced,
+    by: field.by,
+    accept: field.accept,
+    context: field.context
+  });
+}
+var compact = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== void 0));
+
+exports.EMPTY_WORKFLOW_SCOPE = EMPTY_WORKFLOW_SCOPE;
+exports.SKILL_PROMPT_FALLBACK_PLACEHOLDER = SKILL_PROMPT_FALLBACK_PLACEHOLDER;
+exports.SKILL_PROMPT_LABEL = SKILL_PROMPT_LABEL;
+exports.buildLaunch = buildLaunch;
+exports.composeWorkflowPrompt = composeWorkflowPrompt;
+exports.defaultInputs = defaultInputs;
+exports.fieldToFrontmatter = fieldToFrontmatter;
+exports.inputsFromContext = inputsFromContext;
+exports.isEmptyWorkflowScope = isEmptyWorkflowScope;
+exports.isWorkflowScope = isWorkflowScope;
+exports.mergeSkillWorkflows = mergeSkillWorkflows;
+exports.promptFieldName = promptFieldName;
+exports.skillTitle = skillTitle;
+exports.skillToWorkflow = skillToWorkflow;
+exports.validateInputs = validateInputs;
+exports.workflowAccepts = workflowAccepts;
+exports.workflowFromFrontmatter = workflowFromFrontmatter;
+exports.workflowsAccepting = workflowsAccepting;
+exports.workflowsForHost = workflowsForHost;
+//# sourceMappingURL=chunk-76L6LOP3.cjs.map
+//# sourceMappingURL=chunk-76L6LOP3.cjs.map

package/dist/chunk-76L6LOP3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agents/workflows/types.ts","../src/agents/workflows/workflow.ts"],"names":["isTone"],"mappings":"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","file":"chunk-76L6LOP3.cjs","sourcesContent":["/**\n * The one workflow model: a skill with a declared input schema. Everything launchable (a quick\n * action, a slash skill, a task body, an agent's job) is a `WorkflowDefinition`.\n *\n * The shape maps 1:1 onto future SKILL.md frontmatter (`inputs:` etc., snake_case on disk; see\n * `workflowFromFrontmatter`), so the backend can adopt it without a UI change. Blocks hold no\n * domain wording: titles, labels and prompt text are data supplied by the host.\n */\n\nimport type { Tone } from '../../components/tones'\n\nexport type WorkflowFieldType =\n  | 'text'\n  | 'longtext'\n  | 'boolean'\n  | 'select'\n  | 'number'\n  | 'date'\n  | 'scope'\n  | 'documents'\n  /** A workspace member (`usr-…` / `agt-…`): what a step's assignee or a signer can name. */\n  | 'person'\n\n/**\n * What a launching surface can hand a workflow without asking the user: the files it is looking at\n * (`documents`), the text the user selected (`selection`), or the image on screen (`image`, a file\n * id). A field binds to one with `context`; a surface offers a workflow when it can supply one of\n * the kinds the workflow declares (`workflowAccepts`).\n */\nexport type WorkflowContextKind = 'documents' | 'selection' | 'image'\n\n/** Where the user ends up after launching. `current-chat` sends into the chat already on screen. */\nexport type WorkflowLanding = 'chat' | 'current-chat' | 'files'\n\n/** Which files a run is limited to. Empty folders and labels = every file. */\nexport interface WorkflowScope {\n  /** Folder paths; `''` is the unfiled bucket. */\n  folders: string[]\n  /** Label (tag) ids. */\n  labels: string[]\n  /** Exactly these files (ids). When present it wins over folders and labels: a `documents` field or a context launch. */\n  documents?: string[]\n}\n\nexport const EMPTY_WORKFLOW_SCOPE: WorkflowScope = { folders: [], labels: [] }\n\nexport type WorkflowInputValue = string | number | boolean | WorkflowScope\n\nexport interface WorkflowFieldOption {\n  value: string\n  label: string\n  description?: string\n  /** Prompt fragment substituted for `{{name}}` when chosen (falls back to the label). */\n  text?: string\n  /** Key into the host's icon map. */\n  icon?: string\n  /**\n   * Colours the option's choice tile (e.g. a risk rating: low `success`, medium `warning`, high\n   * `danger`), chosen or not. The label always shows, so the tone is never the only cue.\n   */\n  tone?: Tone\n}\n\nexport interface WorkflowField {\n  /** Key in `inputs`; also the `{{placeholder}}` in the prompt template. */\n  name: string\n  type: WorkflowFieldType\n  label: string\n  description?: string\n  placeholder?: string\n  required?: boolean\n  default?: WorkflowInputValue\n  /** `select` only. */\n  options?: WorkflowFieldOption[]\n  /** `number` only. */\n  min?: number\n  max?: number\n  /** `boolean`: prompt fragments substituted for `{{name}}`. */\n  trueText?: string\n  falseText?: string\n  /** Fold behind a disclosure: advanced wording the common run does not need. */\n  advanced?: boolean\n  /** `scope` only: which dimensions are offered. Default both. */\n  by?: Array<'folders' | 'labels'>\n  /** `documents` only: what kind of file is offered; `max` is how many may be picked (default 1). */\n  accept?: 'image'\n  /** Prefilled by a launching surface that supplies this kind of context (see `WorkflowContextKind`). */\n  context?: WorkflowContextKind\n}\n\nexport type WorkflowRun =\n  /** Compose a message from `promptTemplate` and send it. */\n  | { kind: 'prompt'; promptTemplate: string }\n  /** The host performs it (bound by workflow id), e.g. create a label then generate. */\n  | { kind: 'operation' }\n  /**\n   * A guided run of named steps that form a graph. A run is a work thread on the server: the\n   * thread's plan carries the steps (`toPlanSteps`), its activity log records each step's progress,\n   * and the work runner starts each agent step as a turn in the thread. A person does the form,\n   * upload and review steps (`useWorkflowThread` / `WorkflowRunner`). Not schedulable from a single\n   * form: a workflow (automation) carries the steps and its trigger (`WorkflowBuilder`).\n   */\n  | {\n      kind: 'steps'\n      /** The run thread's title, a template over the run's inputs; defaults to the workflow's. */\n      threadTitle?: string\n      /** In dependency order: a step only waits for steps listed before it (`orderSteps`). */\n      steps: WorkflowStep[]\n      completion?: WorkflowCompletion\n      /** Where each step sits on the builder's canvas, by step id. */\n      layout?: Record<string, { x: number; y: number }>\n    }\n\n/* ------------------------------- steps ------------------------------- */\n\n/**\n * When a step's signal is raised, tested against the step's outcome once it is done (a skipped or\n * failed step never signals): a form field equals a value (case-insensitive text), the agent's\n * answer contains a phrase or matches a regex, or a review is approved. Absent = whenever it is done.\n */\nexport type WorkflowSignalWhen =\n  | { field: string; equals: string | number | boolean }\n  | { contains: string }\n  | { matches: string }\n  | { approved: true }\n\n/**\n * A named signal a step raises when it is done and its condition holds. Another workflow starts on\n * it (\"When a step signals\") as its own thread linked to this one, so the if/then between\n * workflows lives in the link and each workflow stays short.\n */\nexport interface WorkflowSignal {\n  /** A slug (`[a-z0-9][a-z0-9_.-]*`), e.g. `risk-high`: what a linked workflow listens for. */\n  name: string\n  when?: WorkflowSignalWhen\n}\n\ninterface WorkflowStepBase {\n  /** Unique within the workflow (`[a-z][a-z0-9_-]*`): the thread's progress is keyed by it. */\n  id: string\n  /** The step's name: the stepper and the thread's top bar show it. */\n  title: string\n  /** One line under the step's heading. */\n  description?: string\n  /** Key into the host's icon map. */\n  icon?: string\n  /**\n   * The host commits this step before the run moves on (`commit[id]`), e.g. creates the record\n   * later steps work in. Once committed the step's inputs are locked.\n   */\n  commit?: boolean\n  /** Primary button text while on this step (until it is committed); defaults to \"Continue\". */\n  nextLabel?: string\n  /**\n   * The steps this one waits for. Absent: the step before it in the list, so a plain list is a\n   * sequence. `[]`: it starts with the run. A step waiting for several waits for them all.\n   */\n  after?: string[]\n  /** Signals the step raises when it is done and their condition holds. */\n  signals?: WorkflowSignal[]\n  /**\n   * Who the step is for (a person step, or a signature or email step): they are told when it is\n   * ready, and only they (or the run's owner) can do it. Absent: whoever is on the run.\n   */\n  assignee?: WorkflowAssignee\n  /** A person step left this many hours is announced again (once). */\n  remindAfterHours?: number\n}\n\n/**\n * Who a step is for: a named member (`usr-…` / `agt-…`), whoever started the run, the person a\n * form's `person` field names (`input`: its name), or the project's lead.\n */\nexport type WorkflowAssignee =\n  { user: string } | { runOwner: true } | { input: string } | { projectLead: true }\n\n/**\n * A document a step works on, named by where it comes from: what an earlier step produced or was\n * given (an upload's files, an agent's draft, a signed copy, an edited version), what a run input\n * names (a document pick), or one document by id (`doc-…`, optionally `@v<n>`).\n */\nexport type WorkflowDocumentRef = { step: string } | { input: string } | { id: string }\n\n/** Ask people to e-sign a document. The step waits until every signer has signed. */\nexport interface WorkflowSignAction {\n  type: 'sign'\n  document?: WorkflowDocumentRef\n  signers: WorkflowAssignee[]\n  /** Shown to the signers. */\n  message?: string\n  /** Unsigned this long after it starts, the step fails. */\n  expiresAfterHours?: number\n}\n\n/**\n * Prepare an email in native mail, never sent by itself: its person sends it, and the step is done\n * when they say so (or send it). Every text is a template over the run (`{{field}}`,\n * `{{step.answer}}`).\n */\nexport interface WorkflowEmailDraftAction {\n  type: 'email_draft'\n  to: string[]\n  cc?: string[]\n  subject: string\n  body: string\n  attachments?: WorkflowDocumentRef[]\n}\n\n/** Run review columns (labels with instructions) over documents, then open the grid. */\nexport interface WorkflowTabularReviewAction {\n  type: 'tabular_review'\n  /** Label (tag) ids: the columns. */\n  tags: string[]\n  /** Every file the run's uploads took, every document of the workspace, or these documents. */\n  documents: 'run_uploads' | 'workspace' | WorkflowDocumentRef[]\n  /** Fill cells that already have a value again. */\n  overwrite?: boolean\n}\n\nexport type WorkflowAction =\n  WorkflowSignAction | WorkflowEmailDraftAction | WorkflowTabularReviewAction\nexport type WorkflowActionType = WorkflowAction['type']\n\n/** Ask for inputs. Every step's fields share the run's one input namespace (`{{name}}`). */\nexport interface WorkflowFormStep extends WorkflowStepBase {\n  kind: 'form'\n  inputs: WorkflowField[]\n}\n\n/** Add files to the run's workspace. Skippable unless `required`. */\nexport interface WorkflowUploadStep extends WorkflowStepBase {\n  kind: 'upload'\n  required?: boolean\n  /** `accept` of the file picker, e.g. `.pdf,.docx`. */\n  accept?: string\n  /** Small muted line under the drop target. */\n  hint?: string\n}\n\n/**\n * A turn the assistant takes in the run's thread. It runs a skill or another workflow\n * (`workflow`, its inputs filled from `with`) or its own `run`. It continues the thread's main\n * line, so it sees everything before it; a `branch` step runs off the main line instead and\n * delivers only its result back to it.\n */\nexport interface WorkflowAgentStep extends WorkflowStepBase {\n  kind: 'agent'\n  /** Id of the skill or workflow this step runs; its inputs come from `with`. */\n  workflow?: string\n  /**\n   * The named workflow's inputs, each a template over the run's inputs: `{{client}}`, with\n   * `{{a || b}}` falling back to `b` when `a` is blank. A bare `{{name}}` passes the value as is.\n   */\n  with?: Record<string, string>\n  /** Used when no `workflow` is named. `operation`: the host composes the prompt (`compose`). */\n  run?: Extract<WorkflowRun, { kind: 'prompt' } | { kind: 'operation' }>\n  /** What the step shows: the answer (default) or the drafted document. */\n  output?: 'answer' | 'artifact'\n  /** Runs off the thread's main line and delivers only its result to it. */\n  branch?: boolean\n  /**\n   * Edit this Word document with tracked changes (the instruction says what to change); the\n   * edited copy is its next version, to accept or reject change by change. Main line only.\n   */\n  editDocument?: WorkflowDocumentRef\n}\n\n/** A person's review or approval: whoever completes it on the thread approves it. */\nexport interface WorkflowReviewStep extends WorkflowStepBase {\n  kind: 'review'\n  /** What to review, a template over the run's inputs. */\n  instructions?: string\n  /** What the approver fills in when approving (e.g. a rating): they join the run's inputs. */\n  fields?: WorkflowField[]\n}\n\n/**\n * A step that uses a platform feature rather than producing text: an e-signature, an email draft\n * or a tabular review. It starts by itself; a signature and an email then wait for their people.\n */\nexport interface WorkflowActionStep extends WorkflowStepBase {\n  kind: 'action'\n  action: WorkflowAction\n}\n\nexport type WorkflowStep =\n  | WorkflowFormStep\n  | WorkflowUploadStep\n  | WorkflowAgentStep\n  | WorkflowReviewStep\n  | WorkflowActionStep\n\n/** The finish screen of a stepped run. */\nexport interface WorkflowCompletion {\n  title: string\n  description?: string\n  icon?: string\n}\n\n/**\n * Where a step of a run is, as the thread records it: not reached yet (`pending`), `running`,\n * `waiting` (an action step waiting on its signers or on its email being sent), `done`,\n * `skipped`, or `failed` (it can be retried or skipped).\n */\nexport type WorkflowStepStatus = 'pending' | 'running' | 'waiting' | 'done' | 'skipped' | 'failed'\n\n/** What a waiting step waits on (ids only), as its latest event says. */\nexport interface WorkflowActionWaiting {\n  /** An agent step: the documents to finish processing before its turn starts. */\n  documents?: string[]\n  /** A signature: the document and version to sign, who signs, who has signed. */\n  doc_ext_id?: string\n  version?: number\n  signers?: string[]\n  signed?: string[]\n  expires_at?: string\n  /** An email: the draft in native mail and whose mailbox it is in. */\n  draft_id?: string\n  mailbox?: string\n  [key: string]: unknown\n}\n\n/** What a review recorded it approved: each step it waited for, as it stood then. */\nexport interface WorkflowApprovalEvidence {\n  step: string\n  status: string\n  /** That step's answer (a message in the thread). */\n  response_id?: string\n  /** The document versions it had (`doc-…@v<n>`). */\n  documents?: string[]\n  output?: Record<string, unknown>\n}\n\nexport interface WorkflowStepState {\n  status: WorkflowStepStatus\n  /** The step's answer in the thread (an agent step), or the result a branch delivered. */\n  responseId?: string | null\n  /** The answer's text, once read. */\n  text?: string\n  error?: string | null\n  /**\n   * Skipped while it stood failed (`error` keeps why it failed): what waits for it goes on\n   * without its result.\n   */\n  skippedAfterFailure?: boolean\n  /** When it started running (ISO), for the elapsed time while it runs. */\n  startedAt?: string\n  /** An action step's type, once it has started. */\n  action?: WorkflowActionType\n  /** What a `waiting` step waits on (an action step's people, an agent step's documents). */\n  waiting?: WorkflowActionWaiting\n  /** What a done action step produced (ids: the signed version, the draft, the reviewed labels). */\n  output?: Record<string, unknown>\n  /** The document versions the step produced or was given (`doc-…@v<n>`). */\n  documents?: string[]\n  /** Reopened by a send-back to this step and not touched since (`hasNote`: with a note). */\n  sentBack?: boolean\n  hasNote?: boolean\n  /** Who was told the step is ready (`usr-…` / `agt-…`), since it last changed. */\n  announcedTo?: string | null\n  /** Who finished it (completed, approved, skipped, declined). */\n  by?: string | null\n  /** When it finished (ISO). */\n  at?: string\n  /** A review: what it approved. */\n  approved?: WorkflowApprovalEvidence[]\n  /** A declined signature: who declined. */\n  declinedBy?: string\n}\n\nexport interface WorkflowDefinition {\n  /** Execute a document operation directly, without creating a chat. */\n  documentAction?: 'annotate_documents' | 'email_documents'\n\n  /** The skill slug. */\n  id: string\n  title: string\n  /** One line: the tile text and the task picker's hint. */\n  description: string\n  /** Longer explanation shown in the dialog header; defaults to `description`. */\n  details?: string\n  /** Key into the host's icon map. */\n  icon?: string\n  /** Primary button text; defaults to the dialog's generic \"Start\". */\n  startLabel?: string\n  /** Shipped with the app/deployment (pinned, not deletable, forkable into the user's own skills). */\n  builtin?: boolean\n  /** Backed by a server skill (its slug): a task runs it as a skill rather than as a prompt. */\n  skill?: string\n  inputs: WorkflowField[]\n  run: WorkflowRun\n  /** Where the user ends up after launching by default; a launch may override it. */\n  landing: WorkflowLanding\n  /** A model this run asks for (a run option the host applies, e.g. a stronger one for summaries). */\n  model?: string\n  /** Only offered by this host (e.g. `'word'`); absent = offered everywhere. */\n  host?: string\n  /** Needs workspace files to make sense: the dialog offers the host's add-files slot when none. */\n  requiresFiles?: boolean\n  /** Default agent; absent = the user's own assistant. */\n  defaultAgentId?: string\n  /** A free-form entry (\"my own instruction\", \"remind me\"), not a named skill: it does not name the dialog. */\n  generic?: boolean\n  /** Can be the body of a task (unattended). `action` workflows are not. */\n  schedulable?: boolean\n  /** Run options the form offers (all shown by default). */\n  options?: { agent?: boolean }\n}\n\n/** What `onLaunch` receives. The host performs the launch (chat, scoping, send). */\nexport interface WorkflowLaunch {\n  workflow: WorkflowDefinition\n  inputs: Record<string, WorkflowInputValue>\n  /** The first `scope` field's value, hoisted: the host scopes documents with it. */\n  scope: WorkflowScope\n  /** `undefined` = the user's own assistant, in this chat. */\n  agentId?: string\n  /** Overrides `workflow.landing` for this launch (the empty chat sends in place). */\n  landing?: WorkflowLanding\n}\n\nexport type OnWorkflowLaunch = (launch: WorkflowLaunch) => void | Promise<void>\n\nexport type WorkflowInputs = Record<string, WorkflowInputValue>\n\n/** Validation problem of one field: the dialog maps the code to a label. */\nexport type WorkflowFieldError = 'required' | 'min' | 'max' | 'number'\nexport type WorkflowErrors = Record<string, WorkflowFieldError>\n","import { isTone } from '../../components/tones'\nimport {\n  EMPTY_WORKFLOW_SCOPE,\n  type WorkflowDefinition,\n  type WorkflowErrors,\n  type WorkflowField,\n  type WorkflowFieldOption,\n  type WorkflowContextKind,\n  type WorkflowFieldType,\n  type WorkflowInputs,\n  type WorkflowInputValue,\n  type WorkflowLaunch,\n  type WorkflowScope,\n} from './types'\n\nexport const isWorkflowScope = (value: unknown): value is WorkflowScope =>\n  typeof value === 'object' &&\n  value !== null &&\n  Array.isArray((value as WorkflowScope).folders) &&\n  Array.isArray((value as WorkflowScope).labels)\n\nexport const isEmptyWorkflowScope = (scope: WorkflowScope): boolean =>\n  scope.folders.length === 0 && scope.labels.length === 0 && !scope.documents?.length\n\n/** A field that selects files: a folder/label scope or an explicit pick. */\nconst isFileField = (field: WorkflowField): boolean =>\n  field.type === 'scope' || field.type === 'documents'\n\nfunction emptyValue(field: WorkflowField): WorkflowInputValue {\n  switch (field.type) {\n    case 'boolean':\n      return false\n    case 'scope':\n      return { folders: [], labels: [] }\n    case 'documents':\n      return { folders: [], labels: [], documents: [] }\n    default:\n      return ''\n  }\n}\n\n/** The inputs a fresh form starts with: each field's default, else an empty value of its type. */\nexport function defaultInputs(workflow: WorkflowDefinition): WorkflowInputs {\n  const inputs: WorkflowInputs = {}\n  for (const field of workflow.inputs) {\n    const d = field.default\n    inputs[field.name] =\n      d === undefined\n        ? emptyValue(field)\n        : isWorkflowScope(d)\n          ? { ...d }\n          : (d as WorkflowInputValue)\n  }\n  return inputs\n}\n\n/** Required-field and range problems, keyed by field name. Empty object = launchable. */\nexport function validateInputs(\n  workflow: WorkflowDefinition,\n  inputs: WorkflowInputs\n): WorkflowErrors {\n  const errors: WorkflowErrors = {}\n  for (const field of workflow.inputs) {\n    const value = inputs[field.name]\n    if (field.type === 'number') {\n      const blank = value === '' || value === undefined\n      if (blank) {\n        if (field.required) errors[field.name] = 'required'\n        continue\n      }\n      const n = Number(value)\n      if (Number.isNaN(n)) errors[field.name] = 'number'\n      else if (field.min !== undefined && n < field.min) errors[field.name] = 'min'\n      else if (field.max !== undefined && n > field.max) errors[field.name] = 'max'\n      continue\n    }\n    if (!field.required) continue\n    if (field.type === 'documents') {\n      if (!isWorkflowScope(value) || !value.documents?.length) errors[field.name] = 'required'\n      continue\n    }\n    if (field.type === 'boolean' || field.type === 'scope') continue\n    if (typeof value !== 'string' || value.trim() === '') errors[field.name] = 'required'\n  }\n  return errors\n}\n\n/**\n * The field that holds what the user asks for: the first common (not folded away) free-text field.\n * Text typed after a slash pre-fills it; the form puts the cursor in it when it comes first.\n */\nexport function promptFieldName(workflow: WorkflowDefinition): string | undefined {\n  return workflow.inputs.find((f) => !f.advanced && (f.type === 'text' || f.type === 'longtext'))\n    ?.name\n}\n\n/** What the host knows that the inputs alone do not: file ids resolved to names for the wording. */\nexport interface WorkflowComposeContext {\n  documentTitles?: Record<string, string>\n}\n\nconst quoteList = (names: string[]): string => {\n  const quoted = names.map((n) => `\"${n}\"`)\n  return quoted.length <= 1\n    ? (quoted[0] ?? '')\n    : `${quoted.slice(0, -1).join(', ')} and ${quoted[quoted.length - 1]}`\n}\n\nfunction fragment(\n  field: WorkflowField,\n  value: WorkflowInputValue | undefined,\n  ctx: WorkflowComposeContext | undefined\n): string {\n  switch (field.type) {\n    case 'documents': {\n      // The quoted file name(s): \"the document <name>\" reads the same whichever file was picked.\n      const ids = isWorkflowScope(value) ? (value.documents ?? []) : []\n      const names = ids.flatMap((id) => {\n        const title = ctx?.documentTitles?.[id]\n        return title ? [title] : []\n      })\n      return quoteList(names)\n    }\n    case 'boolean':\n      return value ? (field.trueText ?? 'yes') : (field.falseText ?? 'no')\n    case 'select': {\n      const option = field.options?.find((o) => o.value === value)\n      return option ? (option.text ?? option.label) : String(value ?? '')\n    }\n    case 'scope':\n      // The scope decides WHICH files the run is given; naming it in the wording only churns it.\n      return ''\n    default:\n      return typeof value === 'string' ? value.trim() : String(value ?? '')\n  }\n}\n\n/**\n * The single place a prompt string is composed from (workflow, inputs): `{{name}}` placeholders in\n * the template are replaced by each field's text. Whitespace left by empty fragments is tidied.\n */\nexport function composeWorkflowPrompt(\n  workflow: WorkflowDefinition,\n  inputs: WorkflowInputs,\n  ctx?: WorkflowComposeContext\n): string {\n  if (workflow.run.kind !== 'prompt') return ''\n  const byName = new Map(workflow.inputs.map((f) => [f.name, f]))\n  const template = workflow.run.promptTemplate\n  // Whitespace left by empty fragments is tidied in the template's own text only: what the user\n  // typed or selected (tabs, runs of spaces) reaches the prompt exactly as it was.\n  let out = ''\n  let last = 0\n  const append = (text: string, isValue: boolean) => {\n    let t = text\n    if (!isValue) {\n      t = t.replace(/[ \\t]{2,}/g, ' ')\n      if (/[ \\t]$/.test(out)) t = t.replace(/^[ \\t]+/, '')\n    }\n    out += t\n  }\n  for (const m of template.matchAll(/\\{\\{\\s*([a-z][a-z0-9_]*)\\s*\\}\\}/gi)) {\n    append(template.slice(last, m.index), false)\n    const field = byName.get(m[1])\n    append(field ? fragment(field, inputs[m[1]], ctx) : '', true)\n    last = m.index + m[0].length\n  }\n  append(template.slice(last), false)\n  return out.trim()\n}\n\n/** Assemble the launch the host receives: inputs, the hoisted scope and the chosen agent. */\nexport function buildLaunch(\n  workflow: WorkflowDefinition,\n  inputs: WorkflowInputs,\n  agentId?: string\n): WorkflowLaunch {\n  const scopeField = workflow.inputs.find(isFileField)\n  const raw = scopeField ? inputs[scopeField.name] : undefined\n  const scope = isWorkflowScope(raw) ? raw : { ...EMPTY_WORKFLOW_SCOPE }\n  return { workflow, inputs, scope, agentId: agentId || workflow.defaultAgentId || undefined }\n}\n\n/* --------------------------- context launch --------------------------- */\n\n/** What a surface hands a workflow: the files in view, the selected text, the image on screen. */\nexport interface WorkflowContext {\n  documents?: string[]\n  selection?: string\n  /** A file id. */\n  image?: string\n}\n\n/** The kinds of context a workflow declares it can be started from. */\nexport function workflowAccepts(workflow: WorkflowDefinition): WorkflowContextKind[] {\n  const kinds = new Set<WorkflowContextKind>()\n  for (const field of workflow.inputs) if (field.context) kinds.add(field.context)\n  return [...kinds]\n}\n\n/** Workflows a surface can offer: those that accept at least one kind of context it supplies. */\nexport function workflowsAccepting(\n  workflows: WorkflowDefinition[],\n  supplied: WorkflowContextKind[]\n): WorkflowDefinition[] {\n  return workflows.filter((w) => workflowAccepts(w).some((k) => supplied.includes(k)))\n}\n\n/** Workflows a host offers: its own plus every one that is not tied to another host. */\nexport function workflowsForHost(\n  workflows: WorkflowDefinition[],\n  host: string\n): WorkflowDefinition[] {\n  return workflows.filter((w) => !w.host || w.host === host)\n}\n\n/**\n * The inputs a context pre-fills: each field bound to a kind the surface supplied. Fields it does\n * not supply are left to the form's defaults, so the dialog still asks for them.\n */\nexport function inputsFromContext(\n  workflow: WorkflowDefinition,\n  context: WorkflowContext\n): WorkflowInputs {\n  const inputs: WorkflowInputs = {}\n  for (const field of workflow.inputs) {\n    if (!field.context) continue\n    if (field.context === 'selection') {\n      if (context.selection) inputs[field.name] = context.selection\n      continue\n    }\n    const ids =\n      field.context === 'image' ? (context.image ? [context.image] : []) : context.documents\n    if (ids?.length && isFileField(field)) {\n      inputs[field.name] = { folders: [], labels: [], documents: ids.slice(0, field.max ?? 1) }\n    }\n  }\n  return inputs\n}\n\n/* ------------------------------ skills ------------------------------- */\n\n/** The slice of a skill listing row the model needs (`SkillSummaryResponse`). */\nexport interface SkillLike {\n  name: string\n  slug: string\n  description?: string\n  arg_hint?: string\n}\n\n/** The prompt field's label when a skill brings none of its own. */\nexport const SKILL_PROMPT_LABEL = 'What should it work on?'\nexport const SKILL_PROMPT_FALLBACK_PLACEHOLDER = 'Describe what you want'\n\n/** `<prompt>` / `[topic]` becomes `prompt` / `topic`: a hint reads as a placeholder, not syntax. */\nconst plainHint = (hint: string): string => hint.replace(/^[<[]\\s*|\\s*[>\\]]$/g, '').trim()\n\n/**\n * A skill is run WITH a prompt, so it always gets a one-field form: a required free-text field\n * (`args`) whose placeholder is the skill's `arg_hint` (brackets removed). Starting one with\n * nothing is never offered; text typed after the slash pre-fills the field.\n */\nexport function skillToWorkflow(skill: SkillLike): WorkflowDefinition {\n  const hint = plainHint((skill.arg_hint ?? '').trim())\n  const inputs: WorkflowField[] = [\n    {\n      name: 'args',\n      type: 'longtext',\n      label: SKILL_PROMPT_LABEL,\n      placeholder: hint || SKILL_PROMPT_FALLBACK_PLACEHOLDER,\n      required: true,\n    },\n  ]\n  return {\n    id: skill.slug,\n    skill: skill.slug,\n    title: skill.name || skill.slug,\n    description: skill.description ?? '',\n    inputs,\n    run: { kind: 'prompt', promptTemplate: `/${skill.slug} {{args}}` },\n    landing: 'chat',\n    schedulable: true,\n  }\n}\n\n/** A skill named like its slug (\"deep-research\") reads as a title (\"Deep research\"); a written name is kept. */\nexport function skillTitle(name: string): string {\n  if (!/^[a-z0-9]+(?:[-_][a-z0-9]+)*$/.test(name)) return name\n  const words = name.replace(/[-_]+/g, ' ')\n  return words.charAt(0).toUpperCase() + words.slice(1)\n}\n\n/** A skill as the skills list returns it (`GET /v1/assistant/skills`). */\nexport interface SkillListing extends Omit<SkillLike, 'arg_hint' | 'description'> {\n  description?: string | null\n  arg_hint?: string | null\n  /** `builtin` ships with ARBI; `mine` and `global` are documents someone uploaded. */\n  visibility?: string | null\n}\n\n/**\n * The host's own workflows together with the skills the user can run, as one list of workflows:\n * `host` (in its order) and `skills` (by slug, each a one-field form, icon `skill`). An uploaded skill with a\n * host workflow's id replaces it (your own copy is used instead of the original); a built-in skill\n * the host already offers keeps the host's richer form, so nothing is listed twice.\n */\nexport function mergeSkillWorkflows(\n  host: WorkflowDefinition[],\n  listings: SkillListing[]\n): { host: WorkflowDefinition[]; skills: WorkflowDefinition[] } {\n  const hostIds = new Set(host.map((w) => w.id))\n  const skills = listings\n    .filter((s) => !(s.visibility === 'builtin' && hostIds.has(s.slug)))\n    .map((s) => ({\n      ...skillToWorkflow({\n        name: skillTitle(s.name || s.slug),\n        slug: s.slug,\n        description: s.description ?? undefined,\n        arg_hint: s.arg_hint ?? undefined,\n      }),\n      icon: 'skill',\n    }))\n    .sort((a, b) => a.id.localeCompare(b.id))\n  const shadowed = new Set(skills.map((w) => w.id))\n  return { host: host.filter((w) => !shadowed.has(w.id)), skills }\n}\n\nconst FIELD_TYPES: WorkflowFieldType[] = [\n  'text',\n  'longtext',\n  'boolean',\n  'select',\n  'number',\n  'date',\n  'scope',\n  'documents',\n]\n\nconst str = (v: unknown): string | undefined => (typeof v === 'string' ? v : undefined)\nconst num = (v: unknown): number | undefined => (typeof v === 'number' ? v : undefined)\nconst bool = (v: unknown): boolean | undefined => (typeof v === 'boolean' ? v : undefined)\n\nfunction fieldFromFrontmatter(raw: unknown): WorkflowField | null {\n  if (typeof raw !== 'object' || raw === null) return null\n  const r = raw as Record<string, unknown>\n  const name = str(r.name)\n  const type = FIELD_TYPES.find((t) => t === r.type)\n  if (!name || !/^[a-z][a-z0-9_]*$/.test(name) || !type) return null\n  const options = Array.isArray(r.options)\n    ? r.options.flatMap((o): WorkflowFieldOption[] => {\n        const ro = o as Record<string, unknown>\n        const value = str(ro?.value)\n        const label = str(ro?.label)\n        return value && label\n          ? [\n              {\n                value,\n                label,\n                description: str(ro.description),\n                text: str(ro.text),\n                icon: str(ro.icon),\n                tone: isTone(ro.tone) ? ro.tone : undefined,\n              },\n            ]\n          : []\n      })\n    : undefined\n  return {\n    name,\n    type,\n    label: str(r.label) ?? name,\n    description: str(r.description),\n    placeholder: str(r.placeholder),\n    required: bool(r.required),\n    default: r.default as WorkflowInputValue | undefined,\n    options,\n    min: num(r.min),\n    max: num(r.max),\n    trueText: str(r.true_text),\n    falseText: str(r.false_text),\n    advanced: bool(r.advanced),\n    accept: r.accept === 'image' ? 'image' : undefined,\n    context:\n      r.context === 'documents' || r.context === 'selection' || r.context === 'image'\n        ? r.context\n        : undefined,\n    by: Array.isArray(r.by)\n      ? (r.by.filter((b) => b === 'folders' || b === 'labels') as Array<'folders' | 'labels'>)\n      : undefined,\n  }\n}\n\n/**\n * Build a workflow from parsed SKILL.md frontmatter (snake_case keys) and its body (the prompt\n * template). The inverse of what the backend will publish; seeded workflows use the same shape.\n */\nexport function workflowFromFrontmatter(\n  id: string,\n  frontmatter: Record<string, unknown>,\n  body: string\n): WorkflowDefinition {\n  const inputs = Array.isArray(frontmatter.inputs)\n    ? frontmatter.inputs.flatMap((f) => {\n        const field = fieldFromFrontmatter(f)\n        return field ? [field] : []\n      })\n    : []\n  return {\n    id,\n    title: str(frontmatter.name) ?? id,\n    description: str(frontmatter.description) ?? '',\n    icon: str(frontmatter.icon),\n    inputs,\n    run: { kind: 'prompt', promptTemplate: body.trim() },\n    landing: frontmatter.landing === 'files' ? 'files' : 'chat',\n    requiresFiles: bool(frontmatter.requires_files),\n    schedulable: bool(frontmatter.schedulable) ?? true,\n  }\n}\n\n/** snake_case keys of the on-disk form of a field (what `workflowFromFrontmatter` reads). */\nexport function fieldToFrontmatter(field: WorkflowField): Record<string, unknown> {\n  return compact({\n    name: field.name,\n    type: field.type,\n    label: field.label,\n    description: field.description,\n    placeholder: field.placeholder,\n    required: field.required,\n    default: field.default,\n    options: field.options?.map((o) =>\n      compact({\n        value: o.value,\n        label: o.label,\n        description: o.description,\n        text: o.text,\n        icon: o.icon,\n        tone: o.tone,\n      })\n    ),\n    min: field.min,\n    max: field.max,\n    true_text: field.trueText,\n    false_text: field.falseText,\n    advanced: field.advanced,\n    by: field.by,\n    accept: field.accept,\n    context: field.context,\n  })\n}\n\nconst compact = (o: Record<string, unknown>): Record<string, unknown> =>\n  Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined))\n"]}

package/dist/chunk-AHDJXIUB.cjs

@@ -0,0 +1,25 @@
+"use client";
+'use strict';
+
+var react = require('react');
+
+// src/lib/useControllableState.ts
+function useControllableState(value, defaultValue, onChange) {
+  const [inner, setInner] = react.useState(defaultValue);
+  const isControlled = value !== void 0;
+  const current = isControlled ? value : inner;
+  const onChangeRef = react.useRef(onChange);
+  onChangeRef.current = onChange;
+  const set = react.useCallback(
+    (next) => {
+      if (!isControlled) setInner(next);
+      onChangeRef.current?.(next);
+    },
+    [isControlled]
+  );
+  return [current, set];
+}
+
+exports.useControllableState = useControllableState;
+//# sourceMappingURL=chunk-AHDJXIUB.cjs.map
+//# sourceMappingURL=chunk-AHDJXIUB.cjs.map

package/dist/chunk-AHDJXIUB.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/useControllableState.ts"],"names":["useState","useRef","useCallback"],"mappings":";;;;;AAMO,SAAS,oBAAA,CACd,KAAA,EACA,YAAA,EACA,QAAA,EACwB;AACxB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAY,YAAY,CAAA;AAClD,EAAA,MAAM,eAAe,KAAA,KAAU,MAAA;AAC/B,EAAA,MAAM,OAAA,GAAU,eAAe,KAAA,GAAQ,KAAA;AACvC,EAAA,MAAM,WAAA,GAAcC,aAAO,QAAQ,CAAA;AACnC,EAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AACtB,EAAA,MAAM,GAAA,GAAMC,iBAAA;AAAA,IACV,CAAC,IAAA,KAAY;AACX,MAAA,IAAI,CAAC,YAAA,EAAc,QAAA,CAAS,IAAI,CAAA;AAChC,MAAA,WAAA,CAAY,UAAU,IAAI,CAAA;AAAA,IAC5B,CAAA;AAAA,IACA,CAAC,YAAY;AAAA,GACf;AACA,EAAA,OAAO,CAAC,SAAS,GAAG,CAAA;AACtB","file":"chunk-AHDJXIUB.cjs","sourcesContent":["import { useCallback, useRef, useState } from 'react'\n\n/**\n * State that is controlled when `value` is passed and uncontrolled (seeded by `defaultValue`)\n * otherwise. `onChange` fires in both modes.\n */\nexport function useControllableState<T>(\n  value: T | undefined,\n  defaultValue: T,\n  onChange?: (next: T) => void\n): [T, (next: T) => void] {\n  const [inner, setInner] = useState<T>(defaultValue)\n  const isControlled = value !== undefined\n  const current = isControlled ? value : inner\n  const onChangeRef = useRef(onChange)\n  onChangeRef.current = onChange\n  const set = useCallback(\n    (next: T) => {\n      if (!isControlled) setInner(next)\n      onChangeRef.current?.(next)\n    },\n    [isControlled]\n  )\n  return [current, set]\n}\n"]}

package/dist/chunk-AOSUHWIL.js

@@ -0,0 +1,98 @@
+"use client";
+import { NativeDocxEditor } from './chunk-2FL7QJKJ.js';
+import { useRef, useState, useEffect } from 'react';
+import { parseVersionRef } from '@arbidocs/react/artifacts';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+function redlineQuery(baseId, revisedId) {
+  const base = parseVersionRef(baseId);
+  const revised = parseVersionRef(revisedId);
+  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId });
+  if (base.version) query.set("base_version", String(base.version));
+  if (revised.version) query.set("revised_version", String(revised.version));
+  return query;
+}
+function NativeDocxComparison({
+  adapter,
+  baseId,
+  revisedId,
+  title,
+  onCompared
+}) {
+  const host = useRef({ adapter, onCompared });
+  host.current = { adapter, onCompared };
+  const [documentId, setDocumentId] = useState("");
+  const [error, setError] = useState("");
+  const [attempt, setAttempt] = useState(0);
+  useEffect(() => {
+    let cancelled = false;
+    setDocumentId("");
+    setError("");
+    void host.current.adapter.request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: "POST" }).then((response) => response.json()).then((result) => {
+      if (!result.document_ext_id) throw new Error("Comparison did not return a Word document.");
+      if (!cancelled) {
+        setDocumentId(result.document_ext_id);
+        void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {
+        });
+      }
+    }).catch((error2) => {
+      if (!cancelled) setError(error2 instanceof Error ? error2.message : String(error2));
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [baseId, revisedId, attempt]);
+  if (error)
+    return /* @__PURE__ */ jsxs("div", { className: "native-docx-error", role: "alert", children: [
+      /* @__PURE__ */ jsx("p", { children: error }),
+      /* @__PURE__ */ jsx("button", { onClick: () => setAttempt((value) => value + 1), children: "Retry comparison" })
+    ] });
+  if (!documentId)
+    return /* @__PURE__ */ jsx("div", { className: "native-docx-error", role: "status", children: "Comparing Word documents\u2026" });
+  return /* @__PURE__ */ jsx(
+    NativeDocxEditor,
+    {
+      adapter,
+      documentId,
+      title: `${title.replace(/\.[^.]+$/, "")} (redline).docx`
+    },
+    documentId
+  );
+}
+function StreamedWordArtifact({
+  adapter,
+  content,
+  title,
+  busy,
+  error,
+  documentId,
+  onSaved
+}) {
+  if (!busy && documentId) {
+    return /* @__PURE__ */ jsx(
+      NativeDocxEditor,
+      {
+        adapter,
+        documentId,
+        title,
+        onSaved
+      },
+      documentId
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    NativeDocxEditor,
+    {
+      adapter,
+      documentId: "stream-preview",
+      title,
+      draftContent: "",
+      stream: { content, busy, error }
+    },
+    "stream-preview"
+  );
+}
+
+export { NativeDocxComparison, StreamedWordArtifact };
+//# sourceMappingURL=chunk-AOSUHWIL.js.map
+//# sourceMappingURL=chunk-AOSUHWIL.js.map

package/dist/chunk-AOSUHWIL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docx/NativeDocxComparison.tsx","../src/docx/StreamedWordArtifact.tsx"],"names":["error","jsx"],"mappings":"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","file":"chunk-AOSUHWIL.js","sourcesContent":["import { useEffect, useRef, useState } from 'react'\nimport { parseVersionRef } from '@arbidocs/react/artifacts'\nimport { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface NativeDocxComparisonProps {\n  adapter: NativeDocxAdapter\n  baseId: string\n  revisedId: string\n  title: string\n  onCompared?: (documentId: string) => void | Promise<void>\n}\n\n/** A `doc-…@v{n}` side names an older version: the endpoint takes its document and version apart. */\nfunction redlineQuery(baseId: string, revisedId: string): URLSearchParams {\n  const base = parseVersionRef(baseId)\n  const revised = parseVersionRef(revisedId)\n  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId })\n  if (base.version) query.set('base_version', String(base.version))\n  if (revised.version) query.set('revised_version', String(revised.version))\n  return query\n}\n\n/** Word comparison through the host's authenticated transport and LibreOffice service. */\nexport function NativeDocxComparison({\n  adapter,\n  baseId,\n  revisedId,\n  title,\n  onCompared,\n}: NativeDocxComparisonProps) {\n  const host = useRef({ adapter, onCompared })\n  host.current = { adapter, onCompared }\n  const [documentId, setDocumentId] = useState('')\n  const [error, setError] = useState('')\n  const [attempt, setAttempt] = useState(0)\n  useEffect(() => {\n    let cancelled = false\n    setDocumentId('')\n    setError('')\n    void host.current.adapter\n      .request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: 'POST' })\n      .then((response) => response.json())\n      .then((result: { document_ext_id: string }) => {\n        if (!result.document_ext_id) throw new Error('Comparison did not return a Word document.')\n        if (!cancelled) {\n          setDocumentId(result.document_ext_id)\n          void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {})\n        }\n      })\n      .catch((error) => {\n        if (!cancelled) setError(error instanceof Error ? error.message : String(error))\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [baseId, revisedId, attempt])\n  if (error)\n    return (\n      <div className=\"native-docx-error\" role=\"alert\">\n        <p>{error}</p>\n        <button onClick={() => setAttempt((value) => value + 1)}>Retry comparison</button>\n      </div>\n    )\n  if (!documentId)\n    return (\n      <div className=\"native-docx-error\" role=\"status\">\n        Comparing Word documents…\n      </div>\n    )\n  return (\n    <NativeDocxEditor\n      key={documentId}\n      adapter={adapter}\n      documentId={documentId}\n      title={`${title.replace(/\\.[^.]+$/, '')} (redline).docx`}\n    />\n  )\n}\n","import { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface StreamedWordArtifactProps {\n  adapter: NativeDocxAdapter\n  /** Streamed Markdown, shown as a read-only preview while the draft is generated. */\n  content: string\n  title: string\n  busy: boolean\n  error?: string | null\n  /** The DOCX draft the server stored for this generation (`doc-…`), once known. */\n  documentId?: string\n  onSaved?: (documentId: string) => void\n}\n\n/**\n * One drafting surface for an AI document draft. The server stores every draft as DOCX, so\n * this component never creates a document: it previews the streamed Markdown until generation\n * ends and the stored DOCX is known, then opens that DOCX in the live collaborative editor.\n */\nexport function StreamedWordArtifact({\n  adapter,\n  content,\n  title,\n  busy,\n  error,\n  documentId,\n  onSaved,\n}: StreamedWordArtifactProps) {\n  if (!busy && documentId) {\n    return (\n      <NativeDocxEditor\n        key={documentId}\n        adapter={adapter}\n        documentId={documentId}\n        title={title}\n        onSaved={onSaved}\n      />\n    )\n  }\n  return (\n    <NativeDocxEditor\n      key=\"stream-preview\"\n      adapter={adapter}\n      documentId=\"stream-preview\"\n      title={title}\n      draftContent=\"\"\n      stream={{ content, busy, error }}\n    />\n  )\n}\n"]}