lark-remote 0.1.2 → 0.1.4

package/dist/index.js

@@ -5,6 +5,7 @@ import { parseCliArgs, resolveConfigDir, setConfigDir, printHelp, printVersion,
 import { FeishuConnector } from './connector/index.js';
 import { ClaudeRunner, CodexExecRunner, OpencodeExecRunner, PiRunner, KimiRunner, } from './runner/index.js';
 import { AgentRegistry } from './runner/registry.js';
+import { probeAllAgents } from './runner/probe.js';
 import { SessionReaderRegistry, SessionStore } from './session/index.js';
 import { ClaudeSessionReader, CodexSessionReader, OpencodeSessionReader, PiSessionReader, KimiSessionReader, } from './session/index.js';
 import { CommandRouter, isImmediateAction, formatUsageStats, } from './router/index.js';
@@ -21,6 +22,7 @@ import { markdownDiv } from './card/collapsible.js';
 import { sessionEventPanel } from './router/card-helpers.js';
 import { newSessionButton, agentDisplayName } from './card/card-shared.js';
 import path from 'node:path';
+import fs from 'node:fs';
 /** Send auto-resume card for a restored session */
 async function sendAutoResumeCard(connector, contact, cwd, session, state) {
     if (!contact.userId)
@@ -145,14 +147,13 @@ function setupInstanceLockAndHandlers(instanceLock, logger, configDir) {
 function initializeRunner(config, configDir, cliArgs) {
     const agentRegistry = new AgentRegistry();
     // P1-15: Claude factory reads from configContainer (not closure) so runtime
-    // config changes (binary, model, effort, stopGraceMs) take effect after
+    // config changes (model, effort, stopGraceMs) take effect after
     // bridge.setConfig() + clearRunners(). Same pattern as codex/pi/kimi.
     agentRegistry.register('claude', (ws) => {
         const container = agentRegistry.getConfigContainer();
         const latestConfig = container?.current ?? config;
         const claudeConfig = latestConfig.claude;
         return new ClaudeRunner({
-            binary: claudeConfig.binary,
             model: claudeConfig.model,
             effort: claudeConfig.effort,
             stopGraceMs: claudeConfig.stopGraceMs,
@@ -170,7 +171,6 @@ function initializeRunner(config, configDir, cliArgs) {
         const latestConfig = container?.current ?? config;
         const codexConfig = getAgentConfig(latestConfig, 'codex');
         return new CodexExecRunner({
-            binary: codexConfig?.binary ?? 'codex',
             model: codexConfig?.model,
             modelProvider: codexConfig?.modelProvider,
             reasoningEffort: codexConfig?.reasoningEffort,
@@ -182,20 +182,17 @@ function initializeRunner(config, configDir, cliArgs) {
     });
     // Register OpencodeExecRunner (run mode)
     // Using `opencode run --format json --auto` instead of HTTP+SSE server mode
-    const opencodeConfig = getAgentConfig(config, 'opencode');
     // Register session reader (same instance as used by runner)
     const sessionReaderRegistry = new SessionReaderRegistry();
     sessionReaderRegistry.register('claude', new ClaudeSessionReader());
     sessionReaderRegistry.register('codex', codexSessionReader);
     // Register OpencodeSessionReader (CLI version)
     // Using `opencode session list` and `opencode export` instead of HTTP API
-    const opencodeSessionReader = new OpencodeSessionReader({
-        binary: opencodeConfig?.binary ?? 'opencode',
-    });
+    const opencodeSessionReader = new OpencodeSessionReader();
     agentRegistry.register('opencode', (ws) => {
         // Get latest config from container (set below for pi)
         const container = agentRegistry.getConfigContainer();
-        const latestConfig = container?.current;
+        const latestConfig = container?.current ?? config;
         const ocConfig = getAgentConfig(latestConfig, 'opencode');
         // Build model string with validation: provider/model format
         let model;
@@ -210,7 +207,6 @@ function initializeRunner(config, configDir, cliArgs) {
             }
         }
         return new OpencodeExecRunner({
-            binary: ocConfig?.binary ?? 'opencode',
             model,
             // P1-15: read stopGraceMs from latestConfig (not startup closure)
             stopGraceMs: latestConfig.claude?.stopGraceMs ?? DEFAULT_STOP_GRACE_MS,
@@ -230,10 +226,9 @@ function initializeRunner(config, configDir, cliArgs) {
     agentRegistry.register('pi', (ws) => {
         // 每次 factory 调用时从 registry 获取最新 config
         const container = agentRegistry.getConfigContainer();
-        const latestConfig = container?.current;
+        const latestConfig = container?.current ?? config;
         const piConf = getAgentConfig(latestConfig, 'pi');
         return new PiRunner({
-            binary: piConf?.binary ?? 'pi',
             provider: piConf?.provider ?? 'Volcano',
             model: piConf?.model ?? 'glm-5.2',
             thinking: piConf?.thinking ?? 'medium',
@@ -252,12 +247,12 @@ function initializeRunner(config, configDir, cliArgs) {
     agentRegistry.register('kimi', (ws) => {
         // 每次 factory 调用时从 registry 获取最新 config
         const container = agentRegistry.getConfigContainer();
-        const latestConfig = container?.current;
+        const latestConfig = container?.current ?? config;
         const kimiConf = getAgentConfig(latestConfig, 'kimi');
         return new KimiRunner({
-            binary: kimiConf?.binary ?? 'kimi',
             model: kimiConf?.model ?? 'kimi-code/k3',
             thinkingEffort: kimiConf?.thinkingEffort ?? 'max',
+            // P1-15: read stopGraceMs from latestConfig (not startup closure)
             stopGraceMs: latestConfig.claude?.stopGraceMs ?? DEFAULT_STOP_GRACE_MS,
             pidDir: configDir,
             workspace: ws,
@@ -273,10 +268,25 @@ function initializeRunner(config, configDir, cliArgs) {
     agentRegistry.registerDisplayName('kimi', 'Kimi');
     // 设置全局 registry，供 agentDisplayName 等全局函数使用
     AgentRegistry.setGlobalInstance(agentRegistry);
+    // Probe agent CLI availability (fire-and-forget, populates cache for /config card).
+    // Don't block startup — log unavailable agents as warnings.
+    probeAllAgents()
+        .then((availability) => {
+        const unavailable = [...availability.entries()].filter(([, ok]) => !ok).map(([kind]) => kind);
+        if (unavailable.length > 0) {
+            getLogger().warn(`[probe] agent CLI not found or not functional: ${unavailable.join(', ')}`);
+        }
+        else {
+            getLogger().info('[probe] all agent CLIs available');
+        }
+    })
+        .catch(() => {
+        // Probe failure is non-fatal; /config card will retry on open.
+    });
     return { agentRegistry, sessionReaderRegistry };
 }
 /** Setup message and card action handlers. */
-function setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger) {
+function setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger, config) {
     connector.setMessageHandler((msg) => {
         // 绑定/授权闸门：仅 owner 放行；非 owner 静默丢弃；未绑定时要求 PIN 认领
         const decision = binder.classify(msg.userId, msg.content, msg.chatId);
@@ -286,9 +296,50 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         if (decision.kind === 'pin_wrong')
             return;
         if (decision.kind === 'bind_success') {
-            void connector
-                .sendWithRetry(msg.chatId, { text: '✅ 已绑定到本账号，此后仅你可使用本应用' })
-                .catch((err) => logger.error('[binder] bind-success reply failed:', err));
+            // First-run onboarding: set default cwd + send welcome + Help card.
+            // setCwd is synchronous (outside the async closure) so that the user's
+            // next message — which will hit the `owner` branch now that
+            // startup-contact.json has been written — finds cwd already set.
+            // process.cwd() is the only sensible default: the user started
+            // lark-remote in the directory they want to work in.
+            // setCwd only when no cwd is set yet (e.g. fresh start after bind).
+            // Don't overwrite an existing cwd — the user may have already set one
+            // via /cd or a previous bind. Use realpath for canonical form (matching
+            // Claude JSONL cwd, e.g. /tmp → /private/tmp on macOS).
+            let resolvedCwd;
+            try {
+                resolvedCwd = fs.realpathSync(process.cwd());
+            }
+            catch {
+                resolvedCwd = process.cwd();
+            }
+            if (!sessionStore.getCwd(msg.userId)) {
+                sessionStore.setCwd(msg.userId, resolvedCwd);
+            }
+            void (async () => {
+                try {
+                    // Message 1: bind confirmation + status (combined to avoid
+                    // Feishu out-of-order delivery across three separate messages).
+                    await connector.sendWithRetry(msg.chatId, {
+                        text: `✅ 已绑定到本账号，此后仅你可使用本应用\n` +
+                            `📂 当前工作目录: \`${resolvedCwd}\`\n` +
+                            `🤖 默认 Agent: ${agentDisplayName(config.defaultAgent)}\n` +
+                            `💡 直接输入消息即可开始对话，或 /cd 切换目录`,
+                    });
+                    // Message 2: Help card.
+                    // Use router.cmdHelp() + manual send (without replyTo) so the Help
+                    // card appears as an independent message, not a reply to the PIN
+                    // message. router.handle('/help') would set replyTo=msg.messageId
+                    // (the PIN), causing the card to nest under the PIN in Feishu UI.
+                    const helpResult = router.cmdHelp();
+                    if (helpResult.card) {
+                        await connector.sendWithRetry(msg.chatId, { card: helpResult.card });
+                    }
+                }
+                catch (err) {
+                    logger.error('[binder] onboarding send failed:', err);
+                }
+            })();
             return;
         }
         // decision.kind === 'owner'：正常处理（不再每条覆盖 startup-contact）
@@ -343,7 +394,9 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         if (!workspace && workspaceStore) {
             const workspaces = workspaceStore.list();
             if (workspaces.length > 0) {
-                workspace = workspaces[0][1];
+                // NOTE: fallback uses insertion order, not sort preference — by design
+                // (workspace-sorting.md §9: cwd fallback stays insertion-order for now)
+                workspace = workspaces[0].path;
             }
         }
         // Step4/D4: 入队时刻（T0）快照 agent+session，随任务闭包带到 T1 执行时刻，
@@ -486,7 +539,7 @@ async function main() {
     logger.info('config loaded');
     logger.info(`configDir = ${configDir}`);
     logger.info(`feishu.appId = ${config.feishu.appId}`);
-    logger.info(`claude.binary = ${config.claude.binary}`);
+    logger.info(`claude.model = ${config.claude.model}`);
     if (cliArgs.settings) {
         logger.info(`claude.settings = ${cliArgs.settings}`);
     }
@@ -522,7 +575,7 @@ async function main() {
         restartSpawner: () => spawnReplacementBridge(path.join(configDir, 'logs')),
         sessionReaderRegistry,
     });
-    setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger);
+    setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger, config);
     try {
         await connector.connect();
     }
@@ -532,7 +585,7 @@ async function main() {
     }
     if (binder.isBound()) {
         // 仅已绑定时发送启动通知；未绑定时不打扰（PIN 引导已在控制台输出）
-        await sendStartupHello(connector, startupContactStore);
+        await sendStartupHello(connector, startupContactStore, { dev: cliArgs.dev });
     }
     // Auto-restore: resume the persisted sessionId if available
     const restoredContact = startupContactStore.getContact();

package/dist/router/config/codex.js

@@ -6,14 +6,12 @@ export class CodexConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
         // 从 codex config.toml 动态读取 provider 和 model
-        const codexBinary = displayConfig.agents?.codex?.binary ?? 'codex';
-        const codexCfg = loadCodexConfig({ binary: codexBinary });
+        const codexCfg = loadCodexConfig();
         const codexProviderNames = codexCfg.providerNames;
         const currentModelProvider = displayConfig.agents?.codex?.modelProvider ?? codexCfg.currentProvider;
         const currentCodexModel = displayConfig.agents?.codex?.model ?? codexCfg.currentModel;
-        const currentReasoningEffort = displayConfig.agents?.codex?.reasoningEffort ??
-            getDefaultReasoningEffort(currentCodexModel, codexBinary);
-        // 传入当前 provider 过滤模型列���
+        const currentReasoningEffort = displayConfig.agents?.codex?.reasoningEffort ?? getDefaultReasoningEffort(currentCodexModel);
+        // 传入当前 provider 过滤模型列表
         const codexModelOptions = codexCfg.modelOptions(currentModelProvider);
         fields.push({
             key: 'agents.codex.modelProvider',
@@ -42,7 +40,7 @@ export class CodexConfigBuilder {
             label: '推理强度',
             type: 'select',
             // 档位按目录实际声明透传（P2-5）：codex 支持 none/Custom，不再按标准枚举过滤
-            options: getReasoningEffortOptions(currentCodexModel, codexBinary),
+            options: getReasoningEffortOptions(currentCodexModel),
             currentValue: currentReasoningEffort,
         });
         return fields;
@@ -50,10 +48,9 @@ export class CodexConfigBuilder {
     handleFieldChange(key, value, config) {
         const patches = [];
         patches.push({ key, value });
-        // provider 变更时，重置 model 为�� provider 的首个模型
+        // provider 变更时，重置 model 为新 provider 的首个模型
         if (key === 'agents.codex.modelProvider' && typeof value === 'string') {
-            const codexBinary = config.agents?.codex?.binary ?? 'codex';
-            const codexCfg = loadCodexConfig({ binary: codexBinary });
+            const codexCfg = loadCodexConfig();
             const newModelOptions = codexCfg.modelOptions(value);
             const currentModel = config.agents?.codex?.model;
             const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
@@ -86,14 +83,13 @@ export class CodexConfigBuilder {
      *   对 undefined 做键删除，P1）。
      */
     effortPatchForModel(config, newModel) {
-        const codexBinary = config.agents?.codex?.binary ?? 'codex';
         const currentReasoningEffort = config.agents?.codex?.reasoningEffort;
-        const newModelSupportedEfforts = getReasoningEffortOptions(newModel, codexBinary);
+        const newModelSupportedEfforts = getReasoningEffortOptions(newModel);
         const isCurrentEffortValid = currentReasoningEffort && newModelSupportedEfforts.includes(currentReasoningEffort);
         if (isCurrentEffortValid)
             return null;
         const middle = newModelSupportedEfforts[Math.floor((newModelSupportedEfforts.length - 1) / 2)];
-        const newEffort = middle ?? getDefaultReasoningEffort(newModel, codexBinary);
+        const newEffort = middle ?? getDefaultReasoningEffort(newModel);
         return { key: 'agents.codex.reasoningEffort', value: newEffort };
     }
 }

package/dist/router/config/index.d.ts

@@ -16,3 +16,13 @@ import type { AgentConfigCardBuilder } from './types.js';
 export declare function getConfigBuilder(agent: AgentKind): AgentConfigCardBuilder;
 /** List all registered agent kinds. */
 export declare function listRegisteredAgents(): AgentKind[];
+/**
+ * Sort agent kinds for UI lists: agents that are definitively unavailable
+ * (availability === false) sink to the bottom; everything else keeps its
+ * input order. The sort is stable, so relative order within both groups is
+ * preserved (e.g. registration order in the config card selector).
+ *
+ * `undefined` (probe cache missing/expired) is treated as "keep in place",
+ * so a stale cache cannot misplace installed agents.
+ */
+export declare function sortAgentsByAvailability(kinds: AgentKind[], isAvailable: (kind: AgentKind) => boolean | undefined): AgentKind[];

package/dist/router/config/index.js

@@ -35,4 +35,21 @@ export function getConfigBuilder(agent) {
 export function listRegisteredAgents() {
     return Object.keys(builders);
 }
+/**
+ * Sort agent kinds for UI lists: agents that are definitively unavailable
+ * (availability === false) sink to the bottom; everything else keeps its
+ * input order. The sort is stable, so relative order within both groups is
+ * preserved (e.g. registration order in the config card selector).
+ *
+ * `undefined` (probe cache missing/expired) is treated as "keep in place",
+ * so a stale cache cannot misplace installed agents.
+ */
+export function sortAgentsByAvailability(kinds, isAvailable) {
+    const unavailable = new Set(kinds.filter((kind) => isAvailable(kind) === false));
+    return [...kinds].sort((a, b) => {
+        const rankA = unavailable.has(a) ? 1 : 0;
+        const rankB = unavailable.has(b) ? 1 : 0;
+        return rankA - rankB;
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/router/index.d.ts

@@ -17,6 +17,7 @@ interface CommandResult {
  * These bypass the serial queue and execute immediately.
  *
  * ws.use   — /ws list card "使用 <name>"
+ * ws.page  — /ws list card "上一页/下一页"
  * queue.immediate — queue card "立即执行" button (§9.6)
  * queue.cancel    — queue card "撤销" button
  * queue.diagnose  — queue card "诊断" button
@@ -25,6 +26,7 @@ interface CommandResult {
  * new-session — clear sessionId only
  * stop        — interrupt current run
  * ls.file     — send file only
+ * ws.page     — paginate /ws list only
  * ws.remove   — delete workspace alias only
  * resume.use  — set sessionId + agent for correct reader routing
  * help.*      — read-only help commands
@@ -73,6 +75,8 @@ interface CardActionResponse {
     [key: string]: unknown;
 }
 export declare class CommandRouter {
+    /** Valid agent kinds — single source of truth for resume.use / resume.page / cmdResume. */
+    static readonly VALID_AGENTS: readonly ["claude", "codex", "opencode", "pi", "kimi"];
     private sessionStore;
     private bridge;
     private config;
@@ -96,6 +100,11 @@ export declare class CommandRouter {
      * millisecond); the counter guarantees uniqueness regardless of timing.
      */
     private orderExecKeyCounter;
+    /**
+     * Per-user sort preference for /ws list (memory-only, not persisted).
+     * Default 'recent' (most recently used first), can toggle to 'alpha'.
+     */
+    private wsSortPreference;
     /**
      * Session reader registry for multi-agent path. Resolves the right
      * reader by `config.defaultAgent` (and per-agent override params).
@@ -187,6 +196,11 @@ export declare class CommandRouter {
      * Mirrors handleLsPage — updates the same card, never sends a new one.
      */
     private handleResumePage;
+    /**
+     * Handle active.page: paginate the /active run list in place.
+     * Mirrors handleResumePage — updates the same card, never sends a new one.
+     */
+    private handleActivePage;
     /**
      * Handle ls.browse: browse directory without switching cwd.
      */
@@ -223,12 +237,36 @@ export declare class CommandRouter {
      * Handle order.delete: remove the order and update card in place.
      */
     private handleOrderDelete;
+    /**
+     * Handle order.page: paginate the /order list in place.
+     * Mirrors handleLsPage — updates the same card, never sends a new one.
+     */
+    private handleOrderPage;
+    /**
+     * Handle ws.use card action: switch to the workspace, then refresh the /ws
+     * list card in place so "recent" sort order is immediately visible.
+     *
+     * Unlike the command-line `/ws use` (which returns text), the card action
+     * uses toast + inplace refresh for a cleaner UX (matching ws.remove/ws.sort).
+     * If auto-resume produces a card, it is sent as a separate reply.
+     */
+    private handleWsUse;
     /**
      * Handle ws.remove: remove the workspace alias and refresh the /ws list card
      * in place (mirrors handleOrderDelete). Without this the stale alias would
      * remain visible on the card the user just clicked.
      */
     private handleWsRemove;
+    /**
+     * Handle ws.page: paginate the /ws list in place.
+     * Mirrors handleOrderPage — updates the same card, never sends a new one.
+     */
+    private handleWsPage;
+    /**
+     * Handle ws.sort: toggle sort preference and refresh the /ws list card.
+     * Sort preference is memory-only (not persisted); restart resets to 'recent'.
+     */
+    private handleWsSort;
     /**
      * `ls.file` card button: send file to Feishu, rejecting if > 30MB.
      */
@@ -273,7 +311,7 @@ export declare class CommandRouter {
      */
     private propagateConfigSave;
     private executeCommand;
-    private cmdHelp;
+    cmdHelp(): CommandResult;
     private cmdStatus;
     private cmdPs;
     private cmdStop;
@@ -307,6 +345,7 @@ export declare class CommandRouter {
     /**
      * Build CardKit 2.0 /active card from bridge memory (not file system).
      * Shows only runs that were started by THIS bridge process.
+     * Paginates with ACTIVE_PAGE_SIZE (default 20) items per page.
      */
     private buildActiveCardFromMemory;
     private cmdReconnect;