shennian 0.3.41 → 0.3.43

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

@@ -25,9 +25,54 @@ export type FsChunk = {
 export type FsTransferManifestEntry = {
     relativePath: string;
     size: number;
+    sha256: string;
     mimeType?: string;
     modifiedAt?: number;
 };
+export type FsTransferStartParams = {
+    transferId: string;
+    rootPath: string;
+    name: string;
+    totalSize: number;
+    sha256: string;
+    mimeType: string;
+    kind: 'file' | 'folder';
+    manifest?: FsTransferManifestEntry[];
+};
+export type FsTransferStartResult = {
+    transferId: string;
+    path: string;
+    reused: boolean;
+    offsets: Record<string, number>;
+    attachment?: FsTransferFinishResult;
+};
+export type FsTransferChunkParams = {
+    transferId: string;
+    rootPath: string;
+    offset: number;
+    data: string;
+    relativePath?: string;
+};
+export type FsTransferFinishParams = {
+    transferId: string;
+    rootPath: string;
+};
+export type FsTransferFinishResult = {
+    transferId: string;
+    path: string;
+    name: string;
+    mimeType: string;
+    kind: 'file' | 'folder';
+    byteSize: number;
+    sha256: string;
+    reused: boolean;
+};
+export type FsTransferAbortParams = {
+    transferId: string;
+    rootPath: string;
+};
+/** Stable input for the aggregate hash of a folder transfer. */
+export declare function serializeFsTransferManifest(entries: readonly FsTransferManifestEntry[]): string;
 export type FsRenameResult = {
     oldPath: string;
     newPath: string;

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

@@ -1 +1,7 @@
-export {};
+/** Stable input for the aggregate hash of a folder transfer. */
+export function serializeFsTransferManifest(entries) {
+    return [...entries]
+        .sort((left, right) => left.relativePath.localeCompare(right.relativePath))
+        .map((entry) => `${entry.relativePath}\0${entry.size}\0${entry.sha256.toLowerCase()}`)
+        .join('\n');
+}

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

@@ -5,6 +5,7 @@ export * from './methods.ts';
 export * from './frames.ts';
 export * from './fs.ts';
 export * from './session.ts';
+export * from './session-sync.ts';
 export * from './message-payload.ts';
 export * from './external-message-format.ts';
 export * from './native-session.ts';

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

@@ -5,6 +5,7 @@ export * from "./methods.js";
 export * from "./frames.js";
 export * from "./fs.js";
 export * from "./session.js";
+export * from "./session-sync.js";
 export * from "./message-payload.js";
 export * from "./external-message-format.js";
 export * from "./native-session.js";

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

@@ -14,6 +14,12 @@ export type Machine = {
     region?: string;
     /** CLI version currently running on this machine */
     cliVersion?: string;
+    /** Stable identity of the daemon data root. It is not the mobile installationId. */
+    daemonInstallationId?: string;
+    /** Personal Session sync protocol understood by this daemon. */
+    sessionSyncProtocolVersion?: import('./session-sync.ts').SessionSyncProtocolVersion;
+    /** Full capability set required by the hard-cutover personal Session protocol. */
+    sessionSyncCapabilities?: import('./session-sync.ts').SessionSyncCapability[];
     /** Auto-upgrade policy configured on this machine */
     autoUpgrade?: AutoUpgradePolicy;
     /** Ownership role — absent means owner (backward-compatible) */

package/node_modules/@shennian/wire/dist/message-payload.d.ts

@@ -4,6 +4,8 @@ export type ChatAttachmentMeta = {
     name: string;
     mimeType: string;
     kind: ChatAttachmentKind;
+    byteSize?: number;
+    sha256?: string;
     previewData?: string;
 };
 export type StructuredUserMessagePayload = {

package/node_modules/@shennian/wire/dist/message-payload.js

@@ -52,7 +52,21 @@ function parseAttachmentMeta(value) {
     if (!path || !name || !mimeType || !kind)
         return null;
     const previewData = typeof entry.previewData === 'string' && entry.previewData.trim() ? entry.previewData.trim() : undefined;
-    return { path, name, mimeType, kind, ...(previewData ? { previewData } : {}) };
+    const byteSize = typeof entry.byteSize === 'number' && Number.isSafeInteger(entry.byteSize) && entry.byteSize >= 0
+        ? entry.byteSize
+        : undefined;
+    const sha256 = typeof entry.sha256 === 'string' && /^[a-f0-9]{64}$/i.test(entry.sha256)
+        ? entry.sha256.toLowerCase()
+        : undefined;
+    return {
+        path,
+        name,
+        mimeType,
+        kind,
+        ...(byteSize !== undefined ? { byteSize } : {}),
+        ...(sha256 ? { sha256 } : {}),
+        ...(previewData ? { previewData } : {}),
+    };
 }
 export function parseStructuredMessagePayload(payload) {
     const parsed = parseObjectPayload(payload);

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

@@ -1 +1 @@
-export type ReqMethod = 'chat.send' | 'chat.enqueue' | 'chat.queue.get' | 'chat.queue.edit' | 'chat.queue.delete' | 'chat.abort' | 'session.resume' | 'session.history' | 'session.refresh' | 'session.tool.detail' | 'session.title.set' | 'fs.ls' | 'fs.read' | 'fs.write' | 'fs.export.markdown-pdf' | 'fs.export.markdown-pdf.setup' | 'fs.archive.zip' | 'fs.transfer' | 'fs.transfer.start' | 'fs.transfer.chunk' | 'fs.transfer.finish' | 'fs.transfer.abort' | 'fs.rename' | 'skill.list' | 'skill.install' | 'skill.doctor' | 'skill.setup' | 'skill.use' | 'region.probe' | 'region.switch' | 'upgrade.start' | 'upgrade.status' | 'upgrade.set-policy' | 'agents.refresh' | 'models.refresh' | 'agent.config.get' | 'agent.config.upsert' | 'agent.config.clear' | 'agent.config.test' | 'agent.capabilities.list' | 'manager.channel.get' | 'manager.channel.upsert' | 'session.wechat-rpa.channel.get' | 'session.wechat-rpa.channel.upsert' | 'session.wechat-rpa.channel.sync' | 'session.wechat-rpa.outbound.cancel' | 'manager.wechat-rpa.channel.get' | 'manager.wechat-rpa.channel.upsert' | 'manager.wechat-rpa.channel.sync' | 'manager.wechat-rpa.outbound.cancel' | 'wechat-rpa.helper.runtime' | 'wecom.send' | 'external.send' | 'room.sync' | 'room.send' | 'room.bind' | 'room.agent.bind-managed' | 'room.agent.restart-managed' | 'room.unbind';
+export type ReqMethod = 'chat.send' | 'chat.enqueue' | 'chat.queue.get' | 'chat.queue.edit' | 'chat.queue.delete' | 'chat.abort' | 'session.resume' | 'session.history' | 'session.history.open' | 'session.history.page' | 'session.history.close' | 'session.index.update' | 'session.message.status' | 'voice.session.body.window' | 'session.refresh' | 'session.tool.detail' | 'session.title.set' | 'fs.ls' | 'fs.read' | 'fs.write' | 'fs.export.markdown-pdf' | 'fs.export.markdown-pdf.setup' | 'fs.archive.zip' | 'fs.transfer.start' | 'fs.transfer.chunk' | 'fs.transfer.finish' | 'fs.transfer.abort' | 'fs.rename' | 'skill.list' | 'skill.install' | 'skill.doctor' | 'skill.setup' | 'skill.use' | 'region.probe' | 'region.switch' | 'upgrade.start' | 'upgrade.status' | 'upgrade.set-policy' | 'agents.refresh' | 'models.refresh' | 'agent.config.get' | 'agent.config.upsert' | 'agent.config.clear' | 'agent.config.test' | 'agent.capabilities.list' | 'manager.channel.get' | 'manager.channel.upsert' | 'session.wechat-rpa.channel.get' | 'session.wechat-rpa.channel.upsert' | 'session.wechat-rpa.channel.sync' | 'session.wechat-rpa.outbound.cancel' | 'manager.wechat-rpa.channel.get' | 'manager.wechat-rpa.channel.upsert' | 'manager.wechat-rpa.channel.sync' | 'manager.wechat-rpa.outbound.cancel' | 'wechat-rpa.helper.runtime' | 'wecom.send' | 'external.send' | 'room.sync' | 'room.send' | 'room.bind' | 'room.agent.bind-managed' | 'room.agent.restart-managed' | 'room.unbind';

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

@@ -0,0 +1,197 @@
+import type { Envelope } from './envelope.ts';
+import type { AgentType, ManagerConfig, SessionMode } from './session.ts';
+export declare const SESSION_SYNC_PROTOCOL_VERSION: 1;
+export type SessionSyncProtocolVersion = typeof SESSION_SYNC_PROTOCOL_VERSION;
+export declare const SESSION_SYNC_RELEASE_GATE: {
+    readonly minCliVersion: "0.3.42";
+    readonly minAppBuild: {
+        readonly ios: 51;
+        readonly android: 12;
+    };
+};
+export declare const SESSION_SYNC_REQUIRED_CAPABILITIES: readonly ["session_index_v1", "session_body_revision_v1", "session_history_subscription_v1", "local_canonical_v1", "session_title_authority_v1", "session_tool_detail_v1", "voice_session_body_relay_v1", "native_source_tombstone_v1", "session_durable_send_v1", "daemon_installation_identity_v1"];
+export declare const SESSION_SYNC_EVENT_NAMES: readonly ["session.index.updated", "session.body.delta"];
+export declare const SESSION_HISTORY_LIMITS: {
+    readonly defaultSnapshotMessages: 100;
+    readonly maxSnapshotMessages: 500;
+    readonly defaultPageMessages: 100;
+    readonly maxPageMessages: 500;
+    readonly maxDeltaMutations: 200;
+    readonly maxMutationBytes: number;
+    readonly maxSubscriptionsPerClient: 4;
+    readonly maxSubscriptionsPerSession: 8;
+};
+export type SessionSyncCapability = (typeof SESSION_SYNC_REQUIRED_CAPABILITIES)[number];
+export type SessionSyncEventName = (typeof SESSION_SYNC_EVENT_NAMES)[number];
+export type SessionBodyStorageMode = 'machine_local';
+export type SessionTitleSource = 'shennian_manual' | 'agent_native' | 'shennian_generated' | 'first_user_fallback';
+export declare const SESSION_TITLE_SOURCE_PRIORITY: Readonly<Record<SessionTitleSource, number>>;
+export declare function isSessionTitleSource(value: unknown): value is SessionTitleSource;
+export type SessionTitleSetParams = {
+    sessionId: string;
+    agentType: AgentType;
+    agentSessionId: string | null;
+    workDir: string;
+    title: string;
+    titleSource: 'shennian_manual';
+    titleRevision: number;
+    titleOriginEventId: string;
+};
+export type SessionSyncErrorCode = 'upgrade_required' | 'revision_gap' | 'snapshot_compacted' | 'machine_offline' | 'history_unavailable' | 'subscription_not_found' | 'subscription_limit_exceeded' | 'response_too_large';
+export type SessionSyncError = {
+    code: SessionSyncErrorCode;
+    message?: string;
+    requiredProtocolVersion?: SessionSyncProtocolVersion;
+    requiredCapabilities?: SessionSyncCapability[];
+    expectedRevision?: number;
+    actualRevision?: number;
+    retryable: boolean;
+};
+export type PersonalAttachmentReference = {
+    path: string;
+    name: string;
+    mimeType: string;
+    kind: 'file' | 'image' | 'folder';
+    byteSize: number;
+    sha256: string;
+};
+export type SessionDeliveryState = 'queued' | 'committed' | 'executing' | 'completed' | 'failed' | 'cancelled';
+export type SessionDurableSendAck<TState extends SessionDeliveryState = SessionDeliveryState> = {
+    sessionId: string;
+    clientMessageId: string;
+    messageId: string;
+    deliveryState: TState;
+    bodyRevision: number;
+    committedAt: string;
+};
+export type SessionMessageStatusParams = {
+    sessionId: string;
+    clientMessageId: string;
+};
+export type SessionMessageStatusResponse = {
+    state: 'not_found';
+    sessionId: string;
+    clientMessageId: string;
+} | {
+    [TState in SessionDeliveryState]: {
+        state: TState;
+    } & SessionDurableSendAck<TState>;
+}[SessionDeliveryState];
+export declare function getMissingSessionSyncCapabilities(capabilities: readonly string[] | null | undefined): SessionSyncCapability[];
+export declare function hasRequiredSessionSyncCapabilities(capabilities: readonly string[] | null | undefined): capabilities is readonly SessionSyncCapability[];
+export type SessionHistoryOpenParams = {
+    sessionId: string;
+    subscriptionId: string;
+    cachedBodyRevision?: number;
+    limit?: number;
+    beforeSequence?: number;
+};
+export type SessionHistoryMessage = {
+    sequence: number;
+    revision: number;
+    message: Envelope;
+};
+export type SessionHistorySnapshot = {
+    sessionId: string;
+    subscriptionId: string;
+    storageMode: SessionBodyStorageMode;
+    snapshotRevision: number;
+    firstAvailableSeq: number | null;
+    lastAvailableSeq: number | null;
+    hasOlder: boolean;
+    messages: SessionHistoryMessage[];
+};
+export type SessionHistoryPageParams = {
+    sessionId: string;
+    subscriptionId: string;
+    beforeSequence: number;
+    limit?: number;
+};
+export type SessionHistoryPage = {
+    sessionId: string;
+    subscriptionId: string;
+    snapshotRevision: number;
+    firstAvailableSeq: number | null;
+    hasOlder: boolean;
+    messages: SessionHistoryMessage[];
+};
+export type VoiceSessionBodyWindowParams = {
+    sessionId: string;
+    callId: string;
+    bodyRevision?: number;
+    limit?: number;
+    maxBytes?: number;
+};
+export type VoiceSessionBodyWindow = {
+    sessionId: string;
+    callId: string;
+    bodyRevision: number;
+    messages: Envelope[];
+    truncated: boolean;
+};
+export type SessionHistoryCloseParams = {
+    sessionId: string;
+    subscriptionId: string;
+};
+export type SessionHistoryCloseResponse = {
+    sessionId: string;
+    subscriptionId: string;
+    closed: true;
+};
+export type SessionBodyMutation = {
+    sessionId: string;
+    subscriptionId: string;
+    revision: number;
+    mutation: 'append' | 'upsert' | 'tombstone';
+    messageId: string;
+    sequence: number;
+    message?: Envelope;
+    deliveryState?: SessionDeliveryState;
+};
+export type SessionBodyDeltaEvent = {
+    sessionId: string;
+    subscriptionId: string;
+    fromRevision: number;
+    toRevision: number;
+    mutations: SessionBodyMutation[];
+};
+/**
+ * Machine-authored personal-session projection. Ownership, machine display
+ * fields and viewer permissions are server authority and therefore never
+ * accepted from a daemon payload.
+ */
+export type DaemonSessionIndexProjection = {
+    id: string;
+    agentType: AgentType;
+    sessionMode?: SessionMode;
+    managerConfig?: ManagerConfig | null;
+    agentSessionId: string | null;
+    modelId: string | null;
+    managerDefaultWorkerAgentType?: AgentType | null;
+    managerDefaultWorkerModelId?: string | null;
+    title: string;
+    titleSource: SessionTitleSource;
+    titleRevision: number;
+    titleLockedByUser: boolean;
+    titleOriginEventId: string | null;
+    status: 'active' | 'completed' | 'failed';
+    workDir: string;
+    lastMessagePreview: string | null;
+    bodyStorageMode: SessionBodyStorageMode;
+    bodyRevision: number;
+    indexRevision: number;
+    firstAvailableSeq: number | null;
+    visibleMessageCount: number;
+    lastVisibleMessageId: string | null;
+    lastBodyCommittedAt: string | null;
+    deletionRevision: number;
+    lastActivityAt: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt: string | null;
+};
+export type SessionIndexUpdate = {
+    protocolVersion: SessionSyncProtocolVersion;
+    daemonInstallationId: string;
+    session: DaemonSessionIndexProjection;
+};

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

@@ -0,0 +1,49 @@
+// @arch docs/architecture/data-sync.md#目标架构-v3
+// @test src/__tests__/session-sync.test.ts
+export const SESSION_SYNC_PROTOCOL_VERSION = 1;
+export const SESSION_SYNC_RELEASE_GATE = {
+    minCliVersion: '0.3.42',
+    minAppBuild: { ios: 51, android: 12 },
+};
+export const SESSION_SYNC_REQUIRED_CAPABILITIES = [
+    'session_index_v1',
+    'session_body_revision_v1',
+    'session_history_subscription_v1',
+    'local_canonical_v1',
+    'session_title_authority_v1',
+    'session_tool_detail_v1',
+    'voice_session_body_relay_v1',
+    'native_source_tombstone_v1',
+    'session_durable_send_v1',
+    'daemon_installation_identity_v1',
+];
+export const SESSION_SYNC_EVENT_NAMES = [
+    'session.index.updated',
+    'session.body.delta',
+];
+export const SESSION_HISTORY_LIMITS = {
+    defaultSnapshotMessages: 100,
+    maxSnapshotMessages: 500,
+    defaultPageMessages: 100,
+    maxPageMessages: 500,
+    maxDeltaMutations: 200,
+    maxMutationBytes: 256 * 1024,
+    maxSubscriptionsPerClient: 4,
+    maxSubscriptionsPerSession: 8,
+};
+export const SESSION_TITLE_SOURCE_PRIORITY = {
+    first_user_fallback: 0,
+    shennian_generated: 1,
+    agent_native: 2,
+    shennian_manual: 3,
+};
+export function isSessionTitleSource(value) {
+    return typeof value === 'string' && value in SESSION_TITLE_SOURCE_PRIORITY;
+}
+export function getMissingSessionSyncCapabilities(capabilities) {
+    const available = new Set(capabilities ?? []);
+    return SESSION_SYNC_REQUIRED_CAPABILITIES.filter((capability) => !available.has(capability));
+}
+export function hasRequiredSessionSyncCapabilities(capabilities) {
+    return getMissingSessionSyncCapabilities(capabilities).length === 0;
+}

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

@@ -1,4 +1,5 @@
 import type { NativeSessionSourceMode } from './native-session.js';
+import type { PersonalAttachmentReference, SessionBodyStorageMode, SessionTitleSource } from './session-sync.js';
 export type BuiltinAgentType = 'claude' | 'codex' | 'workbuddy' | 'gemini' | 'cursor' | 'openclaw' | 'opencode' | 'pi' | 'manager';
 export type CustomAgentType = `custom:${string}`;
 export type AgentType = BuiltinAgentType | CustomAgentType;
@@ -70,6 +71,10 @@ export type SessionUserState = {
     sessionId: string;
     pinnedAt?: string | null;
     lastReadAt?: string | null;
+    /** Index watermark captured atomically when the user marks this session read. */
+    lastReadBodyRevision?: number;
+    lastReadVisibleMessageCount?: number;
+    lastReadVisibleMessageId?: string | null;
     manualUnread?: boolean;
     updatedAt: string;
 };
@@ -184,9 +189,21 @@ export type NianSession = {
     managerDefaultWorkerAgentType?: AgentType | null;
     managerDefaultWorkerModelId?: string | null;
     title: string;
+    titleSource?: SessionTitleSource;
+    titleRevision?: number;
+    titleLockedByUser?: boolean;
+    titleOriginEventId?: string | null;
     status: 'active' | 'completed' | 'failed';
     workDir: string;
     lastMessagePreview?: string | null;
+    bodyStorageMode?: SessionBodyStorageMode;
+    bodyRevision?: number;
+    indexRevision?: number;
+    firstAvailableSeq?: number | null;
+    visibleMessageCount?: number;
+    lastVisibleMessageId?: string | null;
+    lastBodyCommittedAt?: string | null;
+    deletionRevision?: number;
     lastActivityAt: string;
     createdAt: string;
     updatedAt: string;
@@ -201,7 +218,7 @@ export type NianSession = {
     activity?: SessionActivitySnapshot | null;
     externalChannel?: ExternalChannelSessionStatus | null;
 };
-export type SessionListProjection = Pick<NianSession, 'id' | 'machineId' | 'userId' | 'agentType' | 'sessionMode' | 'managerConfig' | 'agentSessionId' | 'modelId' | 'managerDefaultWorkerAgentType' | 'managerDefaultWorkerModelId' | 'title' | 'status' | 'workDir' | 'lastMessagePreview' | 'lastActivityAt' | 'createdAt' | 'updatedAt' | 'deletedAt' | 'machineName' | 'ownerName' | 'ownerPhone' | 'ownerEmail' | 'canManage' | 'sharedMachineSession' | 'activity' | 'externalChannel'>;
+export type SessionListProjection = Pick<NianSession, 'id' | 'machineId' | 'userId' | 'agentType' | 'sessionMode' | 'managerConfig' | 'agentSessionId' | 'modelId' | 'managerDefaultWorkerAgentType' | 'managerDefaultWorkerModelId' | 'title' | 'titleSource' | 'titleRevision' | 'titleLockedByUser' | 'titleOriginEventId' | 'status' | 'workDir' | 'lastMessagePreview' | 'bodyStorageMode' | 'bodyRevision' | 'indexRevision' | 'firstAvailableSeq' | 'visibleMessageCount' | 'lastVisibleMessageId' | 'lastBodyCommittedAt' | 'deletionRevision' | 'lastActivityAt' | 'createdAt' | 'updatedAt' | 'deletedAt' | 'machineName' | 'ownerName' | 'ownerPhone' | 'ownerEmail' | 'canManage' | 'sharedMachineSession' | 'activity' | 'externalChannel'>;
 export type ChatSendParams = {
     sessionId: string;
     text: string;
@@ -217,10 +234,8 @@ export type ChatSendParams = {
     reasoningEffort?: string | null;
     clientMessageId?: string;
     sessionListProjection?: SessionListProjection[];
-    attachments?: Array<{
-        path: string;
-        name: string;
-        mimeType: string;
+    attachments?: Array<PersonalAttachmentReference & {
+        /** @deprecated Removed by the hard-cutover attachment migration. */
         previewData?: string;
     }>;
     externalChannel?: ExternalChannelSessionStatus | null;
@@ -241,10 +256,8 @@ export type QueuedChatMessage = {
     managerDefaultWorkerModelId?: string | null;
     reasoningEffort?: string | null;
     clientMessageId?: string | null;
-    attachments?: Array<{
-        path: string;
-        name: string;
-        mimeType: string;
+    attachments?: Array<PersonalAttachmentReference & {
+        /** @deprecated Removed by the hard-cutover attachment migration. */
         previewData?: string;
     }>;
     externalChannel?: ExternalChannelSessionStatus | null;
@@ -268,10 +281,8 @@ export type ChatQueueEditParams = {
     sessionId: string;
     queueMessageId: string;
     text: string;
-    attachments?: Array<{
-        path: string;
-        name: string;
-        mimeType: string;
+    attachments?: Array<PersonalAttachmentReference & {
+        /** @deprecated Removed by the hard-cutover attachment migration. */
         previewData?: string;
     }>;
 };

package/node_modules/@shennian/wire/dist/tool-detail.d.ts

@@ -1,4 +1,12 @@
+export declare const SESSION_TOOL_DETAIL_LIMITS: {
+    readonly defaultMaxBytes: number;
+    readonly minMaxBytes: number;
+    readonly maxMaxBytes: number;
+    readonly responseTtlMs: number;
+    readonly relayTimeoutMs: number;
+};
 export type ToolDetailStatus = 'available' | 'not_found' | 'unsupported' | 'unavailable';
+export type ToolDetailUnavailableReason = 'not_found' | 'revision_mismatch' | 'machine_offline' | 'request_timeout' | 'response_too_large' | 'unsupported';
 export type ToolDetailSource = 'local-session-store' | 'local-tool-index' | 'native-local-index' | 'unavailable';
 export type ToolDetailRef = {
     runId?: string;
@@ -7,24 +15,23 @@ export type ToolDetailRef = {
 };
 export type SessionToolDetailRequest = {
     sessionId: string;
-    messageId: string;
-    toolIndex?: number;
-    name?: string;
-    runId?: string;
-    sourceSeq?: number;
-    detailRef?: ToolDetailRef | string | null;
-    maxChars?: number;
+    toolCallId: string;
+    detailRevision: number;
+    maxBytes?: number;
 };
 export type SessionToolDetailResponse = {
+    sessionId: string;
+    toolCallId: string;
+    detailRevision: number;
     detailStatus: ToolDetailStatus;
-    messageId?: string;
-    toolIndex?: number;
-    name?: string;
     status?: 'running' | 'completed' | 'failed';
     command?: string;
     argsSummary?: unknown;
     result?: string;
     resultOmitted: boolean;
+    redacted: boolean;
+    byteSize: number;
+    expiresAt: string;
     source: ToolDetailSource;
-    reason?: string;
+    reason?: ToolDetailUnavailableReason;
 };

package/node_modules/@shennian/wire/dist/tool-detail.js

@@ -1,3 +1,9 @@
 // @arch docs/architecture/data-retention-and-sync-policy.md#tool-结果
 // @test src/__tests__/types.test.ts
-export {};
+export const SESSION_TOOL_DETAIL_LIMITS = {
+    defaultMaxBytes: 32 * 1024,
+    minMaxBytes: 4 * 1024,
+    maxMaxBytes: 64 * 1024,
+    responseTtlMs: 5 * 60 * 1_000,
+    relayTimeoutMs: 15 * 1_000,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shennian",
-  "version": "0.3.41",
+  "version": "0.3.43",
   "description": "Shennian — AI Agent Control Plane CLI",
   "type": "module",
   "bin": {

package/dist/src/session/remote-attachments.d.ts

@@ -1,15 +0,0 @@
-export type ChatAttachmentInput = {
-    path: string;
-    name: string;
-    mimeType: string;
-    previewData?: string;
-};
-export declare function materializeRemoteChatAttachments(input: {
-    text: string;
-    attachments?: ChatAttachmentInput[];
-    workDir: string;
-}): Promise<{
-    text: string;
-    attachments?: ChatAttachmentInput[];
-    localized: boolean;
-}>;

package/dist/src/session/remote-attachments.js

@@ -1 +0,0 @@
-import f from"node:crypto";import i from"node:fs";import o from"node:path";const l=Number(process.env.SHENNIAN_REMOTE_ATTACHMENT_MAX_BYTES||50*1024*1024);function m(t){return o.basename(t||"attachment").normalize("NFKC").replace(/[<>:"/\\|?*\x00-\x1F]/g,"_").replace(/[\r\n\t]+/g," ").replace(/\s+/g," ").replace(/_+/g,"_").replace(/^[ ._]+|[ ._]+$/g,"")||"attachment"}function u(t,a,e){const r=m(a),n=o.extname(r),c=n?r.slice(0,-n.length):r,s=o.join(t,r);return i.existsSync(s)?o.join(t,`${c}-${e.slice(0,8)}${n}`):s}function p(t){return/^https?:\/\//i.test(t)}async function d(t,a){if(!p(t.path))return t;const e=await fetch(t.path);if(!e.ok||Number(e.headers.get("content-length")||0)>l)return t;const n=Buffer.from(await e.arrayBuffer());if(!n.byteLength||n.byteLength>l)return t;const c=f.createHash("sha256").update(n).digest("hex"),s=o.join(a,".uploads");i.mkdirSync(s,{recursive:!0});const h=u(s,t.name,c);return i.existsSync(h)||i.writeFileSync(h,n),{...t,path:h,mimeType:t.mimeType||e.headers.get("content-type")||"application/octet-stream"}}function g(t,a,e){return a.path===e.path||!a.path||!e.path?t:t.split(a.path).join(e.path)}async function _(t){if(!t.attachments?.length)return{text:t.text,attachments:t.attachments,localized:!1};const a=[];let e=t.text,r=!1;for(const n of t.attachments){const c=await d(n,t.workDir).catch(()=>n);c.path!==n.path&&p(n.path)&&(r=!0),e=g(e,n,c),a.push(c)}return{text:e,attachments:a,localized:r}}export{_ as materializeRemoteChatAttachments};

package/dist/src/session/tool-summary.d.ts

@@ -1 +0,0 @@
-export declare function buildToolArgsSummary(value: unknown): unknown;

package/dist/src/session/tool-summary.js

@@ -1 +0,0 @@
-const o=240;function c(t){if(t==null)return;if(!t||typeof t!="object"||Array.isArray(t))return r(t);const n={};for(const[i,e]of Object.entries(t))if(!(e==null||e==="")&&(n[i]=r(e),Object.keys(n).length===2))break;return Object.keys(n).length?n:void 0}function r(t){if(typeof t=="string")return s(t)?"[SYSTEM CONTEXT REDACTED]":t.replace(/\s+/g," ").trim().slice(0,240);const n=JSON.stringify(t);return String(n??t).replace(/\s+/g," ").slice(0,240)}function s(t){const n=t.trim();return/^<environment_context>[\s\S]*<\/environment_context>$/i.test(n)||/^# AGENTS\.md instructions for [^\n]+[\s\S]*<INSTRUCTIONS>[\s\S]*<\/INSTRUCTIONS>/i.test(n)||/^<turn_aborted>[\s\S]*<\/turn_aborted>$/i.test(n)}export{c as buildToolArgsSummary};