@getpaseo/protocol 0.1.84

package/dist/provider-config.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import { AgentProviderSchema } from "./provider-manifest.js";
+const ProviderCommandDefaultSchema = z
+    .object({
+    mode: z.literal("default"),
+})
+    .strict();
+const ProviderCommandAppendSchema = z
+    .object({
+    mode: z.literal("append"),
+    args: z.array(z.string()).optional(),
+})
+    .strict();
+const ProviderCommandReplaceSchema = z
+    .object({
+    mode: z.literal("replace"),
+    argv: z.array(z.string().min(1)).min(1),
+})
+    .strict();
+export const ProviderCommandSchema = z.discriminatedUnion("mode", [
+    ProviderCommandDefaultSchema,
+    ProviderCommandAppendSchema,
+    ProviderCommandReplaceSchema,
+]);
+export const ProviderRuntimeSettingsSchema = z
+    .object({
+    command: ProviderCommandSchema.optional(),
+    env: z.record(z.string()).optional(),
+    disallowedTools: z.array(z.string()).optional(),
+})
+    .strict();
+const ProviderProfileThinkingOptionSchema = z
+    .object({
+    id: z.string(),
+    label: z.string(),
+    description: z.string().optional(),
+    isDefault: z.boolean().optional(),
+})
+    .strict();
+export const ProviderProfileModelSchema = z
+    .object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    description: z.string().optional(),
+    isDefault: z.boolean().optional(),
+    thinkingOptions: z.array(ProviderProfileThinkingOptionSchema).optional(),
+})
+    .strict();
+export const ProviderOverrideSchema = z
+    .object({
+    extends: z.string().optional(),
+    label: z.string().optional(),
+    description: z.string().optional(),
+    command: z.array(z.string().min(1)).min(1).optional(),
+    env: z.record(z.string()).optional(),
+    models: z.array(ProviderProfileModelSchema).optional(),
+    additionalModels: z.array(ProviderProfileModelSchema).optional(),
+    disallowedTools: z.array(z.string()).optional(),
+    enabled: z.boolean().optional(),
+    order: z.number().optional(),
+})
+    .strict();
+const BUILTIN_PROVIDER_IDS = ["claude", "codex", "copilot", "opencode", "pi"];
+const PROVIDER_ID_PATTERN = /^[a-z][a-z0-9-]*$/;
+export const ProviderOverridesSchema = z
+    .record(ProviderOverrideSchema)
+    .superRefine((providers, ctx) => {
+    const builtinProviderIdSet = new Set(BUILTIN_PROVIDER_IDS);
+    const validExtendsValues = new Set([...BUILTIN_PROVIDER_IDS, "acp"]);
+    for (const [providerId, provider] of Object.entries(providers)) {
+        if (!PROVIDER_ID_PATTERN.test(providerId)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [providerId],
+                message: `Provider ID "${providerId}" must match ${PROVIDER_ID_PATTERN}.`,
+            });
+        }
+        const isBuiltinProvider = builtinProviderIdSet.has(providerId);
+        if (!isBuiltinProvider && !provider.extends) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [providerId, "extends"],
+                message: `Custom provider "${providerId}" must declare extends.`,
+            });
+        }
+        if (!isBuiltinProvider && !provider.label) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [providerId, "label"],
+                message: `Custom provider "${providerId}" must declare label.`,
+            });
+        }
+        if (provider.extends && !validExtendsValues.has(provider.extends)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [providerId, "extends"],
+                message: `Provider "${providerId}" extends unknown provider "${provider.extends}".`,
+            });
+        }
+        if (provider.extends === "acp" && !provider.command) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [providerId, "command"],
+                message: `Provider "${providerId}" extending "acp" must declare command.`,
+            });
+        }
+    }
+});
+export const AgentProviderRuntimeSettingsMapSchema = z
+    .record(ProviderRuntimeSettingsSchema)
+    .superRefine((providers, ctx) => {
+    for (const providerId of Object.keys(providers)) {
+        const parsedProviderId = AgentProviderSchema.safeParse(providerId);
+        if (!parsedProviderId.success) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [providerId],
+                message: `Invalid agent provider "${providerId}".`,
+            });
+        }
+    }
+});
+//# sourceMappingURL=provider-config.js.map

package/dist/provider-manifest.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import type { AgentMode } from "./agent-types.js";
+export type AgentModeColorTier = "safe" | "moderate" | "dangerous" | "planning" | `#${string}`;
+export type AgentModeIcon = string;
+export interface AgentModeVisuals {
+    icon: AgentModeIcon;
+    colorTier: AgentModeColorTier;
+}
+export type AgentProviderModeDefinition = Omit<AgentMode, "icon" | "colorTier"> & AgentModeVisuals & {
+    isUnattended?: boolean;
+};
+export interface AgentProviderDefinition {
+    id: string;
+    label: string;
+    description: string;
+    defaultModeId: string | null;
+    modes: AgentProviderModeDefinition[];
+    voice?: {
+        enabled: boolean;
+        defaultModeId: string;
+        defaultModel?: string;
+    };
+}
+export declare const AGENT_PROVIDER_DEFINITIONS: AgentProviderDefinition[];
+export declare const DEV_AGENT_PROVIDER_DEFINITIONS: AgentProviderDefinition[];
+export declare function getAgentProviderDefinition(provider: string, definitions?: AgentProviderDefinition[]): AgentProviderDefinition;
+export declare const BUILTIN_PROVIDER_IDS: string[];
+export declare const AGENT_PROVIDER_IDS: string[];
+export declare const AgentProviderSchema: z.ZodString;
+export declare function isValidAgentProvider(value: string, validIds?: Iterable<string>): boolean;
+export declare function getUnattendedModeId(provider: string, definitions?: AgentProviderDefinition[]): string | undefined;
+export declare function getModeVisuals(provider: string, modeId: string, definitions: AgentProviderDefinition[]): AgentModeVisuals | undefined;
+//# sourceMappingURL=provider-manifest.d.ts.map

package/dist/provider-manifest.js

@@ -0,0 +1,219 @@
+import { z } from "zod";
+const CLAUDE_MODES = [
+    {
+        id: "default",
+        label: "Always Ask",
+        description: "Prompts for permission the first time a tool is used",
+        icon: "ShieldCheck",
+        colorTier: "safe",
+    },
+    {
+        id: "auto",
+        label: "Auto mode",
+        description: "Uses a model classifier to review permission prompts automatically",
+        icon: "ShieldQuestionMark",
+        colorTier: "moderate",
+    },
+    {
+        id: "acceptEdits",
+        label: "Accept File Edits",
+        description: "Automatically approves edit-focused tools without prompting",
+        icon: "ShieldAlert",
+        colorTier: "moderate",
+    },
+    {
+        id: "plan",
+        label: "Plan Mode",
+        description: "Analyze the codebase without executing tools or edits",
+        icon: "ShieldCheck",
+        colorTier: "planning",
+    },
+    {
+        id: "bypassPermissions",
+        label: "Bypass",
+        description: "Skip all permission prompts (use with caution)",
+        icon: "ShieldAlert",
+        colorTier: "dangerous",
+        isUnattended: true,
+    },
+];
+const CODEX_MODES = [
+    {
+        id: "auto",
+        label: "Default Permissions",
+        description: "Edit files and run commands with Codex's default approval flow.",
+        icon: "ShieldAlert",
+        colorTier: "moderate",
+    },
+    {
+        id: "auto-review",
+        label: "Auto-review",
+        description: "Same workspace-write permissions as Default, but eligible `on-request` approvals are routed through the auto-reviewer subagent.",
+        icon: "ShieldQuestionMark",
+        colorTier: "moderate",
+    },
+    {
+        id: "full-access",
+        label: "Full Access",
+        description: "Edit files, run commands, and access the network without additional prompts.",
+        icon: "ShieldAlert",
+        colorTier: "dangerous",
+        isUnattended: true,
+    },
+];
+const COPILOT_MODES = [
+    {
+        id: "https://agentclientprotocol.com/protocol/session-modes#agent",
+        label: "Agent",
+        description: "Default agent mode for conversational interactions",
+        icon: "ShieldAlert",
+        colorTier: "moderate",
+    },
+    {
+        id: "https://agentclientprotocol.com/protocol/session-modes#plan",
+        label: "Plan",
+        description: "Plan mode for creating and executing multi-step plans",
+        icon: "ShieldCheck",
+        colorTier: "planning",
+    },
+    {
+        id: "allow-all",
+        label: "Allow All",
+        description: "Automatically approves all Copilot tool, path, and URL requests.",
+        icon: "ShieldOff",
+        colorTier: "dangerous",
+        isUnattended: true,
+    },
+];
+const OPENCODE_MODES = [
+    {
+        id: "build",
+        label: "Build",
+        description: "Allows edits and tool execution for implementation work",
+        icon: "Bot",
+        colorTier: "moderate",
+    },
+    {
+        id: "plan",
+        label: "Plan",
+        description: "Read-only planning mode that avoids file edits",
+        icon: "Bot",
+        colorTier: "planning",
+    },
+];
+const MOCK_LOAD_TEST_MODES = [
+    {
+        id: "load-test",
+        label: "Load Test",
+        description: "Streams repeated markdown, reasoning, and tool calls for app stress testing",
+        icon: "ShieldOff",
+        colorTier: "dangerous",
+    },
+];
+const MOCK_SLOW_MODES = [
+    {
+        id: "default",
+        label: "Default",
+        description: "Dev-only mode for the mock slow provider",
+        icon: "ShieldOff",
+        colorTier: "dangerous",
+    },
+];
+export const AGENT_PROVIDER_DEFINITIONS = [
+    {
+        id: "claude",
+        label: "Claude",
+        description: "Anthropic's multi-tool assistant with MCP support, streaming, and deep reasoning",
+        defaultModeId: "default",
+        modes: CLAUDE_MODES,
+        voice: {
+            enabled: true,
+            defaultModeId: "default",
+            defaultModel: "haiku",
+        },
+    },
+    {
+        id: "codex",
+        label: "Codex",
+        description: "OpenAI's Codex workspace agent with sandbox controls and optional network access",
+        defaultModeId: "auto",
+        modes: CODEX_MODES,
+        voice: {
+            enabled: true,
+            defaultModeId: "auto",
+            defaultModel: "gpt-5.4-mini",
+        },
+    },
+    {
+        id: "copilot",
+        label: "Copilot",
+        description: "GitHub Copilot via Agent Client Protocol with dynamic modes and session support",
+        defaultModeId: "https://agentclientprotocol.com/protocol/session-modes#agent",
+        modes: COPILOT_MODES,
+    },
+    {
+        id: "opencode",
+        label: "OpenCode",
+        description: "Open-source coding assistant with multi-provider model support",
+        defaultModeId: "build",
+        modes: OPENCODE_MODES,
+        voice: {
+            enabled: true,
+            defaultModeId: "build",
+        },
+    },
+    {
+        id: "pi",
+        label: "Pi",
+        description: "Minimal terminal-based coding agent with multi-provider LLM support",
+        defaultModeId: null,
+        modes: [],
+    },
+];
+export const DEV_AGENT_PROVIDER_DEFINITIONS = [
+    {
+        id: "mock",
+        label: "Mock Load Test",
+        description: "Development-only provider that emits synthetic agent traffic for performance tests",
+        defaultModeId: "load-test",
+        modes: MOCK_LOAD_TEST_MODES,
+    },
+    {
+        id: "mock-slow",
+        label: "Mock Slow Provider",
+        description: "Dev-only: hangs during model discovery to test loading and timeout UI",
+        defaultModeId: "default",
+        modes: MOCK_SLOW_MODES,
+    },
+];
+export function getAgentProviderDefinition(provider, definitions = [
+    ...AGENT_PROVIDER_DEFINITIONS,
+    ...DEV_AGENT_PROVIDER_DEFINITIONS,
+]) {
+    const definition = definitions.find((entry) => entry.id === provider);
+    if (!definition) {
+        throw new Error(`Unknown agent provider: ${provider}`);
+    }
+    return definition;
+}
+export const BUILTIN_PROVIDER_IDS = AGENT_PROVIDER_DEFINITIONS.map((d) => d.id);
+export const AGENT_PROVIDER_IDS = BUILTIN_PROVIDER_IDS;
+export const AgentProviderSchema = z.string();
+export function isValidAgentProvider(value, validIds = BUILTIN_PROVIDER_IDS) {
+    return Array.isArray(validIds) ? validIds.includes(value) : new Set(validIds).has(value);
+}
+export function getUnattendedModeId(provider, definitions = [
+    ...AGENT_PROVIDER_DEFINITIONS,
+    ...DEV_AGENT_PROVIDER_DEFINITIONS,
+]) {
+    const definition = definitions.find((entry) => entry.id === provider);
+    return definition?.modes.find((mode) => mode.isUnattended)?.id;
+}
+export function getModeVisuals(provider, modeId, definitions) {
+    const definition = definitions.find((entry) => entry.id === provider);
+    const mode = definition?.modes.find((m) => m.id === modeId);
+    if (!mode)
+        return undefined;
+    return { icon: mode.icon, colorTier: mode.colorTier };
+}
+//# sourceMappingURL=provider-manifest.js.map