@gbg/go-core 0.2.0-alpha.0 → 0.2.0-alpha.1

package/src/models/slim-identity.ts

@@ -5,7 +5,6 @@
 import * as z from "zod/v4-mini";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
-import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 export type CurrentAddressLocation = {
@@ -199,10 +198,10 @@ export const CurrentAddressLocation$inboundSchema: z.ZodMiniType<
   CurrentAddressLocation,
   unknown
 > = z.object({
-  latitude: types.optional(types.string()),
-  longitude: types.optional(types.string()),
-  geoAccuracy: types.optional(types.string()),
-  what3words: types.optional(types.string()),
+  latitude: z.optional(z.string()),
+  longitude: z.optional(z.string()),
+  geoAccuracy: z.optional(z.string()),
+  what3words: z.optional(z.string()),
 });
 
 export function currentAddressLocationFromJSON(
@@ -220,24 +219,24 @@ export const CurrentAddress$inboundSchema: z.ZodMiniType<
   CurrentAddress,
   unknown
 > = z.object({
-  lines: types.optional(z.array(types.string())),
-  addressString: types.optional(types.string()),
-  premise: types.optional(types.string()),
-  building: types.optional(types.string()),
-  subBuilding: types.optional(types.string()),
-  thoroughfare: types.optional(types.string()),
-  dependentThoroughfare: types.optional(types.string()),
-  locality: types.optional(types.string()),
-  dependentLocality: types.optional(types.string()),
-  doubleDependentLocality: types.optional(types.string()),
-  postalCode: types.optional(types.string()),
-  postBox: types.optional(types.string()),
-  country: types.optional(types.string()),
-  superAdministrativeArea: types.optional(types.string()),
-  administrativeArea: types.optional(types.string()),
-  subAdministrativeArea: types.optional(types.string()),
-  organization: types.optional(types.string()),
-  location: types.optional(z.lazy(() => CurrentAddressLocation$inboundSchema)),
+  lines: z.optional(z.array(z.string())),
+  addressString: z.optional(z.string()),
+  premise: z.optional(z.string()),
+  building: z.optional(z.string()),
+  subBuilding: z.optional(z.string()),
+  thoroughfare: z.optional(z.string()),
+  dependentThoroughfare: z.optional(z.string()),
+  locality: z.optional(z.string()),
+  dependentLocality: z.optional(z.string()),
+  doubleDependentLocality: z.optional(z.string()),
+  postalCode: z.optional(z.string()),
+  postBox: z.optional(z.string()),
+  country: z.optional(z.string()),
+  superAdministrativeArea: z.optional(z.string()),
+  administrativeArea: z.optional(z.string()),
+  subAdministrativeArea: z.optional(z.string()),
+  organization: z.optional(z.string()),
+  location: z.optional(z.lazy(() => CurrentAddressLocation$inboundSchema)),
 });
 
 export function currentAddressFromJSON(
@@ -255,10 +254,10 @@ export const PlaceOfBirthLocation$inboundSchema: z.ZodMiniType<
   PlaceOfBirthLocation,
   unknown
 > = z.object({
-  latitude: types.optional(types.string()),
-  longitude: types.optional(types.string()),
-  geoAccuracy: types.optional(types.string()),
-  what3words: types.optional(types.string()),
+  latitude: z.optional(z.string()),
+  longitude: z.optional(z.string()),
+  geoAccuracy: z.optional(z.string()),
+  what3words: z.optional(z.string()),
 });
 
 export function placeOfBirthLocationFromJSON(
@@ -274,24 +273,24 @@ export function placeOfBirthLocationFromJSON(
 /** @internal */
 export const PlaceOfBirth$inboundSchema: z.ZodMiniType<PlaceOfBirth, unknown> =
   z.object({
-    lines: types.optional(z.array(types.string())),
-    addressString: types.optional(types.string()),
-    premise: types.optional(types.string()),
-    building: types.optional(types.string()),
-    subBuilding: types.optional(types.string()),
-    thoroughfare: types.optional(types.string()),
-    dependentThoroughfare: types.optional(types.string()),
-    locality: types.optional(types.string()),
-    dependentLocality: types.optional(types.string()),
-    doubleDependentLocality: types.optional(types.string()),
-    postalCode: types.optional(types.string()),
-    postBox: types.optional(types.string()),
-    country: types.optional(types.string()),
-    superAdministrativeArea: types.optional(types.string()),
-    administrativeArea: types.optional(types.string()),
-    subAdministrativeArea: types.optional(types.string()),
-    organization: types.optional(types.string()),
-    location: types.optional(z.lazy(() => PlaceOfBirthLocation$inboundSchema)),
+    lines: z.optional(z.array(z.string())),
+    addressString: z.optional(z.string()),
+    premise: z.optional(z.string()),
+    building: z.optional(z.string()),
+    subBuilding: z.optional(z.string()),
+    thoroughfare: z.optional(z.string()),
+    dependentThoroughfare: z.optional(z.string()),
+    locality: z.optional(z.string()),
+    dependentLocality: z.optional(z.string()),
+    doubleDependentLocality: z.optional(z.string()),
+    postalCode: z.optional(z.string()),
+    postBox: z.optional(z.string()),
+    country: z.optional(z.string()),
+    superAdministrativeArea: z.optional(z.string()),
+    administrativeArea: z.optional(z.string()),
+    subAdministrativeArea: z.optional(z.string()),
+    organization: z.optional(z.string()),
+    location: z.optional(z.lazy(() => PlaceOfBirthLocation$inboundSchema)),
   });
 
 export function placeOfBirthFromJSON(
@@ -307,9 +306,9 @@ export function placeOfBirthFromJSON(
 /** @internal */
 export const IdNumber$inboundSchema: z.ZodMiniType<IdNumber, unknown> = z
   .object({
-    type: types.string(),
-    idNumber: types.string(),
-    country: types.optional(types.string()),
+    type: z.string(),
+    idNumber: z.string(),
+    country: z.optional(z.string()),
   });
 
 export function idNumberFromJSON(
@@ -325,16 +324,16 @@ export function idNumberFromJSON(
 /** @internal */
 export const SlimIdentity$inboundSchema: z.ZodMiniType<SlimIdentity, unknown> =
   z.object({
-    title: types.optional(types.string()),
-    firstName: types.optional(types.string()),
-    middleNames: types.optional(z.array(types.string())),
-    lastNames: types.optional(z.array(types.string())),
-    lastNamesAtBirth: types.optional(z.array(types.string())),
-    dateOfBirth: types.optional(types.string()),
-    gender: types.optional(types.string()),
-    currentAddress: types.optional(z.lazy(() => CurrentAddress$inboundSchema)),
-    placeOfBirth: types.optional(z.lazy(() => PlaceOfBirth$inboundSchema)),
-    idNumbers: types.optional(z.array(z.lazy(() => IdNumber$inboundSchema))),
+    title: z.optional(z.string()),
+    firstName: z.optional(z.string()),
+    middleNames: z.optional(z.array(z.string())),
+    lastNames: z.optional(z.array(z.string())),
+    lastNamesAtBirth: z.optional(z.array(z.string())),
+    dateOfBirth: z.optional(z.string()),
+    gender: z.optional(z.string()),
+    currentAddress: z.optional(z.lazy(() => CurrentAddress$inboundSchema)),
+    placeOfBirth: z.optional(z.lazy(() => PlaceOfBirth$inboundSchema)),
+    idNumbers: z.optional(z.array(z.lazy(() => IdNumber$inboundSchema))),
   });
 
 export function slimIdentityFromJSON(

package/src/models/slim-interaction-fetch-response.ts

@@ -5,10 +5,13 @@
 import * as z from "zod/v4-mini";
 import { safeParse } from "../lib/schemas.js";
 import * as openEnums from "../types/enums.js";
-import { ClosedEnum, OpenEnum } from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
-import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  OutstandingGroup,
+  OutstandingGroup$inboundSchema,
+} from "./outstanding-group.js";
 import { SlimResult, SlimResult$inboundSchema } from "./slim-result.js";
 
 export const SlimInteractionFetchResponseStatus = {
@@ -25,33 +28,19 @@ export type SlimInteractionFetchResponseJourney = {
   status: SlimInteractionFetchResponseStatus;
 };
 
-export const SlimInteractionFetchResponseCardinality = {
-  AtLeastOne: "at-least-one",
-} as const;
-export type SlimInteractionFetchResponseCardinality = ClosedEnum<
-  typeof SlimInteractionFetchResponseCardinality
->;
-
-export type SlimInteractionFetchResponseOutstandingGroup = {
-  elementId: string;
-  cardinality: SlimInteractionFetchResponseCardinality;
-  refs: Array<string>;
-};
-
 export type SlimInteractionFetchResponseJoinedDevice = {
   connected: boolean;
 };
 
 export type SlimInteractionFetchResponse = {
+  view: "slim";
   instanceId: string;
   interactionId?: string | undefined;
   journey: SlimInteractionFetchResponseJourney;
   interaction?: { [k: string]: any } | undefined;
   processing?: boolean | undefined;
   outstanding?: Array<string> | undefined;
-  outstandingGroups?:
-    | Array<SlimInteractionFetchResponseOutstandingGroup>
-    | undefined;
+  outstandingGroups?: Array<OutstandingGroup> | undefined;
   instructions?: Array<string> | undefined;
   result?: SlimResult | undefined;
   joinedDevice?: SlimInteractionFetchResponseJoinedDevice | undefined;
@@ -82,41 +71,10 @@ export function slimInteractionFetchResponseJourneyFromJSON(
   );
 }
 
-/** @internal */
-export const SlimInteractionFetchResponseCardinality$inboundSchema:
-  z.ZodMiniEnum<typeof SlimInteractionFetchResponseCardinality> = z.enum(
-    SlimInteractionFetchResponseCardinality,
-  );
-
-/** @internal */
-export const SlimInteractionFetchResponseOutstandingGroup$inboundSchema:
-  z.ZodMiniType<SlimInteractionFetchResponseOutstandingGroup, unknown> = z
-    .object({
-      elementId: types.string(),
-      cardinality: SlimInteractionFetchResponseCardinality$inboundSchema,
-      refs: z.array(types.string()),
-    });
-
-export function slimInteractionFetchResponseOutstandingGroupFromJSON(
-  jsonString: string,
-): SafeParseResult<
-  SlimInteractionFetchResponseOutstandingGroup,
-  SDKValidationError
-> {
-  return safeParse(
-    jsonString,
-    (x) =>
-      SlimInteractionFetchResponseOutstandingGroup$inboundSchema.parse(
-        JSON.parse(x),
-      ),
-    `Failed to parse 'SlimInteractionFetchResponseOutstandingGroup' from JSON`,
-  );
-}
-
 /** @internal */
 export const SlimInteractionFetchResponseJoinedDevice$inboundSchema:
   z.ZodMiniType<SlimInteractionFetchResponseJoinedDevice, unknown> = z.object({
-    connected: types.boolean(),
+    connected: z.boolean(),
   });
 
 export function slimInteractionFetchResponseJoinedDeviceFromJSON(
@@ -140,20 +98,17 @@ export const SlimInteractionFetchResponse$inboundSchema: z.ZodMiniType<
   SlimInteractionFetchResponse,
   unknown
 > = z.object({
-  instanceId: types.string(),
-  interactionId: types.optional(types.string()),
+  view: z.literal("slim"),
+  instanceId: z.string(),
+  interactionId: z.optional(z.string()),
   journey: z.lazy(() => SlimInteractionFetchResponseJourney$inboundSchema),
-  interaction: types.optional(z.record(z.string(), z.any())),
-  processing: types.optional(types.boolean()),
-  outstanding: types.optional(z.array(types.string())),
-  outstandingGroups: types.optional(
-    z.array(z.lazy(() =>
-      SlimInteractionFetchResponseOutstandingGroup$inboundSchema
-    )),
-  ),
-  instructions: types.optional(z.array(types.string())),
-  result: types.optional(SlimResult$inboundSchema),
-  joinedDevice: types.optional(
+  interaction: z.optional(z.record(z.string(), z.any())),
+  processing: z.optional(z.boolean()),
+  outstanding: z.optional(z.array(z.string())),
+  outstandingGroups: z.optional(z.array(OutstandingGroup$inboundSchema)),
+  instructions: z.optional(z.array(z.string())),
+  result: z.optional(SlimResult$inboundSchema),
+  joinedDevice: z.optional(
     z.lazy(() => SlimInteractionFetchResponseJoinedDevice$inboundSchema),
   ),
 });

package/src/models/slim-journey.ts

@@ -5,7 +5,6 @@
 import * as z from "zod/v4-mini";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
-import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 export type SlimJourney = {
@@ -19,11 +18,11 @@ export type SlimJourney = {
 /** @internal */
 export const SlimJourney$inboundSchema: z.ZodMiniType<SlimJourney, unknown> = z
   .object({
-    id: types.optional(types.string()),
-    name: types.optional(types.string()),
-    version: types.optional(types.string()),
-    startedAt: types.optional(types.string()),
-    endedAt: types.optional(types.string()),
+    id: z.optional(z.string()),
+    name: z.optional(z.string()),
+    version: z.optional(z.string()),
+    startedAt: z.optional(z.string()),
+    endedAt: z.optional(z.string()),
   });
 
 export function slimJourneyFromJSON(

package/src/models/slim-module-step-error.ts

@@ -0,0 +1,99 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export const SlimModuleStepErrorLocation = {
+  Path: "Path",
+  Authorization: "Authorization",
+  Header: "Header",
+  QueryString: "Query String",
+  Request: "Request",
+  Body: "Body",
+  Service: "Service",
+  Flow: "Flow",
+} as const;
+export type SlimModuleStepErrorLocation = OpenEnum<
+  typeof SlimModuleStepErrorLocation
+>;
+
+export type Cause = {
+  /**
+   * The module's own error code, as emitted (e.g. `5012`, `BD10003`). Present only when the module emitted a structured code; look it up in the module or GBG Errors Catalog documentation.
+   */
+  code?: string | undefined;
+  /**
+   * The upstream service's trace id for the failed request (e.g. SIP's `gbg-correlation-id`), taken from the same error as `code`.
+   */
+  correlationId?: string | undefined;
+  /**
+   * The module the failed step ran. On an interaction fetch, which carries no step history, `cause` has only `moduleId`/`variantId`; the module code and correlation id are on the state fetch.
+   */
+  moduleId?: string | undefined;
+  /**
+   * The module variant (configuration) the step ran.
+   */
+  variantId?: string | undefined;
+};
+
+export type SlimModuleStepError = {
+  code: string;
+  name: string;
+  problem: string;
+  action: string;
+  location?: SlimModuleStepErrorLocation | undefined;
+  cause?: Cause | undefined;
+};
+
+/** @internal */
+export const SlimModuleStepErrorLocation$inboundSchema: z.ZodMiniType<
+  SlimModuleStepErrorLocation,
+  unknown
+> = openEnums.inboundSchema(SlimModuleStepErrorLocation);
+
+/** @internal */
+export const Cause$inboundSchema: z.ZodMiniType<Cause, unknown> = z.object({
+  code: z.optional(z.string()),
+  correlationId: z.optional(z.string()),
+  moduleId: z.optional(z.string()),
+  variantId: z.optional(z.string()),
+});
+
+export function causeFromJSON(
+  jsonString: string,
+): SafeParseResult<Cause, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Cause$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Cause' from JSON`,
+  );
+}
+
+/** @internal */
+export const SlimModuleStepError$inboundSchema: z.ZodMiniType<
+  SlimModuleStepError,
+  unknown
+> = z.object({
+  code: z.string(),
+  name: z.string(),
+  problem: z.string(),
+  action: z.string(),
+  location: z.optional(SlimModuleStepErrorLocation$inboundSchema),
+  cause: z.optional(z.lazy(() => Cause$inboundSchema)),
+});
+
+export function slimModuleStepErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<SlimModuleStepError, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SlimModuleStepError$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SlimModuleStepError' from JSON`,
+  );
+}

package/src/models/slim-result.ts

@@ -7,16 +7,18 @@ import { safeParse } from "../lib/schemas.js";
 import * as openEnums from "../types/enums.js";
 import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
-import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
-import { GbgError, GbgError$inboundSchema } from "./gbg-error.js";
+import {
+  SlimModuleStepError,
+  SlimModuleStepError$inboundSchema,
+} from "./slim-module-step-error.js";
 import {
   SlimVerifiedData,
   SlimVerifiedData$inboundSchema,
 } from "./slim-verified-data.js";
 
 /**
- * Headline result state, and the AUTHORITATIVE signal for whether the journey succeeded. `complete` means the journey finished. `error` means it ended in failure: either a module reported a terminal error, or the platform abandoned the journey before it could finish (a deadlock, an interaction or execution timeout, or a spin). Abandonment is reported as `error` rather than as a distinct value. `pending` is reported for a running journey once its state has materialized. `timeout` is part of this range but is not currently emitted at journey level — an elapsed deadline surfaces as `error`. When `status` disagrees with `outcome` or `outcomeClassification`, `status` wins: a journey can pass an evaluation and then fail before finishing, leaving a positive classification beside `status: "error"`. Both are true — the evaluation did pass — but the journey did not complete, so do not read a positive classification as success. Note also that an `error` caused by abandonment is generally NOT retryable — a deadlocked journey deadlocks again — even though the accompanying error advises a retry; start a new journey instead.
+ * Headline result state, and the AUTHORITATIVE signal for whether the journey succeeded. `complete` means the journey finished. A `complete` journey may still list `errors`: a module step failed (e.g. a data source was unavailable) and the journey continued past it, as configured (on a state fetch each failed step is also marked on `steps[]`). `error` means it ended in failure — for example a module reported a terminal error (journeys run without per-step module error handling, which includes every journey on engine 2), a module that could not be found or routed at all, a step whose output broke its declared contract, or the platform abandoning the journey before it could finish (a deadlock, an interaction or execution timeout, or a spin). Abandonment is reported as `error` rather than as a distinct value. `pending` is reported for a running journey once its state has materialized. `timeout` is part of this range but is not currently emitted at journey level — an elapsed deadline surfaces as `error`. When `status` disagrees with `outcome` or `outcomeClassification`, `status` wins: a journey can pass an evaluation and then fail before finishing, leaving a positive classification beside `status: "error"`. Both are true — the evaluation did pass — but the journey did not complete, so do not read a positive classification as success. Note also that an `error` caused by abandonment is generally NOT retryable — a deadlocked journey deadlocks again — even though the accompanying error advises a retry; start a new journey instead.
  */
 export const SlimResultStatus = {
   Pending: "pending",
@@ -25,7 +27,7 @@ export const SlimResultStatus = {
   Timeout: "timeout",
 } as const;
 /**
- * Headline result state, and the AUTHORITATIVE signal for whether the journey succeeded. `complete` means the journey finished. `error` means it ended in failure: either a module reported a terminal error, or the platform abandoned the journey before it could finish (a deadlock, an interaction or execution timeout, or a spin). Abandonment is reported as `error` rather than as a distinct value. `pending` is reported for a running journey once its state has materialized. `timeout` is part of this range but is not currently emitted at journey level — an elapsed deadline surfaces as `error`. When `status` disagrees with `outcome` or `outcomeClassification`, `status` wins: a journey can pass an evaluation and then fail before finishing, leaving a positive classification beside `status: "error"`. Both are true — the evaluation did pass — but the journey did not complete, so do not read a positive classification as success. Note also that an `error` caused by abandonment is generally NOT retryable — a deadlocked journey deadlocks again — even though the accompanying error advises a retry; start a new journey instead.
+ * Headline result state, and the AUTHORITATIVE signal for whether the journey succeeded. `complete` means the journey finished. A `complete` journey may still list `errors`: a module step failed (e.g. a data source was unavailable) and the journey continued past it, as configured (on a state fetch each failed step is also marked on `steps[]`). `error` means it ended in failure — for example a module reported a terminal error (journeys run without per-step module error handling, which includes every journey on engine 2), a module that could not be found or routed at all, a step whose output broke its declared contract, or the platform abandoning the journey before it could finish (a deadlock, an interaction or execution timeout, or a spin). Abandonment is reported as `error` rather than as a distinct value. `pending` is reported for a running journey once its state has materialized. `timeout` is part of this range but is not currently emitted at journey level — an elapsed deadline surfaces as `error`. When `status` disagrees with `outcome` or `outcomeClassification`, `status` wins: a journey can pass an evaluation and then fail before finishing, leaving a positive classification beside `status: "error"`. Both are true — the evaluation did pass — but the journey did not complete, so do not read a positive classification as success. Note also that an `error` caused by abandonment is generally NOT retryable — a deadlocked journey deadlocks again — even though the accompanying error advises a retry; start a new journey instead.
  */
 export type SlimResultStatus = OpenEnum<typeof SlimResultStatus>;
 
@@ -41,11 +43,14 @@ export type SlimResultOutcomeClassification = OpenEnum<
 export type SlimResult = {
   outcome?: string | undefined;
   /**
-   * Headline result state, and the AUTHORITATIVE signal for whether the journey succeeded. `complete` means the journey finished. `error` means it ended in failure: either a module reported a terminal error, or the platform abandoned the journey before it could finish (a deadlock, an interaction or execution timeout, or a spin). Abandonment is reported as `error` rather than as a distinct value. `pending` is reported for a running journey once its state has materialized. `timeout` is part of this range but is not currently emitted at journey level — an elapsed deadline surfaces as `error`. When `status` disagrees with `outcome` or `outcomeClassification`, `status` wins: a journey can pass an evaluation and then fail before finishing, leaving a positive classification beside `status: "error"`. Both are true — the evaluation did pass — but the journey did not complete, so do not read a positive classification as success. Note also that an `error` caused by abandonment is generally NOT retryable — a deadlocked journey deadlocks again — even though the accompanying error advises a retry; start a new journey instead.
+   * Headline result state, and the AUTHORITATIVE signal for whether the journey succeeded. `complete` means the journey finished. A `complete` journey may still list `errors`: a module step failed (e.g. a data source was unavailable) and the journey continued past it, as configured (on a state fetch each failed step is also marked on `steps[]`). `error` means it ended in failure — for example a module reported a terminal error (journeys run without per-step module error handling, which includes every journey on engine 2), a module that could not be found or routed at all, a step whose output broke its declared contract, or the platform abandoning the journey before it could finish (a deadlock, an interaction or execution timeout, or a spin). Abandonment is reported as `error` rather than as a distinct value. `pending` is reported for a running journey once its state has materialized. `timeout` is part of this range but is not currently emitted at journey level — an elapsed deadline surfaces as `error`. When `status` disagrees with `outcome` or `outcomeClassification`, `status` wins: a journey can pass an evaluation and then fail before finishing, leaving a positive classification beside `status: "error"`. Both are true — the evaluation did pass — but the journey did not complete, so do not read a positive classification as success. Note also that an `error` caused by abandonment is generally NOT retryable — a deadlocked journey deadlocks again — even though the accompanying error advises a retry; start a new journey instead.
    */
   status?: SlimResultStatus | undefined;
   outcomeClassification?: SlimResultOutcomeClassification | null | undefined;
-  errors?: Array<GbgError> | undefined;
+  /**
+   * Customer-safe errors. Failed module steps are listed as they happen, so `errors` can appear while the journey is still `pending`. For an `error`/`timeout` journey the first entry describes the journey failure. One further entry is listed per failed module step (codes 5021 step failed, 5022 step timed out, 5023 step could not be started), on a `complete` journey too, in step order. On a state fetch the failed steps carry the same entry on `steps[].error`.
+   */
+  errors?: Array<SlimModuleStepError> | undefined;
   /**
    * Verified-output slice (OQ-A). May be transiently ABSENT on a journey already reporting `status: complete`: the certified view materializes just after the completion signal, so a client reading `data` the instant it sees `complete` may need to re-poll once. Absent `data` means "not yet available", not "no verified data". (Read-after-write closure tracked in GGO-16738.)
    */
@@ -67,13 +72,13 @@ export const SlimResultOutcomeClassification$inboundSchema: z.ZodMiniType<
 /** @internal */
 export const SlimResult$inboundSchema: z.ZodMiniType<SlimResult, unknown> = z
   .object({
-    outcome: types.optional(types.string()),
-    status: types.optional(SlimResultStatus$inboundSchema),
+    outcome: z.optional(z.string()),
+    status: z.optional(SlimResultStatus$inboundSchema),
     outcomeClassification: z.optional(
       z.nullable(SlimResultOutcomeClassification$inboundSchema),
     ),
-    errors: types.optional(z.array(GbgError$inboundSchema)),
-    data: types.optional(SlimVerifiedData$inboundSchema),
+    errors: z.optional(z.array(SlimModuleStepError$inboundSchema)),
+    data: z.optional(SlimVerifiedData$inboundSchema),
   });
 
 export function slimResultFromJSON(

package/src/models/slim-state-fetch-response.ts

@@ -7,7 +7,6 @@ import { safeParse } from "../lib/schemas.js";
 import * as openEnums from "../types/enums.js";
 import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
-import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 import { SlimJourney, SlimJourney$inboundSchema } from "./slim-journey.js";
 import { SlimResult, SlimResult$inboundSchema } from "./slim-result.js";
@@ -23,6 +22,7 @@ export type SlimStateFetchResponseStatus = OpenEnum<
 >;
 
 export type SlimStateFetchResponse = {
+  view: "slim";
   instanceId: string;
   status: SlimStateFetchResponseStatus;
   journey?: SlimJourney | undefined;
@@ -41,11 +41,12 @@ export const SlimStateFetchResponse$inboundSchema: z.ZodMiniType<
   SlimStateFetchResponse,
   unknown
 > = z.object({
-  instanceId: types.string(),
+  view: z.literal("slim"),
+  instanceId: z.string(),
   status: SlimStateFetchResponseStatus$inboundSchema,
-  journey: types.optional(SlimJourney$inboundSchema),
-  steps: types.optional(z.array(SlimStep$inboundSchema)),
-  result: types.optional(SlimResult$inboundSchema),
+  journey: z.optional(SlimJourney$inboundSchema),
+  steps: z.optional(z.array(SlimStep$inboundSchema)),
+  result: z.optional(SlimResult$inboundSchema),
 });
 
 export function slimStateFetchResponseFromJSON(

package/src/models/slim-step.ts

@@ -5,10 +5,13 @@
 import * as z from "zod/v4-mini";
 import { safeParse } from "../lib/schemas.js";
 import * as openEnums from "../types/enums.js";
-import { OpenEnum } from "../types/enums.js";
+import { ClosedEnum, OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
-import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  SlimModuleStepError,
+  SlimModuleStepError$inboundSchema,
+} from "./slim-module-step-error.js";
 
 export const SlimStepOutcomeClassification = {
   Positive: "positive",
@@ -19,11 +22,27 @@ export type SlimStepOutcomeClassification = OpenEnum<
   typeof SlimStepOutcomeClassification
 >;
 
+/**
+ * Present only when this module step failed. The journey may still have continued past it.
+ */
+export const SlimStepStatus = {
+  Error: "error",
+} as const;
+/**
+ * Present only when this module step failed. The journey may still have continued past it.
+ */
+export type SlimStepStatus = ClosedEnum<typeof SlimStepStatus>;
+
 export type SlimStep = {
   nodeId: string;
   name?: string | undefined;
   outcome?: string | undefined;
   outcomeClassification?: SlimStepOutcomeClassification | null | undefined;
+  /**
+   * Present only when this module step failed. The journey may still have continued past it.
+   */
+  status?: SlimStepStatus | undefined;
+  error?: SlimModuleStepError | undefined;
 };
 
 /** @internal */
@@ -32,15 +51,22 @@ export const SlimStepOutcomeClassification$inboundSchema: z.ZodMiniType<
   unknown
 > = openEnums.inboundSchema(SlimStepOutcomeClassification);
 
+/** @internal */
+export const SlimStepStatus$inboundSchema: z.ZodMiniEnum<
+  typeof SlimStepStatus
+> = z.enum(SlimStepStatus);
+
 /** @internal */
 export const SlimStep$inboundSchema: z.ZodMiniType<SlimStep, unknown> = z
   .object({
-    nodeId: types.string(),
-    name: types.optional(types.string()),
-    outcome: types.optional(types.string()),
+    nodeId: z.string(),
+    name: z.optional(z.string()),
+    outcome: z.optional(z.string()),
     outcomeClassification: z.optional(
       z.nullable(SlimStepOutcomeClassification$inboundSchema),
     ),
+    status: z.optional(SlimStepStatus$inboundSchema),
+    error: z.optional(SlimModuleStepError$inboundSchema),
   });
 
 export function slimStepFromJSON(