@akagilnc/pi-workflow-roles 0.1.3749 → 0.1.3771

package/src/submission-correctable-error.ts

@@ -32,3 +32,41 @@ export function isCorrectableExecuteError(error: unknown): boolean {
     || error instanceof WorkerUnfinishedReasonReminderError
   );
 }
+
+/**
+ * Durable projection for ACP envelope tool catches only.
+ * Pi path keeps native throw → isError toolResult (no shared projection consumer).
+ */
+export type CorrectableExecuteRejectionProjection = {
+  readonly diagnostic: string;
+  readonly details: Record<string, unknown>;
+};
+
+/**
+ * One authority for correctable execute → diagnostic text + structured details.
+ * Consumed by the ACP envelope tool catch; host adapters wrap transport shape only.
+ */
+export function projectCorrectableExecuteRejection(
+  error: unknown,
+): CorrectableExecuteRejectionProjection {
+  const diagnostic = error instanceof Error ? error.message : String(error);
+  if (error instanceof GatekeeperDecisionError) {
+    return { diagnostic, details: { ...(error.result as Record<string, unknown>) } };
+  }
+  if (
+    error instanceof WorkerCommitReminderError
+    || error instanceof WorkerPrefixReminderError
+    || error instanceof WorkerUnfinishedReasonReminderError
+  ) {
+    return { diagnostic, details: { code: error.code } };
+  }
+  if (typeof (error as { code?: unknown }).code === "string") {
+    return { diagnostic, details: { code: (error as { code: string }).code } };
+  }
+  return {
+    diagnostic,
+    details: {
+      code: error instanceof Error && error.name ? error.name : "correctable-submission-error",
+    },
+  };
+}