shennian 0.4.11 → 0.4.13

package/node_modules/@shennian/wire/dist/session.d.ts

@@ -2,7 +2,9 @@ import type { NativeSessionSourceMode } from './native-session.js';
 import type { PersonalAttachmentReference, PersonalSyncIdentity, SessionBodyStorageMode, SessionTitleSource } from './session-sync.js';
 export type BuiltinAgentType = 'claude' | 'codex' | 'workbuddy' | 'gemini' | 'cursor' | 'openclaw' | 'opencode' | 'pi' | 'pi-coding-agent' | 'manager';
 export type CustomAgentType = `custom:${string}`;
-export type AgentType = BuiltinAgentType | CustomAgentType;
+/** Stable Agent Client Protocol integrations discovered on the target machine. */
+export type AcpAgentType = `acp:${string}`;
+export type AgentType = BuiltinAgentType | CustomAgentType | AcpAgentType;
 /** The external Codex owner stopped its last turn, so its native queue is paused. */
 export declare const CODEX_DESKTOP_SEND_UNAVAILABLE = "codex_desktop_send_unavailable";
 export declare const DISABLED_BUILTIN_AGENT_TYPES: readonly ["gemini", "openclaw"];
@@ -21,6 +23,15 @@ export type ModelInfo = {
     defaultReasoningEffort?: string;
     additionalSpeedTiers?: string[];
 };
+/** Runtime options returned by an active ACP session; absent before session/new or load. */
+export type AcpSessionOptions = {
+    models: ModelInfo[];
+    modes: Array<{
+        id: string;
+        name: string;
+        description?: string;
+    }>;
+};
 export type AgentConfigStatus = 'missing' | 'detected' | 'managed' | 'error';
 export type AgentConfigSummary = {
     /** Configuration state on the target machine; secrets are never included. */
@@ -45,9 +56,79 @@ export type AgentRuntimeSummary = {
     /** Shennian never upgrades third-party Agents automatically. */
     upgradeAction?: 'manual';
 };
+export type AgentIntegration = 'deep' | 'acp';
+export type AgentAuthState = 'ready' | 'required' | 'unknown' | 'error';
+export type AcpCapabilitySummary = {
+    protocolVersion: 1;
+    listSessions: boolean;
+    loadSession: boolean;
+    resumeSession: boolean;
+    closeSession: boolean;
+    deleteSession: boolean;
+    terminal: boolean;
+    fileRead: boolean;
+    fileWrite: boolean;
+    permission: boolean;
+    modelConfig: boolean;
+};
+export type AcpAuthMethodSummary = {
+    id: string;
+    name: string;
+    type: 'agent' | 'terminal';
+};
+export type AgentDisplayMetadata = {
+    name: string;
+    abbreviation?: string;
+    version?: string;
+};
+export type AcpCatalogPlatform = 'darwin-aarch64' | 'darwin-x86_64' | 'linux-aarch64' | 'linux-x86_64' | 'windows-aarch64' | 'windows-x86_64';
+export type AcpCatalogCandidate = {
+    id: string;
+    name: string;
+    version: string;
+    commands: string[];
+    args: string[];
+    /** Package hints are inspected locally only; the daemon never installs them. */
+    npmPackage?: string;
+    uvPackage?: string;
+    website?: string;
+    duplicateOf?: BuiltinAgentType;
+};
+export type AcpCatalogSnapshot = {
+    revision: string;
+    digest: string;
+    fetchedAt: string;
+    sourceVersion: string;
+    platform: AcpCatalogPlatform;
+    candidates: AcpCatalogCandidate[];
+};
+export type AcpExternalSessionInfo = {
+    agentSessionId: string;
+    cwd: string;
+    title?: string;
+    updatedAt?: string;
+};
+/** Complete scope for an external ACP session; vendor ids are never global. */
+export type AcpExternalSessionIdentity = {
+    machineId: string;
+    agentType: AcpAgentType;
+    agentSessionId: string;
+};
 export type AgentInfo = {
     type: AgentType;
     models: ModelInfo[];
+    /** User-facing grouping. Omitted by older daemons and interpreted as deep. */
+    integration?: AgentIntegration;
+    /** Non-secret metadata used for dynamic ACP display fallbacks. */
+    display?: AgentDisplayMetadata;
+    /** Stable ACP v1 capabilities negotiated with the installed local Agent. */
+    acpCapabilities?: AcpCapabilitySummary;
+    /** Non-secret authentication choices advertised during ACP initialize. */
+    acpAuthMethods?: AcpAuthMethodSummary[];
+    /** Conservative auth projection; authMethods alone never imply required. */
+    authState?: AgentAuthState;
+    /** Registry snapshot used to discover the Agent, when applicable. */
+    catalogRevision?: string;
     /** True when this provider can back a stable Shennian Agent and managed Room session. */
     supportsManagedAgent?: boolean;
     /** True when Manager mode can create this provider as a worker. */
@@ -82,6 +163,8 @@ export type SessionUserState = {
     lastReadAttentionCount?: number;
     lastReadAttentionId?: string | null;
     manualUnread?: boolean;
+    /** Local desired read watermark has not yet been acknowledged by Server. */
+    readSyncPending?: boolean;
     updatedAt: string;
 };
 /** Exact lightweight index state the user actually saw before marking a Session read. */

package/node_modules/@shennian/wire/dist/session.js

@@ -1,3 +1,5 @@
+// @arch docs/features/app-relay-reconnect-and-connectivity-feedback-todo.md#p4已读水位恢复
+// @test packages/shared/src/__tests__/sync-engine.test.ts
 /** The external Codex owner stopped its last turn, so its native queue is paused. */
 export const CODEX_DESKTOP_SEND_UNAVAILABLE = 'codex_desktop_send_unavailable';
 export const DISABLED_BUILTIN_AGENT_TYPES = [
@@ -20,7 +22,9 @@ export function isAvailableBuiltinAgentType(value) {
     return AVAILABLE_BUILTIN_AGENT_TYPE_SET.has(value);
 }
 export function isAvailableAgentType(value) {
-    return value.startsWith('custom:') || isAvailableBuiltinAgentType(value);
+    return value.startsWith('custom:')
+        || /^acp:[a-z0-9][a-z0-9._-]{0,63}$/.test(value)
+        || isAvailableBuiltinAgentType(value);
 }
 export function filterAvailableAgentTypes(values) {
     const filtered = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shennian",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "Shennian — AI Agent Control Plane CLI",
   "type": "module",
   "bin": {
@@ -37,12 +37,14 @@
     "node": ">=18"
   },
   "dependencies": {
+    "@agentclientprotocol/sdk": "1.4.0",
     "@sinclair/typebox": "^0.34.49",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "qrcode": "^1.5.4",
     "qrcode-terminal": "^0.12.0",
     "ws": "^8.18.1",
+    "zod": "3.25.76",
     "@shennian/wire": "0.1.5"
   },
   "devDependencies": {
@@ -55,8 +57,8 @@
     "typescript": "^5.9.3"
   },
   "scripts": {
-    "build": "tsc && node scripts/copy-macos-background-client.mjs && node -e \"require('node:fs').chmodSync('dist/bin/shennian.js', 0o755)\"",
-    "build:publish": "pnpm --filter @shennian/wire build:publish && node -e \"const fs=require('node:fs'); fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('.tsbuildinfo.publish', { force: true })\" && tsc -p tsconfig.publish.json && node scripts/copy-macos-background-client.mjs && node scripts/minify-publish-js.mjs && node -e \"require('node:fs').chmodSync('dist/bin/shennian.js', 0o755)\" && node scripts/check-publish-artifact.mjs",
+    "build": "node -e \"require('node:fs').rmSync('dist/native/macos-background-client', { recursive: true, force: true })\" && tsc && node -e \"require('node:fs').chmodSync('dist/bin/shennian.js', 0o755)\"",
+    "build:publish": "pnpm --filter @shennian/wire build:publish && node -e \"const fs=require('node:fs'); fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('.tsbuildinfo.publish', { force: true })\" && tsc -p tsconfig.publish.json && node scripts/minify-publish-js.mjs && node -e \"require('node:fs').chmodSync('dist/bin/shennian.js', 0o755)\" && node scripts/check-publish-artifact.mjs",
     "test:security:codex": "tsx scripts/verify-managed-codex-sandbox.ts",
     "test:security:codex-tools": "tsx scripts/verify-managed-codex-dynamic-tools.ts",
     "dev": "tsc --watch"

package/dist/native/macos-background-client/Shennian.app/Contents/Info.plist

@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>CFBundleDevelopmentRegion</key><string>en</string>
-  <key>CFBundleDisplayName</key><string>Shennian</string>
-  <key>CFBundleExecutable</key><string>ShennianClientLauncher</string>
-  <key>CFBundleIdentifier</key><string>net.shennian.client.background-service</string>
-  <key>CFBundleInfoDictionaryVersion</key><string>6.0</string>
-  <key>CFBundleName</key><string>Shennian</string>
-  <key>CFBundlePackageType</key><string>APPL</string>
-  <key>CFBundleShortVersionString</key><string>1.0.0</string>
-  <key>CFBundleVersion</key><string>1.0.0</string>
-  <key>LSBackgroundOnly</key><true/>
-  <key>LSMinimumSystemVersion</key><string>13.0</string>
-</dict>
-</plist>

package/dist/native/macos-background-client/Shennian.app/Contents/Resources/en.lproj/InfoPlist.strings

@@ -1,2 +0,0 @@
-"CFBundleDisplayName" = "Shennian";
-"CFBundleName" = "Shennian";

package/dist/native/macos-background-client/Shennian.app/Contents/Resources/zh-Hans.lproj/InfoPlist.strings

@@ -1,2 +0,0 @@
-"CFBundleDisplayName" = "神念";
-"CFBundleName" = "神念";

package/dist/native/macos-background-client/Shennian.app/Contents/_CodeSignature/CodeResources

@@ -1,153 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>files</key>
-	<dict>
-		<key>Resources/en.lproj/InfoPlist.strings</key>
-		<dict>
-			<key>hash</key>
-			<data>
-			7cZ/3Y+z3FLOqySef5/rGgdk+hU=
-			</data>
-			<key>optional</key>
-			<true/>
-		</dict>
-		<key>Resources/zh-Hans.lproj/InfoPlist.strings</key>
-		<dict>
-			<key>hash</key>
-			<data>
-			6MKN0tNN2Z8t8wIkKiANNKgscLY=
-			</data>
-			<key>optional</key>
-			<true/>
-		</dict>
-	</dict>
-	<key>files2</key>
-	<dict>
-		<key>Resources/en.lproj/InfoPlist.strings</key>
-		<dict>
-			<key>hash2</key>
-			<data>
-			FJaLoD8f3R/s4Tvbgbvcrb9uzFLfPBACRdeL+bpiUtw=
-			</data>
-			<key>optional</key>
-			<true/>
-		</dict>
-		<key>Resources/zh-Hans.lproj/InfoPlist.strings</key>
-		<dict>
-			<key>hash2</key>
-			<data>
-			B/tCw00PlOTxARULQMz6SavBh8IU6/M0b8GXT253tC0=
-			</data>
-			<key>optional</key>
-			<true/>
-		</dict>
-	</dict>
-	<key>rules</key>
-	<dict>
-		<key>^Resources/</key>
-		<true/>
-		<key>^Resources/.*\.lproj/</key>
-		<dict>
-			<key>optional</key>
-			<true/>
-			<key>weight</key>
-			<real>1000</real>
-		</dict>
-		<key>^Resources/.*\.lproj/locversion.plist$</key>
-		<dict>
-			<key>omit</key>
-			<true/>
-			<key>weight</key>
-			<real>1100</real>
-		</dict>
-		<key>^Resources/Base\.lproj/</key>
-		<dict>
-			<key>weight</key>
-			<real>1010</real>
-		</dict>
-		<key>^version.plist$</key>
-		<true/>
-	</dict>
-	<key>rules2</key>
-	<dict>
-		<key>.*\.dSYM($|/)</key>
-		<dict>
-			<key>weight</key>
-			<real>11</real>
-		</dict>
-		<key>^(.*/)?\.DS_Store$</key>
-		<dict>
-			<key>omit</key>
-			<true/>
-			<key>weight</key>
-			<real>2000</real>
-		</dict>
-		<key>^(Frameworks|SharedFrameworks|PlugIns|Plug-ins|XPCServices|Helpers|MacOS|Library/(Automator|Spotlight|LoginItems))/</key>
-		<dict>
-			<key>nested</key>
-			<true/>
-			<key>weight</key>
-			<real>10</real>
-		</dict>
-		<key>^.*</key>
-		<true/>
-		<key>^Info\.plist$</key>
-		<dict>
-			<key>omit</key>
-			<true/>
-			<key>weight</key>
-			<real>20</real>
-		</dict>
-		<key>^PkgInfo$</key>
-		<dict>
-			<key>omit</key>
-			<true/>
-			<key>weight</key>
-			<real>20</real>
-		</dict>
-		<key>^Resources/</key>
-		<dict>
-			<key>weight</key>
-			<real>20</real>
-		</dict>
-		<key>^Resources/.*\.lproj/</key>
-		<dict>
-			<key>optional</key>
-			<true/>
-			<key>weight</key>
-			<real>1000</real>
-		</dict>
-		<key>^Resources/.*\.lproj/locversion.plist$</key>
-		<dict>
-			<key>omit</key>
-			<true/>
-			<key>weight</key>
-			<real>1100</real>
-		</dict>
-		<key>^Resources/Base\.lproj/</key>
-		<dict>
-			<key>weight</key>
-			<real>1010</real>
-		</dict>
-		<key>^[^/]+$</key>
-		<dict>
-			<key>nested</key>
-			<true/>
-			<key>weight</key>
-			<real>10</real>
-		</dict>
-		<key>^embedded\.provisionprofile$</key>
-		<dict>
-			<key>weight</key>
-			<real>20</real>
-		</dict>
-		<key>^version\.plist$</key>
-		<dict>
-			<key>weight</key>
-			<real>20</real>
-		</dict>
-	</dict>
-</dict>
-</plist>