@crowdedkingdoms/crowdyjs 8.11.0 → 8.13.0

package/dist/generated/graphql.d.ts

@@ -2334,6 +2334,8 @@ export type GmAutomationRun = {
     errorMessage: Maybe<Scalars['String']['output']>;
     /** When the run finished. */
     finishedAt: Maybe<Scalars['DateTime']['output']>;
+    /** Flow correlation id: shared with gm event-log rows and compute module runs triggered by the same entry call (player invoke / automation run / computeInvoke). */
+    flowId: Maybe<Scalars['String']['output']>;
     /** Number of fn: user-function calls across invocations. */
     fnCalls: Scalars['Int']['output'];
     /** Evaluation gas consumed across invocations. */
@@ -2437,6 +2439,26 @@ export type GmContainer = {
     /** The container type name. */
     typeName: Scalars['String']['output'];
 };
+/** One container-change notification from gameModelContainerChanged. Metadata only (no property values): clients pull the visibility-filtered state with gameModelContainerState on receipt. Delivery is post-commit and best-effort, like model-driven notifications. */
+export type GmContainerChange = {
+    __typename?: 'GmContainerChange';
+    /** The app (tenant). */
+    appId: Scalars['BigInt']['output'];
+    /** The property keys the change touched (empty for created/deleted; clamped to 32 keys). */
+    changedKeys: Array<Scalars['String']['output']>;
+    /** The container that changed. */
+    containerId: Scalars['String']['output'];
+    /** For source='function': the function that mutated it. */
+    functionName: Maybe<Scalars['String']['output']>;
+    /** When the change committed. */
+    occurredAt: Scalars['DateTime']['output'];
+    /** The session scope of the change, when any. */
+    sessionId: Maybe<Scalars['String']['output']>;
+    /** What changed it: 'function' (invoke mutation), 'direct' (gameModelSetProperty), 'created', or 'deleted'. */
+    source: Scalars['String']['output'];
+    /** The container type (null if the type is unknown). */
+    typeName: Maybe<Scalars['String']['output']>;
+};
 /** A container plus its property values filtered to what the requesting caller is allowed to see. */
 export type GmContainerState = {
     __typename?: 'GmContainerState';
@@ -2502,6 +2524,8 @@ export type GmEvent = {
     eventId: Scalars['String']['output'];
     /** When the invocation executed. */
     executedAt: Scalars['DateTime']['output'];
+    /** Flow correlation id: shared with automation runs and compute module runs caused by the same entry call (player invoke / automation run / computeInvoke), so cross-engine flows can be stitched together. */
+    flowId: Maybe<Scalars['String']['output']>;
     /** The function that was invoked. */
     functionName: Scalars['String']['output'];
     /** JSON array of applied mutations. */
@@ -2527,6 +2551,18 @@ export type GmEventEdge = {
     /** The node at the end of this edge. */
     node: GmEvent;
 };
+/** The stitched cross-engine timeline for one flow correlation id: every model event, automation run, and compute module run that shares the flow_id minted at the entry edge (player invoke / automation run / computeInvoke). Each array is ordered by time ascending, so the three together read as one causal diagnostics trace (e.g. mob kill -> compute event -> reward grant). */
+export type GmFlowTimeline = {
+    __typename?: 'GmFlowTimeline';
+    /** Automation (autonomous process) runs in the flow, ordered by startedAt ascending. */
+    automationRuns: Array<GmAutomationRun>;
+    /** Model function-invocation events (gm_event_log rows) in the flow, ordered by executedAt ascending. */
+    events: Array<GmEvent>;
+    /** The flow correlation id (UUID) this timeline was built for. */
+    flowId: Scalars['String']['output'];
+    /** Compute module runs in the flow, ordered by startedAt ascending. */
+    moduleRuns: Array<WasmModuleRun>;
+};
 /** A studio-defined function: a named, sandboxed behavior over containers (parameters, declared mutations, optional return, and an authority invoke policy). */
 export type GmFunction = {
     __typename?: 'GmFunction';
@@ -4596,6 +4632,8 @@ export type Query = {
     gameModelEventsConnection: GameModelEventsConnection;
     /** List the feature keys defined for an app. Requires app-admin ('manage_apps'). */
     gameModelFeatures: Array<GmAppFeature>;
+    /** Diagnostics surface: stitch one flow correlation id into a single cross-engine timeline — the model events (gm event log), automation runs, and compute module runs that share the flowId minted at the entry edge (player gameModelInvoke / automation run / computeInvoke) and propagated across model_invoke, the event bus, and emit_compute_event. Each array is ordered by time ascending; an unknown flowId returns three empty arrays. Answers "what happened to this kill's reward" in one query instead of three hand-joined ones. Requires app-admin ('manage_apps'). */
+    gameModelFlow: GmFlowTimeline;
     /** Fetch one studio-defined function by name. Requires app-admin ('manage_apps'). */
     gameModelFunction: GmFunction;
     /** List studio-defined functions for an app, optionally filtered to those attached to a container type. Requires app-admin ('manage_apps'). */
@@ -5057,6 +5095,10 @@ export type QueryGameModelEventsConnectionArgs = {
 export type QueryGameModelFeaturesArgs = {
     appId: Scalars['BigInt']['input'];
 };
+export type QueryGameModelFlowArgs = {
+    appId: Scalars['BigInt']['input'];
+    flowId: Scalars['String']['input'];
+};
 export type QueryGameModelFunctionArgs = {
     appId: Scalars['BigInt']['input'];
     name: Scalars['String']['input'];
@@ -5893,9 +5935,16 @@ export type SocialLoginStartInput = {
 };
 export type Subscription = {
     __typename?: 'Subscription';
+    /** Push notification whenever a container in the app changes: an invoke mutated it, a direct gameModelSetProperty wrote it, or it was created/deleted. Metadata only (containerId, typeName, changedKeys — no property values); pull the visibility-filtered state with gameModelContainerState on receipt. Post-commit and best-effort (a dropped event costs one missed pull, never correctness) — durable reads remain the source of truth. Optional typeName/sessionId filters narrow delivery. Fans out across all API replicas. Requires a valid token. Replaces interval polling with pull-on-push. */
+    gameModelContainerChanged: GmContainerChange;
     /** Realtime downlink from the game server: spatial notifications and responses, GenericErrorResponse (errors from your sends, correlated by sequenceNumber), and RealtimeConnectionEvent (lifecycle/setup failures). Requires a bearer game token AND an appId-scoped connection — the appId is read from the graphql-transport-ws connection (game tokens are app-agnostic and one UDP socket is shared across apps, so an app-agnostic subscription is rejected with a RealtimeConnectionEvent code APP_ID_REQUIRED, and a missing/invalid token with AUTH_REQUIRED). On subscribe, opens a UDP proxy session if none exists (binds to the least-loaded game server); open/transport failures are delivered as RealtimeConnectionEvent (code UDP_PROXY_CONNECTION_FAILED) and then the stream ends. Only this app’s spatial fan-out is delivered; appId-less control frames always pass. Subscribe before/while sending so async results are not missed. Unsubscribing stops delivery only — it does NOT close the UDP session; call disconnectUdpProxy (or rely on the server inactivity timeout) to release it. */
     udpNotifications: Maybe<UdpNotification>;
 };
+export type SubscriptionGameModelContainerChangedArgs = {
+    appId: Scalars['BigInt']['input'];
+    sessionId?: InputMaybe<Scalars['String']['input']>;
+    typeName?: InputMaybe<Scalars['String']['input']>;
+};
 export type TeleportRequestInput = {
     /** App (game) to teleport within. Must be greater than 0 (a non-positive value yields errorCode INVALID_APP_ID). BigInt sent as a decimal string. */
     appId: Scalars['BigInt']['input'];
@@ -6276,6 +6325,8 @@ export type UpsertComputeTriggerInput = {
     appId: Scalars['BigInt']['input'];
     /** Event filter: only this container type. */
     containerTypeName?: InputMaybe<Scalars['String']['input']>;
+    /** For invoke triggers: optional typed contract (JSON): {"params": {name: {type, required?, description?}}, "result": {...}, "description"?}. Types: int|float|string|bool|object|array. Declared params are validated on computeInvoke BEFORE the sandbox runs (required presence + type; undeclared params pass through); result is documentation/codegen only. Null = no validation. */
+    contractJson?: InputMaybe<Scalars['String']['input']>;
     /** Debounce/coalesce window in ms for event triggers. */
     debounceMs?: InputMaybe<Scalars['Int']['input']>;
     /** Event filter: only compute events with this name (on_event=compute_event). */
@@ -6886,6 +6937,8 @@ export type WasmModuleRun = {
     entry: Maybe<Scalars['String']['output']>;
     /** Error message when the run failed (trap, fuel, watchdog). */
     errorMessage: Maybe<Scalars['String']['output']>;
+    /** Flow correlation id: shared with gm event-log rows and automation runs caused by the same entry call (computeInvoke / automation run / player invoke); ticks mint their own. */
+    flowId: Maybe<Scalars['String']['output']>;
     /** Fuel consumed by the run. */
     fuelUsed: Scalars['BigInt']['output'];
     /** The module that ran. */
@@ -6908,6 +6961,8 @@ export type WasmModuleTrigger = {
     appId: Scalars['BigInt']['output'];
     /** Event filter: only this container type. */
     containerTypeName: Maybe<Scalars['String']['output']>;
+    /** For invoke triggers: the typed contract (JSON: params/result field maps with int|float|string|bool|object|array types). The platform validates computeInvoke params against it pre-sandbox; client codegen reads it for typed wrappers. Null = undeclared. */
+    contractJson: Maybe<Scalars['String']['output']>;
     /** When the trigger was created. */
     createdAt: Scalars['DateTime']['output'];
     /** Debounce/coalesce window in ms. */
@@ -8558,6 +8613,7 @@ export type ComputeTriggerFieldsFragment = {
     debounceMs: number;
     exportName: string | null;
     invokePolicyJson: string | null;
+    contractJson: string | null;
     createdAt: string;
 };
 export type ComputePolicyFieldsFragment = {
@@ -8580,6 +8636,7 @@ export type ComputeRunFieldsFragment = {
     __typename?: 'WasmModuleRun';
     runId: string;
     appId: string;
+    flowId: string | null;
     moduleId: string;
     moduleName: string;
     triggerSource: string;
@@ -8690,6 +8747,7 @@ export type ComputeUpsertTriggerMutation = {
         debounceMs: number;
         exportName: string | null;
         invokePolicyJson: string | null;
+        contractJson: string | null;
         createdAt: string;
     };
 };
@@ -8828,6 +8886,7 @@ export type ComputeModuleTriggersQuery = {
         debounceMs: number;
         exportName: string | null;
         invokePolicyJson: string | null;
+        contractJson: string | null;
         createdAt: string;
     }>;
 };
@@ -8866,6 +8925,7 @@ export type ComputeModuleRunsQuery = {
         __typename?: 'WasmModuleRun';
         runId: string;
         appId: string;
+        flowId: string | null;
         moduleId: string;
         moduleName: string;
         triggerSource: string;
@@ -9952,6 +10012,7 @@ export type GmAutomationRunFieldsFragment = {
     __typename?: 'GmAutomationRun';
     runId: string;
     appId: string;
+    flowId: string | null;
     automationId: string;
     automationName: string;
     triggerSource: string;
@@ -10115,6 +10176,7 @@ export type GameModelRunAutomationMutation = {
         __typename?: 'GmAutomationRun';
         runId: string;
         appId: string;
+        flowId: string | null;
         automationId: string;
         automationName: string;
         triggerSource: string;
@@ -10266,6 +10328,7 @@ export type GameModelAutomationRunsQuery = {
         __typename?: 'GmAutomationRun';
         runId: string;
         appId: string;
+        flowId: string | null;
         automationId: string;
         automationName: string;
         triggerSource: string;
@@ -10547,6 +10610,25 @@ export type GameModelContainersQuery = {
         metadataJson: string;
     }>;
 };
+export type GameModelContainerChangedSubscriptionVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+    typeName?: InputMaybe<Scalars['String']['input']>;
+    sessionId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type GameModelContainerChangedSubscription = {
+    __typename?: 'Subscription';
+    gameModelContainerChanged: {
+        __typename?: 'GmContainerChange';
+        appId: string;
+        containerId: string;
+        typeName: string | null;
+        sessionId: string | null;
+        source: string;
+        functionName: string | null;
+        changedKeys: Array<string>;
+        occurredAt: string;
+    };
+};
 export type GameModelContainerStateQueryVariables = Exact<{
     appId: Scalars['BigInt']['input'];
     containerId: Scalars['String']['input'];
@@ -10644,6 +10726,7 @@ export type GameModelEventsQuery = {
     gameModelEvents: Array<{
         __typename?: 'GmEvent';
         eventId: string;
+        flowId: string | null;
         sessionId: string | null;
         functionName: string;
         selfContainerId: string | null;
@@ -10679,6 +10762,7 @@ export type GameModelEventsConnectionQuery = {
             node: {
                 __typename?: 'GmEvent';
                 eventId: string;
+                flowId: string | null;
                 sessionId: string | null;
                 functionName: string;
                 selfContainerId: string | null;
@@ -10703,6 +10787,78 @@ export type GameModelEventsConnectionQuery = {
         };
     };
 };
+export type GameModelFlowQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+    flowId: Scalars['String']['input'];
+}>;
+export type GameModelFlowQuery = {
+    __typename?: 'Query';
+    gameModelFlow: {
+        __typename?: 'GmFlowTimeline';
+        flowId: string;
+        events: Array<{
+            __typename?: 'GmEvent';
+            eventId: string;
+            flowId: string | null;
+            sessionId: string | null;
+            functionName: string;
+            selfContainerId: string | null;
+            callerUserId: string | null;
+            callerKind: string;
+            automationId: string | null;
+            paramsJson: string;
+            mutationsAppliedJson: string;
+            permissionEffectsAppliedJson: string;
+            returnValueJson: string | null;
+            success: boolean;
+            errorMessage: string | null;
+            executedAt: string;
+        }>;
+        automationRuns: Array<{
+            __typename?: 'GmAutomationRun';
+            runId: string;
+            appId: string;
+            flowId: string | null;
+            automationId: string;
+            automationName: string;
+            triggerSource: string;
+            parentRunId: string | null;
+            cascadeDepth: number;
+            startedAt: string;
+            finishedAt: string | null;
+            durationUs: number;
+            targets: number;
+            invocations: number;
+            mutations: number;
+            fnCalls: number;
+            gasUsed: number;
+            success: boolean;
+            errorMessage: string | null;
+            circuitAction: string | null;
+            computeUnits: number;
+        }>;
+        moduleRuns: Array<{
+            __typename?: 'WasmModuleRun';
+            runId: string;
+            appId: string;
+            flowId: string | null;
+            moduleId: string;
+            moduleName: string;
+            triggerSource: string;
+            entry: string | null;
+            startedAt: string;
+            durationUs: number;
+            fuelUsed: string;
+            dbReads: number;
+            dbWrites: number;
+            egressMsgs: number;
+            egressBytes: string;
+            success: boolean;
+            errorMessage: string | null;
+            circuitAction: string | null;
+        }>;
+    };
+};
 export type GmFunctionFieldsFragment = {
     __typename?: 'GmFunction';
     functionId: string;
@@ -13520,12 +13676,14 @@ export declare const GameModelDeleteEdgeDocument: DocumentNode<GameModelDeleteEd
 export declare const GameModelInvokeDocument: DocumentNode<GameModelInvokeMutation, GameModelInvokeMutationVariables>;
 export declare const GameModelContainerDocument: DocumentNode<GameModelContainerQuery, GameModelContainerQueryVariables>;
 export declare const GameModelContainersDocument: DocumentNode<GameModelContainersQuery, GameModelContainersQueryVariables>;
+export declare const GameModelContainerChangedDocument: DocumentNode<GameModelContainerChangedSubscription, GameModelContainerChangedSubscriptionVariables>;
 export declare const GameModelContainerStateDocument: DocumentNode<GameModelContainerStateQuery, GameModelContainerStateQueryVariables>;
 export declare const GameModelTraverseDocument: DocumentNode<GameModelTraverseQuery, GameModelTraverseQueryVariables>;
 export declare const GameModelSessionDocument: DocumentNode<GameModelSessionQuery, GameModelSessionQueryVariables>;
 export declare const GameModelSessionsDocument: DocumentNode<GameModelSessionsQuery, GameModelSessionsQueryVariables>;
 export declare const GameModelEventsDocument: DocumentNode<GameModelEventsQuery, GameModelEventsQueryVariables>;
 export declare const GameModelEventsConnectionDocument: DocumentNode<GameModelEventsConnectionQuery, GameModelEventsConnectionQueryVariables>;
+export declare const GameModelFlowDocument: DocumentNode<GameModelFlowQuery, GameModelFlowQueryVariables>;
 export declare const GameModelSeedDocument: DocumentNode<GameModelSeedMutation, GameModelSeedMutationVariables>;
 export declare const GameModelUpsertContainerTypeDocument: DocumentNode<GameModelUpsertContainerTypeMutation, GameModelUpsertContainerTypeMutationVariables>;
 export declare const GameModelUpsertPropertyDefDocument: DocumentNode<GameModelUpsertPropertyDefMutation, GameModelUpsertPropertyDefMutationVariables>;