@almadar/core 10.100.0 → 10.102.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -551,12 +551,36 @@ interface OrbitalEventResponse {
551
551
  * string (kept for backcompat) with a machine-readable shape.
552
552
  */
553
553
  rejections?: TransitionRejection[];
554
+ /**
555
+ * Names of traits DROPPED from a stateless cascade because the cross-trait
556
+ * worklist hit its safety-valve cap (G-RUNTIME-027) — the response's
557
+ * states/effects/entity rows are INCOMPLETE for these traits. Absent when
558
+ * the whole worklist ran. Surfaced so the truncation is observable
559
+ * (previously the tail of any page over ~20 traits silently never
560
+ * executed).
561
+ */
562
+ cascadeTruncated?: string[];
554
563
  error?: string;
555
564
  }
556
565
  /** Zod twin of `OrbitalEventRequest`. Third type param `object`, see `BusEventSourceSchema`. */
557
566
  declare const OrbitalEventRequestSchema: z.ZodType<OrbitalEventRequest, z.ZodTypeDef, object>;
558
567
  /** Zod twin of `OrbitalEventResponse`. Third type param `object`, see `BusEventSourceSchema`. */
559
568
  declare const OrbitalEventResponseSchema: z.ZodType<OrbitalEventResponse, z.ZodTypeDef, object>;
569
+ /**
570
+ * Where circuit state lives between events (`docs/Almadar_Runtime_Stateless_Stateful_PLAN.md` §1a):
571
+ * `'stateless'` = the client carries it on every request, `'stateful'` = the server holds it.
572
+ */
573
+ type ServerTopology = 'stateless' | 'stateful';
574
+ declare const ServerTopologySchema: z.ZodEnum<["stateless", "stateful"]>;
575
+ /** `POST /register` response. `topology` absent = a server that predates the declaration. */
576
+ interface OrbitalRegisterResponse {
577
+ success: boolean;
578
+ topology?: ServerTopology;
579
+ message?: string;
580
+ orbitals?: string[];
581
+ error?: string;
582
+ }
583
+ declare const OrbitalRegisterResponseSchema: z.ZodType<OrbitalRegisterResponse, z.ZodTypeDef, object>;
560
584
  /**
561
585
  * One persist-envelope success emit, handed to the live-broadcast sink
562
586
  * (`OrbitalServerRuntime.setLiveBroadcastSink`) and relayed to every OTHER
@@ -585,4 +609,4 @@ type EventDispatchResponse = OrbitalEventResponse;
585
609
  /** @deprecated use {@link OrbitalEventResponseSchema}. */
586
610
  declare const EventDispatchResponseSchema: z.ZodType<OrbitalEventResponse, z.ZodTypeDef, object>;
587
611
 
588
- export { ANONYMOUS_USER as A, type BusEvent as B, type ClientEffectTuple as C, DEFAULT_VIEWER as D, type EmittedEvent as E, ServerEffectResultSchema as F, type TransitionRejectionCode as G, type Unsubscribe as H, decodeDevIdentityToken as I, encodeDevIdentityToken as J, findPersonaInRoster as K, type LiveBroadcastItem as L, normalizeUserContext as M, personaFromIdentityRow as N, type OrbitalEventRequest as O, resolveDefaultViewer as P, resolvePersonaSpec as Q, type RawUserClaims as R, type ServerBatchSummary as S, type TransitionRejection as T, type UserContext as U, type OrbitalEventResponse as a, type BusEventListener as b, type BusEventSource as c, BusEventSourceSchema as d, ClientEffectTupleSchema as e, type ClientNavigateBackTuple as f, ClientNavigateBackTupleSchema as g, type ClientNavigateTuple as h, ClientNavigateTupleSchema as i, type ClientRenderUITuple as j, ClientRenderUITupleSchema as k, DEV_TOKEN_PREFIX as l, EmittedEventSchema as m, type EventDispatchRequest as n, EventDispatchRequestSchema as o, type EventDispatchResponse as p, EventDispatchResponseSchema as q, type EventEmit as r, type EventKey as s, type EventListen as t, LiveBroadcastItemSchema as u, OrbitalEventRequestSchema as v, OrbitalEventResponseSchema as w, RawUserClaimsSchema as x, ServerBatchSummarySchema as y, type ServerEffectResult as z };
612
+ export { ANONYMOUS_USER as A, type BusEvent as B, type ClientEffectTuple as C, DEFAULT_VIEWER as D, type EmittedEvent as E, ServerBatchSummarySchema as F, type ServerEffectResult as G, ServerEffectResultSchema as H, type ServerTopology as I, ServerTopologySchema as J, type TransitionRejectionCode as K, type LiveBroadcastItem as L, type Unsubscribe as M, decodeDevIdentityToken as N, type OrbitalEventRequest as O, encodeDevIdentityToken as P, findPersonaInRoster as Q, type RawUserClaims as R, type ServerBatchSummary as S, type TransitionRejection as T, type UserContext as U, normalizeUserContext as V, personaFromIdentityRow as W, resolveDefaultViewer as X, resolvePersonaSpec as Y, type OrbitalEventResponse as a, type BusEventListener as b, type BusEventSource as c, BusEventSourceSchema as d, ClientEffectTupleSchema as e, type ClientNavigateBackTuple as f, ClientNavigateBackTupleSchema as g, type ClientNavigateTuple as h, ClientNavigateTupleSchema as i, type ClientRenderUITuple as j, ClientRenderUITupleSchema as k, DEV_TOKEN_PREFIX as l, EmittedEventSchema as m, type EventDispatchRequest as n, EventDispatchRequestSchema as o, type EventDispatchResponse as p, EventDispatchResponseSchema as q, type EventEmit as r, type EventKey as s, type EventListen as t, LiveBroadcastItemSchema as u, OrbitalEventRequestSchema as v, OrbitalEventResponseSchema as w, type OrbitalRegisterResponse as x, OrbitalRegisterResponseSchema as y, RawUserClaimsSchema as z };
@@ -1,5 +1,5 @@
1
1
  import { O as OrbitalEntity } from './effect-Hm_QDaSI.js';
2
- import { O as OrbitalSchema, a as OrbitalDefinition } from './schema-TqLV2wlK.js';
2
+ import { O as OrbitalSchema, a as OrbitalDefinition } from './schema-COf9yTjs.js';
3
3
  import { S as SExpr } from './expression-DRwzVnMu.js';
4
4
 
5
5
  /**
@@ -1,7 +1,7 @@
1
- import { k as FactorySignatureCatalog, h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay, J as JsonSchema } from '../types-Ug92oza4.js';
2
- export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, l as FactorySignatureEntityField, m as FactoryTraitSignature, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-Ug92oza4.js';
1
+ import { k as FactorySignatureCatalog, h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay, J as JsonSchema } from '../types-CYOzs4As.js';
2
+ export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, l as FactorySignatureEntityField, m as FactoryTraitSignature, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-CYOzs4As.js';
3
3
  import { a as EntityPersistence, E as EntityField } from '../effect-Hm_QDaSI.js';
4
- import { a as TraitReference } from '../trait-YlNXc4H3.js';
4
+ import { a as TraitReference } from '../trait-Be3xF0px.js';
5
5
  export { J as JsonValue } from '../json-D8gmyK3l.js';
6
6
  import 'zod';
7
7
  import '../expression-DRwzVnMu.js';
@@ -1,5 +1,5 @@
1
- import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-TqLV2wlK.js';
2
- import { g as TraitConfigValue, i as CallSiteConfig, j as CallSiteConfigEntry, h as Trait } from '../trait-YlNXc4H3.js';
1
+ import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-COf9yTjs.js';
2
+ import { g as TraitConfigValue, i as CallSiteConfig, j as CallSiteConfigEntry, h as Trait } from '../trait-Be3xF0px.js';
3
3
  import { E as EntityField, a as EntityPersistence } from '../effect-Hm_QDaSI.js';
4
4
  import { MakeTraitRefOpts } from '../builders.js';
5
5
  import '../json-D8gmyK3l.js';
@@ -900,6 +900,7 @@ var EffectUseSchema = z.object({
900
900
  site: EffectSiteSchema.optional()
901
901
  });
902
902
  var EffectRowSchema = z.array(EffectUseSchema);
903
+ z.enum(["persistedAwaited", "hybridClientOnly", "runtimeOptimistic"]);
903
904
  var SourceBehaviorMetadataSchema = z.object({
904
905
  behavior: z.string().min(1),
905
906
  alias: z.string().min(1),
@@ -1798,6 +1799,15 @@ z.object({
1798
1799
  guard: z.unknown().optional()
1799
1800
  })
1800
1801
  ).optional(),
1802
+ cascadeTruncated: z.array(z.string()).optional(),
1803
+ error: z.string().optional()
1804
+ });
1805
+ var ServerTopologySchema = z.enum(["stateless", "stateful"]);
1806
+ z.object({
1807
+ success: z.boolean(),
1808
+ topology: ServerTopologySchema.optional(),
1809
+ message: z.string().optional(),
1810
+ orbitals: z.array(z.string()).optional(),
1801
1811
  error: z.string().optional()
1802
1812
  });
1803
1813
  z.object({