@crowdedkingdoms/crowdyjs 8.10.0 → 8.12.0

package/dist/generated/graphql.d.ts

@@ -2228,12 +2228,18 @@ export type GmAppPolicy = {
 /** An autonomous process (automation / NPC): a server-driven entry-point function bound to a trigger (schedule or model activity) plus a safety budget and circuit-breaker state. */
 export type GmAutomation = {
     __typename?: 'GmAutomation';
+    /** Action kind: model_function (invoke a Model function) or compute_invoke (invoke a compute-module export). */
+    actionKind: Scalars['String']['output'];
     /** The app (tenant) that owns the automation. */
     appId: Scalars['BigInt']['output'];
     /** Unique automation id (UUID). */
     automationId: Scalars['String']['output'];
     /** Circuit-breaker state: closed | open | half_open. */
     circuitState: Scalars['String']['output'];
+    /** For action_kind=compute_invoke: the module invoke export called. */
+    computeExport: Maybe<Scalars['String']['output']>;
+    /** For action_kind=compute_invoke: the compute module name invoked. */
+    computeModuleName: Maybe<Scalars['String']['output']>;
     /** Current consecutive-failure count. */
     consecutiveFailures: Scalars['Int']['output'];
     /** Cooldown (ms) while the circuit is open. */
@@ -2246,8 +2252,8 @@ export type GmAutomation = {
     enabled: Scalars['Boolean']['output'];
     /** Consecutive failures that trip the circuit breaker. */
     failureThreshold: Scalars['Int']['output'];
-    /** The entry-point function name (must be autonomous_invocable). */
-    functionName: Scalars['String']['output'];
+    /** The entry-point function name (must be autonomous_invocable). Null for compute_invoke actions. */
+    functionName: Maybe<Scalars['String']['output']>;
     /** Override: evaluation gas per invoke. */
     gasLimit: Maybe<Scalars['Int']['output']>;
     /** Interval in ms (schedule_kind=interval). */
@@ -2431,6 +2437,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';
@@ -2663,6 +2689,15 @@ export type GmPropertyDef = {
     /** Who may write the property: function | owner | admin. */
     writable: Scalars['String']['output'];
 };
+/** One property predicate for filtered container lists (the same shape automation selectors use): compare a property value against a JSON literal. Missing properties fall back to the type default. */
+export type GmPropertyPredicateInput = {
+    /** Property key to compare. */
+    key: Scalars['String']['input'];
+    /** Comparison operator: '==', '!=', '<', '>', '<=' or '>='. */
+    op: Scalars['String']['input'];
+    /** JSON-encoded comparison value (e.g. '"enemy"', 'true', '10'). */
+    valueJson: Scalars['String']['input'];
+};
 /** Summary of what a gameModelSeed call created. */
 export type GmSeedResult = {
     __typename?: 'GmSeedResult';
@@ -4573,7 +4608,7 @@ export type Query = {
     gameModelContainerState: GmContainerState;
     /** List all container types defined for an app. Requires app-admin ('manage_apps'). */
     gameModelContainerTypes: Array<GmContainerType>;
-    /** List containers in an app, optionally filtered by container type and/or session. Requires a valid token. */
+    /** List containers in an app, optionally filtered by container type and/or session, by property predicates (`where`, requires typeName; the same predicate shape automation selectors use — missing properties fall back to the type default), and paged with offset/limit over the stable created-at ordering. Requires a valid token. */
     gameModelContainers: Array<GmContainer>;
     /** Query the function-invocation event log (audit trail) with optional filters and pagination. Useful for debugging functions or showing recent activity. Requires a valid token. */
     gameModelEvents: Array<GmEvent>;
@@ -5015,8 +5050,11 @@ export type QueryGameModelContainerTypesArgs = {
 };
 export type QueryGameModelContainersArgs = {
     appId: Scalars['BigInt']['input'];
+    limit?: InputMaybe<Scalars['Int']['input']>;
+    offset?: InputMaybe<Scalars['Int']['input']>;
     sessionId?: InputMaybe<Scalars['String']['input']>;
     typeName?: InputMaybe<Scalars['String']['input']>;
+    where?: InputMaybe<Array<GmPropertyPredicateInput>>;
 };
 export type QueryGameModelEventsArgs = {
     appId: Scalars['BigInt']['input'];
@@ -5875,9 +5913,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'];
@@ -6171,8 +6216,14 @@ export type UpdateVoxelInput = {
 };
 /** Create or update an autonomous process (automation / NPC). Upsert key is (app, name). */
 export type UpsertAutomationInput = {
+    /** Action kind: model_function (default — invoke a Model function) or compute_invoke (invoke a compute-module export directly; the trusted server path, no invoke policy evaluation). */
+    actionKind?: InputMaybe<Scalars['String']['input']>;
     /** The app (tenant) that owns the automation. */
     appId: Scalars['BigInt']['input'];
+    /** For action_kind=compute_invoke: the module invoke export to call (must be bound as an invoke trigger on the module). */
+    computeExport?: InputMaybe<Scalars['String']['input']>;
+    /** For action_kind=compute_invoke: the compute module name to invoke. */
+    computeModuleName?: InputMaybe<Scalars['String']['input']>;
     /** Cooldown (ms) while the circuit is open. */
     cooldownMs?: InputMaybe<Scalars['Int']['input']>;
     /** Cron expression (schedule_kind=cron). */
@@ -6183,8 +6234,8 @@ export type UpsertAutomationInput = {
     enabled?: InputMaybe<Scalars['Boolean']['input']>;
     /** Consecutive failures that open the circuit. */
     failureThreshold?: InputMaybe<Scalars['Int']['input']>;
-    /** Entry-point function name (must be autonomous_invocable). */
-    functionName: Scalars['String']['input'];
+    /** Entry-point function name (must be autonomous_invocable). Required for action_kind=model_function; ignored for compute_invoke. */
+    functionName?: InputMaybe<Scalars['String']['input']>;
     /** Override: gas per invoke. */
     gasLimit?: InputMaybe<Scalars['Int']['input']>;
     /** Interval in ms (schedule_kind=interval). */
@@ -6211,7 +6262,7 @@ export type UpsertAutomationInput = {
     selfContainerId?: InputMaybe<Scalars['String']['input']>;
     /** Optional session scope (UUID). */
     sessionId?: InputMaybe<Scalars['String']['input']>;
-    /** Target mode: container | type | global. Defaults to container. */
+    /** Target mode: container | type | global. Defaults to container (model_function) / global (compute_invoke). */
     targetMode?: InputMaybe<Scalars['String']['input']>;
     /** For target_mode=type: the container type to fan out over. */
     targetTypeName?: InputMaybe<Scalars['String']['input']>;
@@ -6252,6 +6303,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). */
@@ -6884,6 +6937,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. */
@@ -8534,6 +8589,7 @@ export type ComputeTriggerFieldsFragment = {
     debounceMs: number;
     exportName: string | null;
     invokePolicyJson: string | null;
+    contractJson: string | null;
     createdAt: string;
 };
 export type ComputePolicyFieldsFragment = {
@@ -8666,6 +8722,7 @@ export type ComputeUpsertTriggerMutation = {
         debounceMs: number;
         exportName: string | null;
         invokePolicyJson: string | null;
+        contractJson: string | null;
         createdAt: string;
     };
 };
@@ -8804,6 +8861,7 @@ export type ComputeModuleTriggersQuery = {
         debounceMs: number;
         exportName: string | null;
         invokePolicyJson: string | null;
+        contractJson: string | null;
         createdAt: string;
     }>;
 };
@@ -9874,7 +9932,10 @@ export type GmAutomationFieldsFragment = {
     name: string;
     description: string | null;
     enabled: boolean;
-    functionName: string;
+    actionKind: string;
+    functionName: string | null;
+    computeModuleName: string | null;
+    computeExport: string | null;
     targetMode: string;
     selfContainerId: string | null;
     targetTypeName: string | null;
@@ -9955,7 +10016,10 @@ export type GameModelUpsertAutomationMutation = {
         name: string;
         description: string | null;
         enabled: boolean;
-        functionName: string;
+        actionKind: string;
+        functionName: string | null;
+        computeModuleName: string | null;
+        computeExport: string | null;
         targetMode: string;
         selfContainerId: string | null;
         targetTypeName: string | null;
@@ -10004,7 +10068,10 @@ export type GameModelSetAutomationEnabledMutation = {
         name: string;
         description: string | null;
         enabled: boolean;
-        functionName: string;
+        actionKind: string;
+        functionName: string | null;
+        computeModuleName: string | null;
+        computeExport: string | null;
         targetMode: string;
         selfContainerId: string | null;
         targetTypeName: string | null;
@@ -10113,7 +10180,10 @@ export type GameModelAutomationsQuery = {
         name: string;
         description: string | null;
         enabled: boolean;
-        functionName: string;
+        actionKind: string;
+        functionName: string | null;
+        computeModuleName: string | null;
+        computeExport: string | null;
         targetMode: string;
         selfContainerId: string | null;
         targetTypeName: string | null;
@@ -10153,7 +10223,10 @@ export type GameModelAutomationQuery = {
         name: string;
         description: string | null;
         enabled: boolean;
-        functionName: string;
+        actionKind: string;
+        functionName: string | null;
+        computeModuleName: string | null;
+        computeExport: string | null;
         targetMode: string;
         selfContainerId: string | null;
         targetTypeName: string | null;
@@ -10490,6 +10563,9 @@ export type GameModelContainersQueryVariables = Exact<{
     appId: Scalars['BigInt']['input'];
     typeName?: InputMaybe<Scalars['String']['input']>;
     sessionId?: InputMaybe<Scalars['String']['input']>;
+    where?: InputMaybe<Array<GmPropertyPredicateInput> | GmPropertyPredicateInput>;
+    limit?: InputMaybe<Scalars['Int']['input']>;
+    offset?: InputMaybe<Scalars['Int']['input']>;
 }>;
 export type GameModelContainersQuery = {
     __typename?: 'Query';
@@ -10505,6 +10581,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'];
@@ -13478,6 +13573,7 @@ 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>;