@adecore/agent-contracts 0.31.0 → 0.31.1

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { KNOWN_AGENT_KINDS, type KnownAgentKind, AGENT_KIND_MAX_LENGTH, AgentKin
 export { ChatIdSchema, type ChatId, ChatContextBreakdownSchema, type ChatContextBreakdown, ChatUsageSchema, type ChatUsage, CHAT_ATTACHMENTS_MAX_BYTES, CHAT_ATTACHMENT_MAX_BYTES, CHAT_ATTACHMENTS_MAX_COUNT, attachmentBytes, attachmentImageMime, ChatAttachmentUploadSchema, type ChatAttachmentUpload, ChatAttachmentUploadsSchema, ChatAttachmentSchema, type ChatAttachment, ChatUiChoiceOriginSchema, type ChatUiChoiceOrigin, ChatUiAnswerSchema, type ChatUiAnswer, ChatQuoteSourceSchema, type ChatQuoteSource, ChatQueuedMessageSchema, type ChatQueuedMessage, ChatBackgroundTaskSchema, type ChatBackgroundTask, ChatTurnLimitSchema, type ChatTurnLimit, ChatGoalStatusSchema, type ChatGoalStatus, ChatGoalSchema, type ChatGoal, ChatQuestionSchema, type ChatQuestion, ChatRequestKindSchema, type ChatRequestKind, CHAT_REQUEST_LIMITS, ChatRequestApprovalSchema, type ChatRequestApproval, ChatRequestSummarySchema, type ChatRequestSummary, ChatInfoSchema, type ChatInfo, ChatSkillSourceSchema, type ChatSkillSource, ChatSkillSchema, type ChatSkill, SkillsListPayloadSchema, type SkillsListPayload, SkillsListResultSchema, type SkillsListResult, ChatUserItemSchema, ChatUiQueryReadingSchema, type ChatUiQueryReading, ChatUiLinkReadingSchema, type ChatUiLinkReading, ChatUiPlaceReadingSchema, type ChatUiPlaceReading, ChatUiQueryStateSchema, type ChatUiQueryState, ChatAssistantItemSchema, ChatThinkingItemSchema, ChatToolStateSchema, type ChatToolState, ChatToolProgressSchema, type ChatToolProgress, ChatFileChangeSchema, type ChatFileChange, ChatSubagentStatusSchema, type ChatSubagentStatus, ChatWorkflowPhaseSchema, type ChatWorkflowPhase, ChatWorkflowAgentSchema, type ChatWorkflowAgent, ChatWorkflowSchema, type ChatWorkflow, workflowAgentRef, workflowAgentIdOf, ChatToolItemSchema, ChatSubagentUsageSchema, type ChatSubagentUsage, HOST_TASK_ORIGIN, ChatSubagentItemSchema, ChatApprovalDecisionSchema, type ChatApprovalDecision, ChatApprovalItemSchema, ChatQuestionItemSchema, ChatCheckpointFileSchema, type ChatCheckpointFile, ChatCheckpointDiffSchema, type ChatCheckpointDiff, ChatTurnItemSchema, notResumedNote, abortedByMachine, ENDED_NOTE_PREFIX, abortedByEnd, activeSubagents, WAITING_NOTE_PREFIX, ChatNoteItemSchema, ChatCompactionItemSchema, ChatItemSchema, type ChatItem, type ChatUserItem, type ChatAssistantItem, type ChatThinkingItem, type ChatToolItem, type ChatSubagentItem, type ChatApprovalItem, type ChatQuestionItem, type ChatTurnItem, type ChatNoteItem, type ChatCompactionItem, ChatEventSchema, type ChatEvent, ChatEventEnvelopeSchema, type ChatEventEnvelope, ChatCreatePayloadSchema, type ChatCreatePayload, ChatConfigurePayloadSchema, type ChatConfigurePayload, ChatPreferencesPayloadSchema, type ChatPreferencesPayload, ChatTargetPayloadSchema, type ChatTargetPayload, ChatClearPayloadSchema, type ChatClearPayload, ChatCancelPayloadSchema, type ChatCancelPayload, ChatAttachPayloadSchema, ChatHistoryPayloadSchema, ChatHistoryPageSchema, ChatHistoryResultSchema, type ChatHistoryResult, ChatSubagentPayloadSchema, type ChatSubagentPayload, ChatStopSubagentPayloadSchema, type ChatStopSubagentPayload, ChatGoalActionSchema, type ChatGoalAction, ChatGoalPayloadSchema, type ChatGoalPayload, ChatStopTaskPayloadSchema, type ChatStopTaskPayload, ChatSubagentPageSchema, ChatSubagentSourceSchema, type ChatSubagentSource, ChatSubagentResultSchema, type ChatSubagentResult, ChatStatusEventSchema, type ChatStatusEvent, ChatSubagentChangedEventSchema, type ChatSubagentChangedEvent, CHAT_BOOKMARK_LIMITS, ChatBookmarkSchema, type ChatBookmark, ChatBookmarksSchema, ChatAddBookmarkPayloadSchema, type ChatAddBookmarkPayload, ChatRenameBookmarkPayloadSchema, type ChatRenameBookmarkPayload, ChatRemoveBookmarkPayloadSchema, type ChatRemoveBookmarkPayload, ChatBookmarksResultSchema, type ChatBookmarksResult, ChatBookmarksEventSchema, type ChatBookmarksEvent, ChatRemoveVisualPayloadSchema, type ChatRemoveVisualPayload, ChatVisualsResultSchema, type ChatVisualsResult, ChatVisualsEventSchema, type ChatVisualsEvent, ChatAttachResultSchema, type ChatAttachResult, ChatDeliverySchema, type ChatDelivery, ChatSendPayloadSchema, type ChatSendPayload, ChatSendResultSchema, type ChatSendResult, ChatUiChoicePayloadSchema, type ChatUiChoicePayload, ChatUiQueryPayloadSchema, type ChatUiQueryPayload, ChatUiLinkPayloadSchema, type ChatUiLinkPayload, ChatQueuePayloadSchema, type ChatQueuePayload, ChatUnqueueResultSchema, type ChatUnqueueResult, ChatApprovePayloadSchema, type ChatApprovePayload, ChatDismissPayloadSchema, type ChatDismissPayload, ChatAnswerPayloadSchema, type ChatAnswerPayload, ChatTurnDiffPayloadSchema, type ChatTurnDiffPayload, ChatTurnDiffResultSchema, type ChatTurnDiffResult, CHAT_FORK_TITLE_MAX, ChatForkPayloadSchema, type ChatForkPayload, ChatForkResultSchema, type ChatForkResult, ChatContinueOnPayloadSchema, type ChatContinueOnPayload, ChatContinueOnResultSchema, type ChatContinueOnResult, ChatSummarizePayloadSchema, type ChatSummarizePayload, ChatSummarizeResultSchema, type ChatSummarizeResult, ChatForkInfoPayloadSchema, type ChatForkInfoPayload, ChatForkInfoResultSchema, type ChatForkInfoResult, ChatListResultSchema, type ChatListResult, GeneratedImageInputSchema, type GeneratedImageInput, generatedImageAttachment } from './chat.ts';
 export { ErrorSchema, type WireError, RequestSchema, type Request, ReplyOkSchema, type ReplyOk, ReplyErrorSchema, type ReplyError, ReplySchema, type Reply, EventSchema, type Event, ServerFrameSchema, type ServerFrame, type ParseResult, parseRequest, parseServerFrame } from './envelope.ts';
 export { SessionIdSchema, type SessionId } from './ids.ts';
-export { ModelOptionChoiceSchema, type ModelOptionChoice, ModelOptionDescriptorSchema, type ModelOptionDescriptor, ModelInfoSchema, type ModelInfo, ModelSelectionSchema, type ModelSelection, ModelCatalogProfileSchema, type ModelCatalogProfile, ModelCatalogEntrySchema, type ModelCatalogEntry, ModelCatalogDataSchema, type ModelCatalogData, RuntimeModeSchema, type RuntimeMode, ProviderCapabilitiesSchema, type ProviderCapabilities, ProviderInfoSchema, type ProviderInfo, ProviderListResultSchema, type ProviderListResult, resumeCommandFor } from './model.ts';
+export { ModelOptionChoiceSchema, type ModelOptionChoice, ModelOptionDescriptorSchema, type ModelOptionDescriptor, ModelInfoSchema, type ModelInfo, ModelSelectionSchema, type ModelSelection, ModelCatalogProfileSchema, type ModelCatalogProfile, ModelCatalogEntrySchema, type ModelCatalogEntry, ModelCatalogDataSchema, type ModelCatalogData, RuntimeModeSchema, type RuntimeMode, ProviderCapabilitiesSchema, type ProviderCapabilities, ProviderPlatformSchema, type ProviderPlatform, ProviderSignInSchema, type ProviderSignIn, ProviderInstallSchema, type ProviderInstall, ProviderInfoSchema, type ProviderInfo, ProviderListResultSchema, type ProviderListResult, resumeCommandFor } from './model.ts';
 export type { FramePort } from './port.ts';
 export { EmptySchema, AGENT_REQUEST_SCHEMAS, AGENT_EVENT_SCHEMAS, type AgentRequestType, type AgentEventType } from './protocol.ts';
 export { ProviderAccountIdSchema, type ProviderAccountId, ProviderAccountVariableSchema, type ProviderAccountVariable, ProviderAccountSchema, type ProviderAccount, ProviderAccountStateSchema, type ProviderAccountState, ProviderAccountStatusSchema, type ProviderAccountStatus, ProviderAccountMapSchema, type ProviderAccountMap, ProviderAccountsSchema, type ProviderAccounts, ProviderAccountsSavePayloadSchema, type ProviderAccountsSavePayload, ProviderAccountCreatePayloadSchema, type ProviderAccountCreatePayload, ProviderAccountCreateResultSchema, type ProviderAccountCreateResult, ProviderAccountWatchLoginPayloadSchema, type ProviderAccountWatchLoginPayload } from './provider-accounts.ts';

package/dist/index.js

@@ -3,7 +3,7 @@ export { KNOWN_AGENT_KINDS, AGENT_KIND_MAX_LENGTH, AgentKindSchema, isKnownAgent
 export { ChatIdSchema, ChatContextBreakdownSchema, ChatUsageSchema, CHAT_ATTACHMENTS_MAX_BYTES, CHAT_ATTACHMENT_MAX_BYTES, CHAT_ATTACHMENTS_MAX_COUNT, attachmentBytes, attachmentImageMime, ChatAttachmentUploadSchema, ChatAttachmentUploadsSchema, ChatAttachmentSchema, ChatUiChoiceOriginSchema, ChatUiAnswerSchema, ChatQuoteSourceSchema, ChatQueuedMessageSchema, ChatBackgroundTaskSchema, ChatTurnLimitSchema, ChatGoalStatusSchema, ChatGoalSchema, ChatQuestionSchema, ChatRequestKindSchema, CHAT_REQUEST_LIMITS, ChatRequestApprovalSchema, ChatRequestSummarySchema, ChatInfoSchema, ChatSkillSourceSchema, ChatSkillSchema, SkillsListPayloadSchema, SkillsListResultSchema, ChatUserItemSchema, ChatUiQueryReadingSchema, ChatUiLinkReadingSchema, ChatUiPlaceReadingSchema, ChatUiQueryStateSchema, ChatAssistantItemSchema, ChatThinkingItemSchema, ChatToolStateSchema, ChatToolProgressSchema, ChatFileChangeSchema, ChatSubagentStatusSchema, ChatWorkflowPhaseSchema, ChatWorkflowAgentSchema, ChatWorkflowSchema, workflowAgentRef, workflowAgentIdOf, ChatToolItemSchema, ChatSubagentUsageSchema, HOST_TASK_ORIGIN, ChatSubagentItemSchema, ChatApprovalDecisionSchema, ChatApprovalItemSchema, ChatQuestionItemSchema, ChatCheckpointFileSchema, ChatCheckpointDiffSchema, ChatTurnItemSchema, notResumedNote, abortedByMachine, ENDED_NOTE_PREFIX, abortedByEnd, activeSubagents, WAITING_NOTE_PREFIX, ChatNoteItemSchema, ChatCompactionItemSchema, ChatItemSchema, ChatEventSchema, ChatEventEnvelopeSchema, ChatCreatePayloadSchema, ChatConfigurePayloadSchema, ChatPreferencesPayloadSchema, ChatTargetPayloadSchema, ChatClearPayloadSchema, ChatCancelPayloadSchema, ChatAttachPayloadSchema, ChatHistoryPayloadSchema, ChatHistoryPageSchema, ChatHistoryResultSchema, ChatSubagentPayloadSchema, ChatStopSubagentPayloadSchema, ChatGoalActionSchema, ChatGoalPayloadSchema, ChatStopTaskPayloadSchema, ChatSubagentPageSchema, ChatSubagentSourceSchema, ChatSubagentResultSchema, ChatStatusEventSchema, ChatSubagentChangedEventSchema, CHAT_BOOKMARK_LIMITS, ChatBookmarkSchema, ChatBookmarksSchema, ChatAddBookmarkPayloadSchema, ChatRenameBookmarkPayloadSchema, ChatRemoveBookmarkPayloadSchema, ChatBookmarksResultSchema, ChatBookmarksEventSchema, ChatRemoveVisualPayloadSchema, ChatVisualsResultSchema, ChatVisualsEventSchema, ChatAttachResultSchema, ChatDeliverySchema, ChatSendPayloadSchema, ChatSendResultSchema, ChatUiChoicePayloadSchema, ChatUiQueryPayloadSchema, ChatUiLinkPayloadSchema, ChatQueuePayloadSchema, ChatUnqueueResultSchema, ChatApprovePayloadSchema, ChatDismissPayloadSchema, ChatAnswerPayloadSchema, ChatTurnDiffPayloadSchema, ChatTurnDiffResultSchema, CHAT_FORK_TITLE_MAX, ChatForkPayloadSchema, ChatForkResultSchema, ChatContinueOnPayloadSchema, ChatContinueOnResultSchema, ChatSummarizePayloadSchema, ChatSummarizeResultSchema, ChatForkInfoPayloadSchema, ChatForkInfoResultSchema, ChatListResultSchema, GeneratedImageInputSchema, generatedImageAttachment } from './chat.js';
 export { ErrorSchema, RequestSchema, ReplyOkSchema, ReplyErrorSchema, ReplySchema, EventSchema, ServerFrameSchema, parseRequest, parseServerFrame } from './envelope.js';
 export { SessionIdSchema } from './ids.js';
-export { ModelOptionChoiceSchema, ModelOptionDescriptorSchema, ModelInfoSchema, ModelSelectionSchema, ModelCatalogProfileSchema, ModelCatalogEntrySchema, ModelCatalogDataSchema, RuntimeModeSchema, ProviderCapabilitiesSchema, ProviderInfoSchema, ProviderListResultSchema, resumeCommandFor } from './model.js';
+export { ModelOptionChoiceSchema, ModelOptionDescriptorSchema, ModelInfoSchema, ModelSelectionSchema, ModelCatalogProfileSchema, ModelCatalogEntrySchema, ModelCatalogDataSchema, RuntimeModeSchema, ProviderCapabilitiesSchema, ProviderPlatformSchema, ProviderSignInSchema, ProviderInstallSchema, ProviderInfoSchema, ProviderListResultSchema, resumeCommandFor } from './model.js';
 export { EmptySchema, AGENT_REQUEST_SCHEMAS, AGENT_EVENT_SCHEMAS } from './protocol.js';
 export { ProviderAccountIdSchema, ProviderAccountVariableSchema, ProviderAccountSchema, ProviderAccountStateSchema, ProviderAccountStatusSchema, ProviderAccountMapSchema, ProviderAccountsSchema, ProviderAccountsSavePayloadSchema, ProviderAccountCreatePayloadSchema, ProviderAccountCreateResultSchema, ProviderAccountWatchLoginPayloadSchema } from './provider-accounts.js';
 export { isRecord } from './record.js';

package/dist/model.d.ts

@@ -160,6 +160,41 @@ export declare const ProviderCapabilitiesSchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type ProviderCapabilities = z.infer<typeof ProviderCapabilitiesSchema>;
+export declare const ProviderPlatformSchema: z.ZodEnum<{
+    darwin: "darwin";
+    linux: "linux";
+    win32: "win32";
+}>;
+export type ProviderPlatform = z.infer<typeof ProviderPlatformSchema>;
+export declare const ProviderSignInSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"command">;
+    command: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"env">;
+    variable: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"chat">;
+}, z.core.$strip>], "kind">;
+export type ProviderSignIn = z.infer<typeof ProviderSignInSchema>;
+export declare const ProviderInstallSchema: z.ZodObject<{
+    description: z.ZodString;
+    commands: z.ZodObject<{
+        darwin: z.ZodOptional<z.ZodString>;
+        linux: z.ZodOptional<z.ZodString>;
+        win32: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    guideUrl: z.ZodOptional<z.ZodString>;
+    signIn: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<({
+        kind: "command";
+        command: string;
+    } | {
+        kind: "env";
+        variable: string;
+    } | {
+        kind: "chat";
+    })[], unknown[]>>;
+}, z.core.$strip>;
+export type ProviderInstall = z.infer<typeof ProviderInstallSchema>;
 export declare const ProviderInfoSchema: z.ZodObject<{
     kind: z.ZodString;
     name: z.ZodString;
@@ -223,6 +258,24 @@ export declare const ProviderInfoSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>;
     resumeCommand: z.ZodString;
+    install: z.ZodOptional<z.ZodObject<{
+        description: z.ZodString;
+        commands: z.ZodObject<{
+            darwin: z.ZodOptional<z.ZodString>;
+            linux: z.ZodOptional<z.ZodString>;
+            win32: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        guideUrl: z.ZodOptional<z.ZodString>;
+        signIn: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<({
+            kind: "command";
+            command: string;
+        } | {
+            kind: "env";
+            variable: string;
+        } | {
+            kind: "chat";
+        })[], unknown[]>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ProviderInfo = z.infer<typeof ProviderInfoSchema>;
 export declare const ProviderListResultSchema: z.ZodObject<{
@@ -289,6 +342,24 @@ export declare const ProviderListResultSchema: z.ZodObject<{
             }>>;
         }, z.core.$strip>;
         resumeCommand: z.ZodString;
+        install: z.ZodOptional<z.ZodObject<{
+            description: z.ZodString;
+            commands: z.ZodObject<{
+                darwin: z.ZodOptional<z.ZodString>;
+                linux: z.ZodOptional<z.ZodString>;
+                win32: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            guideUrl: z.ZodOptional<z.ZodString>;
+            signIn: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<({
+                kind: "command";
+                command: string;
+            } | {
+                kind: "env";
+                variable: string;
+            } | {
+                kind: "chat";
+            })[], unknown[]>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ProviderListResult = z.infer<typeof ProviderListResultSchema>;

package/dist/model.js

@@ -108,6 +108,28 @@ export const ProviderCapabilitiesSchema = z.object({
     // or as the slash command alone (`command`); absent where the CLI has no goals.
     goals: z.enum(['native', 'command']).optional()
 });
+// The systems an install command is written for, by Node's names for them.
+export const ProviderPlatformSchema = z.enum(['darwin', 'linux', 'win32']);
+// One way a CLI signs in once it is installed.
+export const ProviderSignInSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('command'), command: z.string() }),
+    z.object({ kind: z.literal('env'), variable: z.string() }),
+    z.object({ kind: z.literal('chat') })
+]);
+// How a person gets a CLI that is not on the machine yet.
+export const ProviderInstallSchema = z.object({
+    // One line on what the CLI is.
+    description: z.string(),
+    // A system without a command is one the CLI does not install on in one line.
+    commands: z.object({ darwin: z.string().optional(), linux: z.string().optional(), win32: z.string().optional() }),
+    guideUrl: z.string().optional(),
+    // In the order the CLI prefers them. A way a newer host names that this version does not know is left out,
+    // so it never fails the whole provider.
+    signIn: z.array(z.unknown()).transform((ways) => ways.flatMap((way) => {
+        const parsed = ProviderSignInSchema.safeParse(way);
+        return parsed.success ? [parsed.data] : [];
+    }))
+});
 export const ProviderInfoSchema = z.object({
     kind: AgentKindSchema,
     name: z.string(),
@@ -119,7 +141,9 @@ export const ProviderInfoSchema = z.object({
     capabilities: ProviderCapabilitiesSchema,
     // What a terminal runs to continue one of this CLI's sessions. `{id}` stands for the session id
     // and `{flags}` for the flags the launch carries, which is where in the line each CLI takes them.
-    resumeCommand: z.string()
+    resumeCommand: z.string(),
+    // Absent from a host that knows no way to install this CLI, and from one older than this field.
+    install: ProviderInstallSchema.optional()
 });
 export const ProviderListResultSchema = z.object({
     providers: z.array(ProviderInfoSchema)

package/dist/protocol.d.ts

@@ -3946,6 +3946,24 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                     }>>;
                 }, z.core.$strip>;
                 resumeCommand: z.ZodString;
+                install: z.ZodOptional<z.ZodObject<{
+                    description: z.ZodString;
+                    commands: z.ZodObject<{
+                        darwin: z.ZodOptional<z.ZodString>;
+                        linux: z.ZodOptional<z.ZodString>;
+                        win32: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>;
+                    guideUrl: z.ZodOptional<z.ZodString>;
+                    signIn: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<({
+                        kind: "command";
+                        command: string;
+                    } | {
+                        kind: "env";
+                        variable: string;
+                    } | {
+                        kind: "chat";
+                    })[], unknown[]>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agent-contracts",
-  "version": "0.31.0",
+  "version": "0.31.1",
   "description": "Schemas and port contracts for agent chats, provider accounts, models and usage.",
   "type": "module",
   "exports": {
@@ -86,7 +86,7 @@
     "test": "bun --conditions=source test"
   },
   "dependencies": {
-    "@adecore/intelligent-ui": "0.31.0",
+    "@adecore/intelligent-ui": "0.31.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/src/index.ts

@@ -294,6 +294,12 @@ export {
     type RuntimeMode,
     ProviderCapabilitiesSchema,
     type ProviderCapabilities,
+    ProviderPlatformSchema,
+    type ProviderPlatform,
+    ProviderSignInSchema,
+    type ProviderSignIn,
+    ProviderInstallSchema,
+    type ProviderInstall,
     ProviderInfoSchema,
     type ProviderInfo,
     ProviderListResultSchema,

package/src/model.ts

@@ -128,6 +128,36 @@ export const ProviderCapabilitiesSchema = z.object({
 });
 export type ProviderCapabilities = z.infer<typeof ProviderCapabilitiesSchema>;
 
+// The systems an install command is written for, by Node's names for them.
+export const ProviderPlatformSchema = z.enum(['darwin', 'linux', 'win32']);
+export type ProviderPlatform = z.infer<typeof ProviderPlatformSchema>;
+
+// One way a CLI signs in once it is installed.
+export const ProviderSignInSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('command'), command: z.string() }),
+    z.object({ kind: z.literal('env'), variable: z.string() }),
+    z.object({ kind: z.literal('chat') })
+]);
+export type ProviderSignIn = z.infer<typeof ProviderSignInSchema>;
+
+// How a person gets a CLI that is not on the machine yet.
+export const ProviderInstallSchema = z.object({
+    // One line on what the CLI is.
+    description: z.string(),
+    // A system without a command is one the CLI does not install on in one line.
+    commands: z.object({ darwin: z.string().optional(), linux: z.string().optional(), win32: z.string().optional() }),
+    guideUrl: z.string().optional(),
+    // In the order the CLI prefers them. A way a newer host names that this version does not know is left out,
+    // so it never fails the whole provider.
+    signIn: z.array(z.unknown()).transform((ways) =>
+        ways.flatMap((way) => {
+            const parsed = ProviderSignInSchema.safeParse(way);
+            return parsed.success ? [parsed.data] : [];
+        })
+    )
+});
+export type ProviderInstall = z.infer<typeof ProviderInstallSchema>;
+
 export const ProviderInfoSchema = z.object({
     kind: AgentKindSchema,
     name: z.string(),
@@ -139,7 +169,9 @@ export const ProviderInfoSchema = z.object({
     capabilities: ProviderCapabilitiesSchema,
     // What a terminal runs to continue one of this CLI's sessions. `{id}` stands for the session id
     // and `{flags}` for the flags the launch carries, which is where in the line each CLI takes them.
-    resumeCommand: z.string()
+    resumeCommand: z.string(),
+    // Absent from a host that knows no way to install this CLI, and from one older than this field.
+    install: ProviderInstallSchema.optional()
 });
 export type ProviderInfo = z.infer<typeof ProviderInfoSchema>;