@oomol-lab/open-flow 0.1.0-beta.79 → 0.1.0-beta.80

package/dist/common/flow-state.js

@@ -5733,6 +5733,7 @@ var stateQuerySchema = strictObject({
 	scope: _enum(["draft", "live"]),
 	values: literal(false).optional()
 });
+var stateSummaryQuerySchema = stateQuerySchema.omit({ values: true });
 var stateReadSchema = strictObject({
 	scope: _enum(["draft", "live"]),
 	keys: array(keySchema).min(1).max(stateReadLimits.maxKeys).refine((keys) => new Set(keys).size === keys.length, "State keys must be distinct.")
@@ -5745,6 +5746,7 @@ var dedupeClearSchema = strictObject({
 	scope: _enum(["draft", "live"]),
 	space: string().regex(/^(flow|node:.+)$/)
 });
+var dedupeClearAllSchema = strictObject({ scope: _enum(["draft", "live"]) });
 var skipDuplicatesConfigSchema = strictObject({ fields: array(string().refine((field) => field.length > 0 && field.split(".").every((part) => part.length > 0), "Use a nonempty dot-separated field path.")).refine((fields) => new Set(fields).size === fields.length, "Identity fields must be distinct.").default([]) });
 var skipDuplicatesExecutorSchema = skipDuplicatesConfigSchema.extend({ kind: literal("skip-duplicates") });
 function skipDuplicatesTask(config = skipDuplicatesConfigSchema.parse({}), name = "Skip Duplicates") {
@@ -5822,6 +5824,10 @@ var flowStateViewSchema = object({
 		updatedAt: number()
 	}))
 });
+var flowStateSummarySchema = flowStateViewSchema.extend({ values: strictObject({
+	count: number().int().nonnegative(),
+	updatedAt: number().nullable()
+}) });
 var flowStateValuesSchema = object({
 	version: literal(1),
 	scope: _enum(["draft", "live"]),
@@ -5834,4 +5840,4 @@ var flowStateValuesSchema = object({
 	return response.values.reduce((bytes, item) => bytes + (item.value === null ? 0 : encoder.encode(JSON.stringify(item.value)).byteLength), 0) <= stateReadLimits.maxBytes;
 }, "State values exceed the 1 MiB read limit.");
 //#endregion
-export { StateError, dedupeClearSchema, dedupeIdentities, flowStateValuesSchema, flowStateViewSchema, hashIdentities, skipDuplicatesConfigSchema, skipDuplicatesExecutorSchema, skipDuplicatesIdentities, skipDuplicatesTask, stateClearSchema, stateConformanceCases, stateKey, stateQuerySchema, stateReadLimits, stateReadSchema };
+export { StateError, dedupeClearAllSchema, dedupeClearSchema, dedupeIdentities, flowStateSummarySchema, flowStateValuesSchema, flowStateViewSchema, hashIdentities, skipDuplicatesConfigSchema, skipDuplicatesExecutorSchema, skipDuplicatesIdentities, skipDuplicatesTask, stateClearSchema, stateConformanceCases, stateKey, stateQuerySchema, stateReadLimits, stateReadSchema, stateSummaryQuerySchema };

package/dist/common/mcp.js

@@ -8857,6 +8857,7 @@ var stateQuerySchema = strictObject({
 	scope: _enum(["draft", "live"]),
 	values: literal(false).optional()
 });
+stateQuerySchema.omit({ values: true });
 var stateReadSchema = strictObject({
 	scope: _enum(["draft", "live"]),
 	keys: array(keySchema).min(1).max(stateReadLimits.maxKeys).refine((keys) => new Set(keys).size === keys.length, "State keys must be distinct.")
@@ -8869,6 +8870,7 @@ var dedupeClearSchema = strictObject({
 	scope: _enum(["draft", "live"]),
 	space: string$1().regex(/^(flow|node:.+)$/)
 });
+strictObject({ scope: _enum(["draft", "live"]) });
 var skipDuplicatesConfigSchema = strictObject({ fields: array(string$1().refine((field) => field.length > 0 && field.split(".").every((part) => part.length > 0), "Use a nonempty dot-separated field path.")).refine((fields) => new Set(fields).size === fields.length, "Identity fields must be distinct.").default([]) });
 var skipDuplicatesExecutorSchema = skipDuplicatesConfigSchema.extend({ kind: literal("skip-duplicates") });
 var flowStateViewSchema = object({
@@ -8894,6 +8896,10 @@ var flowStateViewSchema = object({
 		updatedAt: number()
 	}))
 });
+var flowStateSummarySchema = flowStateViewSchema.extend({ values: strictObject({
+	count: number().int().nonnegative(),
+	updatedAt: number().nullable()
+}) });
 var flowStateValuesSchema = object({
 	version: literal(1),
 	scope: _enum(["draft", "live"]),
@@ -10795,7 +10801,7 @@ function leinaBots(value) {
 }
 function accessPermissions(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"actionIds",
 		"allActions",
 		"triggerIds",
@@ -10833,19 +10839,15 @@ function accessBinding(value, candidate) {
 	const legacy = Object.hasOwn(source, "displayName") && !Object.hasOwn(source, "connectionDisplayName");
 	const permissions = candidate && Object.hasOwn(source, "permissions") ? accessPermissions(source.permissions) : void 0;
 	const permissionGroupName = source.permissionGroupName;
-	exact(source, [
+	requiredFields(source, [
 		"accessBindingId",
 		"connectionId",
 		"source",
 		legacy ? "displayName" : "connectionDisplayName",
-		...candidate && Object.hasOwn(source, "isDefault") ? ["isDefault"] : [],
-		...candidate && permissions != null ? ["permissions"] : [],
-		...Object.hasOwn(source, "permissionGroupName") ? ["permissionGroupName"] : [],
-		...policyRevision == null ? [] : ["policyRevision"],
 		"providerId",
 		...candidate ? [] : ["status"]
 	]);
-	if (policyRevision != null && typeof policyRevision != "string") return invalidResponse("policyRevision: expected a string.");
+	if (policyRevision !== void 0 && typeof policyRevision != "string") return invalidResponse("policyRevision: expected a string.");
 	if (candidate && isDefault !== void 0 && typeof isDefault != "boolean") return invalidResponse("isDefault: expected a boolean.");
 	if (permissionGroupName !== void 0 && permissionGroupName !== null && typeof permissionGroupName != "string") return invalidResponse("permissionGroupName: expected a string or null.");
 	if (!candidate && status != "active" && status != "forbidden" && status != "invalid" && status != "missing") return invalidResponse();
@@ -10874,13 +10876,11 @@ function accessMode(value) {
 }
 function connectorAccess(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"accessRevision",
 		"bindings",
 		"mode",
 		"sharedAccessDigest",
-		..."providerIds" in source ? ["providerIds"] : [],
-		..."discardedBindingCount" in source ? ["discardedBindingCount"] : [],
 		"version"
 	]);
 	const accessRevision = integer(source.accessRevision);
@@ -10921,13 +10921,12 @@ function accessGrants(value) {
 	if (!Array.isArray(value)) return invalidResponse();
 	const bindings = value.map((candidate) => {
 		const entry = record(candidate);
-		exact(entry, [
+		requiredFields(entry, [
 			"accessBindingId",
 			"connectionId",
 			"providerId",
 			"source",
-			"connectionDisplayName",
-			..."permissionGroupName" in entry ? ["permissionGroupName"] : []
+			"connectionDisplayName"
 		]);
 		let identity;
 		try {
@@ -10950,7 +10949,7 @@ function accessGrants(value) {
 }
 function connectorAccessSnapshot(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"mode",
 		"sharedAccessDigest",
 		"sharedBindings",
@@ -10972,7 +10971,7 @@ function connectorAccessSnapshot(value) {
 }
 function connectorAccessCandidates(value, providerId) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"candidates",
 		"mode",
 		"providerId",
@@ -10993,7 +10992,7 @@ function connectorAccessCandidates(value, providerId) {
 }
 function connectorAccessCandidatesBatch(value, providerIds) {
 	const source = record(value);
-	exact(source, ["results", "version"]);
+	requiredFields(source, ["results", "version"]);
 	if (source.version != 1) return invalidResponse("version: expected 1.");
 	if (!Array.isArray(source.results)) return invalidResponse("results: expected an array.");
 	const remaining = new Set(providerIds);
@@ -11002,9 +11001,9 @@ function connectorAccessCandidatesBatch(value, providerIds) {
 		const providerId = string(item.providerId);
 		if (!remaining.delete(providerId)) return invalidResponse("results[].providerId: duplicate or unrequested provider.");
 		if (!Object.hasOwn(item, "error")) return connectorAccessCandidates(item, providerId);
-		exact(item, ["providerId", "error"]);
+		requiredFields(item, ["providerId", "error"]);
 		const error = record(item.error);
-		exact(error, ["code", "message"]);
+		requiredFields(error, ["code", "message"]);
 		return {
 			providerId,
 			error: {
@@ -11640,6 +11639,25 @@ function draft(value) {
 		return invalidResponse();
 	}
 }
+function revisionTriggers(value) {
+	const source = record(value);
+	const graph = record(record(record(source.content).document).graph);
+	const triggers = Object.entries(record(graph.nodes)).flatMap(([triggerId, entry]) => {
+		const node = record(entry);
+		if (node.kind == "outputs" || Object.hasOwn(node, "inputs")) return [];
+		const kind = string(node.kind);
+		if (node.name !== void 0 && typeof node.name != "string") return invalidResponse();
+		return [{
+			triggerId: string(triggerId),
+			kind,
+			...node.name === void 0 ? {} : { name: node.name }
+		}];
+	});
+	return {
+		...revisionMetadata(source),
+		triggers
+	};
+}
 function presentation(value) {
 	const source = record(value);
 	if (source.version != 1 || integer(source.revision) < 1) return invalidResponse();
@@ -12385,6 +12403,10 @@ var ControlClient = class {
 		const result = flowStateViewSchema.safeParse(await this.request(`/v1/flows/${segment(flowId)}/state?scope=${scope}`));
 		return result.success && result.data.scope === scope ? result.data : invalidResponse();
 	}
+	async getFlowStateSummary(flowId, scope, signal) {
+		const result = flowStateSummarySchema.safeParse(await this.request(`/v1/flows/${segment(flowId)}/state/summary?scope=${scope}`, { signal }));
+		return result.success && result.data.scope === scope ? result.data : invalidResponse();
+	}
 	async getFlowStateValues(flowId, scope, keys, signal) {
 		const result = flowStateValuesSchema.safeParse(await this.request(`/v1/flows/${segment(flowId)}/state/read`, {
 			method: "POST",
@@ -12405,6 +12427,10 @@ var ControlClient = class {
 		const source = record(await this.request(`/v1/flows/${segment(flowId)}/dedupe?scope=${scope}&space=${encodeURIComponent(space)}`, { method: "DELETE" }));
 		if (source.version !== 1 || source.cleared !== true) invalidResponse();
 	}
+	async clearAllFlowDedupe(flowId, scope) {
+		const source = record(await this.request(`/v1/flows/${segment(flowId)}/dedupe/all?scope=${scope}`, { method: "DELETE" }));
+		if (source.version !== 1 || source.cleared !== true) invalidResponse();
+	}
 	async renameFlow(flowId, name) {
 		return this.updateFlow(flowId, { name });
 	}
@@ -12517,6 +12543,11 @@ var ControlClient = class {
 	async getRevision(flowId, revisionId, signal) {
 		return draft(await this.request(`/v1/flows/${segment(flowId)}/revisions/${segment(revisionId)}`, { signal }));
 	}
+	async getRevisionTriggers(flowId, revisionId, signal) {
+		const revision = revisionTriggers(await this.request(`/v1/flows/${segment(flowId)}/revisions/${segment(revisionId)}`, { signal }));
+		if (revision.flowId != flowId || revision.revisionId != revisionId) return invalidResponse();
+		return revision;
+	}
 	async listTriggerConfigOptions(flowId, nodeId, field, signal) {
 		const source = record(await this.request(`/v1/flows/${segment(flowId)}/triggers/${segment(nodeId)}/options/${segment(field)}`, { signal }));
 		requiredFields(source, ["options", "version"]);

package/dist/common/scheduler.js

@@ -9545,7 +9545,7 @@ var keySchema = string$1().min(1).refine((value) => new TextEncoder().encode(val
 strictObject({
 	scope: _enum(["draft", "live"]),
 	values: literal(false).optional()
-});
+}).omit({ values: true });
 strictObject({
 	scope: _enum(["draft", "live"]),
 	keys: array(keySchema).min(1).max(stateReadLimits.maxKeys).refine((keys) => new Set(keys).size === keys.length, "State keys must be distinct.")
@@ -9558,6 +9558,7 @@ strictObject({
 	scope: _enum(["draft", "live"]),
 	space: string$1().regex(/^(flow|node:.+)$/)
 });
+strictObject({ scope: _enum(["draft", "live"]) });
 var skipDuplicatesExecutorSchema = strictObject({ fields: array(string$1().refine((field) => field.length > 0 && field.split(".").every((part) => part.length > 0), "Use a nonempty dot-separated field path.")).refine((fields) => new Set(fields).size === fields.length, "Identity fields must be distinct.").default([]) }).extend({ kind: literal("skip-duplicates") });
 object({
 	version: literal(1),
@@ -9581,7 +9582,10 @@ object({
 		reservedCount: number().nonnegative(),
 		updatedAt: number()
 	}))
-});
+}).extend({ values: strictObject({
+	count: number().int().nonnegative(),
+	updatedAt: number().nullable()
+}) });
 object({
 	version: literal(1),
 	scope: _enum(["draft", "live"]),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oomol-lab/open-flow",
-  "version": "0.1.0-beta.79",
+  "version": "0.1.0-beta.80",
   "description": "TypeScript contracts and Browser runtime for Open Flow.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {

package/src/control/common/api.ts

@@ -1,8 +1,8 @@
 import type { CanvasCommand } from '../../canvas/common/commands.ts'
-import type { FlowStateValues, FlowStateView, StateScope } from '../../state/common/state.ts'
+import type { FlowStateSummary, FlowStateValues, FlowStateView, StateScope } from '../../state/common/state.ts'
 
 import { currentEngineContract } from '../../runtime/common/engineContract.ts'
-import { flowStateValuesSchema, flowStateViewSchema } from '../../state/common/state.ts'
+import { flowStateSummarySchema, flowStateValuesSchema, flowStateViewSchema } from '../../state/common/state.ts'
 import { workflowContractSchema, workflowReferencesSchema } from '../../workflow/common/workflow.ts'
 export type { CanvasCommand, CanvasCommandSubscriber } from '../../canvas/common/commands.ts'
 import type { LiveDetails } from './liveDetails.ts'
@@ -68,7 +68,7 @@ import { allConnectorConnectionsQuery, connectorActionQuery, connectorConnection
 import { requiredFields, integer, invalidResponse, jsonValue, record, string } from './decoding.ts'
 import { errorListener, flow, flowPage, variable, variableListItem, variableReferences } from './flowDecoders.ts'
 import { live, publication, publicationPage, publishOperation } from './publicationDecoders.ts'
-import { draft, draftChange, draftSync, presentation } from './revisionDecoders.ts'
+import { draft, draftChange, draftSync, presentation, revisionTriggers } from './revisionDecoders.ts'
 import { runCancellation, runDetails, runPage, runResult, waitResolution } from './runDecoders.ts'
 import { pollTriggerTestResult, triggerActivityPage, triggerBinding, triggerBindingDetail, triggerKey, triggerKeySummary } from './triggerDecoders.ts'
 
@@ -968,7 +968,7 @@ export class ControlClient {
     )
   }
 
-  async broadcastCanvas(flowId: string, command: CanvasCommand): Promise<CanvasBroadcast> {
+  async broadcastCanvas(flowId: string, command: CanvasCommand | Readonly<Record<string, unknown>>): Promise<CanvasBroadcast> {
     const source = record(
       await this.request(`/v1/flows/${segment(flowId)}/canvas`, {
         method: 'POST',
@@ -1022,6 +1022,11 @@ export class ControlClient {
     return result.success && result.data.scope === scope ? result.data : invalidResponse()
   }
 
+  async getFlowStateSummary(flowId: string, scope: StateScope, signal?: AbortSignal): Promise<FlowStateSummary> {
+    const result = flowStateSummarySchema.safeParse(await this.request(`/v1/flows/${segment(flowId)}/state/summary?scope=${scope}`, { signal }))
+    return result.success && result.data.scope === scope ? result.data : invalidResponse()
+  }
+
   async getFlowStateValues(flowId: string, scope: StateScope, keys: readonly string[], signal?: AbortSignal): Promise<FlowStateValues> {
     const result = flowStateValuesSchema.safeParse(
       await this.request(`/v1/flows/${segment(flowId)}/state/read`, { method: 'POST', body: JSON.stringify({ version: 1, scope, keys }), signal }),
@@ -1046,6 +1051,11 @@ export class ControlClient {
     if (source.version !== 1 || source.cleared !== true) invalidResponse()
   }
 
+  async clearAllFlowDedupe(flowId: string, scope: StateScope): Promise<void> {
+    const source = record(await this.request(`/v1/flows/${segment(flowId)}/dedupe/all?scope=${scope}`, { method: 'DELETE' }))
+    if (source.version !== 1 || source.cleared !== true) invalidResponse()
+  }
+
   async renameFlow(flowId: string, name: string): Promise<Flow> {
     return this.updateFlow(flowId, { name })
   }
@@ -1168,6 +1178,12 @@ export class ControlClient {
     return draft(await this.request(`/v1/flows/${segment(flowId)}/revisions/${segment(revisionId)}`, { signal }))
   }
 
+  async getRevisionTriggers(flowId: string, revisionId: string, signal?: AbortSignal) {
+    const revision = revisionTriggers(await this.request(`/v1/flows/${segment(flowId)}/revisions/${segment(revisionId)}`, { signal }))
+    if (revision.flowId != flowId || revision.revisionId != revisionId) return invalidResponse()
+    return revision
+  }
+
   async listTriggerConfigOptions(flowId: string, nodeId: string, field: string, signal?: AbortSignal): Promise<readonly TriggerConfigOption[]> {
     const source = record(await this.request(`/v1/flows/${segment(flowId)}/triggers/${segment(nodeId)}/options/${segment(field)}`, { signal }))
     requiredFields(source, ['options', 'version'])
@@ -1315,19 +1331,19 @@ export class ControlClient {
     }
   }
 
-  async readAuthoring(flowId: string, query: AuthoringRead = {}) {
+  async readAuthoring(flowId: string, query: AuthoringRead | Readonly<Record<string, unknown>> = {}) {
     return authoringReadResponse.parse(await this.request(`/v1/flows/${segment(flowId)}/authoring/read`, { method: 'POST', body: JSON.stringify(query) }))
   }
 
-  async searchAuthoring(flowId: string, query: AuthoringSearch) {
+  async searchAuthoring(flowId: string, query: AuthoringSearch | Readonly<Record<string, unknown>>) {
     return authoringSearchResponse.parse(await this.request(`/v1/flows/${segment(flowId)}/authoring/search`, { method: 'POST', body: JSON.stringify(query) }))
   }
 
-  async authoringSchema(flowId: string, query: { type?: AuthoringType; action?: string }) {
+  async authoringSchema(flowId: string, query: { type?: AuthoringType; action?: string } | Readonly<Record<string, unknown>>) {
     return record(await this.request(`/v1/flows/${segment(flowId)}/authoring/schema`, { method: 'POST', body: JSON.stringify(query) }))
   }
 
-  async editAuthoring(flowId: string, request: AuthoringRequest) {
+  async editAuthoring(flowId: string, request: AuthoringRequest | { readonly requestId: string; readonly [key: string]: unknown }) {
     return authoringEditResponse.parse(
       await this.request(`/v1/flows/${segment(flowId)}/authoring/edit`, {
         method: 'POST',

package/src/control/common/connectorDecoders.ts

@@ -15,7 +15,7 @@ import type {
 } from './api.ts'
 
 import { providerIconAppearance } from '../../connector/common/providerIconSprite.ts'
-import { exact, requiredFields, integer, invalidResponse, jsonValue, record, string } from './decoding.ts'
+import { requiredFields, integer, invalidResponse, jsonValue, record, string } from './decoding.ts'
 import { ApiError } from './errors.ts'
 import { parseProviderAccessSource } from './providerAccess.ts'
 
@@ -33,7 +33,7 @@ export function leinaBots(value: unknown): readonly LeinaBot[] {
 
 function accessPermissions(value: unknown): NonNullable<ProviderAccessBindingCandidate['permissions']> {
   const source = record(value)
-  exact(source, ['actionIds', 'allActions', 'triggerIds', 'allTriggers', 'configured', 'proxy'])
+  requiredFields(source, ['actionIds', 'allActions', 'triggerIds', 'allTriggers', 'configured', 'proxy'])
   if (!Array.isArray(source.actionIds)) return invalidResponse('permissions.actionIds: expected an array.')
   if (!Array.isArray(source.triggerIds)) return invalidResponse('permissions.triggerIds: expected an array.')
   if (typeof source.allActions != 'boolean') return invalidResponse('permissions.allActions: expected a boolean.')
@@ -62,19 +62,15 @@ function accessBinding(value: unknown, candidate: boolean): ProviderAccessBindin
   const legacy = Object.hasOwn(source, 'displayName') && !Object.hasOwn(source, 'connectionDisplayName')
   const permissions = candidate && Object.hasOwn(source, 'permissions') ? accessPermissions(source.permissions) : undefined
   const permissionGroupName = source.permissionGroupName
-  exact(source, [
+  requiredFields(source, [
     'accessBindingId',
     'connectionId',
     'source',
     legacy ? 'displayName' : 'connectionDisplayName',
-    ...(candidate && Object.hasOwn(source, 'isDefault') ? ['isDefault'] : []),
-    ...(candidate && permissions != null ? ['permissions'] : []),
-    ...(Object.hasOwn(source, 'permissionGroupName') ? ['permissionGroupName'] : []),
-    ...(policyRevision == null ? [] : ['policyRevision']),
     'providerId',
     ...(candidate ? [] : ['status']),
   ])
-  if (policyRevision != null && typeof policyRevision != 'string') return invalidResponse('policyRevision: expected a string.')
+  if (policyRevision !== undefined && typeof policyRevision != 'string') return invalidResponse('policyRevision: expected a string.')
   if (candidate && isDefault !== undefined && typeof isDefault != 'boolean') return invalidResponse('isDefault: expected a boolean.')
   if (permissionGroupName !== undefined && permissionGroupName !== null && typeof permissionGroupName != 'string')
     return invalidResponse('permissionGroupName: expected a string or null.')
@@ -106,15 +102,7 @@ function accessMode(value: unknown): ConnectorAccess['mode'] {
 
 export function connectorAccess(value: unknown): ConnectorAccess {
   const source = record(value)
-  exact(source, [
-    'accessRevision',
-    'bindings',
-    'mode',
-    'sharedAccessDigest',
-    ...('providerIds' in source ? ['providerIds'] : []),
-    ...('discardedBindingCount' in source ? ['discardedBindingCount'] : []),
-    'version',
-  ])
+  requiredFields(source, ['accessRevision', 'bindings', 'mode', 'sharedAccessDigest', 'version'])
   const accessRevision = integer(source.accessRevision)
   if (source.version != 1 || accessRevision < 0 || !Array.isArray(source.bindings)) return invalidResponse()
   if ('providerIds' in source && !Array.isArray(source.providerIds)) return invalidResponse()
@@ -170,14 +158,7 @@ function accessGrants(value: unknown): readonly ConnectorAccessGrant[] {
   if (!Array.isArray(value)) return invalidResponse()
   const bindings = value.map((candidate) => {
     const entry = record(candidate)
-    exact(entry, [
-      'accessBindingId',
-      'connectionId',
-      'providerId',
-      'source',
-      'connectionDisplayName',
-      ...('permissionGroupName' in entry ? ['permissionGroupName'] : []),
-    ])
+    requiredFields(entry, ['accessBindingId', 'connectionId', 'providerId', 'source', 'connectionDisplayName'])
     let identity
     try {
       identity = parseProviderAccessSource(entry.source)
@@ -200,7 +181,7 @@ function accessGrants(value: unknown): readonly ConnectorAccessGrant[] {
 
 export function connectorAccessSnapshot(value: unknown): ConnectorAccessSnapshot {
   const source = record(value)
-  exact(source, ['mode', 'sharedAccessDigest', 'sharedBindings', 'selectedBindings', 'version'])
+  requiredFields(source, ['mode', 'sharedAccessDigest', 'sharedBindings', 'selectedBindings', 'version'])
   if (source.version != 2) return invalidResponse()
   const mode = accessMode(source.mode)
   const sharedBindings = accessGrants(source.sharedBindings)
@@ -211,7 +192,7 @@ export function connectorAccessSnapshot(value: unknown): ConnectorAccessSnapshot
 
 export function connectorAccessCandidates(value: unknown, providerId: string): ConnectorAccessCandidates {
   const source = record(value)
-  exact(source, ['candidates', 'mode', 'providerId', 'version'])
+  requiredFields(source, ['candidates', 'mode', 'providerId', 'version'])
   if (source.version != 1) return invalidResponse('version: expected 1.')
   if (string(source.providerId) != providerId) return invalidResponse('providerId: does not match the requested provider.')
   if (!Array.isArray(source.candidates)) return invalidResponse('candidates: expected an array.')
@@ -225,7 +206,7 @@ export function connectorAccessCandidates(value: unknown, providerId: string): C
 
 export function connectorAccessCandidatesBatch(value: unknown, providerIds: readonly string[]): ConnectorAccessCandidatesBatch {
   const source = record(value)
-  exact(source, ['results', 'version'])
+  requiredFields(source, ['results', 'version'])
   if (source.version != 1) return invalidResponse('version: expected 1.')
   if (!Array.isArray(source.results)) return invalidResponse('results: expected an array.')
   const remaining = new Set(providerIds)
@@ -234,9 +215,9 @@ export function connectorAccessCandidatesBatch(value: unknown, providerIds: read
     const providerId = string(item.providerId)
     if (!remaining.delete(providerId)) return invalidResponse('results[].providerId: duplicate or unrequested provider.')
     if (!Object.hasOwn(item, 'error')) return connectorAccessCandidates(item, providerId)
-    exact(item, ['providerId', 'error'])
+    requiredFields(item, ['providerId', 'error'])
     const error = record(item.error)
-    exact(error, ['code', 'message'])
+    requiredFields(error, ['code', 'message'])
     return { providerId, error: { code: string(error.code), message: string(error.message) } }
   })
   if (remaining.size != 0) return invalidResponse('results: missing requested providers.')

package/src/control/common/revisionDecoders.ts

@@ -28,6 +28,20 @@ export function draft(value: unknown): Draft {
   }
 }
 
+export function revisionTriggers(value: unknown) {
+  const source = record(value)
+  const content = record(source.content)
+  const graph = record(record(content.document).graph)
+  const triggers = Object.entries(record(graph.nodes)).flatMap(([triggerId, entry]) => {
+    const node = record(entry)
+    if (node.kind == 'outputs' || Object.hasOwn(node, 'inputs')) return []
+    const kind = string(node.kind)
+    if (node.name !== undefined && typeof node.name != 'string') return invalidResponse()
+    return [{ triggerId: string(triggerId), kind, ...(node.name === undefined ? {} : { name: node.name }) }]
+  })
+  return { ...revisionMetadata(source), triggers }
+}
+
 export function presentation(value: unknown): Presentation {
   const source = record(value)
   if (source.version != 1 || integer(source.revision) < 1) return invalidResponse()

package/src/state/common/state.ts

@@ -11,6 +11,7 @@ const keySchema = z
   .min(1)
   .refine((value) => new TextEncoder().encode(value).length <= 256)
 export const stateQuerySchema = z.strictObject({ scope: z.enum(['draft', 'live']), values: z.literal(false).optional() })
+export const stateSummaryQuerySchema = stateQuerySchema.omit({ values: true })
 export const stateReadSchema = z.strictObject({
   scope: z.enum(['draft', 'live']),
   keys: z
@@ -25,6 +26,7 @@ export const stateClearSchema = z.strictObject({
   key: keySchema.optional(),
 })
 export const dedupeClearSchema = z.strictObject({ scope: z.enum(['draft', 'live']), space: z.string().regex(/^(flow|node:.+)$/) })
+export const dedupeClearAllSchema = z.strictObject({ scope: z.enum(['draft', 'live']) })
 export type DedupeIdentity = string | number
 export const skipDuplicatesConfigSchema = z.strictObject({
   fields: z
@@ -150,6 +152,18 @@ export const flowStateViewSchema = z.object({
   ),
 })
 
+export interface FlowStateSummary {
+  readonly version: 1
+  readonly scope: StateScope
+  readonly limits: FlowStateView['limits']
+  readonly values: { readonly count: number; readonly updatedAt: number | null }
+  readonly spaces: FlowStateView['spaces']
+}
+
+export const flowStateSummarySchema = flowStateViewSchema.extend({
+  values: z.strictObject({ count: z.number().int().nonnegative(), updatedAt: z.number().nullable() }),
+})
+
 export interface FlowStateValues {
   readonly version: 1
   readonly scope: StateScope