setup-agent 0.0.3 → 0.0.5

package/dist/protocol.d.ts

@@ -1,272 +1,287 @@
-//#region src/protocol.d.ts
-declare namespace Checkout {
-  type StepStatus = "pending" | "active" | "done" | "skipped" | "blocked";
-  /** A unit of install work the agent declared; the catalog seeds none. */
-  type Step = {
-    id: string;
-    title: string;
-    detail?: string;
-    status: StepStatus;
-    note?: string;
-    /** The product this step belongs to, when the agent said. */
-    product?: string;
-    createdAt: number;
-  };
-  type Product = {
-    slug: string;
-    name: string;
-    /** The install reference the agent fetches while planning. */
-    guide?: string;
-  };
-  type InputStatus = "open" | "answered" | "dismissed";
-  /**
-   * product: the agent proposes adding a product to this checkout, such as one
-   * another product depends on. The browser owns the catalog, so it answers
-   * with `checkout/add-product`; dismissing the input declines.
-   */
-  type InputKind = "text" | "choice" | "model" | "product";
-  type ChoiceVariant = {
-    id: string;
-    label: string;
-  };
-  type ChoiceOption = {
-    id: string;
-    label: string;
-    description?: string;
-    /** A name from OPTION_ICONS, or the key of a brand mark on a preset option; unknown keys render without one. */
-    icon?: string;
-    /** A second pick under this option, such as the language of a framework. */
-    variants?: ChoiceVariant[];
-  };
-  /** A short nudge for users who need help choosing, with a longer guide to link to. */
-  type InputHelp = {
-    summary: string;
-    href?: string;
-  };
-  /**
-   * The answer to a model input, stored as JSON text. The API key itself is
-   * never part of it: the browser deposits it with the checkout and the
-   * agent's `env` command writes it straight to a file.
-   */
-  type ModelAnswer = {
-    provider: string;
-    model: string;
-    reasoningEffort?: "low" | "medium" | "high";
-  };
-  /**
-   * A choice answer is an option id, `<option>:<variant>` when the option has
-   * variants, or the user's own text when none of the options fit; a multiple
-   * choice answers a JSON array of those. A model answer is a JSON-encoded
-   * ModelAnswer whose provider is one of the options.
-   */
-  type Input = {
-    phase: Status;
-    id: string;
-    kind: InputKind;
-    /** The standard input this was built from, when it was. */
-    preset?: string;
-    prompt: string;
-    placeholder?: string;
-    options?: ChoiceOption[];
-    /** The user may pick any number of options; the answer is a JSON array. */
-    multiple?: true;
-    /** The slug a product input proposes. */
-    product?: string;
-    default?: string;
-    help?: InputHelp;
-    optional: boolean;
-    status: InputStatus;
-    answer?: string;
-    /** A remark the user attached to the answer. */
-    note?: string;
-    stepId?: string;
-    createdAt: number;
-    answeredAt?: number;
-  };
-  type LogEntry = {
-    phase: Status;
-    id: string;
-    role: "agent" | "user";
-    acknowledgedAt?: number;
-    at: number;
-    text: string;
-    /** The step that was active when the line was posted; none while planning. */
-    stepId?: string;
-  };
-  type PlanStatus = "proposed" | "approved" | "changes-requested";
-  /** One revision of the agent's plan. Markdown the browser renders. */
-  type Plan = {
-    revision: number;
-    markdown: string;
-    status: PlanStatus;
-    submittedAt: number;
-    decidedAt?: number;
-    /** What the user asked to change, when they did. */
-    feedback?: string;
-  };
-  /**
-   * waiting: no agent has joined. planning: the agent investigates and
-   * proposes a plan. installing: the plan is approved and steps run.
-   */
-  type Status = "waiting" | "planning" | "installing" | "done" | "cancelled";
-  /**
-   * The agent's proposal to close the checkout. Only the user closes it, and
-   * they may keep messaging the agent instead; a later `done` renews it.
-   * `preview` is the loopback URL of a dev server the agent left running for
-   * the user to try before they close.
-   */
-  type Completion = {
-    proposedAt: number;
-    preview?: string;
-  };
-  type State = {
-    version: 2;
-    /** The id the browser gave the current checkout; a create with another id replaces it on the same link. */
-    id: string | null;
-    status: Status;
-    completion?: Completion;
-    createdAt: number | null;
-    products: Product[];
-    instructions: string;
-    agent: {
-      lastSeenAt: number | null;
-      /** False once the agent's stream said goodbye; heartbeats set it again. */
-      connected: boolean;
-      cwd: string | null;
-      /** The coding agent that ran the command, as the CLI detected it from its environment. */
-      kind: string | null;
-      /** When the command was first run against this checkout, before the agent joined the stream. */
-      introducedAt: number | null;
+export declare namespace Checkout {
+    type StepStatus = "pending" | "active" | "done" | "skipped" | "blocked";
+    /** A unit of install work the agent declared; the catalog seeds none. */
+    type Step = {
+        id: string;
+        title: string;
+        detail?: string;
+        status: StepStatus;
+        note?: string;
+        /** The product this step belongs to, when the agent said. */
+        product?: string;
+        createdAt: number;
     };
-    /** Every revision in order; the last one is current. */
-    plans: Plan[];
-    steps: Step[];
-    inputs: Input[];
-    log: LogEntry[];
-  };
-  type ProductSeed = {
-    slug: string;
-    name: string;
-    guide?: string;
-  };
-  type InputSeed = {
-    kind?: InputKind;
-    preset?: string;
-    prompt: string;
-    placeholder?: string;
-    options?: ChoiceOption[];
-    multiple?: true;
-    product?: string;
-    default?: string;
-    help?: InputHelp;
-    optional?: boolean;
-  };
-  type PlanDecision = {
-    decision: "approve";
-  } | {
-    decision: "revise";
-    feedback: string;
-  };
-  type Commands = {
-    "checkout/create": (params: {
-      id: string;
-      products: ProductSeed[];
-      instructions?: string;
-    }) => void;
-    "checkout/begin-plan": () => void;
-    "checkout/answer": (params: {
-      inputId: string;
-      answer: string;
-      note?: string;
-    }) => void;
-    "checkout/add-product": (params: {
-      inputId: string;
-      product: ProductSeed;
-    }) => void;
-    "checkout/message": (params: {
-      text: string;
-    }) => void;
-    "agent/ack": (params: {
-      messageId: string;
-    }) => void;
-    "checkout/dismiss": (params: {
-      inputId: string;
-    }) => void;
-    "checkout/plan": (params: PlanDecision) => void;
-    "checkout/cancel": () => void;
-    "checkout/finish": () => void;
-    "agent/intro": (params: {
-      kind?: string;
-    }) => void;
-    "agent/hello": (params: {
-      cwd?: string;
-      kind?: string;
-    }) => void;
-    "agent/heartbeat": () => void;
-    "agent/bye": () => void;
-    "agent/plan": (params: {
-      markdown: string;
-    }) => {
-      revision: number;
+    type Product = {
+        slug: string;
+        name: string;
+        /** The install reference the agent fetches while planning. */
+        guide?: string;
     };
-    "agent/add-step": (params: {
-      title: string;
-      detail?: string;
-      product?: string;
-      /** Start the step in the same call. */
-      active?: boolean;
-    }) => {
-      stepId: string;
+    type InputStatus = "open" | "answered" | "dismissed";
+    /**
+     * product: the agent proposes adding a product to this checkout, such as one
+     * another product depends on. The browser owns the catalog, so it answers
+     * with `checkout/add-product`; dismissing the input declines.
+     */
+    type InputKind = "text" | "choice" | "model" | "product" | "entry-point";
+    type EntryPoint = {
+        formFactor: "modal" | "sidebar" | "full-page";
+        placement: string;
+        trigger: string;
+        recommended?: boolean;
     };
-    "agent/step": (params: {
-      stepId: string;
-      status: StepStatus;
-      note?: string;
-    }) => void;
-    "agent/ask": (params: InputSeed & {
-      stepId?: string;
-    }) => {
-      inputId: string;
+    type EntryPointOption = {
+        id: string;
+        label: string;
+        description: string;
+        entryPoint: EntryPoint;
     };
-    "agent/log": (params: {
-      text: string;
-    }) => void;
-    "agent/done": (params?: {
-      summary?: string;
-      preview?: string;
-    }) => void;
-  };
-  type RejectionReason = "already-created" | "not-created" | "closed" | "planning-not-started" | "plan-required" | "no-plan" | "plan-decided" | "finish-not-proposed" | "feedback-required" | "empty-plan" | "unknown-step" | "unknown-product" | "unknown-input" | "input-closed" | "invalid-input" | "invalid-answer" | "invalid-preview" | "empty-message" | "unknown-message";
+    type ChoiceVariant = {
+        id: string;
+        label: string;
+    };
+    type ChoiceOption = {
+        id: string;
+        label: string;
+        description?: string;
+        /** A name from OPTION_ICONS, or the key of a brand mark on a preset option; unknown keys render without one. */
+        icon?: string;
+        /** A second pick under this option, such as the language of a framework. */
+        variants?: ChoiceVariant[];
+        entryPoint?: EntryPoint;
+    };
+    /** A short nudge for users who need help choosing, with a longer guide to link to. */
+    type InputHelp = {
+        summary: string;
+        href?: string;
+    };
+    /**
+     * The answer to a model input, stored as JSON text. The API key itself is
+     * never part of it: the browser deposits it with the checkout and the
+     * agent's `env` command writes it straight to a file.
+     */
+    type ModelAnswer = {
+        provider: string;
+        model: string;
+        reasoningEffort?: "low" | "medium" | "high";
+    };
+    /**
+     * A choice answer is an option id, `<option>:<variant>` when the option has
+     * variants, or the user's own text when none of the options fit; a multiple
+     * choice answers a JSON array of those. A model answer is a JSON-encoded
+     * ModelAnswer whose provider is one of the options.
+     */
+    type Input = {
+        phase: Status;
+        id: string;
+        kind: InputKind;
+        /** The standard input this was built from, when it was. */
+        preset?: string;
+        prompt: string;
+        placeholder?: string;
+        options?: ChoiceOption[];
+        /** The user may pick any number of options; the answer is a JSON array. */
+        multiple?: true;
+        /** The slug a product input proposes. */
+        product?: string;
+        default?: string;
+        help?: InputHelp;
+        optional: boolean;
+        status: InputStatus;
+        answer?: string;
+        /** A remark the user attached to the answer. */
+        note?: string;
+        stepId?: string;
+        createdAt: number;
+        answeredAt?: number;
+    };
+    type LogEntry = {
+        phase: Status;
+        id: string;
+        role: "agent" | "user";
+        acknowledgedAt?: number;
+        at: number;
+        text: string;
+        /** The step that was active when the line was posted; none while planning. */
+        stepId?: string;
+    };
+    type PlanStatus = "proposed" | "approved" | "changes-requested";
+    /** One revision of the agent's plan. Markdown the browser renders. */
+    type Plan = {
+        revision: number;
+        markdown: string;
+        status: PlanStatus;
+        submittedAt: number;
+        decidedAt?: number;
+        /** What the user asked to change, when they did. */
+        feedback?: string;
+    };
+    /**
+     * waiting: no agent has joined. planning: the agent investigates and
+     * proposes a plan. installing: the plan is approved and steps run.
+     */
+    type Status = "waiting" | "planning" | "installing" | "done" | "cancelled";
+    /**
+     * The agent's proposal to close the checkout. Only the user closes it, and
+     * they may keep messaging the agent instead; a later `done` renews it.
+     * `preview` is the loopback URL of a dev server the agent left running for
+     * the user to try before they close.
+     */
+    type Completion = {
+        proposedAt: number;
+        preview?: string;
+    };
+    type State = {
+        version: 2;
+        /** The id the browser gave the current checkout; a create with another id replaces it on the same link. */
+        id: string | null;
+        status: Status;
+        completion?: Completion;
+        createdAt: number | null;
+        products: Product[];
+        instructions: string;
+        agent: {
+            lastSeenAt: number | null;
+            /** False once the agent's stream said goodbye; heartbeats set it again. */
+            connected: boolean;
+            cwd: string | null;
+            /** The coding agent that ran the command, as the CLI detected it from its environment. */
+            kind: string | null;
+            /** When the command was first run against this checkout, before the agent joined the stream. */
+            introducedAt: number | null;
+        };
+        /** Every revision in order; the last one is current. */
+        plans: Plan[];
+        steps: Step[];
+        inputs: Input[];
+        log: LogEntry[];
+    };
+    type ProductSeed = {
+        slug: string;
+        name: string;
+        guide?: string;
+    };
+    type InputSeed = {
+        kind?: InputKind;
+        preset?: string;
+        prompt: string;
+        placeholder?: string;
+        options?: ChoiceOption[];
+        multiple?: true;
+        product?: string;
+        default?: string;
+        help?: InputHelp;
+        optional?: boolean;
+    };
+    type PlanDecision = {
+        decision: "approve";
+    } | {
+        decision: "revise";
+        feedback: string;
+    };
+    type Commands = {
+        "checkout/create": (params: {
+            id: string;
+            products: ProductSeed[];
+            instructions?: string;
+        }) => void;
+        "checkout/begin-plan": () => void;
+        "checkout/answer": (params: {
+            inputId: string;
+            answer: string;
+            note?: string;
+        }) => void;
+        "checkout/add-product": (params: {
+            inputId: string;
+            product: ProductSeed;
+        }) => void;
+        "checkout/message": (params: {
+            text: string;
+        }) => void;
+        "agent/ack": (params: {
+            messageId: string;
+        }) => void;
+        "checkout/dismiss": (params: {
+            inputId: string;
+        }) => void;
+        "checkout/plan": (params: PlanDecision) => void;
+        /** A cancel that names another checkout than the current one is a no-op. */
+        "checkout/cancel": (params?: {
+            id?: string;
+        }) => void;
+        "checkout/finish": () => void;
+        "agent/intro": (params: {
+            kind?: string;
+        }) => void;
+        "agent/hello": (params: {
+            cwd?: string;
+            kind?: string;
+        }) => void;
+        "agent/heartbeat": () => void;
+        "agent/bye": () => void;
+        "agent/plan": (params: {
+            markdown: string;
+        }) => {
+            revision: number;
+        };
+        "agent/add-step": (params: {
+            title: string;
+            detail?: string;
+            product?: string;
+            /** Start the step in the same call. */
+            active?: boolean;
+        }) => {
+            stepId: string;
+        };
+        "agent/step": (params: {
+            stepId: string;
+            status: StepStatus;
+            note?: string;
+        }) => void;
+        "agent/ask": (params: InputSeed & {
+            stepId?: string;
+        }) => {
+            inputId: string;
+        };
+        "agent/log": (params: {
+            text: string;
+        }) => void;
+        "agent/done": (params?: {
+            summary?: string;
+            preview?: string;
+        }) => void;
+    };
+    type RejectionReason = "already-created" | "not-created" | "closed" | "planning-not-started" | "plan-required" | "no-plan" | "plan-decided" | "finish-not-proposed" | "feedback-required" | "empty-plan" | "unknown-step" | "unknown-product" | "unknown-input" | "input-closed" | "invalid-input" | "invalid-answer" | "invalid-preview" | "empty-message" | "unknown-message";
 }
-declare const AGENT_PRESENCE_MS = 15000;
-declare const AGENT_HEARTBEAT_MS = 5000;
-declare const initialCheckoutState: () => Checkout.State;
-declare const isAgentPresent: (state: Checkout.State, now?: number) => boolean;
-declare const isClosed: (state: Checkout.State) => boolean;
+export declare const AGENT_PRESENCE_MS = 15000;
+export declare const AGENT_HEARTBEAT_MS = 5000;
+export declare const initialCheckoutState: () => Checkout.State;
+export declare const isAgentPresent: (state: Checkout.State, now?: number) => boolean;
+export declare const isClosed: (state: Checkout.State) => boolean;
 /** True while the agent's proposal to close waits for the user. */
-declare const finishProposed: (state: Checkout.State) => boolean;
-/** True when the user messaged the agent after it last proposed to close. */
-declare const followedUpSinceProposal: (state: Checkout.State) => boolean;
+export declare const finishProposed: (state: Checkout.State) => boolean;
+/** True while a message the user sent after the agent proposed to close still waits for the agent. */
+export declare const followedUpSinceProposal: (state: Checkout.State) => boolean;
 /**
  * The URL a preview names, or `undefined` unless it is an http(s) URL on this
  * machine's loopback interface. The browser opens it, so nothing else passes.
  */
-declare const parsePreviewUrl: (value: string | undefined) => URL | undefined;
-declare const openInputs: (state: Checkout.State) => Checkout.Input[];
+export declare const parsePreviewUrl: (value: string | undefined) => URL | undefined;
+export declare const openInputs: (state: Checkout.State) => Checkout.Input[];
 /** The current plan revision, or `undefined` before the agent proposed one. */
-declare const currentPlan: (state: Checkout.State) => Checkout.Plan | undefined;
+export declare const currentPlan: (state: Checkout.State) => Checkout.Plan | undefined;
 /** True while a proposed plan waits for the user's decision. */
-declare const planNeedsReview: (state: Checkout.State) => boolean;
+export declare const planNeedsReview: (state: Checkout.State) => boolean;
 /** The icons an agent can put on its own options, by name. */
-declare const OPTION_ICONS: readonly ["code", "terminal", "braces", "git-branch", "package", "database", "server", "cloud", "globe", "monitor", "smartphone", "key", "lock", "shield", "brain", "sparkles", "bot", "workflow", "file", "folder", "book", "table", "image", "video", "mic", "speech", "paperclip", "message", "mail", "bell", "calendar", "clock", "user", "users", "settings", "wrench", "plug", "link", "palette", "search", "zap", "check", "question"];
-type OptionIcon = (typeof OPTION_ICONS)[number];
-declare const isOptionIcon: (value: string) => value is OptionIcon;
-declare const parseChoiceAnswer: (answer: string) => {
-  variant?: string;
-  option: string;
+export declare const OPTION_ICONS: readonly ["code", "terminal", "braces", "git-branch", "package", "database", "server", "cloud", "globe", "monitor", "smartphone", "key", "lock", "shield", "brain", "sparkles", "bot", "workflow", "file", "folder", "book", "table", "image", "video", "mic", "speech", "paperclip", "message", "mail", "bell", "calendar", "clock", "user", "users", "settings", "wrench", "plug", "link", "palette", "search", "zap", "check", "question"];
+export type OptionIcon = (typeof OPTION_ICONS)[number];
+export declare const isOptionIcon: (value: string) => value is OptionIcon;
+export declare const parseChoiceAnswer: (answer: string) => {
+    variant?: string;
+    option: string;
 };
 /** The entries of a multiple choice answer, or `undefined` when the text is not a JSON array of strings. */
-declare const parseMultipleAnswer: (answer: string) => string[] | undefined;
+export declare const parseMultipleAnswer: (answer: string) => string[] | undefined;
 type ChoiceAnswerKind = "option" | "custom" | "invalid";
 /**
  * "option" when `answer` names one of the input's options (with a variant
@@ -275,15 +290,17 @@ type ChoiceAnswerKind = "option" | "custom" | "invalid";
  * multiple choice is classified entry by entry: "invalid" when any entry is
  * or the array is empty, "custom" when any entry is the user's own text.
  */
-declare const classifyChoiceAnswer: (input: Checkout.Input, answer: string) => ChoiceAnswerKind;
+export declare const classifyChoiceAnswer: (input: Checkout.Input, answer: string) => ChoiceAnswerKind;
+export declare const parseEntryPointOptions: (value: unknown) => Checkout.EntryPointOption[] | undefined;
+export declare const isValidEntryPointInput: (input: Checkout.InputSeed) => boolean;
+export declare const isValidEntryPointAnswer: (input: Checkout.Input, answer: string) => boolean;
 /** The model answer an input holds, or `undefined` when the text is not one. */
-declare const parseModelAnswer: (answer: string) => Checkout.ModelAnswer | undefined;
+export declare const parseModelAnswer: (answer: string) => Checkout.ModelAnswer | undefined;
 /** Whether `answer` is a model answer naming one of the input's providers. */
-declare const isValidModelAnswer: (input: Checkout.Input, answer: string) => boolean;
-declare const stepProgress: (state: Checkout.State) => {
-  total: number;
-  done: number;
+export declare const isValidModelAnswer: (input: Checkout.Input, answer: string) => boolean;
+export declare const stepProgress: (state: Checkout.State) => {
+    total: number;
+    done: number;
 };
-//#endregion
-export { AGENT_HEARTBEAT_MS, AGENT_PRESENCE_MS, Checkout, OPTION_ICONS, OptionIcon, classifyChoiceAnswer, currentPlan, finishProposed, followedUpSinceProposal, initialCheckoutState, isAgentPresent, isClosed, isOptionIcon, isValidModelAnswer, openInputs, parseChoiceAnswer, parseModelAnswer, parseMultipleAnswer, parsePreviewUrl, planNeedsReview, stepProgress };
+export {};
 //# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","names":[],"sources":["../src/protocol.ts"],"mappings":";kBAAiB;OACH;;OAQA;IACV;IACA;IACA;IACA,QAAQ;IACR;;IAEA;IACA;;OAGU;IACV;IACA;;IAEA;;OAGU;;;;;;OAOA;OAEA;IAAkB;IAAY;;OAE9B;IACV;IACA;IACA;;IAEA;;IAEA,WAAW;;;OAID;IAAc;IAAiB;;;;;;;OAO/B;IACV;IACA;IACA;;;;;;;;OASU;IACV,OAAO;IACP;IACA,MAAM;;IAEN;IACA;IACA;IACA,UAAU;;IAEV;;IAEA;IACA;IACA,OAAO;IACP;IACA,QAAQ;IACR;;IAEA;IACA;IACA;IACA;;OAGU;IACV,OAAO;IACP;IACA;IACA;IACA;IACA;;IAEA;;OAGU;;OAGA;IACV;IACA;IACA,QAAQ;IACR;IACA;;IAEA;;;;;;OAOU;;;;;;;OAaA;IAAe;IAAoB;;OAEnC;IACV;;IAEA;IACA,QAAQ;IACR,aAAa;IACb;IACA,UAAU;IACV;IACA;MACE;;MAEA;MACA;;MAEA;;MAEA;;;IAGF,OAAO;IACP,OAAO;IACP,QAAQ;IACR,KAAK;;OAGK;IAAgB;IAAc;IAAc;;OAE5C;IACV,OAAO;IACP;IACA;IACA;IACA,UAAU;IACV;IACA;IACA;IACA,OAAO;IACP;;OAGU;IACN;;IACA;IAAoB;;OAEd;IACV,oBAAoB;MAClB;MACA,UAAU;MACV;;IAEF;IACA,oBAAoB;MAClB;MACA;MACA;;IAEF,yBAAyB;MACvB;MACA,SAAS;;IAEX,qBAAqB;MAAU;;IAC/B,cAAc;MAAU;;IACxB,qBAAqB;MAAU;;IAC/B,kBAAkB,QAAQ;IAC1B;IACA;IACA,gBAAgB;MAAU;;IAC1B,gBAAgB;MAAU;MAAc;;IACxC;IACA;IACA,eAAe;MAAU;;MAAyB;;IAClD,mBAAmB;MACjB;MACA;MACA;;MAEA;;MACM;;IACR,eAAe;MACb;MACA,QAAQ;MACR;;IAEF,cAAc,QAAQ;MAAc;;MAClC;;IAEF,cAAc;MAAU;;IACxB,eAAe;MAAW;MAAkB;;;OAGlC;;cAsBD;cACA;cAEA,4BAA2B,SAAS;cAoBpC,iBAAkB,OAAO,SAAS,OAAO;cAKzC,WAAY,OAAO,SAAS;;cAI5B,iBAAkB,OAAO,SAAS;;cAIlC,0BAA2B,OAAO,SAAS;;;;;cAc3C,kBAAmB,8BAAyB;cAe5C,aAAc,OAAO,SAAS,UAAK,SAAA;;cAInC,cAAe,OAAO,SAAS,UAAQ,SAAS;;cAIhD,kBAAmB,OAAO,SAAS;;cAInC;KA8CD,qBAAqB;cAEpB,eAAgB,kBAAgB,SAAS;cAGzC,oBAAqB;;;;;cAMrB,sBAAuB;KAa/B;;;;;;;;cAwBQ,uBACX,OAAO,SAAS,OAChB,mBACC;;cAiBU,mBACX,mBACC,SAAS;;cAuBC,qBAAsB,OAAO,SAAS,OAAO;cAQ7C,eAAgB,OAAO,SAAS"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js

@@ -24,10 +24,10 @@ const isAgentPresent = (state, now = Date.now()) => state.agent.connected && sta
 const isClosed = (state) => state.status === "done" || state.status === "cancelled";
 /** True while the agent's proposal to close waits for the user. */
 const finishProposed = (state) => !isClosed(state) && state.completion !== void 0;
-/** True when the user messaged the agent after it last proposed to close. */
+/** True while a message the user sent after the agent proposed to close still waits for the agent. */
 const followedUpSinceProposal = (state) => {
 	const proposedAt = state.completion?.proposedAt;
-	return proposedAt !== void 0 && state.log.some((entry) => entry.role === "user" && entry.at > proposedAt);
+	return proposedAt !== void 0 && state.log.some((entry) => entry.role === "user" && entry.at > proposedAt && entry.acknowledgedAt === void 0);
 };
 const LOOPBACK_HOSTS = /* @__PURE__ */ new Set([
 	"localhost",
@@ -103,7 +103,9 @@ const OPTION_ICONS = [
 ];
 const isOptionIcon = (value) => OPTION_ICONS.includes(value);
 const parseChoiceAnswer = (answer) => {
-	const [option = "", variant] = answer.split(":", 2);
+	const parts = answer.split(":");
+	if (parts.length > 2) return { option: answer };
+	const [option = "", variant] = parts;
 	return {
 		option,
 		...variant !== void 0 && { variant }
@@ -141,6 +143,35 @@ const classifyChoiceAnswer = (input, answer) => {
 	if (kinds.includes("invalid")) return "invalid";
 	return kinds.includes("custom") ? "custom" : "option";
 };
+const isEntryPointText = (value, max) => typeof value === "string" && value.trim() !== "" && value.length <= max;
+const parseEntryPointOptions = (value) => {
+	if (!Array.isArray(value) || value.length < 1 || value.length > 3) return void 0;
+	const options = [];
+	for (const candidate of value) {
+		if (typeof candidate !== "object" || candidate === null) return void 0;
+		const { id, label, description, entryPoint, variants } = candidate;
+		if (typeof id !== "string" || !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$/.test(id) || options.some((option) => option.id === id) || !isEntryPointText(label, 160) || !isEntryPointText(description, 1e3) || variants !== void 0 || typeof entryPoint !== "object" || entryPoint === null) return void 0;
+		const { formFactor, placement, trigger, recommended } = entryPoint;
+		if (formFactor !== "modal" && formFactor !== "sidebar" && formFactor !== "full-page" || !isEntryPointText(placement, 400) || !isEntryPointText(trigger, 400) || recommended !== void 0 && typeof recommended !== "boolean") return void 0;
+		options.push({
+			id,
+			label,
+			description,
+			entryPoint: {
+				formFactor,
+				placement,
+				trigger,
+				...recommended !== void 0 && { recommended }
+			}
+		});
+	}
+	return options.filter((option) => option.entryPoint.recommended).length <= 1 ? options : void 0;
+};
+const isValidEntryPointInput = (input) => {
+	const options = parseEntryPointOptions(input.options);
+	return input.kind === "entry-point" && isEntryPointText(input.prompt, 1e3) && options !== void 0 && input.multiple === void 0 && input.help === void 0 && (input.default === void 0 || options.some((option) => option.id === input.default));
+};
+const isValidEntryPointAnswer = (input, answer) => input.options?.some((option) => option.id === answer) ?? false;
 const REASONING_EFFORTS = /* @__PURE__ */ new Set([
 	"low",
 	"medium",
@@ -179,6 +210,6 @@ const stepProgress = (state) => ({
 	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, isValidModelAnswer, openInputs, parseChoiceAnswer, parseModelAnswer, parseMultipleAnswer, parsePreviewUrl, planNeedsReview, stepProgress };
+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 };
 
 //# sourceMappingURL=protocol.js.map