@agentknight/client 0.9.41 → 0.9.43

package/README.md

@@ -61,8 +61,8 @@ Status and upgrade commands do not import or migrate configuration.
 A legacy `~/.copilot-remote` home is copied only while the old Agent is stopped,
 preserving its machine identity, pairing keys and saved state. The stable device
 ID now lives in `<home>/device-id` alongside `device.json`; existing identities
-are preserved when importing the old `.bluepaw` ID. Fresh custom homes have
-independent identities. No new `.bluepaw` directory or compatibility symlink is
+are preserved when importing a retired client layout's ID. Fresh custom homes have
+independent identities. No retired client directory or compatibility symlink is
 created. Conflicting identities or homes require manual resolution, not an
 automatic reset. Retained legacy files are rollback copies, never dual-written;
 remove them only after verifying the migrated installation while old agents are stopped.
@@ -220,10 +220,9 @@ Native agent configuration still comes from the environment file. Subsequent
 webpage Sync actions apply immediately and save the selection; the startup flag takes precedence
 again on restart. Managed mode also works with the local webpage disabled.
 
-Discovery reads native session inventories without resuming their conversations.
-AgentKnight can continue PI's saved sessions, but does not attach to an already
-running PI terminal. Avoid continuing the same native session concurrently in both
-applications. Provider credentials and history stay in their native stores.
+PI discovery reads its native session inventory without resuming conversations.
+AgentKnight can continue saved PI sessions, but cannot attach to a running PI
+terminal. Avoid continuing the same session concurrently in both applications.
 
 In Android, choose **Rename** from a supported session's menu to change its native
 name, not a local display alias. Renaming a group changes only its title, not its
@@ -237,20 +236,22 @@ Groups connect two shared Copilot sessions on the same PC, in either managed or
 single-engine mode, including sessions created in the CLI or restored after a restart.
 Both participants must be idle with no pending input. After restarting, groups remain
 paused without replay; send a new group message to continue with the existing members.
-PI and ACP do not support groups.
+Other engines do not support groups.
 
 For experimental online conversation between Copilot sessions on two PCs, see
 the [peer-chat setup](../../docs/remote-sessions/agent-group-chat-design.md#使用).
 It is separate from local groups and sends Relay-readable text.
 Use only non-sensitive test content.
 
-Explicit `copilot`, `pi`, or `acp` values retain single-engine operation without
+Explicit engine values retain single-engine operation without
 selection filtering. See [.env.example](.env.example) for configuration.
 
 | Engine | Setup |
 | --- | --- |
 | `copilot` | Authenticate the GitHub Copilot CLI as before. |
-| `pi` | Requires Node.js >=22.19.0 and the optional PI dependencies from the [SDK manifest](../../shared/sdk/package.json). Authenticate PI using its own CLI (`/login`) or supported provider API-key environment variables. |
+| `pi` | Install the optional PI dependencies using the Node.js version required by their manifests. Authenticate through PI's CLI or supported provider environment variables. |
+| `codex` | Install and authenticate the [official Codex CLI](https://developers.openai.com/codex/cli/); executable overrides are in [.env.example](.env.example). |
+| `claude` | Enable optional dependencies and follow the [official Agent SDK setup](https://platform.claude.com/docs/en/agent-sdk/overview) for API-key or cloud-provider authentication. Personal subscription OAuth is not reused. |
 | `acp` | Install and authenticate an ACP-compatible agent or bridge. Set `AGENTKNIGHT_ACP_COMMAND` to its executable and `AGENTKNIGHT_ACP_ARGS` to a JSON string array, such as `["--stdio"]` if that agent requires it. |
 
 PI uses its native directory by default. `PI_CODING_AGENT_DIR` selects an
@@ -260,6 +261,11 @@ AgentKnight with optional dependencies enabled to use PI.
 Source builds and the complete adapter suite also require the PI-compatible Node
 version; Copilot-only operation retains the baseline version in the manifest.
 
+Codex (App Server) and Claude (Agent SDK) expose only AgentKnight-created
+conversations and their saved history, not existing CLI/IDE conversations.
+Credentials stay on the PC; discovery does not verify authentication.
+Copilot-specific Workbench, group and peer-chat operations remain unsupported.
+
 The ACP executable must speak the Agent Client Protocol over stdio; an ordinary
 Codex or Claude Code CLI is not automatically an ACP endpoint. Arguments are
 passed literally, without a shell. AgentKnight does not download or authenticate
@@ -274,8 +280,8 @@ Machine-wide features such as uploads and deletion are available only when every
 selected engine supports them; session controls use that session's own engine.
 ACP approvals use the agent's offered one-time permission option, never an
 automatic persistent grant. Unsupported operations return errors rather than
-pretending to succeed. PI and ACP do not expose Copilot's remote-mode toggle.
-Generic file uploads remain Copilot-only; PI also rejects image uploads, while
+pretending to succeed. Only Copilot exposes its remote-mode toggle.
+Generic file uploads remain Copilot-only; PI, Codex and Claude also reject image uploads, while
 ACP images require the agent's negotiated image support.
 
 Optional controls follow the [capability compatibility policy](../../docs/remote-sessions/protocol-compatibility-plan.md);

package/dist/cli.js

@@ -33,7 +33,7 @@ function readAppVersion() {
 }
 
 // src/cli-options.ts
-import { AgentSelectionSchema } from "@agentknight/sdk";
+import { AgentSelectionSchema, CODING_AGENT_IDS } from "@agentknight/sdk";
 import { PeerChatRequestSchema } from "@agentknight/sdk";
 function parseCliOptions(args) {
   let envFile;
@@ -94,7 +94,7 @@ function parseCliOptions(args) {
         agents: value === "none" ? [] : value?.split(",").map((id) => id.trim())
       });
       if (!parsed.success) {
-        throw new Error("--agents requires comma-separated copilot,pi,acp or none");
+        throw new Error(`--agents requires comma-separated ${CODING_AGENT_IDS.join(",")} or none`);
       }
       agents = parsed.data.agents;
       index += 1;
@@ -143,7 +143,7 @@ Usage:
 
 Options:
   --env <path>       Use a file as the authoritative PC configuration
-  --agents <list>    Sync copilot,pi,acp (comma-separated), or none
+  --agents <list>    Sync ${CODING_AGENT_IDS.join(",")} (comma-separated), or none
   -h, --help         Show this help
   -v, --version      Show the installed CLI version
 
@@ -1365,6 +1365,8 @@ function fileResultSchema(mediaTypes, extended) {
 }
 var SessionFileReadResultDataSchema = fileResultSchema(SESSION_FILE_MEDIA_TYPES, false);
 var SessionFileReadV2ResultDataSchema = fileResultSchema(SESSION_FILE_V2_MEDIA_TYPES, true);
+var SessionFileDownloadDataSchema = SessionFileReadDataSchema;
+var SessionFileDownloadResultDataSchema = fileResultSchema(["application/octet-stream"], true);
 var SessionGitProjectSchema = z13.object({
   localRepositoryKey: z13.string().length(43).regex(/^[A-Za-z0-9_-]{43}$/),
   worktreeRoot: z13.string().min(1).max(SESSION_PROJECT_IDENTITY_MAX_PATH_LENGTH),
@@ -3018,6 +3020,8 @@ var AndroidProtocolSchemas = {
   SessionFileReadData: SessionFileReadDataSchema,
   SessionFileReadResultData: SessionFileReadResultDataSchema,
   SessionFileReadV2ResultData: SessionFileReadV2ResultDataSchema,
+  SessionFileDownloadData: SessionFileDownloadDataSchema,
+  SessionFileDownloadResultData: SessionFileDownloadResultDataSchema,
   SessionResourceReadData: SessionResourceReadDataSchema,
   SessionResourceReadResultData: SessionResourceReadResultDataSchema,
   SessionDirectoryListRequest: SessionDirectoryListRequestSchema,
@@ -3109,6 +3113,7 @@ var AndroidProtocolSchemas = {
 // src/config.ts
 import {
   AgentSelectionSchema as AgentSelectionSchema2,
+  CODING_AGENT_IDS as CODING_AGENT_IDS2,
   SessionImageRelayUrlSchema,
   SessionImagesConfigSchema
 } from "@agentknight/sdk";
@@ -3142,10 +3147,11 @@ var EnvironmentSchema = z28.object({
   AGENTKNIGHT_MACHINE_NAME: z28.string().trim().min(1).max(120).optional(),
   AGENTKNIGHT_HOME: z28.string().trim().min(1).optional(),
   AGENTKNIGHT_WORKSPACE_ROOT: z28.string().trim().min(1).optional(),
-  AGENTKNIGHT_CODING_AGENT: z28.enum(["managed", "copilot", "pi", "acp"]).default("managed"),
+  AGENTKNIGHT_CODING_AGENT: z28.enum(["managed", ...CODING_AGENT_IDS2]).default("managed"),
   AGENTKNIGHT_GROUP_CHAT_ENABLED: EnabledBooleanStringSchema,
   AGENTKNIGHT_PEER_CHAT_ENABLED: EnabledBooleanStringSchema,
   PI_CODING_AGENT_DIR: OptionalPathSchema,
+  AGENTKNIGHT_CODEX_COMMAND: OptionalPathSchema,
   AGENTKNIGHT_ACP_COMMAND: OptionalPathSchema,
   AGENTKNIGHT_ACP_ARGS: AcpArgumentsSchema,
   SESSION_REFRESH_INTERVAL_MS: z28.coerce.number().int().min(5e3).max(36e5).default(3e4),
@@ -3188,6 +3194,7 @@ function codingAgentConfig(environment) {
     case "managed":
       return {
         kind: "managed",
+        ...environment.AGENTKNIGHT_CODEX_COMMAND === void 0 ? {} : { codexCommand: environment.AGENTKNIGHT_CODEX_COMMAND },
         ...environment.PI_CODING_AGENT_DIR === void 0 ? {} : { piDirectory: environment.PI_CODING_AGENT_DIR },
         ...environment.AGENTKNIGHT_ACP_COMMAND === void 0 ? {} : {
           acp: { command: environment.AGENTKNIGHT_ACP_COMMAND, args: environment.AGENTKNIGHT_ACP_ARGS }
@@ -3200,6 +3207,13 @@ function codingAgentConfig(environment) {
         kind: "pi",
         ...environment.PI_CODING_AGENT_DIR === void 0 ? {} : { agentDirectory: environment.PI_CODING_AGENT_DIR }
       };
+    case "codex":
+      return {
+        kind: "codex",
+        ...environment.AGENTKNIGHT_CODEX_COMMAND === void 0 ? {} : { command: environment.AGENTKNIGHT_CODEX_COMMAND }
+      };
+    case "claude":
+      return { kind: "claude" };
     case "acp":
       if (environment.AGENTKNIGHT_ACP_COMMAND === void 0) {
         throw new Error("AGENTKNIGHT_ACP_COMMAND is required");
@@ -6832,7 +6846,7 @@ import { link, lstat as lstat2, mkdir as mkdir6, readFile as readFile5, readlink
 import { homedir as homedir3, hostname } from "node:os";
 import { dirname as dirname6, join as join12, resolve as resolve9 } from "node:path";
 import { z as z37 } from "zod";
-import { DeviceIdentitySchema } from "@agentknight/sdk";
+import { DeviceIdentitySchema, LEGACY_CLIENT_STATE_DIRECTORY } from "@agentknight/sdk";
 import { DeviceIdentitySchema as DeviceIdentitySchema2 } from "@agentknight/sdk";
 var LegacyDeviceIdentitySchema = z37.object({
   schemaVersion: z37.literal(1),
@@ -6871,8 +6885,8 @@ async function requireDirectory(path) {
 }
 async function readLegacyStableDeviceId(userHome) {
   const defaultHome = defaultClientHome(userHome);
-  const movedRoot = join12(defaultHome, ".bluepaw");
-  const legacyRoot = join12(userHome, ".bluepaw");
+  const movedRoot = join12(defaultHome, LEGACY_CLIENT_STATE_DIRECTORY);
+  const legacyRoot = join12(userHome, LEGACY_CLIENT_STATE_DIRECTORY);
   const movedExists = await requireDirectory(defaultHome) && await requireDirectory(movedRoot);
   const legacyInfo = await optionalStat(legacyRoot);
   let legacyDirectory;