@skrr-ai/cli 0.1.132 → 0.1.133

package/dist/lib/scoped-memory-command.js

@@ -7,6 +7,7 @@ exports.memoryNotMountedDiagnostic = memoryNotMountedDiagnostic;
 exports.parseMemoryMount = parseMemoryMount;
 exports.parseMountedMemoryStore = parseMountedMemoryStore;
 exports.parseMemoryApiError = parseMemoryApiError;
+exports.uncertainMemoryMutationRecovery = uncertainMemoryMutationRecovery;
 const core_1 = require("@oclif/core");
 const node_crypto_1 = require("node:crypto");
 const base_command_1 = require("../base-command");
@@ -191,6 +192,23 @@ function parseMemoryApiError(error) {
         };
     }
 }
+/** A gateway timeout can arrive after the canonical mutation committed. */
+function uncertainMemoryMutationRecovery(path, options, status) {
+    if (status !== 504 || options.method !== 'POST' || !/\/mutations\/[^/?]+$/.test(path))
+        return null;
+    const body = options.body;
+    if (!body || body.dryRun === true || typeof body.idempotencyKey !== 'string' || typeof body.targetStoreId !== 'string')
+        return null;
+    return {
+        message: `The write may have been saved. Inspect the canonical Store with skrr memory topics list using the same --agent and --store ${body.targetStoreId}${body.spaceId ? ' and --space ' + body.spaceId : ''}. If retrying the identical operation, use --idempotency-key ${body.idempotencyKey}.`,
+        details: {
+            outcome: 'unknown',
+            targetStoreId: body.targetStoreId,
+            idempotencyKey: body.idempotencyKey,
+            ...(typeof body.spaceId === 'string' ? { spaceId: body.spaceId } : {}),
+        },
+    };
+}
 class ScopedMemoryCommand extends base_command_1.BaseCommand {
     endpoint(agentId, suffix = '') {
         return `/api/agents/${encodeURIComponent(agentId)}/memories/workspace${suffix}`;
@@ -229,13 +247,14 @@ class ScopedMemoryCommand extends base_command_1.BaseCommand {
         catch (error) {
             if (error instanceof api_fetch_1.ApiFetchError) {
                 const parsed = parseMemoryApiError(error);
+                const recovery = uncertainMemoryMutationRecovery(path, options, error.status);
                 this.failWithCliError({
-                    message: `${parsed.code}: ${parsed.message}`,
+                    message: `${parsed.code}: ${parsed.message}${recovery ? ` ${recovery.message}` : ''}`,
                     code: parsed.code,
                     status: error.status,
                     exit: ERROR_EXITS[parsed.code] || (error.status === 404 ? 4 : error.status === 403 ? 5 : 2),
                     retryable: parsed.retryable,
-                    details: parsed.details,
+                    details: recovery ? { ...parsed.details, ...recovery.details } : parsed.details,
                 });
             }
             this.handleApiError(error);