@getpaseo/protocol 0.3.0-beta.1 → 0.3.0-beta.3

package/dist/host-connection-schema.d.ts

@@ -5,6 +5,7 @@ export declare const DirectTcpHostConnectionSchema: z.ZodObject<{
     endpoint: z.ZodString;
     useTls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     password: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export type DirectTcpHostConnection = z.input<typeof DirectTcpHostConnectionSchema>;
 export type NormalizedDirectTcpHostConnection = z.output<typeof DirectTcpHostConnectionSchema>;

package/dist/host-connection-schema.js

@@ -5,5 +5,6 @@ export const DirectTcpHostConnectionSchema = z.object({
     endpoint: z.string(),
     useTls: z.boolean().optional().default(false),
     password: z.string().optional(),
+    headers: z.record(z.string(), z.string()).optional(),
 });
 //# sourceMappingURL=host-connection-schema.js.map

package/dist/messages.d.ts

@@ -158,6 +158,8 @@ export declare const ProviderSnapshotEntrySchema: z.ZodObject<{
     models: z.ZodOptional<z.ZodArray<z.ZodObject<{
         provider: z.ZodString;
         id: z.ZodString;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isSelectable: z.ZodOptional<z.ZodBoolean>;
         label: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -184,6 +186,8 @@ export declare const CompactProviderSnapshotModelSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
     isDefault: z.ZodOptional<z.ZodBoolean>;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    isSelectable: z.ZodOptional<z.ZodBoolean>;
     contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
     defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
     thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -218,6 +222,8 @@ export declare const CompactProviderSnapshotEntrySchema: z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
         isDefault: z.ZodOptional<z.ZodBoolean>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isSelectable: z.ZodOptional<z.ZodBoolean>;
         contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
         defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
         thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -244,6 +250,8 @@ export declare const CompactProviderSnapshotSchema: z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
             isDefault: z.ZodOptional<z.ZodBoolean>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isSelectable: z.ZodOptional<z.ZodBoolean>;
             contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
             defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
             thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -12361,6 +12369,8 @@ export declare const ListProviderModelsResponseMessageSchema: z.ZodObject<{
         models: z.ZodOptional<z.ZodArray<z.ZodObject<{
             provider: z.ZodString;
             id: z.ZodString;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isSelectable: z.ZodOptional<z.ZodBoolean>;
             label: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -12451,6 +12461,8 @@ export declare const GetProvidersSnapshotResponseMessageSchema: z.ZodObject<{
             models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 provider: z.ZodString;
                 id: z.ZodString;
+                aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                isSelectable: z.ZodOptional<z.ZodBoolean>;
                 label: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
                 isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -12492,6 +12504,8 @@ export declare const GetProvidersSnapshotResponseMessageSchema: z.ZodObject<{
                     id: z.ZodString;
                     label: z.ZodString;
                     isDefault: z.ZodOptional<z.ZodBoolean>;
+                    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    isSelectable: z.ZodOptional<z.ZodBoolean>;
                     contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
                     defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
                     thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -12530,6 +12544,8 @@ export declare const ProvidersSnapshotUpdateMessageSchema: z.ZodObject<{
             models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 provider: z.ZodString;
                 id: z.ZodString;
+                aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                isSelectable: z.ZodOptional<z.ZodBoolean>;
                 label: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
                 isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -12571,6 +12587,8 @@ export declare const ProvidersSnapshotUpdateMessageSchema: z.ZodObject<{
                     id: z.ZodString;
                     label: z.ZodString;
                     isDefault: z.ZodOptional<z.ZodBoolean>;
+                    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    isSelectable: z.ZodOptional<z.ZodBoolean>;
                     contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
                     defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
                     thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -19618,6 +19636,8 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         models: z.ZodOptional<z.ZodArray<z.ZodObject<{
             provider: z.ZodString;
             id: z.ZodString;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isSelectable: z.ZodOptional<z.ZodBoolean>;
             label: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -19704,6 +19724,8 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
             models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 provider: z.ZodString;
                 id: z.ZodString;
+                aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                isSelectable: z.ZodOptional<z.ZodBoolean>;
                 label: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
                 isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -19745,6 +19767,8 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
                     id: z.ZodString;
                     label: z.ZodString;
                     isDefault: z.ZodOptional<z.ZodBoolean>;
+                    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    isSelectable: z.ZodOptional<z.ZodBoolean>;
                     contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
                     defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
                     thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -19782,6 +19806,8 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
             models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 provider: z.ZodString;
                 id: z.ZodString;
+                aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                isSelectable: z.ZodOptional<z.ZodBoolean>;
                 label: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
                 isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -19823,6 +19849,8 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
                     id: z.ZodString;
                     label: z.ZodString;
                     isDefault: z.ZodOptional<z.ZodBoolean>;
+                    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    isSelectable: z.ZodOptional<z.ZodBoolean>;
                     contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
                     defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
                     thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -29515,6 +29543,8 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 provider: z.ZodString;
                 id: z.ZodString;
+                aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                isSelectable: z.ZodOptional<z.ZodBoolean>;
                 label: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
                 isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -29601,6 +29631,8 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
                 models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     provider: z.ZodString;
                     id: z.ZodString;
+                    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    isSelectable: z.ZodOptional<z.ZodBoolean>;
                     label: z.ZodString;
                     description: z.ZodOptional<z.ZodString>;
                     isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -29642,6 +29674,8 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
                         id: z.ZodString;
                         label: z.ZodString;
                         isDefault: z.ZodOptional<z.ZodBoolean>;
+                        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        isSelectable: z.ZodOptional<z.ZodBoolean>;
                         contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
                         defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
                         thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -29679,6 +29713,8 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
                 models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     provider: z.ZodString;
                     id: z.ZodString;
+                    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    isSelectable: z.ZodOptional<z.ZodBoolean>;
                     label: z.ZodString;
                     description: z.ZodOptional<z.ZodString>;
                     isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -29720,6 +29756,8 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
                         id: z.ZodString;
                         label: z.ZodString;
                         isDefault: z.ZodOptional<z.ZodBoolean>;
+                        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        isSelectable: z.ZodOptional<z.ZodBoolean>;
                         contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
                         defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
                         thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -39076,6 +39114,8 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 provider: z.ZodString;
                 id: z.ZodString;
+                aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                isSelectable: z.ZodOptional<z.ZodBoolean>;
                 label: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
                 isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -39162,6 +39202,8 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     provider: z.ZodString;
                     id: z.ZodString;
+                    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    isSelectable: z.ZodOptional<z.ZodBoolean>;
                     label: z.ZodString;
                     description: z.ZodOptional<z.ZodString>;
                     isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -39203,6 +39245,8 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                         id: z.ZodString;
                         label: z.ZodString;
                         isDefault: z.ZodOptional<z.ZodBoolean>;
+                        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        isSelectable: z.ZodOptional<z.ZodBoolean>;
                         contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
                         defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
                         thinkingSet: z.ZodOptional<z.ZodNumber>;
@@ -39240,6 +39284,8 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 models: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     provider: z.ZodString;
                     id: z.ZodString;
+                    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    isSelectable: z.ZodOptional<z.ZodBoolean>;
                     label: z.ZodString;
                     description: z.ZodOptional<z.ZodString>;
                     isDefault: z.ZodOptional<z.ZodBoolean>;
@@ -39281,6 +39327,8 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                         id: z.ZodString;
                         label: z.ZodString;
                         isDefault: z.ZodOptional<z.ZodBoolean>;
+                        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        isSelectable: z.ZodOptional<z.ZodBoolean>;
                         contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
                         defaultThinkingOptionId: z.ZodOptional<z.ZodString>;
                         thinkingSet: z.ZodOptional<z.ZodNumber>;

package/dist/messages.js

@@ -147,6 +147,8 @@ export const AgentFeatureSchema = z.discriminatedUnion("type", [
 const AgentModelDefinitionSchema = z.object({
     provider: AgentProviderSchema,
     id: z.string(),
+    aliases: z.array(z.string()).optional(),
+    isSelectable: z.boolean().optional(),
     label: z.string(),
     description: z.string().optional(),
     isDefault: z.boolean().optional(),

package/dist/provider-manifest.js

@@ -133,6 +133,13 @@ const MOCK_LOAD_TEST_MODES = [
         icon: "ShieldOff",
         colorTier: "dangerous",
     },
+    {
+        id: "approval-test",
+        label: "Approval Test",
+        description: "Alternate development-only permission mode for preference tests",
+        icon: "ShieldCheck",
+        colorTier: "safe",
+    },
 ];
 const MOCK_SLOW_MODES = [
     {

package/dist/terminal-profiles.d.ts

@@ -1,5 +1,40 @@
 import type { TerminalProfile } from "./messages.js";
+/**
+ * Marks where a typed prompt goes inside a profile's `command` or `args`. A
+ * profile carrying it accepts a prompt; one without it launches as-is.
+ *
+ * Substitution happens client-side before `create_terminal_request` is sent, so
+ * this is profile-format vocabulary rather than anything on the wire. It lives
+ * here because this module owns what a `TerminalProfile` means.
+ */
+export declare const PROMPT_SENTINEL = "{{{prompt}}}";
 export declare const DEFAULT_TERMINAL_PROFILES: readonly TerminalProfile[];
+export interface SubstitutableCommand {
+    command: string;
+    args?: string[];
+}
+export interface ResolvedCommand {
+    command: string;
+    args: string[];
+}
+/** True when the sentinel appears anywhere in `command` or an `args` entry. */
+export declare function profileTakesPrompt(profile: SubstitutableCommand): boolean;
+/** Replaces every sentinel occurrence with `prompt`, dropping prompt-only args when there is none. */
+export declare function substitutePrompt(profile: SubstitutableCommand, prompt: string): ResolvedCommand;
+/** Human-readable preview of the resolved command, for read-only display. */
+export declare function formatResolvedCommand(resolved: ResolvedCommand): string;
+export interface TerminalProfileLaunch {
+    name: string;
+    command: string;
+    args: string[];
+}
+/**
+ * What to spawn for a profile. Every launcher goes through here, so no caller
+ * can forward a raw `profile.args` still carrying the sentinel: launchers with
+ * nowhere to type (pinned targets, the workspace terminal menu) pass an empty
+ * prompt and get the bare command back.
+ */
+export declare function resolveTerminalProfileLaunch(profile: TerminalProfile, prompt: string): TerminalProfileLaunch;
 export declare function guessTerminalProfileIcon(command: string): string | undefined;
 export declare function getTerminalProfileIcon(profile: TerminalProfile): string | undefined;
 export declare function resolveTerminalProfiles(terminalProfiles: TerminalProfile[] | undefined): readonly TerminalProfile[];

package/dist/terminal-profiles.js

@@ -1,9 +1,78 @@
 import { KNOWN_PROVIDER_ICON_NAMES } from "./provider-icon-names.js";
+/**
+ * Marks where a typed prompt goes inside a profile's `command` or `args`. A
+ * profile carrying it accepts a prompt; one without it launches as-is.
+ *
+ * Substitution happens client-side before `create_terminal_request` is sent, so
+ * this is profile-format vocabulary rather than anything on the wire. It lives
+ * here because this module owns what a `TerminalProfile` means.
+ */
+export const PROMPT_SENTINEL = "{{{prompt}}}";
+// Prompt forms are taken from each CLI's own `--help`. claude, codex, and pi
+// take the prompt as a trailing positional. opencode's positional is the
+// project directory, so its prompt goes through `--prompt`, written in the
+// `--flag=value` form to keep it one argv entry that can be dropped whole when
+// no prompt is typed.
 export const DEFAULT_TERMINAL_PROFILES = [
-    { id: "claude", name: "Claude Code", command: "claude", icon: "claude" },
-    { id: "codex", name: "Codex", command: "codex", icon: "codex" },
-    { id: "opencode", name: "OpenCode", command: "opencode", icon: "opencode" },
+    { id: "claude", name: "Claude Code", command: "claude", args: [PROMPT_SENTINEL], icon: "claude" },
+    { id: "codex", name: "Codex", command: "codex", args: [PROMPT_SENTINEL], icon: "codex" },
+    {
+        id: "opencode",
+        name: "OpenCode",
+        command: "opencode",
+        args: [`--prompt=${PROMPT_SENTINEL}`],
+        icon: "opencode",
+    },
+    { id: "pi", name: "Pi", command: "pi", args: [PROMPT_SENTINEL], icon: "pi" },
 ];
+function containsSentinel(value) {
+    return value.includes(PROMPT_SENTINEL);
+}
+/** True when the sentinel appears anywhere in `command` or an `args` entry. */
+export function profileTakesPrompt(profile) {
+    return containsSentinel(profile.command) || (profile.args ?? []).some(containsSentinel);
+}
+function replaceSentinel(value, prompt) {
+    return value.split(PROMPT_SENTINEL).join(prompt);
+}
+/**
+ * An arg that exists only to carry a prompt: the sentinel alone
+ * (`{{{prompt}}}`), or as the whole value of an option assignment
+ * (`--prompt={{{prompt}}}`). Both are dropped when there is no prompt, because
+ * an empty positional and a valueless `--prompt=` are not the same as omitting
+ * them. A sentinel embedded in larger text (`echo {{{prompt}}}`) is not
+ * prompt-only and still substitutes to empty.
+ *
+ * This is why an option and its value belong in one entry. Split across two,
+ * the option would survive with nothing to carry.
+ */
+function isPromptOnlyArg(arg) {
+    if (arg === PROMPT_SENTINEL) {
+        return true;
+    }
+    const separator = arg.indexOf("=");
+    return separator > 0 && arg.slice(separator + 1) === PROMPT_SENTINEL;
+}
+/** Replaces every sentinel occurrence with `prompt`, dropping prompt-only args when there is none. */
+export function substitutePrompt(profile, prompt) {
+    return {
+        command: replaceSentinel(profile.command, prompt),
+        args: (profile.args ?? []).flatMap((arg) => prompt === "" && isPromptOnlyArg(arg) ? [] : [replaceSentinel(arg, prompt)]),
+    };
+}
+/** Human-readable preview of the resolved command, for read-only display. */
+export function formatResolvedCommand(resolved) {
+    return [resolved.command, ...resolved.args].join(" ");
+}
+/**
+ * What to spawn for a profile. Every launcher goes through here, so no caller
+ * can forward a raw `profile.args` still carrying the sentinel: launchers with
+ * nowhere to type (pinned targets, the workspace terminal menu) pass an empty
+ * prompt and get the bare command back.
+ */
+export function resolveTerminalProfileLaunch(profile, prompt) {
+    return { name: profile.name, ...substitutePrompt(profile, prompt) };
+}
 const WELL_KNOWN_COMMAND_ICONS = new Map(KNOWN_PROVIDER_ICON_NAMES.map((name) => [name, name]));
 function getCommandBaseName(command) {
     const lastSlash = command.lastIndexOf("/");
@@ -19,10 +88,183 @@ export function guessTerminalProfileIcon(command) {
 export function getTerminalProfileIcon(profile) {
     return profile.icon ?? guessTerminalProfileIcon(profile.command);
 }
+// Base command name to the sentinel-bearing args that command wants, derived
+// from the shipped defaults rather than written out again, so adding a default
+// profile later cannot silently miss the adoption below or get the wrong form.
+const PROMPT_ARGS_BY_COMMAND = new Map(DEFAULT_TERMINAL_PROFILES.map((profile) => [
+    getCommandBaseName(profile.command),
+    (profile.args ?? []).filter(containsSentinel),
+]));
+// Adoption applies only to the interactive, prompt-taking form of each CLI.
+// These are the global options whose values would otherwise look positional
+// while walking argv. Unknown options stay conservative: a following bare arg
+// blocks adoption rather than risking a second prompt or changing a subcommand.
+const GLOBAL_OPTIONS_WITH_VALUES_BY_COMMAND = new Map([
+    [
+        "claude",
+        new Set([
+            "--add-dir",
+            "--agent",
+            "--agents",
+            "--allowed-tools",
+            "--allowedTools",
+            "--append-system-prompt",
+            "--betas",
+            "--debug-file",
+            "--disallowed-tools",
+            "--disallowedTools",
+            "--effort",
+            "--fallback-model",
+            "--file",
+            "--input-format",
+            "--json-schema",
+            "--max-budget-usd",
+            "--mcp-config",
+            "--model",
+            "--name",
+            "--output-format",
+            "--permission-mode",
+            "--plugin-dir",
+            "--plugin-url",
+            "--remote-control-session-name-prefix",
+            "--settings",
+            "--system-prompt",
+            "--system-prompt-file",
+            "--tools",
+            "-n",
+        ]),
+    ],
+    [
+        "codex",
+        new Set([
+            "--add-dir",
+            "--ask-for-approval",
+            "--cd",
+            "--config",
+            "--disable",
+            "--enable",
+            "--image",
+            "--local-provider",
+            "--model",
+            "--profile",
+            "--remote",
+            "--remote-auth-token-env",
+            "--sandbox",
+            "-C",
+            "-a",
+            "-c",
+            "-i",
+            "-m",
+            "-p",
+            "-s",
+        ]),
+    ],
+    [
+        "opencode",
+        new Set([
+            "--agent",
+            "--cors",
+            "--hostname",
+            "--log-level",
+            "--mdns-domain",
+            "--model",
+            "--port",
+            "--prompt",
+            "--replay-limit",
+            "--session",
+            "-m",
+            "-s",
+        ]),
+    ],
+    [
+        "pi",
+        new Set([
+            "--api-key",
+            "--append-system-prompt",
+            "--exclude-tools",
+            "--export",
+            "--extension",
+            "--fork",
+            "--mode",
+            "--model",
+            "--models",
+            "--name",
+            "--prompt-template",
+            "--provider",
+            "--session",
+            "--session-dir",
+            "--session-id",
+            "--skill",
+            "--system-prompt",
+            "--theme",
+            "--thinking",
+            "--tools",
+            "-e",
+            "-n",
+            "-t",
+            "-xt",
+        ]),
+    ],
+]);
+// Profiles predating the sentinel got materialized into user config the first
+// time anyone touched the profile list (host-page.tsx patches the whole list on
+// any add, edit, or reorder). Those users would otherwise be stuck with
+// launch-only versions of the agents we ship, while a fresh install gets prompt
+// support, so a profile still pointing at one of those agents adopts the
+// trailing sentinel on read.
+//
+// Keyed on the command's base name, not the profile id: profiles created
+// through the settings UI get generated ids (`profile_<timestamp>_<random>`),
+// so a real user's Codex profile is never id `codex`. The base name also
+// normalizes `/usr/local/bin/codex` and `codex.cmd` onto the same agent.
+//
+// User args are preserved: `codex --yolo` becomes `codex --yolo {{{prompt}}}`.
+// The appended form comes from the shipped default for that command, so
+// opencode gets `--prompt=` rather than a trailing positional, which it would
+// read as a project directory. A profile that already carries the sentinel
+// anywhere is left alone, and so is one pointing at any other command. Nothing
+// is written back, so this stays a read-time adoption with no version stamp and
+// no daemon-start hook.
+// Any positional means this is not the bare interactive form we can safely
+// adopt. It may be a subcommand (`codex --profile work login`) or an existing
+// prompt/project argument. Option assignments carry their value inline; known
+// split options consume the next argv entry before positional detection.
+function hasPositionalArg(command, args) {
+    const optionsWithValues = GLOBAL_OPTIONS_WITH_VALUES_BY_COMMAND.get(command) ?? new Set();
+    let expectsOptionValue = false;
+    for (const arg of args) {
+        if (expectsOptionValue) {
+            expectsOptionValue = false;
+            continue;
+        }
+        if (arg === "--") {
+            return true;
+        }
+        if (!arg.startsWith("-")) {
+            return true;
+        }
+        const separator = arg.indexOf("=");
+        const option = separator === -1 ? arg : arg.slice(0, separator);
+        expectsOptionValue = separator === -1 && optionsWithValues.has(option);
+    }
+    return false;
+}
+function adoptPromptSentinel(profile) {
+    const command = getCommandBaseName(profile.command);
+    const promptArgs = PROMPT_ARGS_BY_COMMAND.get(command);
+    if (!promptArgs || promptArgs.length === 0) {
+        return profile;
+    }
+    const args = profile.args ?? [];
+    if (profileTakesPrompt(profile) || hasPositionalArg(command, args)) {
+        return profile;
+    }
+    return { ...profile, args: [...args, ...promptArgs] };
+}
 export function resolveTerminalProfiles(terminalProfiles) {
     if (terminalProfiles === undefined) {
         return DEFAULT_TERMINAL_PROFILES;
     }
-    return terminalProfiles;
+    return terminalProfiles.map(adoptPromptSentinel);
 }
 //# sourceMappingURL=terminal-profiles.js.map

package/dist/validation/ws-outbound-schema-metadata.d.ts

@@ -6112,6 +6112,8 @@ export declare const WSOutboundMessageSchema: {
                 models: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                     provider: import("zod").ZodString;
                     id: import("zod").ZodString;
+                    aliases: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    isSelectable: import("zod").ZodOptional<import("zod").ZodBoolean>;
                     label: import("zod").ZodString;
                     description: import("zod").ZodOptional<import("zod").ZodString>;
                     isDefault: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -6198,6 +6200,8 @@ export declare const WSOutboundMessageSchema: {
                     models: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                         provider: import("zod").ZodString;
                         id: import("zod").ZodString;
+                        aliases: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                        isSelectable: import("zod").ZodOptional<import("zod").ZodBoolean>;
                         label: import("zod").ZodString;
                         description: import("zod").ZodOptional<import("zod").ZodString>;
                         isDefault: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -6239,6 +6243,8 @@ export declare const WSOutboundMessageSchema: {
                             id: import("zod").ZodString;
                             label: import("zod").ZodString;
                             isDefault: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                            aliases: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                            isSelectable: import("zod").ZodOptional<import("zod").ZodBoolean>;
                             contextWindowMaxTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
                             defaultThinkingOptionId: import("zod").ZodOptional<import("zod").ZodString>;
                             thinkingSet: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -6276,6 +6282,8 @@ export declare const WSOutboundMessageSchema: {
                     models: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                         provider: import("zod").ZodString;
                         id: import("zod").ZodString;
+                        aliases: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                        isSelectable: import("zod").ZodOptional<import("zod").ZodBoolean>;
                         label: import("zod").ZodString;
                         description: import("zod").ZodOptional<import("zod").ZodString>;
                         isDefault: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -6317,6 +6325,8 @@ export declare const WSOutboundMessageSchema: {
                             id: import("zod").ZodString;
                             label: import("zod").ZodString;
                             isDefault: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                            aliases: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                            isSelectable: import("zod").ZodOptional<import("zod").ZodBoolean>;
                             contextWindowMaxTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
                             defaultThinkingOptionId: import("zod").ZodOptional<import("zod").ZodString>;
                             thinkingSet: import("zod").ZodOptional<import("zod").ZodNumber>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/protocol",
-  "version": "0.3.0-beta.1",
+  "version": "0.3.0-beta.3",
   "description": "Paseo shared protocol schemas and wire types",
   "files": [
     "dist",