shennian 0.5.0 → 0.5.2

package/dist/src/commands/upgrade.d.ts

@@ -1,31 +0,0 @@
-import { execSync, spawn } from 'node:child_process';
-import type { Command } from 'commander';
-import { compareVersions } from '../upgrade/engine.js';
-import type { CliRelayClient } from '../relay/client.js';
-type RestartAfterUpgradeDeps = {
-    platform?: NodeJS.Platform;
-    kill?: typeof process.kill;
-    pid?: number;
-    spawn?: typeof spawn;
-    execSync?: typeof execSync;
-    env?: NodeJS.ProcessEnv;
-};
-export declare function hasMajorUpgradeConfirmation(changeType: ReturnType<typeof compareVersions>, confirmed: boolean): boolean;
-export declare function restartCurrentDaemonAfterUpgrade(deps?: RestartAfterUpgradeDeps): void;
-export declare function registerUpgradeCommand(program: Command): void;
-export declare function handleUpgradeStart(client: CliRelayClient, reqId: string, targetVersion?: string, opts?: {
-    currentVersion?: string;
-    confirmedMajor?: boolean;
-    prepareForUpgrade?: (jobId: string) => {
-        activeRunCount: number;
-    };
-    cancelUpgradePreparation?: () => void;
-    shutdownAfterHandoff?: () => void;
-    suppressResponse?: boolean;
-    canHandoff?: () => boolean;
-    waitForCompletion?: boolean;
-}): Promise<Record<string, unknown>>;
-export declare function handleUpgradeStatus(client: CliRelayClient, reqId: string, opts?: {
-    currentVersion?: string;
-}): Promise<void>;
-export {};

package/dist/src/commands/worker.d.ts

@@ -1,11 +0,0 @@
-import type { Command } from 'commander';
-type WorkerCommandResponse = {
-    ok: boolean;
-    error?: string;
-    message?: string;
-    nextAction?: string;
-    [key: string]: unknown;
-};
-export declare function executeWorkerCommand(operation: 'start' | 'read' | 'send' | 'wait' | 'stop', body: Record<string, unknown>): Promise<WorkerCommandResponse>;
-export declare function registerWorkerCommand(program: Command): void;
-export {};

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

@@ -1,58 +0,0 @@
-import type { ManagedAgentRuntimePlatform, ManagedAgentRuntimeSecurityDeclaration } from '../security/managed-agent-runtime.js';
-export declare function getShennianDir(): string;
-export declare function resolveShennianPath(...parts: string[]): string;
-export declare function getConfigPath(): string;
-export declare const configPath: string;
-export type CustomAgentEntry = {
-    command: string;
-    caps: {
-        name: string;
-        model?: string;
-        models?: string[];
-        defaultModel?: string;
-        mode: 'spawn' | 'stdio';
-        proactive?: boolean;
-        resume?: boolean;
-        version?: string;
-        security?: CustomAgentSecurityDeclaration;
-    };
-};
-/**
- * Optional managed-runtime attestation returned by a Custom Agent's /caps
- * probe. It is bound to one runtime version, executable digest and platform.
- * Missing or stale attestations leave the runtime unverified.
- */
-export type CustomAgentSecurityDeclaration = {
-    schemaVersion: 1;
-    declarationVersion: number;
-    policyProtocol: 'shennian-managed-policy-file-v1';
-    runtimeVersion: string;
-    executablePath: string;
-    executableSha256: string;
-    conformance: {
-        suiteVersion: string;
-        status: 'passed' | 'failed';
-        platform: ManagedAgentRuntimePlatform;
-        testedAt: string;
-    };
-    runtimeSecurity: ManagedAgentRuntimeSecurityDeclaration;
-};
-export type ShennianConfig = {
-    defaultProvider?: string;
-    defaultModel?: string;
-    apiKeys?: Record<string, string>;
-    machineId?: string;
-    machineToken?: string;
-    accountNamespaceId?: string;
-    accessToken?: string;
-    refreshToken?: string;
-    serverUrl?: string;
-    customAgents?: Record<string, CustomAgentEntry>;
-    /** Auto-upgrade policy. Missing values default to patch; legacy "minor" values stay disabled. */
-    autoUpgrade?: 'none' | 'patch' | 'minor';
-};
-export type RuntimeAutoUpgradePolicy = 'none' | 'patch';
-export declare function normalizeAutoUpgradePolicy(value: unknown): RuntimeAutoUpgradePolicy;
-export declare function loadConfig(): ShennianConfig;
-export declare function saveConfig(config: ShennianConfig): void;
-export declare function ensureDir(): void;

package/dist/src/daemon-ipc/agent-readiness.d.ts

@@ -1,15 +0,0 @@
-import { type AgentInfo } from '@shennian/wire';
-import type { DaemonStatus } from '../commands/daemon.js';
-import type { AgentWorkspaceValidationInput, AgentWorkspaceValidationResult } from '../session/handlers/agent-workspace-validation.js';
-import type { DaemonIpcHandler } from './server.js';
-type DiscoveredAi = AgentInfo & {
-    runtimePlatform?: string;
-    runtimeIsWsl?: boolean;
-};
-export declare function createAgentReadinessHandlers(input: {
-    getStatus: () => DaemonStatus;
-    getSnapshot: () => DiscoveredAi[];
-    discover: (agentType?: string) => Promise<DiscoveredAi[]>;
-    validate: (params: AgentWorkspaceValidationInput) => Promise<AgentWorkspaceValidationResult>;
-}): Record<string, DaemonIpcHandler>;
-export {};

package/dist/src/daemon-ipc/client.d.ts

@@ -1,8 +0,0 @@
-import type { JsonValue } from './json.js';
-import { type DaemonIpcPaths } from './paths.js';
-export declare function callDaemonIpc<T extends JsonValue = JsonValue>(input: {
-    method: string;
-    params?: JsonValue;
-    paths?: DaemonIpcPaths;
-    timeoutMs?: number;
-}): Promise<T>;

package/dist/src/daemon-ipc/control.d.ts

@@ -1,16 +0,0 @@
-import type { DetectedAgent } from '../agents/detect.js';
-import type { DaemonStatus } from '../commands/daemon.js';
-import type { JsonValue } from './json.js';
-import type { DaemonIpcHandler } from './server.js';
-export declare const DAEMON_CONTROL_CAPABILITIES: readonly ["protocol.info", "daemon.status", "agent.list", "agent.discover", "agent.check", "agent.auth.completed", "log.read", "upgrade.start", "upgrade.prepare-external", "upgrade.cancel-external"];
-export declare function createDaemonControlHandlers(input: {
-    daemonVersion: string;
-    protocolVersion: number;
-    getStatus: () => DaemonStatus;
-    getAgents: () => DetectedAgent[];
-    startUpgrade?: (params: JsonValue | undefined) => Promise<JsonValue>;
-    prepareExternalUpgrade?: (params: JsonValue | undefined) => Promise<JsonValue> | JsonValue;
-    cancelExternalUpgrade?: () => Promise<JsonValue> | JsonValue;
-    completeAgentAuthentication?: (agentType: string) => Promise<boolean>;
-}): Record<string, DaemonIpcHandler>;
-export declare function readDaemonLogPage(logFile: string, params: JsonValue | undefined): JsonValue;

package/dist/src/daemon-ipc/json.d.ts

@@ -1,3 +0,0 @@
-export type JsonValue = null | boolean | number | string | JsonValue[] | {
-    [key: string]: JsonValue;
-};

package/dist/src/daemon-ipc/paths.d.ts

@@ -1,15 +0,0 @@
-export declare const MANAGED_ROOM_IPC_ROOT_ENV = "SHENNIAN_MANAGED_ROOM_IPC_ROOT";
-export type DaemonIpcPaths = {
-    runtimeDirectory: string;
-    secretFile: string;
-    endpoint: string;
-    transport: 'unix_socket' | 'windows_named_pipe';
-};
-export declare function resolveDaemonIpcPaths(rootDir?: string, platform?: NodeJS.Platform): DaemonIpcPaths;
-/**
- * Managed Agents must never read the persistent ~/.shennian tree. Their only
- * local bridge is a separate, daemon-owned IPC endpoint whose handler still
- * requires the per-turn managed Room capability.
- */
-export declare function getManagedRoomIpcRoot(shennianDir?: string, tempDirectory?: string): string;
-export declare function resolveManagedRoomIpcPaths(rootDir?: string, platform?: NodeJS.Platform): DaemonIpcPaths;

package/dist/src/daemon-ipc/protocol.d.ts

@@ -1,31 +0,0 @@
-import type { JsonValue } from './json.js';
-export declare const DAEMON_IPC_VERSION: 1;
-export declare const DAEMON_IPC_MAX_REQUEST_BYTES: number;
-export declare const DAEMON_IPC_MAX_RESPONSE_BYTES: number;
-export type DaemonIpcRequest = {
-    version: typeof DAEMON_IPC_VERSION;
-    requestId: string;
-    auth: string;
-    method: string;
-    params?: JsonValue;
-};
-export type DaemonIpcSuccess = {
-    version: typeof DAEMON_IPC_VERSION;
-    requestId: string;
-    ok: true;
-    result: JsonValue;
-};
-export type DaemonIpcFailure = {
-    version: typeof DAEMON_IPC_VERSION;
-    requestId: string;
-    ok: false;
-    error: {
-        code: string;
-        message: string;
-    };
-};
-export type DaemonIpcResponse = DaemonIpcSuccess | DaemonIpcFailure;
-export declare class DaemonIpcError extends Error {
-    readonly code: string;
-    constructor(code: string, message: string);
-}

package/dist/src/daemon-ipc/secret.d.ts

@@ -1,3 +0,0 @@
-export declare function loadOrCreateDaemonIpcSecret(runtimeDirectory: string, secretFile: string): string;
-export declare function readDaemonIpcSecret(secretFile: string): string;
-export declare function ensurePrivateRuntimeDirectory(runtimeDirectory: string): void;

package/dist/src/daemon-ipc/server.d.ts

@@ -1,20 +0,0 @@
-import type { JsonValue } from './json.js';
-import { type DaemonIpcPaths } from './paths.js';
-export type DaemonIpcHandler = (params: JsonValue | undefined, context: {
-    requestId: string;
-}) => Promise<JsonValue> | JsonValue;
-export type DaemonIpcServer = {
-    paths: DaemonIpcPaths;
-    close(): Promise<void>;
-};
-export declare function assertUnixSocketEndpointLength(endpoint: string, platform?: NodeJS.Platform): void;
-export declare function startDaemonIpcServer(options: {
-    handlers: Record<string, DaemonIpcHandler>;
-    paths?: DaemonIpcPaths;
-}): Promise<DaemonIpcServer>;
-export declare function timingSafeSecretEqual(value: unknown, secret: string): boolean;
-export declare function daemonIpcListenOptions(paths: DaemonIpcPaths): string | {
-    path: string;
-    readableAll: false;
-    writableAll: false;
-};

package/dist/src/daemon-log.d.ts

@@ -1,9 +0,0 @@
-export declare function getDaemonLogRetention(): {
-    maxLines: number;
-    maxBytes: number;
-};
-export declare function trimDaemonLogFile(filePath?: string, retention?: {
-    maxLines: number;
-    maxBytes: number;
-}): boolean;
-export declare function startDaemonLogRetention(): ReturnType<typeof setInterval>;

package/dist/src/env-path.d.ts

@@ -1,15 +0,0 @@
-export declare function getUserBinPathCandidates(input?: {
-    env?: NodeJS.ProcessEnv;
-    homedir?: string;
-    exists?: (filePath: string) => boolean;
-    readdir?: (filePath: string) => string[];
-    platform?: NodeJS.Platform;
-}): string[];
-export declare function buildAugmentedPath(input?: {
-    pathValue?: string;
-    env?: NodeJS.ProcessEnv;
-    homedir?: string;
-    exists?: (filePath: string) => boolean;
-    readdir?: (filePath: string) => string[];
-}): string;
-export declare function augmentProcessPath(): void;

package/dist/src/fs/boundary.d.ts

@@ -1,23 +0,0 @@
-export type FsPathFlavor = 'win32' | 'posix';
-export type AuthorizedFsRoot = {
-    raw: string;
-    normalized: string;
-    boundary: string;
-    real: string | null;
-    flavor: FsPathFlavor;
-    file: boolean;
-};
-export type ResolveAuthorizedPathResult = {
-    ok: true;
-    path: string;
-    root: AuthorizedFsRoot;
-} | {
-    ok: false;
-    error: string;
-};
-export declare function resolveSessionWorkDir(input: string): string;
-export declare function createAuthorizedFsRoot(rawRoot: string): AuthorizedFsRoot;
-export declare function createAuthorizedFsRootAsync(rawRoot: string): Promise<AuthorizedFsRoot>;
-export declare function resolveAuthorizedPath(rawPath: string, root: AuthorizedFsRoot): ResolveAuthorizedPathResult;
-export declare function resolveAuthorizedPathAsync(rawPath: string, root: AuthorizedFsRoot): Promise<ResolveAuthorizedPathResult>;
-export declare function isAuthorizedRootPath(pathValue: string, root: AuthorizedFsRoot): boolean;

package/dist/src/fs/handler.d.ts

@@ -1,26 +0,0 @@
-import type { FsEntry, FsTransferRequest, FsChunk } from '@shennian/wire';
-export type TransferProgress = {
-    transferId: string;
-    seq: number;
-    total: number;
-    bytesSent: number;
-    bytesTotal: number;
-};
-export declare function handleFsLs(reqPath: string): {
-    entries: FsEntry[];
-} | {
-    error: string;
-};
-export declare function handleFsRead(reqPath: string): {
-    path: string;
-    content: string;
-} | {
-    error: string;
-};
-export declare function handleFsDownload(req: FsTransferRequest, onProgress?: (progress: TransferProgress) => void): AsyncGenerator<FsChunk>;
-export declare function handleFsUploadInit(req: FsTransferRequest): {
-    targetPath: string;
-} | {
-    error: string;
-};
-export declare function handleFsUploadChunk(targetPath: string, chunk: FsChunk): void;

package/dist/src/fs/security.d.ts

@@ -1,2 +0,0 @@
-export declare function normalizePath(inputPath: string): string;
-export declare function isPathSafe(normalizedPath: string): boolean;

package/dist/src/fs/text-decoder.d.ts

@@ -1,10 +0,0 @@
-export declare class BinaryTextPreviewError extends Error {
-    constructor();
-}
-export type AutoTextDecodeResult = {
-    content: string;
-    encoding: 'utf8' | 'utf16le' | 'utf16be' | 'gb18030' | 'windows-1252';
-    fallback: boolean;
-};
-export declare function isAutoTextEncoding(value: string): boolean;
-export declare function decodeTextBufferAuto(buffer: Buffer): AutoTextDecodeResult;

package/dist/src/index.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/log-redaction.d.ts

@@ -1,4 +0,0 @@
-export declare function redactCliLogText(value: string, knownSecrets?: readonly string[]): string;
-export declare function sanitizeCliLogValue(value: unknown, knownSecrets?: readonly string[], key?: string, depth?: number, seen?: WeakSet<object>): unknown;
-export declare function collectKnownLogSecrets(env: NodeJS.ProcessEnv, config: unknown): string[];
-export declare function installCliLogRedaction(knownSecrets: readonly string[]): void;

package/dist/src/log-reporter.d.ts

@@ -1,41 +0,0 @@
-type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-type LogType = 'http' | 'ws' | 'internal';
-type LogEntry = {
-    traceId?: string;
-    sessionId?: string;
-    type?: LogType;
-    level: LogLevel;
-    wsEvent?: string;
-    wsDirection?: 'in' | 'out';
-    errorMessage?: string;
-    errorStack?: string;
-    durationMs?: number;
-    metadata?: unknown;
-};
-export declare function initCliLogReporter(serverUrl: string, machineId: string): void;
-export declare function generateTraceId(): string;
-export declare function reportLog(entry: LogEntry): void;
-export type UpgradeAggregateMetric = {
-    kind: 'upgrade';
-    result: 'healthy' | 'rolled_back' | 'failed';
-    stage: 'installing' | 'verifying' | 'starting' | 'recovering' | 'terminal';
-    durationMs?: number;
-    retries?: number;
-    errorCode?: string;
-};
-export type RecoveryAggregateMetric = {
-    kind: 'recovery';
-    result: 'terminal_reconciled' | 'reattached' | 'resumed' | 'continued' | 'interrupted_by_upgrade' | 'recovery_failed';
-    adapterType: string;
-    stage: 'inspect' | 'reattach' | 'resume' | 'continue' | 'terminal';
-    durationMs: number;
-    retries: number;
-    errorCode?: string;
-};
-/**
- * The general remote logger remains disabled. This deliberately narrow path
- * emits only enumerated aggregate dimensions: its type cannot accept session,
- * prompt, filesystem, attachment, tool, token, or stderr fields.
- */
-export declare function reportUpgradeAggregateMetric(metric: UpgradeAggregateMetric | RecoveryAggregateMetric): void;
-export {};

package/dist/src/manager/prompt.d.ts

@@ -1,2 +0,0 @@
-export declare const MANAGER_SYSTEM_PROMPT = "\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002\n\n\u4F60\u7684\u804C\u8D23\uFF1A\n- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002\n- \u62C6\u89E3\u4EFB\u52A1\u3002\n- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002\n- \u6C47\u603B worker \u7ED3\u679C\u3002\n- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002\n- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002\n\n\u4F60\u7684\u8FB9\u754C\uFF1A\n- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002\n- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002\n- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002\n- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u660E\u786E\u7684\u65B0\u76EE\u6807\u9ED8\u8BA4\u521B\u5EFA\u65B0\u7684 worker\uFF0C\u4E0D\u8981\u4E3A\u4E86\u590D\u7528\u800C\u5148\u679A\u4E3E\u5386\u53F2\uFF0C\u4E5F\u4E0D\u8981\u628A\u4E0D\u540C\u76EE\u6807\u6DF7\u8FDB\u65E7 worker\u3002\n- \u53EA\u6709\u7528\u6237\u660E\u786E\u7EED\u63A5\u3001\u7EA0\u504F\u3001\u8865\u5145\u540C\u4E00\u95EE\u9898\u94FE\u8DEF\uFF0C\u6216\u7CFB\u7EDF\u6B63\u5728\u6062\u590D\u5148\u524D\u5B89\u6392\u65F6\uFF0C\u624D\u7528 sessions list \u67E5\u770B\u5F53\u524D Manager \u81EA\u5DF1\u521B\u5EFA\u7684 worker\uFF0C\u5E76\u7528 sessions read \u6838\u5BF9\u540E\u590D\u7528\u3002\u4E0D\u8981\u5C1D\u8BD5\u53D1\u73B0\u6216\u63A7\u5236\u540C\u9879\u76EE\u4E2D\u5C5E\u4E8E\u65E7 Manager\u3001\u5176\u4ED6 Manager \u6216\u666E\u901A\u4F1A\u8BDD\u7684 Session\u3002\n- \u5982\u679C\u5DF2\u6709 worker \u6B63\u5728\u5904\u7406\u540C\u4E00\u76EE\u6807\uFF0C\u4F18\u5148\u7528 sessions send \u628A\u8865\u5145\u8981\u6C42\u53D1\u7ED9\u8FD9\u4E2A worker\uFF1B\u5373\u4F7F worker \u6B63\u5FD9\u4E5F\u53EF\u4EE5\u53D1\u9001\uFF0C\u9ED8\u8BA4\u4F1A\u8FDB\u5165\u672C\u673A\u961F\u5217\uFF0C\u4E0D\u8981\u56E0\u4E3A\u5B83\u5FD9\u5C31\u91CD\u590D\u521B\u5EFA\u3002\n- \u521B\u5EFA\u6216\u6307\u6D3E worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002\n- \u521B\u5EFA worker \u65F6\u5FC5\u987B\u63D0\u4F9B\u7B80\u77ED\u3001\u5177\u4F53\u3001\u53EF\u533A\u5206\u7684 --title\uFF0C\u540C\u65F6\u628A\u5B8C\u6574\u4EFB\u52A1\u653E\u8FDB --message\uFF1B\u4E0D\u8981\u628A\u6574\u6BB5\u4EFB\u52A1\u6216 Session ID \u5F53\u6807\u9898\u3002\n- Worker \u56FA\u5B9A\u7EE7\u627F\u5F53\u524D Manager \u7684 Agent \u548C\u6A21\u578B\uFF1B\u4E0D\u8981\u4E3A\u53D7\u7BA1 Manager \u7684 Worker \u6307\u5B9A\u3001\u5207\u6362\u6216\u731C\u6D4B Agent / \u6A21\u578B\u3002\u53EA\u6709\u5916\u90E8\u4E34\u65F6 Controller \u7684\u516C\u5F00 shennian worker start \u624D\u5141\u8BB8\u663E\u5F0F\u9009\u62E9 --agent / --model\u3002\n- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002\n- \u53EA\u80FD\u7BA1\u7406\u7531\u5F53\u524D Manager \u521B\u5EFA\u3001\u4E14\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u548C\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684 worker\uFF1B\u4E0D\u8981\u8DE8 Manager\u3001\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002\n- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002\n- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002\n- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u4E3A\u201C\u5916\u90E8\u5BF9\u8BDD: <\u5BF9\u8BDD\u540D\u79F0>\u201D\u540E\u8DDF\u201C\u5BF9\u65B9: <\u5185\u5BB9\u6216\u9644\u4EF6\u94FE\u63A5>\u201D\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002\n- \u5916\u90E8\u6D88\u606F\u662F\u5426\u9700\u8981\u56DE\u590D\u3001\u8FFD\u95EE\u3001\u5FFD\u7565\u3001\u8F6C\u4EA4\u5185\u90E8\u8D1F\u8D23\u4EBA\uFF0C\u6216\u521B\u5EFA/\u6307\u6D3E worker\uFF0C\u7531\u4F60\u6839\u636E\u9879\u76EE\u4E0A\u4E0B\u6587\u663E\u5F0F\u5224\u65AD\u3002\n- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002\n- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002\n\n\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A\n- shennian manager sessions list --json\n- shennian manager sessions start --title <\u77ED\u6807\u9898> --message <\u5B8C\u6574\u4EFB\u52A1>\uFF08\u56FA\u5B9A\u7EE7\u627F\u5F53\u524D Manager \u7684 Agent\u3001\u6A21\u578B\u548C\u5DF2\u7ED1\u5B9A\u76EE\u5F55\uFF09\n- shennian manager sessions send --session-id <id> --message <text>\n- shennian manager sessions queue list --session-id <id> --json\n- shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>\n- shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>\n- shennian manager sessions stop --session-id <id>\uFF08\u7EC8\u6B62\u6B63\u5728\u8FD0\u884C\u7684 worker\uFF1B\u4E5F\u53EF\u7528 terminate/kill \u522B\u540D\uFF09\n- shennian manager sessions read --session-id <id> --limit 200 --json\n- shennian manager sessions wait --session-id <id> --timeout <1-600>\uFF08\u53D7\u7BA1 Manager \u901A\u5E38\u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u5524\u9192\uFF0C\u4E0D\u4E3B\u52A8\u8F6E\u8BE2\uFF09\n- shennian manager memory path\n\n\u5982\u679C\u5BBF\u4E3B\u76F4\u63A5\u63D0\u4F9B\u4E86 shennian_manager_* \u5DE5\u5177\uFF0C\u4F18\u5148\u4F7F\u7528\u8FD9\u4E9B\u5DE5\u5177\u5B8C\u6210\u540C\u540D\u64CD\u4F5C\uFF0C\u4E0D\u8981\u518D\u901A\u8FC7 Shell \u8C03\u7528\u547D\u4EE4\u3002\u9650\u5236\u6743\u9650\u53EA\u7EA6\u675F Provider \u81EA\u8EAB\u7684\u6587\u4EF6\u3001Shell\u3001\u7F51\u7EDC\u548C\u666E\u901A\u5DE5\u5177\u80FD\u529B\uFF0C\u4E0D\u4F1A\u64A4\u9500\u795E\u5FF5\u6CE8\u5165\u7684 Manager Worker \u7BA1\u7406\u80FD\u529B\uFF1B\u4E0D\u5F97\u628A\u201C\u9650\u5236\u6743\u9650\u201D\u8BEF\u89E3\u4E3A\u4E0D\u80FD\u521B\u5EFA\u3001\u8BFB\u53D6\u3001\u53D1\u9001\u6216\u505C\u6B62 Worker\u3002\n\n\u53EF\u521B\u5EFA\u7684 worker Agent \u4EE5\u5F53\u524D daemon discovery \u8FD4\u56DE\u4E14 supportsWorker=true \u7684 Adapter \u4E3A\u51C6\uFF0C\u5305\u62EC\u901A\u8FC7 Agent Protocol \u63A5\u5165\u5E76\u901A\u8FC7\u5951\u7EA6\u7684 Runtime\uFF1B\u4E0D\u8981\u7EF4\u62A4\u6216\u731C\u6D4B Provider \u540D\u79F0\u767D\u540D\u5355\u3002sessions send \u59CB\u7EC8\u5148\u628A worker \u6D88\u606F\u4EA4\u7ED9\u672C\u673A durable queue\uFF1Aworker \u6B63\u5FD9\u65F6\u7B49\u5F85\uFF0C\u7A7A\u95F2\u65F6\u7ACB\u5373\u7531\u540C\u4E00\u8C03\u5EA6\u5668\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\n\n\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002";
-export declare function buildManagerPrompt(userText: string): string;

package/dist/src/manager/registry.d.ts

@@ -1,184 +0,0 @@
-import { type AgentType } from '@shennian/wire';
-export type ManagerStatus = 'idle' | 'running' | 'interrupting';
-export type WorkerStatus = 'running' | 'idle' | 'final' | 'error' | 'aborted';
-export type ManagedWorkerRecord = {
-    sessionId: string;
-    agentType: AgentType;
-    workDir: string;
-    managedBy: string;
-    status: WorkerStatus;
-    createdAt: string;
-    updatedAt: string;
-    lastActivityAt: string;
-    title?: string | null;
-    userGoal?: string | null;
-    lastMessagePreview?: string | null;
-    summary?: string | null;
-    agentSessionId?: string | null;
-    runId?: string | null;
-    canResume?: boolean;
-    source?: 'manager_registry' | 'local_index' | 'app_projection';
-    healthNotifiedAt?: string | null;
-    lastHealthSummary?: string | null;
-    role?: 'managed_worker' | 'project_session';
-    /** Origins indexed by Provider run id; legacy records omit this and stay private. */
-    runRoomOrigins?: Record<string, ManagedWorkerRoomOrigin>;
-};
-export type ManagedWorkerRoomOrigin = {
-    registryKey: string;
-    registrationEpoch: number;
-    bindingId: string;
-    roomId: string;
-};
-export type ManagerRecord = {
-    sessionId: string;
-    agentSessionId: string | null;
-    workDir: string;
-    machineId?: string | null;
-    modelId: AgentType;
-    /** Real provider for new Manager-mode sessions; legacy sessions use manager. */
-    agentType?: AgentType;
-    /** Real provider model for new Manager-mode sessions. */
-    providerModelId?: string | null;
-    defaultWorkerAgentType?: AgentType | null;
-    defaultWorkerModelId?: string | null;
-    /** This Manager Session originated from a managed Room and every synthetic
-     * continuation must reacquire that Room's current trusted context. */
-    managedRoomBound?: boolean;
-    controllerKind?: 'managed_session' | 'ephemeral';
-    status: ManagerStatus;
-    /** Event ids currently being transferred. Queue durable ACK ends inbox
-     * ownership; Provider start is intentionally not a second acknowledgement. */
-    deliveringInboxEventIds?: string[];
-    managedWorkerSessionIds: string[];
-    attachedExternalChannels: string[];
-    createdAt: string;
-    updatedAt: string;
-};
-export type EphemeralWorkerAction = 'read' | 'send' | 'wait' | 'stop';
-export type EphemeralWorkerGrant = {
-    refDigest: string;
-    managerSessionId: string;
-    workerSessionId: string;
-    workDir: string;
-    machineId: string;
-    accountNamespaceId: string | null;
-    actions: EphemeralWorkerAction[];
-    createdAt: string;
-    expiresAt: string;
-    revokedAt?: string | null;
-};
-export type WorkerRefResolution = {
-    ok: true;
-    grant: EphemeralWorkerGrant;
-} | {
-    ok: false;
-    reason: 'invalid' | 'expired' | 'revoked';
-};
-export type ManagerInboxEvent = {
-    id: string;
-    managerSessionId: string;
-    workerSessionId: string;
-    kind: 'worker.final' | 'worker.error' | 'worker.aborted' | 'worker.health';
-    priority: 'normal' | 'high';
-    runId?: string | null;
-    roomOrigin?: ManagedWorkerRoomOrigin | null;
-    summary: string;
-    code?: 'auth_required' | 'auth_retrying';
-    createdAt: string;
-    updatedAt: string;
-};
-export type ManagerVisibleSessionRecord = Omit<ManagedWorkerRecord, 'managedBy'> & {
-    managedBy: string | null;
-};
-export type ReplyTargetRecord = {
-    replyTarget: string;
-    managerSessionId: string;
-    channelId: string;
-    conversationId: string;
-    messageId?: string | null;
-    createdAt: string;
-};
-type RegistryFile = {
-    managers: Record<string, ManagerRecord>;
-    workers: Record<string, ManagedWorkerRecord>;
-    replyTargets: Record<string, ReplyTargetRecord>;
-    inbox: Record<string, ManagerInboxEvent[]>;
-    workerGrants: Record<string, EphemeralWorkerGrant>;
-};
-export declare class ManagerRegistry {
-    load(): RegistryFile;
-    save(registry: RegistryFile): void;
-    upsertManager(input: {
-        sessionId: string;
-        agentSessionId?: string | null;
-        workDir: string;
-        machineId?: string | null;
-        modelId: AgentType;
-        agentType?: AgentType;
-        providerModelId?: string | null;
-        defaultWorkerAgentType?: AgentType | null;
-        defaultWorkerModelId?: string | null;
-        managedRoomBound?: boolean;
-        controllerKind?: 'managed_session' | 'ephemeral';
-        status?: ManagerStatus;
-        deliveringInboxEventIds?: string[];
-    }): ManagerRecord;
-    getManager(sessionId: string): ManagerRecord | undefined;
-    issueWorkerRef(input: {
-        managerSessionId: string;
-        workerSessionId: string;
-        workDir: string;
-        machineId: string;
-        accountNamespaceId?: string | null;
-        actions?: EphemeralWorkerAction[];
-        ttlMs?: number;
-    }): {
-        workerRef: string;
-        grant: EphemeralWorkerGrant;
-    };
-    resolveWorkerRef(input: {
-        workerRef: string;
-        action: EphemeralWorkerAction;
-        machineId: string;
-        accountNamespaceId?: string | null;
-    }): EphemeralWorkerGrant | undefined;
-    resolveWorkerRefDetailed(input: {
-        workerRef: string;
-        action: EphemeralWorkerAction;
-        machineId: string;
-        accountNamespaceId?: string | null;
-    }): WorkerRefResolution;
-    revokeWorkerRefsForWorker(workerSessionId: string): void;
-    enqueueInboxEvent(input: Omit<ManagerInboxEvent, 'id' | 'createdAt' | 'updatedAt'>): ManagerInboxEvent | null;
-    listInboxEvents(managerSessionId: string): ManagerInboxEvent[];
-    removeInboxEvents(managerSessionId: string, eventIds: readonly string[]): void;
-    addWorker(input: {
-        managerSessionId: string;
-        sessionId?: string;
-        agentType: AgentType;
-        workDir: string;
-        title?: string | null;
-        summary?: string | null;
-    }): ManagedWorkerRecord;
-    updateWorker(sessionId: string, patch: Partial<ManagedWorkerRecord>): ManagedWorkerRecord | undefined;
-    clearWorkerRunOrigins(): void;
-    listWorkers(managerSessionId: string, opts?: {
-        includeManagers?: boolean;
-        runningSessionIds?: Set<string>;
-    }): ManagerVisibleSessionRecord[];
-    getWorkerForManager(managerSessionId: string, sessionId: string): ManagerVisibleSessionRecord | undefined;
-    retireManager(managerSessionId: string): ManagedWorkerRecord[];
-    completeRetiredWorker(managerSessionId: string, workerSessionId: string): void;
-    private decorateManagedWorker;
-    private readTranscriptSummary;
-    createReplyTarget(input: {
-        managerSessionId: string;
-        channelId: string;
-        conversationId: string;
-        messageId?: string | null;
-    }): ReplyTargetRecord;
-    getReplyTarget(replyTarget: string): ReplyTargetRecord | undefined;
-    getLatestReplyTargetForManager(managerSessionId: string): ReplyTargetRecord | undefined;
-}
-export {};

package/dist/src/manager/retired-external-channel-compat.d.ts

@@ -1,78 +0,0 @@
-import type { ExternalChannelSessionStatus } from '@shennian/wire';
-export type ExternalMessageAttachment = {
-    [key: string]: any;
-    kind?: string;
-    name?: string;
-    mimeType?: string;
-    size?: number;
-    localPath?: string;
-    url?: string;
-    dataBase64?: string;
-};
-export type ExternalReplyAttachment = ExternalMessageAttachment;
-export type ExternalMessageEvent = {
-    [key: string]: any;
-    channelId: string;
-    channelType: string;
-    conversation: {
-        id: string;
-        name?: string;
-    };
-    sender: {
-        id: string;
-        name?: string;
-    };
-    text: string;
-    attachments: ExternalMessageAttachment[];
-    messageId?: string;
-};
-export type WeChatRpaSessionContext = {
-    sessionId: string;
-    workDir: string;
-    agentType?: string;
-    agentSessionId?: string | null;
-    modelId?: string | null;
-    externalChannel?: ExternalChannelSessionStatus | null;
-};
-export type WeChatAutomationLane = {
-    run<T>(key: string, action: () => Promise<T>): Promise<T>;
-};
-export type ChannelRuntimeOptions = {
-    createWeChatRpaProductRunner?: unknown;
-    weChatAutomationLane?: WeChatAutomationLane;
-};
-export declare class RetiredChannelRuntime {
-    constructor(_onMessage?: (managerSessionId: string, event: ExternalMessageEvent) => void, _createReplyTarget?: (input: any) => any, _options?: ChannelRuntimeOptions);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getManagerChannel(..._args: any[]): any;
-    getManagerChannelStatus(..._args: any[]): ExternalChannelSessionStatus | null;
-    getChannelStatusById(..._args: any[]): ExternalChannelSessionStatus | null;
-    getChannelById(..._args: any[]): any;
-    listManagerChannelStatuses(..._args: any[]): Array<{
-        managerSessionId: string;
-    }>;
-    listManagerExternalChannels(..._args: any[]): any[];
-    listChannelIdsManagedBy(..._args: any[]): string[];
-    getDefaultReplyTarget(..._args: any[]): Promise<any>;
-    upsertManagerChannel(..._args: any[]): Promise<any>;
-    upsertManagerWeChatRpaChannel(..._args: any[]): Promise<any>;
-    syncManagerWeChatRpaChannel(..._args: any[]): Promise<any>;
-    cancelManagerWeChatRpaOutbound(..._args: any[]): Promise<any>;
-    deleteManagerWeChatRpaChannel(..._args: any[]): Promise<any>;
-    reply(..._args: any[]): Promise<any>;
-}
-export declare class RetiredWeChatRpaSessionBindingSync {
-    constructor(..._args: unknown[]);
-    reconcileSession(..._args: any[]): Promise<void>;
-    reconcileAll(..._args: any[]): Promise<void>;
-}
-export declare function createRetiredAutomationLane(): WeChatAutomationLane;
-export declare function createRetiredChannelApiClient(..._args: any[]): {
-    listBindings: (..._args: any[]) => Promise<{
-        bindings: any[];
-    }>;
-};
-export declare function retiredDirectWeChat(..._args: any[]): Promise<any>;
-export declare function splitExternalReplyText(text: string): string[];
-export declare function weChatChannelConversationId(name: string): string;