@akagilnc/pi-workflow-roles 0.1.5406 → 0.1.5475

package/src/submission-ledger.ts

@@ -194,15 +194,6 @@ function resolveReadScope(
   return homeOrScope;
 }
 
-function recordsForAttempt<T extends { subject?: unknown; payload?: unknown }>(
-  owned: readonly T[],
-  attemptId: string | undefined,
-): readonly T[] {
-  // #836: courtAttempt is a recording tag for new courts, not a visibility gate.
-  void attemptId;
-  return owned;
-}
-
 /** Recording tag a row was written under — subject first, historical payload fallback. */
 function recordAttemptId(record: { subject?: unknown; payload?: unknown }): string | undefined {
   if (typeof record.subject === "object" && record.subject !== null) {
@@ -216,34 +207,6 @@ function recordAttemptId(record: { subject?: unknown; payload?: unknown }): stri
   return undefined;
 }
 
-/**
- * True when the given attemptId itself already produced a sealed or
- * audit-escalation submission (#836 r12 class 2). This is a separate
- * freshness signal, not a presentation filter — `recordsForAttempt` above
- * stays a pass-through so every original payload keeps presenting honestly
- * (#836: attemptId is a recording tag, not a visibility gate). Settlement
- * consumes this only to stop a prior attempt's stale acceptance from
- * outranking the current attempt's own real host-turn failure signal
- * (#637 original intent, restored narrowly).
- */
-export async function hasFreshAttemptSubmission(
-  cwd: string,
-  runId: string,
-  attemptId: string,
-  homeOrScope?: string | SubmissionLedgerReadScope,
-): Promise<boolean> {
-  const { owned } = await readOwnedSubmissionRecords(cwd, runId, resolveReadScope(homeOrScope));
-  return owned.some((record) => {
-    if (recordAttemptId(record) !== attemptId) return false;
-    if (record.kind === "sealed") return true;
-    if (record.kind === "outcome") {
-      const payload = record.payload as { type?: string; outcome?: string } | undefined;
-      return payload?.type === "outcome" && payload.outcome === "audit-escalation";
-    }
-    return false;
-  });
-}
-
 function isTerminalRoleName(value: unknown): value is TerminalRoleName {
   return typeof value === "string" && value.length > 0;
 }
@@ -359,55 +322,38 @@ function mapOwnedToSubmissionRows(
   };
 
   for (const record of scoped) {
-    const attemptId = recordAttemptId(record);
-    if (record.kind === "candidate") {
-      const payload = record.payload as Partial<Extract<SubmissionLedgerEvent, { type: "candidate" }>> & {
-        projection?: { role?: unknown };
-      } | undefined;
-      if (payload?.type !== "candidate" || payload.params === undefined) continue;
-      const callKey =
-        typeof payload.toolCallId === "string"
-          ? submissionCallKey(attemptId, payload.toolCallId)
-          : undefined;
-      const fallback = callKey !== undefined ? roleByCall.get(callKey) : undefined;
-      take(rowFromPayload("candidate", payload, payload.params, fallback), callKey);
-      continue;
-    }
-    if (record.kind === "sealed") {
-      const payload = record.payload as Partial<Extract<SubmissionLedgerEvent, { type: "sealed" }>> & {
-        projection?: { role?: unknown };
-      } | undefined;
-      if (payload?.type !== "sealed" || payload.accepted === undefined) continue;
-      const callKey =
-        typeof payload.toolCallId === "string"
-          ? submissionCallKey(attemptId, payload.toolCallId)
-          : undefined;
-      const fallback = callKey !== undefined ? roleByCall.get(callKey) : undefined;
-      take(rowFromPayload("accepted", payload, payload.accepted, fallback), callKey);
-      continue;
-    }
-    if (record.kind !== "outcome") continue;
-    const payload = record.payload as Partial<Extract<SubmissionLedgerEvent, { type: "outcome" }>> & {
+    const payload = record.payload as {
+      type?: unknown;
+      role?: unknown;
       projection?: { role?: unknown };
+      toolCallId?: unknown;
+      params?: unknown;
+      accepted?: unknown;
+      outcome?: unknown;
+      auditReceipt?: unknown;
+      auditOfficer?: unknown;
     } | undefined;
-    if (payload?.type !== "outcome" || payload.accepted === undefined) continue;
-    const outcome = payload.outcome;
-    const kind: RecordedSubmissionRow["kind"] |
-      undefined =
-      outcome === "audit-escalation"
-        ? "audit-escalation"
-        : outcome === "correctable-rejection"
-          ? "correctable-rejection"
-          : outcome === "infrastructure"
-            ? "infrastructure"
-            : undefined;
-    if (kind === undefined) continue;
-    const callKey =
-      typeof payload.toolCallId === "string"
-        ? submissionCallKey(attemptId, payload.toolCallId)
+    let kind: RecordedSubmissionRow["kind"] | undefined;
+    let original: unknown;
+    if (record.kind === "candidate" && payload?.type === "candidate") {
+      kind = "candidate";
+      original = payload.params;
+    } else if (record.kind === "sealed" && payload?.type === "sealed") {
+      kind = "accepted";
+      original = payload.accepted;
+    } else if (record.kind === "outcome" && payload?.type === "outcome") {
+      kind = payload.outcome === "audit-escalation" ? "audit-escalation"
+        : payload.outcome === "correctable-rejection" ? "correctable-rejection"
+        : payload.outcome === "infrastructure" ? "infrastructure"
         : undefined;
-    const fallback = callKey !== undefined ? roleByCall.get(callKey) : undefined;
-    take(rowFromPayload(kind, payload, payload.accepted, fallback), callKey);
+      original = payload.accepted;
+    }
+    if (kind === undefined || original === undefined || payload === undefined) continue;
+    const callKey = typeof payload.toolCallId === "string"
+      ? submissionCallKey(recordAttemptId(record), payload.toolCallId)
+      : undefined;
+    const fallback = callKey === undefined ? undefined : roleByCall.get(callKey);
+    take(rowFromPayload(kind, payload, original, fallback), callKey);
   }
   return out;
 }
@@ -425,8 +371,7 @@ export async function readRecordedSubmissionRows(
 ): Promise<readonly RecordedSubmissionRow[]> {
   const scope = resolveReadScope(homeOrScope);
   const { owned } = await readOwnedSubmissionRecords(cwd, runId, scope);
-  const scoped = recordsForAttempt(owned, scope.attemptId);
-  return mapOwnedToSubmissionRows(scoped);
+  return mapOwnedToSubmissionRows(owned);
 }
 
 /**
@@ -461,37 +406,6 @@ export async function readRecordedSubmissions(
   return (await readRecordedSubmissionRows(cwd, runId, homeOrScope)).map((row) => row.accepted);
 }
 
-/** True when the run has at least one recorded original payload (any outcome class). */
-export async function hasRecordedSubmission(
-  cwd: string,
-  runId: string,
-  homeOrScope?: string | SubmissionLedgerReadScope,
-): Promise<boolean> {
-  return (await readRecordedSubmissionRows(cwd, runId, homeOrScope)).length > 0;
-}
-
-export type LatestSubmissionOutcome = Extract<SubmissionLedgerEvent, { type: "outcome" }>;
-
-/** Latest non-final outcome on the run ledger (settlement residual precedence). */
-export async function readLatestSubmissionOutcome(
-  cwd: string,
-  runId: string,
-  homeOrScope?: string | SubmissionLedgerReadScope,
-): Promise<LatestSubmissionOutcome | undefined> {
-  const scope = resolveReadScope(homeOrScope);
-  const { owned } = await readOwnedSubmissionRecords(cwd, runId, scope);
-  const scoped = recordsForAttempt(owned, scope.attemptId);
-  for (let index = scoped.length - 1; index >= 0; index -= 1) {
-    const record = scoped[index];
-    if (record?.kind !== "outcome") continue;
-    const payload = record.payload as Partial<LatestSubmissionOutcome> | undefined;
-    if (payload?.type === "outcome" && typeof payload.outcome === "string") {
-      return payload as LatestSubmissionOutcome;
-    }
-  }
-  return undefined;
-}
-
 type LedgerState = { sequence: number };
 
 async function restoreState(cwd: string, runId: string, scope: SubmissionLedgerReadScope): Promise<LedgerState> {

package/dist/audit-escalation.js

@@ -1,7 +0,0 @@
-import { isRecord } from "./unknown-value.js";
-/** Historical audit-escalation discriminator retained for reading pre-#1057 run artifacts. */
-export const AUDIT_ESCALATION_KIND = "audit_escalation";
-export function isAuditEscalationResult(value) {
-    return isRecord(value)
-        && value.kind === AUDIT_ESCALATION_KIND;
-}

package/dist/pi/known-failure.js

@@ -1,51 +0,0 @@
-import { hasUpstreamErrorTestimony, projectConfirmedRemotePayload, } from "../upstream-error-testimony.js";
-export { hasUpstreamErrorTestimony } from "../upstream-error-testimony.js";
-function nonEmptyString(value) {
-    return typeof value === "string" && value.trim() !== "" ? value : undefined;
-}
-function sessionStopDetails(input) {
-    const details = {};
-    const errorMessage = nonEmptyString(input.errorMessage);
-    if (errorMessage !== undefined)
-        details.errorMessage = errorMessage;
-    const api = nonEmptyString(input.api);
-    if (api !== undefined)
-        details.api = api;
-    const rawStopReason = nonEmptyString(input.rawStopReason);
-    if (rawStopReason !== undefined)
-        details.rawStopReason = rawStopReason;
-    const testimony = hasUpstreamErrorTestimony(input);
-    if (testimony) {
-        const provider = nonEmptyString(input.provider);
-        if (provider !== undefined)
-            details.provider = provider;
-        const model = nonEmptyString(input.model);
-        if (model !== undefined)
-            details.model = model;
-    }
-    if (typeof input.httpStatus === "number")
-        details.httpStatus = input.httpStatus;
-    if (input.diagnostics !== undefined)
-        details.diagnostics = input.diagnostics;
-    // SDK structured payload fields: project only when held on a confirmed-remote node.
-    if (testimony)
-        Object.assign(details, projectConfirmedRemotePayload(input));
-    return details;
-}
-/**
- * Project a native session assistant stop onto the existing knownFailure chain.
- * Classification follows two-way testimony: typed HTTP status or SDK structure
- * keeps provider; stopReason / errorMessage prose alone never invents a class (#881).
- * Present upstream payload is preserved in details without rewriting; missing fields are omitted.
- */
-export function knownFailureFromProviderStop(input) {
-    if (input.stopReason !== "error" && input.stopReason !== "aborted")
-        return undefined;
-    const diagnostic = nonEmptyString(input.errorMessage);
-    const details = sessionStopDetails(input);
-    return {
-        ...(hasUpstreamErrorTestimony(input) ? { cause: "provider" } : {}),
-        ...(diagnostic === undefined ? {} : { diagnostic }),
-        ...(Object.keys(details).length === 0 ? {} : { details }),
-    };
-}

package/dist/typed-provider-http.js

@@ -1,57 +0,0 @@
-import { readFile, unlink, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-import { isEnoent, isRecord } from "./unknown-value.js";
-const TYPED_HTTP_FILE = "typed-provider-http.json";
-function typedProviderHttpPath(runDirectory) {
-  return join(runDirectory, TYPED_HTTP_FILE);
-}
-async function clearTypedProviderHttpObservation(runDirectory) {
-  try {
-    await unlink(typedProviderHttpPath(runDirectory));
-  } catch (error) {
-    if (isEnoent(error)) return;
-    throw error;
-  }
-}
-async function recordTypedProviderHttpStatus(runDirectory, observation) {
-  if (observation.httpStatus >= 200 && observation.httpStatus < 300) {
-    await clearTypedProviderHttpObservation(runDirectory);
-    return;
-  }
-  const body = {
-    httpStatus: observation.httpStatus,
-    provider: observation.provider
-  };
-  await writeFile(
-    typedProviderHttpPath(runDirectory),
-    `${JSON.stringify(body)}
-`,
-    "utf8"
-  );
-}
-async function readLatestTypedProviderHttpObservation(runDirectory) {
-  let text;
-  try {
-    text = await readFile(typedProviderHttpPath(runDirectory), "utf8");
-  } catch (error) {
-    if (isEnoent(error)) return void 0;
-    throw error;
-  }
-  const raw = JSON.parse(text);
-  if (!isRecord(raw)) {
-    throw new Error("typed provider HTTP observation must be a JSON object");
-  }
-  const record = raw;
-  if (typeof record.httpStatus !== "number") {
-    throw new Error("typed provider HTTP observation missing numeric httpStatus");
-  }
-  if (typeof record.provider !== "string" || record.provider.trim() === "") {
-    throw new Error("typed provider HTTP observation missing non-empty provider");
-  }
-  return { httpStatus: record.httpStatus, provider: record.provider };
-}
-export {
-  clearTypedProviderHttpObservation,
-  readLatestTypedProviderHttpObservation,
-  recordTypedProviderHttpStatus
-};

package/dist/upstream-error-testimony.js

@@ -1,19 +0,0 @@
-function isNonSuccessHttpStatus(status) {
-  return typeof status === "number" && (status < 200 || status >= 300);
-}
-function hasUpstreamErrorTestimony(input) {
-  if (isNonSuccessHttpStatus(input.httpStatus)) return true;
-  return Array.isArray(input.diagnostics) && input.diagnostics.length > 0;
-}
-function projectConfirmedRemotePayload(input) {
-  return {
-    ...input.body === void 0 ? {} : { body: input.body },
-    ...input.code === void 0 ? {} : { code: input.code },
-    ...input.errno === void 0 ? {} : { errno: input.errno }
-  };
-}
-export {
-  hasUpstreamErrorTestimony,
-  isNonSuccessHttpStatus,
-  projectConfirmedRemotePayload
-};

package/src/pi/known-failure.ts

@@ -1,76 +0,0 @@
-/**
- * Project native session assistant stops onto the host-contract knownFailure shape.
- */
-import type { RoleTurnKnownFailure } from "../host-contracts.ts";
-import {
-  hasUpstreamErrorTestimony,
-  projectConfirmedRemotePayload,
-} from "../upstream-error-testimony.ts";
-
-export { hasUpstreamErrorTestimony } from "../upstream-error-testimony.ts";
-
-function nonEmptyString(value: unknown): string | undefined {
-  return typeof value === "string" && value.trim() !== "" ? value : undefined;
-}
-
-function sessionStopDetails(input: {
-  readonly errorMessage?: string | null;
-  readonly provider?: string;
-  readonly model?: string;
-  readonly api?: string;
-  readonly rawStopReason?: string;
-  readonly httpStatus?: number;
-  readonly diagnostics?: unknown;
-  readonly body?: unknown;
-  readonly code?: unknown;
-  readonly errno?: unknown;
-}): Record<string, unknown> {
-  const details: Record<string, unknown> = {};
-  const errorMessage = nonEmptyString(input.errorMessage);
-  if (errorMessage !== undefined) details.errorMessage = errorMessage;
-  const api = nonEmptyString(input.api);
-  if (api !== undefined) details.api = api;
-  const rawStopReason = nonEmptyString(input.rawStopReason);
-  if (rawStopReason !== undefined) details.rawStopReason = rawStopReason;
-  const testimony = hasUpstreamErrorTestimony(input);
-  if (testimony) {
-    const provider = nonEmptyString(input.provider);
-    if (provider !== undefined) details.provider = provider;
-    const model = nonEmptyString(input.model);
-    if (model !== undefined) details.model = model;
-  }
-  if (typeof input.httpStatus === "number") details.httpStatus = input.httpStatus;
-  if (input.diagnostics !== undefined) details.diagnostics = input.diagnostics;
-  // SDK structured payload fields: project only when held on a confirmed-remote node.
-  if (testimony) Object.assign(details, projectConfirmedRemotePayload(input));
-  return details;
-}
-
-/**
- * Project a native session assistant stop onto the existing knownFailure chain.
- * Classification follows two-way testimony: typed HTTP status or SDK structure
- * keeps provider; stopReason / errorMessage prose alone never invents a class (#881).
- * Present upstream payload is preserved in details without rewriting; missing fields are omitted.
- */
-export function knownFailureFromProviderStop(input: {
-  readonly stopReason?: string;
-  readonly errorMessage?: string | null;
-  readonly provider?: string;
-  readonly model?: string;
-  readonly api?: string;
-  readonly rawStopReason?: string;
-  readonly httpStatus?: number;
-  readonly diagnostics?: unknown;
-  readonly body?: unknown;
-  readonly code?: unknown;
-  readonly errno?: unknown;
-}): RoleTurnKnownFailure | undefined {
-  if (input.stopReason !== "error" && input.stopReason !== "aborted") return undefined;
-  const diagnostic = nonEmptyString(input.errorMessage);
-  const details = sessionStopDetails(input);
-  return {
-    ...(hasUpstreamErrorTestimony(input) ? { cause: "provider" as const } : {}),
-    ...(diagnostic === undefined ? {} : { diagnostic }),
-    ...(Object.keys(details).length === 0 ? {} : { details }),
-  };
-}

package/src/typed-provider-http.ts

@@ -1,89 +0,0 @@
-/**
- * Shared durable typed-provider HTTP observation owner.
- * Published with both public-cli and navigator-attendance entries.
- */
-import { readFile, unlink, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-
-import { isEnoent, isRecord } from "./unknown-value.ts";
-
-const TYPED_HTTP_FILE = "typed-provider-http.json";
-
-export type TypedProviderHttpObservation = {
-  readonly httpStatus: number;
-  readonly provider: string;
-};
-
-function typedProviderHttpPath(runDirectory: string): string {
-  return join(runDirectory, TYPED_HTTP_FILE);
-}
-
-/**
- * Clear any prior attempt's typed provider HTTP observation.
- * Each initial/resume dispatch must start without inherited 429 evidence so
- * only the current attempt can qualify v1 resume.
- */
-export async function clearTypedProviderHttpObservation(
-  runDirectory: string,
-): Promise<void> {
-  try {
-    await unlink(typedProviderHttpPath(runDirectory));
-  } catch (error) {
-    if (isEnoent(error)) return;
-    throw error;
-  }
-}
-
-/**
- * Record a typed provider HTTP status observation for the admitted run.
- * Only non-success HTTP statuses are persisted (authorized error evidence).
- * A 2xx response clears any prior observation so success cannot leave stale
- * error evidence. Never inspects diagnostic prose.
- */
-export async function recordTypedProviderHttpStatus(
-  runDirectory: string,
-  observation: { readonly httpStatus: number; readonly provider: string },
-): Promise<void> {
-  if (observation.httpStatus >= 200 && observation.httpStatus < 300) {
-    await clearTypedProviderHttpObservation(runDirectory);
-    return;
-  }
-  const body: TypedProviderHttpObservation = {
-    httpStatus: observation.httpStatus,
-    provider: observation.provider,
-  };
-  await writeFile(
-    typedProviderHttpPath(runDirectory),
-    `${JSON.stringify(body)}\n`,
-    "utf8",
-  );
-}
-
-/**
- * Read the latest durable typed provider HTTP observation, if any.
- * Only ENOENT means absence (undefined). Read/parse/shape failures preserve the
- * real cause for the existing controlled-failure chain — never laundered as absence.
- */
-export async function readLatestTypedProviderHttpObservation(
-  runDirectory: string,
-): Promise<TypedProviderHttpObservation | undefined> {
-  let text: string;
-  try {
-    text = await readFile(typedProviderHttpPath(runDirectory), "utf8");
-  } catch (error) {
-    if (isEnoent(error)) return undefined;
-    throw error;
-  }
-  const raw: unknown = JSON.parse(text);
-  if (!isRecord(raw)) {
-    throw new Error("typed provider HTTP observation must be a JSON object");
-  }
-  const record = raw as Record<string, unknown>;
-  if (typeof record.httpStatus !== "number") {
-    throw new Error("typed provider HTTP observation missing numeric httpStatus");
-  }
-  if (typeof record.provider !== "string" || record.provider.trim() === "") {
-    throw new Error("typed provider HTTP observation missing non-empty provider");
-  }
-  return { httpStatus: record.httpStatus, provider: record.provider };
-}

package/src/upstream-error-testimony.ts

@@ -1,45 +0,0 @@
-/**
- * Single authority for upstream-error testimony (#307).
- * Non-2xx HTTP or non-empty SDK diagnostics = upstream testimony.
- * body/code/errno project only from a confirmed-remote node.
- * Seams keep their own shape/cause-chain reading and wrap via these primitives.
- */
-
-/** True when value is a numeric HTTP status outside 2xx. */
-export function isNonSuccessHttpStatus(status: unknown): status is number {
-  return typeof status === "number" && (status < 200 || status >= 300);
-}
-
-/**
- * Upstream testimony is a directly observed HTTP response or SDK-structured
- * remote error. Pi stopReason, selected provider/model names, silent stream
- * death, errorMessage prose (e.g. "500: …"), and locally synthesized errors
- * are not testimony.
- */
-export function hasUpstreamErrorTestimony(input: {
-  readonly httpStatus?: number;
-  readonly diagnostics?: unknown;
-}): boolean {
-  if (isNonSuccessHttpStatus(input.httpStatus)) return true;
-  return Array.isArray(input.diagnostics) && input.diagnostics.length > 0;
-}
-
-/**
- * Project body/code/errno only when the caller already confirmed remote testimony
- * on the same node. Plain local Error.code is never provider testimony.
- */
-export function projectConfirmedRemotePayload(input: {
-  readonly body?: unknown;
-  readonly code?: unknown;
-  readonly errno?: unknown;
-}): {
-  readonly body?: unknown;
-  readonly code?: unknown;
-  readonly errno?: unknown;
-} {
-  return {
-    ...(input.body === undefined ? {} : { body: input.body }),
-    ...(input.code === undefined ? {} : { code: input.code }),
-    ...(input.errno === undefined ? {} : { errno: input.errno }),
-  };
-}