setup-agent 0.0.6 → 0.0.8

package/dist/protocol.js

@@ -1,4 +1,4 @@
-//#region src/protocol.ts
+// src/protocol.ts
 const AGENT_PRESENCE_MS = 15e3;
 const AGENT_HEARTBEAT_MS = 5e3;
 const initialCheckoutState = () => ({
@@ -48,8 +48,10 @@ const parsePreviewUrl = (value) => {
 	}
 	if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
 	if (url.username !== "" || url.password !== "") return void 0;
-	return LOOPBACK_HOSTS.has(url.hostname) || url.hostname.endsWith(".localhost") ? url : void 0;
+	return isLoopbackHostname(url.hostname) ? url : void 0;
 };
+/** True for a hostname that names this machine. */
+const isLoopbackHostname = (hostname) => LOOPBACK_HOSTS.has(hostname) || hostname.endsWith(".localhost");
 const openInputs = (state) => state.inputs.filter((input) => input.status === "open");
 /** The current plan revision, or `undefined` before the agent proposed one. */
 const currentPlan = (state) => state.plans.at(-1);
@@ -209,7 +211,6 @@ const stepProgress = (state) => ({
 	total: state.steps.length,
 	done: state.steps.filter((step) => step.status === "done" || step.status === "skipped").length
 });
-//#endregion
-export { AGENT_HEARTBEAT_MS, AGENT_PRESENCE_MS, OPTION_ICONS, classifyChoiceAnswer, currentPlan, finishProposed, followedUpSinceProposal, initialCheckoutState, isAgentPresent, isClosed, isOptionIcon, isValidEntryPointAnswer, isValidEntryPointInput, isValidModelAnswer, openInputs, parseChoiceAnswer, parseEntryPointOptions, parseModelAnswer, parseMultipleAnswer, parsePreviewUrl, planNeedsReview, stepProgress };
+export { AGENT_HEARTBEAT_MS, AGENT_PRESENCE_MS, OPTION_ICONS, classifyChoiceAnswer, currentPlan, finishProposed, followedUpSinceProposal, initialCheckoutState, isAgentPresent, isClosed, isLoopbackHostname, isOptionIcon, isValidEntryPointAnswer, isValidEntryPointInput, isValidModelAnswer, openInputs, parseChoiceAnswer, parseEntryPointOptions, parseModelAnswer, parseMultipleAnswer, parsePreviewUrl, planNeedsReview, stepProgress };
 
 //# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["export namespace Checkout {\n  export type StepStatus =\n    | \"pending\"\n    | \"active\"\n    | \"done\"\n    | \"skipped\"\n    | \"blocked\";\n\n  /** A unit of install work the agent declared; the catalog seeds none. */\n  export type Step = {\n    id: string;\n    title: string;\n    detail?: string;\n    status: StepStatus;\n    note?: string;\n    /** The product this step belongs to, when the agent said. */\n    product?: string;\n    createdAt: number;\n  };\n\n  export type Product = {\n    slug: string;\n    name: string;\n    /** The install reference the agent fetches while planning. */\n    guide?: string;\n  };\n\n  export type InputStatus = \"open\" | \"answered\" | \"dismissed\";\n\n  /**\n   * product: the agent proposes adding a product to this checkout, such as one\n   * another product depends on. The browser owns the catalog, so it answers\n   * with `checkout/add-product`; dismissing the input declines.\n   */\n  export type InputKind =\n    | \"text\"\n    | \"choice\"\n    | \"model\"\n    | \"product\"\n    | \"entry-point\";\n\n  export type EntryPoint = {\n    formFactor: \"modal\" | \"sidebar\" | \"full-page\";\n    placement: string;\n    trigger: string;\n    recommended?: boolean;\n  };\n\n  export type EntryPointOption = {\n    id: string;\n    label: string;\n    description: string;\n    entryPoint: EntryPoint;\n  };\n\n  export type ChoiceVariant = { id: string; label: string };\n\n  export type ChoiceOption = {\n    id: string;\n    label: string;\n    description?: string;\n    /** A name from OPTION_ICONS, or the key of a brand mark on a preset option; unknown keys render without one. */\n    icon?: string;\n    /** A second pick under this option, such as the language of a framework. */\n    variants?: ChoiceVariant[];\n    entryPoint?: EntryPoint;\n  };\n\n  /** A short nudge for users who need help choosing, with a longer guide to link to. */\n  export type InputHelp = { summary: string; href?: string };\n\n  /**\n   * The answer to a model input, stored as JSON text. The API key itself is\n   * never part of it: the browser deposits it with the checkout and the\n   * agent's `env` command writes it straight to a file.\n   */\n  export type ModelAnswer = {\n    provider: string;\n    model: string;\n    reasoningEffort?: \"low\" | \"medium\" | \"high\";\n  };\n\n  /**\n   * A choice answer is an option id, `<option>:<variant>` when the option has\n   * variants, or the user's own text when none of the options fit; a multiple\n   * choice answers a JSON array of those. A model answer is a JSON-encoded\n   * ModelAnswer whose provider is one of the options.\n   */\n  export type Input = {\n    phase: Status;\n    id: string;\n    kind: InputKind;\n    /** The standard input this was built from, when it was. */\n    preset?: string;\n    prompt: string;\n    placeholder?: string;\n    options?: ChoiceOption[];\n    /** The user may pick any number of options; the answer is a JSON array. */\n    multiple?: true;\n    /** The slug a product input proposes. */\n    product?: string;\n    default?: string;\n    help?: InputHelp;\n    optional: boolean;\n    status: InputStatus;\n    answer?: string;\n    /** A remark the user attached to the answer. */\n    note?: string;\n    stepId?: string;\n    createdAt: number;\n    answeredAt?: number;\n  };\n\n  export type LogEntry = {\n    phase: Status;\n    id: string;\n    role: \"agent\" | \"user\";\n    acknowledgedAt?: number;\n    at: number;\n    text: string;\n    /** The step that was active when the line was posted; none while planning. */\n    stepId?: string;\n  };\n\n  export type PlanStatus = \"proposed\" | \"approved\" | \"changes-requested\";\n\n  /** One revision of the agent's plan. Markdown the browser renders. */\n  export type Plan = {\n    revision: number;\n    markdown: string;\n    status: PlanStatus;\n    submittedAt: number;\n    decidedAt?: number;\n    /** What the user asked to change, when they did. */\n    feedback?: string;\n  };\n\n  /**\n   * waiting: no agent has joined. planning: the agent investigates and\n   * proposes a plan. installing: the plan is approved and steps run.\n   */\n  export type Status =\n    | \"waiting\"\n    | \"planning\"\n    | \"installing\"\n    | \"done\"\n    | \"cancelled\";\n\n  /**\n   * The agent's proposal to close the checkout. Only the user closes it, and\n   * they may keep messaging the agent instead; a later `done` renews it.\n   * `preview` is the loopback URL of a dev server the agent left running for\n   * the user to try before they close.\n   */\n  export type Completion = { proposedAt: number; preview?: string };\n\n  export type State = {\n    version: 2;\n    /** The id the browser gave the current checkout; a create with another id replaces it on the same link. */\n    id: string | null;\n    status: Status;\n    completion?: Completion;\n    createdAt: number | null;\n    products: Product[];\n    instructions: string;\n    agent: {\n      lastSeenAt: number | null;\n      /** False once the agent's stream said goodbye; heartbeats set it again. */\n      connected: boolean;\n      cwd: string | null;\n      /** The coding agent that ran the command, as the CLI detected it from its environment. */\n      kind: string | null;\n      /** When the command was first run against this checkout, before the agent joined the stream. */\n      introducedAt: number | null;\n    };\n    /** Every revision in order; the last one is current. */\n    plans: Plan[];\n    steps: Step[];\n    inputs: Input[];\n    log: LogEntry[];\n  };\n\n  export type ProductSeed = { slug: string; name: string; guide?: string };\n\n  export type InputSeed = {\n    kind?: InputKind;\n    preset?: string;\n    prompt: string;\n    placeholder?: string;\n    options?: ChoiceOption[];\n    multiple?: true;\n    product?: string;\n    default?: string;\n    help?: InputHelp;\n    optional?: boolean;\n  };\n\n  export type PlanDecision =\n    | { decision: \"approve\" }\n    | { decision: \"revise\"; feedback: string };\n\n  export type Commands = {\n    \"checkout/create\": (params: {\n      id: string;\n      products: ProductSeed[];\n      instructions?: string;\n    }) => void;\n    \"checkout/begin-plan\": () => void;\n    \"checkout/answer\": (params: {\n      inputId: string;\n      answer: string;\n      note?: string;\n    }) => void;\n    \"checkout/add-product\": (params: {\n      inputId: string;\n      product: ProductSeed;\n    }) => void;\n    \"checkout/message\": (params: { text: string }) => void;\n    \"agent/ack\": (params: { messageId: string }) => void;\n    \"checkout/dismiss\": (params: { inputId: string }) => void;\n    \"checkout/plan\": (params: PlanDecision) => void;\n    /** A cancel that names another checkout than the current one is a no-op. */\n    \"checkout/cancel\": (params?: { id?: string }) => void;\n    \"checkout/finish\": () => void;\n    \"agent/intro\": (params: { kind?: string }) => void;\n    \"agent/hello\": (params: { cwd?: string; kind?: string }) => void;\n    \"agent/heartbeat\": () => void;\n    \"agent/bye\": () => void;\n    \"agent/plan\": (params: { markdown: string }) => { revision: number };\n    \"agent/add-step\": (params: {\n      title: string;\n      detail?: string;\n      product?: string;\n      /** Start the step in the same call. */\n      active?: boolean;\n    }) => { stepId: string };\n    \"agent/step\": (params: {\n      stepId: string;\n      status: StepStatus;\n      note?: string;\n    }) => void;\n    \"agent/ask\": (params: InputSeed & { stepId?: string }) => {\n      inputId: string;\n    };\n    \"agent/log\": (params: { text: string }) => void;\n    \"agent/done\": (params?: { summary?: string; preview?: string }) => void;\n  };\n\n  export type RejectionReason =\n    | \"already-created\"\n    | \"not-created\"\n    | \"closed\"\n    | \"planning-not-started\"\n    | \"plan-required\"\n    | \"no-plan\"\n    | \"plan-decided\"\n    | \"finish-not-proposed\"\n    | \"feedback-required\"\n    | \"empty-plan\"\n    | \"unknown-step\"\n    | \"unknown-product\"\n    | \"unknown-input\"\n    | \"input-closed\"\n    | \"invalid-input\"\n    | \"invalid-answer\"\n    | \"invalid-preview\"\n    | \"empty-message\"\n    | \"unknown-message\";\n}\n\nexport const AGENT_PRESENCE_MS = 15_000;\nexport const AGENT_HEARTBEAT_MS = 5_000;\n\nexport const initialCheckoutState = (): Checkout.State => ({\n  version: 2,\n  id: null,\n  status: \"waiting\",\n  createdAt: null,\n  products: [],\n  instructions: \"\",\n  agent: {\n    lastSeenAt: null,\n    connected: false,\n    cwd: null,\n    kind: null,\n    introducedAt: null,\n  },\n  plans: [],\n  steps: [],\n  inputs: [],\n  log: [],\n});\n\nexport const isAgentPresent = (state: Checkout.State, now = Date.now()) =>\n  state.agent.connected &&\n  state.agent.lastSeenAt !== null &&\n  now - state.agent.lastSeenAt < AGENT_PRESENCE_MS;\n\nexport const isClosed = (state: Checkout.State) =>\n  state.status === \"done\" || state.status === \"cancelled\";\n\n/** True while the agent's proposal to close waits for the user. */\nexport const finishProposed = (state: Checkout.State) =>\n  !isClosed(state) && state.completion !== undefined;\n\n/** True while a message the user sent after the agent proposed to close still waits for the agent. */\nexport const followedUpSinceProposal = (state: Checkout.State) => {\n  const proposedAt = state.completion?.proposedAt;\n  return (\n    proposedAt !== undefined &&\n    state.log.some(\n      (entry) =>\n        entry.role === \"user\" &&\n        entry.at > proposedAt &&\n        entry.acknowledgedAt === undefined,\n    )\n  );\n};\n\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"[::1]\"]);\n\n/**\n * The URL a preview names, or `undefined` unless it is an http(s) URL on this\n * machine's loopback interface. The browser opens it, so nothing else passes.\n */\nexport const parsePreviewUrl = (value: string | undefined) => {\n  if (!value) return undefined;\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return undefined;\n  }\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") return undefined;\n  if (url.username !== \"\" || url.password !== \"\") return undefined;\n  const loopback =\n    LOOPBACK_HOSTS.has(url.hostname) || url.hostname.endsWith(\".localhost\");\n  return loopback ? url : undefined;\n};\n\nexport const openInputs = (state: Checkout.State) =>\n  state.inputs.filter((input) => input.status === \"open\");\n\n/** The current plan revision, or `undefined` before the agent proposed one. */\nexport const currentPlan = (state: Checkout.State): Checkout.Plan | undefined =>\n  state.plans.at(-1);\n\n/** True while a proposed plan waits for the user's decision. */\nexport const planNeedsReview = (state: Checkout.State) =>\n  !isClosed(state) && currentPlan(state)?.status === \"proposed\";\n\n/** The icons an agent can put on its own options, by name. */\nexport const OPTION_ICONS = [\n  \"code\",\n  \"terminal\",\n  \"braces\",\n  \"git-branch\",\n  \"package\",\n  \"database\",\n  \"server\",\n  \"cloud\",\n  \"globe\",\n  \"monitor\",\n  \"smartphone\",\n  \"key\",\n  \"lock\",\n  \"shield\",\n  \"brain\",\n  \"sparkles\",\n  \"bot\",\n  \"workflow\",\n  \"file\",\n  \"folder\",\n  \"book\",\n  \"table\",\n  \"image\",\n  \"video\",\n  \"mic\",\n  \"speech\",\n  \"paperclip\",\n  \"message\",\n  \"mail\",\n  \"bell\",\n  \"calendar\",\n  \"clock\",\n  \"user\",\n  \"users\",\n  \"settings\",\n  \"wrench\",\n  \"plug\",\n  \"link\",\n  \"palette\",\n  \"search\",\n  \"zap\",\n  \"check\",\n  \"question\",\n] as const;\n\nexport type OptionIcon = (typeof OPTION_ICONS)[number];\n\nexport const isOptionIcon = (value: string): value is OptionIcon =>\n  (OPTION_ICONS as readonly string[]).includes(value);\n\nexport const parseChoiceAnswer = (answer: string) => {\n  const parts = answer.split(\":\");\n  if (parts.length > 2) return { option: answer };\n  const [option = \"\", variant] = parts;\n  return { option, ...(variant !== undefined && { variant }) };\n};\n\n/** The entries of a multiple choice answer, or `undefined` when the text is not a JSON array of strings. */\nexport const parseMultipleAnswer = (answer: string): string[] | undefined => {\n  let value: unknown;\n  try {\n    value = JSON.parse(answer);\n  } catch {\n    return undefined;\n  }\n  return Array.isArray(value) &&\n    value.every((entry) => typeof entry === \"string\")\n    ? value\n    : undefined;\n};\n\ntype ChoiceAnswerKind = \"option\" | \"custom\" | \"invalid\";\n\nconst classifyChoiceEntry = (\n  input: Checkout.Input,\n  answer: string,\n): ChoiceAnswerKind => {\n  const { option, variant } = parseChoiceAnswer(answer);\n  const match = input.options?.find((candidate) => candidate.id === option);\n  if (!match) return answer.trim() === \"\" ? \"invalid\" : \"custom\";\n  if (!match.variants || match.variants.length === 0) {\n    return variant === undefined ? \"option\" : \"invalid\";\n  }\n  return match.variants.some((candidate) => candidate.id === variant)\n    ? \"option\"\n    : \"invalid\";\n};\n\n/**\n * \"option\" when `answer` names one of the input's options (with a variant\n * when the option has them), \"custom\" for the user's own text, \"invalid\"\n * for an option named without its variant or with an unknown one. A\n * multiple choice is classified entry by entry: \"invalid\" when any entry is\n * or the array is empty, \"custom\" when any entry is the user's own text.\n */\nexport const classifyChoiceAnswer = (\n  input: Checkout.Input,\n  answer: string,\n): ChoiceAnswerKind => {\n  if (!input.multiple) return classifyChoiceEntry(input, answer);\n  const entries = parseMultipleAnswer(answer);\n  if (!entries || entries.length === 0) return \"invalid\";\n  const kinds = entries.map((entry) => classifyChoiceEntry(input, entry));\n  if (kinds.includes(\"invalid\")) return \"invalid\";\n  return kinds.includes(\"custom\") ? \"custom\" : \"option\";\n};\n\nconst isEntryPointText = (value: unknown, max: number): value is string =>\n  typeof value === \"string\" && value.trim() !== \"\" && value.length <= max;\n\nexport const parseEntryPointOptions = (\n  value: unknown,\n): Checkout.EntryPointOption[] | undefined => {\n  if (!Array.isArray(value) || value.length < 1 || value.length > 3)\n    return undefined;\n  const options: Checkout.EntryPointOption[] = [];\n  for (const candidate of value) {\n    if (typeof candidate !== \"object\" || candidate === null) return undefined;\n    const { id, label, description, entryPoint, variants } =\n      candidate as Record<string, unknown>;\n    if (\n      typeof id !== \"string\" ||\n      !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$/.test(id) ||\n      options.some((option) => option.id === id) ||\n      !isEntryPointText(label, 160) ||\n      !isEntryPointText(description, 1000) ||\n      variants !== undefined ||\n      typeof entryPoint !== \"object\" ||\n      entryPoint === null\n    )\n      return undefined;\n    const { formFactor, placement, trigger, recommended } =\n      entryPoint as Record<string, unknown>;\n    if (\n      (formFactor !== \"modal\" &&\n        formFactor !== \"sidebar\" &&\n        formFactor !== \"full-page\") ||\n      !isEntryPointText(placement, 400) ||\n      !isEntryPointText(trigger, 400) ||\n      (recommended !== undefined && typeof recommended !== \"boolean\")\n    )\n      return undefined;\n    options.push({\n      id,\n      label,\n      description,\n      entryPoint: {\n        formFactor,\n        placement,\n        trigger,\n        ...(recommended !== undefined && { recommended }),\n      },\n    });\n  }\n  return options.filter((option) => option.entryPoint.recommended).length <= 1\n    ? options\n    : undefined;\n};\n\nexport const isValidEntryPointInput = (input: Checkout.InputSeed) => {\n  const options = parseEntryPointOptions(input.options);\n  return (\n    input.kind === \"entry-point\" &&\n    isEntryPointText(input.prompt, 1000) &&\n    options !== undefined &&\n    input.multiple === undefined &&\n    input.help === undefined &&\n    (input.default === undefined ||\n      options.some((option) => option.id === input.default))\n  );\n};\n\nexport const isValidEntryPointAnswer = (\n  input: Checkout.Input,\n  answer: string,\n) => input.options?.some((option) => option.id === answer) ?? false;\n\nconst REASONING_EFFORTS = new Set([\"low\", \"medium\", \"high\"]);\n\nconst isReasoningEffort = (\n  value: unknown,\n): value is NonNullable<Checkout.ModelAnswer[\"reasoningEffort\"]> =>\n  typeof value === \"string\" && REASONING_EFFORTS.has(value);\n\n/** The model answer an input holds, or `undefined` when the text is not one. */\nexport const parseModelAnswer = (\n  answer: string,\n): Checkout.ModelAnswer | undefined => {\n  let value: unknown;\n  try {\n    value = JSON.parse(answer);\n  } catch {\n    return undefined;\n  }\n  if (typeof value !== \"object\" || value === null) return undefined;\n  const { provider, model, reasoningEffort } = value as Record<string, unknown>;\n  if (\n    typeof provider !== \"string\" ||\n    typeof model !== \"string\" ||\n    provider === \"\" ||\n    model === \"\"\n  ) {\n    return undefined;\n  }\n  if (reasoningEffort === undefined) return { provider, model };\n  if (!isReasoningEffort(reasoningEffort)) return undefined;\n  return { provider, model, reasoningEffort };\n};\n\n/** Whether `answer` is a model answer naming one of the input's providers. */\nexport const isValidModelAnswer = (input: Checkout.Input, answer: string) => {\n  const parsed = parseModelAnswer(answer);\n  return (\n    parsed !== undefined &&\n    (input.options?.some((option) => option.id === parsed.provider) ?? false)\n  );\n};\n\nexport const stepProgress = (state: Checkout.State) => ({\n  total: state.steps.length,\n  done: state.steps.filter(\n    (step) => step.status === \"done\" || step.status === \"skipped\",\n  ).length,\n});\n"],"mappings":"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"}
+{"version":3,"file":"protocol.js","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["export namespace Checkout {\n  export type StepStatus =\n    | \"pending\"\n    | \"active\"\n    | \"done\"\n    | \"skipped\"\n    | \"blocked\";\n\n  /** A unit of install work the agent declared; the catalog seeds none. */\n  export type Step = {\n    id: string;\n    title: string;\n    detail?: string;\n    status: StepStatus;\n    note?: string;\n    /** The product this step belongs to, when the agent said. */\n    product?: string;\n    createdAt: number;\n  };\n\n  export type Product = {\n    slug: string;\n    name: string;\n    /** The install reference the agent fetches while planning. */\n    guide?: string;\n  };\n\n  export type InputStatus = \"open\" | \"answered\" | \"dismissed\";\n\n  /**\n   * product: the agent proposes adding a product to this checkout, such as one\n   * another product depends on. The browser owns the catalog, so it answers\n   * with `checkout/add-product`; dismissing the input declines.\n   */\n  export type InputKind =\n    | \"text\"\n    | \"choice\"\n    | \"model\"\n    | \"product\"\n    | \"entry-point\";\n\n  export type EntryPoint = {\n    formFactor: \"modal\" | \"sidebar\" | \"full-page\";\n    placement: string;\n    trigger: string;\n    recommended?: boolean;\n  };\n\n  export type EntryPointOption = {\n    id: string;\n    label: string;\n    description: string;\n    entryPoint: EntryPoint;\n  };\n\n  export type ChoiceVariant = { id: string; label: string };\n\n  export type ChoiceOption = {\n    id: string;\n    label: string;\n    description?: string;\n    /** A name from OPTION_ICONS, or the key of a brand mark on a preset option; unknown keys render without one. */\n    icon?: string;\n    /** A second pick under this option, such as the language of a framework. */\n    variants?: ChoiceVariant[];\n    entryPoint?: EntryPoint;\n  };\n\n  /** A short nudge for users who need help choosing, with a longer guide to link to. */\n  export type InputHelp = { summary: string; href?: string };\n\n  /**\n   * The answer to a model input, stored as JSON text. The API key itself is\n   * never part of it: the browser deposits it with the checkout and the\n   * agent's `env` command writes it straight to a file.\n   */\n  export type ModelAnswer = {\n    provider: string;\n    model: string;\n    reasoningEffort?: \"low\" | \"medium\" | \"high\";\n  };\n\n  /**\n   * A choice answer is an option id, `<option>:<variant>` when the option has\n   * variants, or the user's own text when none of the options fit; a multiple\n   * choice answers a JSON array of those. A model answer is a JSON-encoded\n   * ModelAnswer whose provider is one of the options.\n   */\n  export type Input = {\n    phase: Status;\n    id: string;\n    kind: InputKind;\n    /** The standard input this was built from, when it was. */\n    preset?: string;\n    prompt: string;\n    placeholder?: string;\n    options?: ChoiceOption[];\n    /** The user may pick any number of options; the answer is a JSON array. */\n    multiple?: true;\n    /** The slug a product input proposes. */\n    product?: string;\n    default?: string;\n    help?: InputHelp;\n    redeemKeyHash?: string;\n    optional: boolean;\n    status: InputStatus;\n    answer?: string;\n    /** A remark the user attached to the answer. */\n    note?: string;\n    stepId?: string;\n    createdAt: number;\n    answeredAt?: number;\n  };\n\n  export type LogEntry = {\n    phase: Status;\n    id: string;\n    role: \"agent\" | \"user\";\n    acknowledgedAt?: number;\n    at: number;\n    text: string;\n    /** The step that was active when the line was posted; none while planning. */\n    stepId?: string;\n  };\n\n  export type PlanStatus = \"proposed\" | \"approved\" | \"changes-requested\";\n\n  /** One revision of the agent's plan. Markdown the browser renders. */\n  export type Plan = {\n    revision: number;\n    markdown: string;\n    status: PlanStatus;\n    submittedAt: number;\n    decidedAt?: number;\n    /** What the user asked to change, when they did. */\n    feedback?: string;\n  };\n\n  /**\n   * waiting: no agent has joined. planning: the agent investigates and\n   * proposes a plan. installing: the plan is approved and steps run.\n   */\n  export type Status =\n    | \"waiting\"\n    | \"planning\"\n    | \"installing\"\n    | \"done\"\n    | \"cancelled\";\n\n  /**\n   * The agent's proposal to close the checkout. Only the user closes it, and\n   * they may keep messaging the agent instead; a later `done` renews it.\n   * `preview` is the loopback URL of a dev server the agent left running for\n   * the user to try before they close.\n   */\n  export type Completion = { proposedAt: number; preview?: string };\n\n  export type State = {\n    version: 2;\n    /** The id the browser gave the current checkout; a create with another id replaces it on the same link. */\n    id: string | null;\n    status: Status;\n    completion?: Completion;\n    createdAt: number | null;\n    products: Product[];\n    instructions: string;\n    agent: {\n      lastSeenAt: number | null;\n      /** False once the agent's stream said goodbye; heartbeats set it again. */\n      connected: boolean;\n      cwd: string | null;\n      /** The coding agent that ran the command, as the CLI detected it from its environment. */\n      kind: string | null;\n      /** When the command was first run against this checkout, before the agent joined the stream. */\n      introducedAt: number | null;\n    };\n    /** Every revision in order; the last one is current. */\n    plans: Plan[];\n    steps: Step[];\n    inputs: Input[];\n    log: LogEntry[];\n  };\n\n  export type ProductSeed = { slug: string; name: string; guide?: string };\n\n  export type InputSeed = {\n    kind?: InputKind;\n    preset?: string;\n    prompt: string;\n    placeholder?: string;\n    options?: ChoiceOption[];\n    multiple?: true;\n    product?: string;\n    default?: string;\n    help?: InputHelp;\n    redeemKeyHash?: string;\n    optional?: boolean;\n  };\n\n  export type PlanDecision = {\n    /** The setup the browser reviewed; omitted by legacy clients. */\n    id?: string;\n    /** The plan revision the browser reviewed; omitted by legacy clients. */\n    revision?: number;\n  } & ({ decision: \"approve\" } | { decision: \"revise\"; feedback: string });\n\n  export type Commands = {\n    \"checkout/create\": (params: {\n      id: string;\n      products: ProductSeed[];\n      instructions?: string;\n    }) => void;\n    \"checkout/begin-plan\": () => void;\n    \"checkout/answer\": (params: {\n      inputId: string;\n      answer: string;\n      note?: string;\n    }) => void;\n    \"checkout/add-product\": (params: {\n      inputId: string;\n      product: ProductSeed;\n    }) => void;\n    \"checkout/message\": (params: { text: string }) => void;\n    \"agent/ack\": (params: { messageId: string }) => void;\n    \"checkout/dismiss\": (params: { inputId: string }) => void;\n    \"checkout/plan\": (params: PlanDecision) => void;\n    /** A cancel that names another checkout than the current one is a no-op. */\n    \"checkout/cancel\": (params?: { id?: string }) => void;\n    \"checkout/finish\": () => void;\n    \"agent/intro\": (params: { kind?: string }) => void;\n    \"agent/hello\": (params: { cwd?: string; kind?: string }) => void;\n    \"agent/heartbeat\": () => void;\n    \"agent/bye\": () => void;\n    \"agent/plan\": (params: { markdown: string }) => { revision: number };\n    \"agent/add-step\": (params: {\n      title: string;\n      detail?: string;\n      product?: string;\n      /** Start the step in the same call. */\n      active?: boolean;\n    }) => { stepId: string };\n    \"agent/step\": (params: {\n      stepId: string;\n      status: StepStatus;\n      note?: string;\n    }) => void;\n    \"agent/ask\": (params: InputSeed & { stepId?: string }) => {\n      inputId: string;\n    };\n    \"agent/log\": (params: { text: string }) => void;\n    \"agent/done\": (params?: { summary?: string; preview?: string }) => void;\n  };\n\n  export type RejectionReason =\n    | \"already-created\"\n    | \"not-created\"\n    | \"closed\"\n    | \"planning-not-started\"\n    | \"plan-required\"\n    | \"no-plan\"\n    | \"plan-decided\"\n    | \"stale-plan\"\n    | \"finish-not-proposed\"\n    | \"feedback-required\"\n    | \"empty-plan\"\n    | \"unknown-step\"\n    | \"unknown-product\"\n    | \"unknown-input\"\n    | \"input-closed\"\n    | \"invalid-input\"\n    | \"invalid-answer\"\n    | \"invalid-preview\"\n    | \"empty-message\"\n    | \"unknown-message\";\n}\n\nexport const AGENT_PRESENCE_MS = 15_000;\nexport const AGENT_HEARTBEAT_MS = 5_000;\n\nexport const initialCheckoutState = (): Checkout.State => ({\n  version: 2,\n  id: null,\n  status: \"waiting\",\n  createdAt: null,\n  products: [],\n  instructions: \"\",\n  agent: {\n    lastSeenAt: null,\n    connected: false,\n    cwd: null,\n    kind: null,\n    introducedAt: null,\n  },\n  plans: [],\n  steps: [],\n  inputs: [],\n  log: [],\n});\n\nexport const isAgentPresent = (state: Checkout.State, now = Date.now()) =>\n  state.agent.connected &&\n  state.agent.lastSeenAt !== null &&\n  now - state.agent.lastSeenAt < AGENT_PRESENCE_MS;\n\nexport const isClosed = (state: Checkout.State) =>\n  state.status === \"done\" || state.status === \"cancelled\";\n\n/** True while the agent's proposal to close waits for the user. */\nexport const finishProposed = (state: Checkout.State) =>\n  !isClosed(state) && state.completion !== undefined;\n\n/** True while a message the user sent after the agent proposed to close still waits for the agent. */\nexport const followedUpSinceProposal = (state: Checkout.State) => {\n  const proposedAt = state.completion?.proposedAt;\n  return (\n    proposedAt !== undefined &&\n    state.log.some(\n      (entry) =>\n        entry.role === \"user\" &&\n        entry.at > proposedAt &&\n        entry.acknowledgedAt === undefined,\n    )\n  );\n};\n\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"[::1]\"]);\n\n/**\n * The URL a preview names, or `undefined` unless it is an http(s) URL on this\n * machine's loopback interface. The browser opens it, so nothing else passes.\n */\nexport const parsePreviewUrl = (value: string | undefined) => {\n  if (!value) return undefined;\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return undefined;\n  }\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") return undefined;\n  if (url.username !== \"\" || url.password !== \"\") return undefined;\n  return isLoopbackHostname(url.hostname) ? url : undefined;\n};\n\n/** True for a hostname that names this machine. */\nexport const isLoopbackHostname = (hostname: string) =>\n  LOOPBACK_HOSTS.has(hostname) || hostname.endsWith(\".localhost\");\n\nexport const openInputs = (state: Checkout.State) =>\n  state.inputs.filter((input) => input.status === \"open\");\n\n/** The current plan revision, or `undefined` before the agent proposed one. */\nexport const currentPlan = (state: Checkout.State): Checkout.Plan | undefined =>\n  state.plans.at(-1);\n\n/** True while a proposed plan waits for the user's decision. */\nexport const planNeedsReview = (state: Checkout.State) =>\n  !isClosed(state) && currentPlan(state)?.status === \"proposed\";\n\n/** The icons an agent can put on its own options, by name. */\nexport const OPTION_ICONS = [\n  \"code\",\n  \"terminal\",\n  \"braces\",\n  \"git-branch\",\n  \"package\",\n  \"database\",\n  \"server\",\n  \"cloud\",\n  \"globe\",\n  \"monitor\",\n  \"smartphone\",\n  \"key\",\n  \"lock\",\n  \"shield\",\n  \"brain\",\n  \"sparkles\",\n  \"bot\",\n  \"workflow\",\n  \"file\",\n  \"folder\",\n  \"book\",\n  \"table\",\n  \"image\",\n  \"video\",\n  \"mic\",\n  \"speech\",\n  \"paperclip\",\n  \"message\",\n  \"mail\",\n  \"bell\",\n  \"calendar\",\n  \"clock\",\n  \"user\",\n  \"users\",\n  \"settings\",\n  \"wrench\",\n  \"plug\",\n  \"link\",\n  \"palette\",\n  \"search\",\n  \"zap\",\n  \"check\",\n  \"question\",\n] as const;\n\nexport type OptionIcon = (typeof OPTION_ICONS)[number];\n\nexport const isOptionIcon = (value: string): value is OptionIcon =>\n  (OPTION_ICONS as readonly string[]).includes(value);\n\nexport const parseChoiceAnswer = (answer: string) => {\n  const parts = answer.split(\":\");\n  if (parts.length > 2) return { option: answer };\n  const [option = \"\", variant] = parts;\n  return { option, ...(variant !== undefined && { variant }) };\n};\n\n/** The entries of a multiple choice answer, or `undefined` when the text is not a JSON array of strings. */\nexport const parseMultipleAnswer = (answer: string): string[] | undefined => {\n  let value: unknown;\n  try {\n    value = JSON.parse(answer);\n  } catch {\n    return undefined;\n  }\n  return Array.isArray(value) &&\n    value.every((entry) => typeof entry === \"string\")\n    ? value\n    : undefined;\n};\n\ntype ChoiceAnswerKind = \"option\" | \"custom\" | \"invalid\";\n\nconst classifyChoiceEntry = (\n  input: Checkout.Input,\n  answer: string,\n): ChoiceAnswerKind => {\n  const { option, variant } = parseChoiceAnswer(answer);\n  const match = input.options?.find((candidate) => candidate.id === option);\n  if (!match) return answer.trim() === \"\" ? \"invalid\" : \"custom\";\n  if (!match.variants || match.variants.length === 0) {\n    return variant === undefined ? \"option\" : \"invalid\";\n  }\n  return match.variants.some((candidate) => candidate.id === variant)\n    ? \"option\"\n    : \"invalid\";\n};\n\n/**\n * \"option\" when `answer` names one of the input's options (with a variant\n * when the option has them), \"custom\" for the user's own text, \"invalid\"\n * for an option named without its variant or with an unknown one. A\n * multiple choice is classified entry by entry: \"invalid\" when any entry is\n * or the array is empty, \"custom\" when any entry is the user's own text.\n */\nexport const classifyChoiceAnswer = (\n  input: Checkout.Input,\n  answer: string,\n): ChoiceAnswerKind => {\n  if (!input.multiple) return classifyChoiceEntry(input, answer);\n  const entries = parseMultipleAnswer(answer);\n  if (!entries || entries.length === 0) return \"invalid\";\n  const kinds = entries.map((entry) => classifyChoiceEntry(input, entry));\n  if (kinds.includes(\"invalid\")) return \"invalid\";\n  return kinds.includes(\"custom\") ? \"custom\" : \"option\";\n};\n\nconst isEntryPointText = (value: unknown, max: number): value is string =>\n  typeof value === \"string\" && value.trim() !== \"\" && value.length <= max;\n\nexport const parseEntryPointOptions = (\n  value: unknown,\n): Checkout.EntryPointOption[] | undefined => {\n  if (!Array.isArray(value) || value.length < 1 || value.length > 3)\n    return undefined;\n  const options: Checkout.EntryPointOption[] = [];\n  for (const candidate of value) {\n    if (typeof candidate !== \"object\" || candidate === null) return undefined;\n    const { id, label, description, entryPoint, variants } =\n      candidate as Record<string, unknown>;\n    if (\n      typeof id !== \"string\" ||\n      !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$/.test(id) ||\n      options.some((option) => option.id === id) ||\n      !isEntryPointText(label, 160) ||\n      !isEntryPointText(description, 1000) ||\n      variants !== undefined ||\n      typeof entryPoint !== \"object\" ||\n      entryPoint === null\n    )\n      return undefined;\n    const { formFactor, placement, trigger, recommended } =\n      entryPoint as Record<string, unknown>;\n    if (\n      (formFactor !== \"modal\" &&\n        formFactor !== \"sidebar\" &&\n        formFactor !== \"full-page\") ||\n      !isEntryPointText(placement, 400) ||\n      !isEntryPointText(trigger, 400) ||\n      (recommended !== undefined && typeof recommended !== \"boolean\")\n    )\n      return undefined;\n    options.push({\n      id,\n      label,\n      description,\n      entryPoint: {\n        formFactor,\n        placement,\n        trigger,\n        ...(recommended !== undefined && { recommended }),\n      },\n    });\n  }\n  return options.filter((option) => option.entryPoint.recommended).length <= 1\n    ? options\n    : undefined;\n};\n\nexport const isValidEntryPointInput = (input: Checkout.InputSeed) => {\n  const options = parseEntryPointOptions(input.options);\n  return (\n    input.kind === \"entry-point\" &&\n    isEntryPointText(input.prompt, 1000) &&\n    options !== undefined &&\n    input.multiple === undefined &&\n    input.help === undefined &&\n    (input.default === undefined ||\n      options.some((option) => option.id === input.default))\n  );\n};\n\nexport const isValidEntryPointAnswer = (\n  input: Checkout.Input,\n  answer: string,\n) => input.options?.some((option) => option.id === answer) ?? false;\n\nconst REASONING_EFFORTS = new Set([\"low\", \"medium\", \"high\"]);\n\nconst isReasoningEffort = (\n  value: unknown,\n): value is NonNullable<Checkout.ModelAnswer[\"reasoningEffort\"]> =>\n  typeof value === \"string\" && REASONING_EFFORTS.has(value);\n\n/** The model answer an input holds, or `undefined` when the text is not one. */\nexport const parseModelAnswer = (\n  answer: string,\n): Checkout.ModelAnswer | undefined => {\n  let value: unknown;\n  try {\n    value = JSON.parse(answer);\n  } catch {\n    return undefined;\n  }\n  if (typeof value !== \"object\" || value === null) return undefined;\n  const { provider, model, reasoningEffort } = value as Record<string, unknown>;\n  if (\n    typeof provider !== \"string\" ||\n    typeof model !== \"string\" ||\n    provider === \"\" ||\n    model === \"\"\n  ) {\n    return undefined;\n  }\n  if (reasoningEffort === undefined) return { provider, model };\n  if (!isReasoningEffort(reasoningEffort)) return undefined;\n  return { provider, model, reasoningEffort };\n};\n\n/** Whether `answer` is a model answer naming one of the input's providers. */\nexport const isValidModelAnswer = (input: Checkout.Input, answer: string) => {\n  const parsed = parseModelAnswer(answer);\n  return (\n    parsed !== undefined &&\n    (input.options?.some((option) => option.id === parsed.provider) ?? false)\n  );\n};\n\nexport const stepProgress = (state: Checkout.State) => ({\n  total: state.steps.length,\n  done: state.steps.filter(\n    (step) => step.status === \"done\" || step.status === \"skipped\",\n  ).length,\n});\n"],"mappings":";AAoRA,MAAa,oBAAoB;AACjC,MAAa,qBAAqB;AAElC,MAAa,8BAA8C;CACzD,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,WAAW;CACX,UAAU,CAAC;CACX,cAAc;CACd,OAAO;EACL,YAAY;EACZ,WAAW;EACX,KAAK;EACL,MAAM;EACN,cAAc;CAChB;CACA,OAAO,CAAC;CACR,OAAO,CAAC;CACR,QAAQ,CAAC;CACT,KAAK,CAAC;AACR;AAEA,MAAa,kBAAkB,OAAuB,MAAM,KAAK,IAAI,MACnE,MAAM,MAAM,aACZ,MAAM,MAAM,eAAe,QAC3B,MAAM,MAAM,MAAM,aAAA;AAEpB,MAAa,YAAY,UACvB,MAAM,WAAW,UAAU,MAAM,WAAW;;AAG9C,MAAa,kBAAkB,UAC7B,CAAC,SAAS,KAAK,KAAK,MAAM,eAAe,KAAA;;AAG3C,MAAa,2BAA2B,UAA0B;CAChE,MAAM,aAAa,MAAM,YAAY;CACrC,OACE,eAAe,KAAA,KACf,MAAM,IAAI,MACP,UACC,MAAM,SAAS,UACf,MAAM,KAAK,cACX,MAAM,mBAAmB,KAAA,CAC7B;AAEJ;AAEA,MAAM,iCAAiB,IAAI,IAAI;CAAC;CAAa;CAAa;AAAO,CAAC;;;;;AAMlE,MAAa,mBAAmB,UAA8B;CAC5D,IAAI,CAAC,OAAO,OAAO,KAAA;CACnB,IAAI;CACJ,IAAI;EACF,MAAM,IAAI,IAAI,KAAK;CACrB,QAAQ;EACN;CACF;CACA,IAAI,IAAI,aAAa,WAAW,IAAI,aAAa,UAAU,OAAO,KAAA;CAClE,IAAI,IAAI,aAAa,MAAM,IAAI,aAAa,IAAI,OAAO,KAAA;CACvD,OAAO,mBAAmB,IAAI,QAAQ,IAAI,MAAM,KAAA;AAClD;;AAGA,MAAa,sBAAsB,aACjC,eAAe,IAAI,QAAQ,KAAK,SAAS,SAAS,YAAY;AAEhE,MAAa,cAAc,UACzB,MAAM,OAAO,QAAQ,UAAU,MAAM,WAAW,MAAM;;AAGxD,MAAa,eAAe,UAC1B,MAAM,MAAM,GAAG,EAAE;;AAGnB,MAAa,mBAAmB,UAC9B,CAAC,SAAS,KAAK,KAAK,YAAY,KAAK,CAAC,EAAE,WAAW;;AAGrD,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAIA,MAAa,gBAAgB,UAC1B,aAAmC,SAAS,KAAK;AAEpD,MAAa,qBAAqB,WAAmB;CACnD,MAAM,QAAQ,OAAO,MAAM,GAAG;CAC9B,IAAI,MAAM,SAAS,GAAG,OAAO,EAAE,QAAQ,OAAO;CAC9C,MAAM,CAAC,SAAS,IAAI,WAAW;CAC/B,OAAO;EAAE;EAAQ,GAAI,YAAY,KAAA,KAAa,EAAE,QAAQ;CAAG;AAC7D;;AAGA,MAAa,uBAAuB,WAAyC;CAC3E,IAAI;CACJ,IAAI;EACF,QAAQ,KAAK,MAAM,MAAM;CAC3B,QAAQ;EACN;CACF;CACA,OAAO,MAAM,QAAQ,KAAK,KACxB,MAAM,OAAO,UAAU,OAAO,UAAU,QAAQ,IAC9C,QACA,KAAA;AACN;AAIA,MAAM,uBACJ,OACA,WACqB;CACrB,MAAM,EAAE,QAAQ,YAAY,kBAAkB,MAAM;CACpD,MAAM,QAAQ,MAAM,SAAS,MAAM,cAAc,UAAU,OAAO,MAAM;CACxE,IAAI,CAAC,OAAO,OAAO,OAAO,KAAK,MAAM,KAAK,YAAY;CACtD,IAAI,CAAC,MAAM,YAAY,MAAM,SAAS,WAAW,GAC/C,OAAO,YAAY,KAAA,IAAY,WAAW;CAE5C,OAAO,MAAM,SAAS,MAAM,cAAc,UAAU,OAAO,OAAO,IAC9D,WACA;AACN;;;;;;;;AASA,MAAa,wBACX,OACA,WACqB;CACrB,IAAI,CAAC,MAAM,UAAU,OAAO,oBAAoB,OAAO,MAAM;CAC7D,MAAM,UAAU,oBAAoB,MAAM;CAC1C,IAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,OAAO;CAC7C,MAAM,QAAQ,QAAQ,KAAK,UAAU,oBAAoB,OAAO,KAAK,CAAC;CACtE,IAAI,MAAM,SAAS,SAAS,GAAG,OAAO;CACtC,OAAO,MAAM,SAAS,QAAQ,IAAI,WAAW;AAC/C;AAEA,MAAM,oBAAoB,OAAgB,QACxC,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,MAAM,MAAM,UAAU;AAEtE,MAAa,0BACX,UAC4C;CAC5C,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,KAAK,MAAM,SAAS,GAC9D,OAAO,KAAA;CACT,MAAM,UAAuC,CAAC;CAC9C,KAAK,MAAM,aAAa,OAAO;EAC7B,IAAI,OAAO,cAAc,YAAY,cAAc,MAAM,OAAO,KAAA;EAChE,MAAM,EAAE,IAAI,OAAO,aAAa,YAAY,aAC1C;EACF,IACE,OAAO,OAAO,YACd,CAAC,oCAAoC,KAAK,EAAE,KAC5C,QAAQ,MAAM,WAAW,OAAO,OAAO,EAAE,KACzC,CAAC,iBAAiB,OAAO,GAAG,KAC5B,CAAC,iBAAiB,aAAa,GAAI,KACnC,aAAa,KAAA,KACb,OAAO,eAAe,YACtB,eAAe,MAEf,OAAO,KAAA;EACT,MAAM,EAAE,YAAY,WAAW,SAAS,gBACtC;EACF,IACG,eAAe,WACd,eAAe,aACf,eAAe,eACjB,CAAC,iBAAiB,WAAW,GAAG,KAChC,CAAC,iBAAiB,SAAS,GAAG,KAC7B,gBAAgB,KAAA,KAAa,OAAO,gBAAgB,WAErD,OAAO,KAAA;EACT,QAAQ,KAAK;GACX;GACA;GACA;GACA,YAAY;IACV;IACA;IACA;IACA,GAAI,gBAAgB,KAAA,KAAa,EAAE,YAAY;GACjD;EACF,CAAC;CACH;CACA,OAAO,QAAQ,QAAQ,WAAW,OAAO,WAAW,WAAW,CAAC,CAAC,UAAU,IACvE,UACA,KAAA;AACN;AAEA,MAAa,0BAA0B,UAA8B;CACnE,MAAM,UAAU,uBAAuB,MAAM,OAAO;CACpD,OACE,MAAM,SAAS,iBACf,iBAAiB,MAAM,QAAQ,GAAI,KACnC,YAAY,KAAA,KACZ,MAAM,aAAa,KAAA,KACnB,MAAM,SAAS,KAAA,MACd,MAAM,YAAY,KAAA,KACjB,QAAQ,MAAM,WAAW,OAAO,OAAO,MAAM,OAAO;AAE1D;AAEA,MAAa,2BACX,OACA,WACG,MAAM,SAAS,MAAM,WAAW,OAAO,OAAO,MAAM,KAAK;AAE9D,MAAM,oCAAoB,IAAI,IAAI;CAAC;CAAO;CAAU;AAAM,CAAC;AAE3D,MAAM,qBACJ,UAEA,OAAO,UAAU,YAAY,kBAAkB,IAAI,KAAK;;AAG1D,MAAa,oBACX,WACqC;CACrC,IAAI;CACJ,IAAI;EACF,QAAQ,KAAK,MAAM,MAAM;CAC3B,QAAQ;EACN;CACF;CACA,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,EAAE,UAAU,OAAO,oBAAoB;CAC7C,IACE,OAAO,aAAa,YACpB,OAAO,UAAU,YACjB,aAAa,MACb,UAAU,IAEV;CAEF,IAAI,oBAAoB,KAAA,GAAW,OAAO;EAAE;EAAU;CAAM;CAC5D,IAAI,CAAC,kBAAkB,eAAe,GAAG,OAAO,KAAA;CAChD,OAAO;EAAE;EAAU;EAAO;CAAgB;AAC5C;;AAGA,MAAa,sBAAsB,OAAuB,WAAmB;CAC3E,MAAM,SAAS,iBAAiB,MAAM;CACtC,OACE,WAAW,KAAA,MACV,MAAM,SAAS,MAAM,WAAW,OAAO,OAAO,OAAO,QAAQ,KAAK;AAEvE;AAEA,MAAa,gBAAgB,WAA2B;CACtD,OAAO,MAAM,MAAM;CACnB,MAAM,MAAM,MAAM,QACf,SAAS,KAAK,WAAW,UAAU,KAAK,WAAW,SACtD,CAAC,CAAC;AACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "setup-agent",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "A live setup shared between a browser and the coding agent installing the products in it, on Statewire",
   "license": "MIT",
   "homepage": "https://www.assistant-ui.com/",
@@ -43,11 +43,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@assistant-ui/tap": "^0.9.24",
-    "statewire": "^0.20.0"
+    "@assistant-ui/tap": "^0.9.25",
+    "statewire": "^0.22.1"
   },
   "devDependencies": {
-    "@assistant-ui/x-buildutils": "0.0.31",
+    "@assistant-ui/x-buildutils": "0.0.32",
     "@types/node": "^26.6.5",
     "@types/react": "^19.3.0",
     "react": "^19.3.1",