@agentdock/agent-runtime-core 0.0.97

package/dist/acpTypes.d.ts

@@ -0,0 +1,171 @@
+export type ProcessState = 'idle' | 'running' | 'error' | 'disposed';
+
+export interface AgentMessageRouting {
+    readonly parentToolUseId?: string;
+    
+    readonly sourceAgent?: {
+        readonly threadId: string;
+        readonly label: string;
+        
+        readonly parentSpawnCallId?: string;
+    };
+}
+
+export type AgentMessage = ({
+    readonly type: 'text';
+    readonly content: string;
+    readonly thinking: boolean;
+} & AgentMessageRouting) | ({
+    readonly type: 'tool-call';
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly input: unknown;
+    
+    readonly toolTitle?: string;
+    
+    readonly atomic?: boolean;
+} & AgentMessageRouting) | ({
+    readonly type: 'tool-result';
+    readonly toolCallId: string;
+    readonly output: string;
+    readonly isError: boolean;
+} & AgentMessageRouting) | {
+    readonly type: 'status';
+    readonly status: 'idle' | 'working' | 'error' | 'cancelled';
+} | {
+    readonly type: 'error';
+    readonly message: string;
+} | {
+    readonly type: 'warning';
+    readonly message: string;
+} | ({
+    readonly type: 'permission-request';
+    readonly requestId: string;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly input: unknown;
+    
+    readonly toolTitle?: string;
+} & AgentMessageRouting) | {
+    readonly type: 'result';
+    readonly totalCostUsd?: number;
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly durationMs?: number;
+    readonly cliSessionId?: string;
+    readonly isError?: boolean;
+    
+    readonly errorMessage?: string;
+    readonly numTurns?: number;
+} | {
+    readonly type: 'usage';
+    readonly model?: string;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+} | {
+    readonly type: 'session-id';
+    readonly cliSessionId: string;
+} | {
+    readonly type: 'event';
+    readonly name: string;
+    readonly payload: unknown;
+} | {
+    readonly type: 'task-lifecycle';
+    readonly subtype: 'task_started' | 'task_progress' | 'task_notification' | 'task_updated';
+    readonly taskId: string;
+    readonly toolUseId?: string;
+    readonly taskType?: string;
+    readonly taskStatus?: 'completed' | 'failed' | 'stopped' | 'killed' | 'pending' | 'running';
+    readonly description?: string;
+    readonly summary?: string;
+    readonly isBackgrounded?: boolean;
+    readonly taskUsage?: {
+        readonly totalTokens: number;
+        readonly toolUses: number;
+        readonly durationMs: number;
+    };
+} | {
+    readonly type: 'tool-progress';
+    readonly toolUseId: string;
+    readonly toolName: string;
+    readonly parentToolUseId: string | null;
+    readonly elapsedTimeSeconds: number;
+    readonly taskId?: string;
+} | {
+    readonly type: 'compact-boundary';
+    
+    readonly trigger: 'manual' | 'auto' | 'unknown';
+    readonly preTokens?: number;
+    readonly postTokens?: number;
+    readonly durationMs?: number;
+    
+    readonly summary?: string;
+} | {
+    readonly type: 'hook-event';
+    readonly subtype: 'hook_started' | 'hook_response';
+    readonly hookName?: string;
+    readonly hookEvent?: string;
+    readonly hookMessage?: string;
+} | {
+    
+    readonly type: 'collaboration';
+    readonly action: 'started' | 'interacted' | 'interrupted' | 'waiting' | 'resumed' | 'closed';
+    readonly agent: {
+        readonly threadId: string;
+        readonly label: string;
+    };
+};
+
+export type MessageListener = (message: AgentMessage) => void;
+
+export type CompactThreadResult = {
+    readonly status: 'compacted';
+    readonly threadId: string;
+} | {
+    readonly status: 'aborted';
+} | {
+    readonly status: 'failed';
+    readonly reason?: string;
+};
+
+export interface AgentBackend {
+    
+    start(): Promise<void>;
+    
+    sendMessage(text: string, images?: ReadonlyArray<{
+        data: string;
+        mediaType: string;
+    }>, messageUuid?: string): Promise<void>;
+    
+    cancel(): Promise<void>;
+    
+    dispose(): Promise<void>;
+    
+    onMessage(listener: MessageListener): void;
+    
+    onSessionId?(listener: (id: string) => void): void;
+    
+    getState(): ProcessState;
+    
+    resolvePermission?: (requestId: string, approved: boolean, reason?: string, inputOverrides?: Record<string, unknown>) => Promise<void>;
+    
+    addAllowedTools?: (tools: readonly string[]) => void;
+    
+    getAllowedTools?: () => readonly string[];
+    
+    setPermissionMode?: (mode: string) => void;
+    
+    setAutoApproveEdits?: (value: boolean) => void;
+    
+    getCurrentModel?: () => string | undefined;
+    
+    switchModel?: (modelId: string) => Promise<boolean>;
+    
+    switchMode?: (modeId: string) => Promise<boolean>;
+    
+    compactThread?: () => Promise<CompactThreadResult>;
+    
+    sendControlRequest?: (subtype: string, params: Record<string, unknown>) => Promise<Record<string, unknown>>;
+}

package/dist/acpTypes.js

@@ -0,0 +1 @@
+"use strict";export{};

package/dist/adapters/dingtalk.d.ts

@@ -0,0 +1,11 @@
+export interface DingtalkMarkdownParams {
+    readonly title: string;
+    readonly body: string;
+    readonly footer?: string;
+}
+export declare function sendDingtalkMarkdown(webhookUrl: string, params: DingtalkMarkdownParams): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;

package/dist/adapters/dingtalk.js

@@ -0,0 +1,7 @@
+"use strict";import{postWebhookJson as k}from"./webhookClient.js";function i(o){const n=o;return n.errcode!==0?`dingtalk error: ${n.errmsg??"unknown"}`:null}export async function sendDingtalkMarkdown(o,n){const t=n.footer||"",r=t?`
+
+> CCPark \xB7 ${t}`:`
+
+> CCPark`,e={msgtype:"markdown",markdown:{title:"CCPark \u901A\u77E5",text:`## ${n.title}
+
+${n.body}${r}`}};return k(o,e,i,"dingtalk")}

package/dist/adapters/feishu.d.ts

@@ -0,0 +1,13 @@
+export interface FeishuCardParams {
+    readonly title: string;
+    readonly body: string;
+    readonly color: 'red' | 'yellow' | 'green' | 'blue';
+    readonly footer: string;
+    readonly url?: string;
+}
+export declare function sendFeishuCard(webhookUrl: string, params: FeishuCardParams): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;

package/dist/adapters/feishu.js

@@ -0,0 +1 @@
+"use strict";import{postWebhookJson as r}from"./webhookClient.js";function i(n){const t=n;return t.code!==0?`feishu error: ${t.msg??"unknown"}`:null}export async function sendFeishuCard(n,t){const e=[{tag:"div",text:{tag:"lark_md",content:t.body}}];t.url&&e.push({tag:"action",actions:[{tag:"button",text:{tag:"plain_text",content:"\u67E5\u770B\u8BE6\u60C5"},type:"default",url:t.url}]}),e.push({tag:"hr"}),e.push({tag:"note",elements:[{tag:"plain_text",content:`CCPark \xB7 ${t.footer}`}]});const o={msg_type:"interactive",card:{header:{title:{tag:"plain_text",content:t.title},template:t.color},elements:e}};return r(n,o,i,"feishu")}

package/dist/adapters/webhookClient.d.ts

@@ -0,0 +1,8 @@
+export declare const IM_WEBHOOK_TIMEOUT_MS = 10000;
+
+export declare function postWebhookJson(webhookUrl: string, payload: unknown, parseResponse: (json: unknown) => string | null, adapterName: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;

package/dist/adapters/webhookClient.js

@@ -0,0 +1 @@
+"use strict";export const IM_WEBHOOK_TIMEOUT_MS=1e4;export async function postWebhookJson(e,n,s,r){try{const t=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n),signal:AbortSignal.timeout(1e4)});if(!t.ok){const i=await t.text().catch(()=>"");return{ok:!1,error:`${r} returned ${t.status}: ${i.slice(0,200)}`}}const a=await t.json(),o=s(a);return o!==null?{ok:!1,error:o}:{ok:!0}}catch(t){return{ok:!1,error:`${r} fetch failed: ${String(t)}`}}}

package/dist/agentSettings.d.ts

@@ -0,0 +1,42 @@
+import type { AgentSettings, AgentEnvConfig, ModelSource, LocalAgentSettings } from '@agentdock/wire';
+import type { Logger } from './logger.js';
+export declare function projectAiHelperConfig(settings: LocalAgentSettings): AgentSettings['aiHelper'];
+
+export declare function sanitizeAgentSettingsForRpc(settings: AgentSettings): Record<string, unknown>;
+
+export declare function mergeAgentSettings(settings: LocalAgentSettings, update: AgentSettings): LocalAgentSettings;
+
+export declare function mergeAiHelperEnabled(settings: LocalAgentSettings, enabled: boolean): LocalAgentSettings;
+export declare function getAgentSettingsPath(): string;
+
+export declare function loadAgentSettings(): LocalAgentSettings;
+
+export declare function loadAgentSettingsForRpc(): AgentSettings;
+
+export declare function updateAgentSettings(update: AgentSettings): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+
+export declare function validateAgentSettingsFile(log?: Logger): {
+    ok: true;
+    data: LocalAgentSettings;
+} | {
+    ok: false;
+    error: string;
+};
+
+export declare function saveAgentSettings(settings: LocalAgentSettings): void;
+
+export declare function resolveAgentEnv(agentType: string, overrideEnv?: Record<string, string>): Record<string, string> | undefined;
+export declare function buildEnvFromConfig(config: AgentEnvConfig): Record<string, string>;
+
+export declare function getAllCustomModels(): Record<string, readonly {
+    id: string;
+    displayName: string;
+    isDefault: boolean;
+    hidden: boolean;
+    source: ModelSource;
+}[]>;

package/dist/agentSettings.js

@@ -0,0 +1 @@
+"use strict";import y from"node:path";import h from"node:fs";import{AgentSettingsSchema as x,LocalAgentSettingsSchema as f,AiHelperConfigSchema as S,AGENT_ENV_NONE as p,SPAWNABLE_AGENTS as A,getAgentCapability as P}from"@agentdock/wire";import{getDaemonDir as b}from"./paths.js";import{readJsonFile as d,writeJsonFile as E}from"./jsonFileUtils.js";import{errnoCode as m,isRecord as c}from"./typeGuards.js";const H="agent-settings.json";export function projectAiHelperConfig(e){return e.aiHelper?{enabled:e.aiHelper.enabled}:void 0}export function sanitizeAgentSettingsForRpc(e){const{notification:t,aiHelper:r,...o}=e,s={};for(const[n,i]of Object.entries(o))if(n==="defaults"||typeof i=="object"&&i!==null&&!Array.isArray(i)){const a=i,{customEnv:g,...l}=a;s[n]=l}else s[n]=i;return r&&(s.aiHelper=r),s}export function mergeAgentSettings(e,t){const r={...e};for(const[o,s]of Object.entries(t))if(!(o==="version"||s===void 0))if(typeof s=="object"&&s!==null&&!Array.isArray(s)){const n=r[o]??{};r[o]={...n,...s}}else r[o]=s;return r}export function mergeAiHelperEnabled(e,t){return mergeAgentSettings(e,{aiHelper:{enabled:t}})}export function getAgentSettingsPath(){return y.join(b(),H)}function u(){return getAgentSettingsPath()}export function loadAgentSettings(){const e=d(u(),null);if(e===null)return{};if(c(e)&&e.version!==void 0&&e.version!==1)return{};const t=f.safeParse(e);return t.success?t.data:{}}export function loadAgentSettingsForRpc(){const e=d(u(),null);if(e===null)return{};if(c(e)&&e.version!==void 0&&e.version!==1)return{};const t=f.safeParse(e);if(t.success){const{version:g,aiHelper:l,...v}=t.data;return{...v,aiHelper:projectAiHelperConfig({aiHelper:l})}}if(!c(e))return{};const r=e,{aiHelper:o,version:s,...n}=r,i=x.omit({aiHelper:!0}).safeParse(n),a=c(o)&&typeof o.enabled=="boolean"?S.safeParse({enabled:o.enabled}):{success:!1};return i.success&&a.success?{...i.data,aiHelper:a.data}:{}}export function updateAgentSettings(e){const t=d(u(),null);return t!==null&&!c(t)?{ok:!1,error:"agent-settings-local-config-invalid"}:c(t)&&t.version!==void 0&&t.version!==1?{ok:!1,error:"agent-settings-local-config-version-unsupported"}:(saveAgentSettings(mergeAgentSettings(t??{},e)),{ok:!0})}export function validateAgentSettingsFile(e){const t=u();let r;try{r=h.readFileSync(t,"utf-8")}catch(n){if(m(n)!=="ENOENT"){const i=`agent-settings.json could not be read: ${n instanceof Error?n.message:String(n)}`;return e?.warn({err:n,errno:m(n),filePath:t,module:"daemon:settings"},i),{ok:!1,error:i}}return{ok:!0,data:{}}}let o;try{o=JSON.parse(r)}catch(n){return e&&e.warn({err:n,module:"daemon:settings"},"agent-settings.json contains invalid JSON"),{ok:!1,error:`Invalid JSON: ${String(n)}`}}const s=f.safeParse(o);return s.success?{ok:!0,data:s.data}:(e&&e.warn({error:s.error.message,module:"daemon:settings"},"agent-settings.json failed schema validation"),{ok:!1,error:s.error.message})}export function saveAgentSettings(e){E(u(),{version:1,...e})}function j(e,t){const r=(n,i)=>{if(n!==p)return n??i},o=e?.customEnv||t?.customEnv?Object.fromEntries(Object.entries({...e?.customEnv,...t?.customEnv}).filter(([,n])=>n!==p)):void 0,s=e?.customModels||t?.customModels?[...e?.customModels??[],...t?.customModels??[]]:void 0;return{httpProxy:r(t?.httpProxy,e?.httpProxy),httpsProxy:r(t?.httpsProxy,e?.httpsProxy),customEnv:o&&Object.keys(o).length>0?o:void 0,customModels:s&&s.length>0?s:void 0}}export function resolveAgentEnv(e,t){const r=loadAgentSettings(),o=r[e],s=j(r.defaults,o),n=buildEnvFromConfig(s);if(!(Object.keys(n).length===0&&!t))return{...n,...t}}export function buildEnvFromConfig(e){const t={};if(e.httpProxy&&(t.HTTP_PROXY=e.httpProxy,t.http_proxy=e.httpProxy),e.httpsProxy&&(t.HTTPS_PROXY=e.httpsProxy,t.https_proxy=e.httpsProxy),e.customEnv)for(const[r,o]of Object.entries(e.customEnv))t[r]=o;return t}export function getAllCustomModels(){const e=loadAgentSettings(),t={};for(const r of A){if(!P(r).acceptsCustomModels)continue;const o=e.defaults?.customModels??[],n=(c(e)?e[r]:void 0)?.customModels??[],i=new Map;for(const a of o)i.set(a.id,{id:a.id,displayName:a.label,isDefault:!1,hidden:!1,source:"custom"});for(const a of n)i.set(a.id,{id:a.id,displayName:a.label,isDefault:!1,hidden:!1,source:"custom"});i.size>0&&(t[r]=[...i.values()])}return t}

package/dist/agentSpawnTypes.d.ts

@@ -0,0 +1,76 @@
+import type { AccountLanguage, ModelSource } from '@agentdock/wire';
+import type { Logger } from './logger.js';
+
+export interface AgentSpawnConfig {
+    readonly cwd: string;
+    readonly prompt: string;
+    
+    readonly responseLanguage?: AccountLanguage;
+    readonly env?: Record<string, string>;
+    readonly customCommand?: string;
+    readonly customArgs?: readonly string[];
+    readonly model?: string;
+    readonly appendSystemPrompt?: string;
+    readonly allowedTools?: readonly string[];
+    readonly disallowedTools?: readonly string[];
+    readonly mcpConfig?: string;
+    readonly mcpServers?: readonly {
+        readonly name: string;
+        readonly command: string;
+        readonly args?: readonly string[];
+        readonly env?: Readonly<Record<string, string>>;
+    }[];
+    readonly developerInstructions?: string;
+    readonly permissionMode?: string;
+    readonly resumeSessionId?: string;
+    readonly maxTurns?: number;
+    readonly onSessionId?: (id: string) => void;
+    readonly onModelsRefreshed?: (models: readonly {
+        id: string;
+        displayName: string;
+        isDefault: boolean;
+        hidden: boolean;
+        source?: ModelSource;
+    }[]) => void;
+    readonly onModesRefreshed?: (modes: readonly {
+        id: string;
+        label: string;
+    }[]) => void;
+    readonly onStderr?: (line: string) => void;
+    readonly onCompatibilityFailure?: (failure: {
+        readonly detectedVersion: string | null;
+        readonly reasonCode: 'protocol_handshake_failed' | 'required_capability_missing';
+        readonly policyVersion: string;
+        readonly stage: 'acp_initialize';
+    }) => void;
+    readonly logger?: Logger;
+    readonly isScheduled?: boolean;
+    readonly systemPrompt?: string;
+    readonly systemPromptFile?: string;
+    readonly appendSystemPromptFile?: string;
+    readonly fallbackModel?: string;
+    readonly maxBudgetUsd?: number;
+    readonly tools?: readonly string[];
+    readonly effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    readonly addDirs?: readonly string[];
+    readonly agent?: string;
+    readonly agents?: string;
+    readonly jsonSchema?: string;
+    readonly strictMcpConfig?: boolean;
+    readonly chrome?: boolean;
+    readonly worktree?: boolean | string;
+    readonly forkSession?: boolean;
+    readonly sessionId?: string;
+    readonly settings?: string;
+    readonly betas?: readonly string[];
+    readonly brief?: boolean;
+    readonly noSessionPersistence?: boolean;
+    readonly includePartialMessages?: boolean;
+    readonly replayUserMessages?: boolean;
+    readonly settingSources?: string;
+    readonly disableSlashCommands?: boolean;
+    readonly files?: readonly string[];
+    readonly pluginDirs?: readonly string[];
+    readonly dangerouslySkipPermissions?: boolean;
+    readonly allowDangerouslySkipPermissions?: boolean;
+}

package/dist/agentSpawnTypes.js

@@ -0,0 +1 @@
+"use strict";export{};

package/dist/agentStderrPolicy.d.ts

@@ -0,0 +1,6 @@
+import type { Logger } from './logger.js';
+export declare const AGENT_STDERR_SUPPRESSED = "[agent stderr suppressed]";
+export declare function agentStderrBytes(value: string): number;
+export declare function logAgentStderr(log: Logger, module: string, line: string): void;
+export declare function agentProcessExitMessage(code: number | null, stderr: string): string;
+export declare function redactedAgentStderr(stderr: string): string;

package/dist/agentStderrPolicy.js

@@ -0,0 +1 @@
+"use strict";export const AGENT_STDERR_SUPPRESSED="[agent stderr suppressed]";export function agentStderrBytes(e){return Buffer.byteLength(e,"utf8")}export function logAgentStderr(e,r,t){e.debug({source:"agent-stderr",module:r,stderrBytes:agentStderrBytes(t)},"agent emitted stderr; raw output suppressed")}export function agentProcessExitMessage(e,r){const t=`process exited (code ${e??"null"})`;return r?`${t}; stderr suppressed`:t}export function redactedAgentStderr(e){return e?AGENT_STDERR_SUPPRESSED:""}

package/dist/boundedSet.d.ts

@@ -0,0 +1,12 @@
+export declare class BoundedSet<T> {
+    private readonly set;
+    private readonly queue;
+    private readonly maxSize;
+    constructor(maxSize: number);
+    
+    has(value: T): boolean;
+    
+    add(value: T): this;
+    
+    get size(): number;
+}

package/dist/boundedSet.js

@@ -0,0 +1 @@
+"use strict";export class BoundedSet{set=new Set;queue=[];maxSize;constructor(e){if(e<1)throw new Error("BoundedSet maxSize must be >= 1");this.maxSize=e}has(e){return this.set.has(e)}add(e){if(this.set.has(e))return this;if(this.set.size>=this.maxSize){const t=this.queue.shift();t!==void 0&&this.set.delete(t)}return this.set.add(e),this.queue.push(e),this}get size(){return this.set.size}}

package/dist/brand.d.ts

@@ -0,0 +1,27 @@
+import type { AccountLanguage } from '@agentdock/wire';
+export interface BrandConfig {
+    
+    readonly npmPkg: string;
+    
+    readonly binCommand: string;
+    
+    readonly dataDir: string;
+    
+    readonly scope: string;
+    
+    readonly daemonPkg: string;
+    
+    readonly description: string;
+    
+    readonly serverUrl: string;
+    
+    readonly defaultAccountLanguage: AccountLanguage;
+}
+
+export declare function detectBrandFromPath(url?: string): BrandConfig | undefined;
+
+export declare function getBrand(): BrandConfig;
+
+export declare function getDefaultBrand(): BrandConfig;
+
+export declare function isAltBrand(): boolean;

package/dist/brand.js

@@ -0,0 +1 @@
+"use strict";import{fileURLToPath as s}from"node:url";const r={agentdock:{npmPkg:"agentdock",binCommand:"agentdock",dataDir:".agentdock",scope:"@agentdock",daemonPkg:"@agentdock/daemon",description:"AgentDock",serverUrl:"https://agentdock-api.yungujia.com",defaultAccountLanguage:"zh-Hans"},yarkai:{npmPkg:"yarkai",binCommand:"yarkai",dataDir:".yarkai",scope:"@agentdock",daemonPkg:"@agentdock/daemon",description:"YarkAI",serverUrl:"https://app-api.yark.ai",defaultAccountLanguage:"en"},ccpark:{npmPkg:"ccpark",binCommand:"ccpark",dataDir:".ccpark",scope:"@agentdock",daemonPkg:"@agentdock/daemon",description:"CCPark",serverUrl:"https://ccpark-api.yungujia.com",defaultAccountLanguage:"zh-Hans"}},d="agentdock",a=new Map;export function detectBrandFromPath(n){const t=(n??s(import.meta.url)).replace(/\\/g,"/");for(const e of Object.values(r)){const c=`node_modules/${e.npmPkg}/node_modules/${e.daemonPkg}`;if(t.includes(`/${c}/`))return e}}export function getBrand(){const n=process.env.AGENTDOCK_NPM_PACKAGE;if(n){const o=a.get(n);if(o)return o;const i=r[n];if(i)return a.set(n,i),i}const t="__path__";if(!a.has(t)){const o=detectBrandFromPath();o&&a.set(t,o)}const e=a.get(t);if(e)return e;const c=r[d];return a.set(d,c),c}export function getDefaultBrand(){return r[d]}export function isAltBrand(){return getBrand().npmPkg!==d}

package/dist/checkpointService.d.ts

@@ -0,0 +1,40 @@
+import type { Logger } from './logger.js';
+import type { CheckpointEntry, CheckpointDiffResult, CheckpointRollbackResult, RollbackMode } from '@agentdock/wire';
+interface TrackedFileBackup {
+    backupFileName: string | null;
+    version: number;
+    backupTime: string;
+}
+interface ParsedSnapshot {
+    messageId: string;
+    trackedFileBackups: Record<string, TrackedFileBackup>;
+    timestamp: string;
+}
+
+export declare function findJsonlPath(claudeSessionId: string, home?: string): Promise<string | null>;
+
+export declare function parseSnapshots(jsonlPath: string): Promise<ParsedSnapshot[]>;
+
+export declare function listCheckpoints(claudeSessionId: string, home?: string): Promise<CheckpointEntry[]>;
+
+export declare function diffCheckpoint(claudeSessionId: string, messageId: string, home?: string): Promise<CheckpointDiffResult>;
+
+export declare function rollbackCheckpoint(claudeSessionId: string, target: {
+    messageId?: string;
+    timestamp?: string;
+    toolCallId?: string;
+}, opts?: {
+    force?: boolean;
+    home?: string;
+    log?: Logger;
+    mode?: RollbackMode;
+}): Promise<CheckpointRollbackResult>;
+
+export declare function rewindFilesViaClaude(sendControl: (subtype: string, params: Record<string, unknown>) => Promise<Record<string, unknown>>, userMessageId: string, dryRun?: boolean): Promise<{
+    canRewind: boolean;
+    error?: string;
+    filesChanged?: number;
+    insertions?: number;
+    deletions?: number;
+}>;
+export {};

package/dist/checkpointService.js

@@ -0,0 +1,2 @@
+"use strict";import{createReadStream as E}from"node:fs";import{createInterface as z}from"node:readline";import{join as j,dirname as N,isAbsolute as I,resolve as L,sep as R}from"node:path";import{copyFile as J,unlink as _,stat as D,readFile as O,mkdir as U,readFile as q}from"node:fs/promises";import{getClaudeHome as A,getProjectsDir as H,decodeProjectDirName as V}from"./ingest/claudePaths.js";import{listJsonlFiles as W}from"./ingest/claudeSessionScanner.js";import{truncateConversation as $}from"./conversationRollback.js";import{isRecord as P}from"./typeGuards.js";function B(n,o){return j(A(o),"file-history",n)}export async function findJsonlPath(n,o){const r=H(o);let d;try{const{readdir:t}=await import("node:fs/promises");d=(await t(r,{withFileTypes:!0})).filter(i=>i.isDirectory()).map(i=>i.name)}catch{return null}for(const t of d){const e=j(r,t);if((await W(e)).includes(n))return j(e,`${n}.jsonl`)}return null}export async function parseSnapshots(n){const o=[],r=z({input:E(n),crlfDelay:1/0});for await(const d of r)if(d.includes("file-history-snapshot"))try{const t=JSON.parse(d);if(!P(t)||t.type!=="file-history-snapshot")continue;const e=P(t.snapshot)?t.snapshot:void 0,i=(typeof t.messageId=="string"?t.messageId:void 0)??(e&&typeof e.messageId=="string"?e.messageId:void 0),p=t.trackedFileBackups??e?.trackedFileBackups,k=(typeof t.timestamp=="string"?t.timestamp:void 0)??(e&&typeof e.timestamp=="string"?e.timestamp:void 0);if(!i||!p||!k)continue;o.push({messageId:i,trackedFileBackups:p,timestamp:k})}catch{}return o}export async function listCheckpoints(n,o){const r=await findJsonlPath(n,o);return r?(await parseSnapshots(r)).map((t,e)=>({messageId:t.messageId,timestamp:t.timestamp,trackedFileCount:Object.keys(t.trackedFileBackups).length,sequence:e})):[]}export async function diffCheckpoint(n,o,r){const d=await findJsonlPath(n,r);if(!d)return{files:[],hasExternalChanges:!1,externallyModifiedFiles:[]};const e=(await parseSnapshots(d)).find(f=>f.messageId===o);if(!e)return{files:[],hasExternalChanges:!1,externallyModifiedFiles:[]};const i=[],p=[],k=new Date(e.timestamp).getTime(),m=B(n,r);for(const[f,T]of Object.entries(e.trackedFileBackups)){let F=!1,g=0,y=0;try{const w=await D(f);F=!0,g=w.size,y=w.mtimeMs}catch{}if(T.backupFileName===null)F&&i.push({filePath:f,status:"created",currentSize:g,snapshotSize:0});else{const w=j(m,T.backupFileName);let C=0;try{C=(await D(w)).size}catch{}if(!F)i.push({filePath:f,status:"deleted",currentSize:0,snapshotSize:C});else if(g!==C)i.push({filePath:f,status:"modified",currentSize:g,snapshotSize:C});else try{const x=await O(f),s=await O(w);x.equals(s)||i.push({filePath:f,status:"modified",currentSize:g,snapshotSize:C})}catch{i.push({filePath:f,status:"modified",currentSize:g,snapshotSize:C})}}F&&y>k&&p.push(f)}return{files:i,hasExternalChanges:p.length>0,externallyModifiedFiles:p}}export async function rollbackCheckpoint(n,o,r){const d=r?.force??!1,t=r?.home,e=r?.log,i=r?.mode??"code",p=await findJsonlPath(n,t);if(!p)return e?.warn({claudeSessionId:n,module:"daemon:checkpoint"},"rollback: jsonl not found"),{restoredCount:0,deletedCount:0,skippedFiles:[],mode:i};const k=await parseSnapshots(p);let m;if(o.messageId)m=k.find(s=>s.messageId===o.messageId);else if(o.timestamp){const s=new Date(o.timestamp).getTime(),h=12e4;let u,l;for(let c=k.length-1;c>=0;c--){const a=k[c];if(!a)continue;if(new Date(a.timestamp).getTime()<=s){u=a;break}}for(let c=k.length-1;c>=0;c--){const a=k[c];if(!a)continue;const v=new Date(a.timestamp).getTime();if(v>s&&v<=s+h){l=a;break}}l&&(!u||Object.keys(l.trackedFileBackups).length>Object.keys(u.trackedFileBackups).length)?m=l:m=u}const f=i==="code"||i==="both",T=i==="conversation"||i==="both";if(i==="code"&&!m)return e?.warn({claudeSessionId:n,target:o,totalSnapshots:k.length,module:"daemon:checkpoint"},"rollback: no matching checkpoint found for code restore"),{restoredCount:0,deletedCount:0,skippedFiles:[],mode:i};let F=0,g=0;const y=[];let w=0,C,x;if(f&&m){const s=B(n,t),h=new Date(m.timestamp).getTime(),u=N(p),l=u.split(/[/\\]/).pop()??u,c=V(l);for(const a of Object.keys(m.trackedFileBackups)){const v=m.trackedFileBackups[a];if(!v)continue;const b=I(a)?a:L(c,a);if(!I(a)&&b!==c&&!b.startsWith(c+R)){e?.warn({rawPath:a,projectRoot:c,module:"daemon:checkpoint"},"rollback skipped file escaping project root"),y.push(b);continue}if(!d)try{if((await D(b)).mtimeMs>h){y.push(b);continue}}catch{}if(v.backupFileName===null)try{await _(b),g++}catch{y.push(b)}else{const M=j(s,v.backupFileName);try{await U(N(b),{recursive:!0}),await J(M,b),F++}catch{y.push(b)}}}}if(T){let s;if(o.messageId){s=o.messageId;try{const h=await q(p,"utf-8");for(const u of h.split(`
+`))if(u.includes(o.messageId)){const l=JSON.parse(u);P(l)&&typeof l.timestamp=="string"&&(C=l.timestamp);break}}catch{}}else if(o.toolCallId){const{buildOneTimeIndex:h,walkToUserPrompt:u}=await import("./jsonlIndexService.js");e?.info({claudeSessionId:n,toolCallId:o.toolCallId,module:"daemon:checkpoint"},"rollback: building on-demand JSONL index");const{index:l,targetEntry:c}=await h(p,o.toolCallId);if(e?.info({claudeSessionId:n,uuidEntries:l.uuidMap.size,totalLines:l.totalLines,foundTarget:!!c,module:"daemon:checkpoint"},"rollback: on-demand index built"),c){const a=u(l,c.uuid);a?(s=a.uuid,e?.info({claudeSessionId:n,toolCallId:o.toolCallId,targetUuid:c.uuid.slice(0,16),pivotUuid:s.slice(0,16),pivotLine:a.line,hops:0,module:"daemon:checkpoint"},"rollback: pivot found via on-demand index")):e?.warn({claudeSessionId:n,toolCallId:o.toolCallId,module:"daemon:checkpoint"},"rollback: walkToUserPrompt returned null \u2014 no user prompt found in chain")}else e?.warn({claudeSessionId:n,toolCallId:o.toolCallId,uuidEntries:l.uuidMap.size,module:"daemon:checkpoint"},"rollback: toolCallId not found in JSONL")}if(s){x=s,e?.info({claudeSessionId:n,mode:i,pivotMsgId:s,jsonlPath:p,module:"daemon:checkpoint"},"rollback: truncating conversation");try{const h=await $(p,s);w=h.truncatedCount,e?.info({claudeSessionId:n,pivotMsgId:s,pivotLine:h.pivotLine,truncatedMessageCount:w,module:"daemon:checkpoint"},"rollback: conversation truncated")}catch(h){e?.warn({claudeSessionId:n,pivotMsgId:s,error:String(h),module:"daemon:checkpoint"},"rollback: conversation truncation failed")}}else e?.warn({claudeSessionId:n,target:o,module:"daemon:checkpoint"},"rollback: no pivot message found for conversation truncation")}return e?.info({claudeSessionId:n,mode:i,restoredCount:F,deletedCount:g,skippedCount:y.length,truncatedMessageCount:w,snapshotTimestamp:m?.timestamp,module:"daemon:checkpoint"},"rollback completed"),y.length>0&&e?.warn({claudeSessionId:n,skippedFiles:y,module:"daemon:checkpoint"},"rollback: some files were skipped"),{restoredCount:F,deletedCount:g,skippedFiles:y,truncatedMessageCount:w,pivotTimestamp:C,pivotMessageUuid:x,mode:i}}export async function rewindFilesViaClaude(n,o,r){const d=await n("rewind_files",{user_message_id:o,dry_run:r??!1}),t=P(d.response)?d.response:{};return{canRewind:t.canRewind===!0,error:typeof t.error=="string"?t.error:void 0,filesChanged:typeof t.filesChanged=="number"?t.filesChanged:void 0,insertions:typeof t.insertions=="number"?t.insertions:void 0,deletions:typeof t.deletions=="number"?t.deletions:void 0}}

package/dist/cli-arg-access.d.ts

@@ -0,0 +1 @@
+export declare function reqArg(arr: readonly string[], i: number): string;

package/dist/cli-arg-access.js

@@ -0,0 +1 @@
+"use strict";export function reqArg(n,r){const e=n[r];if(e===void 0)throw new Error(`Missing required argument at index ${r}`);return e}

package/dist/cli-args.d.ts

@@ -0,0 +1,75 @@
+export { reqArg } from './cli-arg-access.js';
+
+export declare function optArg(arr: readonly string[], i: number): string | undefined;
+
+export type CommandName = 'start' | 'stop' | 'restart' | 'status' | 'pair' | 'unpair' | 'run' | 'add-device' | 'invite' | 'handoff' | 'stats' | 'upgrade' | 'daemon' | 'debug' | 'config' | 'help' | 'version';
+
+export interface StartOptions {
+    readonly port?: number;
+    readonly detach?: boolean;
+    readonly server?: string;
+    readonly token?: string;
+    readonly label?: string;
+    readonly json?: boolean;
+    readonly model?: string;
+    readonly permissionMode?: string;
+    readonly resume?: string;
+    
+    readonly name?: string;
+    
+    readonly profile?: string;
+    
+    readonly registry?: string;
+    
+    readonly yes?: boolean;
+    
+    readonly agent?: string;
+    
+    readonly extraArgs?: readonly string[];
+    
+    readonly appendSystemPrompt?: string;
+    
+    readonly source?: string;
+    
+    readonly serverSessionId?: string;
+    
+    readonly spawnToken?: string;
+    
+    readonly takeoverToken?: string;
+    
+    readonly sessionBootstrapFile?: string;
+}
+
+export interface RunOptions {
+    readonly agent?: string;
+    readonly prompt?: string;
+    readonly cwd?: string;
+    readonly model?: string;
+    readonly permissionMode?: string;
+    readonly maxTurns?: number;
+    readonly appendSystemPrompt?: string;
+    readonly resume?: string;
+    
+    readonly server?: string;
+}
+
+export interface InviteOptions {
+    readonly label?: string;
+}
+import type { HandoffOptions } from './cli-handoff-args.js';
+export type { HandoffOptions };
+
+export interface CliCommand {
+    readonly command: CommandName;
+    readonly options: StartOptions;
+    readonly runOptions?: RunOptions;
+    readonly inviteOptions?: InviteOptions;
+    readonly handoffOptions?: HandoffOptions;
+    readonly debugAction?: 'on' | 'off';
+    readonly configSubcommand?: 'list' | 'get' | 'set' | 'unset';
+    readonly configKey?: string;
+    readonly configValue?: string;
+}
+export declare const VALID_AGENTS: Set<string>;
+
+export declare function parseArgs(args: readonly string[]): CliCommand;

package/dist/cli-args.js

@@ -0,0 +1 @@
+"use strict";import{CLI_AGENT_TYPES as h}from"@agentdock/wire";import{parseHandoffCommand as a}from"./cli-handoff-args.js";import{reqArg as r}from"./cli-arg-access.js";export{reqArg}from"./cli-arg-access.js";const u=new Set(["start","stop","restart","status","pair","unpair","run","add-device","invite","handoff","stats","upgrade","daemon","debug","config","help"]);export function optArg(e,t){return e[t]}function v(e){return u.has(e)}export const VALID_AGENTS=new Set(h);export function parseArgs(e){if(e.length===0)return{command:"start",options:{agent:"claude"}};const t=r(e,0);if(t==="--help"||t==="-h")return{command:"help",options:{}};if(t==="--version"||t==="-v")return{command:"version",options:{}};if(VALID_AGENTS.has(t))return m(["start",...e]);if(t==="start")return m(e);if(t.startsWith("-")&&!u.has(t))return m(["start",...e]);if(!v(t))return{command:"help",options:{}};const i=t,o=c(e);if(i==="stats"){const n=e.includes("--json");return{command:i,options:{json:n,profile:o}}}if(i==="run")return b(e);if(i==="add-device"||i==="invite")return k(e);if(i==="handoff")return a(e);if(i==="daemon")return d("daemon",e);if(i==="pair")return d("pair",e);if(i==="debug"){const n=optArg(e,1);return{command:i,options:{profile:o},debugAction:n==="on"||n==="off"?n:void 0}}if(i==="config")return y(e);if(i==="upgrade"){const n=p(e,"--registry"),s=e.includes("--yes");return{command:i,options:{profile:o,registry:n,yes:s}}}if(i==="unpair"){const n=p(e,"--server"),s=e.includes("--yes");return{command:i,options:{profile:o,server:n,yes:s}}}if(i==="restart"){const n=p(e,"--server");return{command:i,options:{profile:o,server:n}}}return{command:i,options:{profile:o}}}function p(e,t){for(let i=1;i<e.length;i++)if(e[i]===t&&i+1<e.length)return r(e,i+1)}function c(e){for(let t=1;t<e.length;t++)if(e[t]==="--profile"&&t+1<e.length)return r(e,t+1)}const S=new Set(["--port","--server","--token","--model","--permission-mode","--resume","--name","--profile","--detach","--agent","--source","--server-session-id","--spawn-token","--takeover-token","--session-bootstrap-file","--daemon-gen"]);function m(e){const t={};let i=!1;const o=[];for(let n=1;n<e.length;n++){const s=r(e,n);if(!i&&!s.startsWith("-")&&VALID_AGENTS.has(s))t.agent=s,i=!0;else if(s==="--port"&&n+1<e.length){const l=r(e,n+1),f=parseInt(l,10);!isNaN(f)&&f>0&&(t.port=f),n++}else if(s==="--server"&&n+1<e.length)t.server=r(e,n+1),n++;else if(s==="--token"&&n+1<e.length)t.token=r(e,n+1),n++;else if(s==="--model"&&n+1<e.length)t.model=r(e,n+1),n++;else if(s==="--permission-mode"&&n+1<e.length)t.permissionMode=r(e,n+1),n++;else if(s==="--resume"&&n+1<e.length)t.resume=r(e,n+1),n++;else if(s==="--name"&&n+1<e.length)t.name=r(e,n+1),n++;else if(s==="--profile"&&n+1<e.length)t.profile=r(e,n+1),n++;else if(s==="--detach")t.detach=!0;else if(s==="--agent"&&n+1<e.length)t.agent=r(e,n+1),i=!0,n++;else if(s==="--append-system-prompt"&&n+1<e.length)t.appendSystemPrompt=r(e,n+1),n++;else if(s==="--source"&&n+1<e.length)t.source=r(e,n+1),n++;else if(s==="--server-session-id"&&n+1<e.length)t.serverSessionId=r(e,n+1),n++;else if(s==="--spawn-token"&&n+1<e.length)t.spawnToken=r(e,n+1),n++;else if(s==="--takeover-token"&&n+1<e.length)t.takeoverToken=r(e,n+1),n++;else if(s==="--session-bootstrap-file"&&n+1<e.length)t.sessionBootstrapFile=r(e,n+1),n++;else if(s==="--daemon-gen"&&n+1<e.length)n++;else if(s.startsWith("-")&&!S.has(s)&&(o.push(s),n+1<e.length)){const l=r(e,n+1);l.startsWith("-")||(o.push(l),n++)}}return t.agent||(t.agent="claude"),o.length>0&&(t.extraArgs=o),{command:"start",options:t}}function d(e,t){const i={};for(let o=1;o<t.length;o++){const n=r(t,o);if(n==="--port"&&o+1<t.length){const s=r(t,o+1),l=parseInt(s,10);!isNaN(l)&&l>0&&(i.port=l),o++}else n==="--server"&&o+1<t.length?(i.server=r(t,o+1),o++):n==="--token"&&o+1<t.length?(i.token=r(t,o+1),o++):n==="--label"&&o+1<t.length?(i.label=r(t,o+1),o++):n==="--model"&&o+1<t.length?(i.model=r(t,o+1),o++):n==="--permission-mode"&&o+1<t.length?(i.permissionMode=r(t,o+1),o++):n==="--resume"&&o+1<t.length?(i.resume=r(t,o+1),o++):n==="--name"&&o+1<t.length?(i.name=r(t,o+1),o++):n==="--profile"&&o+1<t.length?(i.profile=r(t,o+1),o++):n==="--detach"&&(i.detach=!0)}return{command:e,options:i}}function b(e){const t={};let i=!1;for(let o=1;o<e.length;o++){const n=r(e,o);if((n==="-p"||n==="--prompt")&&o+1<e.length)t.prompt=r(e,o+1),o++;else if(n==="--cwd"&&o+1<e.length)t.cwd=r(e,o+1),o++;else if(n==="--model"&&o+1<e.length)t.model=r(e,o+1),o++;else if(n==="--permission-mode"&&o+1<e.length)t.permissionMode=r(e,o+1),o++;else if(n==="--max-turns"&&o+1<e.length){const s=parseInt(r(e,o+1),10);!isNaN(s)&&s>0&&(t.maxTurns=s),o++}else n==="--append-system-prompt"&&o+1<e.length?(t.appendSystemPrompt=r(e,o+1),o++):n==="--server"&&o+1<e.length?(t.server=r(e,o+1),o++):n==="--resume"&&o+1<e.length?(t.resume=r(e,o+1),o++):!i&&!n.startsWith("-")&&VALID_AGENTS.has(n)&&(t.agent=n,i=!0)}return{command:"run",options:{},runOptions:t}}function k(e){const t={};for(let i=1;i<e.length;i++)r(e,i)==="--label"&&i+1<e.length&&(t.label=r(e,i+1),i++);return{command:"add-device",options:{},inviteOptions:t}}function y(e){const t=optArg(e,1),i=c(e);if(!t||t==="list")return{command:"config",options:{profile:i},configSubcommand:"list"};const o=optArg(e,2);return t==="get"||t==="unset"?o?{command:"config",options:{profile:i},configSubcommand:t,configKey:o}:{command:"help",options:{}}:t==="set"?!o||e[3]===void 0?{command:"help",options:{}}:{command:"config",options:{profile:i},configSubcommand:"set",configKey:o,configValue:r(e,3)}:{command:"help",options:{}}}

package/dist/cli-handoff-args.d.ts

@@ -0,0 +1,22 @@
+export interface HandoffOptions {
+    readonly sessionId?: string;
+    readonly title?: string;
+    readonly summary?: string;
+    readonly brief?: string;
+    readonly briefFile?: string;
+    readonly sourceReferences: readonly string[];
+    readonly server?: string;
+}
+export declare function parseHandoffCommand(args: readonly string[]): {
+    command: "handoff";
+    options: {};
+    handoffOptions: {
+        sourceReferences: string[];
+        server: string | undefined;
+        briefFile?: string | undefined;
+        brief: string | undefined;
+        summary?: string | undefined;
+        title?: string | undefined;
+        sessionId: string | undefined;
+    };
+};

package/dist/cli-handoff-args.js

@@ -0,0 +1 @@
+"use strict";import{reqArg as l}from"./cli-arg-access.js";export function parseHandoffCommand(t){const h=[];let m,f,i,r,o,s;for(let e=1;e<t.length;e++){const n=l(t,e);n==="--session"&&e+1<t.length?m=l(t,++e):n==="--title"&&e+1<t.length?f=l(t,++e):n==="--summary"&&e+1<t.length?i=l(t,++e):n==="--brief"&&e+1<t.length?r=l(t,++e):n==="--brief-file"&&e+1<t.length?o=l(t,++e):n==="--source-reference"&&e+1<t.length?h.push(l(t,++e)):n==="--server"&&e+1<t.length&&(s=l(t,++e))}return{command:"handoff",options:{},handoffOptions:{sessionId:m,...f?{title:f}:{},...i?{summary:i}:{},brief:r,...o?{briefFile:o}:{},sourceReferences:h,server:s}}}

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_SERVER = "https://agentdock-api.yungujia.com";

package/dist/constants.js

@@ -0,0 +1 @@
+"use strict";export const DEFAULT_SERVER="https://agentdock-api.yungujia.com";

package/dist/containerEnvPrompt.d.ts

@@ -0,0 +1 @@
+export declare const ENTERPRISE_CONTAINER_ENV_PROMPT = "## \u8FD0\u884C\u73AF\u5883\uFF1A\u4F01\u4E1A\u7248\u5BB9\u5668\n\n\u4F60\u6B63\u8FD0\u884C\u5728\u4E00\u4E2A **Docker \u5BB9\u5668** \u4E2D\uFF0C\u62E5\u6709\u5B8C\u6574\u7684 Linux \u7CFB\u7EDF\u8BBF\u95EE\u6743\u9650\u3002\n\n### \u7CFB\u7EDF\u6743\u9650\n\n- \u5F53\u524D\u7528\u6237 `agent`\uFF0C\u62E5\u6709 **passwordless sudo**\u3002\n- `sudo apt install`\u3001`sudo pip install`\u3001`sudo npm install -g` \u5747\u53EF\u6B63\u5E38\u4F7F\u7528\u3002\n- \u6587\u4EF6\u7CFB\u7EDF\u5B8C\u5168\u53EF\u5199\uFF08\u975E\u53EA\u8BFB\uFF09\u3002\n\n### \u6301\u4E45\u5316\u8BF4\u660E\n\n\u5BB9\u5668\u5347\u7EA7\u65F6\u4EE5\u4E0B\u8DEF\u5F84\u7684\u6570\u636E**\u4F1A\u4FDD\u7559**\uFF08bind mount \u5230\u5BBF\u4E3B\u673A\uFF09\uFF1A\n\n| \u8DEF\u5F84 | \u7528\u9014 |\n|------|------|\n| `/workspace` | \u7528\u6237\u5DE5\u4F5C\u533A |\n| `/home/agent/.claude` | Claude Code \u8BBE\u7F6E\u548C\u4F1A\u8BDD |\n| `/home/agent/.local` | \u7528\u6237\u672C\u5730\u5305\uFF08`npm install -g` \u9ED8\u8BA4\u5199\u8FD9\u91CC\uFF09 |\n| `/home/agent/.cache` | \u5305\u7BA1\u7406\u5668\u7F13\u5B58 |\n| `/home/agent/.config` | \u7528\u6237\u7EA7\u914D\u7F6E |\n\n\u4EE5\u4E0B\u8DEF\u5F84\u5347\u7EA7\u540E**\u4F1A\u4E22\u5931**\uFF08\u5EFA\u8BAE\u7528 git \u7BA1\u7406\uFF09\uFF1A\n\n| \u8DEF\u5F84 | \u8BF4\u660E |\n|------|------|\n| `/tmp` | \u4E34\u65F6\u6587\u4EF6\uFF08tmpfs\uFF0C\u4E0A\u9650 256MB\uFF09 |\n| \u7CFB\u7EDF\u8DEF\u5F84\uFF08`/usr`, `/etc` \u7B49\uFF09 | apt \u5B89\u88C5\u7684\u7CFB\u7EDF\u5305 |\n\n> **\u91CD\u8981**\uFF1A`sudo apt install` \u5B89\u88C5\u7684\u7CFB\u7EDF\u5305\u5728\u5BB9\u5668\u5347\u7EA7\u540E\u4F1A\u4E22\u5931\u3002\u5982\u9700\u6301\u4E45\u5316\u7CFB\u7EDF\u7EA7\u8F6F\u4EF6\uFF0C\u8BF7\u5728 `/workspace` \u6216 `~/.local` \u4E2D\u5B89\u88C5 portable \u7248\u672C\u3002\n\n### \u64CD\u4F5C\u6307\u5F15\n\n1. **`sudo apt install <pkg>`**\uFF1A\u5B89\u88C5\u7CFB\u7EDF\u5305\uFF08\u5347\u7EA7\u540E\u4F1A\u4E22\u5931\uFF0C\u9700\u8981\u65F6\u91CD\u88C5\u5373\u53EF\uFF09\u3002\n2. **`npm install -g`**\uFF1A\u9ED8\u8BA4\u5199\u5165 `~/.local`\uFF0C\u5347\u7EA7\u540E\u4FDD\u7559\u3002\u5B89\u88C5\u540E\u7684\u547D\u4EE4\u5728 `~/.local/bin` \u4E0B\uFF0C\u5DF2\u52A0\u5165 PATH\u3002\n3. **`pip install --user`**\uFF1A\u5199\u5165 `~/.local`\uFF0C\u5347\u7EA7\u540E\u4FDD\u7559\u3002\n4. **`npx`**\uFF1A\u65E0\u9700\u5B89\u88C5\u5373\u53EF\u8FD0\u884C\uFF0C\u63A8\u8350\u4F18\u5148\u4F7F\u7528\u3002\n5. **`pnpm`/`yarn`**\uFF1A\u5728 `/workspace` \u5185\u6B63\u5E38\u4F7F\u7528\u3002\n6. **`curl`/`wget`**\uFF1A\u4E0B\u8F7D\u6587\u4EF6\u6B63\u5E38\u53EF\u7528\u3002\n\n### \u5DF2\u9884\u88C5\u7684\u5DE5\u5177\n\n`git`\u3001`curl`\u3001`ps`\uFF08procps\uFF09\u3001`sudo`\u3001`node`\uFF08\u542B npm/npx\uFF09";

package/dist/containerEnvPrompt.js

@@ -0,0 +1 @@
+"use strict";export const ENTERPRISE_CONTAINER_ENV_PROMPT="## \u8FD0\u884C\u73AF\u5883\uFF1A\u4F01\u4E1A\u7248\u5BB9\u5668\n\n\u4F60\u6B63\u8FD0\u884C\u5728\u4E00\u4E2A **Docker \u5BB9\u5668** \u4E2D\uFF0C\u62E5\u6709\u5B8C\u6574\u7684 Linux \u7CFB\u7EDF\u8BBF\u95EE\u6743\u9650\u3002\n\n### \u7CFB\u7EDF\u6743\u9650\n\n- \u5F53\u524D\u7528\u6237 `agent`\uFF0C\u62E5\u6709 **passwordless sudo**\u3002\n- `sudo apt install`\u3001`sudo pip install`\u3001`sudo npm install -g` \u5747\u53EF\u6B63\u5E38\u4F7F\u7528\u3002\n- \u6587\u4EF6\u7CFB\u7EDF\u5B8C\u5168\u53EF\u5199\uFF08\u975E\u53EA\u8BFB\uFF09\u3002\n\n### \u6301\u4E45\u5316\u8BF4\u660E\n\n\u5BB9\u5668\u5347\u7EA7\u65F6\u4EE5\u4E0B\u8DEF\u5F84\u7684\u6570\u636E**\u4F1A\u4FDD\u7559**\uFF08bind mount \u5230\u5BBF\u4E3B\u673A\uFF09\uFF1A\n\n| \u8DEF\u5F84 | \u7528\u9014 |\n|------|------|\n| `/workspace` | \u7528\u6237\u5DE5\u4F5C\u533A |\n| `/home/agent/.claude` | Claude Code \u8BBE\u7F6E\u548C\u4F1A\u8BDD |\n| `/home/agent/.local` | \u7528\u6237\u672C\u5730\u5305\uFF08`npm install -g` \u9ED8\u8BA4\u5199\u8FD9\u91CC\uFF09 |\n| `/home/agent/.cache` | \u5305\u7BA1\u7406\u5668\u7F13\u5B58 |\n| `/home/agent/.config` | \u7528\u6237\u7EA7\u914D\u7F6E |\n\n\u4EE5\u4E0B\u8DEF\u5F84\u5347\u7EA7\u540E**\u4F1A\u4E22\u5931**\uFF08\u5EFA\u8BAE\u7528 git \u7BA1\u7406\uFF09\uFF1A\n\n| \u8DEF\u5F84 | \u8BF4\u660E |\n|------|------|\n| `/tmp` | \u4E34\u65F6\u6587\u4EF6\uFF08tmpfs\uFF0C\u4E0A\u9650 256MB\uFF09 |\n| \u7CFB\u7EDF\u8DEF\u5F84\uFF08`/usr`, `/etc` \u7B49\uFF09 | apt \u5B89\u88C5\u7684\u7CFB\u7EDF\u5305 |\n\n> **\u91CD\u8981**\uFF1A`sudo apt install` \u5B89\u88C5\u7684\u7CFB\u7EDF\u5305\u5728\u5BB9\u5668\u5347\u7EA7\u540E\u4F1A\u4E22\u5931\u3002\u5982\u9700\u6301\u4E45\u5316\u7CFB\u7EDF\u7EA7\u8F6F\u4EF6\uFF0C\u8BF7\u5728 `/workspace` \u6216 `~/.local` \u4E2D\u5B89\u88C5 portable \u7248\u672C\u3002\n\n### \u64CD\u4F5C\u6307\u5F15\n\n1. **`sudo apt install <pkg>`**\uFF1A\u5B89\u88C5\u7CFB\u7EDF\u5305\uFF08\u5347\u7EA7\u540E\u4F1A\u4E22\u5931\uFF0C\u9700\u8981\u65F6\u91CD\u88C5\u5373\u53EF\uFF09\u3002\n2. **`npm install -g`**\uFF1A\u9ED8\u8BA4\u5199\u5165 `~/.local`\uFF0C\u5347\u7EA7\u540E\u4FDD\u7559\u3002\u5B89\u88C5\u540E\u7684\u547D\u4EE4\u5728 `~/.local/bin` \u4E0B\uFF0C\u5DF2\u52A0\u5165 PATH\u3002\n3. **`pip install --user`**\uFF1A\u5199\u5165 `~/.local`\uFF0C\u5347\u7EA7\u540E\u4FDD\u7559\u3002\n4. **`npx`**\uFF1A\u65E0\u9700\u5B89\u88C5\u5373\u53EF\u8FD0\u884C\uFF0C\u63A8\u8350\u4F18\u5148\u4F7F\u7528\u3002\n5. **`pnpm`/`yarn`**\uFF1A\u5728 `/workspace` \u5185\u6B63\u5E38\u4F7F\u7528\u3002\n6. **`curl`/`wget`**\uFF1A\u4E0B\u8F7D\u6587\u4EF6\u6B63\u5E38\u53EF\u7528\u3002\n\n### \u5DF2\u9884\u88C5\u7684\u5DE5\u5177\n\n`git`\u3001`curl`\u3001`ps`\uFF08procps\uFF09\u3001`sudo`\u3001`node`\uFF08\u542B npm/npx\uFF09";