@ai-workbench/remote-agent 0.8.15 → 0.8.17

package/dist/remote-details.js

@@ -1,3 +1,4 @@
+import { closeCode, withFailureEvidence } from "./close-diagnostics.js";
 import { createHash, randomUUID } from 'node:crypto';
 import { constants } from 'node:fs';
 import { mkdir, open, lstat, realpath, readdir } from 'node:fs/promises';
@@ -362,40 +363,67 @@ export function createRemoteDetails(options) {
                     scope.maximum = sequence;
                     const detail = Object.freeze({ ...safe, payload: wire(safe.payload), version: 1, eventId: randomUUID(), instanceId: request.connection.instanceId, epoch: request.connection.epoch, sessionId: request.sessionId, provider: request.provider, turn, step, sequence, kind: kind(observation) });
                     enqueue(async () => {
-                        // A private X journal is retained even if L is disconnected or rejects it.
+                        // Pending is not a delivery verdict. Keep the exact failed stage separately.
                         const file = join(dir, sequence + '-' + detail.eventId + '.json');
+                        let phase = 'journal', appendAttempted = false, outcomeKnown = false;
                         try {
-                            await durableWrite(file, { state: 'pending', detail });
-                        }
-                        catch {
-                            throw failure('REMOTE_DETAIL_STORAGE_FAILED');
-                        }
-                        stable();
-                        let response;
-                        try {
-                            response = await (localScope === undefined ? api.appendRemoteConversationDetail(structuredClone(detail)) : api.appendRemoteConversationDetail(structuredClone(detail), localScope));
-                        }
-                        catch {
+                            try {
+                                await durableWrite(file, { state: 'pending', detail });
+                            }
+                            catch {
+                                throw failure('REMOTE_DETAIL_STORAGE_FAILED');
+                            }
+                            phase = 'append-scope';
                             stable();
-                            const receipt = unwrap(await api.getRemoteConversationDetailReceipt({ eventId: detail.eventId, sessionId: detail.sessionId, provider: detail.provider }));
+                            let response;
+                            try {
+                                phase = 'append';
+                                appendAttempted = true;
+                                response = await (localScope === undefined ? api.appendRemoteConversationDetail(structuredClone(detail)) : api.appendRemoteConversationDetail(structuredClone(detail), localScope));
+                            }
+                            catch {
+                                phase = 'receipt-scope';
+                                stable();
+                                phase = 'receipt';
+                                const receipt = unwrap(await api.getRemoteConversationDetailReceipt({ eventId: detail.eventId, sessionId: detail.sessionId, provider: detail.provider }));
+                                phase = 'receipt-scope';
+                                stable();
+                                if (receipt.eventId !== detail.eventId)
+                                    throw failure('REMOTE_DETAIL_RECEIPT_INVALID');
+                                if (!receipt.recorded)
+                                    throw failure('REMOTE_DETAIL_DELIVERY_UNKNOWN');
+                                if (!isDeepStrictEqual(receipt.detail, detail))
+                                    throw failure('REMOTE_DETAIL_RECEIPT_INVALID');
+                                phase = 'settlement';
+                                await durableWrite(join(dir, 'settled-' + detail.eventId + '.json'), { eventId: detail.eventId, state: 'recorded' });
+                                outcomeKnown = true;
+                                return;
+                            }
+                            phase = 'ack-scope';
                             stable();
-                            if (receipt.eventId !== detail.eventId)
-                                throw failure('REMOTE_DETAIL_RECEIPT_INVALID');
-                            if (!receipt.recorded)
-                                throw failure('REMOTE_DETAIL_DELIVERY_UNKNOWN');
-                            if (!isDeepStrictEqual(receipt.detail, detail))
-                                throw failure('REMOTE_DETAIL_RECEIPT_INVALID');
+                            if (response?.ok === false) {
+                                phase = 'settlement';
+                                await durableWrite(join(dir, 'settled-' + detail.eventId + '.json'), { eventId: detail.eventId, state: 'rejected', code: response.error.code });
+                                outcomeKnown = true;
+                            }
+                            const ack = unwrap(response);
+                            if (ack.eventId !== detail.eventId || ack.recorded !== true)
+                                throw failure('REMOTE_DETAIL_RESPONSE_INVALID');
+                            phase = 'settlement';
                             await durableWrite(join(dir, 'settled-' + detail.eventId + '.json'), { eventId: detail.eventId, state: 'recorded' });
-                            return;
+                            outcomeKnown = true;
                         }
-                        stable();
-                        if (response?.ok === false) {
-                            await durableWrite(join(dir, 'settled-' + detail.eventId + '.json'), { eventId: detail.eventId, state: 'rejected', code: response.error.code });
+                        catch (error) {
+                            if (!outcomeKnown) {
+                                try {
+                                    await durableWrite(join(dir, 'unconfirmed-' + detail.eventId + '.json'), { version: 1, eventId: detail.eventId, state: 'unconfirmed', phase, appendAttempted, code: closeCode(error, 'REMOTE_DETAIL_STORAGE_FAILED') });
+                                }
+                                catch {
+                                    throw withFailureEvidence(error, [failure('REMOTE_DETAIL_STORAGE_FAILED')], 'diagnostic');
+                                }
+                            }
+                            throw error;
                         }
-                        const ack = unwrap(response);
-                        if (ack.eventId !== detail.eventId || ack.recorded !== true)
-                            throw failure('REMOTE_DETAIL_RESPONSE_INVALID');
-                        await durableWrite(join(dir, 'settled-' + detail.eventId + '.json'), { eventId: detail.eventId, state: 'recorded' });
                     });
                 },
                 async flush() { await tail; if (firstFailure)

package/dist/remote.d.ts

@@ -1,3 +1,4 @@
+import type { ConnectNeed } from '@ai-workbench/connect/api';
 import type { LoginDiagnostic } from './login-diagnostic.ts';
 import type { ChildProcessWithoutNullStreams } from 'node:child_process';
 /** Development-only direct SSH. Product transports must consume L's exported sshArgs (v0.2). */
@@ -19,6 +20,7 @@ export declare class NeedError extends Error {
     requires: string;
     technical?: LoginDiagnostic;
     officialReason?: string;
+    connectNeed?: Readonly<ConnectNeed>;
     constructor(code: string, message: string, requires: string);
 }
 export declare function shellQuote(value: string): string;

package/dist/remote.js

@@ -4,6 +4,7 @@ export class NeedError extends Error {
     requires;
     technical;
     officialReason;
+    connectNeed;
     constructor(code, message, requires) {
         super(message);
         this.name = 'NeedError';

package/dist/workspace-source.js

@@ -1,9 +1,11 @@
+import { withFailureEvidence } from "./failure-evidence.js";
+import { connectNeedError } from "./connect-need.js";
 import { isDeepStrictEqual } from 'node:util';
 import { sanitizeDisplayLabel } from "./conversation-details.js";
 import { NeedError } from "./remote.js";
 const fail = (code) => new NeedError(code, '工作区来源尚未确认，本轮未执行；你的原话仍保留。', '当前工作区来源及原始员工输入');
 const codeOf = (value) => value instanceof NeedError ? value.code : 'WORKSPACE_SOURCE_CONFIRMATION_FAILED';
-const diagnosticFailure = (error, diagnostic) => Object.assign(new NeedError('CONVERSATION_DETAILS_FAILED', '工作区来源诊断未能保存，本轮已停止；原话保留。', '原错误代码 ' + codeOf(error) + '；诊断错误代码 ' + codeOf(diagnostic)), { cause: new AggregateError([error, diagnostic], 'WORKSPACE_SOURCE_AND_DIAGNOSTIC_FAILED') });
+const diagnosticFailure = (error, diagnostic) => withFailureEvidence(error, [diagnostic], 'diagnostic', undefined, codeOf(error));
 /** Explicit human source transition only. No source selection is inferred from a folder path. */
 export async function confirmLegacyWorkspaceSource(get, api, request, hooks) {
     let initialContext = { workspaceId: null, bindingId: null, source: null, status: null };
@@ -81,7 +83,7 @@ export async function confirmLegacyWorkspaceSource(get, api, request, hooks) {
             const selected = await api.selectWorkspaceLocation({ instanceId: connection.instanceId, epoch: connection.epoch, workspaceId: workspace.id, expectedBindingId: frozen.bindingId, source: 'local' });
             request.signal?.throwIfAborted();
             if (!selected.ok)
-                throw new NeedError(selected.error.code, selected.error.message, selected.error.requires);
+                throw connectNeedError(selected.error);
             const current = await stable(false), value = selected.value, returned = value.items.filter(item => item.workspaceId === workspace.id);
             if (value.phase !== 'ready' || value.instanceId !== connection.instanceId || value.epoch !== connection.epoch || returned.length !== 1 || returned[0].source !== 'local' || returned[0].status !== 'selected' || !returned[0].bindingId || returned[0].bindingId === frozen.bindingId || returned[0].localPath !== workspace.path || current.source !== 'local' || current.status !== 'selected' || current.bindingId !== returned[0].bindingId)
                 throw fail('WORKSPACE_SOURCE_SELECTION_UNCONFIRMED');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-workbench/remote-agent",
-  "version": "0.8.15",
+  "version": "0.8.17",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -39,7 +39,7 @@
     "zod": "4.6.7"
   },
   "devDependencies": {
-    "@ai-workbench/connect": "file:test/fixtures/ai-workbench-connect-0.7.19.tgz",
+    "@ai-workbench/connect": "file:test/fixtures/ai-workbench-connect-0.7.20.tgz",
     "@ai-workbench/network": "file:test/fixtures/ai-workbench-network-0.4.4.tgz",
     "@deepseek-ai/cordis": "4.0.4",
     "@deepseek-ai/cordis-plugin-group": "1.0.4",
@@ -68,7 +68,7 @@
     "zustand": "4.4.7"
   },
   "peerDependencies": {
-    "@ai-workbench/connect": "~0.7.19",
+    "@ai-workbench/connect": "~0.7.20",
     "@ai-workbench/network": "~0.4.4",
     "@deepseek-ai/cordis": "4.0.4",
     "@deepseek-ai/dsh-agent": "0.2.0-rc.2",