@standards/schema 1.0.0-alpha.421 → 1.0.0-alpha.425

package/dist/api/index.d.mts

@@ -1,7 +1,7 @@
 
-import { AIGenerationType, AIModelPricing, AddAttributeInput, AgentAsideExchange, AgentConfig, AgentMessageAttachment, AgentSession, AgentSessionMode, AggregateGroupByInput, ArchitectChange, ArtifactQuote, ArtifactRevisionView, Attribute, AuditListOptions, BinaryResponse, CollectionContentSource, CollectionScreen, ConnectorTriggerMatch, ContentViewDefinition, CreateCustomObjectInput, CreatePermissionInput, CreateUserProfile, DecisionListParams, DocumentLayout, DownloadedFile, DraftAppendCommand, DraftFocus, DraftPublishCommand, DraftStep, DraftableState, EnvVarEntry, EnvironmentHarnessId, EnvironmentSize, FilterGenerationInput, FilterState, FormRow, FormulaGenerationInput, GeocodingAutocompleteParams, GithubTriggerSender, HttpMethod, LoginSecretEntry, MEETINGS_MAX_ONLY_CONNECTIONS, MailboxLocation, MailboxQuery, MailboxReadState, MentionEntityType, MentionReference, ModelDefinition, NativeToolGroup, OAuthAttemptView, OAuthCompleteOutcome, ObjectImage, ObjectRecord, Operation, OperationDefinition, OperationInput, OperationObjectPermission, OperationOutput, OperationParsedInput, OperationPermission, OperationResult, OperationStatus, OperationThrottle, OperationUpload, OperationWireOutput, OutputType, PageBlockData, PathParams, PreferenceEntry, PreferenceValues, ProposalRevision, PublishOutcomeCode, RecordAppearance, RecordDocuments, RecordGraphNodeRef, RecordGraphRequest, RecordOperationResult, RecordQueryDefinition, RecordScreen, RegexGenerationInput, RelationScope, RoutineAudienceSource, RoutingPrice, SchemaOwner, SchemaStateDefinition, SessionApprovalMode, SlackTriggerSender, SortGenerationInput, SortRule, StoredArtifactResult, SyncBundleInput, ToolGrantReason, ToolGroupGrant, ToolImpact, ToolPartErrorCode, ToolPartState, TriggerEventType, UpdateObjectInput, UploadedPart, UserStatus, ViewContentDefinition, ViewOperation, agentApprovalResolutionSchema, agentHealthSchema, agentRequestAnswerSchema, agentSetupResponseSchema, attachedRecordDocumentSchema, attributeSaveOutputSchema, browserProfilePreparationSchema, draftAppendOutputSchema, editAgentSessionMessageResultSchema, envVarEntrySchema, globalSearchGroupedPageSchema, loginSecretEntrySchema, meetingsOperations, meetingsQuery, meetingsQueryFields, operation, operationGroup, publishDraftOutputSchema, recordDeletionCountSchema, recordMeetingsBody, recordsBulkCreateResultSchema, recordsBulkDeleteResultSchema, recordsBulkUpdateResultSchema, resolvedRelationsBatchSchema, schemaDraftOutputSchema, setAgentSessionWorkPostureResultSchema, type, viewPreferenceAddressSchema } from "../index-DY7cHmBV.mjs";
-import { TenantId } from "../utils-qZ-SCngX.mjs";
-import { ValidationError, ValidationErrorDetail } from "../exceptions-DtcTc7fk.mjs";
+import { AIGenerationType, AIModelPricing, AddAttributeInput, AgentAsideExchange, AgentConfig, AgentMessageAttachment, AgentSession, AgentSessionMode, AggregateGroupByInput, ArchitectChange, ArtifactQuote, ArtifactRevisionView, Attribute, AuditListOptions, BinaryResponse, CollectionContentSource, CollectionScreen, ConnectorTriggerMatch, ContentViewDefinition, CreateCustomObjectInput, CreatePermissionInput, CreateUserProfile, DecisionAnswer, DecisionListParams, DocumentLayout, DownloadedFile, DraftAppendCommand, DraftFocus, DraftPublishCommand, DraftStep, DraftableState, EnvVarEntry, EnvironmentHarnessId, EnvironmentSize, FilterGenerationInput, FilterState, FormRow, FormulaGenerationInput, GeocodingAutocompleteParams, GithubTriggerSender, HttpMethod, LoginSecretEntry, MEETINGS_MAX_ONLY_CONNECTIONS, MailboxLocation, MailboxQuery, MailboxReadState, MentionEntityType, MentionReference, ModelDefinition, NativeToolGroup, OAuthAttemptView, OAuthCompleteOutcome, ObjectBuilderLike, ObjectImage, ObjectRecord, Operation, OperationDefinition, OperationInput, OperationObjectPermission, OperationOutput, OperationParsedInput, OperationPermission, OperationResult, OperationStatus, OperationThrottle, OperationUpload, OperationWireOutput, OutputType, PageBlockData, PathParams, PreferenceEntry, PreferenceValues, ProposalRevision, PublishOutcomeCode, RecordAppearance, RecordDocuments, RecordGraphNodeRef, RecordGraphRequest, RecordOperationResult, RecordQueryDefinition, RecordScreen, RegexGenerationInput, RelationScope, RoutineAudienceSource, RoutingPrice, SchemaOwner, SchemaStateDefinition, SessionApprovalMode, SlackTriggerSender, SortGenerationInput, SortRule, StoredArtifactResult, SyncBundleInput, ToolGrantReason, ToolGroupGrant, ToolImpact, ToolPartErrorCode, ToolPartState, TriggerEventType, UpdateObjectInput, UploadedPart, UserStatus, ViewContentDefinition, ViewOperation, agentApprovalResolutionSchema, agentHealthSchema, agentRequestAnswerSchema, agentSetupResponseSchema, attachedRecordDocumentSchema, attributeSaveOutputSchema, browserProfilePreparationSchema, draftAppendOutputSchema, editAgentSessionMessageResultSchema, envVarEntrySchema, globalSearchGroupedPageSchema, loginSecretEntrySchema, meetingsOperations, meetingsQuery, meetingsQueryFields, operation, operationGroup, publishDraftOutputSchema, recordDeletionCountSchema, recordMeetingsBody, recordsBulkCreateResultSchema, recordsBulkDeleteResultSchema, recordsBulkUpdateResultSchema, resolvedRelationsBatchSchema, schemaDraftOutputSchema, setAgentSessionWorkPostureResultSchema, type, viewPreferenceAddressSchema } from "../record-query-YF8WzWYV.mjs";
+import { TenantId } from "../utils-hkE18pLQ.mjs";
+import { ValidationError, ValidationErrorDetail } from "../exceptions-RLmYnywT.mjs";
 import * as z$2 from "zod";
 /**
  * A timestamp on the wire: an ISO 8601 string (`Date#toISOString()`, UTC),
@@ -91,17 +91,50 @@ export interface OperationWireRequest {
   headers: Record<string, string>;
   uploads?: readonly UploadedPart[];
 }
+/** An actor's id: a UUID, so it never collides with `"system"`. */
+export type ActorId = string;
+/**
+ * Who an in-process call acts as, when the caller names it instead of
+ * letting the ambient context decide: an actor of the tenant, or the
+ * tenant's system actor (the platform acting as itself).
+ */
+export type OperationCaller = {
+  readonly actorId: ActorId;
+} | {
+  readonly system: true;
+};
+/** `as(actor)`'s argument as the caller it names. */
+export declare function callerOf(actor: ActorId | "system"): OperationCaller;
 /**
  * What runs operations in the caller's own process: the runtime implements
  * it (`createOperationHost`), the client's in-process transport calls it.
- * `execute` runs under the caller's tenant and actor context, checks the
- * operation's permissions itself, and resolves to the answer as it goes on
- * the wire (the output schema's encoding; a `bytes` operation's
- * `BinaryResponse`). A refusal rejects with an {@link OperationRefused}.
+ * `execute` checks the operation's permissions itself and resolves to the
+ * answer as it goes on the wire (the output schema's encoding; a `bytes`
+ * operation's `BinaryResponse`). A refusal rejects with an
+ * {@link OperationRefused}.
+ *
+ * Without `caller`, the call acts as the actor the ambient context implies
+ * (the request's, the job's, the write's author), or as the system where no
+ * request, job or hook runs. With `caller`, it acts as that actor, in the
+ * ambient tenant (else the host's default one), the ambient actor recorded as
+ * the one who triggered it.
  */
 export interface OperationHost {
-  execute(op: Operation, request: OperationWireRequest): Promise<unknown>;
+  execute(op: Operation, request: OperationWireRequest, caller?: OperationCaller): Promise<unknown>;
+}
+/** What a server registers: its host, and the object builders of the bundles it declares. */
+export interface RegisteredOperationHost {
+  readonly host: OperationHost;
+  readonly objects: readonly ObjectBuilderLike[];
 }
+/**
+ * Register this process's host, so the client's default instance calls it
+ * in process. Returns the function that unregisters it (on shutdown). A
+ * second registration replaces the first.
+ */
+export declare function registerOperationHost(host: OperationHost, objects?: readonly ObjectBuilderLike[]): () => void;
+/** The host this process registered, if any. */
+export declare function registeredOperationHost(): RegisteredOperationHost | undefined;
 /**
  * A refusal as the HTTP API answers it: its status and its JSON body (the
  * `{ success: false, statusCode, message, code, … }` envelope, redacted as
@@ -1455,7 +1488,7 @@ export declare const decisionsOperations: {
           why: z$2.ZodOptional<z$2.ZodString>;
           change: z$2.ZodOptional<z$2.ZodString>;
           questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-          answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+          answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
           answeredBy: z$2.ZodOptional<z$2.ZodString>;
           effect: z$2.ZodOptional<z$2.ZodString>;
           links: z$2.ZodArray<z$2.ZodObject<{
@@ -1639,7 +1672,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -1792,7 +1825,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -1955,7 +1988,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -2125,7 +2158,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -2310,7 +2343,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -2480,7 +2513,7 @@ export declare const decisionsOperations: {
       why: z$2.ZodOptional<z$2.ZodString>;
       change: z$2.ZodOptional<z$2.ZodString>;
       questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-      answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+      answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
       answeredBy: z$2.ZodOptional<z$2.ZodString>;
       effect: z$2.ZodOptional<z$2.ZodString>;
       links: z$2.ZodArray<z$2.ZodObject<{
@@ -2546,7 +2579,7 @@ export declare const decisionsOperations: {
       why: z$2.ZodOptional<z$2.ZodString>;
       change: z$2.ZodOptional<z$2.ZodString>;
       questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-      answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+      answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
       answeredBy: z$2.ZodOptional<z$2.ZodString>;
       effect: z$2.ZodOptional<z$2.ZodString>;
       links: z$2.ZodArray<z$2.ZodObject<{
@@ -2634,7 +2667,7 @@ export declare const decisionsOperations: {
       why: z$2.ZodOptional<z$2.ZodString>;
       change: z$2.ZodOptional<z$2.ZodString>;
       questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-      answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+      answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
       answeredBy: z$2.ZodOptional<z$2.ZodString>;
       effect: z$2.ZodOptional<z$2.ZodString>;
       links: z$2.ZodArray<z$2.ZodObject<{
@@ -6168,7 +6201,12 @@ export declare const environmentEnvVarsOperations: {
     envVarId: z$2.ZodString;
   }, z$2.core.$strip>, OutputType<void>>>;
 };
-/** `GET /machines` (machines and links §6): what the viewer reads, cursor-paged. */
+/**
+ * `GET /machines` (machines and links §6): what the viewer reads, cursor-paged.
+ * `status=running` answers every running machine, unpaged; `status=stopped`
+ * the others, paged, and only it takes `q`, a search of their titles. A host
+ * with no machines answers 503 `CONFIGURATION_REQUIRED`.
+ */
 export declare const listMachinesQuery: z$2.ZodObject<{
   environmentId: z$2.ZodOptional<z$2.ZodGUID>;
   kind: z$2.ZodOptional<z$2.ZodEnum<{
@@ -6176,6 +6214,11 @@ export declare const listMachinesQuery: z$2.ZodObject<{
     conversation: "conversation";
     run: "run";
   }>>;
+  status: z$2.ZodOptional<z$2.ZodEnum<{
+    running: "running";
+    stopped: "stopped";
+  }>>;
+  q: z$2.ZodOptional<z$2.ZodString>;
   cursor: z$2.ZodOptional<z$2.ZodString>;
 }, z$2.core.$strict>;
 /** `POST /links/:id/duration`: the link expires `durationMs` from now, at most `LINK_MAX_MS`. */
@@ -6202,6 +6245,11 @@ export declare const machinesOperations: {
         conversation: "conversation";
         run: "run";
       }>>;
+      status: z$2.ZodOptional<z$2.ZodEnum<{
+        running: "running";
+        stopped: "stopped";
+      }>>;
+      q: z$2.ZodOptional<z$2.ZodString>;
       cursor: z$2.ZodOptional<z$2.ZodString>;
     }, z$2.core.$strict>;
     readonly output: z$2.ZodObject<{
@@ -24787,6 +24835,7 @@ export declare const recordsOperations: {
           readonly STATE_GATE: "SCHEMA_STATE_GATE";
           readonly ACTOR_CONTEXT_REQUIRED: "SCHEMA_ACTOR_CONTEXT_REQUIRED";
           readonly ACTOR_REQUIRED: "ACTOR_CONTEXT_REQUIRED";
+          readonly ACTOR_CONTEXT_LOST: "ACTOR_CONTEXT_LOST";
           readonly TENANT_CONFIRMATION_MISMATCH: "SCHEMA_TENANT_CONFIRMATION_MISMATCH";
           readonly SESSION_REQUIRED: "SCHEMA_SESSION_REQUIRED";
           readonly API_KEY_OWNER_ROLE_REFUSED: "SCHEMA_API_KEY_OWNER_ROLE_REFUSED";
@@ -25180,6 +25229,7 @@ export declare const recordsOperations: {
           readonly STATE_GATE: "SCHEMA_STATE_GATE";
           readonly ACTOR_CONTEXT_REQUIRED: "SCHEMA_ACTOR_CONTEXT_REQUIRED";
           readonly ACTOR_REQUIRED: "ACTOR_CONTEXT_REQUIRED";
+          readonly ACTOR_CONTEXT_LOST: "ACTOR_CONTEXT_LOST";
           readonly TENANT_CONFIRMATION_MISMATCH: "SCHEMA_TENANT_CONFIRMATION_MISMATCH";
           readonly SESSION_REQUIRED: "SCHEMA_SESSION_REQUIRED";
           readonly API_KEY_OWNER_ROLE_REFUSED: "SCHEMA_API_KEY_OWNER_ROLE_REFUSED";

package/dist/api/index.d.ts

@@ -1,8 +1,8 @@
 
-import { AIGenerationType, AIModelPricing, AddAttributeInput, AgentAsideExchange, AgentConfig, AgentMessageAttachment, AgentSession, AgentSessionMode, AggregateGroupByInput, ArchitectChange, ArtifactQuote, ArtifactRevisionView, Attribute, AuditListOptions, BinaryResponse, CollectionContentSource, CollectionScreen, ConnectorTriggerMatch, ContentViewDefinition, CreateCustomObjectInput, CreatePermissionInput, CreateUserProfile, DecisionListParams, DocumentLayout, DownloadedFile, DraftAppendCommand, DraftFocus, DraftPublishCommand, DraftStep, DraftableState, EnvVarEntry, EnvironmentHarnessId, EnvironmentSize, FilterGenerationInput, FilterState, FormRow, FormulaGenerationInput, GeocodingAutocompleteParams, GithubTriggerSender, HttpMethod, LoginSecretEntry, MEETINGS_MAX_ONLY_CONNECTIONS, MailboxLocation, MailboxQuery, MailboxReadState, MentionEntityType, MentionReference, ModelDefinition, NativeToolGroup, OAuthAttemptView, OAuthCompleteOutcome, ObjectImage, ObjectRecord, Operation, OperationDefinition, OperationInput, OperationObjectPermission, OperationOutput, OperationParsedInput, OperationPermission, OperationResult, OperationStatus, OperationThrottle, OperationUpload, OperationWireOutput, OutputType, PageBlockData, PathParams, PreferenceEntry, PreferenceValues, ProposalRevision, PublishOutcomeCode, RecordAppearance, RecordDocuments, RecordGraphNodeRef, RecordGraphRequest, RecordOperationResult, RecordQueryDefinition, RecordScreen, RegexGenerationInput, RelationScope, RoutineAudienceSource, RoutingPrice, SchemaOwner, SchemaStateDefinition, SessionApprovalMode, SlackTriggerSender, SortGenerationInput, SortRule, StoredArtifactResult, SyncBundleInput, ToolGrantReason, ToolGroupGrant, ToolImpact, ToolPartErrorCode, ToolPartState, TriggerEventType, UpdateObjectInput, UploadedPart, UserStatus, ViewContentDefinition, ViewOperation, agentApprovalResolutionSchema, agentHealthSchema, agentRequestAnswerSchema, agentSetupResponseSchema, attachedRecordDocumentSchema, attributeSaveOutputSchema, browserProfilePreparationSchema, draftAppendOutputSchema, editAgentSessionMessageResultSchema, envVarEntrySchema, globalSearchGroupedPageSchema, loginSecretEntrySchema, meetingsOperations, meetingsQuery, meetingsQueryFields, operation, operationGroup, publishDraftOutputSchema, recordDeletionCountSchema, recordMeetingsBody, recordsBulkCreateResultSchema, recordsBulkDeleteResultSchema, recordsBulkUpdateResultSchema, resolvedRelationsBatchSchema, schemaDraftOutputSchema, setAgentSessionWorkPostureResultSchema, type, viewPreferenceAddressSchema } from "../index-Ba3rZe7X.js";
+import { AIGenerationType, AIModelPricing, AddAttributeInput, AgentAsideExchange, AgentConfig, AgentMessageAttachment, AgentSession, AgentSessionMode, AggregateGroupByInput, ArchitectChange, ArtifactQuote, ArtifactRevisionView, Attribute, AuditListOptions, BinaryResponse, CollectionContentSource, CollectionScreen, ConnectorTriggerMatch, ContentViewDefinition, CreateCustomObjectInput, CreatePermissionInput, CreateUserProfile, DecisionAnswer, DecisionListParams, DocumentLayout, DownloadedFile, DraftAppendCommand, DraftFocus, DraftPublishCommand, DraftStep, DraftableState, EnvVarEntry, EnvironmentHarnessId, EnvironmentSize, FilterGenerationInput, FilterState, FormRow, FormulaGenerationInput, GeocodingAutocompleteParams, GithubTriggerSender, HttpMethod, LoginSecretEntry, MEETINGS_MAX_ONLY_CONNECTIONS, MailboxLocation, MailboxQuery, MailboxReadState, MentionEntityType, MentionReference, ModelDefinition, NativeToolGroup, OAuthAttemptView, OAuthCompleteOutcome, ObjectBuilderLike, ObjectImage, ObjectRecord, Operation, OperationDefinition, OperationInput, OperationObjectPermission, OperationOutput, OperationParsedInput, OperationPermission, OperationResult, OperationStatus, OperationThrottle, OperationUpload, OperationWireOutput, OutputType, PageBlockData, PathParams, PreferenceEntry, PreferenceValues, ProposalRevision, PublishOutcomeCode, RecordAppearance, RecordDocuments, RecordGraphNodeRef, RecordGraphRequest, RecordOperationResult, RecordQueryDefinition, RecordScreen, RegexGenerationInput, RelationScope, RoutineAudienceSource, RoutingPrice, SchemaOwner, SchemaStateDefinition, SessionApprovalMode, SlackTriggerSender, SortGenerationInput, SortRule, StoredArtifactResult, SyncBundleInput, ToolGrantReason, ToolGroupGrant, ToolImpact, ToolPartErrorCode, ToolPartState, TriggerEventType, UpdateObjectInput, UploadedPart, UserStatus, ViewContentDefinition, ViewOperation, agentApprovalResolutionSchema, agentHealthSchema, agentRequestAnswerSchema, agentSetupResponseSchema, attachedRecordDocumentSchema, attributeSaveOutputSchema, browserProfilePreparationSchema, draftAppendOutputSchema, editAgentSessionMessageResultSchema, envVarEntrySchema, globalSearchGroupedPageSchema, loginSecretEntrySchema, meetingsOperations, meetingsQuery, meetingsQueryFields, operation, operationGroup, publishDraftOutputSchema, recordDeletionCountSchema, recordMeetingsBody, recordsBulkCreateResultSchema, recordsBulkDeleteResultSchema, recordsBulkUpdateResultSchema, resolvedRelationsBatchSchema, schemaDraftOutputSchema, setAgentSessionWorkPostureResultSchema, type, viewPreferenceAddressSchema } from "../index-BT3TfqdG.js";
 import "../zod-locale.js";
-import { TenantId } from "../utils-CzDInA43.js";
-import { ValidationError, ValidationErrorDetail } from "../exceptions-EheEZJ0K.js";
+import { TenantId } from "../utils-CIqqP6hZ.js";
+import { ValidationError, ValidationErrorDetail } from "../exceptions-B29yRRaG.js";
 import * as z$2 from "zod";
 /**
  * A timestamp on the wire: an ISO 8601 string (`Date#toISOString()`, UTC),
@@ -92,17 +92,50 @@ export interface OperationWireRequest {
   headers: Record<string, string>;
   uploads?: readonly UploadedPart[];
 }
+/** An actor's id: a UUID, so it never collides with `"system"`. */
+export type ActorId = string;
+/**
+ * Who an in-process call acts as, when the caller names it instead of
+ * letting the ambient context decide: an actor of the tenant, or the
+ * tenant's system actor (the platform acting as itself).
+ */
+export type OperationCaller = {
+  readonly actorId: ActorId;
+} | {
+  readonly system: true;
+};
+/** `as(actor)`'s argument as the caller it names. */
+export declare function callerOf(actor: ActorId | "system"): OperationCaller;
 /**
  * What runs operations in the caller's own process: the runtime implements
  * it (`createOperationHost`), the client's in-process transport calls it.
- * `execute` runs under the caller's tenant and actor context, checks the
- * operation's permissions itself, and resolves to the answer as it goes on
- * the wire (the output schema's encoding; a `bytes` operation's
- * `BinaryResponse`). A refusal rejects with an {@link OperationRefused}.
+ * `execute` checks the operation's permissions itself and resolves to the
+ * answer as it goes on the wire (the output schema's encoding; a `bytes`
+ * operation's `BinaryResponse`). A refusal rejects with an
+ * {@link OperationRefused}.
+ *
+ * Without `caller`, the call acts as the actor the ambient context implies
+ * (the request's, the job's, the write's author), or as the system where no
+ * request, job or hook runs. With `caller`, it acts as that actor, in the
+ * ambient tenant (else the host's default one), the ambient actor recorded as
+ * the one who triggered it.
  */
 export interface OperationHost {
-  execute(op: Operation, request: OperationWireRequest): Promise<unknown>;
+  execute(op: Operation, request: OperationWireRequest, caller?: OperationCaller): Promise<unknown>;
+}
+/** What a server registers: its host, and the object builders of the bundles it declares. */
+export interface RegisteredOperationHost {
+  readonly host: OperationHost;
+  readonly objects: readonly ObjectBuilderLike[];
 }
+/**
+ * Register this process's host, so the client's default instance calls it
+ * in process. Returns the function that unregisters it (on shutdown). A
+ * second registration replaces the first.
+ */
+export declare function registerOperationHost(host: OperationHost, objects?: readonly ObjectBuilderLike[]): () => void;
+/** The host this process registered, if any. */
+export declare function registeredOperationHost(): RegisteredOperationHost | undefined;
 /**
  * A refusal as the HTTP API answers it: its status and its JSON body (the
  * `{ success: false, statusCode, message, code, … }` envelope, redacted as
@@ -1456,7 +1489,7 @@ export declare const decisionsOperations: {
           why: z$2.ZodOptional<z$2.ZodString>;
           change: z$2.ZodOptional<z$2.ZodString>;
           questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-          answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+          answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
           answeredBy: z$2.ZodOptional<z$2.ZodString>;
           effect: z$2.ZodOptional<z$2.ZodString>;
           links: z$2.ZodArray<z$2.ZodObject<{
@@ -1640,7 +1673,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -1793,7 +1826,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -1956,7 +1989,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -2126,7 +2159,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -2311,7 +2344,7 @@ export declare const decisionsOperations: {
         why: z$2.ZodOptional<z$2.ZodString>;
         change: z$2.ZodOptional<z$2.ZodString>;
         questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-        answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+        answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
         answeredBy: z$2.ZodOptional<z$2.ZodString>;
         effect: z$2.ZodOptional<z$2.ZodString>;
         links: z$2.ZodArray<z$2.ZodObject<{
@@ -2481,7 +2514,7 @@ export declare const decisionsOperations: {
       why: z$2.ZodOptional<z$2.ZodString>;
       change: z$2.ZodOptional<z$2.ZodString>;
       questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-      answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+      answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
       answeredBy: z$2.ZodOptional<z$2.ZodString>;
       effect: z$2.ZodOptional<z$2.ZodString>;
       links: z$2.ZodArray<z$2.ZodObject<{
@@ -2547,7 +2580,7 @@ export declare const decisionsOperations: {
       why: z$2.ZodOptional<z$2.ZodString>;
       change: z$2.ZodOptional<z$2.ZodString>;
       questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-      answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+      answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
       answeredBy: z$2.ZodOptional<z$2.ZodString>;
       effect: z$2.ZodOptional<z$2.ZodString>;
       links: z$2.ZodArray<z$2.ZodObject<{
@@ -2635,7 +2668,7 @@ export declare const decisionsOperations: {
       why: z$2.ZodOptional<z$2.ZodString>;
       change: z$2.ZodOptional<z$2.ZodString>;
       questions: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
-      answer: z$2.ZodOptional<z$2.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, z$2.core.$ZodTypeInternals<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>>>;
+      answer: z$2.ZodOptional<z$2.ZodType<DecisionAnswer, DecisionAnswer, z$2.core.$ZodTypeInternals<DecisionAnswer, DecisionAnswer>>>;
       answeredBy: z$2.ZodOptional<z$2.ZodString>;
       effect: z$2.ZodOptional<z$2.ZodString>;
       links: z$2.ZodArray<z$2.ZodObject<{
@@ -6169,7 +6202,12 @@ export declare const environmentEnvVarsOperations: {
     envVarId: z$2.ZodString;
   }, z$2.core.$strip>, OutputType<void>>>;
 };
-/** `GET /machines` (machines and links §6): what the viewer reads, cursor-paged. */
+/**
+ * `GET /machines` (machines and links §6): what the viewer reads, cursor-paged.
+ * `status=running` answers every running machine, unpaged; `status=stopped`
+ * the others, paged, and only it takes `q`, a search of their titles. A host
+ * with no machines answers 503 `CONFIGURATION_REQUIRED`.
+ */
 export declare const listMachinesQuery: z$2.ZodObject<{
   environmentId: z$2.ZodOptional<z$2.ZodGUID>;
   kind: z$2.ZodOptional<z$2.ZodEnum<{
@@ -6177,6 +6215,11 @@ export declare const listMachinesQuery: z$2.ZodObject<{
     conversation: "conversation";
     run: "run";
   }>>;
+  status: z$2.ZodOptional<z$2.ZodEnum<{
+    running: "running";
+    stopped: "stopped";
+  }>>;
+  q: z$2.ZodOptional<z$2.ZodString>;
   cursor: z$2.ZodOptional<z$2.ZodString>;
 }, z$2.core.$strict>;
 /** `POST /links/:id/duration`: the link expires `durationMs` from now, at most `LINK_MAX_MS`. */
@@ -6203,6 +6246,11 @@ export declare const machinesOperations: {
         conversation: "conversation";
         run: "run";
       }>>;
+      status: z$2.ZodOptional<z$2.ZodEnum<{
+        running: "running";
+        stopped: "stopped";
+      }>>;
+      q: z$2.ZodOptional<z$2.ZodString>;
       cursor: z$2.ZodOptional<z$2.ZodString>;
     }, z$2.core.$strict>;
     readonly output: z$2.ZodObject<{
@@ -24788,6 +24836,7 @@ export declare const recordsOperations: {
           readonly STATE_GATE: "SCHEMA_STATE_GATE";
           readonly ACTOR_CONTEXT_REQUIRED: "SCHEMA_ACTOR_CONTEXT_REQUIRED";
           readonly ACTOR_REQUIRED: "ACTOR_CONTEXT_REQUIRED";
+          readonly ACTOR_CONTEXT_LOST: "ACTOR_CONTEXT_LOST";
           readonly TENANT_CONFIRMATION_MISMATCH: "SCHEMA_TENANT_CONFIRMATION_MISMATCH";
           readonly SESSION_REQUIRED: "SCHEMA_SESSION_REQUIRED";
           readonly API_KEY_OWNER_ROLE_REFUSED: "SCHEMA_API_KEY_OWNER_ROLE_REFUSED";
@@ -25181,6 +25230,7 @@ export declare const recordsOperations: {
           readonly STATE_GATE: "SCHEMA_STATE_GATE";
           readonly ACTOR_CONTEXT_REQUIRED: "SCHEMA_ACTOR_CONTEXT_REQUIRED";
           readonly ACTOR_REQUIRED: "ACTOR_CONTEXT_REQUIRED";
+          readonly ACTOR_CONTEXT_LOST: "ACTOR_CONTEXT_LOST";
           readonly TENANT_CONFIRMATION_MISMATCH: "SCHEMA_TENANT_CONFIRMATION_MISMATCH";
           readonly SESSION_REQUIRED: "SCHEMA_SESSION_REQUIRED";
           readonly API_KEY_OWNER_ROLE_REFUSED: "SCHEMA_API_KEY_OWNER_ROLE_REFUSED";