@adecore/agents 0.31.0 → 0.31.1

package/dist/providers/acp-provider.d.ts

@@ -1,4 +1,4 @@
-import type { AgentKind, ProviderCapabilities } from '@adecore/agent-contracts';
+import type { AgentKind, ProviderCapabilities, ProviderInstall } from '@adecore/agent-contracts';
 import { type AcpAgentSpec } from '../chat/acp-backend.ts';
 import type { ModelCatalog } from './catalog.ts';
 import { type CliDetection } from './detect.ts';
@@ -12,6 +12,7 @@ export interface AcpProviderSpec extends AcpAgentSpec {
     capabilities?: Partial<ProviderCapabilities>;
     resumeCommand?: string;
     home?: ProviderHome;
+    install?: ProviderInstall;
     ignoresProjectConfig?: boolean;
     oneShotArgs?(prompt: string): string[];
     oneShotStdinArgs?: readonly string[];

package/dist/providers/acp-provider.js

@@ -32,6 +32,7 @@ export function createAcpProvider(spec) {
         resumeCommand: spec.resumeCommand ?? '',
         ...(spec.ignoresProjectConfig === undefined ? {} : { ignoresProjectConfig: spec.ignoresProjectConfig }),
         ...(spec.home ? { home: spec.home } : {}),
+        ...(spec.install ? { install: spec.install } : {}),
         ...(spec.oneShotArgs ? { oneShotArgs: spec.oneShotArgs } : {}),
         ...(spec.oneShotStdinArgs ? { oneShotStdinArgs: spec.oneShotStdinArgs } : {}),
         ...(spec.enabled ? { enabled: spec.enabled } : {}),

package/dist/providers/claude-provider.js

@@ -18,6 +18,19 @@ export function createClaudeProvider(options = {}) {
             loginEnv: ['ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'CLAUDE_CODE_OAUTH_TOKEN'],
             loginCommand: 'claude auth login'
         },
+        install: {
+            description: "Anthropic's coding agent, in a terminal and in a chat.",
+            commands: {
+                darwin: 'curl -fsSL https://claude.ai/install.sh | bash',
+                linux: 'curl -fsSL https://claude.ai/install.sh | bash',
+                win32: 'irm https://claude.ai/install.ps1 | iex'
+            },
+            guideUrl: 'https://docs.anthropic.com/en/docs/claude-code/setup',
+            signIn: [
+                { kind: 'command', command: 'claude auth login' },
+                { kind: 'env', variable: 'ANTHROPIC_API_KEY' }
+            ]
+        },
         detect: detectCli,
         oneShotArgs: (prompt) => ['-p', prompt, '--output-format', 'text'],
         // `-p` without a prompt argument reads the prompt from stdin.

package/dist/providers/codex-provider.js

@@ -16,6 +16,15 @@ export function createCodexProvider(options = {}) {
         ignoresProjectConfig: false,
         // The auth variables Codex 0.157 names in its own "no Codex credentials were found" advice.
         home: { env: 'CODEX_HOME', fallback: '.codex', loginEnv: ['OPENAI_API_KEY', 'CODEX_API_KEY', 'CODEX_ACCESS_TOKEN'], loginCommand: 'codex login' },
+        install: {
+            description: "OpenAI's coding agent, in a terminal and in a chat.",
+            commands: { darwin: 'npm install -g @openai/codex', linux: 'npm install -g @openai/codex', win32: 'npm install -g @openai/codex' },
+            guideUrl: 'https://github.com/openai/codex',
+            signIn: [
+                { kind: 'command', command: 'codex login' },
+                { kind: 'env', variable: 'OPENAI_API_KEY' }
+            ]
+        },
         detect: detectCli,
         // Read-only and without an approval to wait for: the run only has to read what it is handed. A chat's
         // title is asked in a folder that need not be a repository, and ephemeral keeps the run out of Codex's thread list.

package/dist/providers/provider.d.ts

@@ -1,4 +1,4 @@
-import type { AgentKind, ProviderCapabilities } from '@adecore/agent-contracts';
+import type { AgentKind, ProviderCapabilities, ProviderInstall } from '@adecore/agent-contracts';
 import type { BackendHost, BackendLaunch, ChatBackend } from '../chat/backend.ts';
 import type { ModelCatalog } from './catalog.ts';
 import type { CliDetection } from './detect.ts';
@@ -17,6 +17,7 @@ export interface ChatProvider {
     readonly resumeCommand: string;
     readonly ignoresProjectConfig?: boolean;
     readonly home?: ProviderHome;
+    readonly install?: ProviderInstall;
     oneShotArgs?(prompt: string): string[];
     readonly oneShotStdinArgs?: readonly string[];
     firstPromptArgs(prompt: string): string[];

package/dist/providers/registry.js

@@ -65,7 +65,8 @@ export class ProviderRegistry {
             models: provider.catalog.list(),
             defaultModel: provider.catalog.defaultModel || null,
             capabilities: provider.capabilities,
-            resumeCommand: provider.resumeCommand
+            resumeCommand: provider.resumeCommand,
+            ...(provider.install ? { install: provider.install } : {})
         })));
     }
     /* The kinds this host offers, in the order every menu lists them. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agents",
-  "version": "0.31.0",
+  "version": "0.31.1",
   "description": "Node-compatible agent chat hosts, providers, accounts, usage and durable task coordination.",
   "type": "module",
   "exports": {
@@ -81,8 +81,8 @@
     "test": "bun --conditions=source test"
   },
   "dependencies": {
-    "@adecore/agent-contracts": "0.31.0",
-    "@adecore/intelligent-ui": "0.31.0",
+    "@adecore/agent-contracts": "0.31.1",
+    "@adecore/intelligent-ui": "0.31.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/src/providers/acp-provider.ts

@@ -1,4 +1,4 @@
-import type { AgentKind, ProviderCapabilities } from '@adecore/agent-contracts';
+import type { AgentKind, ProviderCapabilities, ProviderInstall } from '@adecore/agent-contracts';
 import { createAcpBackend, type AcpAgentSpec } from '../chat/acp-backend.ts';
 import type { ModelCatalog } from './catalog.ts';
 import { detectCli, type CliDetection } from './detect.ts';
@@ -38,6 +38,7 @@ export interface AcpProviderSpec extends AcpAgentSpec {
     // What a terminal runs to continue one of its sessions; empty where it has none.
     resumeCommand?: string;
     home?: ProviderHome;
+    install?: ProviderInstall;
     ignoresProjectConfig?: boolean;
     oneShotArgs?(prompt: string): string[];
     oneShotStdinArgs?: readonly string[];
@@ -59,6 +60,7 @@ export function createAcpProvider(spec: AcpProviderSpec): ChatProvider {
         resumeCommand: spec.resumeCommand ?? '',
         ...(spec.ignoresProjectConfig === undefined ? {} : { ignoresProjectConfig: spec.ignoresProjectConfig }),
         ...(spec.home ? { home: spec.home } : {}),
+        ...(spec.install ? { install: spec.install } : {}),
         ...(spec.oneShotArgs ? { oneShotArgs: spec.oneShotArgs } : {}),
         ...(spec.oneShotStdinArgs ? { oneShotStdinArgs: spec.oneShotStdinArgs } : {}),
         ...(spec.enabled ? { enabled: spec.enabled } : {}),

package/src/providers/claude-provider.ts

@@ -20,6 +20,19 @@ export function createClaudeProvider(options: ClaudeBackendOptions = {}): ChatPr
             loginEnv: ['ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'CLAUDE_CODE_OAUTH_TOKEN'],
             loginCommand: 'claude auth login'
         },
+        install: {
+            description: "Anthropic's coding agent, in a terminal and in a chat.",
+            commands: {
+                darwin: 'curl -fsSL https://claude.ai/install.sh | bash',
+                linux: 'curl -fsSL https://claude.ai/install.sh | bash',
+                win32: 'irm https://claude.ai/install.ps1 | iex'
+            },
+            guideUrl: 'https://docs.anthropic.com/en/docs/claude-code/setup',
+            signIn: [
+                { kind: 'command', command: 'claude auth login' },
+                { kind: 'env', variable: 'ANTHROPIC_API_KEY' }
+            ]
+        },
         detect: detectCli,
         oneShotArgs: (prompt) => ['-p', prompt, '--output-format', 'text'],
         // `-p` without a prompt argument reads the prompt from stdin.

package/src/providers/codex-provider.ts

@@ -18,6 +18,15 @@ export function createCodexProvider(options: CodexBackendOptions = {}): ChatProv
         ignoresProjectConfig: false,
         // The auth variables Codex 0.157 names in its own "no Codex credentials were found" advice.
         home: { env: 'CODEX_HOME', fallback: '.codex', loginEnv: ['OPENAI_API_KEY', 'CODEX_API_KEY', 'CODEX_ACCESS_TOKEN'], loginCommand: 'codex login' },
+        install: {
+            description: "OpenAI's coding agent, in a terminal and in a chat.",
+            commands: { darwin: 'npm install -g @openai/codex', linux: 'npm install -g @openai/codex', win32: 'npm install -g @openai/codex' },
+            guideUrl: 'https://github.com/openai/codex',
+            signIn: [
+                { kind: 'command', command: 'codex login' },
+                { kind: 'env', variable: 'OPENAI_API_KEY' }
+            ]
+        },
         detect: detectCli,
         // Read-only and without an approval to wait for: the run only has to read what it is handed. A chat's
         // title is asked in a folder that need not be a repository, and ephemeral keeps the run out of Codex's thread list.

package/src/providers/provider.ts

@@ -1,4 +1,4 @@
-import type { AgentKind, ProviderCapabilities } from '@adecore/agent-contracts';
+import type { AgentKind, ProviderCapabilities, ProviderInstall } from '@adecore/agent-contracts';
 import type { BackendHost, BackendLaunch, ChatBackend } from '../chat/backend.ts';
 import type { ModelCatalog } from './catalog.ts';
 import type { CliDetection } from './detect.ts';
@@ -34,6 +34,8 @@ export interface ChatProvider {
     /* Where this CLI keeps its login, settings and transcripts, which is what an account is. Absent on a
        CLI with no variable to move that folder, which then only has its default account. */
     readonly home?: ProviderHome;
+    /* How a person installs this CLI and signs it in, for a page that shows it while the CLI is missing. */
+    readonly install?: ProviderInstall;
     /* The arguments for one prompt in and one answer out, no session and no chat, which is how a
        host asks for a commit message or a title. Absent on a CLI that only runs interactively. */
     oneShotArgs?(prompt: string): string[];

package/src/providers/registry.ts

@@ -89,7 +89,8 @@ export class ProviderRegistry {
                 models: provider.catalog.list(),
                 defaultModel: provider.catalog.defaultModel || null,
                 capabilities: provider.capabilities,
-                resumeCommand: provider.resumeCommand
+                resumeCommand: provider.resumeCommand,
+                ...(provider.install ? { install: provider.install } : {})
             }))
         );
     }