@powerhousedao/reactor-api 6.2.3-dev.50 → 6.2.3-dev.51

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { a as IPackagePieceSource, c as PackageManagerResult, i as IPackageManag
 import { IAnalyticsStore } from "@powerhousedao/analytics-engine-core";
 import { AnalyticsModel } from "@powerhousedao/analytics-engine-graphql";
 import { DocumentNode, GraphQLError, GraphQLResolveInfo, GraphQLScalarType, GraphQLScalarTypeConfig, GraphQLSchema } from "graphql";
-import { AttachmentRef, DocumentModelSource, IDocumentModelLoader, IDocumentModelRegistry, IDriveClient, IReactorClient, IReactorProcessorHostModuleBase, IRelationalDb, ISyncManager, InProcessReactorClientModule, ParsedDriveUrl, ProcessorFactoryBuilder as ProcessorFactoryBuilder$1, SyncScopeGate, driveIdFromUrl, parseDriveUrl } from "@powerhousedao/reactor";
+import { AttachmentRef, DocumentModelSource, IDocumentModelLoader, IDocumentModelRegistry, IDriveClient, IInspectableAttachmentStore, IInspector, IInspectorStorageHealthProvider, INSPECTOR_OPS, IReactorClient, IReactorFactsSink, IReactorProcessorHostModuleBase, IRelationalDb, ISyncInspector, ISyncManager, InProcessReactorClientModule, InProcessReactorModule, InspectorDocumentReader, InspectorReadOpKey, PagedResults, ParsedDriveUrl, ProcessorFactoryBuilder as ProcessorFactoryBuilder$1, Remote, SYNC_INSPECTION_OPS, SearchFilter, SyncInspectionReadOpKey, SyncScopeGate, ViewFilter, driveIdFromUrl, parseDriveUrl } from "@powerhousedao/reactor";
 import { AuthSubject, DocumentModelGlobalState as DocumentModelGlobalState$1, DocumentModelModule, Operation, PHDocument, UpgradeManifest } from "@powerhousedao/shared/document-model";
 import { ILogger } from "document-model";
 import { GraphQLResolverMap, GraphQLSchemaModule } from "@apollo/subgraph";
@@ -12,6 +12,7 @@ import { AttachmentBuildResult, AttachmentDownloadOptions, AttachmentDownloadTar
 import { IAttachmentClient } from "@powerhousedao/reactor-attachments/client";
 import { WebSocketServer } from "ws";
 import { AuthorizerResult, IHttpScope, IRelationalDb as IRelationalDb$1, IWebhookEndpoints, IWebhookScope, NodeRouteSpec, ProcessorApp, ProcessorFactory, RouteActor, RouteAuth, RouteAuthorizer, RouteBody, RouteContext, RouteHandler, RouteMethod, RouteOptions, RouteSpec, RouteTransport, RouteUser, RouteUser as RouteUser$1, ScopedRouteHandle, WebhookEndpointInfo, WebhookField, WebhookHashAlgorithm, WebhookPolicy, WebhookReply, WebhookRequest, WebhookScheme, WebhookSignatureEncoding, WebhookSpec, WebhookVerification } from "@powerhousedao/shared/processors";
+import { AttachmentReadGate, IDocumentScopeGate } from "@powerhousedao/reactor-attachments/replication";
 import { Generated, Kysely } from "kysely";
 import { PGlite } from "@electric-sql/pglite";
 import { Knex } from "knex";
@@ -587,6 +588,8 @@ interface IWebhookStore {
   revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
   /** True when this delivery has been seen before, within the TTL. */
   seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
+  /** Drops a delivery recorded by seen(), so a retry of it is delivered. */
+  forget(token: string, key: string): Promise<void>;
 }
 /** Opaque and unguessable: the URL is a bearer capability held by a third party. */
 export declare function newWebhookToken(): string;
@@ -600,6 +603,7 @@ export declare class RelationalWebhookStore implements IWebhookStore {
   find(token: string): Promise<WebhookEndpointRow | undefined>;
   list(namespace: string, endpoint?: string): Promise<WebhookEndpointRow[]>;
   revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
+  forget(token: string, key: string): Promise<void>;
   seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
 }
 /** In-memory store, for hosts with no relational database and for tests. */
@@ -608,6 +612,7 @@ export declare class MemoryWebhookStore implements IWebhookStore {
   init(): Promise<void>;
   ensure(namespace: string, endpoint: string, ownerKey: string): Promise<WebhookEndpointRow>;
   find(token: string): Promise<WebhookEndpointRow | undefined>;
+  forget(token: string, key: string): Promise<void>;
   list(namespace: string, endpoint?: string): Promise<WebhookEndpointRow[]>;
   revoke(namespace: string, endpoint: string, ownerKey: string): Promise<void>;
   seen(token: string, key: string, ttlSeconds: number): Promise<boolean>;
@@ -805,20 +810,6 @@ export interface AttachmentAccessRequest {
    */
   appKey?: string;
 }
-/** The reactor's read gate, as the attachment facade consults it. */
-export type AttachmentReadGate = Pick<IReactorClient, "isServed" | "get">;
-/**
- * Which scopes of a document a subject may read, asked by document id.
- *
- * Structural on purpose: the composition that has a policy model to enforce
- * supplies `SyncScopeGate`, and one that does not supplies nothing at all.
- */
-export interface IDocumentScopeGate {
-  scopePredicateById(documentId: string, subject: {
-    address?: string;
-    key?: string;
-  }, branch: string, signal?: AbortSignal): Promise<(scope: string) => boolean>;
-}
 export type AttachmentCallerResult = {
   kind: "admitted";
 } | {
@@ -931,6 +922,24 @@ export declare class AttachmentClientProvider implements IAttachmentClientProvid
   forSubject(subject: AuthSubject): IAttachmentClient;
 }
 //#endregion
+//#region src/graphql/inspection/source.d.ts
+/** What the inspection subgraph serves. Only reads cross GraphQL. */
+interface IReactorInspectionSource {
+  /** Reads as the host; drive and document reads are re-made as the caller. */
+  readonly inspector: IInspector;
+  readonly syncInspector: ISyncInspector | undefined;
+  readonly documentModelRegistry: IDocumentModelRegistry;
+  /** Facts the host learns after boot, e.g. a composed workflow runtime. */
+  readonly facts: IReactorFactsSink;
+}
+type ReactorInspectionOptions = {
+  /** Absent: a group-commit store's own health, else `tracked: false`. */
+  storageHealth?: IInspectorStorageHealthProvider;
+  attachmentStore?: IInspectableAttachmentStore;
+  workflows?: boolean;
+};
+export declare function createReactorInspectionSource(module: InProcessReactorModule, options?: ReactorInspectionOptions): IReactorInspectionSource;
+//#endregion
 //#region src/graphql/types.d.ts
 export type SubgraphClass = typeof BaseSubgraph;
 export type Context = {
@@ -989,6 +998,8 @@ export type SubgraphArgs = {
    * `BaseSubgraph.attachmentsFor(ctx)`.
    */
   attachments?: IAttachmentClientProvider;
+  /** Read only by `InspectionSubgraph`, registered only when this is set. */
+  inspection?: IReactorInspectionSource;
   /**
    * The host's base path, injected by the GraphQL manager when it constructs
    * a subgraph. Subgraph code may read it, but routing ignores it: every
@@ -1106,6 +1117,10 @@ export declare class BaseSubgraph implements ISubgraph$1 {
    * layer, such as a fetched document's id). Performs no slug resolution.
    */
   canReadDocument(documentId: CanonicalDocumentId, ctx: Context): Promise<boolean>;
+  /** Drops the items the host's own ACL refuses the caller. */
+  readableByHost<T extends {
+    id: string;
+  }>(items: readonly T[], ctx: Context): Promise<T[]>;
   /**
    * The principal a request decides as: the authenticated caller's address, and
    * the did:key of the app instance whose token authenticated it.
@@ -1119,6 +1134,14 @@ export declare class BaseSubgraph implements ISubgraph$1 {
   protected viewSubject(ctx: Context): AuthSubject;
   /** Whether a listing would serve the document to the caller; fails closed. */
   protected servesDocument(documentId: string, ctx: Context): Promise<boolean>;
+  /** {@link servesDocument}, but a reactor that cannot answer throws. */
+  protected servesDocumentOrThrows(identifier: string, ctx: Context, view?: Pick<ViewFilter, "branch" | "scopes">): Promise<boolean>;
+  /**
+   * Whether a listing would serve the document to the caller: the reactor read
+   * gate, then the host's legacy layer, as `findDocuments` applies them. Absent
+   * or withheld is `false`; a failure to decide throws.
+   */
+  protected listsDocument(identifier: string, ctx: Context, view?: Pick<ViewFilter, "branch" | "scopes">): Promise<boolean>;
   /**
    * Asserts read access, resolving a slug first. Returns a handle whose
    * `fetchIdentifier` the caller reuses for the data fetch; a denial throws.
@@ -1374,6 +1397,14 @@ export type HttpAdapterSetup = {
 export declare function createHttpAdapter(type: HttpAdapterType): Promise<HttpAdapterSetup>;
 //#endregion
 //#region src/graphql/gateway/drive-ownership-cache.d.ts
+/**
+ * Where drives are looked up: the raw reactor, past the read gate. Ownership
+ * is a storage fact that serves no content, so a policy that withholds a drive
+ * from the host's key must not make the host deny holding it.
+ */
+type DriveStore = {
+  find(search: SearchFilter): Promise<PagedResults<PHDocument>>;
+};
 /**
  * In-memory record of which drives this switchboard instance owns.
  *
@@ -1385,11 +1416,17 @@ export declare function createHttpAdapter(type: HttpAdapterType): Promise<HttpAd
  * 421 response.
  */
 declare class DriveOwnershipCache {
-  private readonly reactorClient;
+  private readonly store;
   private readonly drives;
-  constructor(reactorClient: IReactorClient);
+  constructor(store: DriveStore);
   init(): Promise<void>;
   has(driveId: string): boolean;
+  /**
+   * Whether this host holds the drive, asking the reactor on a miss: drives
+   * also arrive by sync and by writes that bypass the create resolvers. A
+   * positive answer is cached; a failure to ask throws.
+   */
+  holds(driveId: string): Promise<boolean>;
   add(driveId: string): void;
   remove(driveId: string): void;
   size(): number;
@@ -1426,6 +1463,12 @@ export type GraphQLManagerOptions = {
   syncServingGate?: SyncScopeGate;
   httpRoutes?: HttpRouteService;
   attachments?: IAttachmentClientProvider;
+  inspection?: IReactorInspectionSource;
+  /**
+   * Where drive ownership is looked up, past the read gate. Defaults to the
+   * reactor client, which withholds a drive the host's own key may not read.
+   */
+  driveStore?: DriveStore;
 };
 export declare function createWsAuthHandlers(opts: {
   authService?: AuthService;
@@ -1479,6 +1522,7 @@ export declare class GraphQLManager {
   private readonly syncServingGate?;
   private readonly httpRoutes?;
   private readonly attachments?;
+  private readonly inspection?;
   constructor(options: GraphQLManagerOptions);
   init(coreSubgraphs: SubgraphClass$1[], authMiddleware?: AuthFetchMiddleware, requireAuthMiddleware?: RequireAuthFetchMiddleware): Promise<void>;
   /**
@@ -1545,6 +1589,50 @@ export declare class GraphQLManager {
   shutdown(): Promise<void>;
 }
 //#endregion
+//#region src/graphql/inspection/resolvers.d.ts
+/** How the subgraph decides for one request's caller. */
+interface InspectionCallerGate {
+  /** One of the host's listed admins, whatever the policy. */
+  isOperator(ctx: Context): boolean;
+  /** The reactor client, reading as the caller. */
+  readerFor(ctx: Context): InspectorDocumentReader;
+  /** The host's own read check on one document; throws when refused. */
+  assertCanRead(identifier: string, ctx: Context): Promise<string>;
+  /** The host's own read check over a listing. */
+  readableIds(ids: readonly string[], ctx: Context): Promise<Set<string>>;
+  /** The document's id and the scopes the caller is served, or undefined. */
+  servedDocument(identifier: string, branch: string | undefined, ctx: Context): Promise<{
+    id: string;
+    scopes: ReadonlySet<string>;
+  } | undefined>;
+}
+type GqlOf<T, K extends keyof T> = T[K] extends {
+  readonly gql: infer G extends string;
+} ? G : never;
+/** Exactly the GraphQL fields of the read rows of both op tables. */
+type InspectionReadField = GqlOf<typeof INSPECTOR_OPS, InspectorReadOpKey> | GqlOf<typeof SYNC_INSPECTION_OPS, SyncInspectionReadOpKey>;
+/** The read half of the inspection surface; no lever has a field here. */
+export declare function createInspectionResolvers(source: IReactorInspectionSource, sync: {
+  list(): Remote[];
+}, gate: InspectionCallerGate): Record<string, unknown>;
+//#endregion
+//#region src/graphql/inspection/schema.d.ts
+export declare const inspectionTypeDefs: import("graphql").DocumentNode;
+//#endregion
+//#region src/graphql/inspection/subgraph.d.ts
+export declare function isListedAdmin(config: AuthorizationConfig, address: string | undefined): boolean;
+/** The read half of the reactor's inspection surface. */
+export declare class InspectionSubgraph extends BaseSubgraph {
+  name: string;
+  hasSubscriptions: boolean;
+  typeDefs: DocumentNode;
+  resolvers: Record<string, any>;
+  constructor(args: SubgraphArgs);
+  private callerGate;
+  private readerFor;
+  private servedDocument;
+}
+//#endregion
 //#region src/services/package-storage.d.ts
 export interface InstalledPackageInfo {
   name: string;
@@ -1611,6 +1699,8 @@ export type API = {
   /** The read-model relational store, for the same host-composed component:
    * its tables belong in this database and nothing else hands one over. */
   relationalDb: IRelationalDb$1;
+  /** Present when the host serves inspection; `facts` takes late-bound facts. */
+  inspection?: IReactorInspectionSource;
   /**
    * Releases resources owned by the API: shuts down the GraphQL gateway,
    * closes WebSocket and HTTP servers, destroys knex pools, and closes any
@@ -1646,6 +1736,10 @@ type CachedRegistryPackage = {
   /** Absolute entry files inside `dir`, for the entries the package serves. */
   entries: Partial<Record<PackageEntryKind, string>>;
   source: "cache" | "download";
+  /** External packages the package manifest lists, name -> version. */
+  externalDependencies: Record<string, string>;
+  /** The external packages that resolve from neither the project nor reactor-api. */
+  missingExternalDependencies: string[];
 };
 type RegistryPackageCacheOptions = {
   registryUrl: string;
@@ -1675,6 +1769,9 @@ declare class RegistryPackageCache {
   private download;
   private dependenciesOf;
   private fetchBounded;
+  private outsideUrl;
+  /** Whether `specifier` resolves from the project or from reactor-api. */
+  resolvesForCachedPackages(specifier: string, pkg: string): boolean;
   private linkBareImports;
 }
 //#endregion
@@ -1718,6 +1815,7 @@ export declare class HttpPackageLoader implements IPackageLoader {
   readonly documentModelLoader: HttpDocumentModelLoader;
   readonly cache: RegistryPackageCache;
   private readonly versions;
+  private readonly reportedExternal;
   constructor(options: HttpPackageLoaderOptions);
   /**
    * Load document models from a package in the HTTP registry.
@@ -1736,6 +1834,7 @@ export declare class HttpPackageLoader implements IPackageLoader {
     module: Record<string, unknown>;
     filePath?: string;
   }>;
+  private assertExternalDependencies;
   importDocumentModels(packageSpec: string): Promise<{
     module: Record<string, unknown>;
     filePath?: string;
@@ -2046,6 +2145,10 @@ export type ConsistencyToken = {
   readonly createdAtUtcIso: Scalars["String"]["output"];
   readonly version: Scalars["Int"]["output"];
 };
+export type CreateDefaults = {
+  readonly protocolVersions: Scalars["JSONObject"]["output"];
+  readonly signaturePolicy: Scalars["String"]["output"];
+};
 export type DeadLetterInfo = {
   readonly branch: Scalars["String"]["output"];
   readonly documentId: Scalars["String"]["output"];
@@ -2441,6 +2544,7 @@ export declare enum PropagationMode {
   Orphan = "ORPHAN"
 }
 export type Query = {
+  readonly createDefaults: CreateDefaults;
   readonly document?: Maybe<DocumentWithChildren>;
   readonly documentIncomingRelationshipEdges: DocumentRelationshipResultPage;
   readonly documentIncomingRelationships: PhDocumentResultPage;
@@ -2448,6 +2552,7 @@ export type Query = {
   readonly documentOperations: ReactorOperationResultPage;
   readonly documentOutgoingRelationshipEdges: DocumentRelationshipResultPage;
   readonly documentOutgoingRelationships: PhDocumentResultPage;
+  readonly documentServed: Scalars["Boolean"]["output"];
   /**
    * Predicts whether the calling subject would be admitted to execute each of a
    * set of candidate operations, without submitting any of them. A UI asks this to
@@ -2493,6 +2598,9 @@ export type Query = {
   readonly pollSyncEnvelopes: PollSyncEnvelopesResult;
   readonly syncHolds: ReadonlyArray<SyncHold>;
 };
+export type QueryCreateDefaultsArgs = {
+  parentIdOrSlug?: InputMaybe<Scalars["String"]["input"]>;
+};
 export type QueryDocumentArgs = {
   idOrSlug?: InputMaybe<Scalars["String"]["input"]>;
   identifier?: InputMaybe<Scalars["String"]["input"]>;
@@ -2534,6 +2642,10 @@ export type QueryDocumentOutgoingRelationshipsArgs = {
   sourceIdentifier?: InputMaybe<Scalars["String"]["input"]>;
   view?: InputMaybe<ViewFilterInput>;
 };
+export type QueryDocumentServedArgs = {
+  idOrSlug: Scalars["String"]["input"];
+  view?: InputMaybe<ViewFilterInput>;
+};
 export type QueryEvaluateActionsArgs = {
   branch?: InputMaybe<Scalars["String"]["input"]>;
   candidates: ReadonlyArray<ActionCandidateInput>;
@@ -3041,6 +3153,22 @@ export type GetJobStatusQuery = {
     };
   } | null | undefined;
 };
+export type GetDocumentServedQueryVariables = Exact<{
+  idOrSlug: Scalars["String"]["input"];
+  view?: InputMaybe<ViewFilterInput>;
+}>;
+export type GetDocumentServedQuery = {
+  readonly documentServed: boolean;
+};
+export type GetCreateDefaultsQueryVariables = Exact<{
+  parentIdOrSlug?: InputMaybe<Scalars["String"]["input"]>;
+}>;
+export type GetCreateDefaultsQuery = {
+  readonly createDefaults: {
+    readonly signaturePolicy: string;
+    readonly protocolVersions: NonNullable<unknown>;
+  };
+};
 export type EvaluateActionsQueryVariables = Exact<{
   documentIdentifier: Scalars["String"]["input"];
   branch?: InputMaybe<Scalars["String"]["input"]>;
@@ -3525,6 +3653,7 @@ export type ResolversTypes = ResolversObject<{
   ChannelMetaInput: ChannelMetaInput;
   ConsistencyCoordinate: ResolverTypeWrapper<ConsistencyCoordinate>;
   ConsistencyToken: ResolverTypeWrapper<ConsistencyToken>;
+  CreateDefaults: ResolverTypeWrapper<CreateDefaults>;
   DateTime: ResolverTypeWrapper<Scalars["DateTime"]["output"]>;
   DeadLetterInfo: ResolverTypeWrapper<DeadLetterInfo>;
   DocumentChangeContext: ResolverTypeWrapper<DocumentChangeContext>;
@@ -3600,6 +3729,7 @@ export type ResolversParentTypes = ResolversObject<{
   ChannelMetaInput: ChannelMetaInput;
   ConsistencyCoordinate: ConsistencyCoordinate;
   ConsistencyToken: ConsistencyToken;
+  CreateDefaults: CreateDefaults;
   DateTime: Scalars["DateTime"]["output"];
   DeadLetterInfo: DeadLetterInfo;
   DocumentChangeContext: DocumentChangeContext;
@@ -3699,6 +3829,10 @@ export type ConsistencyTokenResolvers<ContextType = Context, ParentType extends
   createdAtUtcIso?: Resolver<ResolversTypes["String"], ParentType, ContextType>;
   version?: Resolver<ResolversTypes["Int"], ParentType, ContextType>;
 }>;
+export type CreateDefaultsResolvers<ContextType = Context, ParentType extends ResolversParentTypes["CreateDefaults"] = ResolversParentTypes["CreateDefaults"]> = ResolversObject<{
+  protocolVersions?: Resolver<ResolversTypes["JSONObject"], ParentType, ContextType>;
+  signaturePolicy?: Resolver<ResolversTypes["String"], ParentType, ContextType>;
+}>;
 export interface DateTimeScalarConfig extends GraphQLScalarTypeConfig<ResolversTypes["DateTime"], any> {
   name: "DateTime";
 }
@@ -3855,6 +3989,7 @@ export type PollSyncEnvelopesResultResolvers<ContextType = Context, ParentType e
   peerManifestRevision?: Resolver<Maybe<ResolversTypes["String"]>, ParentType, ContextType>;
 }>;
 export type QueryResolvers<ContextType = Context, ParentType extends ResolversParentTypes["Query"] = ResolversParentTypes["Query"]> = ResolversObject<{
+  createDefaults?: Resolver<ResolversTypes["CreateDefaults"], ParentType, ContextType, Partial<QueryCreateDefaultsArgs>>;
   document?: Resolver<Maybe<ResolversTypes["DocumentWithChildren"]>, ParentType, ContextType, Partial<QueryDocumentArgs>>;
   documentIncomingRelationshipEdges?: Resolver<ResolversTypes["DocumentRelationshipResultPage"], ParentType, ContextType, Partial<QueryDocumentIncomingRelationshipEdgesArgs>>;
   documentIncomingRelationships?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, RequireFields<QueryDocumentIncomingRelationshipsArgs, "relationshipType">>;
@@ -3862,6 +3997,7 @@ export type QueryResolvers<ContextType = Context, ParentType extends ResolversPa
   documentOperations?: Resolver<ResolversTypes["ReactorOperationResultPage"], ParentType, ContextType, RequireFields<QueryDocumentOperationsArgs, "filter">>;
   documentOutgoingRelationshipEdges?: Resolver<ResolversTypes["DocumentRelationshipResultPage"], ParentType, ContextType, Partial<QueryDocumentOutgoingRelationshipEdgesArgs>>;
   documentOutgoingRelationships?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, RequireFields<QueryDocumentOutgoingRelationshipsArgs, "relationshipType">>;
+  documentServed?: Resolver<ResolversTypes["Boolean"], ParentType, ContextType, RequireFields<QueryDocumentServedArgs, "idOrSlug">>;
   evaluateActions?: Resolver<ResolversTypes["ActionEvaluations"], ParentType, ContextType, RequireFields<QueryEvaluateActionsArgs, "candidates">>;
   findDocuments?: Resolver<ResolversTypes["PHDocumentResultPage"], ParentType, ContextType, Partial<QueryFindDocumentsArgs>>;
   jobStatus?: Resolver<Maybe<ResolversTypes["JobInfo"]>, ParentType, ContextType, RequireFields<QueryJobStatusArgs, "jobId">>;
@@ -3947,6 +4083,7 @@ export type Resolvers<ContextType = Context> = ResolversObject<{
   ChannelMeta?: ChannelMetaResolvers<ContextType>;
   ConsistencyCoordinate?: ConsistencyCoordinateResolvers<ContextType>;
   ConsistencyToken?: ConsistencyTokenResolvers<ContextType>;
+  CreateDefaults?: CreateDefaultsResolvers<ContextType>;
   DateTime?: GraphQLScalarType;
   DeadLetterInfo?: DeadLetterInfoResolvers<ContextType>;
   DocumentChangeContext?: DocumentChangeContextResolvers<ContextType>;
@@ -4026,6 +4163,8 @@ export declare const GetDocumentIncomingRelationshipEdgesDocument: DocumentNode;
 export declare const FindDocumentsDocument: DocumentNode;
 export declare const GetDocumentOperationsDocument: DocumentNode;
 export declare const GetJobStatusDocument: DocumentNode;
+export declare const GetDocumentServedDocument: DocumentNode;
+export declare const GetCreateDefaultsDocument: DocumentNode;
 export declare const EvaluateActionsDocument: DocumentNode;
 export declare const CreateDocumentDocument: DocumentNode;
 export declare const CreateEmptyDocumentDocument: DocumentNode;
@@ -4057,6 +4196,8 @@ export declare function getSdk<C>(requester: Requester<C>): {
   FindDocuments(variables?: FindDocumentsQueryVariables, options?: C): Promise<FindDocumentsQuery>;
   GetDocumentOperations(variables: GetDocumentOperationsQueryVariables, options?: C): Promise<GetDocumentOperationsQuery>;
   GetJobStatus(variables: GetJobStatusQueryVariables, options?: C): Promise<GetJobStatusQuery>;
+  GetDocumentServed(variables: GetDocumentServedQueryVariables, options?: C): Promise<GetDocumentServedQuery>;
+  GetCreateDefaults(variables?: GetCreateDefaultsQueryVariables, options?: C): Promise<GetCreateDefaultsQuery>;
   EvaluateActions(variables: EvaluateActionsQueryVariables, options?: C): Promise<EvaluateActionsQuery>;
   CreateDocument(variables: CreateDocumentMutationVariables, options?: C): Promise<CreateDocumentMutation>;
   CreateEmptyDocument(variables: CreateEmptyDocumentMutationVariables, options?: C): Promise<CreateEmptyDocumentMutation>;
@@ -4134,6 +4275,13 @@ export declare function createReactorGraphQLClient(url: string, fetchImpl?: Fetc
   GetJobStatus(variables: Exact<{
     jobId: Scalars["String"]["input"];
   }>, options?: {} | undefined): Promise<GetJobStatusQuery>;
+  GetDocumentServed(variables: Exact<{
+    idOrSlug: Scalars["String"]["input"];
+    view?: InputMaybe<ViewFilterInput>;
+  }>, options?: {} | undefined): Promise<GetDocumentServedQuery>;
+  GetCreateDefaults(variables?: Exact<{
+    parentIdOrSlug?: InputMaybe<Scalars["String"]["input"]>;
+  }> | undefined, options?: {} | undefined): Promise<GetCreateDefaultsQuery>;
   EvaluateActions(variables: Exact<{
     documentIdentifier: Scalars["String"]["input"];
     branch?: InputMaybe<Scalars["String"]["input"]>;
@@ -4547,6 +4695,8 @@ type Options = {
    * or os.tmpdir() for in-memory DB deployments.
    */
   attachmentStoragePath?: string;
+  /** Storage health and workflow facts for the inspection subgraph. */
+  inspection?: ReactorInspectionOptions;
 };
 type ProcessorInitializer = ProcessorFactoryBuilder;
 /**
@@ -4678,6 +4828,6 @@ export interface DocumentModelSchemaOptions {
  */
 export declare function generateDocumentModelSchema(documentModel: DocumentModelGlobalState$1, options?: DocumentModelSchemaOptions): DocumentNode;
 //#endregion
-export { type AuthorizationConfig, type AuthorizerResult, type CanonicalDocumentId, type HttpRouteServiceOptions, type IAuthorizationService, type IHttpScope, type IPackageLoader, type IPackageLoaderOptions, type IPackagePieceSource, type IWebhookEndpoints, type IWebhookScope, type IWebhookStore, type NodeRouteSpec, type PackagePiece, type PackagePieceEntry, type PackagesSubgraphArgs, type ParsedDriveUrl, type RouteActor, type RouteAuth, type RouteAuthorizer, type RouteBody, type RouteContext, type RouteHandler, type RouteMethod, type RouteOptions, type RouteSpec, type RouteTransport, type RouteUser, type ScopedRouteHandle, type WebhookEndpointInfo, type WebhookEndpointRow, type WebhookField, type WebhookHashAlgorithm, type WebhookPolicy, type WebhookReply, type WebhookRequest, type WebhookScheme, type WebhookSignatureEncoding, type WebhookSpec, type WebhookVerification, driveIdFromUrl, parseDriveUrl };
+export { type AttachmentReadGate, type AuthorizationConfig, type AuthorizerResult, type CanonicalDocumentId, type HttpRouteServiceOptions, type IAuthorizationService, type IDocumentScopeGate, type IHttpScope, type IPackageLoader, type IPackageLoaderOptions, type IPackagePieceSource, type IReactorInspectionSource, type IWebhookEndpoints, type IWebhookScope, type IWebhookStore, type InspectionCallerGate, type InspectionReadField, type NodeRouteSpec, type PackagePiece, type PackagePieceEntry, type PackagesSubgraphArgs, type ParsedDriveUrl, type ReactorInspectionOptions, type RouteActor, type RouteAuth, type RouteAuthorizer, type RouteBody, type RouteContext, type RouteHandler, type RouteMethod, type RouteOptions, type RouteSpec, type RouteTransport, type RouteUser, type ScopedRouteHandle, type WebhookEndpointInfo, type WebhookEndpointRow, type WebhookField, type WebhookHashAlgorithm, type WebhookPolicy, type WebhookReply, type WebhookRequest, type WebhookScheme, type WebhookSignatureEncoding, type WebhookSpec, type WebhookVerification, driveIdFromUrl, parseDriveUrl };
 export {};
 //# sourceMappingURL=index.d.mts.map