{ "components": { "schemas": { "Error": { "description": "Synthesized from the union of `error_set` values across every method in contract/methods.json -- the contract does not separately publish an error envelope schema.", "properties": { "code": { "description": "`ACCESS_DENIED`: The caller lacks the method's required authz_action capability. `CONFLICT`: The mutation could not be applied against the current state (e.g. a version/precondition mismatch). `IDEMPOTENCY_CONFLICT`: A replayed operation identity was reused with a different request body. `INVALID_ARGUMENT`: The request failed request-shape or parameter validation. `READ_ONLY`: The target is in a read-only state and refused a mutating method. `REDIRECTED`: This node is not authoritative for the target; retry against the returned route.", "enum": [ "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "INVALID_ARGUMENT", "READ_ONLY", "REDIRECTED" ], "type": "string" }, "message": { "type": "string" } }, "required": [ "code" ], "type": "object" }, "ReqDef_AbstainReason": { "description": "Why the engine declined to answer.", "oneOf": [ { "additionalProperties": false, "description": "A required capability no candidate covers.", "properties": { "iri": { "type": "string" }, "reason": { "const": "uncovered_capability", "type": "string" } }, "required": [ "reason", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "A declared capability IRI that is not a native term.", "properties": { "iri": { "type": "string" }, "reason": { "const": "unresolved_capability_iri", "type": "string" } }, "required": [ "reason", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "Free text no mapping resolved to a task.", "properties": { "reason": { "const": "unmapped_task", "type": "string" }, "text_digest": { "type": "string" } }, "required": [ "reason", "text_digest" ], "type": "object" }, { "additionalProperties": false, "description": "The constraints named cannot be satisfied together.", "properties": { "constraints": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64" }, "reason": { "const": "infeasible", "type": "string" } }, "required": [ "reason", "constraints" ], "type": "object" }, { "additionalProperties": false, "description": "The search budget ran out above the accepted gap.", "properties": { "incumbent": { "default": null, "type": [ "string", "null" ] }, "lower_bound": { "$ref": "#/components/schemas/ReqDef_Scalar" }, "reason": { "const": "budget_exhausted", "type": "string" } }, "required": [ "reason", "lower_bound" ], "type": "object" }, { "additionalProperties": false, "description": "A fact the objective needs is absent on a candidate.", "properties": { "component_id": { "type": "string" }, "field": { "type": "string" }, "reason": { "const": "unknown_fact", "type": "string" } }, "required": [ "reason", "component_id", "field" ], "type": "object" }, { "additionalProperties": false, "description": "An external agent without its required observation.", "properties": { "component_id": { "type": "string" }, "reason": { "const": "ineligible_external_agent", "type": "string" } }, "required": [ "reason", "component_id" ], "type": "object" }, { "additionalProperties": false, "description": "The record itself would exceed the durable record bound.", "properties": { "bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason": { "const": "record_too_large", "type": "string" } }, "required": [ "reason", "bytes" ], "type": "object" }, { "additionalProperties": false, "description": "The request tried to widen the pinned policy.", "properties": { "field": { "type": "string" }, "reason": { "const": "policy_loosening", "type": "string" } }, "required": [ "reason", "field" ], "type": "object" }, { "additionalProperties": false, "description": "Statistical: below the policy's support, coverage or risk floor. It\nnames no invisible data, by construction.", "properties": { "reason": { "const": "insufficient_confidence", "type": "string" } }, "required": [ "reason" ], "type": "object" } ] }, "ReqDef_AgentComponentContentRequest": { "additionalProperties": false, "description": "Read one component revision's bytes.", "properties": { "component_id": { "type": "string" }, "entry_revision": { "default": null, "description": "`None` reads the current published revision.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "component_id" ], "type": "object" }, "ReqDef_AgentComponentDraft": { "additionalProperties": false, "description": "Caller-supplied inputs for one component revision.", "properties": { "actor_scope": { "type": "string" }, "attributes": { "additionalProperties": { "type": "string" }, "default": {}, "description": "Extension point. New facts belong here until they earn a typed field,\nso the vocabulary can grow without a wire break.", "type": "object" }, "classification": { "default": [], "description": "Ontology terms this component is classified under -- the terms it\nPROVIDES. Matched against a task's required capabilities by\nsubsumption (`crate::agent_ontology::satisfies`), which is what makes\n\"what does an agent doing XYZ need?\" a traversal rather than a prompt.", "items": { "type": "string" }, "type": "array" }, "component_id": { "type": "string" }, "content_digest": { "description": "Pins the component's actual bytes, wherever they live. The bytes\nthemselves are deliberately not stored here.", "type": "string" }, "content_ref": { "default": null, "description": "How to fetch those bytes. `None` for a component that is fully\ndescribed by its facts (a model profile names a provider model; there\nis no artifact to fetch).", "type": [ "string", "null" ] }, "declared_capabilities": { "default": [], "description": "Capability IRIs the publisher DECLARES this component provides, as\ndistinct from the curated `classification` above. A declaration is a\nclaim and is recorded as one, so a decision that leans on it is\nclassified by that claim.", "items": { "type": "string" }, "type": "array" }, "declared_required_capabilities": { "default": [], "description": "The publisher's own statement of what it requires, kept beside the\ncurated `required_capabilities` for the same reason\n`declared_capabilities` is kept beside `classification`.", "items": { "type": "string" }, "type": "array" }, "facts": { "$ref": "#/components/schemas/ReqDef_AgentComponentFacts" }, "kind": { "$ref": "#/components/schemas/ReqDef_AgentComponentKind" }, "policy_digest": { "type": "string" }, "provenance": { "$ref": "#/components/schemas/ReqDef_ComponentProvenance", "description": "Where this component came from. See [`ComponentProvenance`]." }, "purpose_id": { "type": "string" }, "required_capabilities": { "default": [], "description": "Capability IRIs this component NEEDS from whatever it is assembled\nwith. The assembly layer's coverage question is over this list.", "items": { "type": "string" }, "type": "array" }, "requires": { "default": [], "description": "What this component needs, each pinned to an exact revision.", "items": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "type": "array" }, "source_revision": { "type": "string" }, "source_revision_digest": { "type": "string" }, "summary": { "description": "The component's own description of itself, bounded.\n\nThis is INTERFACE, not content, and the distinction is what decides\nwhether it belongs here. An MCP tool's description is what a model\nreads to decide whether to call it, so it is part of the tool's\ncontract and has to be queryable. A system prompt's *body* is content\nand stays out; only its shape (mode, budget, variables) comes in.", "type": "string" }, "tenant_id": { "type": "string" }, "version": { "type": "string" } }, "required": [ "component_id", "kind", "version", "content_digest", "facts", "provenance", "summary", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "source_revision", "source_revision_digest" ], "type": "object" }, "ReqDef_AgentComponentFacts": { "description": "Kind-specific facts an optimizer needs in order to CHOOSE a component.\n\nTyped for the kinds selection actually turns on, and\n[`AgentComponentFacts::Opaque`] for the rest. New facts go in\n`attributes` on the entry rather than as new variants, so extending the\nvocabulary does not break the wire.", "oneOf": [ { "properties": { "context_window_tokens": { "format": "uint32", "minimum": 0, "type": "integer" }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_CostFacts" }, { "type": "null" } ], "default": null }, "facts": { "const": "model_profile", "type": "string" }, "latency_declared": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_DeclaredLatency" }, { "type": "null" } ], "default": null }, "latency_observed_ref": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ObservationRef" }, { "type": "null" } ], "default": null, "description": "The evaluation that MEASURED this profile's latency, when one\nexists. A declared latency and a measured one are different claims\nand a selection that cannot tell them apart cannot say which it used." }, "max_output_tokens": { "format": "uint32", "minimum": 0, "type": "integer" }, "modalities": { "$ref": "#/components/schemas/ReqDef_ModalityFacts", "default": { "input": [], "output": [] } }, "model_identity": { "type": "string" }, "provider": { "type": "string" }, "supports_structured_output": { "type": "boolean" }, "supports_tools": { "type": "boolean" }, "supports_vision": { "type": "boolean" } }, "required": [ "facts", "provider", "model_identity", "context_window_tokens", "max_output_tokens", "supports_tools", "supports_structured_output", "supports_vision" ], "type": "object" }, { "properties": { "facts": { "const": "system_prompt", "type": "string" }, "prompt_mode": { "$ref": "#/components/schemas/ReqDef_PromptMode" }, "token_estimate": { "description": "Budgeting input: a graph's prompts have to fit its model's context.", "format": "uint32", "minimum": 0, "type": "integer" }, "variables": { "description": "Names a dynamic prompt expects to be given. Empty for a static one.", "items": { "type": "string" }, "type": "array" } }, "required": [ "facts", "prompt_mode", "token_estimate", "variables" ], "type": "object" }, { "properties": { "cost": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_CostFacts" }, { "type": "null" } ], "default": null }, "destructive_hint": { "default": null, "type": [ "boolean", "null" ] }, "effect": { "$ref": "#/components/schemas/ReqDef_ToolEffect" }, "facts": { "const": "tool", "type": "string" }, "idempotent_hint": { "default": null, "type": [ "boolean", "null" ] }, "input_schema_digest": { "default": null, "description": "`sha256:` of the served-and-serialized input schema section.", "type": [ "string", "null" ] }, "latency_declared": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_DeclaredLatency" }, { "type": "null" } ], "default": null }, "modalities": { "$ref": "#/components/schemas/ReqDef_ModalityFacts", "default": { "input": [], "output": [] } }, "open_world_hint": { "default": null, "type": [ "boolean", "null" ] }, "output_schema_digest": { "default": null, "description": "`None` means the tool declares no output schema.", "type": [ "string", "null" ] }, "read_only_hint": { "default": null, "type": [ "boolean", "null" ] }, "required_scopes": { "description": "Authz actions a caller must hold. An agent that cannot hold them\ncannot be given this tool.", "items": { "type": "string" }, "type": "array" } }, "required": [ "facts", "effect", "required_scopes" ], "type": "object" }, { "properties": { "facts": { "const": "toolset", "type": "string" }, "transport": { "$ref": "#/components/schemas/ReqDef_ToolsetTransport" } }, "required": [ "facts", "transport" ], "type": "object" }, { "description": "Every other kind. Structure and dependencies still apply; there is just\nnothing kind-specific that selection turns on.", "properties": { "facts": { "const": "opaque", "type": "string" } }, "required": [ "facts" ], "type": "object" } ] }, "ReqDef_AgentComponentKind": { "description": "What kind of part this is.\n\nClosed on purpose. Every kind is either referenced from an agent slot \u2014\n[`crate::agent_library::AgentLibraryEntry`],\n[`crate::agent_library::AgentRuntimeContract`] or\n[`crate::agent_graph`] \u2014 or is catalog content an agent is VALIDATED or\nDECIDED against. Both belong to the same closed set for the same reason: a\npart nothing can name is a part nothing can reason about.", "oneOf": [ { "const": "model_profile", "description": "An LLM and the profile it is invoked under (`model_profile_ref`).", "type": "string" }, { "const": "system_prompt", "description": "Instructions, static or dynamic (`system_prompt_ref`).", "type": "string" }, { "const": "tool", "description": "One callable tool (`tool_refs`). An MCP server's tools ingest as these.", "type": "string" }, { "const": "toolset", "description": "A group of tools with one provenance: an MCP server, a function\ntoolset, a skill pack (`toolset_refs`).", "type": "string" }, { "const": "mcp_server", "description": "An MCP server itself -- the thing a set of tools/prompts/resources is\nserved BY. Modelled separately from `Toolset` because impact analysis\nasks about the server (\"this server is down / its schema moved --\nwhich agents are affected?\"), and that question needs the server to be\na node, not an attribute of each tool.", "type": "string" }, { "const": "mcp_prompt", "description": "An MCP prompt: a named, parameterized prompt template a server offers.", "type": "string" }, { "const": "mcp_resource", "description": "An MCP resource: addressable context a server exposes for reading.", "type": "string" }, { "const": "skill", "description": "A pydantic-ai skill (`skill_refs`).", "type": "string" }, { "const": "ontology", "description": "An ontology or vocabulary (`ontology_refs`).", "type": "string" }, { "const": "schema", "description": "A deps/output contract schema (`deps_contract`, `output_contract`).", "type": "string" }, { "const": "output_validator", "description": "An `@agent.output_validator` (`output_validator_refs`).", "type": "string" }, { "const": "predicate", "description": "A predicate behind a graph decision node or edge condition\n(`AgentGraphNodeKind::Decision::decision`, `AgentGraphEdge::condition`).\nBoth slots pin a `ComponentDependency` of this kind, so republishing a\npredicate cannot re-route an already-approved graph.", "type": "string" }, { "const": "shapes", "description": "A SHACL shapes graph a component or request graph is validated against.", "type": "string" }, { "const": "a2a_agent_card", "description": "An A2A agent card: an external agent's own declaration of itself.", "type": "string" }, { "const": "decision_record", "description": "One durable decision record. Published by the engine only; a caller\nthat tries to publish one is refused by name.", "type": "string" }, { "const": "decision_policy", "description": "A decision policy body: what \"better\" means and when to abstain.", "type": "string" }, { "const": "decision_head", "description": "A fitted statistical decision head.", "type": "string" }, { "const": "feature_schema", "description": "The feature schema a decision head is fitted and evaluated against.", "type": "string" }, { "const": "rubric", "description": "A scoring rubric a decision is judged by.", "type": "string" }, { "const": "nl_template", "description": "A natural-language template a decision surface renders with.", "type": "string" } ] }, "ReqDef_AgentComponentMutationKind": { "description": "Which durable mutation a component operation performs.", "oneOf": [ { "enum": [ "publish", "retire" ], "type": "string" }, { "const": "withdraw", "description": "A pack entry that vanished from its connector's current pack. Unlike\n`Retire` this is REVERSIBLE: the entry coming back republishes it.", "type": "string" }, { "const": "republish", "description": "A withdrawn pack entry returning in a later import.", "type": "string" } ] }, "ReqDef_AgentComponentOp": { "description": "Typed component wire operations.", "oneOf": [ { "description": "Boxed for the same reason as the other two layers: a publish request\ncarries a whole draft and would otherwise set the size of every\n`Method`.", "properties": { "op": { "const": "publish", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentComponentPublishRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "op": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentComponentRetireRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "component_id": { "type": "string" }, "op": { "const": "current", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "component_id" ], "type": "object" }, { "properties": { "component_id": { "type": "string" }, "op": { "const": "history", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "component_id" ], "type": "object" }, { "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentComponentStatusRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "description": "Capability search -- the query this layer exists for.", "properties": { "op": { "const": "search", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentComponentSearchRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "description": "Read one revision's engine-owned bytes back, digest-verified.", "properties": { "op": { "const": "content", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentComponentContentRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ReqDef_AgentComponentPublishRequest": { "additionalProperties": false, "properties": { "component": { "$ref": "#/components/schemas/ReqDef_AgentComponentDraft" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext", "description": "Shared with the other two layers: components are published into the\nsame owner as the agents and graphs that reference them, so they share\nits mutation context rather than growing a parallel copy of it." }, "evaluation_receipt_digest": { "default": null, "description": "`sha256:` of the evaluation receipt that qualified this revision.\nREQUIRED for [`AgentComponentKind::DecisionHead`]: a head decides what\nthe engine does, so publishing one without the receipt that measured it\nis the one case where \"we can evaluate it later\" is not recoverable.", "type": [ "string", "null" ] } }, "required": [ "context", "component" ], "type": "object" }, "ReqDef_AgentComponentRetireRequest": { "additionalProperties": false, "properties": { "component_id": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" } }, "required": [ "context", "component_id" ], "type": "object" }, "ReqDef_AgentComponentSearchRequest": { "additionalProperties": false, "description": "Find components by what they can do.\n\nThe wire form of *\"what does an agent trying to do XYZ need?\"*. A caller\nsupplies a `task` (resolved through the native ontology), explicit\n`capabilities`, or at least one `kind`. A kind-only request is the bounded,\npaginated catalog-listing form; a request with no selector is refused, and\nso is a `task` the native ontology does not know (it would resolve to no\ncapability and widen into an unfiltered listing).\n\n# Why this is paginated\n\nThis is the capability-discovery query the whole component layer exists to\nserve, so it is the one read whose result set grows with the tenant rather\nthan with the request. An unpaginated form has two failure modes and no\nrecovery from either: the response size is bounded only by the corpus, and a\ntenant whose component count passes the scan bound is refused on EVERY\nsearch forever. [`AgentComponentSearchPage`] exists so neither is possible,\nand it is an object rather than a bare array because turning an array into\nan object later is a read-side wire break.", "properties": { "capabilities": { "default": [], "description": "Capability terms the component must satisfy by subsumption.", "items": { "type": "string" }, "type": "array" }, "cursor": { "default": null, "description": "Where to resume, from a previous page's\n[`AgentComponentSearchPage::next_cursor`].\n\nOPAQUE: it is produced by the engine and only ever handed back\nunmodified. It carries a binding to the tenant it was minted for, so one\ntenant's cursor is refused by name against another's search rather than\nsilently resuming somewhere.", "type": [ "string", "null" ] }, "kinds": { "default": [], "description": "Restrict to these kinds. Empty means every kind.", "items": { "$ref": "#/components/schemas/ReqDef_AgentComponentKind" }, "type": "array" }, "limit": { "default": null, "description": "How many entries this page may carry, at most\n[`MAX_AGENT_COMPONENT_SEARCH_LIMIT`]. `None` requests the maximum.", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "read_only": { "default": false, "description": "When true, exclude anything side-effecting. The reason this is a\nfirst-class filter rather than a caller-side one: assembling a\nread-only agent is a common, security-relevant request, and a caller\nthat has to filter afterwards can forget to.", "type": "boolean" }, "task": { "default": null, "description": "An ontology task term, e.g. `eg:task/research`.", "type": [ "string", "null" ] }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id" ], "type": "object" }, "ReqDef_AgentComponentStatusRequest": { "additionalProperties": false, "properties": { "component_id": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "kind": { "$ref": "#/components/schemas/ReqDef_AgentComponentMutationKind" } }, "required": [ "context", "component_id", "kind" ], "type": "object" }, "ReqDef_AgentGraphDraft": { "additionalProperties": false, "description": "Caller-supplied inputs for one composed graph.", "properties": { "actor_scope": { "type": "string" }, "graph_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "shape": { "$ref": "#/components/schemas/ReqDef_AgentGraphShape" }, "synthesis_evidence": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "Why this shape: the evidence an optimizer (or a human) composed it from.\n`None` for a hand-authored graph. RF-ADR-008 requires a SYNTHESIZED\nshape to carry it -- a shape without evidence is a guess, and the\npremise of a context engine is that the context is the justification." }, "tenant_id": { "type": "string" }, "version": { "type": "string" } }, "required": [ "graph_id", "version", "shape", "tenant_id", "actor_scope", "purpose_id", "policy_digest" ], "type": "object" }, "ReqDef_AgentGraphEdge": { "additionalProperties": false, "description": "A directed edge, optionally conditional.", "properties": { "condition": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "Only meaningful out of a [`AgentGraphNodeKind::Decision`]; `None` is an\nunconditional edge.\n\nPinned for the same reason a decision node's predicate is: an unpinned\ncondition would let a republished predicate silently re-route an\napproved graph." }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to" ], "type": "object" }, "ReqDef_AgentGraphEntryRef": { "additionalProperties": false, "description": "One pinned agent GRAPH, as a delegation target (RF-ADR-008).\n\nMirrors [`AgentLibraryEntryRef`] exactly: both pin the record's\n`definition_digest`.\n\n# Why a delegation pins the RECORD digest and a composing parent does not\n\nA [`crate::agent_graph::AgentGraphNodeKind::Graph`] node deliberately pins\nthe child's `shape_digest` -- what a parent composes is the child's\nBEHAVIOUR, and the child's governance is re-checked live at every\nresolution, so pinning a stale copy of it would force a cascading republish\nof an entire tree for a change that alters no behaviour.\n\nA delegation is the opposite question. It names a record IDENTITY, and it is\nthe audit point: `synthesis_evidence` -- which RF-ADR-008 section D says is what\nmakes a synthesized graph auditable and reproducible -- is inside\n`definition_digest` and outside `shape_digest`, as are `version`, the actor\nscope, the purpose, the policy digest and the admitted\n`composed_work_ceiling`. A delegation that pinned only the shape would\nattest to what ran while leaving WHY it was composed unpinned.\n\nDo not \"unify\" the two by giving both the same digest: they answer different\nquestions, and [`crate::agent_graph::AgentGraphEntry`]'s own impl-block doc\ncarries the other half of this note.\n\nThe behaviour pin is not lost: `definition_digest` is a hash OVER\n`shape_digest`, and a shape digest covers every node, while an agent node\npins its own `definition_digest`, which pins every component it is assembled\nfrom. So the record digest still pins the ENTIRE tree transitively -- which\nis why a graph target needs no separate `model_digest` (see\n[`KgDelegateRequest::model_digest`]).", "properties": { "actor_scope": { "type": "string" }, "composed_work_ceiling": { "description": "The composed work ceiling this graph was admitted with --\n`CompositionFacts::total_work` from its publish.\n\nCarried rather than recomputed for two reasons. An executor cannot\nderive it without re-resolving the whole composition tree, and more\nimportantly it must honour the ceiling that was VALIDATED at admission,\nnot one it recomputes later against a tree that may have grown new\nrevisions.", "format": "uint64", "minimum": 0, "type": "integer" }, "definition_digest": { "description": "The published RECORD digest -- see the type doc for why this is the\nrecord digest and not the shape digest.", "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "graph_id", "entry_revision", "definition_digest", "actor_scope", "purpose_id", "policy_digest", "composed_work_ceiling" ], "type": "object" }, "ReqDef_AgentGraphMutationKind": { "description": "Which durable mutation a graph operation performs.", "enum": [ "publish", "retire" ], "type": "string" }, "ReqDef_AgentGraphNode": { "additionalProperties": false, "description": "One node: an identity, what it does, and the contracts it speaks.\n\nThe contracts are restated here rather than looked up from the referenced\nentry so a shape can be validated on its own, without resolving every agent\nit names. They are digest-pinned, so a shape whose restated contract has\ndrifted from the published entry is detectable at admission.", "properties": { "deps_contract": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "What this node consumes. `None` = takes the graph's own input." }, "kind": { "$ref": "#/components/schemas/ReqDef_AgentGraphNodeKind" }, "node_id": { "type": "string" }, "output_contract": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "What this node produces. `None` = produces nothing a successor can bind." } }, "required": [ "node_id", "kind" ], "type": "object" }, "ReqDef_AgentGraphNodeKind": { "description": "What one node in the graph does.", "oneOf": [ { "additionalProperties": false, "description": "Run one published Agent Library entry.", "properties": { "agent": { "properties": { "agent_id": { "type": "string" }, "definition_digest": { "description": "The exact definition this shape was composed against. Pinning the\ndigest is what stops a graph from silently changing behaviour when\nsomeone republishes an agent under the same id.", "type": "string" } }, "required": [ "agent_id", "definition_digest" ], "type": "object" } }, "required": [ "agent" ], "type": "object" }, { "additionalProperties": false, "description": "Instantiate a template with bound parameters, then run it.", "properties": { "template": { "properties": { "bindings": { "additionalProperties": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "description": "Parameter name -> the component it is bound to, each PINNED.\n\nBare strings here would break the invariant the rest of this type\nrests on: every other reference in a shape is pinned by digest, so\nrepublishing a component cannot change what a graph does. An unpinned\ntemplate binding would be the one hole through which it could.\nOrdered so the shape digest does not depend on map iteration order.", "type": "object" }, "definition_digest": { "type": "string" }, "template_id": { "type": "string" } }, "required": [ "template_id", "definition_digest", "bindings" ], "type": "object" } }, "required": [ "template" ], "type": "object" }, { "additionalProperties": false, "description": "Run another published GRAPH as one step -- the hierarchical case\n(RF-ADR-008): teams composed of teams.\n\n`shape_digest` pins the exact child revision, for the same reason an\nagent node pins `definition_digest`: republishing the child under the\nsame id must not silently change what this graph does. It also has a\nsecond, larger consequence -- see the module's composition notes -- in\nthat it makes the composition acyclic by construction.", "properties": { "graph": { "properties": { "graph_id": { "type": "string" }, "shape_digest": { "type": "string" } }, "required": [ "graph_id", "shape_digest" ], "type": "object" } }, "required": [ "graph" ], "type": "object" }, { "additionalProperties": false, "description": "Choose an outgoing edge by evaluating each edge's condition.\n\nThe predicate is PINNED, like every other reference in a shape.\nA bare `decision_ref: String` was the one remaining hole: republishing\nthe predicate an approved, digest-pinned graph routes through would\nchange which branch that graph executes, and no `shape_digest` would\nmove. [`AgentComponentKind::Predicate`] exists for exactly this slot.", "properties": { "decision": { "properties": { "decision": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" } }, "required": [ "decision" ], "type": "object" } }, "required": [ "decision" ], "type": "object" }, { "const": "fanout", "description": "Take every outgoing edge concurrently.", "type": "string" }, { "const": "join", "description": "Wait for every inbound edge before continuing.", "type": "string" }, { "const": "end", "description": "Terminal node.", "type": "string" } ] }, "ReqDef_AgentGraphOp": { "description": "Typed agent-graph wire operations.\n\nDeliberately the same five-operation shape as\n[`crate::agent_library::AgentLibraryOp`]: publish and retire are durable\nrevisions, `Current`/`History` are tenant-bound read snapshots, and `Status`\nresolves a prior attempt's receipt. A reader who knows one knows the other.", "oneOf": [ { "description": "Boxed for the same reason as `AgentLibraryOp::Publish`: the request\ncarries a whole graph draft and is far larger than every other\noperation, so an unboxed variant would make each `AgentGraphOp` -- and\nthrough it each `Method` -- pay that size. `Box` is transparent to\nserde, so the wire form is unchanged.", "properties": { "op": { "const": "publish", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentGraphPublishRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "op": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentGraphRetireRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "graph_id": { "type": "string" }, "op": { "const": "current", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "graph_id" ], "type": "object" }, { "properties": { "graph_id": { "type": "string" }, "op": { "const": "history", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "graph_id" ], "type": "object" }, { "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentGraphStatusRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ReqDef_AgentGraphPublishRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext", "description": "Reused from [`crate::agent_library`] rather than cloned. Agent graphs\nare published into the SAME durable owner as agent entries, so they\nshare its mutation context: a parallel copy would be a second field set\nthat has to be kept in lockstep with the first for no gain\n(RF-RULING-004, one physical authority)." }, "graph": { "$ref": "#/components/schemas/ReqDef_AgentGraphDraft" } }, "required": [ "context", "graph" ], "type": "object" }, "ReqDef_AgentGraphRetireRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "graph_id": { "type": "string" } }, "required": [ "context", "graph_id" ], "type": "object" }, "ReqDef_AgentGraphShape": { "additionalProperties": false, "description": "The composed shape: nodes, edges, and where a run starts.", "properties": { "edges": { "items": { "$ref": "#/components/schemas/ReqDef_AgentGraphEdge" }, "type": "array" }, "entry_node": { "type": "string" }, "max_iterations": { "description": "Hard ceiling on node executions for one run. Required, because a shape\nmay contain cycles and a cycle without a ceiling is an unbounded run.", "format": "uint32", "minimum": 0, "type": "integer" }, "nodes": { "items": { "$ref": "#/components/schemas/ReqDef_AgentGraphNode" }, "type": "array" } }, "required": [ "entry_node", "nodes", "edges", "max_iterations" ], "type": "object" }, "ReqDef_AgentGraphStatusRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "graph_id": { "type": "string" }, "kind": { "$ref": "#/components/schemas/ReqDef_AgentGraphMutationKind" } }, "required": [ "context", "graph_id", "kind" ], "type": "object" }, "ReqDef_AgentLibraryCompositeRef": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "model_profile_digest": { "type": "string" }, "ontology_set_digest": { "type": "string" }, "role_digest": { "type": "string" }, "skill_set_digest": { "type": "string" }, "system_prompt_digest": { "type": "string" }, "tool_set_digest": { "type": "string" } }, "required": [ "agent_id", "role_digest", "system_prompt_digest", "tool_set_digest", "skill_set_digest", "model_profile_digest", "ontology_set_digest" ], "type": "object" }, "ReqDef_AgentLibraryEntryDraft": { "additionalProperties": false, "description": "Caller-supplied, immutable definition inputs for one built agent.\n\nEvery component is represented by an opaque reference and a digest. Raw\nprompts, secrets, tool output, and runtime context deliberately have no\nfield in this type and therefore cannot become part of durable identity.", "properties": { "actor_scope": { "type": "string" }, "agent_id": { "type": "string" }, "instantiated_from": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_TemplateInstanceRef" }, { "type": "null" } ], "default": null, "description": "Which template produced this agent, if any (RF-ADR-008 item C).\n\n`None` for a hand-authored agent. Present on an instance so \"which agents\ncame from this template?\" is a traversal -- the same reason components\nare pinned rather than named. Otherwise inert: an instance is admitted,\ndelegated and pinned exactly like any other agent, which is what keeps\nthose paths free of a template-aware branch." }, "model_identity": { "description": "Kept alongside `model_profile`: the profile is the pinned component,\nthis is the model it names. A reader answering \"what model does this\nagent run on?\" should not have to resolve a component to find out.", "type": "string" }, "model_profile": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "ontologies": { "items": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "type": "array" }, "package_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "role": { "type": "string" }, "role_digest": { "type": "string" }, "runtime": { "$ref": "#/components/schemas/ReqDef_AgentRuntimeContract", "default": { "deps_contract": null, "model_settings": { "max_output_tokens": null, "parallel_tool_calls": null, "request_timeout_ms": null, "seed": null, "stop_sequences": [], "temperature_milli": null, "top_p_milli": null }, "output_contract": null, "output_mode": null, "output_validator_refs": [], "prompt_mode": null, "retry_policy": { "model_retries": 0, "output_retries": 0 }, "toolset_refs": [], "usage_limits": { "input_tokens_limit": null, "output_tokens_limit": null, "request_limit": null, "tool_calls_limit": null } }, "description": "How this agent RUNS -- output/deps contracts, model settings, budgets.\nSee [`AgentRuntimeContract`]. An empty contract is a plain-text agent\nwith engine-default budgets." }, "skills": { "items": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "type": "array" }, "source_revision": { "description": "The source revision is an opaque, source-controlled revision identity;\nits content/provenance digest is carried separately below.", "type": "string" }, "source_revision_digest": { "type": "string" }, "system_prompt": { "$ref": "#/components/schemas/ReqDef_ComponentDependency", "description": "The components this agent is assembled from, each pinned to an exact\nL1 revision (RF-ADR-008). These were opaque `*_ref` strings plus a\nper-set digest; pinning them by `(component_id, kind, definition_digest)`\nis what connects the hierarchy:\n\n* \"which agents use this tool?\" becomes a traversal, not a string match;\n* republishing a component changes its digest, so an agent assembled\n from the old one no longer resolves -- silently inheriting a changed\n tool is no longer possible;\n* each slot's `kind` is checked, so a tool cannot be wired in where a\n model profile belongs.\n\nThe former `*_set_digest` fields are gone: a digest over the whole set\nwas pinning what the per-item digests now pin individually, and\n`definition_digest` already covers the sorted list." }, "tenant_id": { "type": "string" }, "tools": { "items": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "type": "array" }, "version": { "type": "string" } }, "required": [ "agent_id", "package_id", "version", "role", "role_digest", "system_prompt", "tools", "skills", "model_profile", "model_identity", "ontologies", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "source_revision", "source_revision_digest" ], "type": "object" }, "ReqDef_AgentLibraryEntryRef": { "additionalProperties": false, "description": "The retained Agent Library identity pinned by a delegation.\n\nThe fields mirror the current Agent Library entry identity: the tenant and\nactor/purpose/policy binding are checked at admission, while the definition\nand source digests pin the exact retained revision. EG never resolves this\nreference from a local cache; the admission owner supplies the retained\nentry and compares this exact value before creating a WorkItem.", "properties": { "actor_scope": { "type": "string" }, "agent_id": { "type": "string" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" }, "source_revision_digest": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "agent_id", "entry_revision", "definition_digest", "source_revision", "source_revision_digest", "actor_scope", "purpose_id", "policy_digest" ], "type": "object" }, "ReqDef_AgentLibraryLifecycle": { "description": "The retained lifecycle of one Agent Library definition.\n\n`Retired` is a durable tombstone. It remains in the revision stream and\ncannot be replaced by a later publish, preserving the definition's\nprovenance and preventing silent resurrection of an agent identity.\n\n`Withdrawn` is the reversible counterpart, and it exists only for connector\npack members: a pack that stops serving an entry has not decided the entry\nwas wrong, only that it is no longer offered, and a later import that\noffers it again must be able to republish it. Collapsing the two would make\nevery transient publisher outage a permanent tombstone.", "enum": [ "published", "retired", "withdrawn" ], "type": "string" }, "ReqDef_AgentLibraryMutationContext": { "additionalProperties": false, "description": "Caller and authorization facts required by one Agent Library write.\n\nThe storage seam copies these values into the durable action receipt and\nchecks the tenant before admission. The request boundary derives them from\nthe verified carrier; the entry's actor scope, purpose, and policy digest\nremain historical definition provenance and are retained independently.\nAuthentication and policy decisions remain above this pure DTO.", "properties": { "actor_scope": { "type": "string" }, "attempt_nonce": { "$ref": "#/components/schemas/ReqDef_Nonce", "description": "The verified attempt nonce. Every Agent Library mutation must receive\nthis from its authenticated producer; the storage owner never mints a\nfallback nonce because doing so would create a second replay authority." }, "caller_principal": { "description": "Privacy-safe authenticated caller identity, bound by the request\nboundary and copied to the action receipt/outbox actor header.", "type": "string" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_revision": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "idempotency_key": { "type": "string" }, "policy_decision_id": { "type": "string" }, "policy_digest": { "type": "string" }, "policy_revision": { "type": "string" }, "principal": { "description": "Serving authority for the native owner ledger. The authenticated\ncaller is carried separately in `caller_principal`.", "type": "string" }, "purpose_id": { "type": "string" }, "request_id": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" }, "trace_id": { "type": [ "string", "null" ] } }, "required": [ "request_id", "principal", "caller_principal", "attempt_nonce", "tenant_id", "actor_scope", "purpose_id", "policy_revision", "policy_digest", "policy_decision_id", "idempotency_key", "created_at_ms" ], "type": "object" }, "ReqDef_AgentLibraryMutationKind": { "description": "Mutation kind carried by an Agent Library outbox event.", "enum": [ "publish", "retire" ], "type": "string" }, "ReqDef_AgentLibraryOp": { "description": "Typed Agent Library wire operations. The persistence owner remains the\nsingle implementation for every operation; this enum only carries the\nauthenticated request across the existing engine dispatch boundary.", "oneOf": [ { "additionalProperties": false, "description": "Boxed: a publish request carries the whole entry draft and is far\nlarger than every other operation, so an unboxed variant would make\neach `AgentLibraryOp` -- and through it each `Method` -- pay that\nsize. `Box` is transparent to serde, so the wire form is unchanged.", "properties": { "operation": { "const": "publish", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentLibraryPublishRequest" } }, "required": [ "operation", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "operation": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentLibraryRetireRequest" } }, "required": [ "operation", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "operation": { "const": "current", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "operation", "tenant_id", "agent_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "operation": { "const": "history", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "operation", "tenant_id", "agent_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "operation": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentLibraryStatusRequest" } }, "required": [ "operation", "request" ], "type": "object" } ] }, "ReqDef_AgentLibraryPublishRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "entry": { "$ref": "#/components/schemas/ReqDef_AgentLibraryEntryDraft" } }, "required": [ "context", "entry" ], "type": "object" }, "ReqDef_AgentLibraryRetireRequest": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" } }, "required": [ "context", "agent_id" ], "type": "object" }, "ReqDef_AgentLibraryStatusRequest": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "kind": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationKind" } }, "required": [ "context", "agent_id", "kind" ], "type": "object" }, "ReqDef_AgentModelSettings": { "additionalProperties": false, "description": "Bounded model-invocation settings (pydantic-ai `ModelSettings`).\n\nEvery continuous setting is an INTEGER in thousandths, never a float. These\nvalues are hashed into `definition_digest`, and floats have no canonical\nbyte form for that purpose: `NaN != NaN` breaks `Eq`, `0.0` and `-0.0` are\nequal but hash differently, and the same value can format differently across\nplatforms and serde versions. A reproducible definition digest cannot be\nbuilt on any of that, so the wire type carries milli-units and the harness\ndivides by 1000 when it constructs the model settings.", "properties": { "max_output_tokens": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "parallel_tool_calls": { "type": [ "boolean", "null" ] }, "request_timeout_ms": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "seed": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "stop_sequences": { "items": { "type": "string" }, "type": "array" }, "temperature_milli": { "description": "Sampling temperature in thousandths (`700` = 0.7).", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "top_p_milli": { "description": "Nucleus-sampling mass in thousandths (`950` = 0.95).", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "stop_sequences" ], "type": "object" }, "ReqDef_AgentOutputMode": { "description": "How the model is asked to produce the agent's structured output.\n\nMirrors pydantic-ai's `ToolOutput` / `NativeOutput` / `PromptedOutput`.", "oneOf": [ { "const": "text", "description": "Free text \u2014 pydantic-ai's default `output_type=str`.", "type": "string" }, { "const": "tool", "description": "A synthesized tool call carries the structured result.", "type": "string" }, { "const": "native", "description": "The provider's own structured-output mode.", "type": "string" }, { "const": "prompted", "description": "The schema is described in the prompt and parsed from the reply.", "type": "string" } ] }, "ReqDef_AgentPromptMode": { "description": "Whether the system prompt is fixed at publish time or resolved per run.\n\npydantic-ai distinguishes `Agent(system_prompt=\u2026)` from `@agent.system_prompt`\n/ `@agent.instructions`. The distinction is durable identity, not style: a\nstatic prompt's digest pins the prompt itself, while a dynamic prompt's\ndigest can only pin the FUNCTION that produces it. A dynamic prompt must\ntherefore be digest-bound again at resolution time, and a reader that cannot\ntell the two apart cannot know whether `system_prompt_digest` covers the text\nthe model actually saw.", "enum": [ "static", "dynamic" ], "type": "string" }, "ReqDef_AgentRetryPolicy": { "additionalProperties": false, "description": "Retry budgets that belong to the agent definition, not to one delegation.\n\nDistinct from `KgDelegateRequest::max_attempts`, which is how many times the\nENGINE will re-admit the work item. These are how many times the agent will\nask the model again within a single run after a tool error or an output that\nfails validation (pydantic-ai `retries` / `output_retries`).", "properties": { "model_retries": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "output_retries": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "model_retries", "output_retries" ], "type": "object" }, "ReqDef_AgentRole": { "description": "Role of an agent in the system hierarchy.", "oneOf": [ { "const": "System", "description": "System-level (can do anything).", "type": "string" }, { "additionalProperties": false, "description": "Manager agent with subordinates.", "properties": { "Manager": { "properties": { "subordinates": { "items": { "type": "string" }, "type": "array" } }, "required": [ "subordinates" ], "type": "object" } }, "required": [ "Manager" ], "type": "object" }, { "const": "Agent", "description": "Regular agent.", "type": "string" } ] }, "ReqDef_AgentRuntimeContract": { "additionalProperties": false, "description": "The part of an agent's definition that governs how it RUNS, as opposed to\nwhich components it is assembled from.\n\nGrouped into one nested type rather than flattened into\n[`AgentLibraryEntryDraft`] deliberately. The draft, the entry, `create`,\n`retire` and `as_draft` each restate every field, so a flat shape would pay\nfive edits per field and grow a 23-field struct to 35 \u2014 the exact sprawl\nRF-ADR-008 exists to avoid. It also names a real concept: two agents with\nthe same components but different output contracts are different agents.\n\nEvery field participates in `definition_digest`.", "properties": { "deps_contract": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, { "type": "null" } ], "description": "The agent's typed input (pydantic-ai `deps_type`). `None` = no deps." }, "model_settings": { "$ref": "#/components/schemas/ReqDef_AgentModelSettings" }, "output_contract": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, { "type": "null" } ], "description": "The agent's typed output (pydantic-ai `output_type`). `None` with\n[`AgentOutputMode::Text`] is the plain-text default." }, "output_mode": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_AgentOutputMode" }, { "type": "null" } ] }, "output_validator_refs": { "description": "`@agent.output_validator` functions, by reference.", "items": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "type": "array" }, "prompt_mode": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_AgentPromptMode" }, { "type": "null" } ], "description": "`None` is read as [`AgentPromptMode::Static`]." }, "retry_policy": { "$ref": "#/components/schemas/ReqDef_AgentRetryPolicy" }, "toolset_refs": { "description": "Grouped tool sources \u2014 a `FunctionToolset`, an MCP server, a skill pack.\n\n`tools` on the entry is the flattened resolution of these WHERE THE\nPUBLISHER CAN FLATTEN THEM, so a reader that only cares which individual\ntools exist need not walk the grouping. The engine does not, and cannot,\nenforce that: a toolset is an L1 reference, its contents live in the\nsystem that owns it, and resolving an MCP server's tool list is not\nsomething this contract can do at publish time. Treating the flattening\nas an invariant would therefore be asserting a property nothing checks.\n\nSo the capability proof covers BOTH lists instead \u2014 see\n[`AgentLibraryEntry::tool_surface_digest`]. An agent that names a toolset\nit did not flatten still has that toolset inside the digest delegation\nadmits, rather than a proof over a strict subset of what it can call.", "items": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "type": "array" }, "usage_limits": { "$ref": "#/components/schemas/ReqDef_AgentUsageLimits" } }, "required": [ "output_validator_refs", "toolset_refs", "model_settings", "retry_policy", "usage_limits" ], "type": "object" }, "ReqDef_AgentTemplateDraft": { "additionalProperties": false, "description": "Caller-supplied inputs for one template revision.", "properties": { "actor_scope": { "type": "string" }, "base": { "$ref": "#/components/schemas/ReqDef_AgentLibraryEntryDraft", "description": "The default agent. Valid and runnable on its own." }, "params": { "items": { "$ref": "#/components/schemas/ReqDef_TemplateParam" }, "type": "array" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" }, "version": { "type": "string" } }, "required": [ "template_id", "version", "base", "params", "tenant_id", "actor_scope", "purpose_id", "policy_digest" ], "type": "object" }, "ReqDef_AgentTemplateInstantiateRequest": { "additionalProperties": false, "description": "Bind a template's parameters and get back an ordinary agent draft.\n\nA READ: it resolves durable state and computes, but commits nothing. The\ncaller publishes the returned draft through `AgentLibrary::Publish` exactly\nas it would a hand-authored one -- which is the whole point of the design,\nand the reason there is no template-aware branch in admission or delegation.\n\n`entry_revision` pins which template revision to bind. `None` means the\nhead. Pinning matters because [`TemplateInstanceRef`] records a revision:\nreproducing an existing instance means binding the revision it named, not\nwhatever the head has since become.", "properties": { "agent_id": { "description": "The instance's own agent id. Supplied, not derived -- see\n[`AgentTemplateEntry::instantiate`].", "type": "string" }, "bindings": { "additionalProperties": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "default": {}, "type": "object" }, "entry_revision": { "default": null, "description": "The revision to bind, or the head when absent.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "template_id", "agent_id" ], "type": "object" }, "ReqDef_AgentTemplateMutationKind": { "description": "Which durable mutation a template operation performs.", "enum": [ "publish", "retire" ], "type": "string" }, "ReqDef_AgentTemplateOp": { "description": "Typed template wire operations.", "oneOf": [ { "description": "Boxed for the same reason as the other three layers: a publish request\ncarries a whole draft -- and this one embeds an entire\n[`AgentLibraryEntryDraft`] as its base, so it is the largest of the\nfour -- and would otherwise set the size of every `Method`. `Box` is\ntransparent to serde, so the wire form is unchanged.", "properties": { "op": { "const": "publish", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentTemplatePublishRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "op": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentTemplateRetireRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "op": { "const": "current", "type": "string" }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "template_id" ], "type": "object" }, { "properties": { "op": { "const": "history", "type": "string" }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "template_id" ], "type": "object" }, { "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentTemplateStatusRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "description": "Bind parameters and return an ordinary agent draft -- the query this\nlayer exists for. A read: nothing is committed until the caller\npublishes the draft through the agent library.\n\nNOT boxed, unlike `Publish`: this request carries only ids and a\nbounded binding map, so it is smaller than `Status`'s mutation context\nand boxing it would buy an allocation on a read path for nothing.", "properties": { "op": { "const": "instantiate", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AgentTemplateInstantiateRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ReqDef_AgentTemplatePublishRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext", "description": "Shared with the other three layers: templates are published into the\nsame owner as the components, agents and graphs they are built from, so\nthey share its mutation context rather than growing a parallel copy of\nit." }, "template": { "$ref": "#/components/schemas/ReqDef_AgentTemplateDraft" } }, "required": [ "context", "template" ], "type": "object" }, "ReqDef_AgentTemplateRetireRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "template_id": { "type": "string" } }, "required": [ "context", "template_id" ], "type": "object" }, "ReqDef_AgentTemplateStatusRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "kind": { "$ref": "#/components/schemas/ReqDef_AgentTemplateMutationKind" }, "template_id": { "type": "string" } }, "required": [ "context", "template_id", "kind" ], "type": "object" }, "ReqDef_AgentUsageLimits": { "additionalProperties": false, "description": "Per-run consumption ceilings (pydantic-ai `UsageLimits`).\n\n`None` means \"the engine's bounded default\", never \"unlimited\" \u2014 an agent\ndefinition cannot opt out of a ceiling, only decline to tighten it.", "properties": { "input_tokens_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_tokens_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "request_limit": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "tool_calls_limit": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "ReqDef_Algorithm": { "description": "The solver algorithm that produced a certificate.", "oneOf": [ { "const": "depth_first_dual_ascent", "description": "Propagation, greedy incumbent, depth-first branch-and-bound with a\ndual-ascent Lagrangian bound, pre-order leaf-bound certificate.", "type": "string" } ] }, "ReqDef_AnomalyAlgorithm": { "description": "Which detector `MineAnomaly` runs (CONCEPT:EG-KG.mining.isolation-forest).", "enum": [ "zscore", "isoforest", "lof", "ocsvm" ], "type": "string" }, "ReqDef_AsrOp": { "description": "`Method::Asr { op }`'s request shape. `audio_wav` carries the actual PCM\nbytes over the wire (MessagePack handles binary natively \u2014 no base64\ninflation); `model_path`/`model_sha256` are a caller-resolved,\nalready-verified model reference (GOC-36 owns acquisition; this crate\nnever resolves a bare model name into a path or URL).", "oneOf": [ { "additionalProperties": false, "properties": { "TranscribeFile": { "properties": { "audio_wav": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "language": { "default": null, "type": [ "string", "null" ] }, "model_path": { "type": "string" }, "model_sha256": { "type": "string" }, "translate": { "default": false, "type": "boolean" }, "window_ms": { "default": 0, "description": "Bounded streaming window, milliseconds. `0`/absent \u21d2 handler\ndefault (30_000 \u2014 see `handlers::asr`).", "format": "uint32", "minimum": 0, "type": "integer" }, "word_timing": { "default": false, "type": "boolean" } }, "required": [ "model_path", "model_sha256", "audio_wav" ], "type": "object" } }, "required": [ "TranscribeFile" ], "type": "object" } ] }, "ReqDef_AssemblyConstraints": { "additionalProperties": false, "description": "Non-capability requirements the assembly must satisfy.", "properties": { "context_budget_tokens": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "cost_budget": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_CostBudget" }, { "type": "null" } ], "default": null }, "max_components": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "max_p95_latency_ms": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "modalities_in": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_16", "default": [] }, "modalities_out": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_16", "default": [] }, "require_structured_output": { "default": false, "type": "boolean" }, "require_tools": { "default": false, "type": "boolean" } }, "type": "object" }, "ReqDef_AssemblyRequest": { "additionalProperties": false, "description": "One assembly question.", "properties": { "candidates": { "$ref": "#/components/schemas/ReqDef_LibraryCandidateScope" }, "policy": { "$ref": "#/components/schemas/ReqDef_DecisionPolicyRef" }, "requirements": { "$ref": "#/components/schemas/ReqDef_AssemblyRequirements" }, "solver": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SolverBudget" }, { "type": "null" } ], "default": null }, "templates": { "$ref": "#/components/schemas/ReqDef_BoundedVec_AgentGraphEntryRef_8", "default": [], "description": "Candidate graph templates. Empty asks for a one-agent graph." }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "requirements", "candidates", "policy" ], "type": "object" }, "ReqDef_AssemblyRequirements": { "additionalProperties": false, "description": "What the assembled agent has to be able to do.", "properties": { "capabilities": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_32", "default": [], "description": "Native `eg:capability/*` IRIs." }, "constraints": { "$ref": "#/components/schemas/ReqDef_AssemblyConstraints", "default": { "context_budget_tokens": null, "cost_budget": null, "max_components": null, "max_p95_latency_ms": null, "modalities_in": [], "modalities_out": [], "require_structured_output": false, "require_tools": false } }, "denies": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64", "default": [], "description": "Component ids that must not be selected." }, "pins": { "$ref": "#/components/schemas/ReqDef_BoundedVec_ComponentDependency_64", "default": [] }, "task_mappings": { "$ref": "#/components/schemas/ReqDef_BoundedVec_ClaimedTaskMapping_32", "default": [] }, "tasks": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_32", "default": [], "description": "Native `eg:task/*` IRIs." }, "unmapped_task_digests": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_32", "default": [], "description": "Digests of free text no mapping covered. Each becomes an abstention\nreason rather than a silently dropped requirement." } }, "type": "object" }, "ReqDef_AuthorityContext": { "additionalProperties": false, "description": "Complete attempt-specific authority context. Its digest intentionally binds\nrequest/trace identity, timestamps, and nonce and therefore MUST NOT be used\nas the stable operation replay identity.", "properties": { "actor": { "type": "string" }, "audience": { "type": "string" }, "authority_scope": { "$ref": "#/components/schemas/ReqDef_AuthorityScope" }, "catalog_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "context_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "expires_at": { "format": "int64", "type": "integer" }, "idempotency_key": { "type": [ "string", "null" ] }, "ingress_surface": { "type": "string" }, "issued_at": { "format": "int64", "type": "integer" }, "nonce": { "$ref": "#/components/schemas/ReqDef_Nonce" }, "operation": { "type": "string" }, "policy_decision_id": { "type": "string" }, "policy_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "policy_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_revision": { "type": "string" }, "protocol_id": { "type": "string" }, "purpose_kind": { "type": "string" }, "purpose_resource": { "type": [ "string", "null" ] }, "request_id": { "type": "string" }, "schema_version": { "type": "string" }, "tenant": { "type": "string" }, "trace_id": { "type": "string" } }, "required": [ "schema_version", "protocol_id", "catalog_digest", "request_id", "trace_id", "ingress_surface", "actor", "audience", "tenant", "authority_scope", "purpose_kind", "operation", "policy_revision", "policy_epoch", "policy_decision_id", "policy_digest", "issued_at", "expires_at", "nonce", "context_digest" ], "type": "object" }, "ReqDef_AuthorityScope": { "additionalProperties": false, "description": "A materialized scope derived from verified authority. Parent scopes must be\nsorted and unique so equal authority never has multiple byte spellings.", "properties": { "graph_incarnation": { "type": [ "string", "null" ] }, "kind": { "type": "string" }, "parent_scope_ids": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64" }, "scope_id": { "type": "string" }, "tenant": { "type": [ "string", "null" ] } }, "required": [ "kind", "scope_id", "parent_scope_ids" ], "type": "object" }, "ReqDef_BlobReference": { "properties": { "blob_id": { "type": "string" }, "digest": { "type": "string" }, "digest_algorithm": { "type": "string" }, "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "media_type": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ReqDef_MaterialOperation" } }, "required": [ "blob_id", "operation", "digest_algorithm", "digest", "media_type", "length" ], "type": "object" }, "ReqDef_BoundProof": { "description": "The lower-bound evidence a certificate carries.", "oneOf": [ { "additionalProperties": false, "description": "A complete pre-order search tree.", "properties": { "tree": { "additionalProperties": false, "properties": { "nodes": { "items": { "$ref": "#/components/schemas/ReqDef_ProofNode" }, "type": "array" } }, "required": [ "nodes" ], "type": "object" } }, "required": [ "tree" ], "type": "object" }, { "additionalProperties": false, "description": "Only the root dual (the tree exceeded the certificate leaf limit).", "properties": { "root": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ReqDef_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "root" ], "type": "object" } ] }, "ReqDef_BoundedVec_AbstainReason_64": { "items": { "$ref": "#/components/schemas/ReqDef_AbstainReason" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_AgentComponentKind_16": { "items": { "$ref": "#/components/schemas/ReqDef_AgentComponentKind" }, "maxItems": 16, "type": "array" }, "ReqDef_BoundedVec_AgentGraphEntryRef_8": { "items": { "$ref": "#/components/schemas/ReqDef_AgentGraphEntryRef" }, "maxItems": 8, "type": "array" }, "ReqDef_BoundedVec_BoundedVec_SqlSourceCell_256_1024": { "items": { "$ref": "#/components/schemas/ReqDef_BoundedVec_SqlSourceCell_256" }, "maxItems": 1024, "type": "array" }, "ReqDef_BoundedVec_CandidateFacts_64": { "items": { "$ref": "#/components/schemas/ReqDef_CandidateFacts" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_ClaimedTaskMapping_32": { "items": { "$ref": "#/components/schemas/ReqDef_ClaimedTaskMapping" }, "maxItems": 32, "type": "array" }, "ReqDef_BoundedVec_ComponentDependency_256": { "items": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "maxItems": 256, "type": "array" }, "ReqDef_BoundedVec_ComponentDependency_64": { "items": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_CoverageDerivation_32": { "items": { "$ref": "#/components/schemas/ReqDef_CoverageDerivation" }, "maxItems": 32, "type": "array" }, "ReqDef_BoundedVec_DerivationEdge_16": { "items": { "$ref": "#/components/schemas/ReqDef_DerivationEdge" }, "maxItems": 16, "type": "array" }, "ReqDef_BoundedVec_Digest256_64": { "items": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_Elimination_64": { "items": { "$ref": "#/components/schemas/ReqDef_Elimination" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_LabelledItem_4096": { "items": { "$ref": "#/components/schemas/ReqDef_LabelledItem" }, "maxItems": 4096, "type": "array" }, "ReqDef_BoundedVec_ObjectiveLevelKind_8": { "items": { "$ref": "#/components/schemas/ReqDef_ObjectiveLevelKind" }, "maxItems": 8, "type": "array" }, "ReqDef_BoundedVec_OpeEstimatorKind_8": { "items": { "$ref": "#/components/schemas/ReqDef_OpeEstimatorKind" }, "maxItems": 8, "type": "array" }, "ReqDef_BoundedVec_PackEntry_1024": { "items": { "$ref": "#/components/schemas/ReqDef_PackEntry" }, "maxItems": 1024, "type": "array" }, "ReqDef_BoundedVec_PackRef_64": { "items": { "$ref": "#/components/schemas/ReqDef_PackRef" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_PremiseRef_1024": { "items": { "$ref": "#/components/schemas/ReqDef_PremiseRef" }, "maxItems": 1024, "type": "array" }, "ReqDef_BoundedVec_PremiseRef_32": { "items": { "$ref": "#/components/schemas/ReqDef_PremiseRef" }, "maxItems": 32, "type": "array" }, "ReqDef_BoundedVec_SlotAssignment_64": { "items": { "$ref": "#/components/schemas/ReqDef_SlotAssignment" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_SourceEntityRef_16384": { "items": { "$ref": "#/components/schemas/ReqDef_SourceEntityRef" }, "maxItems": 16384, "type": "array" }, "ReqDef_BoundedVec_SourceRecord_1024": { "items": { "$ref": "#/components/schemas/ReqDef_SourceRecord" }, "maxItems": 1024, "type": "array" }, "ReqDef_BoundedVec_SourceRelationship_4096": { "items": { "$ref": "#/components/schemas/ReqDef_SourceRelationship" }, "maxItems": 4096, "type": "array" }, "ReqDef_BoundedVec_SourceWithdrawal_1024": { "items": { "$ref": "#/components/schemas/ReqDef_SourceWithdrawal" }, "maxItems": 1024, "type": "array" }, "ReqDef_BoundedVec_SqlSourceCell_256": { "items": { "$ref": "#/components/schemas/ReqDef_SqlSourceCell" }, "maxItems": 256, "type": "array" }, "ReqDef_BoundedVec_TemplateFacts_8": { "items": { "$ref": "#/components/schemas/ReqDef_TemplateFacts" }, "maxItems": 8, "type": "array" }, "ReqDef_BoundedVec_TypedParam_64": { "items": { "$ref": "#/components/schemas/ReqDef_TypedParam" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_UnitRationalWire_64": { "items": { "$ref": "#/components/schemas/ReqDef_UnitRationalWire" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_WeightedLevel_8": { "items": { "$ref": "#/components/schemas/ReqDef_WeightedLevel" }, "maxItems": 8, "type": "array" }, "ReqDef_BoundedVec_WhyNot_64": { "items": { "$ref": "#/components/schemas/ReqDef_WhyNot" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_float_4096": { "items": { "format": "float", "type": "number" }, "maxItems": 4096, "type": "array" }, "ReqDef_BoundedVec_int64_2048": { "items": { "format": "int64", "type": "integer" }, "maxItems": 2048, "type": "array" }, "ReqDef_BoundedVec_string_1024": { "items": { "type": "string" }, "maxItems": 1024, "type": "array" }, "ReqDef_BoundedVec_string_16": { "items": { "type": "string" }, "maxItems": 16, "type": "array" }, "ReqDef_BoundedVec_string_256": { "items": { "type": "string" }, "maxItems": 256, "type": "array" }, "ReqDef_BoundedVec_string_32": { "items": { "type": "string" }, "maxItems": 32, "type": "array" }, "ReqDef_BoundedVec_string_64": { "items": { "type": "string" }, "maxItems": 64, "type": "array" }, "ReqDef_BoundedVec_string_8": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "ReqDef_CalibrationWire": { "description": "Wire mirror of `eg_epistemic::Calibration` (EPI-P3-3) \u2014 the calibrated interval\nbacking a `RetrievalCandidateWire`'s evidence-quality score, when the candidate\nhas one.", "properties": { "evidence_count": { "format": "uint", "minimum": 0, "type": "integer" }, "interval": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "double", "type": "number" }, { "format": "double", "type": "number" } ], "type": "array" }, "level": { "format": "double", "type": "number" } }, "required": [ "interval", "level", "evidence_count" ], "type": "object" }, "ReqDef_CandidateFacts": { "additionalProperties": false, "description": "Everything known about one candidate at decision time.", "properties": { "classification": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64" }, "component_id": { "type": "string" }, "declared_capabilities": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fact_premises": { "$ref": "#/components/schemas/ReqDef_BoundedVec_PremiseRef_32", "description": "The premises the facts above rest on." }, "facts": { "$ref": "#/components/schemas/ReqDef_AgentComponentFacts" }, "kind": { "$ref": "#/components/schemas/ReqDef_AgentComponentKind" }, "lifecycle": { "$ref": "#/components/schemas/ReqDef_AgentLibraryLifecycle" }, "required_capabilities": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64" }, "requires": { "$ref": "#/components/schemas/ReqDef_BoundedVec_ComponentDependency_256" } }, "required": [ "component_id", "kind", "entry_revision", "definition_digest", "lifecycle", "classification", "required_capabilities", "declared_capabilities", "requires", "facts", "fact_premises" ], "type": "object" }, "ReqDef_CandidateSource": { "description": "Where the options come from.\nNot `Eq`: the cross-modal plan carries floats, so equality on a graph-sourced\ncandidate scope is partial, exactly as it is on `Method` itself.", "oneOf": [ { "additionalProperties": false, "description": "A tenant-bound agent library scope.", "properties": { "scope": { "$ref": "#/components/schemas/ReqDef_LibraryCandidateScope" }, "source": { "const": "agent_library", "type": "string" } }, "required": [ "source", "scope" ], "type": "object" }, { "additionalProperties": false, "description": "An RLS-filtered cross-modal plan over one named graph -- the same\npublic plan type `Method::UnifiedQuery` accepts, so there is one plan\nvocabulary. The plan only names the candidate id set; it may not rank\nor truncate before visibility, because a top-k taken over invisible\nrows would move visible ones.", "properties": { "graph": { "type": "string" }, "plan": { "$ref": "#/components/schemas/ReqDef_Plan" }, "source": { "const": "graph", "type": "string" } }, "required": [ "source", "graph", "plan" ], "type": "object" } ] }, "ReqDef_CandidateSourceRecord": { "description": "Where the candidates came from.", "oneOf": [ { "additionalProperties": false, "description": "One tenant-bound agent library snapshot.", "properties": { "classification_under": { "default": null, "type": [ "string", "null" ] }, "kinds": { "$ref": "#/components/schemas/ReqDef_BoundedVec_AgentComponentKind_16" }, "source": { "const": "agent_library", "type": "string" } }, "required": [ "source", "kinds" ], "type": "object" }, { "additionalProperties": false, "description": "An RLS-filtered graph plan, pinned by its plan digest.", "properties": { "plan_digest": { "type": "string" }, "source": { "const": "graph", "type": "string" } }, "required": [ "source", "plan_digest" ], "type": "object" } ] }, "ReqDef_CanonicalTextAssetRef": { "additionalProperties": false, "properties": { "asset_id": { "type": "string" }, "asset_revision": { "type": "string" }, "content_digest": { "type": "string" } }, "required": [ "asset_id", "asset_revision", "content_digest" ], "type": "object" }, "ReqDef_CapacityAcquireRequest": { "additionalProperties": false, "properties": { "cost_budget_micros": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "demands": { "items": { "$ref": "#/components/schemas/ReqDef_CapacityDemand" }, "type": "array" }, "idempotency_key": { "type": "string" }, "lease_id": { "type": [ "string", "null" ] }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_digest": { "description": "Opaque owner digest. The server compares this to the authenticated\nprincipal/agent binding; callers cannot choose a different owner.", "type": "string" }, "priority": { "$ref": "#/components/schemas/ReqDef_LeasePriority" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_NativeControlSchemaVersion" }, "tenant_ref": { "type": "string" }, "token_budget": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_digest", "idempotency_key", "priority", "demands", "ttl_ms", "now_ms" ], "type": "object" }, "ReqDef_CapacityCell": { "additionalProperties": false, "description": "A durable capacity pool. `capacity` is the cell's total admittable amount at\nits current `epoch`; `reserved_floor` is the slice never available to\n`BackgroundIngestion` (invariant: \"Interactive and orchestration floors are\nreserved; background uses spare capacity but cannot starve a tenant\nindefinitely\").", "properties": { "capacity": { "format": "uint64", "minimum": 0, "type": "integer" }, "cell_id": { "type": "string" }, "epoch": { "description": "Monotonic authority epoch (GOC-03 fencing concept, vendored \u2014 see module\ndoc). Bumped on cell-authority failover/repartition; an acquire/renew\ncarrying an epoch below this is a stale-authority rejection, never a\nbest-effort read of a foreign shape.", "format": "uint64", "minimum": 0, "type": "integer" }, "parent_id": { "type": [ "string", "null" ] }, "policy_digest": { "description": "sha256 digest of the policy/catalog/model snapshot this cell was\nprovisioned under (checked at every hop per the lane doc's \"Security and\nprivacy\" section); opaque here, verified upstream.", "type": "string" }, "reserved_floor": { "format": "uint64", "minimum": 0, "type": "integer" }, "resource_class": { "$ref": "#/components/schemas/ReqDef_CapacityResourceClass" }, "updated_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cell_id", "resource_class", "capacity", "reserved_floor", "epoch", "policy_digest", "updated_at_ms" ], "type": "object" }, "ReqDef_CapacityCellUpdateRequest": { "additionalProperties": false, "properties": { "cell": { "$ref": "#/components/schemas/ReqDef_CapacityCell" }, "expected_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_NativeControlSchemaVersion" } }, "required": [ "schema_version", "cell", "now_ms" ], "type": "object" }, "ReqDef_CapacityDemand": { "additionalProperties": false, "properties": { "amount": { "format": "uint64", "minimum": 0, "type": "integer" }, "cell_id": { "type": "string" }, "resource_class": { "$ref": "#/components/schemas/ReqDef_CapacityResourceClass" } }, "required": [ "cell_id", "resource_class", "amount" ], "type": "object" }, "ReqDef_CapacityLeaseFence": { "additionalProperties": false, "properties": { "fence_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_id": { "type": "string" } }, "required": [ "lease_id", "lease_epoch", "fence_token" ], "type": "object" }, "ReqDef_CapacityLeaseMutationRequest": { "additionalProperties": false, "properties": { "idempotency_key": { "type": [ "string", "null" ] }, "leases": { "items": { "$ref": "#/components/schemas/ReqDef_CapacityLeaseFence" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_digest": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_NativeControlSchemaVersion" }, "tenant_ref": { "type": "string" }, "ttl_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "schema_version", "tenant_ref", "owner_digest", "leases", "now_ms" ], "type": "object" }, "ReqDef_CapacityReclaimRequest": { "additionalProperties": false, "properties": { "cell_id": { "type": [ "string", "null" ] }, "cursor": { "type": [ "string", "null" ] }, "max_count": { "format": "uint32", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_NativeControlSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "max_count", "now_ms" ], "type": "object" }, "ReqDef_CapacityResourceClass": { "description": "The resource a `CapacityCell` doles out. Mirrors the lane doc's \"CPU/LLM/GPU\ncapacity\" plus the existing AU gates this composes with\n(`resource_priority.py`'s shared-LLM gate, `worker_scheduler.py`'s host\nworker pool, `gpu_group_budget.py`'s per-GPU/model floors).", "oneOf": [ { "const": "llm_generator", "description": "Shared LLM generator admission slots (composes with `resource_priority.py`).", "type": "string" }, { "const": "llm_embedding", "description": "A separate embedding endpoint's admission slots \u2014 never contends with\n`LlmGenerator` (mirrors `resource_priority.py`'s separate embedding gate key).", "type": "string" }, { "const": "gpu", "description": "GPU compute units (composes with `gpu_group_budget.py`).", "type": "string" }, { "const": "worker", "description": "Host worker pool slots (composes with `worker_scheduler.py`).", "type": "string" }, { "const": "cpu", "description": "CPU-bound compute slots.", "type": "string" }, { "const": "broker", "description": "Message-broker/engine dispatch admission slots.", "type": "string" } ] }, "ReqDef_CapacityStatusRequest": { "additionalProperties": false, "properties": { "cell_id": { "type": [ "string", "null" ] }, "cursor": { "type": [ "string", "null" ] }, "lease_id": { "type": [ "string", "null" ] }, "max_count": { "format": "uint32", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_NativeControlSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "max_count" ], "type": "object" }, "ReqDef_CasWorkItemMetadataLeaseFence": { "additionalProperties": false, "description": "The live lease tuple a lease-holding caller (checkpoint / request-input)\nfences on, exactly like `RenewWorkItemLease`. Omit `expected_lease` on\nthe request entirely for a lease-less external/scheduler caller\n(submit-input / set-priority), which fences on `expected_status` (and,\nfor submit-input, the tenant + the field's own expected prior value)\ninstead.", "properties": { "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "worker_ref": { "type": "string" } }, "required": [ "worker_ref", "lease_epoch", "fencing_token" ], "type": "object" }, "ReqDef_CasWorkItemMetadataRequest": { "additionalProperties": false, "description": "Atomic single-field compare-and-set on one WorkItem's scheduling\nmetadata. Exactly one field-pair \u2014 (`expected_checkpoint_id`,\n`set_checkpoint_id`) xor (`expected_metadata_msgpack`,\n`set_metadata_msgpack`) xor (`expected_prio_bucket`, `set_prio_bucket`)\n\u2014 must be present; the engine rejects a request naming zero or more than\none. `expected_status` must be non-empty: the caller always names the\nexact status set the row must currently be in.", "properties": { "expected_checkpoint_id": { "type": [ "string", "null" ] }, "expected_lease": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_CasWorkItemMetadataLeaseFence" }, { "type": "null" } ] }, "expected_metadata_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": [ "array", "null" ] }, "expected_prio_bucket": { "format": "int64", "type": [ "integer", "null" ] }, "expected_status": { "items": { "type": "string" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_CasWorkItemMetadataRequestSchemaVersion" }, "set_checkpoint_id": { "type": [ "string", "null" ] }, "set_metadata_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": [ "array", "null" ] }, "set_prio_bucket": { "format": "int64", "type": [ "integer", "null" ] }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "expected_status", "now_ms" ], "type": "object" }, "ReqDef_CasWorkItemMetadataRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_CausalQueryModeWire": { "description": "Which of `eg_epistemic::CausalGraph`'s two non-counterfactual queries\n`Method::CausalEstimate::do_values` feeds (EPI-P3-6).", "enum": [ "Intervene", "Observe" ], "type": "string" }, "ReqDef_CepAttrPredSpec": { "description": "STREAM \u2014 a per-event attribute predicate for a CEP matcher (CONCEPT:EG-KG.query.pipelined-execution). Mirrors\neg-stream's `AttrPredicate`, but defined HERE (pure serde, no eg-stream dep) so the\nwire stays Pi-safe; the executor maps it to eg-stream's enum behind eg-plan's\n`stream` gate.", "oneOf": [ { "additionalProperties": false, "properties": { "Eq": { "properties": { "field": { "type": "string" }, "value": true }, "required": [ "field", "value" ], "type": "object" } }, "required": [ "Eq" ], "type": "object" }, { "additionalProperties": false, "properties": { "Gt": { "properties": { "field": { "type": "string" }, "value": { "format": "double", "type": "number" } }, "required": [ "field", "value" ], "type": "object" } }, "required": [ "Gt" ], "type": "object" }, { "additionalProperties": false, "properties": { "Lt": { "properties": { "field": { "type": "string" }, "value": { "format": "double", "type": "number" } }, "required": [ "field", "value" ], "type": "object" } }, "required": [ "Lt" ], "type": "object" }, { "additionalProperties": false, "properties": { "Exists": { "properties": { "field": { "type": "string" } }, "required": [ "field" ], "type": "object" } }, "required": [ "Exists" ], "type": "object" } ] }, "ReqDef_CepMatcherSpec": { "description": "STREAM \u2014 one event matcher: an optional event `key` + attribute predicates that ALL\nmust hold (CONCEPT:EG-KG.query.pipelined-execution). Mirrors eg-stream's `EventMatcher`; pure serde here.", "properties": { "key": { "default": null, "type": [ "string", "null" ] }, "preds": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_CepAttrPredSpec" }, "type": "array" } }, "type": "object" }, "ReqDef_CepNodeSpec": { "description": "STREAM \u2014 the CEP pattern tree (CONCEPT:EG-KG.query.pipelined-execution): `Sequence` (matchers in order within\nthe window), `Within` (a duration constraint wrapping an inner pattern), `Absence`\n(`a` NOT-followed-by `b` within `within`). Mirrors eg-stream's `CepPattern`; pure\nserde \u2014 the actual NFA lives in eg-stream behind eg-plan's `stream` gate.", "oneOf": [ { "additionalProperties": false, "properties": { "Sequence": { "items": { "$ref": "#/components/schemas/ReqDef_CepMatcherSpec" }, "type": "array" } }, "required": [ "Sequence" ], "type": "object" }, { "additionalProperties": false, "properties": { "Within": { "properties": { "pattern": { "$ref": "#/components/schemas/ReqDef_CepNodeSpec" }, "within": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "within", "pattern" ], "type": "object" } }, "required": [ "Within" ], "type": "object" }, { "additionalProperties": false, "properties": { "Absence": { "properties": { "a": { "$ref": "#/components/schemas/ReqDef_CepMatcherSpec" }, "b": { "$ref": "#/components/schemas/ReqDef_CepMatcherSpec" }, "within": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "a", "b", "within" ], "type": "object" } }, "required": [ "Absence" ], "type": "object" } ] }, "ReqDef_CepPatternSpec": { "description": "STREAM \u2014 the full CEP spec carried by `Op::Cep` (CONCEPT:EG-KG.query.pipelined-execution): the `pattern` tree\nand the `window` it is evaluated over. PURE serde \u2014 the executor turns it into an\neg-stream `run(pattern, events, window)` call behind eg-plan's `stream` gate; this is\nthe wire variant.", "properties": { "pattern": { "$ref": "#/components/schemas/ReqDef_CepNodeSpec" }, "window": { "$ref": "#/components/schemas/ReqDef_CepWindowSpec" } }, "required": [ "pattern", "window" ], "type": "object" }, "ReqDef_CepWindowSpec": { "description": "STREAM \u2014 the sliding / tumbling window a CEP pattern runs over (CONCEPT:EG-KG.query.pipelined-execution).\nMirrors eg-stream's `Window`; pure serde here.", "oneOf": [ { "additionalProperties": false, "properties": { "Sliding": { "properties": { "size": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "size" ], "type": "object" } }, "required": [ "Sliding" ], "type": "object" }, { "additionalProperties": false, "properties": { "Tumbling": { "properties": { "size": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "size" ], "type": "object" } }, "required": [ "Tumbling" ], "type": "object" } ] }, "ReqDef_Certificate": { "additionalProperties": false, "description": "Everything a verifier needs, and nothing it must trust.", "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_Algorithm" }, "config": { "$ref": "#/components/schemas/ReqDef_SolverConfig" }, "incumbent": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Incumbent" }, { "type": "null" } ] }, "lower_bound": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Scalar" }, { "type": "null" } ], "description": "Certified scalar lower bound, when any bound leaf exists." }, "model_digest": { "$ref": "#/components/schemas/ReqDef_Sha256Digest" }, "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" }, "proof": { "$ref": "#/components/schemas/ReqDef_BoundProof" }, "status": { "$ref": "#/components/schemas/ReqDef_SolveStatus" } }, "required": [ "model_digest", "algorithm", "config", "status", "proof", "nodes_expanded" ], "type": "object" }, "ReqDef_ChangeCursor": { "properties": { "expected_previous": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_CursorPosition" }, { "type": "null" } ] }, "partition": { "default": "", "type": "string" }, "position": { "$ref": "#/components/schemas/ReqDef_CursorPosition" }, "source": { "type": "string" } }, "required": [ "source", "position" ], "type": "object" }, "ReqDef_ChangeEnvelope": { "properties": { "blobs": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_BlobReference" }, "type": "array" }, "commit_descriptor_ref": { "description": "Opaque `CommitDescriptor::commit_id` this envelope's mutation was\npublished under. See `commit_seq`.", "type": [ "string", "null" ] }, "commit_seq": { "description": "GOC-03 \u2014 the [`crate::commit_descriptor::CommitDescriptor::commit_seq`]\nthis envelope's mutation was published under, once the durable\ncommit-descriptor index is wired into the commit path (GOC-03-W03/W05).\nAdditive and optional so an envelope predating that wiring, or one whose\nsurface does not yet register a commit-descriptor participant, remains\nvalid; a populated value MUST be paired with `commit_descriptor_ref`\n(see `validate`) and must match a real descriptor recorded by the commit\nindex \u2014 this module does not itself construct or verify that pairing.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "content_version": { "$ref": "#/components/schemas/ReqDef_ContentVersion" }, "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ChangeCursor" }, { "type": "null" } ] }, "envelope_id": { "type": "string" }, "evidence": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_EvidenceRecord" }, "type": "array" }, "features": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_FeatureRecord" }, "type": "array" }, "lineage": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_LineageRecord" }, "type": "array" }, "mutation": { "$ref": "#/components/schemas/ReqDef_MutationBatch" }, "policies": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_PolicyRecord" }, "type": "array" }, "privacy": { "$ref": "#/components/schemas/ReqDef_PrivacyAttestation" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "envelope_id", "mutation", "content_version", "privacy" ], "type": "object" }, "ReqDef_ChannelType": { "description": "Channel type for dynamic communication.", "oneOf": [ { "const": "PeerToPeer", "description": "1:1 direct messaging between two agents.", "type": "string" }, { "const": "Group", "description": "Many-to-many group channel.", "type": "string" } ] }, "ReqDef_ClaimProvenance": { "additionalProperties": false, "description": "How a free-text task was mapped onto native task IRIs, and by what.\n\nA mapping is a CLAIM, never a proof: it is recorded with its producer so a\nrecord that leans on one is classified by its weakest premise.", "properties": { "model_profile": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, { "type": "null" } ], "default": null }, "producer": { "type": "string" }, "prompt_digest": { "default": null, "type": [ "string", "null" ] } }, "required": [ "producer" ], "type": "object" }, "ReqDef_ClaimWorkItemRequest": { "additionalProperties": false, "properties": { "fairness_group": { "type": [ "string", "null" ] }, "lease_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_tenant_in_flight": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "queue_ref": { "type": [ "string", "null" ] }, "resource_class": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ReqDef_ClaimWorkItemRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": [ "string", "null" ] }, "worker_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "worker_ref", "now_ms", "lease_ms", "max_tenant_in_flight" ], "type": "object" }, "ReqDef_ClaimWorkItemRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_ClaimedTaskMapping": { "additionalProperties": false, "description": "One claimed free-text-to-task mapping.", "properties": { "provenance": { "$ref": "#/components/schemas/ReqDef_ClaimProvenance" }, "task_iris": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_8" }, "text_digest": { "description": "`sha256:` of the free text, never the text.", "type": "string" } }, "required": [ "text_digest", "task_iris", "provenance" ], "type": "object" }, "ReqDef_ClassifyAlgorithm": { "description": "Which classifier `MineClassifyFit` fits (CONCEPT:EG-KG.mining.naive-bayes).", "oneOf": [ { "const": "gaussiannb", "description": "Gaussian Naive Bayes (default) \u2014 continuous features.", "type": "string" }, { "const": "multinomialnb", "description": "Multinomial Naive Bayes \u2014 count features.", "type": "string" }, { "const": "knn", "description": "k-nearest-neighbor majority vote.", "type": "string" }, { "const": "logistic", "description": "One-vs-rest logistic regression.", "type": "string" }, { "const": "svc", "description": "One-vs-rest linear SVM (SVC).", "type": "string" } ] }, "ReqDef_ClusterAlgorithm": { "description": "Which clustering engine `MineCluster` runs (CONCEPT:EG-KG.mining.dbscan-density).", "enum": [ "dbscan", "hierarchical", "gmm", "kmedoids" ], "type": "string" }, "ReqDef_Coefficient": { "description": "An objective coefficient. `Unknown` is never read as zero: a level that\nholds unknown coefficients ranks every selection of an unknown-cost\nvariable below every all-known selection (the \"unknown tier\").", "oneOf": [ { "enum": [ "unknown" ], "type": "string" }, { "additionalProperties": false, "properties": { "known": { "format": "int64", "type": "integer" } }, "required": [ "known" ], "type": "object" } ] }, "ReqDef_ColdStart": { "description": "What the engine does before a head is calibrated.", "oneOf": [ { "additionalProperties": false, "description": "Only the deterministic constraint ladder runs.", "properties": { "mode": { "const": "deterministic_only", "type": "string" } }, "required": [ "mode" ], "type": "object" }, { "additionalProperties": false, "description": "Scores are produced and labelled uncalibrated; nothing acts on them.", "properties": { "mode": { "const": "advisory_uncalibrated", "type": "string" } }, "required": [ "mode" ], "type": "object" }, { "additionalProperties": false, "description": "Bounded exploration is allowed within `budget`.", "properties": { "budget": { "$ref": "#/components/schemas/ReqDef_ExplorationBudget" }, "mode": { "const": "explore", "type": "string" } }, "required": [ "mode", "budget" ], "type": "object" } ] }, "ReqDef_CommitOutcomeBundle": { "additionalProperties": false, "description": "The one atomic terminal result/artifact/provenance/outbox unit a WorkItem\ncommits under (lane doc \"Schemas/APIs\"). `work_item_id`/`fence_token` bind\nthis bundle to the SAME lease epoch/fencing token\n`Method::CommitWorkItemResult` already CAS's on\n(`src/server/mutation_batch.rs`'s `WorkItemBatchIdentity`) \u2014 a stale or\nduplicate writer is rejected there today, and this bundle's eventual\nnative applier must reuse that identical fencing rather than inventing a\nsecond one.", "properties": { "artifacts": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_OutcomeArtifactRef" }, "type": "array" }, "capability_digest": { "description": "Digest of the capability/tool catalog snapshot the run executed\nagainst (GOC-19/GOC-21 currency binding).", "type": "string" }, "catalog_digest": { "type": "string" }, "completeness": { "$ref": "#/components/schemas/ReqDef_OutcomeCompleteness" }, "delegation_id": { "description": "Delegation identity shared by the admission WorkItem and all terminal\nreceipt nodes. This is not a second commit identity; the native\nWorkItem batch/outbox remains authoritative.", "type": "string" }, "delegator_id": { "description": "Authenticated delegator (A), distinct from the selected Agent Library\nentry (B) and from the worker holding the lease.", "type": "string" }, "event_sequence": { "description": "Monotonic, process-anchored sequence for this run\n(`observability/trace_ontology.next_event_sequence()`'s existing\nauthority \u2014 this bundle does not mint a second one).", "format": "uint64", "minimum": 0, "type": "integer" }, "executor_lease_actor": { "description": "The worker identity that held the lease for this terminal transition.", "type": "string" }, "fence_token": { "description": "The lease fencing token this bundle commits under \u2014 MUST match the\ndurable WorkItem row's current `fencing_token`; a stale value is\nrejected exactly like `CommitWorkItemResult`'s existing fencing CAS.", "format": "uint64", "minimum": 0, "type": "integer" }, "langfuse_observation_refs": { "default": [], "description": "Opaque Langfuse observation receipts attached to this same run. The\nobservation store is a projection and never a second authority.", "items": { "$ref": "#/components/schemas/ReqDef_LangfuseObservationRef" }, "type": "array" }, "missing_refs": { "default": [], "description": "Names of the specific required components missing when\n`completeness != Complete` (e.g. `\"tool_call:3\"`,\n`\"outcome_evaluation\"`). Empty only when `completeness == Complete`.", "items": { "type": "string" }, "type": "array" }, "model_digest": { "type": "string" }, "outbox_id": { "description": "Identity of the one durable outbox row this bundle's commit publishes.", "type": "string" }, "outcome": { "description": "The exact terminal outcome supplied to `CommitWorkItemResult`.", "type": "string" }, "outcome_ref": { "description": "Opaque reference to the durable OutcomeEvaluation node.", "type": "string" }, "policy_digest": { "type": "string" }, "result_digest": { "description": "sha256 digest of the canonical encoded result body, present whenever\n`result_ref` is. A repair/reconcile pass may never change this once\ncommitted (lane doc: \"Repair is idempotent and cannot alter result\ndigest\").", "type": [ "string", "null" ] }, "result_ref": { "description": "Opaque, immutable reference to the terminal result body. Never the\nbody itself \u2014 mirrors `Method::CommitWorkItemResult`'s existing\n`result_ref: Option`.", "type": [ "string", "null" ] }, "run_id": { "description": "Opaque run identity this bundle's RunTrace/ToolCall/OutcomeEvaluation\nare keyed under (`observability/trace_ontology.py`'s trace id family).", "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "selected_agent_id": { "description": "Retained Agent Library identity selected at admission (B).", "type": "string" }, "tool_call_refs": { "default": [], "description": "Opaque references to the durable ToolCall nodes this bundle's\nprovenance batch wrote, in call order. Never synthesized from a\nprogress receipt or free-text log \u2014 every entry names a real node this\nSAME bundle committed.", "items": { "type": "string" }, "type": "array" }, "trace_ref": { "description": "Opaque reference to the durable RunTrace node this bundle's provenance\nbatch wrote (`observability/trace_ontology.py`'s trace node id).", "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "delegation_id", "delegator_id", "selected_agent_id", "executor_lease_actor", "outcome", "work_item_id", "fence_token", "run_id", "trace_ref", "outcome_ref", "capability_digest", "catalog_digest", "policy_digest", "model_digest", "event_sequence", "completeness", "outbox_id" ], "type": "object" }, "ReqDef_CommittedVersion": { "description": "Exact authoritative version transition committed with a durable record.", "oneOf": [ { "enum": [ "none" ], "type": "string" }, { "additionalProperties": false, "properties": { "graph": { "properties": { "source": { "format": "uint64", "minimum": 0, "type": "integer" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source", "target" ], "type": "object" } }, "required": [ "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "native": { "properties": { "source": { "format": "uint64", "minimum": 0, "type": "integer" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source", "target" ], "type": "object" } }, "required": [ "native" ], "type": "object" } ] }, "ReqDef_CommunityAlgorithm": { "description": "Which existing GDS kernel `MineCommunity` wraps (CONCEPT:EG-KG.mining.community-writeback).", "enum": [ "louvain", "labelprop" ], "type": "string" }, "ReqDef_CommunityQualityFunction": { "description": "Quality (objective) function `CommunityDetectEphemeral` optimizes (EH-314) \u2014\nthe wire mirror of `eg_compute::graph_algos::QualityFunction`, kept as its\nown type here rather than reused directly so `eg-types` never depends on\n`eg-compute`; the server handler maps one to the other\n(`src/server/handlers/graph_ops/algorithms.rs`), the same split\n`CommunityAlgorithm`/`to_community_algo` already use for `MineCommunity`.\n`Modularity` (the pre-EH-314 behaviour) has a well-known resolution limit\non large graphs; `Cpm` (Constant Potts Model) removes it \u2014 see EG's own\n`QualityFunction` doc for the exact math. Defaulting to `Modularity` is\nwhat keeps a caller that sends no `quality` byte-identical to the\npre-EH-314 kernel.\n\nNot gated behind `mining`/`ml-pipeline` (unlike this file's other wire\nenums) \u2014 `CommunityDetectEphemeral` is a base compute method, always\ncompiled.", "enum": [ "modularity", "cpm" ], "type": "string" }, "ReqDef_ComponentDependency": { "additionalProperties": false, "description": "One pinned requirement of a component.\n\nThe `kind` is carried alongside the id so a dependency can be type-checked\nwithout resolving it: a [`AgentComponentKind::Tool`] whose input schema\npoints at a [`AgentComponentKind::ModelProfile`] is rejected structurally,\nnot at run time. The `definition_digest` pins the exact revision, so a\ndependency cannot silently change under a component that was reviewed\nagainst it.", "properties": { "component_id": { "type": "string" }, "definition_digest": { "type": "string" }, "kind": { "$ref": "#/components/schemas/ReqDef_AgentComponentKind" } }, "required": [ "component_id", "kind", "definition_digest" ], "type": "object" }, "ReqDef_ComponentProvenance": { "description": "Where a component was ingested FROM.\n\nSource packages and MCP servers remain the origin of skills, tools, prompts\nand resources; EG is where they are recorded so they can be queried. That\nsplit only works if the origin travels with the record: without it, \"which\nagents break if this MCP server changes?\" cannot be answered, and a\nre-ingest cannot tell an updated component from a new one.", "oneOf": [ { "description": "Declared directly in EG; no upstream system owns it.", "properties": { "origin": { "const": "native", "type": "string" } }, "required": [ "origin" ], "type": "object" }, { "description": "Ingested from a source package (an `agent-packages/*` distribution).", "properties": { "origin": { "const": "source_package", "type": "string" }, "package_id": { "type": "string" }, "package_version": { "type": "string" } }, "required": [ "origin", "package_id", "package_version" ], "type": "object" }, { "description": "Ingested by listing an MCP server's surface.\n\n`server` PINS the [`AgentComponentKind::McpServer`] record by\n`(id, kind, digest)`, so the server is one node every tool/prompt/\nresource it serves hangs off AND the server a record claims is the\nserver that was reviewed. It was a bare `server_component_id: String`\n-- the last unpinned cross-record reference in this contract -- and an\nid alone is unresolvable in principle: no admission check can tell an\ningest that named the reviewed server from one that named a different\nserver, or a republished one whose tool surface has since moved.\n\nA full [`ComponentDependency`] rather than an id+digest pair, because\nthe kind belongs inside the pin exactly as it does everywhere else\nhere: resolution is by `(id, kind, digest)`, and carrying the kind is\nwhat lets admission refuse a provenance that names a `Toolset` where\nthe serving server belongs instead of discovering it at execution.", "properties": { "origin": { "const": "mcp_server", "type": "string" }, "server": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "upstream_name": { "description": "The name the server itself uses. Distinct from `component_id`,\nwhich is EG-scoped: two servers may both expose a `search` tool.", "type": "string" } }, "required": [ "origin", "server", "upstream_name" ], "type": "object" } ] }, "ReqDef_ConnectorPackBindRequest": { "additionalProperties": false, "description": "Bind a connector to the importer allowed to publish its packs.", "properties": { "connector": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "importer": { "type": "string" } }, "required": [ "context", "connector", "importer" ], "type": "object" }, "ReqDef_ConnectorPackImportRequest": { "additionalProperties": false, "description": "Import one pack atomically.", "properties": { "allow_mass_withdrawal": { "default": false, "description": "An import that withdraws most of a connector's surface is usually a\nbroken build, not an intention, so it needs a second, administrative\ngrant rather than the ordinary pack-control one.", "type": "boolean" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "expected_head": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_PackHeadRef" }, { "type": "null" } ], "default": null, "description": "Compare-and-set against the head the caller last saw." }, "index": { "$ref": "#/components/schemas/ReqDef_ConnectorPackIndex" } }, "required": [ "context", "index" ], "type": "object" }, "ReqDef_ConnectorPackIndex": { "additionalProperties": false, "description": "One connector's complete published surface.", "properties": { "archive": { "$ref": "#/components/schemas/ReqDef_PackArchiveRef" }, "catalog": { "$ref": "#/components/schemas/ReqDef_McpCatalogSnapshotBinding", "description": "The exact served generation/digest observed by the catalog lister." }, "connector": { "type": "string" }, "entries": { "$ref": "#/components/schemas/ReqDef_BoundedVec_PackEntry_1024" }, "pack_digest": { "$ref": "#/components/schemas/ReqDef_Digest256", "description": "The digest of everything above, recomputed by the engine before\nanything is committed." }, "producer": { "$ref": "#/components/schemas/ReqDef_PackProducer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "server": { "$ref": "#/components/schemas/ReqDef_PackEntry", "description": "The MCP server entry itself. Every other entry hangs off it." }, "server_package_version": { "type": "string" } }, "required": [ "schema_version", "connector", "server", "server_package_version", "archive", "entries", "producer", "catalog", "pack_digest" ], "type": "object" }, "ReqDef_ConnectorPackOp": { "description": "Every connector-pack operation.", "oneOf": [ { "additionalProperties": false, "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_ConnectorPackStatusRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Boxed: an import carries a whole pack index and would otherwise set the\nsize of every `Method`.", "properties": { "op": { "const": "import", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_ConnectorPackImportRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "bind", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_ConnectorPackBindRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "unbind", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_ConnectorPackUnbindRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_ConnectorPackRetireRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "reproject", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_ConnectorPackReprojectRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "reconcile_bodies", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_ConnectorPackReconcileRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ReqDef_ConnectorPackReconcileRequest": { "additionalProperties": false, "description": "Sweep engine-owned bodies no revision holds any more.", "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" } }, "required": [ "context" ], "type": "object" }, "ReqDef_ConnectorPackReprojectRequest": { "additionalProperties": false, "description": "Re-project the current head into the graph.", "properties": { "connector": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" } }, "required": [ "context", "connector" ], "type": "object" }, "ReqDef_ConnectorPackRetireRequest": { "additionalProperties": false, "description": "Permanently retire named entries of a connector.", "properties": { "connector": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "uris": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_1024" } }, "required": [ "context", "connector", "uris" ], "type": "object" }, "ReqDef_ConnectorPackStatusRequest": { "additionalProperties": false, "description": "Read one connector's pack state.", "properties": { "connector": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "connector" ], "type": "object" }, "ReqDef_ConnectorPackUnbindRequest": { "additionalProperties": false, "description": "Remove a connector's importer binding.", "properties": { "connector": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" } }, "required": [ "context", "connector" ], "type": "object" }, "ReqDef_ConstraintBody": { "description": "The typed body of a constraint.", "oneOf": [ { "additionalProperties": false, "description": "A general linear row with integer coefficients.", "properties": { "linear": { "additionalProperties": false, "properties": { "relation": { "$ref": "#/components/schemas/ReqDef_Relation" }, "rhs": { "format": "int64", "type": "integer" }, "terms": { "items": { "$ref": "#/components/schemas/ReqDef_Term" }, "type": "array" } }, "required": [ "terms", "relation", "rhs" ], "type": "object" } }, "required": [ "linear" ], "type": "object" }, { "additionalProperties": false, "description": "`antecedent \u21d2 consequent` (`consequent \u2212 antecedent \u2265 0`).", "properties": { "implication": { "additionalProperties": false, "properties": { "antecedent": { "$ref": "#/components/schemas/ReqDef_VarId" }, "consequent": { "$ref": "#/components/schemas/ReqDef_VarId" } }, "required": [ "antecedent", "consequent" ], "type": "object" } }, "required": [ "implication" ], "type": "object" }, { "additionalProperties": false, "description": "`antecedent \u21d2 at least one consequent` (a conditional covering row).", "properties": { "implies_any": { "additionalProperties": false, "properties": { "antecedent": { "$ref": "#/components/schemas/ReqDef_VarId" }, "consequents": { "items": { "$ref": "#/components/schemas/ReqDef_VarId" }, "type": "array" } }, "required": [ "antecedent", "consequents" ], "type": "object" } }, "required": [ "implies_any" ], "type": "object" }, { "additionalProperties": false, "description": "Exactly one of `vars` is selected.", "properties": { "exactly_one": { "additionalProperties": false, "properties": { "vars": { "items": { "$ref": "#/components/schemas/ReqDef_VarId" }, "type": "array" } }, "required": [ "vars" ], "type": "object" } }, "required": [ "exactly_one" ], "type": "object" }, { "additionalProperties": false, "description": "At most `k` of `vars` are selected.", "properties": { "at_most": { "additionalProperties": false, "properties": { "k": { "format": "uint32", "minimum": 0, "type": "integer" }, "vars": { "items": { "$ref": "#/components/schemas/ReqDef_VarId" }, "type": "array" } }, "required": [ "vars", "k" ], "type": "object" } }, "required": [ "at_most" ], "type": "object" }, { "additionalProperties": false, "description": "At least `k` of `vars` are selected (`k = 1` is a covering row).", "properties": { "at_least": { "additionalProperties": false, "properties": { "k": { "format": "uint32", "minimum": 0, "type": "integer" }, "vars": { "items": { "$ref": "#/components/schemas/ReqDef_VarId" }, "type": "array" } }, "required": [ "vars", "k" ], "type": "object" } }, "required": [ "at_least" ], "type": "object" }, { "additionalProperties": false, "description": "`var` is pinned to `value`.", "properties": { "fix": { "additionalProperties": false, "properties": { "value": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ReqDef_VarId" } }, "required": [ "var", "value" ], "type": "object" } }, "required": [ "fix" ], "type": "object" } ] }, "ReqDef_ConstraintSpec": { "additionalProperties": false, "description": "A labelled constraint. The label names the constraint in explanations\n(for example an infeasibility core).", "properties": { "body": { "$ref": "#/components/schemas/ReqDef_ConstraintBody" }, "label": { "type": "string" } }, "required": [ "label", "body" ], "type": "object" }, "ReqDef_ContentVersion": { "properties": { "digest": { "type": "string" }, "digest_algorithm": { "type": "string" }, "object_id": { "type": "string" }, "previous_digest": { "type": [ "string", "null" ] }, "source_version": { "$ref": "#/components/schemas/ReqDef_ContentVersionPosition", "description": "Typed source-side version. It is never compared lexically." } }, "required": [ "object_id", "digest_algorithm", "digest", "source_version" ], "type": "object" }, "ReqDef_ContentVersionPosition": { "oneOf": [ { "properties": { "kind": { "const": "sequence", "type": "string" }, "value": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "timestamp_millis", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "opaque", "type": "string" }, "value": { "properties": { "value": { "type": "string" }, "version_type": { "type": "string" } }, "required": [ "version_type", "value" ], "type": "object" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ReqDef_ControlLeaseTarget": { "description": "The state a transition moves a lease to.", "enum": [ "consumed", "revoked", "expired" ], "type": "string" }, "ReqDef_CostBudget": { "additionalProperties": false, "description": "A currency-denominated ceiling on the selection's declared cost.", "properties": { "currency": { "description": "ISO 4217, exactly three ASCII uppercase letters.", "type": "string" }, "max_micros": { "format": "uint64", "minimum": 0, "type": "integer" }, "strict": { "description": "Strict means an unknown cost is excluded rather than ranked below.", "type": "boolean" } }, "required": [ "currency", "max_micros", "strict" ], "type": "object" }, "ReqDef_CostFacts": { "additionalProperties": false, "description": "What one invocation costs, plus who says so and how strongly.", "properties": { "currency": { "description": "ISO 4217: exactly three ASCII uppercase letters.", "type": "string" }, "input_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "per_call_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "price_source": { "$ref": "#/components/schemas/ReqDef_PriceSource" }, "quality": { "$ref": "#/components/schemas/ReqDef_FactQuality" } }, "required": [ "currency", "price_source", "quality" ], "type": "object" }, "ReqDef_CoverageDerivation": { "additionalProperties": false, "description": "How one required capability is covered, step by step.", "properties": { "chain": { "$ref": "#/components/schemas/ReqDef_BoundedVec_DerivationEdge_16" }, "covered_by": { "default": null, "description": "The component that covers it, or `None` when nothing does.", "type": [ "string", "null" ] }, "required": { "type": "string" } }, "required": [ "required", "chain" ], "type": "object" }, "ReqDef_CursorPosition": { "oneOf": [ { "properties": { "kind": { "const": "sequence", "type": "string" }, "value": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "timestamp_millis", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "description": "Provider-defined cursors are never ordered lexically.", "properties": { "kind": { "const": "opaque", "type": "string" }, "value": { "properties": { "cursor_type": { "description": "Stable provider cursor type (for example `page_token_v2`).", "type": "string" }, "value": { "type": "string" } }, "required": [ "cursor_type", "value" ], "type": "object" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ReqDef_CypherMode": { "description": "Required execution authority for a Cypher statement.\n\nThe caller must declare whether a statement is a read or mutation. The\nserver parses the statement and rejects a mismatch, so a mutation can never\nobtain read authorization by hiding a keyword in comments, literals, or an\nunsupported clause.", "enum": [ "read", "write" ], "type": "string" }, "ReqDef_DecideRequest": { "additionalProperties": false, "description": "One statistical decision request.\nNot `Eq`, for the same reason [`CandidateSource`] is not.", "properties": { "candidates": { "$ref": "#/components/schemas/ReqDef_CandidateSource" }, "feature_schema": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "head": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "Absent asks for the deterministic ladder only." }, "max_records": { "default": null, "description": "At most [`MAX_DECIDE_RECORDS`].", "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] }, "params": { "$ref": "#/components/schemas/ReqDef_BoundedVec_TypedParam_64", "default": [], "description": "Sorted by name and unique." }, "policy": { "$ref": "#/components/schemas/ReqDef_DecisionPolicyRef" }, "question": { "$ref": "#/components/schemas/ReqDef_StatisticalQuestion" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "question", "candidates", "feature_schema", "policy" ], "type": "object" }, "ReqDef_DecisionCommitRequest": { "additionalProperties": false, "description": "Commit one assembly record as a durable `DecisionRecord` component.", "properties": { "context": { "$ref": "#/components/schemas/ReqDef_AgentLibraryMutationContext" }, "expected_catalog_digest": { "description": "Compare-and-set: the catalog digest the record was decided against.", "type": "string" }, "record": { "$ref": "#/components/schemas/ReqDef_DecisionRecord", "description": "This wave commits library-sourced v1 records only." } }, "required": [ "context", "record", "expected_catalog_digest" ], "type": "object" }, "ReqDef_DecisionEvalOp": { "description": "Evaluate a candidate decision head.", "oneOf": [ { "additionalProperties": false, "description": "Enqueue the job. The only mutating op. Boxed: a submission\ncarries its whole labelled dataset.", "properties": { "op": { "const": "submit", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_DecisionEvalRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Read one submitted job's row.", "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_DecisionJobStatusRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ReqDef_DecisionEvalRequest": { "additionalProperties": false, "description": "Evaluate a candidate head against recorded decisions.", "properties": { "approved_commit_principals": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64", "default": [], "description": "Commit principals whose bandit records may be evaluated on." }, "candidate": { "$ref": "#/components/schemas/ReqDef_EvalCandidate" }, "dataset": { "$ref": "#/components/schemas/ReqDef_LabelledDataset", "description": "The labelled items the candidate is evaluated on." }, "estimators": { "$ref": "#/components/schemas/ReqDef_BoundedVec_OpeEstimatorKind_8" }, "gold_set_digest": { "default": null, "type": [ "string", "null" ] }, "idempotency_key": { "type": "string" }, "policy": { "$ref": "#/components/schemas/ReqDef_DecisionPolicyRef" }, "tenant_id": { "type": "string" }, "window": { "$ref": "#/components/schemas/ReqDef_RecordWindow" } }, "required": [ "tenant_id", "idempotency_key", "candidate", "policy", "estimators", "window", "dataset" ], "type": "object" }, "ReqDef_DecisionFitOp": { "description": "Fit a decision head.", "oneOf": [ { "additionalProperties": false, "description": "Enqueue the job. The only mutating op. Boxed: a submission\ncarries its whole labelled dataset.", "properties": { "op": { "const": "submit", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_DecisionFitRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Read one submitted job's row.", "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_DecisionJobStatusRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ReqDef_DecisionFitRequest": { "additionalProperties": false, "description": "Fit a decision head into a draft artifact.", "properties": { "approved_commit_principals": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64", "default": [], "description": "Commit principals whose bandit records may train. Empty admits none." }, "dataset": { "$ref": "#/components/schemas/ReqDef_LabelledDataset", "description": "The labelled items, pinned: a full-label regime's `gold_set_digest`\nmust equal this dataset's digest." }, "feature_schema": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "head_kind": { "$ref": "#/components/schemas/ReqDef_HeadKind" }, "idempotency_key": { "type": "string" }, "label_regime": { "$ref": "#/components/schemas/ReqDef_LabelRegime" }, "optimiser": { "$ref": "#/components/schemas/ReqDef_OptimiserSpec" }, "policy": { "$ref": "#/components/schemas/ReqDef_DecisionPolicyRef" }, "tenant_id": { "type": "string" }, "window": { "$ref": "#/components/schemas/ReqDef_RecordWindow" } }, "required": [ "tenant_id", "idempotency_key", "head_kind", "feature_schema", "policy", "label_regime", "window", "optimiser", "dataset" ], "type": "object" }, "ReqDef_DecisionInputs": { "additionalProperties": false, "description": "The complete input set, digested as `inputs_digest`.", "properties": { "candidates": { "$ref": "#/components/schemas/ReqDef_BoundedVec_CandidateFacts_64", "description": "Sorted by `component_id`, so the digest does not depend on read order." }, "catalog_digest": { "type": "string" }, "ontology_digest": { "type": "string" }, "policy": { "$ref": "#/components/schemas/ReqDef_DecisionPolicy" }, "policy_digest": { "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_AssemblyRequest" }, "solver": { "$ref": "#/components/schemas/ReqDef_SolverIdentity" }, "templates": { "$ref": "#/components/schemas/ReqDef_BoundedVec_TemplateFacts_8", "default": [], "description": "The graph templates the request named, read at their pinned revisions.\nEmpty asks for a one-agent graph." } }, "required": [ "request", "candidates", "ontology_digest", "policy", "policy_digest", "catalog_digest", "solver" ], "type": "object" }, "ReqDef_DecisionJobStatusRequest": { "additionalProperties": false, "description": "Ask after one submitted job.", "properties": { "job_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "job_id" ], "type": "object" }, "ReqDef_DecisionOutcome": { "description": "The conclusion of one assembly decision.", "oneOf": [ { "additionalProperties": false, "description": "An assembly, with the certificate that proves it optimal. Boxed: the\ncertificate's own proof tree dwarfs every other field this enum\ncarries (320 bytes vs. `Abstained`'s 24), so every `DecisionOutcome`\nvalue would otherwise pay `Solved`'s size even when it holds the far\nsmaller `Abstained` variant.", "properties": { "certificate": { "$ref": "#/components/schemas/ReqDef_Certificate" }, "graph_digest": { "type": "string" }, "outcome": { "const": "solved", "type": "string" }, "slots": { "$ref": "#/components/schemas/ReqDef_BoundedVec_SlotAssignment_64" } }, "required": [ "outcome", "graph_digest", "slots", "certificate" ], "type": "object" }, { "additionalProperties": false, "description": "No assembly, and exactly why.", "properties": { "outcome": { "const": "abstained", "type": "string" }, "reasons": { "$ref": "#/components/schemas/ReqDef_BoundedVec_AbstainReason_64" } }, "required": [ "outcome", "reasons" ], "type": "object" } ] }, "ReqDef_DecisionPolicy": { "additionalProperties": false, "description": "The complete decision policy.", "properties": { "a2a_requires_observation": { "description": "Whether an A2A agent card needs an observation before it is selectable.", "type": "boolean" }, "accepted_gap": { "$ref": "#/components/schemas/ReqDef_Scalar", "description": "Largest objective gap accepted instead of reporting budget exhaustion." }, "cold_start": { "$ref": "#/components/schemas/ReqDef_ColdStart" }, "max_nogood_rounds": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_slots": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_templates": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_why_not_per_slot": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" }, "objective": { "$ref": "#/components/schemas/ReqDef_ObjectiveOrder" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "statistical": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_StatisticalPolicy" }, { "type": "null" } ], "default": null }, "unknown_cost": { "$ref": "#/components/schemas/ReqDef_UnknownCostRule" } }, "required": [ "schema_version", "objective", "unknown_cost", "accepted_gap", "node_budget", "max_templates", "max_slots", "max_nogood_rounds", "max_why_not_per_slot", "a2a_requires_observation", "cold_start" ], "type": "object" }, "ReqDef_DecisionPolicyRef": { "description": "Which policy decides this request.", "oneOf": [ { "additionalProperties": false, "description": "The engine default policy.", "properties": { "policy": { "const": "default", "type": "string" } }, "required": [ "policy" ], "type": "object" }, { "additionalProperties": false, "description": "A published `DecisionPolicy` component, pinned by revision digest.", "properties": { "component": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "policy": { "const": "pinned", "type": "string" } }, "required": [ "policy", "component" ], "type": "object" } ] }, "ReqDef_DecisionQuestion": { "description": "The question a record answers. One variant in this wave; the tag exists so\na later question does not have to break the record shape.", "enum": [ "assemble" ], "type": "string" }, "ReqDef_DecisionRecord": { "additionalProperties": false, "description": "One assembly decision, in full.", "properties": { "caller_principal": { "description": "Privacy-safe persistence id of the caller, never a display name.", "type": "string" }, "candidate_source": { "$ref": "#/components/schemas/ReqDef_CandidateSourceRecord" }, "created_at_ms": { "description": "Recorded, and never read by the math.", "format": "uint64", "minimum": 0, "type": "integer" }, "derivation_class": { "$ref": "#/components/schemas/ReqDef_DerivationClass" }, "derivations": { "$ref": "#/components/schemas/ReqDef_BoundedVec_CoverageDerivation_32" }, "eliminated": { "$ref": "#/components/schemas/ReqDef_BoundedVec_Elimination_64" }, "evidence_class": { "$ref": "#/components/schemas/ReqDef_EvidenceClass" }, "inputs": { "$ref": "#/components/schemas/ReqDef_DecisionInputs" }, "inputs_digest": { "type": "string" }, "outcome": { "$ref": "#/components/schemas/ReqDef_DecisionOutcome" }, "premises": { "$ref": "#/components/schemas/ReqDef_BoundedVec_PremiseRef_1024" }, "question": { "$ref": "#/components/schemas/ReqDef_DecisionQuestion" }, "record_digest": { "type": "string" }, "record_id": { "type": "string" }, "resolution_kind": { "$ref": "#/components/schemas/ReqDef_ResolutionKind" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" }, "trace_fidelity": { "$ref": "#/components/schemas/ReqDef_TraceFidelity" }, "why_not": { "$ref": "#/components/schemas/ReqDef_BoundedVec_WhyNot_64" } }, "required": [ "schema_version", "record_id", "tenant_id", "caller_principal", "created_at_ms", "question", "candidate_source", "inputs", "inputs_digest", "resolution_kind", "evidence_class", "derivation_class", "trace_fidelity", "premises", "eliminated", "derivations", "outcome", "why_not", "record_digest" ], "type": "object" }, "ReqDef_DecisionTree": { "properties": { "nodes": { "items": { "$ref": "#/components/schemas/ReqDef_TreeNode" }, "type": "array" } }, "required": [ "nodes" ], "type": "object" }, "ReqDef_DeclaredCost": { "additionalProperties": false, "description": "What one invocation costs, exactly, in a named currency.\n\nInteger micros, never a float: a budget comparison that depends on binary\nrounding is a budget that decides differently on two hosts. The same\nshape a connector pack entry declares for itself\n([`crate::connector_pack::PackCost`]) \u2014 one owner for \"what does this\ninvocation cost\", whether the number arrived via a pack import or was\notherwise declared.", "properties": { "currency": { "description": "ISO 4217: exactly three ASCII uppercase letters.", "type": "string" }, "input_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "per_call_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "currency" ], "type": "object" }, "ReqDef_DeclaredLatency": { "additionalProperties": false, "description": "A publisher's declared latency profile.", "properties": { "p50_ms": { "format": "uint32", "minimum": 0, "type": "integer" }, "p95_ms": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "p50_ms", "p95_ms" ], "type": "object" }, "ReqDef_DelegationTarget": { "description": "What a delegation runs.\n\n# Why one delegation, not one per node\n\nA graph delegation admits exactly ONE work item. The child agent runs are\nthe executor's business, bounded by the graph's own composed ceiling.\n\nThe alternative -- admitting one work item per node -- was rejected because\n`max_tenant_in_flight` would then make a graph UNSCHEDULABLE whenever its\nnode count exceeded the tenant's limit: the parent would hold a slot while\nwaiting for children that cannot get one. That is a deadlock, not a\nthrottle.\n\nSo the two bounds govern two different things, and both are needed:\n\n* `max_tenant_in_flight` bounds how many DELEGATIONS a tenant may have in\n flight;\n* `composed_work_ceiling` bounds what one delegation may do INTERNALLY.\n\nWithout the second, a graph would be a way to escape the first by fanning\nout. `MAX_COMPOSITION_WORK` is the global cap that makes the escape\nimpossible rather than merely discouraged.", "oneOf": [ { "description": "One published agent (layer 2).", "properties": { "entry": { "$ref": "#/components/schemas/ReqDef_AgentLibraryEntryRef" }, "target": { "const": "agent", "type": "string" } }, "required": [ "target", "entry" ], "type": "object" }, { "description": "One published agent graph -- a team (layer 3).", "properties": { "graph": { "$ref": "#/components/schemas/ReqDef_AgentGraphEntryRef", "description": "Boxed: a graph ref is the larger variant, and an unboxed enum pays\nits size on every delegation including single-agent ones." }, "target": { "const": "graph", "type": "string" } }, "required": [ "target", "graph" ], "type": "object" } ] }, "ReqDef_DerivationClass": { "description": "How the derivation itself was produced. Only checkable derivations are\nadmitted in this wave, so the enum has one arm and a name.", "enum": [ "proof" ], "type": "string" }, "ReqDef_DerivationEdge": { "additionalProperties": false, "description": "One `narrower \u2291 broader` step of a coverage chain.", "properties": { "broader": { "type": "string" }, "class": { "$ref": "#/components/schemas/ReqDef_PremiseClass" }, "narrower": { "type": "string" }, "source": { "$ref": "#/components/schemas/ReqDef_EdgeSource" } }, "required": [ "narrower", "broader", "source", "class" ], "type": "object" }, "ReqDef_DevelopmentLaneCleanupCompleteRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_work_item_fence": { "type": "string" }, "cleanup_work_item_id": { "type": "string" }, "expected_hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "removal_proof_ref": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneCleanupCompleteRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "cleanup_work_item_id", "cleanup_work_item_fence", "cleanup_attempt", "cleanup_lease_epoch", "cleanup_fencing_token", "hold_id", "expected_hold_revision", "removal_proof_ref", "idempotency_key", "now_ms" ], "type": "object" }, "ReqDef_DevelopmentLaneCleanupCompleteRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneFinishRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneFinishRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "terminal_state": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneFinishRequestTerminalState" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "hold_id", "expected_hold_revision", "terminal_state", "idempotency_key", "now_ms" ], "type": "object" }, "ReqDef_DevelopmentLaneFinishRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneFinishRequestTerminalState": { "enum": [ "succeeded", "failed", "cancelled", "dead_letter" ], "type": "string" }, "ReqDef_DevelopmentLaneIntent": { "additionalProperties": false, "properties": { "base_ref": { "type": "string" }, "base_sha": { "type": "string" }, "branch": { "type": "string" }, "fairness_group": { "type": "string" }, "host_ref": { "type": "string" }, "host_target_alias": { "type": [ "string", "null" ] }, "host_target_kind": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneIntentHostTargetKind" }, "input_fingerprint": { "type": "string" }, "lane_id": { "type": "string" }, "owner_id": { "type": "string" }, "predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "quota_policy_name": { "type": "string" }, "quota_policy_version": { "type": "string" }, "repository_id": { "type": "string" }, "request_id": { "type": "string" }, "resource_reservation_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneIntentSchemaVersion" }, "session_id": { "type": "string" }, "tenant_ref": { "type": "string" }, "ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_ref": { "type": "string" }, "worktree_locator": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "request_id", "lane_id", "repository_id", "base_ref", "base_sha", "branch", "host_target_kind", "host_ref", "resource_reservation_id", "workspace_ref", "worktree_locator", "owner_id", "session_id", "fairness_group", "quota_policy_name", "quota_policy_version", "predicted_disk_bytes", "ttl_ms", "input_fingerprint" ], "type": "object" }, "ReqDef_DevelopmentLaneIntentHostTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ReqDef_DevelopmentLaneIntentSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneObserveRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "observation_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneObserveRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "hold_id", "expected_hold_revision", "observed_disk_bytes", "observation_revision", "idempotency_key", "now_ms" ], "type": "object" }, "ReqDef_DevelopmentLaneObserveRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneQueryRequest": { "additionalProperties": false, "properties": { "hold_id": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneQueryRequestSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "hold_id", "now_ms" ], "type": "object" }, "ReqDef_DevelopmentLaneQueryRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneQuotaPolicy": { "additionalProperties": false, "properties": { "drain_only": { "type": "boolean" }, "global_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_observation_staleness_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "min_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_name": { "type": "string" }, "policy_version": { "type": "string" }, "repository_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneQuotaPolicySchemaVersion" }, "session_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "policy_name", "policy_version", "tenant_count_limit", "owner_count_limit", "session_count_limit", "workspace_count_limit", "repository_count_limit", "host_count_limit", "global_count_limit", "tenant_predicted_disk_bytes", "owner_predicted_disk_bytes", "session_predicted_disk_bytes", "workspace_predicted_disk_bytes", "repository_predicted_disk_bytes", "host_predicted_disk_bytes", "global_predicted_disk_bytes", "tenant_observed_disk_bytes", "owner_observed_disk_bytes", "session_observed_disk_bytes", "workspace_observed_disk_bytes", "repository_observed_disk_bytes", "host_observed_disk_bytes", "global_observed_disk_bytes", "tenant_retained_disk_bytes", "owner_retained_disk_bytes", "session_retained_disk_bytes", "workspace_retained_disk_bytes", "repository_retained_disk_bytes", "host_retained_disk_bytes", "global_retained_disk_bytes", "min_ttl_ms", "max_ttl_ms", "max_observation_staleness_ms", "drain_only" ], "type": "object" }, "ReqDef_DevelopmentLaneQuotaPolicySchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneQuotaUpdateRequest": { "additionalProperties": false, "properties": { "expected_policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_policy_version": { "type": [ "string", "null" ] }, "idempotency_key": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneQuotaPolicy" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneQuotaUpdateRequestSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "policy", "expected_policy_revision", "idempotency_key", "now_ms" ], "type": "object" }, "ReqDef_DevelopmentLaneQuotaUpdateRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneRenewRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneRenewRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "hold_id", "expected_hold_revision", "ttl_ms", "idempotency_key", "now_ms" ], "type": "object" }, "ReqDef_DevelopmentLaneRenewRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneReserveRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "intent": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneIntent" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneReserveRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "intent", "idempotency_key", "now_ms" ], "type": "object" }, "ReqDef_DevelopmentLaneReserveRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_DevelopmentLaneStatusRequest": { "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "hold_id": { "type": [ "string", "null" ] }, "lane_id": { "type": [ "string", "null" ] }, "limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneStatusRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "tenant_ref", "limit", "now_ms" ], "type": "object" }, "ReqDef_DevelopmentLaneStatusRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_Digest256": { "description": "32 bytes of SHA-256 as lowercase hexadecimal", "maxLength": 64, "minLength": 64, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "ReqDef_DisclosureLevelWire": { "description": "Wire mirror of `eg_epistemic::redact::DisclosureLevel` (EPI-P3-4, L51) \u2014 the\n`Method::ExplainBelief::disclosure_level` request field AND the\n`ExplainBeliefRedactedResult::level` response field share this one type. Plain\nserde/enum, no `eg-epistemic` dependency needed here (`eg-types` sits BELOW\n`eg-epistemic` in the crate DAG).", "enum": [ "Full", "Skeleton", "ExistenceOnly" ], "type": "string" }, "ReqDef_DiscoveryCounts": { "additionalProperties": false, "description": "How many of each MCP primitive the probe saw.", "properties": { "prompts": { "format": "uint32", "minimum": 0, "type": "integer" }, "resources": { "format": "uint32", "minimum": 0, "type": "integer" }, "skills": { "format": "uint32", "minimum": 0, "type": "integer" }, "tools": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "tools", "skills", "prompts", "resources" ], "type": "object" }, "ReqDef_DiscoveryOutcome": { "description": "What the probe found.", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "reachable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "description": "Recorded rather than omitted: \"unavailable\" must never look identical to\n\"empty\". `error` is caller-redacted text; it is bounded here and never\ninterpreted.", "properties": { "error": { "type": "string" }, "status": { "const": "unreachable", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ] }, "ReqDef_DiscoveryScope": { "description": "Under whose authority a discovery observation was made.\n\nClosed, and deliberately two-valued. A local/stdio probe has no provider\ngrant to fingerprint, so it is tenant-local and visible to the tenant; a\nprobe made with a principal's OAuth grant saw what THAT grant allows, so it\nis visible only to that principal while that grant is current. There is no\nthird \"global\" value: an observation that cannot say which of the two it is\nis not recorded.", "oneOf": [ { "additionalProperties": false, "properties": { "authority": { "const": "tenant_local", "type": "string" } }, "required": [ "authority" ], "type": "object" }, { "additionalProperties": false, "description": "`grant_digest` is the broker-minted fingerprint of the grant the probe\nused. The principal is NOT a field: the server binds it from the\nverified request context.", "properties": { "authority": { "const": "oauth_grant", "type": "string" }, "grant_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" } }, "required": [ "authority", "grant_digest" ], "type": "object" } ] }, "ReqDef_DistAlgo": { "description": "The distributed graph algorithm a `DistributedCompute` / matview runs across\nshards (CONCEPT:EG-KG.storage.feature). Each is a vertex-centric (Pregel/GAS) computation the\ncross-shard superstep coordinator drives; the single-shard fast path stays the\nalways-on `PageRank`/`ConnectedComponents` ops.", "oneOf": [ { "additionalProperties": false, "description": "PageRank \u2014 `damping`\u00b7rank-mass propagation for `iterations` supersteps. The\ncross-shard result matches the single-graph result on the UNION graph.", "properties": { "PageRank": { "properties": { "damping": { "format": "double", "type": "number" }, "iterations": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "damping", "iterations" ], "type": "object" } }, "required": [ "PageRank" ], "type": "object" }, { "const": "ConnectedComponents", "description": "Weakly-connected components \u2014 every vertex labeled with its component's\nrepresentative, via label-propagation supersteps to a fixpoint.", "type": "string" }, { "additionalProperties": false, "description": "BFS levels from `source` \u2014 every reachable vertex labeled with its hop distance.", "properties": { "Bfs": { "properties": { "source": { "type": "string" } }, "required": [ "source" ], "type": "object" } }, "required": [ "Bfs" ], "type": "object" } ] }, "ReqDef_DualEntry": { "additionalProperties": false, "description": "One non-zero rational multiplier numerator.", "properties": { "numerator": { "$ref": "#/components/schemas/ReqDef_Scalar" }, "row": { "$ref": "#/components/schemas/ReqDef_RowId" } }, "required": [ "row", "numerator" ], "type": "object" }, "ReqDef_DurabilityDomain": { "description": "Authoritative durability domain for an operation.", "enum": [ "graph_rows", "graph_snapshot", "rdf_dataset", "sql_catalog", "blob_store", "kv_store", "time_series", "analytics_job", "semantic_index", "broker", "cross_modal", "multi_graph", "lifecycle", "control_plane" ], "type": "string" }, "ReqDef_EdgeSource": { "description": "Which side of a subsumption edge the engine got it from.", "oneOf": [ { "additionalProperties": false, "description": "The engine's own ontology.", "properties": { "edge": { "const": "native_ontology", "type": "string" } }, "required": [ "edge" ], "type": "object" }, { "additionalProperties": false, "description": "A component's own classification list.", "properties": { "component_id": { "type": "string" }, "edge": { "const": "component_classification", "type": "string" } }, "required": [ "edge", "component_id" ], "type": "object" } ] }, "ReqDef_Elimination": { "additionalProperties": false, "description": "One eliminated candidate and the rule that removed it.", "properties": { "component_id": { "type": "string" }, "violation": { "$ref": "#/components/schemas/ReqDef_Violation" } }, "required": [ "component_id", "violation" ], "type": "object" }, "ReqDef_EstimatorParams": { "description": "Hyperparameters for the estimators. All optional; per-estimator defaults are\napplied at fit time to mirror scikit-learn's defaults.", "properties": { "C": { "format": "double", "type": [ "number", "null" ] }, "alpha": { "format": "double", "type": [ "number", "null" ] }, "epsilon": { "format": "double", "type": [ "number", "null" ] }, "gamma": { "format": "double", "type": [ "number", "null" ] }, "kernel": { "type": [ "string", "null" ] }, "l1_ratio": { "format": "double", "type": [ "number", "null" ] }, "learning_rate": { "format": "double", "type": [ "number", "null" ] }, "max_depth": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "max_features": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "max_iter": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "min_samples_leaf": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "min_samples_split": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "n_estimators": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "random_state": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "subsample": { "format": "double", "type": [ "number", "null" ] }, "tol": { "format": "double", "type": [ "number", "null" ] } }, "type": "object" }, "ReqDef_EvalCandidate": { "description": "What is being evaluated.", "oneOf": [ { "additionalProperties": false, "description": "A fit job's draft artifact, pinned by content digest.", "properties": { "candidate": { "const": "draft_artifact", "type": "string" }, "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "sha256": { "type": "string" } }, "required": [ "candidate", "sha256", "length" ], "type": "object" }, { "additionalProperties": false, "description": "An already-published head.", "properties": { "candidate": { "const": "published_head", "type": "string" }, "head": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" } }, "required": [ "candidate", "head" ], "type": "object" } ] }, "ReqDef_EvidenceClass": { "description": "The weakest class of evidence the conclusion rests on.", "enum": [ "proof", "observation", "claim" ], "type": "string" }, "ReqDef_EvidenceRecord": { "properties": { "content_digest": { "type": "string" }, "evidence_id": { "type": "string" }, "locus_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "modality": { "type": "string" }, "object_id": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ReqDef_MaterialOperation" } }, "required": [ "evidence_id", "operation", "object_id", "modality", "locus_msgpack", "content_digest" ], "type": "object" }, "ReqDef_ExplorationBudget": { "additionalProperties": false, "description": "How much exploration a cold, uncalibrated question may spend.", "properties": { "fraction": { "$ref": "#/components/schemas/ReqDef_UnitRationalWire" }, "questions": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_16", "description": "Question ids exploration is permitted for. Empty forbids it everywhere." }, "spend_at_risk_micros": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "fraction", "spend_at_risk_micros", "questions" ], "type": "object" }, "ReqDef_FactQuality": { "description": "How strong one declared fact is.\n\nA connector pack carries no measurement and no operator attestation, so a\nprice read out of one is neither measured nor estimated: it is\n[`FactQuality::Declared`], and a record that used it says so.", "enum": [ "measured", "estimated", "declared", "unavailable" ], "type": "string" }, "ReqDef_FeatureRecord": { "properties": { "feature_id": { "type": "string" }, "kind": { "type": "string" }, "model_version": { "type": "string" }, "object_id": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ReqDef_MaterialOperation" }, "value_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "feature_id", "operation", "object_id", "kind", "value_msgpack", "model_version" ], "type": "object" }, "ReqDef_FeatureStep": { "description": "One ordered feature-construction step. Steps run left\u2192right: the first PRODUCING\nstep (`Embedding`/`NodeVector`) yields the `(node_id, row)` matrix; later transform\nsteps (`Normalize`) rewrite the rows in place. An empty step list \u21d2 the caller's\nexplicit `x` matrix is used verbatim.", "oneOf": [ { "description": "Structural node embeddings computed over the label subgraph \u2014 `method` is\n`fastrp` (default, training-free) or `node2vec` (biased walks + SGNS). The\nwalk/epoch knobs apply to `node2vec`; `iterations` to `fastrp`.", "properties": { "dim": { "default": 64, "format": "uint", "minimum": 0, "type": "integer" }, "epochs": { "default": 5, "format": "uint", "minimum": 0, "type": "integer" }, "iterations": { "default": 3, "format": "uint", "minimum": 0, "type": "integer" }, "method": { "default": "fastrp", "type": "string" }, "seed": { "default": 7, "format": "uint64", "minimum": 0, "type": "integer" }, "step": { "const": "embedding", "type": "string" }, "walk_length": { "default": 40, "format": "uint", "minimum": 0, "type": "integer" }, "walks_per_node": { "default": 10, "format": "uint", "minimum": 0, "type": "integer" }, "window": { "default": 5, "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "step" ], "type": "object" }, { "description": "Read each source node's pre-stored embedding vector from the SemanticStore\n(the \"classify these nodes by their existing embeddings\" path).", "properties": { "step": { "const": "node_vector", "type": "string" } }, "required": [ "step" ], "type": "object" }, { "description": "L2-normalize each feature row in place (a zero row is left untouched).", "properties": { "step": { "const": "normalize", "type": "string" } }, "required": [ "step" ], "type": "object" } ] }, "ReqDef_FittedClassifier": { "description": "Serializable fitted classifier returned by `mining::classify::fit` and consumed\nback by `mining::classify::predict` (the PREDICTIVE fit\u2192blob\u2192predict pair). Lives\nin eg-types so `Method::MineClassifyPredict` can embed the model over the wire \u2014\nexactly like `FittedModel` carries the datascience regressors. `classes` is the\nsorted set of integer labels; every score/proba vector is column-ordered by it.", "oneOf": [ { "description": "Gaussian Naive Bayes \u2014 per-class prior + per-feature (mean, variance).", "properties": { "kind": { "const": "GaussianNb", "type": "string" }, "model": { "properties": { "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "means": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "priors": { "items": { "format": "double", "type": "number" }, "type": "array" }, "vars": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "classes", "priors", "means", "vars" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "Multinomial Naive Bayes \u2014 per-class log-prior + Laplace-smoothed feature log-probs.", "properties": { "kind": { "const": "MultinomialNb", "type": "string" }, "model": { "properties": { "class_log_prior": { "items": { "format": "double", "type": "number" }, "type": "array" }, "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "feature_log_prob": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "classes", "class_log_prior", "feature_log_prob" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "k-NN \u2014 the lazy classifier stores its training rows + labels for the vote.", "properties": { "kind": { "const": "Knn", "type": "string" }, "model": { "properties": { "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "k": { "format": "uint", "minimum": 0, "type": "integer" }, "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "required": [ "k", "classes", "x", "y" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "One-vs-rest linear classifier (`kind` = `logistic` | `svc`): a weight vector +\nbias per class. Prediction is argmax of the per-class score.", "properties": { "kind": { "const": "LinearOvr", "type": "string" }, "model": { "properties": { "biases": { "items": { "format": "double", "type": "number" }, "type": "array" }, "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "kind": { "type": "string" }, "weights": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "kind", "classes", "weights", "biases" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" } ] }, "ReqDef_FittedModel": { "description": "Serializable fitted model returned by `fit_estimator`.", "oneOf": [ { "properties": { "kind": { "const": "Linear", "type": "string" }, "model": { "properties": { "coefficients": { "items": { "format": "double", "type": "number" }, "type": "array" }, "intercept": { "format": "double", "type": "number" } }, "required": [ "coefficients", "intercept" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Tree", "type": "string" }, "model": { "$ref": "#/components/schemas/ReqDef_DecisionTree" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Forest", "type": "string" }, "model": { "properties": { "trees": { "items": { "$ref": "#/components/schemas/ReqDef_DecisionTree" }, "type": "array" } }, "required": [ "trees" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "GradientBoosting", "type": "string" }, "model": { "properties": { "init": { "format": "double", "type": "number" }, "learning_rate": { "format": "double", "type": "number" }, "trees": { "items": { "$ref": "#/components/schemas/ReqDef_DecisionTree" }, "type": "array" } }, "required": [ "init", "learning_rate", "trees" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "AdaBoost", "type": "string" }, "model": { "properties": { "trees": { "items": { "$ref": "#/components/schemas/ReqDef_DecisionTree" }, "type": "array" }, "weights": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "trees", "weights" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Svr", "type": "string" }, "model": { "properties": { "dual_coef": { "items": { "format": "double", "type": "number" }, "type": "array" }, "gamma": { "format": "double", "type": "number" }, "intercept": { "format": "double", "type": "number" }, "kernel": { "type": "string" }, "support_vectors": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "support_vectors", "dual_coef", "intercept", "kernel", "gamma" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" } ] }, "ReqDef_FleetCatalogCursor": { "additionalProperties": false, "description": "Where a page resumes, fenced to the snapshot that produced it.", "properties": { "after_id": { "type": "string" }, "after_name": { "description": "Exclusive `(lowercased name, id)` lower bound for the next page.", "type": "string" }, "snapshot_digest": { "$ref": "#/components/schemas/ReqDef_Digest256", "description": "Digest of the whole visible, filtered snapshot of the page's kind. The\nfence is content, not a graph revision: a registry heartbeat that changes\nnothing this kind shows must not invalidate a caller's cursor." } }, "required": [ "after_name", "after_id", "snapshot_digest" ], "type": "object" }, "ReqDef_FleetCatalogKind": { "description": "Which kind of row a page lists.", "enum": [ "discoveries", "tools", "prompts", "resources", "skills" ], "type": "string" }, "ReqDef_FleetCatalogListRequest": { "additionalProperties": false, "description": "Read one bounded page of one kind.", "properties": { "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_FleetCatalogCursor" }, { "type": "null" } ], "default": null }, "grant_digests": { "$ref": "#/components/schemas/ReqDef_BoundedVec_Digest256_64", "default": [], "description": "The caller's CURRENT grant fingerprints. Only narrows: an OAuth-scoped\nrow is visible when its principal is the verified caller AND its grant\nis listed here; nothing listed here can widen past the caller." }, "kind": { "$ref": "#/components/schemas/ReqDef_FleetCatalogKind" }, "limit": { "default": null, "description": "`None` selects the maximum page size.", "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] }, "query": { "default": null, "description": "Case-insensitive substring over name, server name and description.", "type": [ "string", "null" ] } }, "required": [ "kind" ], "type": "object" }, "ReqDef_FleetCatalogLookupRequest": { "additionalProperties": false, "description": "Read the visible rows for a batch of ids of any kind: component ids for\ncontent rows, discovery ids for observations. An id the caller may not see\nis absent from the answer exactly as an unknown id is.", "properties": { "grant_digests": { "$ref": "#/components/schemas/ReqDef_BoundedVec_Digest256_64", "default": [] }, "ids": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_256" } }, "required": [ "ids" ], "type": "object" }, "ReqDef_FleetCatalogOp": { "description": "Every fleet catalog operation.\n\nThe read/write split and the authorization action live on the op, so the\ncapability ledger and the server's write classifier cannot disagree about\nan operation.", "oneOf": [ { "additionalProperties": false, "description": "Record one server's latest discovery observation under one scope.", "properties": { "op": { "const": "record_discovery", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_FleetDiscoveryRecordRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Set one durable operator override on a published component.", "properties": { "op": { "const": "set_override", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_FleetOverrideSetRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Clear one durable operator override.", "properties": { "op": { "const": "clear_override", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_FleetOverrideClearRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Read one bounded, snapshot-fenced page of one kind.", "properties": { "op": { "const": "list", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_FleetCatalogListRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Read the visible rows for a batch of ids, of any kind.", "properties": { "op": { "const": "lookup", "type": "string" }, "request": { "$ref": "#/components/schemas/ReqDef_FleetCatalogLookupRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ReqDef_FleetDiscoveryRecordRequest": { "additionalProperties": false, "description": "Record one server's latest discovery observation under one scope.\n\nOne record per `(tenant, server_name, scope)`; a later observation replaces\nthe earlier one through a compare-and-set on its revision.", "properties": { "connector": { "description": "The connector whose pack holds what this probe observed. The join from\nobservation to content: every `mcp:/...` component inherits\nthis observation's visibility.", "type": "string" }, "counts": { "$ref": "#/components/schemas/ReqDef_DiscoveryCounts", "default": { "prompts": 0, "resources": 0, "skills": 0, "tools": 0 } }, "expected_revision": { "default": null, "description": "`None` writes unconditionally; `Some(0)` requires that no record exists\nyet; `Some(n)` requires the stored revision to be exactly `n`.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "outcome": { "$ref": "#/components/schemas/ReqDef_DiscoveryOutcome" }, "scope": { "$ref": "#/components/schemas/ReqDef_DiscoveryScope" }, "server_name": { "description": "The registry name the server registers under.", "type": "string" } }, "required": [ "server_name", "scope", "connector", "outcome" ], "type": "object" }, "ReqDef_FleetOverride": { "description": "One durable operator override. Closed, one variant per field.", "oneOf": [ { "additionalProperties": false, "description": "Reclassify a skill. Survives every re-import of its pack, because the\nimport never writes override records and the projection applies them at\nread time.", "properties": { "field": { "const": "skill_type", "type": "string" }, "skill_type": { "$ref": "#/components/schemas/ReqDef_SkillType" } }, "required": [ "field", "skill_type" ], "type": "object" } ] }, "ReqDef_FleetOverrideClearRequest": { "additionalProperties": false, "description": "Clear one durable operator override. A cleared override is a tombstone\nrevision, not a deletion, so the compare-and-set chain never restarts.", "properties": { "component_id": { "type": "string" }, "expected_revision": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "field": { "$ref": "#/components/schemas/ReqDef_FleetOverrideField" } }, "required": [ "component_id", "field" ], "type": "object" }, "ReqDef_FleetOverrideField": { "description": "The field an override record governs; one record per `(component, field)`.", "enum": [ "skill_type" ], "type": "string" }, "ReqDef_FleetOverrideSetRequest": { "additionalProperties": false, "description": "Set one durable operator override.", "properties": { "component_id": { "type": "string" }, "expected_revision": { "default": null, "description": "Same compare-and-set meaning as on a discovery record.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "value": { "$ref": "#/components/schemas/ReqDef_FleetOverride" } }, "required": [ "component_id", "value" ], "type": "object" }, "ReqDef_ForecastAlgorithm": { "description": "Which forecasting engine `MineForecast` runs (CONCEPT:EG-KG.mining.arima \u2014\nPhase 4). ARIMA is the default (Hannan-Rissanen AR(p)/MA(q) after `d`-order\ndifferencing); `holtwinters` degrades to Holt's linear-trend method when\n`period` is 0; `stl` is a classical decomposition + extrapolation.", "enum": [ "arima", "holtwinters", "stl" ], "type": "string" }, "ReqDef_ForeignSourceSpec": { "description": "A FOREIGN (external) RowSet source for the federation `Op::ForeignScan`\n(CONCEPT:EG-KG.query.query-federation, Lane P). A federated query reads rows from a source OUTSIDE\nthe local engine and composes them with the local graph/vector/SQL ops \u2014 so a\n`ForeignScan` is just another RowSet leaf, like `Scan`/`Reason`/`SparqlBgp`. Two\nkinds, behind one wire enum; the `ForeignSource` trait in eg-plan turns each into\na [`crate::RowSet`].", "oneOf": [ { "additionalProperties": false, "description": "A REMOTE epistemic-graph engine, reached over the SAME length-prefixed\nMessagePack + HMAC transport this engine speaks. The federation client\nconnects to `endpoint` (a `host:port` TCP address), sends a `UnifiedQueryText`\n(UQL) \u2014 or, when `uql` is empty, a `CypherQuery` \u2014 against the remote `graph`,\nand projects the result rows into a local RowSet. Every request is an `eg2.`\nverified-context envelope; an empty secret or incomplete context fails before\ndialing. This composes the engine with ANOTHER engine without a Python\nround-trip \u2014 the cross-engine federation seam.", "properties": { "RemoteEngine": { "properties": { "context": { "$ref": "#/components/schemas/ReqDef_RequestContextClaims", "default": { "agent_id": "", "audience": "", "delegation": [], "policy_version": "", "principal": "", "roles": [], "scopes": [], "tenant": "" }, "description": "Identity, tenant, audience, capabilities, active policy version, and\ndelegation path signed into every remote request. The receiving engine\nindependently checks these claims against deployment policy and RBAC.\nBoxed: `RequestContextClaims` is the single field that made this the\nlargest `ForeignSourceSpec` variant by a wide margin." }, "cypher": { "default": "", "description": "A Cypher query run on the remote when `uql` is empty (must `RETURN` an id\ncolumn named by `id_field`).", "type": "string" }, "endpoint": { "description": "`host:port` of the remote engine's TCP listener.", "type": "string" }, "graph": { "description": "The remote graph to query (e.g. `__commons__`).", "type": "string" }, "id_field": { "default": "", "description": "For the Cypher path: the RETURN column that carries the node id. Ignored on\nthe UQL path (a UQL plan's rows are already `[id, score?]`).", "type": "string" }, "secret": { "default": "", "description": "HMAC-SHA256 secret used by the remote verified-context issuer. Empty is\ninvalid; native federation never downgrades to insecure or legacy auth.", "type": "string" }, "uql": { "default": "", "description": "A UQL query run on the remote (its rows seed the RowSet). When empty, `cypher`\nis used instead.", "type": "string" } }, "required": [ "endpoint", "graph" ], "type": "object" } }, "required": [ "RemoteEngine" ], "type": "object" }, { "additionalProperties": false, "description": "A GENERIC HTTP/JSON source. The federation client issues an HTTP GET to `url`\n(pure-Rust rustls client \u2014 NOT openssl, gated OUT of the Pi tier), walks the\nJSON response to the array at `json_path` (a dotted path, e.g. `data.items`),\nand maps each element into a RowSet row via `field_map`: the element field\nnamed `field_map.id` becomes the row id, and (optionally) `field_map.score`\nbecomes the row score. Any external REST API thereby becomes a joinable RowSet.", "properties": { "HttpJson": { "properties": { "field_map": { "$ref": "#/components/schemas/ReqDef_HttpFieldMap", "description": "Maps a JSON element to a RowSet row (which field is the id / the score)." }, "json_path": { "default": "", "description": "Dotted path to the JSON array of rows (empty \u21d2 the response is itself the\narray).", "type": "string" }, "url": { "description": "The HTTP(S) URL to GET.", "type": "string" } }, "required": [ "url", "field_map" ], "type": "object" } }, "required": [ "HttpJson" ], "type": "object" }, { "additionalProperties": false, "description": "An EXTERNAL relational-SQL database (Postgres/MySQL/\u2026) (CONCEPT:EG-KG.query.feature). The\nfederation client connects to `dsn`, runs `query`, and maps each result row to a\nRowSet row: the column named `id_field` becomes the row id (stringified), and\n(optionally) `score_field` becomes the row score. This lets ONE unified plan JOIN\nan external SQL table with the LOCAL graph/vector \u2014 the \"engine federates external\nSQL\" half that sql-mcp alone cannot give: sql-mcp speaks SQL to the engine, this\nlets the engine speak SQL OUT to a foreign RDBMS and fuse the rows in-plan.\n\nThis wire variant is PURE serde (it carries only the DSN + query strings), so it\nis present whenever `federation` is on. The actual SQL *driver* (a pure-Rust /\nrustls client \u2014 NEVER openssl) lives in eg-plan behind its own `federation-sql`\ngate and is folded OUT of the Pi tier (the Pi contract: no SQL driver / rustls /\nopenssl). A `federation` build WITHOUT `federation-sql` accepts + registers a\n`Sql` spec but errors clearly if a plan actually tries to fetch it.", "properties": { "Sql": { "properties": { "dsn": { "description": "The external database DSN (e.g. `postgres://host:5432/db`).", "type": "string" }, "id_field": { "description": "The result column whose value is the row id (stringified).", "type": "string" }, "query": { "description": "The SQL query to run against the external DB. Its result columns are mapped\nto RowSet rows via `id_field` / `score_field`.", "type": "string" }, "score_field": { "default": null, "description": "The result column whose numeric value is the row score (absent \u21d2 unscored).", "type": [ "string", "null" ] } }, "required": [ "dsn", "query", "id_field" ], "type": "object" } }, "required": [ "Sql" ], "type": "object" }, { "additionalProperties": false, "description": "A NAMED reference to a foreign source registered in the executor's\n`ForeignSourceRegistry` (CONCEPT:EG-KG.query.closure-backed-source). Unlike the self-describing variants\nabove (which carry the full connection spec inline), this carries ONLY a `name`\n\u2014 the executor resolves it to a concrete, pre-registered [`ForeignSource`] at\nplan time. This is the resolution seam the UQL `FOREIGN \"\"` clause needs:\nthe parser only ever sees a name, and binding that name to a live source lives\nwith the server/facade (which owns the registry), not in the wire DTO. A `Named`\nspec handed to a source builder WITHOUT a registry is a clean typed error, never\na silent empty set.", "properties": { "Named": { "properties": { "name": { "description": "The registry key naming a pre-registered foreign source.", "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "Named" ], "type": "object" } ] }, "ReqDef_FuseClock": { "description": "FUSE \u2014 the DECLARED time base [`Op::SensorAlign`] resamples onto\n(CONCEPT:EG-KG.query.multi-rate-sensor-stream). This is what separates `SensorAlign` from `Op::SensorFuse`:\n`SensorFuse` fuses onto the UNION clock of the samples themselves (data-driven instants,\ntolerance/ASOF only), while `SensorAlign` fuses onto a clock the CALLER declares, so the\noutput instants are independent of when the sensors happened to fire.\n\n* `Uniform { from_ns, to_ns, step_ns }` \u2014 the half-open grid `from_ns, from_ns+step_ns,\n \u2026 < to_ns`. One fused row per grid instant.\n* `Tumbling { width_ns, step_ns }` \u2014 EG-067 tumbling windows of `width_ns` aligned as\n `(t/width)*width` spanning the union sample span, each internally resampled onto a\n `step_ns` sub-grid. One fused row per window.\n\nAll bounds are INTEGER nanoseconds, not `f64` seconds: a grid instant has to be exact\n(it is an output identity), and integer ns keeps it so.", "oneOf": [ { "additionalProperties": false, "properties": { "uniform": { "properties": { "from_ns": { "format": "int64", "type": "integer" }, "step_ns": { "format": "int64", "type": "integer" }, "to_ns": { "format": "int64", "type": "integer" } }, "required": [ "from_ns", "to_ns", "step_ns" ], "type": "object" } }, "required": [ "uniform" ], "type": "object" }, { "additionalProperties": false, "properties": { "tumbling": { "properties": { "step_ns": { "format": "int64", "type": "integer" }, "width_ns": { "format": "int64", "type": "integer" } }, "required": [ "width_ns", "step_ns" ], "type": "object" } }, "required": [ "tumbling" ], "type": "object" } ] }, "ReqDef_FuseInterp": { "description": "FUSE \u2014 the per-channel interpolation mode carried by [`FuseStream`]\n(CONCEPT:EG-KG.query.multi-rate-sensor-stream). Chosen PER STREAM because modalities differ: a pose is\n`Linear`-interpolable, a discrete mode/label wants `AsofHold`, a noisy raw reading may\nwant `Nearest`. PURE serde \u2014 the resampling math lives in `eg_tsdb::fusion` behind\neg-plan's `timeseries` gate; this is the wire variant.", "oneOf": [ { "const": "nearest", "description": "The closest sample in time to the grid instant (either side); a tie resolves to the\nEARLIER sample so the result is deterministic.", "type": "string" }, { "const": "linear", "description": "Linear interpolation between the two samples bracketing the grid instant. An instant\nOUTSIDE the sample span is a GAP \u2014 no extrapolation.", "type": "string" }, { "const": "asof_hold", "description": "Last-known value at-or-before the grid instant (forward-fill / zero-order hold). An\ninstant before the first sample is a GAP.", "type": "string" } ] }, "ReqDef_FuseStream": { "description": "FUSE \u2014 one input stream to [`Op::SensorAlign`] (CONCEPT:EG-KG.query.multi-rate-sensor-stream): the sensor\n`layer` (a node label / `type`, resolved off the snapshot exactly as `Op::SensorFuse`\nresolves its streams) plus the [`FuseInterp`] mode that channel is resampled under.\nPURE serde; this is the wire variant.", "properties": { "interp": { "$ref": "#/components/schemas/ReqDef_FuseInterp" }, "layer": { "type": "string" } }, "required": [ "layer", "interp" ], "type": "object" }, "ReqDef_Grant": { "description": "A grant binding a role to an (`resource`, `action`, `effect`) triple\n(CONCEPT:EG-KG.compute.feature).", "properties": { "action": { "$ref": "#/components/schemas/ReqDef_RbacAction" }, "effect": { "$ref": "#/components/schemas/ReqDef_GrantEffect" }, "resource": { "$ref": "#/components/schemas/ReqDef_ResourceSelector" }, "role": { "type": "string" } }, "required": [ "role", "resource", "action", "effect" ], "type": "object" }, "ReqDef_GrantEffect": { "description": "Whether a [`Grant`] permits or forbids the action (CONCEPT:EG-KG.compute.feature).", "enum": [ "Allow", "Deny" ], "type": "string" }, "ReqDef_GraphLearnParams": { "description": "Training + architecture knobs for `GraphLearnFit` (CONCEPT:EG-KG.graphlearn.link-predictor).", "properties": { "alpha": { "default": 0.5, "description": "1-hop neighbour-aggregation self-retention for the node-feature channel.", "format": "double", "type": "number" }, "basis": { "default": "chebyshev", "description": "Polynomial basis for the edge functions: `chebyshev` (default) or `jacobi`.", "type": "string" }, "degree": { "default": 4, "description": "Polynomial degree per edge function.", "format": "uint", "minimum": 0, "type": "integer" }, "epochs": { "default": 200, "description": "Adam training epochs.", "format": "uint", "minimum": 0, "type": "integer" }, "hidden": { "default": 0, "description": "Hidden width; `0` \u21d2 a single interpretable layer (one edge fn per feature).", "format": "uint", "minimum": 0, "type": "integer" }, "lr": { "default": 0.05, "description": "Adam learning rate.", "format": "double", "type": "number" }, "neg_ratio": { "default": 1.0, "description": "Negatives (sampled non-edges) per positive edge.", "format": "double", "type": "number" }, "seed": { "default": 42, "description": "Seed for negative sampling + parameter init (deterministic).", "format": "uint64", "minimum": 0, "type": "integer" } }, "type": "object" }, "ReqDef_GraphSchemaOp": { "description": "Attach, replace or detach one keyed schema source.", "oneOf": [ { "additionalProperties": false, "description": "Attach or replace the documents under `source_id`. At least one\ndocument must be given; attaching nothing is a detach, and saying so\nexplicitly is what stops an empty request from silently clearing a key.", "properties": { "if_composed_digest": { "default": null, "description": "Compare-and-set against the composed digest the caller last saw.", "type": [ "string", "null" ] }, "ontology_ttl": { "default": null, "type": [ "string", "null" ] }, "op": { "const": "attach", "type": "string" }, "shapes_ttl": { "default": null, "type": [ "string", "null" ] }, "source_id": { "type": "string" } }, "required": [ "op", "source_id" ], "type": "object" }, { "additionalProperties": false, "description": "Attach the current head of a connector's pack, under its reserved key.", "properties": { "connector": { "type": "string" }, "if_composed_digest": { "default": null, "type": [ "string", "null" ] }, "op": { "const": "attach_pack", "type": "string" } }, "required": [ "op", "connector" ], "type": "object" }, { "additionalProperties": false, "properties": { "if_composed_digest": { "default": null, "type": [ "string", "null" ] }, "op": { "const": "detach", "type": "string" }, "source_id": { "type": "string" } }, "required": [ "op", "source_id" ], "type": "object" } ] }, "ReqDef_GraphSource": { "description": "A graph-derived subgraph source for `GraphLearn*` (CONCEPT:EG-KG.graphlearn.link-predictor).\n\nEvery node carrying `node_label` becomes a vertex; edges among them (following\n`direction`, optionally filtered to `relation`) are the observed positive links\nthe KAN learns from. Isolated label instances are kept as candidate endpoints.", "properties": { "direction": { "default": "any", "description": "Edge direction to gather links: `any` (both, default \u2014 links are undirected\nfor prediction), `out` (successors), or `in` (predecessors).", "type": "string" }, "limit": { "description": "Cap the number of label nodes scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances form the learning subgraph's vertices.", "type": "string" }, "relation": { "description": "Optional edge-relation filter: only use edges whose `relationship` equals\nthis. `None` \u21d2 all edges among the label's nodes.", "type": [ "string", "null" ] } }, "required": [ "node_label" ], "type": "object" }, "ReqDef_GraphTextPropertyRef": { "additionalProperties": false, "properties": { "graph_id": { "type": "string" }, "property_id": { "type": "string" }, "type_id": { "type": "string" } }, "required": [ "graph_id", "type_id", "property_id" ], "type": "object" }, "ReqDef_GraphType": { "description": "Graph type for multi-tenant registry.", "enum": [ "Agent", "Team", "Global", "Commons" ], "type": "string" }, "ReqDef_HeadKind": { "description": "Which head shape a fit produces.", "oneOf": [ { "const": "weighted_features", "description": "One weight per feature; an advisory score that never acts.", "type": "string" }, { "const": "listwise_logistic", "description": "A listwise logistic model over the candidate set.", "type": "string" } ] }, "ReqDef_HttpFieldMap": { "description": "Which JSON element fields become a RowSet row's id / score (for\n[`ForeignSourceSpec::HttpJson`]).", "properties": { "id": { "description": "The element field whose value is the row id (stringified).", "type": "string" }, "score": { "default": null, "description": "The element field whose numeric value is the row score (absent \u21d2 unscored).", "type": [ "string", "null" ] } }, "required": [ "id" ], "type": "object" }, "ReqDef_IncarnationId": { "description": "Opaque logical-generation identity. It is never derived from a resource name.", "type": "string" }, "ReqDef_Incumbent": { "additionalProperties": false, "description": "A feasible assignment and its objective value.", "properties": { "objective": { "$ref": "#/components/schemas/ReqDef_ObjectiveValue" }, "selected": { "items": { "type": "boolean" }, "type": "array" } }, "required": [ "selected", "objective" ], "type": "object" }, "ReqDef_IssueControlLeaseRequest": { "additionalProperties": false, "description": "`IssueControlLease`: create one active lease, refused if the id exists.", "properties": { "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "grant": { "additionalProperties": true, "description": "The immutable grant body.", "type": "object" }, "hard_expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "description": "Caller-stable retry identity for this issue.", "type": "string" }, "issued_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "description": "Caller-defined lease family, e.g. `browser.control`.", "type": "string" }, "lease_id": { "type": "string" }, "tenant": { "description": "Must equal the verified request tenant.", "type": "string" } }, "required": [ "tenant", "lease_id", "kind", "grant", "issued_at_ms", "expires_at_ms", "hard_expires_at_ms", "idempotency_key" ], "type": "object" }, "ReqDef_ItemLabel": { "description": "The label of one item.", "oneOf": [ { "additionalProperties": false, "properties": { "acceptable": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64" }, "label": { "const": "gold", "type": "string" }, "source": { "$ref": "#/components/schemas/ReqDef_LabelSource" } }, "required": [ "label", "acceptable", "source" ], "type": "object" }, { "additionalProperties": false, "description": "One logged, executed decision.", "properties": { "commit_principal": { "type": "string" }, "evaluation": { "$ref": "#/components/schemas/ReqDef_OutcomeEvaluation" }, "executed": { "type": "string" }, "label": { "const": "logged", "type": "string" }, "logging_propensities": { "$ref": "#/components/schemas/ReqDef_BoundedVec_UnitRationalWire_64", "description": "Aligned with the item's candidates; must sum to exactly one." }, "pinned": { "description": "A pinned decision had propensity one by fiat and is excluded from\noff-policy estimates.", "type": "boolean" }, "propensity_source": { "$ref": "#/components/schemas/ReqDef_PropensitySource" } }, "required": [ "label", "executed", "logging_propensities", "propensity_source", "pinned", "commit_principal", "evaluation" ], "type": "object" } ] }, "ReqDef_JobKind": { "description": "Which analytics computation a job runs (CONCEPT:INT-P2-1).", "oneOf": [ { "additionalProperties": false, "description": "Association-rule mining over explicit transactions (mirrors\n`Method::MineAssociate`'s non-graph-derived path).", "properties": { "MineAssociate": { "properties": { "algorithm": { "default": "fpgrowth", "description": "`\"apriori\" | \"fpgrowth\" | \"eclat\"`; unrecognized \u21d2 facade error.", "type": "string" }, "min_confidence": { "default": 0.5, "format": "double", "type": "number" }, "min_support": { "default": 0.1, "format": "double", "type": "number" }, "transactions": { "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" } }, "required": [ "transactions" ], "type": "object" } }, "required": [ "MineAssociate" ], "type": "object" }, { "additionalProperties": false, "description": "Governed graph-native program compilation. The nested MessagePack is a\nversioned `eg_program::OptimizationRequest`; `eg-types` remains the bottom\nof the crate DAG and the server decodes/rebinds it at the verified boundary.", "properties": { "ProgramOptimize": { "properties": { "request_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "request_msgpack" ], "type": "object" } }, "required": [ "ProgramOptimize" ], "type": "object" } ] }, "ReqDef_JobOp": { "description": "The analytics-job control-plane operation (CONCEPT:INT-P2-1).", "oneOf": [ { "additionalProperties": false, "description": "Submit a new job. Runs asynchronously off the request \u2014 the response carries\nthe freshly durable `Submitted` job record (including its server-issued id),\nnot the eventual result.", "properties": { "Submit": { "$ref": "#/components/schemas/ReqDef_SubmitJobSpec" } }, "required": [ "Submit" ], "type": "object" }, { "additionalProperties": false, "description": "Fetch a job's current durable state (including checkpoint/progress).", "properties": { "Status": { "properties": { "job_id": { "type": "string" } }, "required": [ "job_id" ], "type": "object" } }, "required": [ "Status" ], "type": "object" }, { "additionalProperties": false, "description": "Cooperatively cancel a job (immediate if not yet started; the running\nexecutor observes the flag and stops otherwise).", "properties": { "Cancel": { "properties": { "job_id": { "type": "string" } }, "required": [ "job_id" ], "type": "object" } }, "required": [ "Cancel" ], "type": "object" }, { "additionalProperties": false, "description": "Resume a job from its last checkpoint \u2014 a `Failed` job with retries\nremaining, or a `Running` job orphaned by a crashed/restarted process.", "properties": { "Resume": { "properties": { "job_id": { "type": "string" } }, "required": [ "job_id" ], "type": "object" } }, "required": [ "Resume" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically claim the highest-priority eligible job. `worker_instance`\ndistinguishes concurrent slots for one authenticated principal; the server\nhashes it with the verified identity before persistence.", "properties": { "WorkerClaim": { "properties": { "capabilities": { "default": [], "items": { "type": "string" }, "type": "array" }, "lease_ms": { "default": 60000, "format": "uint64", "minimum": 0, "type": "integer" }, "worker_instance": { "default": "", "type": "string" } }, "type": "object" } }, "required": [ "WorkerClaim" ], "type": "object" }, { "additionalProperties": false, "description": "Renew the exact lease epoch owned by this authenticated worker slot.", "properties": { "WorkerRenew": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_ms": { "default": 60000, "format": "uint64", "minimum": 0, "type": "integer" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch" ], "type": "object" } }, "required": [ "WorkerRenew" ], "type": "object" }, { "additionalProperties": false, "description": "Persist a fenced progress checkpoint. `state_ref`, when present, must be an\nopaque external state reference rather than inline source/user content.", "properties": { "WorkerCheckpoint": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "progress": { "format": "double", "type": "number" }, "stage": { "type": "string" }, "state_ref": { "default": null, "type": [ "string", "null" ] }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch", "progress", "stage" ], "type": "object" } }, "required": [ "WorkerCheckpoint" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically stage the complete typed result before publication.", "properties": { "WorkerStage": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "result": { "$ref": "#/components/schemas/ReqDef_JobResult" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch", "result" ], "type": "object" } }, "required": [ "WorkerStage" ], "type": "object" }, { "additionalProperties": false, "description": "Commit evidence-bearing claims for a staged result and then mark success.", "properties": { "WorkerPublish": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch" ], "type": "object" } }, "required": [ "WorkerPublish" ], "type": "object" }, { "additionalProperties": false, "description": "Release a failed compute attempt through server-owned retry/backoff policy.", "properties": { "WorkerFail": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason_code": { "type": "string" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch", "reason_code" ], "type": "object" } }, "required": [ "WorkerFail" ], "type": "object" }, { "additionalProperties": false, "description": "Confirm that a worker cooperatively stopped after a cancellation request.", "properties": { "WorkerCancel": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch" ], "type": "object" } }, "required": [ "WorkerCancel" ], "type": "object" } ] }, "ReqDef_JobReproducibilityManifest": { "description": "Reproducibility manifest bound server-side to the leased job lineage.", "properties": { "algorithm_ref": { "type": "string" }, "environment_version": { "type": "string" }, "implementation_version": { "type": "string" }, "input_content_digest": { "type": "string" }, "input_dataset_ref": { "type": "string" }, "input_snapshot_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "params_digest": { "type": "string" }, "policy_fingerprint": { "type": "string" } }, "required": [ "input_dataset_ref", "input_content_digest", "input_snapshot_version", "algorithm_ref", "params_digest", "implementation_version", "environment_version", "policy_fingerprint" ], "type": "object" }, "ReqDef_JobResult": { "description": "KnowledgeBatch-shaped result currency accepted by [`JobOp::WorkerStage`].", "properties": { "calibration": { "default": null, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "double", "type": "number" }, { "format": "double", "type": "number" } ], "type": [ "array", "null" ] }, "content_digest": { "type": "string" }, "counterexample_refs": { "default": [], "items": { "type": "string" }, "type": "array" }, "dataset_ref": { "type": "string" }, "evidence_refs": { "default": [], "items": { "type": "string" }, "type": "array" }, "reproducibility": { "$ref": "#/components/schemas/ReqDef_JobReproducibilityManifest" }, "rows": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "schema": { "items": { "$ref": "#/components/schemas/ReqDef_JobResultColumn" }, "type": "array" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "uncertainty": { "default": null, "format": "double", "type": [ "number", "null" ] } }, "required": [ "schema_version", "dataset_ref", "content_digest", "schema", "rows", "reproducibility" ], "type": "object" }, "ReqDef_JobResultColumn": { "description": "Portable typed result column for remote analytics workers.", "properties": { "logical_type": { "type": "string" }, "name": { "type": "string" }, "nullable": { "type": "boolean" } }, "required": [ "name", "logical_type", "nullable" ], "type": "object" }, "ReqDef_JsonPathOp": { "description": "DOCUMENT/JSON \u2014 the test applied by [`Pred::JsonPath`] against the value(s) a\nJSONPath resolves to (CONCEPT:EG-KG.query.json-wire-roundtrip). PURE serde (a small tag + an optional\n`serde_json::Value` literal); the actual walk/containment lives in\n`eg_core::jsonpath` behind eg-plan's FILTER leg \u2014 this is the wire variant.", "oneOf": [ { "const": "Exists", "description": "The path resolves to at least one value (`jsonb_path_query` existence / `@?`).", "type": "string" }, { "additionalProperties": false, "description": "Some value at the path equals `value` (Postgres `->` / `->>` equality). A `->>`\ntext compare coerces a scalar to text, so a JSON-string `value` also matches a\nnumeric leaf whose canonical text is equal.", "properties": { "Eq": { "properties": { "value": true }, "required": [ "value" ], "type": "object" } }, "required": [ "Eq" ], "type": "object" }, { "additionalProperties": false, "description": "The value at the path CONTAINS `value` per Postgres `@>` JSON containment\n(object \u2287 object, array \u2287 array/scalar, scalar equality).", "properties": { "Contains": { "properties": { "value": true }, "required": [ "value" ], "type": "object" } }, "required": [ "Contains" ], "type": "object" } ] }, "ReqDef_KgDelegateRequest": { "additionalProperties": false, "description": "A delegation admission request. The `context` value is a wire assertion;\nthe server compares it with the authenticated outer envelope before using\nany field for tenant, policy, or routing decisions.", "properties": { "actor_scope": { "type": "string" }, "capability_digest": { "type": "string" }, "catalog_digest": { "type": "string" }, "command_digest": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_RequestContext" }, "deadline_unix": { "format": "double", "type": [ "number", "null" ] }, "delegation_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "input_ref": { "type": "string" }, "kind": { "type": "string" }, "max_attempts": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_tenant_in_flight": { "description": "Zero requests the engine's bounded default. The native admission\nauthority still enforces its own hard ceiling.", "format": "uint64", "minimum": 0, "type": "integer" }, "model_digest": { "default": null, "description": "The model a single-agent delegation will run on.\n\n`Some` for an agent target and `None` for a graph, and both directions\nare enforced. A graph has no single model -- it has one per agent node --\nand its pinned `definition_digest` covers the shape digest, which pins\nevery one of them transitively, so a scalar here would either be a lie\nor a duplicate of something the shape digest covers better. Requiring it\nto be absent keeps the two cases from being conflated by a caller that\nfills in a plausible value.", "type": [ "string", "null" ] }, "policy_digest": { "type": "string" }, "priority": { "format": "int64", "type": "integer" }, "purpose": { "type": "string" }, "run_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_KgDelegateSchemaVersion" }, "target": { "$ref": "#/components/schemas/ReqDef_DelegationTarget", "description": "What to run: one agent, or one graph of them." }, "trace_id": { "type": "string" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "context", "delegation_id", "run_id", "trace_id", "target", "input_ref", "command_digest", "capability_digest", "catalog_digest", "policy_digest", "idempotency_key", "kind", "actor_scope", "purpose", "priority", "max_attempts", "max_tenant_in_flight" ], "type": "object" }, "ReqDef_KgDelegateSchemaVersion": { "oneOf": [ { "const": "2", "description": "Format identity, not a component name (RF-ADR-006). See\n[`KG_DELEGATE_VERSION`] for what changed.", "type": "string" } ] }, "ReqDef_KnowledgeResultFamily": { "description": "The seven result-producing families sharing the native batch currency.", "enum": [ "graph", "sql", "rdf", "vector", "time_series", "job", "cross_modal" ], "type": "string" }, "ReqDef_KnowledgeStreamCursor": { "description": "Authority-, placement-, query-, snapshot-, and schema-bound resume position.\n\nEvery reference is an opaque `eg::` value. The facade\nvalidates them by constructing `eg_modality::OpaqueRef`s before resuming.", "properties": { "access_policy_ref": { "type": "string" }, "batch_index": { "format": "uint64", "minimum": 0, "type": "integer" }, "batch_size": { "format": "uint32", "minimum": 0, "type": "integer" }, "derivation_ref": { "type": "string" }, "evidence_set_ref": { "type": "string" }, "exhausted": { "type": "boolean" }, "family": { "$ref": "#/components/schemas/ReqDef_KnowledgeResultFamily" }, "integrity_ref": { "description": "Keyed integrity reference over every other cursor field, including the\nposition. It is re-derived from verified request authority on resume.", "type": "string" }, "placement_ref": { "type": "string" }, "query_ref": { "type": "string" }, "row_offset": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "snapshot_ref": { "type": "string" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "family", "integrity_ref", "tenant_ref", "access_policy_ref", "placement_ref", "snapshot_ref", "query_ref", "derivation_ref", "evidence_set_ref", "batch_size", "row_offset", "batch_index", "exhausted" ], "type": "object" }, "ReqDef_KnowledgeStreamProjection": { "description": "Result encoding requested from the one native pull method.\n\n`ArrowIpc` is the sole engine-native result contract.", "enum": [ "arrow_ipc" ], "type": "string" }, "ReqDef_KnowledgeStreamQuery": { "description": "Typed query submitted to the shared result adapter.", "oneOf": [ { "additionalProperties": false, "properties": { "family": { "const": "graph", "type": "string" }, "label": { "default": "", "description": "Empty means every visible node.", "type": "string" }, "limit": { "default": 0, "description": "Total source-row cap; zero means no caller cap.", "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "family" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "sql", "type": "string" }, "params_msgpack": { "default": [], "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "query": { "type": "string" } }, "required": [ "family", "query" ], "type": "object" }, { "additionalProperties": false, "properties": { "base_iri": { "default": "", "type": "string" }, "family": { "const": "rdf", "type": "string" }, "query": { "type": "string" }, "type_convention": { "default": "", "type": "string" } }, "required": [ "family", "query" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "vector", "type": "string" }, "k": { "format": "uint", "minimum": 0, "type": "integer" }, "keywords": { "default": [], "items": { "type": "string" }, "type": "array" }, "query_embedding": { "default": [], "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "family", "k" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "time_series", "type": "string" }, "from": { "format": "int64", "type": "integer" }, "series_id": { "type": "string" }, "to": { "format": "int64", "type": "integer" } }, "required": [ "family", "series_id", "from", "to" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "job", "type": "string" }, "job_id": { "type": "string" } }, "required": [ "family", "job_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "cross_modal", "type": "string" }, "text": { "description": "UQL text parsed into the same plan used by `UnifiedQuery`.", "type": "string" } }, "required": [ "family", "text" ], "type": "object" } ] }, "ReqDef_KnowledgeStreamRequest": { "description": "One pull from the shared served stream.", "properties": { "batch_size": { "description": "Clamped by the server to its safe bound.", "format": "uint32", "minimum": 0, "type": "integer" }, "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_KnowledgeStreamCursor" }, { "type": "null" } ] }, "projection": { "$ref": "#/components/schemas/ReqDef_KnowledgeStreamProjection", "default": "arrow_ipc" }, "query": { "$ref": "#/components/schemas/ReqDef_KnowledgeStreamQuery" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "query", "batch_size" ], "type": "object" }, "ReqDef_LabelRegime": { "description": "What kind of labels the training records carry.", "oneOf": [ { "additionalProperties": false, "description": "Every option's outcome is known, pinned by the gold set's digest.", "properties": { "gold_set_digest": { "type": "string" }, "regime": { "const": "full_label", "type": "string" } }, "required": [ "regime", "gold_set_digest" ], "type": "object" }, { "additionalProperties": false, "description": "Only the acted-on option's outcome is known.", "properties": { "regime": { "const": "bandit_label", "type": "string" } }, "required": [ "regime" ], "type": "object" } ] }, "ReqDef_LabelSource": { "description": "Who produced a full-label acceptability set.", "oneOf": [ { "enum": [ "human" ], "type": "string" }, { "const": "synthetic_construction", "description": "Ground truth by construction (the synthetic suite).", "type": "string" }, { "const": "llm_resolved", "description": "An LLM resolved an abstention. Never a label: a candidate for human\nlabelling only.", "type": "string" } ] }, "ReqDef_LabelledDataset": { "additionalProperties": false, "description": "A labelled dataset, pinned by digest in every job that reads it.", "properties": { "feature_names": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_32" }, "feature_schema_digest": { "description": "`sha256:` of the feature schema body the rows were computed under.", "type": "string" }, "items": { "$ref": "#/components/schemas/ReqDef_BoundedVec_LabelledItem_4096" }, "scale": { "$ref": "#/components/schemas/ReqDef_QuantScaleTag" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "synthetic": { "description": "Synthetic evidence is labelled as such, always.", "type": "boolean" } }, "required": [ "schema_version", "feature_schema_digest", "feature_names", "scale", "items", "synthetic" ], "type": "object" }, "ReqDef_LabelledItem": { "additionalProperties": false, "description": "One labelled decision: its candidates, their feature rows and the label.", "properties": { "audit_inclusion": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_UnitRationalWire" }, { "type": "null" } ], "default": null, "description": "Known inclusion probability of an audit-sampled item; its weight is the\ninverse (EH-026)." }, "candidate_ids": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64" }, "class_key": { "description": "Calibration class (task class); Mondrian guarantees are per class.", "type": "string" }, "features": { "$ref": "#/components/schemas/ReqDef_BoundedVec_int64_2048", "description": "Row-major, `candidate_ids.len() x feature_names.len()`, on the\ndataset's scale." }, "item_id": { "type": "string" }, "label": { "$ref": "#/components/schemas/ReqDef_ItemLabel" }, "recorded_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "item_id", "recorded_at_ms", "class_key", "candidate_ids", "features", "label" ], "type": "object" }, "ReqDef_LagrangeDual": { "additionalProperties": false, "description": "Row multipliers `numerator / denominator`, entries strictly ordered by row.", "properties": { "denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "entries": { "items": { "$ref": "#/components/schemas/ReqDef_DualEntry" }, "type": "array" } }, "required": [ "denominator", "entries" ], "type": "object" }, "ReqDef_LakehouseVectorProjectionRef": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "namespace_id": { "type": "string" }, "projection_id": { "type": "string" }, "source_revision": { "type": "string" }, "table_id": { "type": "string" } }, "required": [ "catalog_id", "namespace_id", "table_id", "projection_id", "source_revision" ], "type": "object" }, "ReqDef_LangfuseObservationRef": { "additionalProperties": false, "description": "One Langfuse observation identity. EG records the opaque receipt and its\ndigest; the Langfuse client/export path remains outside the graph authority.", "properties": { "digest": { "type": "string" }, "observation_id": { "type": "string" } }, "required": [ "observation_id", "digest" ], "type": "object" }, "ReqDef_LeafProof": { "description": "How a leaf of the search tree is closed.", "oneOf": [ { "additionalProperties": false, "description": "`L(dual, path)` is a lower bound on every feasible completion.", "properties": { "bound": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ReqDef_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "bound" ], "type": "object" }, { "additionalProperties": false, "description": "`L(dual, path)` with a zero objective is positive: no feasible completion.", "properties": { "infeasible": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ReqDef_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "infeasible" ], "type": "object" } ] }, "ReqDef_LeasePriority": { "description": "The same four priority tiers `resource_priority.py::PriorityClass` defines,\nvendored here (not imported \u2014 this crate has no Python interop and must not\ndepend on AU) so a `CapacityLease` carries the identical vocabulary the AU\nscheduler already enforces at the LLM gate. `#[derive(Ord)]` on a fieldless\nenum compares by DECLARATION ORDER, so listing `Interactive` first and\n`BackgroundIngestion` last gives `Interactive < Orchestration < Hydration <\nBackgroundIngestion`, matching `core/cognitive_scheduler.py::SchedulerPriority`'s\n\"lower value = higher priority\" convention. `Orchestration`/`Hydration` are\nNOT equal-priority under this `Ord` (AU's equal LLM-gate WEIGHT for the two\nis a separate lookup table, `_PRIORITY_WEIGHTS`, not an enum-ordinal fact \u2014\nsee `resource_priority.py`); only `may_spend_reserved_floor` below is a\nhard cell-admission rule.", "enum": [ "interactive", "orchestration", "hydration", "background_ingestion" ], "type": "string" }, "ReqDef_LevelValue": { "additionalProperties": false, "description": "Value of one objective level under an assignment.", "properties": { "known": { "$ref": "#/components/schemas/ReqDef_Scalar", "description": "Sum of the known coefficients of the selected variables." }, "unknown_selected": { "description": "How many selected variables have an unknown coefficient at this level.", "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "known", "unknown_selected" ], "type": "object" }, "ReqDef_LibraryCandidateScope": { "additionalProperties": false, "description": "Which slice of the agent library the candidates come from.", "properties": { "classification_under": { "default": null, "description": "Restrict to components classified under this ontology term.", "type": [ "string", "null" ] }, "kinds": { "$ref": "#/components/schemas/ReqDef_BoundedVec_AgentComponentKind_16" } }, "required": [ "kinds" ], "type": "object" }, "ReqDef_LineageRecord": { "properties": { "lineage_id": { "type": "string" }, "object_id": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ReqDef_MaterialOperation" }, "parent_content_digests": { "items": { "type": "string" }, "type": "array" }, "source_artifact_digest": { "type": "string" }, "transform_name": { "type": "string" }, "transform_version": { "type": "string" } }, "required": [ "lineage_id", "operation", "object_id", "source_artifact_digest", "transform_name", "transform_version", "parent_content_digests" ], "type": "object" }, "ReqDef_Linkage": { "description": "Hierarchical agglomerative linkage criterion (CONCEPT:EG-KG.mining.hierarchical-linkage).", "enum": [ "single", "complete", "average" ], "type": "string" }, "ReqDef_LogicalName": { "description": "Validated graph or native-resource name with no filesystem semantics.", "type": "string" }, "ReqDef_MaintenanceEnvelope": { "additionalProperties": false, "description": "An owner-maintenance write: compaction, retention, index initialization, a\ncontent-addressed definition insert.\n\nIt is a full mutation -- ledgered, fenced, class-rowed and version-bumping --\nbut it has no caller, so it owns no [`OperationReplayIdentity`], can never\nconsume an attempt nonce, and claims first-wins on `maintenance_key` alone.\n`kind` and `subject` are mandatory so the ledger row NAMES what it wrote\nrather than recording that something was written.", "properties": { "kind": { "description": "What kind of maintenance this is: `index-rebuild`, `series-evict`, ...", "type": "string" }, "maintenance_key": { "description": "`digest(kind, subject, scope, version)` -- the first-wins claim key.", "type": "string" }, "serving_principal": { "type": "string" }, "subject": { "description": "The exact subject the ledger row must name.", "type": "string" } }, "required": [ "serving_principal", "kind", "subject", "maintenance_key" ], "type": "object" }, "ReqDef_MaterialOperation": { "enum": [ "upsert", "delete" ], "type": "string" }, "ReqDef_McpCatalogSnapshotBinding": { "additionalProperties": false, "description": "Exact identity of the served MCP catalog snapshot this pack came from.\n\nThe pack digest binds this whole value. Consequently a stored resource can\nnever be mistaken for one observed under a different configuration,\nconnection or authorization scope even when its own body is byte-identical.", "properties": { "authorization_scope_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "catalog_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "child_connection_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "configuration_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "snapshot_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" } }, "required": [ "configuration_revision", "catalog_generation", "snapshot_digest", "child_connection_generation", "authorization_scope_digest" ], "type": "object" }, "ReqDef_MineAlgorithm": { "description": "Which frequent-itemset engine `MineAssociate` runs (CONCEPT:EG-KG.mining.frequent-itemset-mining).\nAll three are exact and agree on the frequent-itemset set for a given support;\nthey differ only in traversal strategy. FP-Growth is the default (no candidate\ngeneration \u2192 fastest on dense baskets).", "enum": [ "fpgrowth", "apriori", "eclat" ], "type": "string" }, "ReqDef_MineSeqAlgorithm": { "description": "Which sequential-pattern engine `MineSequence` runs (CONCEPT:EG-KG.mining.prefixspan\n\u2014 Phase 4). Both are exact and agree on the frequent-pattern set for a given\nsupport. PrefixSpan is the default (projection-based, no candidate generation).", "enum": [ "prefixspan", "gsp" ], "type": "string" }, "ReqDef_ModalityFacts": { "additionalProperties": false, "description": "Which modalities a component consumes and produces.\n\nNative `eg:modality/*` IRIs, sorted and unique, so two components that\nspeak the same modalities digest identically whatever order they declared\nthem in.", "properties": { "input": { "default": [], "items": { "type": "string" }, "type": "array" }, "output": { "default": [], "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "ReqDef_ModelSpec": { "description": "The model family + its algorithm + free-form hyperparameters. `family` is\n`classify` (node classification), `estimator`/`regress` (regression), or\n`graphlearn`/`kan` (link prediction \u2014 the KAN one-off, now a pipeline family).\n`algorithm` selects within the family (e.g. classify \u2192 `logistic`; estimator \u2192\n`ridge`). `params` carries family-specific knobs the handler reads with defaults.", "properties": { "algorithm": { "default": "", "type": "string" }, "family": { "default": "classify", "type": "string" }, "params": { "default": {} } }, "type": "object" }, "ReqDef_MultimodalAssetRef": { "additionalProperties": false, "properties": { "asset_id": { "type": "string" }, "asset_revision": { "type": "string" }, "content_digest": { "type": "string" }, "media_kind": { "type": "string" } }, "required": [ "asset_id", "media_kind", "asset_revision", "content_digest" ], "type": "object" }, "ReqDef_MutationBatch": { "additionalProperties": false, "description": "Universal, deterministic durable mutation unit.", "properties": { "authoritative_state": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_MutationStateDescriptor" }, { "type": "null" } ], "description": "Present when operations are represented by a complete staged graph image." }, "batch_id": { "description": "Stable identity for status lookup and outbox correlation.", "type": "string" }, "created_at_ms": { "description": "Creation time supplied by the request boundary.", "format": "uint64", "minimum": 0, "type": "integer" }, "envelope": { "$ref": "#/components/schemas/ReqDef_MutationEnvelope", "description": "The admission header this batch is admitted under: verified caller\nauthority for an operation, the store's own declaration for maintenance." }, "fencing_token": { "description": "Lease/worker fencing epoch for work-driven writes.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "identity": { "$ref": "#/components/schemas/ReqDef_MutationScopeIdentity", "description": "Exact tenant, typed logical owner, lifecycle generation, and digest." }, "operations": { "items": { "$ref": "#/components/schemas/ReqDef_MutationOperation" }, "type": "array" }, "outbox": { "items": { "$ref": "#/components/schemas/ReqDef_MutationOutboxIntent" }, "type": "array" }, "placement_epoch": { "description": "Catalog epoch used to resolve a placed owner.", "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "version_expectation": { "$ref": "#/components/schemas/ReqDef_VersionExpectation" } }, "required": [ "schema_version", "batch_id", "envelope", "identity", "placement_epoch", "version_expectation", "operations", "outbox", "created_at_ms" ], "type": "object" }, "ReqDef_MutationCapability": { "description": "Admission capabilities that materially change persistence semantics.", "oneOf": [ { "const": "unversioned_system_mutation", "description": "Reserved for authenticated first-boot/system-recovery operations.", "type": "string" } ] }, "ReqDef_MutationEnvelope": { "description": "The admission header of one durable batch.", "oneOf": [ { "additionalProperties": false, "description": "A caller operation: verified authority, one stable operation identity and\none attempt nonce identity.", "properties": { "operation": { "$ref": "#/components/schemas/ReqDef_OperationEnvelope" } }, "required": [ "operation" ], "type": "object" }, { "additionalProperties": false, "description": "An owner-maintenance write: no caller, therefore no operation identity and\nno attempt nonce (RF-RULING-005).", "properties": { "maintenance": { "$ref": "#/components/schemas/ReqDef_MaintenanceEnvelope" } }, "required": [ "maintenance" ], "type": "object" } ] }, "ReqDef_MutationOperation": { "additionalProperties": false, "description": "One ordered engine operation in a [`MutationBatch`].", "properties": { "domain": { "$ref": "#/components/schemas/ReqDef_DurabilityDomain", "description": "Required authoritative domain." }, "method": { "$ref": "#" }, "ordinal": { "format": "uint32", "minimum": 0, "type": "integer" }, "surface": { "$ref": "#/components/schemas/ReqDef_MutationSurface" } }, "required": [ "ordinal", "surface", "domain", "method" ], "type": "object" }, "ReqDef_MutationOutboxIntent": { "additionalProperties": false, "description": "A projection/index/CDC/audit/lineage notification to publish after commit.", "properties": { "headers": { "additionalProperties": { "type": "string" }, "type": "object" }, "key": { "type": "string" }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "topic": { "type": "string" } }, "required": [ "topic", "key", "payload", "headers" ], "type": "object" }, "ReqDef_MutationOutboxLease": { "additionalProperties": false, "description": "Durable lease over an outbox row.", "properties": { "attempt": { "format": "uint32", "minimum": 0, "type": "integer" }, "consumer": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_until_ms": { "description": "EXCLUSIVE upper bound, mirroring `eg_transaction::outbox::rows::\nOutboxDelivery::lease_until_ms` (the durable row this lease is\nissued over): valid while `now_ms < lease_until_ms`, expired once\n`now_ms >= lease_until_ms`. `now_ms == lease_until_ms` is already\nexpired, not still valid.", "format": "uint64", "minimum": 0, "type": "integer" }, "record": { "$ref": "#/components/schemas/ReqDef_MutationOutboxRecord" } }, "required": [ "record", "consumer", "lease_epoch", "lease_until_ms", "attempt" ], "type": "object" }, "ReqDef_MutationOutboxOp": { "description": "Every mutation-outbox operation.", "oneOf": [ { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "op": { "const": "status", "type": "string" }, "target": { "$ref": "#/components/schemas/ReqDef_OutboxTarget" } }, "required": [ "op", "target", "consumer" ], "type": "object" }, { "additionalProperties": false, "properties": { "after": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_OutboxPositionView" }, { "type": "null" } ], "default": null }, "consumer": { "type": "string" }, "limit": { "description": "At most [`MAX_OUTBOX_DEAD_LETTER_PAGE`].", "format": "uint32", "minimum": 0, "type": "integer" }, "op": { "const": "dead_letters", "type": "string" }, "target": { "$ref": "#/components/schemas/ReqDef_OutboxTarget" } }, "required": [ "op", "target", "consumer", "limit" ], "type": "object" }, { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "op": { "const": "rewind", "type": "string" }, "target": { "$ref": "#/components/schemas/ReqDef_OutboxTarget" }, "to": { "$ref": "#/components/schemas/ReqDef_RewindTarget" } }, "required": [ "op", "target", "consumer", "to" ], "type": "object" } ] }, "ReqDef_MutationOutboxRecord": { "additionalProperties": false, "description": "One durable outbox row.", "properties": { "batch_id": { "type": "string" }, "commit_sequence": { "default": null, "description": "The scope version after the batch committed. Legacy rows may omit\nthis field and are rejected when their original order is unverifiable.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "committed_version": { "$ref": "#/components/schemas/ReqDef_CommittedVersion" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "identity": { "$ref": "#/components/schemas/ReqDef_MutationScopeIdentity" }, "intent": { "$ref": "#/components/schemas/ReqDef_MutationOutboxIntent" }, "ordinal": { "format": "uint32", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "batch_id", "ordinal", "identity", "committed_version", "intent", "created_at_ms" ], "type": "object" }, "ReqDef_MutationScope": { "description": "Typed logical owner of a durable mutation.", "oneOf": [ { "additionalProperties": false, "properties": { "graph": { "$ref": "#/components/schemas/ReqDef_LogicalName" }, "kind": { "const": "graph", "type": "string" } }, "required": [ "kind", "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "domain": { "$ref": "#/components/schemas/ReqDef_DurabilityDomain" }, "kind": { "const": "native", "type": "string" }, "resource": { "$ref": "#/components/schemas/ReqDef_LogicalName" } }, "required": [ "kind", "domain", "resource" ], "type": "object" } ] }, "ReqDef_MutationScopeDigest": { "description": "Canonical SHA-256 identity digest persisted with every authority-bearing row.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "maxItems": 32, "minItems": 32, "type": "array" }, "ReqDef_MutationScopeIdentity": { "additionalProperties": false, "description": "Tenant + typed logical owner + exact lifecycle generation.", "properties": { "identity_digest": { "$ref": "#/components/schemas/ReqDef_MutationScopeDigest" }, "incarnation_id": { "$ref": "#/components/schemas/ReqDef_IncarnationId" }, "scope": { "$ref": "#/components/schemas/ReqDef_MutationScope" }, "tenant": { "$ref": "#/components/schemas/ReqDef_ScopeTenantId" } }, "required": [ "tenant", "scope", "incarnation_id", "identity_digest" ], "type": "object" }, "ReqDef_MutationStateDescriptor": { "additionalProperties": false, "description": "Digest/version descriptor for authenticated authoritative graph material.", "properties": { "algorithm": { "type": "string" }, "digest": { "type": "string" }, "source_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "target_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "algorithm", "digest", "source_graph_version", "target_graph_version" ], "type": "object" }, "ReqDef_MutationSurface": { "description": "Origin surface for an operation. The durable semantics never depend on this\nvalue; it exists for policy/audit/projection consumers.", "enum": [ "graph", "transaction", "query", "rdf", "lifecycle", "job", "broker", "other" ], "type": "string" }, "ReqDef_NativeControlSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_NativeOutboxStore": { "description": "Which native owner's outbox this is.\n\nClosed, and closed on purpose: an outbox nobody named is an outbox nobody\nmonitors, so a new durable owner has to be added here to be operable.", "enum": [ "agent_library", "semantic_index", "jobs", "sql_catalog" ], "type": "string" }, "ReqDef_Nonce": { "description": "32 bytes of attempt nonce as lowercase hexadecimal", "maxLength": 64, "minLength": 64, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "ReqDef_ObdaExternalSource": { "description": "CONCEPT:EG-KG.query.obda-predicate-pushdown \u2014 a LIVE EXTERNAL relational source registered\nfor an OBDA virtual graph (W4.11): a `TriplesMap::logical_source` NAME bound to a `table`\nin an external Postgres/MySQL database reachable at `dsn`. On a [`Method::SparqlVirtual`]\nquery the engine exposes it as a virtual RDF graph and pushes BOTH the query's column\nprojection AND its row-level `FILTER`s down into a real `SELECT \u2026 WHERE \u2026` against the\ndatabase \u2014 the whole table is never scanned. The live SQL path needs a server built with\n`federation-sql` (reusing its SSRF-validated, read-only, timeout+row-bounded connector); a\nbuild without it returns a clean \"rebuild with federation-sql\" error. Distinct from\n`tables` (the engine's OWN user tables).", "properties": { "dsn": { "description": "The external database DSN (`postgres://\u2026` / `mysql://\u2026`), SSRF-validated server-side.", "type": "string" }, "name": { "description": "The foreign-source NAME the mapping's `TriplesMap`(s) reference as `logical_source`.", "type": "string" }, "table": { "description": "The table (or view) name in the external database to expose as the virtual source.", "type": "string" } }, "required": [ "name", "dsn", "table" ], "type": "object" }, "ReqDef_ObjectiveLevelKind": { "description": "One level of the objective, named rather than positional so a record says\nwhich quantity a budget was exhausted on.", "oneOf": [ { "const": "uncovered", "description": "How many required capabilities stay uncovered.", "type": "string" }, { "const": "components", "description": "How many components the assembly selects.", "type": "string" }, { "const": "declared_cost", "description": "Declared cost of the selection, in the budget's currency.", "type": "string" }, { "const": "declared_p95_latency", "description": "Declared p95 latency of the selection.", "type": "string" } ] }, "ReqDef_ObjectiveLevelSpec": { "additionalProperties": false, "description": "One level of the lexicographic objective (minimised).", "properties": { "label": { "type": "string" }, "terms": { "items": { "$ref": "#/components/schemas/ReqDef_ObjectiveTerm" }, "type": "array" } }, "required": [ "label", "terms" ], "type": "object" }, "ReqDef_ObjectiveOrder": { "description": "How the objective levels combine.", "oneOf": [ { "additionalProperties": false, "description": "Strict priority: any change in an earlier level outweighs every\npossible change in all later ones together.", "properties": { "levels": { "$ref": "#/components/schemas/ReqDef_BoundedVec_ObjectiveLevelKind_8" }, "order": { "const": "lexicographic", "type": "string" } }, "required": [ "order", "levels" ], "type": "object" }, { "additionalProperties": false, "description": "One weighted sum.", "properties": { "order": { "const": "weighted", "type": "string" }, "weights": { "$ref": "#/components/schemas/ReqDef_BoundedVec_WeightedLevel_8" } }, "required": [ "order", "weights" ], "type": "object" } ] }, "ReqDef_ObjectiveTerm": { "additionalProperties": false, "description": "One term of an objective level.", "properties": { "coefficient": { "$ref": "#/components/schemas/ReqDef_Coefficient" }, "var": { "$ref": "#/components/schemas/ReqDef_VarId" } }, "required": [ "var", "coefficient" ], "type": "object" }, "ReqDef_ObjectiveValue": { "additionalProperties": false, "description": "Every level's value plus the exact scalarised objective.", "properties": { "levels": { "items": { "$ref": "#/components/schemas/ReqDef_LevelValue" }, "type": "array" }, "scalar": { "$ref": "#/components/schemas/ReqDef_Scalar" } }, "required": [ "levels", "scalar" ], "type": "object" }, "ReqDef_ObservationRef": { "additionalProperties": false, "description": "A pointer to a recorded evaluation, for a fact that was MEASURED rather\nthan declared.", "properties": { "digest": { "type": "string" }, "evaluation_id": { "type": "string" } }, "required": [ "evaluation_id", "digest" ], "type": "object" }, "ReqDef_Op": { "description": "One cross-modal operator. A [`Plan`] is an ordered list of these \u2014 a pipeline\nwhere each op `(RowSet) -> RowSet`. This increment binds SQL + graph + vector\n(`Scan | Filter | Traverse | Rank | Limit`); reasoning/blob ops are later\nincrements. The algorithm lives in `eg-plan`; this is the wire DTO.", "oneOf": [ { "additionalProperties": false, "description": "SOURCE \u2014 seed from all nodes carrying `label` (`type == label`).", "properties": { "Scan": { "properties": { "label": { "type": "string" } }, "required": [ "label" ], "type": "object" } }, "required": [ "Scan" ], "type": "object" }, { "additionalProperties": false, "description": "FILTER (relational) \u2014 keep rows matching ALL `preds`, via real DataFusion.", "properties": { "Filter": { "properties": { "preds": { "items": { "$ref": "#/components/schemas/ReqDef_Pred" }, "type": "array" } }, "required": [ "preds" ], "type": "object" } }, "required": [ "Filter" ], "type": "object" }, { "additionalProperties": false, "description": "TRAVERSE (graph) \u2014 follow `rel` edges `min..=max` hops (petgraph BFS).", "properties": { "Traverse": { "properties": { "max": { "format": "uint", "minimum": 0, "type": "integer" }, "min": { "format": "uint", "minimum": 0, "type": "integer" }, "rel": { "type": "string" } }, "required": [ "rel", "min", "max" ], "type": "object" } }, "required": [ "Traverse" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (vector) \u2014 re-order by cosine similarity to `query` (SemanticStore kNN).", "properties": { "Rank": { "properties": { "query": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "query" ], "type": "object" } }, "required": [ "Rank" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (vector-from-TEXT, CONCEPT:EG-KG.compute.no-embedder-bound-op) \u2014 like `Rank`, but the query vector is\nRESOLVED at exec time from the natural-language `text` by the server-side embedder\nbound on the `PlanCtx` (`eg_plan::PlanCtx::with_embedder`). This closes the UQL\n`RANK BY ~ \"text\"` NL\u2192vector seam: the front-end no longer needs the caller to\npre-embed and pass a literal vector. With NO embedder bound the op is a clean typed\nERROR (never a panic) \u2014 the documented unbound behavior. Base `query` (the\n`TextEmbedder` trait is dep-free; the kNN reuses the SAME `SemanticStore` path as\n`Rank`, so a build without an embedder is byte-for-byte unchanged).", "properties": { "RankEmbed": { "properties": { "text": { "type": "string" } }, "required": [ "text" ], "type": "object" } }, "required": [ "RankEmbed" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (graph distance, CONCEPT:EG-KG.query.uql-parser-ops) \u2014 re-order the candidate set by inverse\nshortest-path hop distance from `center` over the graph topology, score\n`1/(1+hops)` (unreachable \u2192 0). A graph-NATIVE reranker (Graphiti's\n`node_distance`): proximity to a focal node, fused alongside vector/BM25. Reuses\nthe same BFS the `Traverse` leg uses; dep-free, so it ships under base `query`.", "properties": { "RankNodeDistance": { "properties": { "center": { "type": "string" } }, "required": [ "center" ], "type": "object" } }, "required": [ "RankNodeDistance" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (provenance salience, CONCEPT:EG-KG.query.uql-parser-ops) \u2014 re-order the candidate set by how\nmany edges MENTION each node (incoming-edge count), score normalized to the max\nin the set. Graphiti's `episode_mentions` salience: a node many episodes point at\nranks higher. Topology-only, dep-free, base `query`.", "properties": { "RankMentions": { "type": "object" } }, "required": [ "RankMentions" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (MMR diversity, CONCEPT:AU-KG.retrieval.mmr-diversification) \u2014 re-order the candidate set by Maximal\nMarginal Relevance: greedily pick the next item maximizing\n`lambda*rel - (1-lambda)*max_sim_to_already_picked`, where rel is the item's\nincoming relevance score (from a prior `Rank`) and sim is cosine over stored\nembeddings. Reduces near-duplicate redundancy in the top-k \u2014 the diversity\nreranker Graphiti does NOT have. `k` caps how many to re-rank (0 \u21d2 all). Reads\n`ctx.semantic` (always present), so base `query`.", "properties": { "RankMmr": { "properties": { "k": { "format": "uint", "minimum": 0, "type": "integer" }, "lambda": { "format": "float", "type": "number" } }, "required": [ "lambda", "k" ], "type": "object" } }, "required": [ "RankMmr" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (lexical, BM25) \u2014 re-order the candidate set by BM25 relevance to the\nnatural-language `query` string over the text index (CONCEPT:AU-KG.query.text-spatial-time). A\nsibling of the vector `Rank`: it produces a score-per-id over the SAME RowSet\ncurrency, so the closed algebra is unchanged. Gated by `text` (the Tantivy\nindex lives in eg-text behind its own gate; this is just the wire variant).", "properties": { "RankText": { "properties": { "query": { "type": "string" } }, "required": [ "query" ], "type": "object" } }, "required": [ "RankText" ], "type": "object" }, { "additionalProperties": false, "description": "FUSE (hybrid) \u2014 reciprocal-rank-fusion of N SUB-PLAN `branches` over the SAME\nseed into ONE ranked RowSet (CONCEPT:AU-KG.query.text-spatial-time / KG-2.253). The modern hybrid-\nretrieval pattern, generalized past two legs: fuse the RANKS (not the\nincomparable BM25/cosine/distance scores) so a doc strong across MORE branches\nout-ranks one strong in only one. The canonical tri-modal hybrid is\n`branches = [[Rank{vec}], [RankText{q}], [RankNodeDistance{c}]]`. `k` is the RRF\ndamping constant (use `eg_text::RRF_K` = 60 by convention; `0.0` \u21d2 that default).", "properties": { "FuseRrf": { "properties": { "branches": { "items": { "items": { "$ref": "#/components/schemas/ReqDef_Op" }, "type": "array" }, "type": "array" }, "k": { "format": "float", "type": "number" } }, "required": [ "branches", "k" ], "type": "object" } }, "required": [ "FuseRrf" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (semantic, OWL) \u2014 seed the RowSet with every individual the native OWL 2\nreasoner INFERS to be a member of `target_class` (CONCEPT:EG-KG.ontology.incremental-materialization/220). The\nreasoner classifies the graph's TBox (the OWL axioms loaded as RDF) and returns\nthe instances of `target_class` \u2014 INCLUDING ones reached through existential\nrestrictions / role chains for which the property-graph stored NO explicit type\nedge. `ontology` (Turtle) carries the axioms; an empty string \u21d2 use the axioms\nalready in the graph. The result then flows \u2014 like any RowSet \u2014 into a graph\n`Traverse`, a vector `Rank`, a SQL `Filter`, or a `Limit`. Gated by `owl`.", "properties": { "Reason": { "properties": { "ontology": { "default": "", "description": "OWL axioms as a Turtle document. Empty \u21d2 classify the axioms already loaded\ninto the request's graph.", "type": "string" }, "target_class": { "description": "The named class whose (inferred) members seed the RowSet (canonical ``\nor a bare IRI string \u2014 both are accepted).", "type": "string" } }, "required": [ "target_class" ], "type": "object" } }, "required": [ "Reason" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (semantic, SPARQL) \u2014 seed the RowSet with the node bindings of `var` in\nthe result of the SPARQL `query` (a basic graph pattern, CONCEPT:EG-KG.ontology.concept-12),\nevaluated over the request's graph. A SPARQL-selected candidate set as a normal\nRowSet source: it then flows into the SAME graph/vector/SQL/time ops as any\nother op. Gated by `owl` (which implies `sparql`).", "properties": { "SparqlBgp": { "properties": { "query": { "description": "A SPARQL 1.1 SELECT (the basic-graph-pattern surface eg-rdf evaluates).", "type": "string" }, "var": { "description": "The projected variable whose (resource) bindings become the RowSet ids.", "type": "string" } }, "required": [ "query", "var" ], "type": "object" } }, "required": [ "SparqlBgp" ], "type": "object" }, { "additionalProperties": false, "description": "UDF (WASM) \u2014 transform the current `RowSet` through a registered, SANDBOXED\nWebAssembly user function (CONCEPT:EG-KG.query.rowset-execution). The executor serializes the input\nrows (ids + scores) to bytes, runs the wasm module `id` under fuel + memory\nlimits with NO host capabilities, and deserializes the returned rows back into\nthe pipeline. A pure `RowSet -> RowSet` op like every other, so a UDF composes\nwith Scan/Filter/Traverse/Rank/Limit. Gated by `wasm-udf` (the wasmtime runtime\nlives in eg-wasm behind its own gate; this is just the wire variant).", "properties": { "Udf": { "properties": { "id": { "type": "string" } }, "required": [ "id" ], "type": "object" } }, "required": [ "Udf" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (federation) \u2014 read rows from an EXTERNAL source and seed the RowSet\n(CONCEPT:EG-KG.query.query-federation, Lane P). `source` is either a REMOTE epistemic-graph engine\n(queried over the same transport) or a generic HTTP/JSON API \u2014 see\n[`ForeignSourceSpec`]. The resulting RowSet then flows \u2014 like any other source\nop \u2014 into a downstream `Filter`/`Traverse`/`Rank`/`Limit`, so a federated query\nJOINS a foreign source with the LOCAL graph in ONE plan. A `ForeignScan` placed\nAFTER a local source op replaces the input (it is a source, not a transform),\nexactly like `Scan`/`Reason`/`SparqlBgp`. Gated by `federation` (the HTTP client\nis rustls/pure-Rust and kept OUT of the Pi tier \u2014 the Pi contract).\n\n`ForeignScan` is the RESOLVED federation EXECUTOR (it carries a fully-specified\n[`ForeignSourceSpec`] and actually fetches+joins). The UQL `FOREIGN \"\"`\nclause (CONCEPT:EG-KG.query.sparql-completeness) instead lowers to the lighter [`Op::Foreign`] name\nMARKER below \u2014 the parser only has a name, and resolving that name to a concrete\n`ForeignSourceSpec` goes through the server-side `foreign_sources` map, which the\nserved query handler turns into eg-plan's own `ForeignSourceRegistry` and binds\nonto the `PlanCtx` (CONCEPT:EG-KG.query.closure-backed-source). The two are\ncomplementary: `Foreign`\nis the named-reference surface, `ForeignScan` is the resolved executor a\nserver/planner constructs.", "properties": { "ForeignScan": { "properties": { "join": { "default": false, "description": "When this `ForeignScan` is NOT the first op, intersect its rows with the\ncurrent candidate set (a foreign\u2229local JOIN keyed on id) instead of\nreplacing the input. The default (false) makes it a pure source. The\npreceding rows' ORDER is preserved on an intersect.", "type": "boolean" }, "source": { "$ref": "#/components/schemas/ReqDef_ForeignSourceSpec" } }, "required": [ "source" ], "type": "object" } }, "required": [ "ForeignScan" ], "type": "object" }, { "additionalProperties": false, "description": "TIME (`AS OF [TX] @`, CONCEPT:EG-KG.query.sparql-completeness / KG-2.250) \u2014 pin the RowSet to a\npoint-in-time `ts` (unix seconds) and DROP rows not live at that instant. A\nRowSet-narrowing temporal filter executed in `eg-plan` (dep-free blob scan, no\nDataFusion \u2014 Pi-safe). `axis` selects the timeline: `Valid` = \"what was TRUE at\nts\" (`valid_from`/`valid_until`); `Transaction` = \"what we BELIEVED at ts\"\n(`tx_from`/`tx_to`). The axis is explicit in the current plan contract.", "properties": { "AsOf": { "properties": { "axis": { "$ref": "#/components/schemas/ReqDef_TimeAxis" }, "ts": { "format": "double", "type": "number" } }, "required": [ "ts", "axis" ], "type": "object" } }, "required": [ "AsOf" ], "type": "object" }, { "additionalProperties": false, "description": "TIME (`WINDOW `, CONCEPT:EG-KG.query.sparql-completeness) \u2014 declare a trailing time window of\n`secs` seconds for the windowed time-series aggregate. A RowSet-preserving\nCONTEXT op paired with `AsOf`; passes the rows through unchanged today (the\nwindowed aggregate is the eg-tsdb seam) but lets the `WINDOW ` UQL clause\nlower to ONE plan AST. Always available under `query`.\n\nAs of CONCEPT:EG-KG.compute.tsscan-series-window-60s the executor no longer merely passes the rows through: an\n`Op::Window` over a RowSet of `(ts, value)` rows (e.g. from `Op::TsScan`, or any\nscored row) now emits a REAL tumbling windowed aggregate (MEAN, via eg-tsdb's\n`time_bucket`) \u2014 one row per non-empty bucket (`id` = the aligned bucket start,\n`score` = the aggregate) \u2014 composing downstream into `Rank`/`Limit`. Under a\nnon-`timeseries` build the op keeps its RowSet-preserving passthrough behavior.", "properties": { "Window": { "properties": { "secs": { "format": "double", "type": "number" } }, "required": [ "secs" ], "type": "object" } }, "required": [ "Window" ], "type": "object" }, { "additionalProperties": false, "description": "TIME (`WINDOW `, CONCEPT:EG-KG.compute.trailing-aggregate-selector-lowers) \u2014 the SELECTABLE-aggregate form of\n`Op::Window`: a real tumbling windowed aggregate over `(ts, value)` rows whose\naggregate function `agg` (one of `mean`/`avg`, `sum`, `min`, `max`, `count`,\n`first`, `last`; unknown \u21d2 `mean`) is resolved to an `eg_tsdb::query::Agg`. Emits\none row per non-empty bucket (`id` = aligned bucket start, `score` = the aggregate),\ncomposing downstream exactly like `Window`. Base `query` (the eg-tsdb aggregate is\nonly wired under `timeseries`; a non-`timeseries` build passes the rows through, as\n`Window` does).", "properties": { "WindowAgg": { "properties": { "agg": { "type": "string" }, "secs": { "format": "double", "type": "number" } }, "required": [ "secs", "agg" ], "type": "object" } }, "required": [ "WindowAgg" ], "type": "object" }, { "additionalProperties": false, "description": "FEDERATION (`FOREIGN \"\"`, CONCEPT:EG-KG.query.sparql-completeness) \u2014 replace the seed with rows from\nthe registered foreign source `name`. The plan fails when no registry/source is\nbound; foreign intent is never ignored. Always available under `query`, while\nexecution requires the `federation` feature. The inline-spec counterpart is the\n`federation`-gated [`Op::ForeignScan`] above.", "properties": { "Foreign": { "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "Foreign" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (spatial, CONCEPT:EG-KG.ontology.singles-concept) \u2014 seed the RowSet with every node in the spatial\n`layer` (a node label / `type`) whose geometry's bounding box intersects `bbox`\n(`[minx, miny, maxx, maxy]`). The executor builds eg-geo's packed Hilbert R-tree\nover the layer's geometries and runs `query_bbox`, so the returned candidate set\nthen flows \u2014 like any source op \u2014 into a downstream spatial `Filter`\n(`SpatialWithin`/`SpatialDWithin`) / `Traverse` / `Rank` / `Limit`, composing a\nspatial filter with graph + vector in ONE plan. Gated by `geo` (the geometry model\n+ R-tree live in eg-geo behind eg-plan's own `geo` gate; this is the wire variant).", "properties": { "SpatialScan": { "properties": { "bbox": { "items": { "format": "double", "type": "number" }, "maxItems": 4, "minItems": 4, "type": "array" }, "layer": { "type": "string" } }, "required": [ "layer", "bbox" ], "type": "object" } }, "required": [ "SpatialScan" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (spatial CRS, CONCEPT:EG-KG.domains.coordinate-reference-system) \u2014 reproject each row's stored geometry into\nthe target CRS `to_epsg`. The SOURCE CRS is the row geometry's EWKT `SRID=\u2026;` tag\nwhen present, else the explicit `from_epsg` override. Rows with no/invalid geometry,\nno resolvable source CRS, or an unsupported EPSG code are DROPPED (order-preserving,\nexactly as the tensor/spatial legs narrow their input) \u2014 the derived geometry\nvalidates the transform per row. The pure-Rust reprojection math (WGS84 / Web-Mercator\n/ UTM, NO PROJ C dep) lives in eg-geo behind eg-plan's `geo` gate; this is the\nCRS-carrying wire variant. Gated by `geo`.", "properties": { "Reproject": { "properties": { "from_epsg": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "to_epsg": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "to_epsg" ], "type": "object" } }, "required": [ "Reproject" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (constructive geometry, CONCEPT:EG-KG.ontology.concept-9) \u2014 apply the constructive op `kind`\n(buffer / convex-hull / simplify / centroid / union / intersection / difference) to\neach row's stored geometry, producing a DERIVED geometry per row. Rows whose geometry\nis missing/invalid or where the op yields nothing (e.g. an empty intersection) are\nDROPPED \u2014 order- and score-preserving, exactly as the tensor `TensorOp` leg. The\npure-Rust algebra lives in eg-geo behind eg-plan's `geo` gate; this is the wire\nvariant. Gated by `geo`.", "properties": { "SpatialOp": { "properties": { "kind": { "$ref": "#/components/schemas/ReqDef_SpatialOpKind" } }, "required": [ "kind" ], "type": "object" } }, "required": [ "SpatialOp" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (tensor, CONCEPT:EG-KG.storage.content-addressed-dedup) \u2014 seed the RowSet with every node in the `layer`\n(a node label / `type`) that carries a stored tensor (a dense N-D array in the\nconventional `tensor` node property). The returned candidate set then flows \u2014\nlike any source op \u2014 into a downstream `TensorOp` (slice/reduce/elementwise) /\n`Traverse` / `Rank` / `Limit`, composing an array modality with graph + vector in\nONE plan. Gated by `tensor` (the N-D array model + ops live in eg-tensor behind\neg-plan's own `tensor` gate; this is the wire variant). The persisted tensors are\ncontent-addressed in the blob CAS per the concept row (`ChunkStore` + EG-071).", "properties": { "TensorScan": { "properties": { "layer": { "type": "string" } }, "required": [ "layer" ], "type": "object" } }, "required": [ "TensorScan" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (tensor, CONCEPT:EG-KG.storage.content-addressed-dedup) \u2014 apply the eg-tensor op `kind`\n(slice/reduce/elementwise) to each row's stored tensor. Rows whose tensor is\nmissing/invalid or where the op fails are dropped (order-preserving), exactly as\nthe spatial `Filter` leg drops rows with no geometry. Gated by `tensor`; the\nN-D array math lives in eg-tensor behind eg-plan's `tensor` gate.", "properties": { "TensorOp": { "properties": { "kind": { "$ref": "#/components/schemas/ReqDef_TensorOpKind" } }, "required": [ "kind" ], "type": "object" } }, "required": [ "TensorOp" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (stream, CONCEPT:EG-KG.query.pipelined-execution) \u2014 run the bounded NFA CEP engine (eg-stream)\nover the input RowSet interpreted as a time-ordered event stream: each row's node\nblob carries `ts`/`key`/`attrs`, and the op keeps the rows that participate in a\ndetected match (order-preserving, exactly as the spatial/tensor legs narrow their\ninput). `pattern` carries the pattern tree (sequence/within/absence) + the\nsliding/tumbling `window`. Gated by `stream` (the NFA lives in eg-stream behind\neg-plan's own `stream` gate; this is the wire variant). EG-067 `Op::Window` is the\nwindowing primitive; a live standing CEP query fed by the EG-064 CDC\n`ChangeNotifier` bus is a documented follow-up \u2014 the batch `Op::Cep` over a RowSet\nis what lands.", "properties": { "Cep": { "properties": { "pattern": { "$ref": "#/components/schemas/ReqDef_CepPatternSpec" } }, "required": [ "pattern" ], "type": "object" } }, "required": [ "Cep" ], "type": "object" }, { "additionalProperties": false, "description": "FUSE (multimodal sensor fusion, CONCEPT:EG-KG.query.multi-rate-sensor-stream) \u2014 time-align N heterogeneous sensor\n`streams` to ONE common clock and emit fused multi-channel rows. Each named stream is\na node layer (label / `type`) whose nodes carry a `valid_from` event time and either a\nscalar `value` OR an opaque tensor-blob reference (an EG-085 camera/LiDAR frame). The\nexecutor resolves the streams off the snapshot, calls eg-tsdb's `sensor_fuse` \u2014 which\nreuses the eg-tsdb ASOF backward-join to carry each stream's latest sample at-or-before\neach reference instant, within `tolerance_ns` \u2014 and emits one fused row per instant\n(id = the aligned ts, score = the count of present, non-gap channels) so a downstream\n`Limit`/`Rank` composes over the fused series. `tolerance_ns` is the max staleness (ns)\na channel may carry forward; `0` \u21d2 exact-instant matches only. Gated behind\n`timeseries`; the variant only exists when eg-types/timeseries is on (pulled by\neg-plan/timeseries), so a non-timeseries build has neither the variant nor its executor\narm (the tensor/stream gating precedent). Composes EG-085 + EG-088 + eg-tsdb ASOF\n(EG-067); the alignment math lives in eg-tsdb behind eg-plan's `timeseries` gate \u2014 this\nis the pure-serde wire variant.", "properties": { "SensorFuse": { "properties": { "streams": { "items": { "type": "string" }, "type": "array" }, "tolerance_ns": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "streams", "tolerance_ns" ], "type": "object" } }, "required": [ "SensorFuse" ], "type": "object" }, { "additionalProperties": false, "description": "FUSE (multimodal sensor fusion on a DECLARED clock, CONCEPT:EG-KG.query.multi-rate-sensor-stream) \u2014\nthe fixed-grid / tumbling-window sibling of `Op::SensorFuse`. Where `SensorFuse` fuses\nonto the UNION clock of the samples (data-driven instants, ASOF/tolerance only), this\nop resamples every stream onto the time base the caller DECLARES in `clock`\n([`FuseClock::Uniform`] grid or [`FuseClock::Tumbling`] EG-067 windows), each stream\nunder its OWN [`FuseInterp`] mode (`Nearest` / `Linear` / `AsofHold`) \u2014 so the output\ninstants, and the values at them, are independent of when the sensors happened to fire.\nThat is a different semantics, not a different spelling: a `Linear` channel yields a\ngenuinely INTERPOLATED reading at a grid instant no sample sits on, which ASOF cannot\nproduce.\n\nA SOURCE op: it resolves its streams off the snapshot and REPLACES the input, exactly\nlike `SensorFuse` / `TensorScan` / `SpatialScan`. The executor stacks the aligned\nchannels into a `[timesteps \u00d7 channels]` eg-tensor frame + validity mask\n(`eg_tensor::fusion`) and projects ONE row per clock instant: `id` = the instant (or\nwindow start), `score` = the PRIMARY channel's (stream 0) fused reading \u2014 the\n`Op::TsScan` \"field 0\" projection lifted onto the fused frame \u2014 or `None` where that\nchannel gapped. An instant at which EVERY channel is a gap emits NO row, so the\nvalidity mask is what decides emission.\n\n`tolerance_ns` bounds per-channel staleness (`None` = unbounded): a `Nearest`/\n`AsofHold` match farther away than it, or a `Linear` bracket wider than it, is a GAP.\n\nGated behind `timeseries` (the SensorFuse gating precedent); the alignment math lives\nin `eg_tsdb::fusion` and the tensor stacking in `eg_tensor::fusion`, both behind\neg-plan's `timeseries` gate \u2014 this is the pure-serde wire variant.", "properties": { "SensorAlign": { "properties": { "clock": { "$ref": "#/components/schemas/ReqDef_FuseClock" }, "streams": { "items": { "$ref": "#/components/schemas/ReqDef_FuseStream" }, "type": "array" }, "tolerance_ns": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "streams", "clock" ], "type": "object" } }, "required": [ "SensorAlign" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (time-series, CONCEPT:EG-KG.query.native-time-series) \u2014 seed the RowSet from native TSDB series.\nScans each series in `series` for points in the `[from, to)` timestamp window and\nemits them as rows so a downstream `Rank`/`Limit`/`Filter` composes the tsdb leg\nwith the graph/vector/relational legs in ONE plan (tsdb-in-plan fusion). Bounds\nare `f64` seconds (uniform with the other numeric plan ops); the executor lowers\nthem to the eg-tsdb `SeriesStore` ns range internally. Gated behind `timeseries`;\nthe variant only exists when eg-types/timeseries is on (pulled by\neg-plan/timeseries), so a non-timeseries build has neither the variant nor its\nexecutor arm (the `SensorFuse` gating precedent). The scan implementation lives in\neg-plan behind its `timeseries` gate; this is the pure-serde wire variant.", "properties": { "TsScan": { "properties": { "from": { "format": "double", "type": "number" }, "series": { "items": { "type": "string" }, "type": "array" }, "to": { "format": "double", "type": "number" } }, "required": [ "series", "from", "to" ], "type": "object" } }, "required": [ "TsScan" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (probabilistic, CONCEPT:EG-KG.compute.uncertainty-values) \u2014 run the probabilistic query `query`\nagainst each row's stored `Distribution` VALUE (the conventional `distribution`\nnode property, the tagged serde form of `eg_types::Distribution`) and SCORE the\nrow with the closed-form result \u2014 expectation / marginal probability / conditional\nposterior mean / deterministic seeded sample \u2014 re-ordering the RowSet by that score\nDESCENDING, exactly as `Rank` produces a scored order a downstream `Limit` respects.\nRows whose `distribution` is missing/invalid, or where the query does not apply\n(e.g. a `Conditional` with an unsupported conjugate pair), are DROPPED \u2014 mirroring\nhow the tensor/spatial legs narrow their input. Gated by `probabilistic` (the\ndistribution + Bayesian math lives in eg-types/eg-compute behind eg-plan's own\n`probabilistic` gate; this is the pure-serde wire variant \u2014 no RNG-from-clock, so a\nseeded `Sample` is reproducible). Mirrors the `tensor`/`stream` gating precedent.", "properties": { "Probabilistic": { "properties": { "query": { "$ref": "#/components/schemas/ReqDef_ProbQuery" } }, "required": [ "query" ], "type": "object" } }, "required": [ "Probabilistic" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE/FILTER (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 the evidence\nFOR `claim_id`: nodes linked to it by an INCOMING `SUPPORTS`/`SUPPORTS_BELIEF`/\n`HAS_EVIDENCE`/`CORROBORATES` edge (classified by `eg_epistemic::classify_relationship`).\nAs a SOURCE (empty input) it seeds the RowSet with the supporting ids; mid-pipeline it\nnarrows the candidate set to the ones that ALSO support `claim_id` \u2014 the same\nseed-or-filter shape as `Op::AsOf`. Gated by `epistemic` (the belief-substrate model\nlives in eg-epistemic behind eg-plan's own `epistemic` gate; this is the wire variant).", "properties": { "EvidenceFor": { "properties": { "claim_id": { "type": "string" } }, "required": [ "claim_id" ], "type": "object" } }, "required": [ "EvidenceFor" ], "type": "object" }, { "additionalProperties": false, "description": "FILTER/SOURCE (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 evidence\nAGAINST `node_id`: nodes linked to it by an INCOMING `CONTRADICTS`/`CONTRADICTS_BELIEF`/\n`REFUTES` OR `ATTACKS`/`DEFEATS`/`UNDERCUTS` edge (an attack is a stronger contradiction,\nso both count). Same seed-or-filter shape as `EvidenceFor`. Gated by `epistemic`.", "properties": { "Contradicts": { "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "Contradicts" ], "type": "object" }, { "additionalProperties": false, "description": "FILTER/SOURCE (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 the claims\n`node_id` itself supports: nodes reached by an OUTGOING `SUPPORTS`/`SUPPORTS_BELIEF`/\n`HAS_EVIDENCE`/`CORROBORATES` edge FROM `node_id` \u2014 the mirror direction of\n`EvidenceFor`. Same seed-or-filter shape. Gated by `epistemic`.", "properties": { "SupportedBy": { "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "SupportedBy" ], "type": "object" }, { "additionalProperties": false, "description": "TIME+TRANSFORM (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 pin the\ncandidate set to what the engine BELIEVED at transaction-time `ts` (composes the\nexisting `Op::AsOf { ts, axis: Transaction }` bi-temporal filter) and then RE-SCORE\neach surviving row by its propagated belief confidence at that instant\n(`eg_epistemic::propagate_confidence`). The UQL sibling `VALID AS OF ` is a pure\nALIAS for `Op::AsOf { axis: Valid }` (no belief propagation) \u2014 this op is the one that\nactually walks the support/contradiction/attack graph. Gated by `epistemic`.", "properties": { "BeliefAsOf": { "properties": { "ts": { "format": "double", "type": "number" } }, "required": [ "ts" ], "type": "object" } }, "required": [ "BeliefAsOf" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 re-weight every\nrow currently in the RowSet by the propagated reliability (belief confidence) of the\nnamed `source_id` node, via `eg_epistemic::propagate_confidence`. Represents \"discount\nthis candidate set by how much I trust source X\" \u2014 a uniform scalar multiplier over\nexisting scores (unscored rows are treated as score `1.0`). Gated by `epistemic`.", "properties": { "SourceReliability": { "properties": { "source_id": { "type": "string" } }, "required": [ "source_id" ], "type": "object" } }, "required": [ "SourceReliability" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 re-score EACH\nrow in the current RowSet by ITS OWN propagated belief confidence\n(`eg_epistemic::propagate_confidence` walking that row's own support/contradiction/\nattack neighbourhood), re-ordering descending \u2014 the `CONFIDENCE` UQL keyword with no\nargument. Mirrors `Op::Probabilistic`'s \"score-then-rank\" shape but over the belief\ngraph instead of a stored `Distribution`. Gated by `epistemic`.", "properties": { "ConfidenceOp": { "type": "object" } }, "required": [ "ConfidenceOp" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 the answer to\n`EXPLAIN BELIEF `: build the recursive justification tree\n(`eg_epistemic::explain_belief`) rooted at `node_id`, flatten it (pre-order, deduped) to\n`(claim_id, confidence)` pairs, and either SEED the RowSet with them (empty input) or\nnarrow+re-score the current candidate set to the ones that appear in the tree (mirrors\nthe `EvidenceFor`/`Contradicts` seed-or-filter shape). The FULL nested proof tree\n(rule names, premise structure) is NOT representable in the flat `RowSet` currency \u2014\nthis plan-Op surface is the queryable (composes-with-`Traverse`/`Rank`/`Limit`)\nprojection of it; a standalone `Method::ExplainBelief` returning the tree verbatim\n(mirroring `Method::OwlExplain`'s `ProofNodeWire`) is a documented follow-up, not\nbuilt here (E2 scope is the wire+UQL plan surface). Gated by `epistemic`.", "properties": { "ExplainBelief": { "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "ExplainBelief" ], "type": "object" }, { "additionalProperties": false, "description": "LIMIT \u2014 top-k, respecting the current order.", "properties": { "Limit": { "properties": { "k": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "k" ], "type": "object" } }, "required": [ "Limit" ], "type": "object" } ] }, "ReqDef_OpeEstimatorKind": { "description": "Which off-policy estimator an evaluation runs.", "enum": [ "ips", "clipped_ips", "snips", "switch", "doubly_robust" ], "type": "string" }, "ReqDef_OperationEnvelope": { "additionalProperties": false, "description": "The verified authority one caller operation was admitted under.", "properties": { "authority": { "$ref": "#/components/schemas/ReqDef_AuthorityContext", "description": "The complete attempt-specific authority: nonce, request/trace id, issue\nand expiry, catalog digest, actor, audience, tenant, authority scope,\npurpose, policy revision/epoch/digest and the caller's idempotency key." }, "canonical_payload_digest": { "$ref": "#/components/schemas/ReqDef_Digest256", "description": "A digest over the operation CONTENT alone -- scope, operations, outbox\nintents and any authoritative-state digest. It deliberately excludes the\nOCC expectation, the route (placement epoch / fencing token), the batch\nid, timestamps and the request/trace ids, because a second attempt of the\nsame operation legitimately re-observes all of them." }, "method": { "description": "The one method this operation is. For a multi-operation batch it is the\nreserved batch descriptor id and every member's method is folded into\n`canonical_payload_digest` instead.", "type": "string" }, "method_schema_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "method_schema_id": { "type": "string" }, "serving_principal": { "description": "The principal the COMMITTING LEDGER requires -- for every domain, the\nstore's serving principal (RF-RULING-004 application note). Caller\nattribution is the outbox `actor` header and lives nowhere else.", "type": "string" }, "verified_capabilities": { "description": "Capabilities verified at the authenticated admission boundary. Attempt\nfacts, not identity: they gate `VersionExpectation::Unversioned` and are\ndeliberately outside `OperationReplayIdentity`.", "items": { "$ref": "#/components/schemas/ReqDef_MutationCapability" }, "type": "array", "uniqueItems": true } }, "required": [ "authority", "method", "method_schema_id", "method_schema_digest", "canonical_payload_digest", "serving_principal", "verified_capabilities" ], "type": "object" }, "ReqDef_OptimiserSpec": { "additionalProperties": false, "description": "Deterministic optimiser limits. The seed is part of the request, so a fit\nis reproducible from its record.", "properties": { "max_iterations": { "format": "uint32", "minimum": 0, "type": "integer" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" }, "tolerance": { "$ref": "#/components/schemas/ReqDef_QuantisedValue" } }, "required": [ "max_iterations", "tolerance", "seed" ], "type": "object" }, "ReqDef_Order": { "description": "A single order in the book (matched by `eg-compute::finance::exchange`).", "properties": { "id": { "type": "string" }, "price": { "format": "double", "type": "number" }, "quantity": { "format": "double", "type": "number" }, "side": { "type": "string" }, "timestamp": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "id", "side", "price", "quantity", "timestamp" ], "type": "object" }, "ReqDef_OutboxPositionView": { "additionalProperties": false, "description": "One position in an outbox, exactly as the kernel orders rows.", "properties": { "batch_id": { "type": "string" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "ordinal": { "format": "uint32", "minimum": 0, "type": "integer" }, "sequence": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sequence", "created_at_ms", "batch_id", "ordinal" ], "type": "object" }, "ReqDef_OutboxTarget": { "description": "Which outbox an operation names.", "oneOf": [ { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "target": { "const": "graph", "type": "string" } }, "required": [ "target", "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "store": { "$ref": "#/components/schemas/ReqDef_NativeOutboxStore" }, "target": { "const": "native_store", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "target", "store", "tenant_id" ], "type": "object" } ] }, "ReqDef_OutcomeArtifactRef": { "additionalProperties": false, "description": "One immutable, content-addressed artifact reference a\n[`CommitOutcomeBundle`] carries. The bundle never embeds artifact bytes \u2014\nonly a bounded reference/digest pair, mirroring\n[`crate::commit_descriptor::CommitDescriptor`]'s \"digests cover canonical\nencoded participant bytes, never mutable pointers or raw content\" rule.", "properties": { "artifact_ref": { "description": "Opaque CAS/artifact reference (never a raw filesystem path or URL).", "type": "string" }, "classification": { "description": "GOC-16 classification label carried alongside the reference so a\nprojection can enforce policy without a second lookup.", "type": "string" }, "digest": { "description": "sha256 digest of the artifact's canonical encoded bytes.", "type": "string" }, "kind": { "description": "Caller-defined artifact kind (e.g. `\"document\"`, `\"table\"`, `\"log\"`).", "type": "string" }, "size_bytes": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "artifact_ref", "digest", "kind", "size_bytes", "classification" ], "type": "object" }, "ReqDef_OutcomeCompleteness": { "description": "Terminal completeness state of a committed [`CommitOutcomeBundle`]\n(lane doc \"Authority and invariants\" + the decision record's \"Completeness\nsemantics\"). Distinct from [`crate::commit_descriptor::CommitStatus`]:\nthat enum describes the CROSS-DOMAIN COMMIT's own prepare/publish\nlifecycle; this one describes whether the WorkItem's REQUIRED provenance\nspecifically landed once the commit itself succeeded.", "oneOf": [ { "const": "complete", "description": "The authoritative outcome AND every required provenance node/edge\n(RunTrace, OutcomeEvaluation, and the full ToolCall set when the run\nmade tool calls) are durably committed. Never claimed on the strength\nof the outcome commit alone.", "type": "string" }, { "const": "degraded", "description": "The authoritative outcome committed, but one or more required\nprovenance components did not. Always carries a non-empty\n`missing_refs` naming which ones.", "type": "string" }, { "const": "reconciling", "description": "A `Degraded` outcome a reconciler has claimed and is actively\nrepairing. Repair is idempotent and MUST NOT alter `result_digest`.", "type": "string" } ] }, "ReqDef_OutcomeEvaluation": { "additionalProperties": false, "description": "The independent evaluation behind a bandit label.", "properties": { "class": { "$ref": "#/components/schemas/ReqDef_EvidenceClass" }, "evaluation_id": { "type": "string" }, "fidelity": { "$ref": "#/components/schemas/ReqDef_OutcomeFidelity" }, "lease_holder": { "description": "The lease holder that ran it; likewise excluded as a producer.", "type": "string" }, "producer": { "type": "string" }, "selected_agent": { "description": "The agent the decision selected; a label it produced itself is a\nself-report.", "type": "string" }, "success": { "default": null, "description": "`None` is a censored run: neither a success nor a failure.", "type": [ "boolean", "null" ] } }, "required": [ "evaluation_id", "class", "producer", "selected_agent", "lease_holder", "fidelity" ], "type": "object" }, "ReqDef_OutcomeFidelity": { "description": "How completely the evaluated run was traced, plus the censored states.", "enum": [ "full_step", "tool_calls", "final_output", "trace_incomplete", "outcome_uncertain", "cancelled" ], "type": "string" }, "ReqDef_PackAnnotations": { "additionalProperties": false, "description": "Everything one entry declares beyond its bytes.", "properties": { "contract_version": { "default": null, "type": [ "string", "null" ] }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_DeclaredCost" }, { "type": "null" } ], "default": null }, "destructive_hint": { "default": null, "type": [ "boolean", "null" ] }, "idempotent_hint": { "default": null, "type": [ "boolean", "null" ] }, "latency_declared": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_DeclaredLatency" }, { "type": "null" } ], "default": null }, "modalities_in": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64", "default": [] }, "modalities_out": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64", "default": [] }, "model": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_PackModelFacts" }, { "type": "null" } ], "default": null }, "open_world_hint": { "default": null, "type": [ "boolean", "null" ] }, "provides": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64", "default": [] }, "read_only_hint": { "default": null, "type": [ "boolean", "null" ] }, "required_scopes": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64", "default": [] }, "requires_capabilities": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64", "default": [] }, "sdk_contract_pin": { "default": null, "description": "The SDK contract the publisher pinned. Stored as a claim ATTRIBUTE\nrather than a typed fact: the engine cannot recompute the SDK's own\nnormalization, so it can record the string and must not pretend to have\nchecked it.", "type": [ "string", "null" ] } }, "type": "object" }, "ReqDef_PackArchiveRef": { "additionalProperties": false, "description": "Where the archive lives and what it must hash to.", "properties": { "blob_digest": { "description": "The engine blob reference the archive was uploaded under.", "type": "string" }, "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "sha256": { "$ref": "#/components/schemas/ReqDef_Digest256" } }, "required": [ "blob_digest", "length", "sha256" ], "type": "object" }, "ReqDef_PackEntry": { "additionalProperties": false, "description": "One published entry of a pack.", "properties": { "annotations": { "$ref": "#/components/schemas/ReqDef_PackAnnotations", "default": { "contract_version": null, "cost": null, "destructive_hint": null, "idempotent_hint": null, "latency_declared": null, "modalities_in": [], "modalities_out": [], "model": null, "open_world_hint": null, "provides": [], "read_only_hint": null, "required_scopes": [], "requires_capabilities": [], "sdk_contract_pin": null } }, "body": { "$ref": "#/components/schemas/ReqDef_PackSection" }, "input_schema": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_PackSection" }, { "type": "null" } ], "default": null }, "kind": { "$ref": "#/components/schemas/ReqDef_PackEntryKind" }, "media_type": { "type": "string" }, "name": { "type": "string" }, "output_schema": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_PackSection" }, { "type": "null" } ], "default": null }, "references": { "$ref": "#/components/schemas/ReqDef_BoundedVec_PackRef_64", "default": [] }, "uri": { "type": "string" } }, "required": [ "kind", "uri", "name", "media_type", "body" ], "type": "object" }, "ReqDef_PackEntryKind": { "description": "What one pack entry is.", "enum": [ "mcp_server", "tool", "skill", "prompt", "resource", "resource_template", "ontology", "shapes", "model_profile", "a2a_card", "manifest" ], "type": "string" }, "ReqDef_PackHeadRef": { "additionalProperties": false, "description": "The head a caller believes is current, for a compare-and-set import.", "properties": { "binding_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "pack_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" } }, "required": [ "binding_revision", "pack_digest" ], "type": "object" }, "ReqDef_PackModelFacts": { "additionalProperties": false, "description": "A model profile a pack publishes.\n\nThe three `supports_*` flags are tri-state here and `bool` on the component\nfacts, because absent is not false: a pack that leaves one out has said\nnothing, and importing that as `false` would silently make the model\nineligible. An entry with any of them absent is refused `INVALID_FACTS`\nrather than imported with an invented answer.", "properties": { "context_window_tokens": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_output_tokens": { "format": "uint64", "minimum": 0, "type": "integer" }, "model_identity": { "type": "string" }, "provider": { "type": "string" }, "supports_structured_output": { "default": null, "type": [ "boolean", "null" ] }, "supports_tools": { "default": null, "type": [ "boolean", "null" ] }, "supports_vision": { "default": null, "type": [ "boolean", "null" ] } }, "required": [ "provider", "model_identity", "context_window_tokens", "max_output_tokens" ], "type": "object" }, "ReqDef_PackProducer": { "additionalProperties": false, "description": "The tool that produced this pack.", "properties": { "name": { "type": "string" }, "version": { "type": "string" } }, "required": [ "name", "version" ], "type": "object" }, "ReqDef_PackRef": { "additionalProperties": false, "description": "A reference from one entry to another, by URI and kind.", "properties": { "kind": { "$ref": "#/components/schemas/ReqDef_PackEntryKind" }, "uri": { "type": "string" } }, "required": [ "uri", "kind" ], "type": "object" }, "ReqDef_PackSection": { "additionalProperties": false, "description": "One byte range of the archive, pinned by its own digest.", "properties": { "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "offset": { "format": "uint64", "minimum": 0, "type": "integer" }, "sha256": { "$ref": "#/components/schemas/ReqDef_Digest256" } }, "required": [ "offset", "length", "sha256" ], "type": "object" }, "ReqDef_PipelineSpec": { "description": "The full composable pipeline recipe: ordered feature steps \u2192 split \u2192 model. Stored\n(minus the split) inside the `:Model` artifact so eval/predict rebuild features\nIDENTICALLY from the same recipe without the caller re-specifying it.", "properties": { "features": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_FeatureStep" }, "type": "array" }, "label_property": { "default": "", "description": "Node property holding the integer class label (node classification). Empty \u21d2\nlabels must be passed explicitly as `y`. Ignored by the `graphlearn` family\n(its labels are the observed edges).", "type": "string" }, "model": { "$ref": "#/components/schemas/ReqDef_ModelSpec" }, "split": { "$ref": "#/components/schemas/ReqDef_SplitSpec", "default": { "seed": 42, "shuffle": true, "test_ratio": 0.25 } } }, "required": [ "model" ], "type": "object" }, "ReqDef_PlacementAdminOp": { "description": "One operation on the placement-catalog admin surface (CONCEPT:EG-KG.sharding.placement-catalog-admin-rpc,\nDIST-P2-5). Nested under `Method::PlacementAdmin { op }` \u2014 mirrors\n[`crate::modality::ServedModalityOp`]'s \"one Method variant, many operations\" shape.", "oneOf": [ { "additionalProperties": false, "description": "Assign the WHOLE keyspace of `tenant` to `group` (the placement DECISION leg).\nCollapses any prior split. Returns `{\"epoch\": u64}` \u2014 the new routing epoch\nevery subsequent `PlacementRoute`/read observes immediately.", "properties": { "group": { "format": "uint64", "minimum": 0, "type": "integer" }, "operation": { "const": "assign", "type": "string" }, "tenant": { "type": "string" } }, "required": [ "operation", "tenant", "group" ], "type": "object" }, { "additionalProperties": false, "description": "Online-move `tenant`'s partition `[range_start, range_end]` to `target`.\nReturns a `PlacementMoveReport` JSON: `{tenant, range, target, epoch,\ngraphs: [{graph, from_group, to_group, nodes_transferred}]}`.", "properties": { "operation": { "const": "move", "type": "string" }, "range_end": { "format": "uint64", "minimum": 0, "type": "integer" }, "range_start": { "format": "uint64", "minimum": 0, "type": "integer" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant": { "type": "string" } }, "required": [ "operation", "tenant", "range_start", "range_end", "target" ], "type": "object" }, { "additionalProperties": false, "description": "Abort an in-flight online move identified by `move_id` before its cutover\nfence. A move already past its epoch fence is rejected (roll-forward only,\nmatching `TenantManager::abort_move`'s in-process contract). Returns `Bool`.", "properties": { "move_id": { "type": "string" }, "operation": { "const": "abort_move", "type": "string" } }, "required": [ "operation", "move_id" ], "type": "object" } ] }, "ReqDef_PlacementRouteRequest": { "additionalProperties": false, "properties": { "client_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "partition_ref": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_PlacementRouteRequestSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "partition_ref", "client_epoch" ], "type": "object" }, "ReqDef_PlacementRouteRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_Plan": { "description": "A logical plan: an ordered list of [`Op`]s over one `RowSet`. The serializable\nwire payload of `Method::UnifiedQuery` (CONCEPT:AU-KG.compute.vector).", "properties": { "ops": { "items": { "$ref": "#/components/schemas/ReqDef_Op" }, "type": "array" } }, "required": [ "ops" ], "type": "object" }, "ReqDef_PolicyRecord": { "description": "Policy rows carry an opaque subject-set digest, never raw principals.", "properties": { "classification": { "type": "string" }, "legal_hold": { "default": false, "type": "boolean" }, "object_id": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ReqDef_MaterialOperation" }, "policy_id": { "type": "string" }, "policy_version": { "type": "string" }, "retention_policy": { "default": "", "type": "string" }, "subject_set_digest": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "policy_id", "operation", "object_id", "tenant", "classification", "policy_version", "subject_set_digest" ], "type": "object" }, "ReqDef_Pred": { "description": "A simple equality / range predicate over a node property, compiled to a SQL\n`WHERE` fragment and evaluated by the DataFusion FILTER leg in `eg-plan`.", "oneOf": [ { "additionalProperties": false, "description": "`prop == value` (string compare on the JSON-stringified value).", "properties": { "Eq": { "properties": { "prop": { "type": "string" }, "value": { "type": "string" } }, "required": [ "prop", "value" ], "type": "object" } }, "required": [ "Eq" ], "type": "object" }, { "additionalProperties": false, "description": "`prop > n` (numeric).", "properties": { "GtNum": { "properties": { "n": { "format": "double", "type": "number" }, "prop": { "type": "string" } }, "required": [ "prop", "n" ], "type": "object" } }, "required": [ "GtNum" ], "type": "object" }, { "additionalProperties": false, "description": "`prop < n` (numeric).", "properties": { "LtNum": { "properties": { "n": { "format": "double", "type": "number" }, "prop": { "type": "string" } }, "required": [ "prop", "n" ], "type": "object" } }, "required": [ "LtNum" ], "type": "object" }, { "additionalProperties": false, "description": "DOCUMENT/JSON \u2014 keep rows whose node property document satisfies a deep\nJSONPath predicate (CONCEPT:EG-KG.query.json-wire-roundtrip). `path` is a JSONPath (`$.a.b`, `$.a[0]`,\n`$.a[*]`, wildcard) evaluated against the row's decoded JSON; `op` is the\nexistence / equality / `@>`-containment test. This is the lowered form of the\nPostgres JSON operators (`->`, `->>`, `@>`, `jsonb_path_query`) and a Mongo-style\n`$match` \u2014 see `eg_query::sql::classify`. Like the spatial preds it is NOT lowered\nto SQL (DataFusion has no JSONPath): `eg-plan`'s FILTER leg splits it out and\napplies it per-row against the stored JSON, and the planner can consult eg-core's\ninverted path-index for candidate selectivity. PURE serde here (a string, a small\nenum, and a `serde_json::Value` literal \u2014 exactly as `CepAttrPredSpec` carries),\nso it is present whenever `query` is on and adds NO dependency.", "properties": { "JsonPath": { "properties": { "op": { "$ref": "#/components/schemas/ReqDef_JsonPathOp" }, "path": { "type": "string" } }, "required": [ "path", "op" ], "type": "object" } }, "required": [ "JsonPath" ], "type": "object" }, { "additionalProperties": false, "description": "SPATIAL \u2014 keep rows whose geometry (in node property `column`, stored as WKT)\nis spatially WITHIN the query geometry `wkt` (CONCEPT:EG-KG.ontology.singles-concept). Evaluated by\neg-geo's planar `within` in eg-plan (behind the `geo` feature) \u2014 NOT lowered to\nSQL (DataFusion has no spatial), so the FILTER leg splits spatial preds out and\napplies them per-row against the stored geometry. Gated by `geo` (implies\n`query`); pure serde here (only two strings).", "properties": { "SpatialWithin": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialWithin" ], "type": "object" }, { "additionalProperties": false, "description": "SPATIAL \u2014 keep rows whose geometry (node property `column`, WKT) lies within\nplanar `distance` of the query geometry `wkt` \u2014 an `ST_DWithin` (CONCEPT:EG-KG.ontology.singles-concept).\nEvaluated by eg-geo's planar `distance` in eg-plan. Gated by `geo`.", "properties": { "SpatialDWithin": { "properties": { "column": { "type": "string" }, "distance": { "format": "double", "type": "number" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt", "distance" ], "type": "object" } }, "required": [ "SpatialDWithin" ], "type": "object" }, { "additionalProperties": false, "description": "SPATIAL (DE-9IM, CONCEPT:EG-KG.ontology.de-9im-relations) \u2014 keep rows whose geometry (node property `column`,\nWKT) is topologically related to the query geometry `wkt` per the named DE-9IM\nrelation. Each mirrors [`Pred::SpatialWithin`] (two strings) and is evaluated per-row\nby eg-geo's `predicates` in eg-plan \u2014 NOT lowered to SQL. Gated by `geo`.\n\n`SpatialContains` = the row geometry CONTAINS the query geometry; `SpatialCovers`\nits boundary-inclusive superset; `SpatialTouches` boundary-only contact;\n`SpatialCrosses` interiors meeting in lower dimension; `SpatialOverlaps` same-dim\npartial overlap; `SpatialEquals` geometric equality; `SpatialDisjoint` no shared\npoint.", "properties": { "SpatialContains": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialContains" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialCovers": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialCovers" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialTouches": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialTouches" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialCrosses": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialCrosses" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialOverlaps": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialOverlaps" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialEquals": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialEquals" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialDisjoint": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialDisjoint" ], "type": "object" } ] }, "ReqDef_PremiseClass": { "description": "How strong one premise is.", "oneOf": [ { "const": "definition", "description": "True by the definition of the vocabulary.", "type": "string" }, { "const": "claim", "description": "Asserted by a producer that is not the engine.", "type": "string" }, { "const": "observation", "description": "Measured by a recorded evaluation.", "type": "string" }, { "const": "proof", "description": "Derived by a checkable rule from other premises.", "type": "string" } ] }, "ReqDef_PremiseProvenance": { "description": "Where a premise came from.", "oneOf": [ { "additionalProperties": false, "description": "The engine's own ontology, at the digest named.", "properties": { "ontology_digest": { "type": "string" }, "provenance": { "const": "native_ontology", "type": "string" } }, "required": [ "provenance", "ontology_digest" ], "type": "object" }, { "additionalProperties": false, "description": "The decision policy in force.", "properties": { "policy_digest": { "type": "string" }, "provenance": { "const": "policy", "type": "string" } }, "required": [ "provenance", "policy_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A component publisher's declaration at an exact revision.", "properties": { "component_id": { "type": "string" }, "definition_digest": { "type": "string" }, "provenance": { "const": "publisher", "type": "string" } }, "required": [ "provenance", "component_id", "definition_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A connector pack entry at an exact binding revision.", "properties": { "binding_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "connector": { "type": "string" }, "entry_digest": { "type": "string" }, "pack_digest": { "type": "string" }, "provenance": { "const": "connector_pack", "type": "string" } }, "required": [ "provenance", "connector", "binding_revision", "pack_digest", "entry_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A free-text-to-task mapping asserted by a producer.", "properties": { "producer": { "type": "string" }, "provenance": { "const": "claimed_mapping", "type": "string" }, "text_digest": { "type": "string" } }, "required": [ "provenance", "text_digest", "producer" ], "type": "object" }, { "additionalProperties": false, "description": "A recorded evaluation.", "properties": { "evaluation_id": { "type": "string" }, "provenance": { "const": "observation", "type": "string" } }, "required": [ "provenance", "evaluation_id" ], "type": "object" }, { "additionalProperties": false, "description": "The request itself: a requirement the caller stated in `field`.", "properties": { "field": { "type": "string" }, "provenance": { "const": "request", "type": "string" } }, "required": [ "provenance", "field" ], "type": "object" } ] }, "ReqDef_PremiseRef": { "additionalProperties": false, "description": "One fact the decision used.", "properties": { "class": { "$ref": "#/components/schemas/ReqDef_PremiseClass" }, "fact": { "type": "string" }, "provenance": { "$ref": "#/components/schemas/ReqDef_PremiseProvenance" }, "subject": { "type": "string" } }, "required": [ "subject", "fact", "class", "provenance" ], "type": "object" }, "ReqDef_PriceSource": { "description": "Who says what this costs.", "oneOf": [ { "additionalProperties": false, "description": "The model or tool publisher's own list price.", "properties": { "source": { "const": "publisher", "type": "string" } }, "required": [ "source" ], "type": "object" }, { "additionalProperties": false, "description": "A connector pack entry, pinned by the entry's digest.", "properties": { "connector": { "type": "string" }, "entry_digest": { "type": "string" }, "source": { "const": "connector_pack", "type": "string" } }, "required": [ "source", "connector", "entry_digest" ], "type": "object" }, { "additionalProperties": false, "description": "An operator override, with the reference that justifies it.", "properties": { "reference": { "type": "string" }, "source": { "const": "operator", "type": "string" } }, "required": [ "source", "reference" ], "type": "object" } ] }, "ReqDef_PrivacyAttestation": { "properties": { "policy_version": { "type": "string" }, "sanitized_payload_digest": { "type": "string" }, "sanitizer_version": { "type": "string" } }, "required": [ "policy_version", "sanitizer_version", "sanitized_payload_digest" ], "type": "object" }, "ReqDef_ProbEvidenceSpec": { "description": "PROBABILISTIC \u2014 the evidence for a conjugate Bayesian update carried by\n[`ProbQuery::Conditional`] (CONCEPT:EG-KG.compute.uncertainty-values). Mirrors `eg_compute::probabilistic::Evidence`,\nbut defined HERE (pure serde, no eg-compute dep) so the wire stays Pi-safe; the executor\nmaps it to eg-compute's enum behind eg-plan's `probabilistic` gate. `Bernoulli` counts\nare the sufficient statistic for a Beta prior; `Gaussian` observations (with a KNOWN\nlikelihood variance) for a Gaussian prior over the unknown mean.", "oneOf": [ { "properties": { "failures": { "format": "double", "type": "number" }, "kind": { "const": "bernoulli", "type": "string" }, "successes": { "format": "double", "type": "number" } }, "required": [ "kind", "successes", "failures" ], "type": "object" }, { "properties": { "kind": { "const": "gaussian", "type": "string" }, "known_variance": { "format": "double", "type": "number" }, "observations": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "kind", "observations", "known_variance" ], "type": "object" } ] }, "ReqDef_ProbQuery": { "description": "PROBABILISTIC \u2014 the probabilistic query carried by `Op::Probabilistic` (CONCEPT:EG-KG.compute.uncertainty-values):\none closed-form question asked of each row's stored `Distribution` VALUE.\n* `Expectation` \u2014 the mean `E[X]`.\n* `Marginal { at, label }` \u2014 the marginal probability: the density `pdf(at)` for the\n continuous variants, or the mass `pmf(label)` when `label` is set (a `Categorical`).\n* `Conditional { evidence }` \u2014 the posterior MEAN after a conjugate Bayesian update\n with `evidence` (the \"conditional\" query).\n* `Sample { seed }` \u2014 one DETERMINISTIC seeded draw (same seed \u21d2 same value; no\n RNG-from-clock, so a plan is reproducible).\n\nPURE serde \u2014 the distribution math lives in eg-types (`Distribution`) + eg-compute\n(`bayesian_update`) behind eg-plan's `probabilistic` gate; this is the wire variant.", "oneOf": [ { "properties": { "kind": { "const": "expectation", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "at": { "default": 0.0, "format": "double", "type": "number" }, "kind": { "const": "marginal", "type": "string" }, "label": { "default": null, "type": [ "string", "null" ] } }, "required": [ "kind" ], "type": "object" }, { "properties": { "evidence": { "$ref": "#/components/schemas/ReqDef_ProbEvidenceSpec" }, "kind": { "const": "conditional", "type": "string" } }, "required": [ "kind", "evidence" ], "type": "object" }, { "properties": { "kind": { "const": "sample", "type": "string" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "seed" ], "type": "object" } ] }, "ReqDef_PromptMode": { "description": "How a prompt's text is resolved.", "oneOf": [ { "const": "static", "description": "Fixed at publish time; `content_digest` pins the text itself.", "type": "string" }, { "const": "dynamic", "description": "Produced per run; `content_digest` can only pin the FUNCTION, so the\ntext the model saw must be bound again at resolution.", "type": "string" } ] }, "ReqDef_ProofNode": { "description": "One pre-order node of the search-tree proof.", "oneOf": [ { "additionalProperties": false, "properties": { "branch": { "additionalProperties": false, "properties": { "first": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ReqDef_VarId" } }, "required": [ "var", "first" ], "type": "object" } }, "required": [ "branch" ], "type": "object" }, { "additionalProperties": false, "properties": { "forced": { "additionalProperties": false, "properties": { "row": { "$ref": "#/components/schemas/ReqDef_RowId" }, "value": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ReqDef_VarId" } }, "required": [ "var", "value", "row" ], "type": "object" } }, "required": [ "forced" ], "type": "object" }, { "additionalProperties": false, "properties": { "leaf": { "additionalProperties": false, "properties": { "proof": { "$ref": "#/components/schemas/ReqDef_LeafProof" } }, "required": [ "proof" ], "type": "object" } }, "required": [ "leaf" ], "type": "object" } ] }, "ReqDef_PropensitySource": { "description": "Where a logged propensity came from.", "oneOf": [ { "const": "executed_policy", "description": "The executed policy's exact probability.", "type": "string" }, { "const": "head_mass", "description": "A head's score copied in as if it were a propensity. Never admissible.", "type": "string" } ] }, "ReqDef_QuantScaleTag": { "description": "The fixed-point scale a [`QuantisedValue`] is read on. Mirrors\n`eg_numeric`'s `QuantScale`.", "oneOf": [ { "const": "pico", "description": "`value / 10^12`.", "type": "string" }, { "const": "q32", "description": "`value / 2^32`.", "type": "string" } ] }, "ReqDef_QuantisedValue": { "additionalProperties": false, "description": "An exact fixed-point number: `value` read on `scale`.", "properties": { "scale": { "$ref": "#/components/schemas/ReqDef_QuantScaleTag" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "scale", "value" ], "type": "object" }, "ReqDef_QuantumOp": { "description": "The agent-facing quantum control-plane operation (Q8). Nested under\n`Method::Quantum { op }` \u2014 mirrors `acl::RbacAdminOp`/`jobs::JobOp`'s \"one Method\nvariant, many operations\" shape.", "oneOf": [ { "additionalProperties": false, "description": "Rank candidate items by a caller-supplied weight signal through a\ndeterministic amplitude-encoding + interference circuit. The agent NEVER\nsees qubits: it supplies `(id, weight)` pairs and a shot budget and gets\nback an ordering plus the full Q0 metadata. ALWAYS a proposal \u2014 see the\nmodule doc's exactness section.", "properties": { "backend_id": { "default": null, "description": "R5 escape hatch. Always honoured (if the named backend is registered),\nalways audited (Q9). `None` lets the planner choose (R0-R4) \u2014 the\ndefault agent experience, and the only path that needs no hardware\nquota check.", "type": [ "string", "null" ] }, "candidates": { "description": "One qubit per candidate (bounded server-side \u2014 see the facade's\n`MAX_RANK_CANDIDATES`; an oversized request is rejected outright, never\nsilently truncated).", "items": { "$ref": "#/components/schemas/ReqDef_QuantumRankCandidate" }, "type": "array" }, "operation": { "const": "rank", "type": "string" }, "seed": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "operation", "candidates" ], "type": "object" }, { "additionalProperties": false, "description": "Run ONE fixed-parameter QAOA layer set over a caller-supplied Max-Cut\ninstance (candidate node ids + weighted edges) and return a sampled cut\nassignment. NOT a variational optimizer loop \u2014 no classical outer loop, one\nevaluation at a canonical fixed angle schedule. ALWAYS a proposal.", "properties": { "backend_id": { "default": null, "type": [ "string", "null" ] }, "edges": { "items": { "$ref": "#/components/schemas/ReqDef_QuantumQaoaEdge" }, "type": "array" }, "nodes": { "items": { "type": "string" }, "type": "array" }, "operation": { "const": "optimize_qaoa", "type": "string" }, "p_layers": { "default": 1, "format": "uint32", "minimum": 0, "type": "integer" }, "seed": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "operation", "nodes", "edges" ], "type": "object" }, { "additionalProperties": false, "description": "Compute a sampled Pauli-Z-string expectation value over a caller-supplied\n`QuantumProgram` (native IR, JSON-encoded exactly like\n`eg_quantum_core::ir::QuantumProgram`'s own serde round-trip \u2014\n`eg-quantum-core`'s `qasm` module or the IR's own JSON shape both produce\nsomething this field accepts directly). `observable_qubits` names the\nZ-observable's support; every qubit in it MUST already be measured into a\nclassical bit by `program` (the facade validates this and rejects\notherwise \u2014 it never silently appends measurements to a caller's circuit).\nRestricted to Pauli-Z strings in Q8 v0 \u2014 X/Y support (via basis-rotation\ngates prepended before measurement) is a straightforward follow-up, not\nattempted here to keep the exactness/observability wiring the focus of this\nlane.", "properties": { "backend_id": { "default": null, "type": [ "string", "null" ] }, "observable_qubits": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "type": "array" }, "operation": { "const": "expectation", "type": "string" }, "program": true, "seed": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "operation", "program", "observable_qubits" ], "type": "object" } ] }, "ReqDef_QuantumQaoaEdge": { "description": "One weighted edge of the Max-Cut instance [`QuantumOp::OptimizeQaoa`] builds its\ncost Hamiltonian from. `source`/`target` reference `nodes` by value, not index \u2014\nstable across a caller re-ordering `nodes`.", "properties": { "source": { "type": "string" }, "target": { "type": "string" }, "weight": { "default": 1.0, "format": "double", "type": "number" } }, "required": [ "source", "target" ], "type": "object" }, "ReqDef_QuantumRankCandidate": { "description": "One candidate item for [`QuantumOp::Rank`], with the classical weight/score\nsignal the ranking circuit is built from.", "properties": { "id": { "type": "string" }, "weight": { "format": "double", "type": "number" } }, "required": [ "id", "weight" ], "type": "object" }, "ReqDef_QuestionKind": { "description": "What class of question this is. The kind selects the executor; it never\nselects the guarantee.", "enum": [ "route", "rank", "classify", "resolve_entity", "schema_mapping", "template_choice", "retrieval_plan", "ingestion_lane", "enrichment_schedule" ], "type": "string" }, "ReqDef_QuestionSafety": { "description": "What is at stake. Exploration is permitted only for\n[`QuestionSafety::Ordinary`]; everything else must be decided on evidence\nalready in hand or abstained.", "enum": [ "ordinary", "security", "policy", "write_back", "irreversible" ], "type": "string" }, "ReqDef_RankWeightsWire": { "description": "Wire mirror of `eg_epistemic::RankWeights` (EPI-P3-3) \u2014 weights combining\nsimilarity with the evidence-quality/provenance signal for `RankByProvenance`.\nDefaults to `{ similarity: 0.5, evidence_quality: 0.5 }`, the SAME\nequal-weighting default `eg_epistemic::RankWeights::default()` uses.", "properties": { "evidence_quality": { "format": "double", "type": "number" }, "similarity": { "format": "double", "type": "number" } }, "required": [ "similarity", "evidence_quality" ], "type": "object" }, "ReqDef_RbacAction": { "description": "An action a grant permits or denies over a resource (CONCEPT:EG-KG.compute.feature).", "enum": [ "Read", "Write", "Admin" ], "type": "string" }, "ReqDef_RbacAdminOp": { "description": "A single administrative mutation of the RBAC policy (CONCEPT:EG-KG.compute.feature), carried by\n`Method::RbacAdmin`. Unconditional so it sits below the `isolation` layer.", "oneOf": [ { "additionalProperties": false, "properties": { "AddRole": { "$ref": "#/components/schemas/ReqDef_Role" } }, "required": [ "AddRole" ], "type": "object" }, { "additionalProperties": false, "properties": { "RemoveRole": { "type": "string" } }, "required": [ "RemoveRole" ], "type": "object" }, { "additionalProperties": false, "properties": { "AddGrant": { "$ref": "#/components/schemas/ReqDef_Grant" } }, "required": [ "AddGrant" ], "type": "object" }, { "additionalProperties": false, "properties": { "RemoveGrant": { "$ref": "#/components/schemas/ReqDef_Grant" } }, "required": [ "RemoveGrant" ], "type": "object" }, { "const": "List", "description": "Read-only: list the current roles + grants.", "type": "string" } ] }, "ReqDef_ReceiptNode": { "additionalProperties": false, "description": "A graph node that is co-committed with one terminal result.\n\nThe `properties_msgpack` bytes are the same bounded `AddNode` payload the\nexisting native B9 applier accepts. The digest is checked against those\nbytes, while every identity/fence/outbox field is checked against the\nenclosing [`CommitOutcomeBundle`]. Consequently a schema-valid node from\nanother WorkItem or lease cannot be smuggled into the batch.", "properties": { "delegation_id": { "type": "string" }, "fence_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "$ref": "#/components/schemas/ReqDef_ReceiptNodeKind" }, "node_id": { "type": "string" }, "outbox_id": { "type": "string" }, "payload_digest": { "description": "SHA-256 of the canonical `properties_msgpack` bytes.", "type": "string" }, "payload_ref": { "description": "Opaque CAS/ref-store identity for the redacted node payload.", "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "result_ref": { "type": [ "string", "null" ] }, "run_id": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "node_id", "kind", "delegation_id", "work_item_id", "run_id", "fence_token", "outbox_id", "payload_ref", "payload_digest", "properties_msgpack" ], "type": "object" }, "ReqDef_ReceiptNodeKind": { "description": "Receipt node kinds that may ride alongside a terminal WorkItem result.\nEvery node uses the existing graph node payload shape; this type only binds\nits identity and bounded property bytes to the terminal commit.", "enum": [ "run_trace", "tool_call", "outcome_evaluation" ], "type": "string" }, "ReqDef_ReconciliationObservation": { "additionalProperties": false, "properties": { "change_set_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "change_set_id": { "type": "string" }, "connector_observation_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "effect_status": { "$ref": "#/components/schemas/ReqDef_WriteBackEffectStatus" }, "evidence_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "idempotency_key": { "type": "string" }, "observed_source_version": { "type": "string" }, "provenance_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "retry_allowed": { "type": "boolean" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "change_set_id", "change_set_digest", "idempotency_key", "observed_source_version", "effect_status", "retry_allowed", "evidence_digest", "connector_observation_digest", "provenance_digest" ], "type": "object" }, "ReqDef_RecordWindow": { "additionalProperties": false, "description": "The closed record window a job reads.", "properties": { "from_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "to_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "from_ms", "to_ms" ], "type": "object" }, "ReqDef_ReduceAlgorithm": { "description": "Which reduction engine `MineReduce` runs (CONCEPT:EG-KG.mining.truncated-svd).", "oneOf": [ { "const": "svd", "description": "Truncated SVD (default) \u2014 unsupervised linear projection.", "type": "string" }, { "const": "lda", "description": "Fisher LDA \u2014 supervised (needs labels).", "type": "string" }, { "const": "umap", "description": "UMAP layout.", "type": "string" }, { "const": "tsne", "description": "t-SNE embedding.", "type": "string" } ] }, "ReqDef_RegisteredServerCursor": { "additionalProperties": false, "description": "Stable continuation over one complete live registry snapshot.", "properties": { "after_name": { "description": "Exclusive server-name lower bound for the next page.", "type": "string" }, "registry_digest": { "$ref": "#/components/schemas/ReqDef_Digest256", "description": "Canonical digest of every live, visible typed server in that image." }, "registry_revision": { "description": "`GraphCore::version()` of the `__commons__` image that produced the page.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "after_name", "registry_revision", "registry_digest" ], "type": "object" }, "ReqDef_RegisteredServerListRequest": { "additionalProperties": false, "description": "Request for a bounded page of registered servers.", "properties": { "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_RegisteredServerCursor" }, { "type": "null" } ], "default": null }, "limit": { "default": null, "description": "`None` selects the maximum/default page size of 256.", "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "ReqDef_Relation": { "description": "Relation of a linear row's left-hand side to its right-hand side.", "oneOf": [ { "const": "less_equal", "description": "`\u03a3 a\u00b7x \u2264 rhs`.", "type": "string" }, { "const": "greater_equal", "description": "`\u03a3 a\u00b7x \u2265 rhs`.", "type": "string" }, { "const": "equal", "description": "`\u03a3 a\u00b7x = rhs`.", "type": "string" } ] }, "ReqDef_RequestContext": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "audience": { "type": "string" }, "authentication_method": { "$ref": "#/components/schemas/ReqDef_RequestContextAuthenticationMethod" }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "issued_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "placement_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "policy_version": { "type": "string" }, "request_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_RequestContextSchemaVersion" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "subject_id": { "type": "string" }, "tenant_id": { "type": "string" }, "trace_id": { "type": "string" } }, "required": [ "schema_version", "request_id", "subject_id", "tenant_id", "agent_id", "scopes", "audience", "authentication_method", "policy_version", "graph", "trace_id", "issued_at_ms", "expires_at_ms" ], "type": "object" }, "ReqDef_RequestContextAuthenticationMethod": { "enum": [ "workload_identity", "oidc", "mutual_tls", "local_process" ], "type": "string" }, "ReqDef_RequestContextClaims": { "additionalProperties": false, "description": "Identity and policy claims carried by a verified request-context envelope.\n\nThis is the wire representation only. Callers must not treat a deserialized\nvalue as trusted until the server has verified the envelope MAC, deployment\naudience/tenant/policy version, request binding, and delegation chain. The\nserver exposes a separate, non-constructible `VerifiedRequestContext` wrapper\nafter those checks succeed.", "properties": { "agent_id": { "description": "Effective agent identity used for ACL/RBAC decisions.", "type": "string" }, "audience": { "description": "Intended service audience.", "type": "string" }, "delegation": { "description": "Ordered delegation path from `principal` to `agent_id` (inclusive).\nEmpty means no delegation and therefore requires principal == agent_id.", "items": { "type": "string" }, "type": "array" }, "node": { "description": "Target node id this envelope was minted for (ADR-3 / W1.9 node-bound\nenvelopes \u2014 ``reports/wave1/ADR-scale-trio.md``). `None` for a client\nthat predates node binding, or one that has not yet learned a target\nnode id; a single-node deployment never needs to set this. When\n`Some(id)`, the server exact-matches it against the receiving node's\nown identity before dispatch (`server::auth::validate_context_claims`)\n\u2014 a mismatch means the envelope was captured and replayed against a\ndifferent cluster member. `#[serde(default)]` so an envelope minted by\na client that has never heard of this claim deserializes exactly as\nbefore (absent, not a hard error).", "type": [ "string", "null" ] }, "policy_version": { "description": "Exact policy bundle/version under which the context was issued.", "type": "string" }, "principal": { "description": "Authenticated subject that originated the request.", "type": "string" }, "priority": { "description": "Advisory QoS admission-priority class this request declares (W2.4 \u2014\nengine-native QoS lanes). One of the agent-utilities `PriorityClass`\nwire values `\"interactive\"` / `\"orchestration\"` / `\"hydration\"` /\n`\"background_ingestion\"`; any other or absent value is treated as the\norchestration default (high, never starved \u2014 matching au's\nuntagged-context semantics). Mapped to a [`crate`]-independent admission\nclass by the server's QoS scheduler (`server::qos::QosClass`).\n\nIt is **MAC-covered** (appended to `build_envelope_v2_bytes` as a\ndistinct tag-`2` optional trailer, after the tag-`1` node trailer) so a\nnoisy principal cannot forge a higher class to defeat the admission\nordering \u2014 the priority is bound to the signed envelope exactly like\nevery other claim. `#[serde(default)]` + presence-gated encoding keep an\nenvelope minted by a client that predates this claim byte-for-byte\nidentical to before (absent, not a hard error) \u2014 fully additive.", "type": [ "string", "null" ] }, "roles": { "description": "Identity-provider roles asserted for policy evaluation/audit.", "items": { "type": "string" }, "type": "array" }, "scopes": { "description": "Fine-grained capabilities asserted for policy evaluation/audit.", "items": { "type": "string" }, "type": "array" }, "tenant": { "description": "Tenant security boundary selected by the deployment.", "type": "string" } }, "required": [ "principal", "tenant", "audience", "agent_id", "roles", "scopes", "policy_version", "delegation" ], "type": "object" }, "ReqDef_RequestContextSchemaVersion": { "enum": [ "2" ], "type": "string" }, "ReqDef_ResolutionKind": { "description": "How the conclusion was reached.", "enum": [ "constraint", "entailment", "optimization", "statistical", "abstention" ], "type": "string" }, "ReqDef_ResourceCapacity": { "additionalProperties": false, "properties": { "cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "process_slots": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cpu_weight", "memory_mib", "disk_mib", "process_slots" ], "type": "object" }, "ReqDef_ResourceHostUpdateRequest": { "additionalProperties": false, "properties": { "capacity": { "$ref": "#/components/schemas/ReqDef_ResourceCapacity" }, "disk_capacity_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_used_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "draining": { "type": "boolean" }, "heartbeat_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "heartbeat_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "labels": { "items": { "type": "string" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "observed": { "$ref": "#/components/schemas/ReqDef_ResourceCapacity" }, "quarantined": { "type": "boolean" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_ResourceHostUpdateRequestSchemaVersion" }, "target_alias": { "type": [ "string", "null" ] }, "target_kind": { "$ref": "#/components/schemas/ReqDef_ResourceHostUpdateRequestTargetKind" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "host_ref", "revision", "capacity", "observed", "heartbeat_at_ms", "heartbeat_ttl_ms", "now_ms", "draining", "quarantined", "labels", "target_kind", "disk_used_mib", "disk_capacity_mib" ], "type": "object" }, "ReqDef_ResourceHostUpdateRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_ResourceHostUpdateRequestTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ReqDef_ResourceRequirement": { "additionalProperties": false, "properties": { "cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "process_slots": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cpu_weight", "memory_mib", "disk_mib", "process_slots" ], "type": "object" }, "ReqDef_ResourceReservationRequest": { "additionalProperties": false, "properties": { "anti_affinity": { "items": { "type": "string" }, "type": "array" }, "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "branch": { "type": "string" }, "branch_exclusive": { "type": "boolean" }, "concurrency_key": { "type": "string" }, "concurrency_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_high_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_low_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_policy_key": { "type": "string" }, "expected_host_revision": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "expected_lifecycle_revision": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "fairness_cost": { "format": "uint64", "minimum": 0, "type": "integer" }, "fairness_group": { "type": "string" }, "fence": { "type": "string" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "idempotency_key": { "type": "string" }, "input_fingerprint": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "profile_name": { "type": "string" }, "profile_version": { "type": "string" }, "repository_exclusive": { "type": "boolean" }, "repository_id": { "type": "string" }, "required_labels": { "items": { "type": "string" }, "type": "array" }, "requirement": { "$ref": "#/components/schemas/ReqDef_ResourceRequirement" }, "reservation_id": { "type": "string" }, "reserved_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_ResourceReservationRequestSchemaVersion" }, "target_alias": { "type": [ "string", "null" ] }, "target_kind": { "$ref": "#/components/schemas/ReqDef_ResourceReservationRequestTargetKind" }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "fence", "lease_epoch", "fencing_token", "attempt", "reservation_id", "input_fingerprint", "profile_name", "profile_version", "host_ref", "requirement", "target_kind", "repository_id", "branch", "concurrency_key", "repository_exclusive", "branch_exclusive", "required_labels", "anti_affinity", "fairness_group", "fairness_cost", "disk_policy_key", "reserved_at_ms", "expires_at_ms", "idempotency_key", "now_ms" ], "type": "object" }, "ReqDef_ResourceReservationRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_ResourceReservationRequestTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ReqDef_ResourceReservationStatusRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "cursor": { "type": [ "string", "null" ] }, "fairness_group": { "type": [ "string", "null" ] }, "fence": { "type": [ "string", "null" ] }, "fencing_token": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "host_ref": { "type": [ "string", "null" ] }, "input_fingerprint": { "type": [ "string", "null" ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": [ "string", "null" ] }, "reservation_id": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ReqDef_ResourceReservationStatusRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "tenant_ref", "limit", "now_ms" ], "type": "object" }, "ReqDef_ResourceReservationStatusRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ReqDef_ResourceSelector": { "description": "What a [`Grant`] applies to (CONCEPT:EG-KG.compute.feature). Ordered by [`specificity`] so the\nevaluator can implement \"most-specific-resource wins\": a named graph beats a\nlabel, which beats a glob pattern, which beats \"all\".\n\n[`specificity`]: ResourceSelector::specificity", "oneOf": [ { "const": "All", "description": "Every resource (least specific).", "type": "string" }, { "additionalProperties": false, "description": "A glob over the graph name \u2014 a single optional leading and/or trailing `*`\nwildcard (e.g. `agent:*`, `*:private`, `*log*`).", "properties": { "Pattern": { "type": "string" } }, "required": [ "Pattern" ], "type": "object" }, { "additionalProperties": false, "description": "A node label.", "properties": { "Label": { "type": "string" } }, "required": [ "Label" ], "type": "object" }, { "additionalProperties": false, "description": "One named graph (most specific).", "properties": { "Graph": { "type": "string" } }, "required": [ "Graph" ], "type": "object" } ] }, "ReqDef_RetrievalCandidateWire": { "description": "Wire mirror of `eg_epistemic::RetrievalCandidate` (EPI-P3-3) \u2014 one candidate in\na `Method::RankByProvenance` request, before ranking.", "properties": { "calibration": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_CalibrationWire" }, { "type": "null" } ], "description": "`None` for a candidate with no evidence-graph backing (ranks on\nsimilarity/reliability/freshness alone \u2014 an honest \"unknown\", never a\nfabricated middling score)." }, "freshness": { "format": "double", "type": "number" }, "id": { "type": "string" }, "similarity": { "format": "double", "type": "number" }, "source_reliability": { "format": "double", "type": "number" } }, "required": [ "id", "similarity", "source_reliability", "freshness" ], "type": "object" }, "ReqDef_RetrievalTraceSpec": { "description": "One stored retrieval trace for `MineRetrievalQuality` (CONCEPT:EG-KG.mining.retrieval-quality):\nwhat a query actually retrieved (ranked) vs. what was actually relevant.", "properties": { "relevant": { "description": "Ground-truth relevant ids for this query.", "items": { "type": "string" }, "type": "array" }, "retrieved": { "description": "Ranked ids the retrieval actually returned.", "items": { "type": "string" }, "type": "array" } }, "required": [ "retrieved", "relevant" ], "type": "object" }, "ReqDef_RewindTarget": { "description": "Where a rewind puts the consumer's cursor.", "oneOf": [ { "additionalProperties": false, "description": "Re-deliver everything the outbox still retains.", "properties": { "to": { "const": "start", "type": "string" } }, "required": [ "to" ], "type": "object" }, { "additionalProperties": false, "properties": { "position": { "$ref": "#/components/schemas/ReqDef_OutboxPositionView" }, "to": { "const": "at", "type": "string" } }, "required": [ "to", "position" ], "type": "object" } ] }, "ReqDef_Role": { "description": "A durable RBAC role with an optional set of parent roles forming a hierarchy\n(CONCEPT:EG-KG.compute.feature). A role transitively inherits every grant of its parents.", "properties": { "name": { "type": "string" }, "parents": { "default": [], "items": { "type": "string" }, "type": "array" } }, "required": [ "name" ], "type": "object" }, "ReqDef_RowId": { "description": "Index of a constraint (its position in [`ModelSpec::constraints`]). Every\nconstraint lowers to exactly one linear row, so this is also the row index.", "format": "uint32", "minimum": 0, "type": "integer" }, "ReqDef_RunEvent": { "additionalProperties": false, "description": "One durable projection event a [`CommitOutcomeBundle`]'s commit (or a\nrepair pass) publishes. Streaming/AG-UI/SSE/WebSocket/terminal/MCP\nsurfaces are projections of a sequence of these, never a second event\nauthority (lane doc \"Cursor/streaming semantics\").", "properties": { "capability_digest": { "type": "string" }, "carrier_digest": { "description": "Digest of the GOC-15 carrier/session this event was emitted under.", "type": "string" }, "catalog_digest": { "type": "string" }, "completeness": { "$ref": "#/components/schemas/ReqDef_OutcomeCompleteness" }, "cursor_token": { "description": "Opaque, resume-safe cursor token a stream consumer persists and\nreplays from \u2014 tenant/actor scoped, never crossing runs or audiences.", "type": "string" }, "delegation_id": { "type": "string" }, "delegator_id": { "type": "string" }, "event_sequence": { "description": "Same numeric authority as [`CommitOutcomeBundle::event_sequence`] \u2014\nnever a timestamp or opaque string (the decision record's explicit\nrule for every GOC-21/22/23/25/29/31 consumer).", "format": "uint64", "minimum": 0, "type": "integer" }, "executor_lease_actor": { "type": "string" }, "fence_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "description": "Caller-defined event kind (e.g. `\"tool_call\"`, `\"outcome\"`,\n`\"degraded\"`, `\"reconciled\"`).", "type": "string" }, "missing_refs": { "default": [], "items": { "type": "string" }, "type": "array" }, "model_digest": { "type": "string" }, "outbox_id": { "type": "string" }, "outcome": { "type": "string" }, "outcome_ref": { "type": [ "string", "null" ] }, "payload_digest": { "description": "sha256 digest of this event's canonical encoded payload \u2014 the event\ncarries a reference/digest, never raw prompt/tool-argument content\n(GOC-16 classification applies upstream, at bundle-commit time).", "type": "string" }, "policy_digest": { "type": "string" }, "result_ref": { "type": [ "string", "null" ] }, "run_id": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "selected_agent_id": { "type": "string" }, "timestamp_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "tool_call_ref": { "type": [ "string", "null" ] }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "delegation_id", "delegator_id", "selected_agent_id", "executor_lease_actor", "outcome", "work_item_id", "run_id", "fence_token", "outbox_id", "capability_digest", "catalog_digest", "policy_digest", "model_digest", "event_sequence", "completeness", "kind", "payload_digest", "timestamp_ms", "cursor_token", "carrier_digest" ], "type": "object" }, "ReqDef_Scalar": { "description": "An exact 128-bit signed integer (objective values, bounds, multipliers).", "type": "string" }, "ReqDef_ScopeTenantId": { "description": "Validated tenant security boundary. Bytes are retained exactly as supplied.", "type": "string" }, "ReqDef_SemanticActivationTarget": { "additionalProperties": false, "properties": { "ann_index_identity": { "$ref": "#/components/schemas/ReqDef_SemanticAnnIndexIdentity" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "composite_policy_digest": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index_identity": { "$ref": "#/components/schemas/ReqDef_SemanticLexicalIndexIdentity" }, "source_revision": { "type": "string" }, "target_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "tenant_id": { "type": "string" }, "vector_target_id": { "type": "string" } }, "required": [ "tenant_id", "binding_id", "binding_digest", "generation", "source_revision", "vector_target_id", "lexical_index_identity", "ann_index_identity", "composite_policy_digest", "target_digest" ], "type": "object" }, "ReqDef_SemanticActivePointer": { "additionalProperties": false, "properties": { "activated_at": { "type": "string" }, "activation_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "ann_index_identity": { "$ref": "#/components/schemas/ReqDef_SemanticAnnIndexIdentity" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "composite_policy_digest": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index_identity": { "$ref": "#/components/schemas/ReqDef_SemanticLexicalIndexIdentity" }, "source_revision": { "type": "string" }, "tenant_id": { "type": "string" }, "vector_target_id": { "type": "string" } }, "required": [ "tenant_id", "binding_id", "binding_digest", "generation", "source_revision", "vector_target_id", "lexical_index_identity", "ann_index_identity", "composite_policy_digest", "activation_receipt_digest", "activated_at" ], "type": "object" }, "ReqDef_SemanticAnnIndexIdentity": { "additionalProperties": false, "properties": { "ann_index_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "dimension": { "format": "uint32", "minimum": 0, "type": "integer" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "method": { "$ref": "#/components/schemas/ReqDef_SemanticAnnIndexMethod" }, "model_digest": { "type": "string" }, "parameters_digest": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "method", "parameters_digest", "generation", "source_revision", "model_digest", "dimension", "purpose_id", "policy_digest", "ann_index_digest" ], "type": "object" }, "ReqDef_SemanticAnnIndexManifest": { "additionalProperties": false, "properties": { "artifact_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "identity": { "$ref": "#/components/schemas/ReqDef_SemanticAnnIndexIdentity" }, "source_revision": { "type": "string" }, "vector_count": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "binding_id", "binding_digest", "generation", "source_revision", "identity", "artifact_digest", "vector_count", "completed_receipt_digest", "completed_at" ], "type": "object" }, "ReqDef_SemanticAnnIndexMethod": { "enum": [ "hnsw", "ivf_pq" ], "type": "string" }, "ReqDef_SemanticAnnIndexSpec": { "additionalProperties": false, "description": "Pre-binding ANN configuration. It intentionally has no binding or final\nindex digest; both are derived only after the binding digest exists.", "properties": { "method": { "$ref": "#/components/schemas/ReqDef_SemanticAnnIndexMethod" }, "parameters_digest": { "type": "string" } }, "required": [ "method", "parameters_digest" ], "type": "object" }, "ReqDef_SemanticAuthorizationReceipt": { "additionalProperties": false, "properties": { "actor_scope": { "type": "string" }, "authorization_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "authorized_at": { "type": "string" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "effective_actor_scope": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_decision_digest": { "type": "string" }, "policy_identity": { "$ref": "#/components/schemas/ReqDef_SemanticPolicyIdentity" }, "purpose_id": { "type": "string" }, "scope": { "$ref": "#/components/schemas/ReqDef_SemanticStageScope" }, "source_revision": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "actor_scope", "effective_actor_scope", "purpose_id", "policy_identity", "policy_decision_digest", "binding_id", "binding_digest", "generation", "scope", "source_revision", "authorized_at", "authorization_receipt_digest" ], "type": "object" }, "ReqDef_SemanticBindingDraft": { "additionalProperties": false, "description": "Caller-supplied fields; state and final digests are constructor-owned.", "properties": { "actor_scope": { "description": "Originating principal scope from the authenticated carrier authority.", "type": "string" }, "ann_index": { "$ref": "#/components/schemas/ReqDef_SemanticAnnIndexSpec" }, "binding_id": { "type": "string" }, "created_at": { "type": "string" }, "dimension": { "format": "uint32", "minimum": 0, "type": "integer" }, "effective_actor_scope": { "description": "Opaque server-derived scope for the verified delegated agent, distinct\nfrom the originating principal and never inferred from approval.", "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index": { "$ref": "#/components/schemas/ReqDef_SemanticLexicalIndexSpec" }, "maintenance_policy_id": { "type": "string" }, "metric": { "$ref": "#/components/schemas/ReqDef_SemanticVectorMetric" }, "model": { "$ref": "#/components/schemas/ReqDef_SemanticModelIdentity" }, "policy": { "$ref": "#/components/schemas/ReqDef_SemanticPolicyComponents" }, "purpose_id": { "type": "string" }, "source_field_set_digest": { "type": "string" }, "source_revision": { "type": "string" }, "source_schema_digest": { "type": "string" }, "source_selector": { "$ref": "#/components/schemas/ReqDef_SemanticSourceSelector" }, "tenant_id": { "type": "string" } }, "required": [ "binding_id", "tenant_id", "actor_scope", "effective_actor_scope", "purpose_id", "policy", "source_selector", "source_schema_digest", "source_revision", "source_field_set_digest", "dimension", "metric", "model", "generation", "maintenance_policy_id", "lexical_index", "ann_index", "created_at" ], "type": "object" }, "ReqDef_SemanticBindingState": { "enum": [ "pending", "building", "live", "disabled", "failed", "dropping" ], "type": "string" }, "ReqDef_SemanticDeadLetter": { "additionalProperties": false, "properties": { "attempt": { "format": "uint32", "minimum": 0, "type": "integer" }, "error_code": { "type": "string" }, "failed_at": { "type": "string" }, "failure_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "intent": { "$ref": "#/components/schemas/ReqDef_SemanticStageIntent" }, "reason": { "type": "string" } }, "required": [ "intent", "attempt", "error_code", "reason", "failure_digest", "failed_at" ], "type": "object" }, "ReqDef_SemanticDigest": { "description": "A SHA-256 semantic contract identity as `sha256:<64 lowercase hex>`", "maxLength": 71, "minLength": 71, "pattern": "^sha256:[0-9a-f]{64}$", "type": "string" }, "ReqDef_SemanticGenerationAggregate": { "additionalProperties": false, "properties": { "aggregate_artifact_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "aggregate_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "completed_entity_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "entity_set_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "expected_entity_count": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "expected_entity_count", "completed_entity_count", "entity_set_digest", "aggregate_receipt_digest", "aggregate_artifact_digest" ], "type": "object" }, "ReqDef_SemanticGenerationArtifact": { "description": "Closed generation-finalization artifact. This keeps the exact replay batch\nauthoritative for global lexical/ANN identities and the active pointer.", "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "const": "lexical_index_manifest", "type": "string" }, "manifest": { "$ref": "#/components/schemas/ReqDef_SemanticLexicalIndexManifest" } }, "required": [ "artifact", "manifest" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "ann_index_manifest", "type": "string" }, "manifest": { "$ref": "#/components/schemas/ReqDef_SemanticAnnIndexManifest" } }, "required": [ "artifact", "manifest" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "activation", "type": "string" }, "pointer": { "$ref": "#/components/schemas/ReqDef_SemanticActivePointer" }, "target": { "$ref": "#/components/schemas/ReqDef_SemanticActivationTarget" } }, "required": [ "artifact", "target", "pointer" ], "type": "object" } ] }, "ReqDef_SemanticGenerationCheckpoint": { "additionalProperties": false, "properties": { "aggregate": { "$ref": "#/components/schemas/ReqDef_SemanticGenerationAggregate" }, "artifact_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "checkpoint_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "completed_at": { "type": "string" }, "dependency": { "$ref": "#/components/schemas/ReqDef_SemanticGenerationDependency" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_revision": { "type": "string" }, "stage": { "$ref": "#/components/schemas/ReqDef_SemanticStage" } }, "required": [ "binding_id", "binding_digest", "generation", "source_revision", "stage", "aggregate", "dependency", "artifact_digest", "completed_at", "checkpoint_digest" ], "type": "object" }, "ReqDef_SemanticGenerationCheckpointUpdate": { "additionalProperties": false, "description": "One exact checkpoint compare-and-swap carried with an S3/S5 completion.\nThe owner store must load the expected predecessor, insert `member`,\nrecompute the complete sorted aggregate from authoritative entity rows,\nand compare it with `successor` in the same transaction.", "properties": { "expected_previous_checkpoint_digest": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, { "type": "null" } ] }, "expected_previous_completed_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "member": { "$ref": "#/components/schemas/ReqDef_SemanticGenerationMember" }, "successor": { "$ref": "#/components/schemas/ReqDef_SemanticGenerationCheckpoint" } }, "required": [ "expected_previous_completed_count", "member", "successor" ], "type": "object" }, "ReqDef_SemanticGenerationDependency": { "oneOf": [ { "additionalProperties": false, "properties": { "dependency": { "const": "none", "type": "string" } }, "required": [ "dependency" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "dependency": { "const": "checkpoint", "type": "string" }, "stage": { "$ref": "#/components/schemas/ReqDef_SemanticStage" } }, "required": [ "dependency", "stage", "checkpoint_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "ann_checkpoint_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "dependency": { "const": "activation", "type": "string" }, "lexical_checkpoint_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" } }, "required": [ "dependency", "lexical_checkpoint_digest", "ann_checkpoint_digest" ], "type": "object" } ] }, "ReqDef_SemanticGenerationMember": { "additionalProperties": false, "properties": { "artifact_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "source_entity_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "source_entity_id", "source_revision", "receipt_digest", "artifact_digest" ], "type": "object" }, "ReqDef_SemanticGraphProjectionManifest": { "additionalProperties": false, "properties": { "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "manifest_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "projection_content_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "projection_entity_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "source_entity_id": { "type": "string" }, "source_manifest_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "generation", "source_entity_id", "source_revision", "source_manifest_digest", "projection_entity_digest", "projection_content_digest", "completed_receipt_digest", "completed_at", "manifest_digest" ], "type": "object" }, "ReqDef_SemanticIndexFilter": { "additionalProperties": false, "description": "Closed relational/identity filter. Raw predicates and SQL expressions have\nno representable field.", "properties": { "max_results": { "format": "uint32", "minimum": 0, "type": "integer" }, "required_source_revision": { "type": [ "string", "null" ] }, "source_entity_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "source_entity_ids", "max_results" ], "type": "object" }, "ReqDef_SemanticIndexOp": { "description": "Operations over one durable semantic binding and its S1-S6 stage queue.\n\nShaped like [`crate::agent_component::AgentComponentOp`] and its three\nsibling layers: one `Method` carrying a closed op enum, with the read/write\nclassification living on the op itself ([`Self::is_mutation`]) so the\ncapability policy and `server::access::requires_write` cannot drift apart\nabout which operations write.", "oneOf": [ { "additionalProperties": false, "description": "Mint and persist a binding, publishing its durable creation event.\n\nThe DRAFT is what travels, not a built `SemanticBinding`: the engine\ncalls `SemanticBinding::create`, so the binding digest is computed over\nwhat the engine validated rather than accepted from the caller.", "properties": { "binding_id": { "type": "string" }, "draft": { "$ref": "#/components/schemas/ReqDef_SemanticBindingDraft", "description": "Boxed: a binding draft carries roughly twenty governed fields and\nwould otherwise set the size of every `Method`." }, "idempotency_key": { "description": "The caller's stable retry identity. The per-attempt nonce is minted\nby the engine and is deliberately not representable here.", "type": "string" }, "op": { "const": "admit_binding", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "draft", "idempotency_key" ], "type": "object" }, { "additionalProperties": false, "description": "Replace a live generation with an operation-bound pending one. The old\nactive pointer remains the serving proof until S6 publishes.", "properties": { "binding_id": { "type": "string" }, "draft": { "$ref": "#/components/schemas/ReqDef_SemanticBindingDraft" }, "expected_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "op": { "const": "refresh_binding", "type": "string" }, "source_manifest": { "$ref": "#/components/schemas/ReqDef_SemanticSqlSourceManifestDraft" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "expected_generation", "draft", "source_manifest", "idempotency_key" ], "type": "object" }, { "additionalProperties": false, "description": "Move the durable binding state machine (e.g. `Pending` -> `Building`),\nfenced on the exact generation the caller believes is live.", "properties": { "binding_id": { "type": "string" }, "expected_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "next_state": { "$ref": "#/components/schemas/ReqDef_SemanticBindingState" }, "op": { "const": "transition_binding", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "expected_generation", "next_state", "idempotency_key" ], "type": "object" }, { "additionalProperties": false, "description": "Retire the binding at an exact generation.", "properties": { "binding_id": { "type": "string" }, "expected_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "op": { "const": "drop_binding", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "expected_generation", "idempotency_key" ], "type": "object" }, { "additionalProperties": false, "description": "One coarse wakeup whose source owner guarantees exactly one complete\nrow. Multi-row providers must use [`Self::AdmitSourcePage`].", "properties": { "binding_id": { "type": "string" }, "op": { "const": "admit_source_record", "type": "string" }, "record": { "$ref": "#/components/schemas/ReqDef_MutationOutboxRecord", "description": "The committed SQL mutation this wakeup names. Boxed for size." }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "record" ], "type": "object" }, { "additionalProperties": false, "description": "One bounded page of a multi-row wakeup, resumed by the previous page's\nopaque cursor.", "properties": { "binding_id": { "type": "string" }, "cursor": { "type": [ "string", "null" ] }, "op": { "const": "admit_source_page", "type": "string" }, "record": { "$ref": "#/components/schemas/ReqDef_MutationOutboxRecord" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "record" ], "type": "object" }, { "additionalProperties": false, "description": "A complete-snapshot reconciliation turn: page the authoritative source,\nthen emit absence tombstones once the complete-page proof holds. Bounded\nper turn by the service's own page/row/byte budgets, so a large source\nresumes rather than being refused.", "properties": { "binding_id": { "type": "string" }, "op": { "const": "admit_source_reconcile", "type": "string" }, "record": { "$ref": "#/components/schemas/ReqDef_MutationOutboxRecord" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "record" ], "type": "object" }, { "additionalProperties": false, "description": "Admit S1 after a refresh has advanced the durable binding head.", "properties": { "binding_id": { "type": "string" }, "draft": { "$ref": "#/components/schemas/ReqDef_SemanticBindingDraft" }, "op": { "const": "admit_source_replacement", "type": "string" }, "record": { "$ref": "#/components/schemas/ReqDef_MutationOutboxRecord" }, "source_manifest": { "$ref": "#/components/schemas/ReqDef_SemanticSqlSourceManifestDraft" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "draft", "source_manifest", "record" ], "type": "object" }, { "additionalProperties": false, "description": "Durably subscribe a named consumer to this binding's stage topic. A\nconsumer with no durable subscription claims nothing.", "properties": { "binding_id": { "type": "string" }, "consumer": { "type": "string" }, "op": { "const": "subscribe_stage_consumer", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "consumer" ], "type": "object" }, { "additionalProperties": false, "description": "Take a bounded set of stage leases for one queue class.", "properties": { "binding_id": { "type": "string" }, "consumer": { "type": "string" }, "lease_ms": { "description": "At most [`MAX_SEMANTIC_STAGE_LEASE_MS`].", "format": "uint64", "minimum": 0, "type": "integer" }, "limit": { "description": "At most [`MAX_SEMANTIC_STAGE_CLAIM_LIMIT`].", "format": "uint32", "minimum": 0, "type": "integer" }, "op": { "const": "claim_stage_leases", "type": "string" }, "queue_class": { "$ref": "#/components/schemas/ReqDef_SemanticQueueClass", "description": "The tier this worker serves. Rows whose stage belongs to another\nclass are released back unexecuted rather than handed to a worker\nthat cannot do them -- tier selection is the whole point of a\ntiered queue, so it has to be expressible on the wire." }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "consumer", "queue_class", "limit", "lease_ms" ], "type": "object" }, { "additionalProperties": false, "description": "Re-check a held lease and return the canonical intent it leases, without\ncommitting anything. A worker calls this before starting expensive work.", "properties": { "binding_id": { "type": "string" }, "consumer": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ReqDef_MutationOutboxLease" }, "op": { "const": "validate_stage_lease", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "consumer", "lease" ], "type": "object" }, { "additionalProperties": false, "description": "The bounded queue's per-consumer liveness, capacity and in-flight count.", "properties": { "binding_id": { "type": "string" }, "consumer": { "type": "string" }, "op": { "const": "stage_status", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "consumer" ], "type": "object" }, { "additionalProperties": false, "description": "Persist one terminal entity-scoped transition with its artifact, publish\nthe successor intent when the predecessor proof is complete, and\nacknowledge the exact lease -- one durable mutation.", "properties": { "artifact": { "$ref": "#/components/schemas/ReqDef_SemanticStageArtifact" }, "binding_id": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ReqDef_MutationOutboxLease" }, "op": { "const": "complete_stage", "type": "string" }, "successor": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SemanticStageIntent" }, { "type": "null" } ] }, "tenant_id": { "type": "string" }, "transition": { "$ref": "#/components/schemas/ReqDef_SemanticStageTransition" } }, "required": [ "op", "tenant_id", "binding_id", "lease", "transition", "artifact" ], "type": "object" }, { "additionalProperties": false, "description": "Complete S3 or S5 and persist its canonical lexical/ANN manifest in the\nsame owner mutation as the transition, checkpoint, successor and lease\nacknowledgement.", "properties": { "artifact": { "$ref": "#/components/schemas/ReqDef_SemanticGenerationArtifact" }, "binding_id": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ReqDef_MutationOutboxLease" }, "op": { "const": "complete_generation_stage", "type": "string" }, "successor": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SemanticStageIntent" }, { "type": "null" } ] }, "tenant_id": { "type": "string" }, "transition": { "$ref": "#/components/schemas/ReqDef_SemanticStageTransition" } }, "required": [ "op", "tenant_id", "binding_id", "lease", "transition", "artifact" ], "type": "object" }, { "additionalProperties": false, "description": "Complete an S1 source transition. No source row travels: the engine\nre-reads the authoritative, ACL-checked SQL page itself and converts its\ndecision into the authorization receipt. A caller that could supply the\nrow could index text it is not allowed to read.", "properties": { "binding_id": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ReqDef_MutationOutboxLease" }, "op": { "const": "complete_sql_source_stage", "type": "string" }, "page_cursor": { "description": "The opaque page cursor the intent was claimed from, so the exact\nbounded page is re-read.", "type": [ "string", "null" ] }, "successor": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SemanticStageIntent" }, { "type": "null" } ] }, "tenant_id": { "type": "string" }, "transition": { "$ref": "#/components/schemas/ReqDef_SemanticStageTransition" } }, "required": [ "op", "tenant_id", "binding_id", "lease", "transition" ], "type": "object" }, { "additionalProperties": false, "description": "Resolve an S1 completion that may already have committed before a crash.\n`None` means it has not, and the caller may proceed through\n[`Self::CompleteSqlSourceStage`].", "properties": { "binding_id": { "type": "string" }, "expected_intent": { "$ref": "#/components/schemas/ReqDef_SemanticStageIntent" }, "lease": { "$ref": "#/components/schemas/ReqDef_MutationOutboxLease" }, "op": { "const": "replay_completed_sql_source_stage", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "lease", "expected_intent" ], "type": "object" }, { "additionalProperties": false, "description": "Hand a lease back unexecuted. Without this a connector that cannot do\nthe work it claimed wedges the row until the lease lapses.", "properties": { "binding_id": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ReqDef_MutationOutboxLease" }, "op": { "const": "release_stage_lease", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "lease" ], "type": "object" }, { "additionalProperties": false, "description": "The durable binding head of this owner.", "properties": { "binding_id": { "type": "string" }, "op": { "const": "binding", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id" ], "type": "object" }, { "additionalProperties": false, "description": "The one retained prior SQL source manifest a complete-page deletion\nproof needs. It never reconstructs deleted bytes.", "properties": { "binding_id": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "op": { "const": "sql_source_manifest", "type": "string" }, "source_entity_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "generation", "source_entity_id" ], "type": "object" }, { "additionalProperties": false, "description": "The bounded binding catalog. Paginated; see [`SemanticBindingPage`].", "properties": { "binding_id": { "type": "string" }, "cursor": { "type": [ "string", "null" ] }, "filter": { "$ref": "#/components/schemas/ReqDef_SemanticIndexFilter" }, "op": { "const": "list_bindings", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "filter" ], "type": "object" }, { "additionalProperties": false, "description": "The generation currently serving reads, if any.", "properties": { "binding_id": { "type": "string" }, "op": { "const": "live_generation", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id" ], "type": "object" } ] }, "ReqDef_SemanticLexicalIndexIdentity": { "additionalProperties": false, "properties": { "analyzer_config_digest": { "type": "string" }, "analyzer_id": { "type": "string" }, "analyzer_revision": { "type": "string" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "analyzer_id", "analyzer_revision", "analyzer_config_digest", "generation", "source_revision", "purpose_id", "policy_digest", "lexical_index_digest" ], "type": "object" }, "ReqDef_SemanticLexicalIndexManifest": { "additionalProperties": false, "properties": { "artifact_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "identity": { "$ref": "#/components/schemas/ReqDef_SemanticLexicalIndexIdentity" }, "row_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "generation", "source_revision", "identity", "artifact_digest", "row_count", "completed_receipt_digest", "completed_at" ], "type": "object" }, "ReqDef_SemanticLexicalIndexSpec": { "additionalProperties": false, "description": "Pre-binding lexical configuration. It intentionally has no binding or\nfinal index digest, breaking the otherwise circular binding identity.", "properties": { "analyzer_config_digest": { "type": "string" }, "analyzer_id": { "type": "string" }, "analyzer_revision": { "type": "string" } }, "required": [ "analyzer_id", "analyzer_revision", "analyzer_config_digest" ], "type": "object" }, "ReqDef_SemanticModelIdentity": { "additionalProperties": false, "properties": { "model_digest": { "type": "string" }, "model_id": { "type": "string" }, "model_revision": { "type": "string" }, "preprocess_digest": { "type": "string" } }, "required": [ "model_id", "model_revision", "preprocess_digest", "model_digest" ], "type": "object" }, "ReqDef_SemanticPolicyComponents": { "additionalProperties": false, "properties": { "rbac_policy_digest": { "type": "string" }, "rbac_policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "row_policy_digest": { "type": "string" }, "row_policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_acl_digest": { "type": "string" }, "source_acl_revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "rbac_policy_revision", "rbac_policy_digest", "row_policy_revision", "row_policy_digest", "source_acl_revision", "source_acl_digest" ], "type": "object" }, "ReqDef_SemanticPolicyIdentity": { "additionalProperties": false, "properties": { "components": { "$ref": "#/components/schemas/ReqDef_SemanticPolicyComponents" }, "effective_actor_scope": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "effective_actor_scope", "purpose_id", "components", "policy_digest" ], "type": "object" }, "ReqDef_SemanticQueueClass": { "enum": [ "fast", "medium", "slow_heavy" ], "type": "string" }, "ReqDef_SemanticSourceSelector": { "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "sql_column_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ReqDef_SqlColumnRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "graph_text_property_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ReqDef_GraphTextPropertyRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "canonical_text_asset", "type": "string" }, "selector": { "$ref": "#/components/schemas/ReqDef_CanonicalTextAssetRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "agent_library_composite", "type": "string" }, "selector": { "$ref": "#/components/schemas/ReqDef_AgentLibraryCompositeRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "multimodal_asset_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ReqDef_MultimodalAssetRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "time_series_window_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ReqDef_TimeSeriesWindowRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "lakehouse_vector_projection_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ReqDef_LakehouseVectorProjectionRef" } }, "required": [ "kind", "selector" ], "type": "object" } ] }, "ReqDef_SemanticSqlSourceIdentity": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "column_id": { "type": "string" }, "record_identity_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest", "description": "Server-derived digest of the stable row identity. Raw predicates and\nprimary-key values are intentionally not transport fields." }, "schema_id": { "type": "string" }, "source_identity_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "table_id": { "type": "string" }, "tenant_scope": { "type": "string" } }, "required": [ "tenant_scope", "catalog_id", "schema_id", "table_id", "column_id", "record_identity_digest", "source_identity_digest" ], "type": "object" }, "ReqDef_SemanticSqlSourceManifest": { "additionalProperties": false, "properties": { "authorization_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "manifest_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "source_acl_digest": { "type": "string" }, "source_acl_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_content_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "source_entity_id": { "type": "string" }, "source_field_set_digest": { "type": "string" }, "source_identity": { "$ref": "#/components/schemas/ReqDef_SemanticSqlSourceIdentity" }, "source_revision": { "type": "string" }, "source_schema_digest": { "type": "string" }, "source_schema_revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "binding_id", "binding_digest", "generation", "source_identity", "source_entity_id", "source_revision", "source_content_digest", "source_schema_revision", "source_schema_digest", "source_field_set_digest", "source_acl_revision", "source_acl_digest", "authorization_receipt_digest", "completed_receipt_digest", "completed_at", "manifest_digest" ], "type": "object" }, "ReqDef_SemanticSqlSourceManifestDraft": { "additionalProperties": false, "properties": { "authorization_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_acl_digest": { "type": "string" }, "source_acl_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_content_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "source_field_set_digest": { "type": "string" }, "source_identity": { "$ref": "#/components/schemas/ReqDef_SemanticSqlSourceIdentity" }, "source_revision": { "type": "string" }, "source_schema_digest": { "type": "string" }, "source_schema_revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "binding_id", "binding_digest", "generation", "source_identity", "source_revision", "source_content_digest", "source_schema_revision", "source_schema_digest", "source_field_set_digest", "source_acl_revision", "source_acl_digest", "authorization_receipt_digest", "completed_receipt_digest", "completed_at" ], "type": "object" }, "ReqDef_SemanticStage": { "enum": [ "S1", "S2", "S3", "S4", "S5", "S6" ], "type": "string" }, "ReqDef_SemanticStageArtifact": { "description": "Closed entity-stage owner artifact carried inside the exact-replay mutation.\nGlobal index manifests and activation are committed only by\n[`SemanticIndexMutation::FinalizeGeneration`].", "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "const": "none", "type": "string" } }, "required": [ "artifact" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "sql_source_manifest", "type": "string" }, "authorization": { "$ref": "#/components/schemas/ReqDef_SemanticAuthorizationReceipt" }, "manifest": { "$ref": "#/components/schemas/ReqDef_SemanticSqlSourceManifest" } }, "required": [ "artifact", "manifest", "authorization" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "graph_projection_manifest", "type": "string" }, "manifest": { "$ref": "#/components/schemas/ReqDef_SemanticGraphProjectionManifest" } }, "required": [ "artifact", "manifest" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "vector", "type": "string" }, "vector": { "$ref": "#/components/schemas/ReqDef_SemanticVector" } }, "required": [ "artifact", "vector" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "dead_letter", "type": "string" }, "dead_letter": { "$ref": "#/components/schemas/ReqDef_SemanticDeadLetter" } }, "required": [ "artifact", "dead_letter" ], "type": "object" } ] }, "ReqDef_SemanticStageIntent": { "additionalProperties": false, "properties": { "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "input_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "intent_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "predecessor": { "$ref": "#/components/schemas/ReqDef_SemanticStagePredecessor" }, "scope": { "$ref": "#/components/schemas/ReqDef_SemanticStageScope" }, "source_revision": { "type": "string" }, "stage": { "$ref": "#/components/schemas/ReqDef_SemanticStage" } }, "required": [ "binding_id", "binding_digest", "generation", "scope", "source_revision", "stage", "predecessor", "input_digest", "intent_digest" ], "type": "object" }, "ReqDef_SemanticStageOutcome": { "enum": [ "completed", "idempotent_noop", "deferred_backpressured", "parked_awaiting_predecessor", "rejected_dead_letter" ], "type": "string" }, "ReqDef_SemanticStagePredecessor": { "oneOf": [ { "additionalProperties": false, "properties": { "proof": { "const": "none", "type": "string" } }, "required": [ "proof" ], "type": "object" }, { "additionalProperties": false, "properties": { "proof": { "const": "entity_receipt", "type": "string" }, "receipt_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "stage": { "$ref": "#/components/schemas/ReqDef_SemanticStage" } }, "required": [ "proof", "stage", "receipt_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "proof": { "const": "generation_checkpoint", "type": "string" }, "stage": { "$ref": "#/components/schemas/ReqDef_SemanticStage" } }, "required": [ "proof", "stage", "checkpoint_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint": { "$ref": "#/components/schemas/ReqDef_SemanticGenerationCheckpoint" }, "proof": { "const": "generation_coverage", "type": "string" } }, "required": [ "proof", "checkpoint" ], "type": "object" }, { "additionalProperties": false, "properties": { "ann_checkpoint_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "lexical_checkpoint_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "proof": { "const": "activation", "type": "string" } }, "required": [ "proof", "lexical_checkpoint_digest", "ann_checkpoint_digest" ], "type": "object" } ] }, "ReqDef_SemanticStageReceipt": { "additionalProperties": false, "properties": { "completed_at": { "type": "string" }, "cursor": { "type": "string" }, "intent_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "outcome": { "$ref": "#/components/schemas/ReqDef_SemanticStageOutcome" }, "output_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" } }, "required": [ "intent_digest", "output_digest", "cursor", "completed_at", "outcome" ], "type": "object" }, "ReqDef_SemanticStageScope": { "oneOf": [ { "additionalProperties": false, "properties": { "scope": { "const": "entity", "type": "string" }, "source_entity_id": { "type": "string" } }, "required": [ "scope", "source_entity_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "scope": { "const": "generation", "type": "string" } }, "required": [ "scope" ], "type": "object" } ] }, "ReqDef_SemanticStageTransition": { "additionalProperties": false, "properties": { "generation_checkpoint": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SemanticGenerationCheckpointUpdate" }, { "type": "null" } ] }, "intent": { "$ref": "#/components/schemas/ReqDef_SemanticStageIntent" }, "receipt": { "$ref": "#/components/schemas/ReqDef_SemanticStageReceipt" } }, "required": [ "intent", "receipt" ], "type": "object" }, "ReqDef_SemanticVector": { "additionalProperties": false, "properties": { "binding_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" }, "binding_id": { "type": "string" }, "dimension": { "format": "uint32", "minimum": 0, "type": "integer" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "model_digest": { "type": "string" }, "policy_digest": { "type": "string" }, "preprocess_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_entity_id": { "type": "string" }, "source_revision": { "type": "string" }, "values": { "items": { "format": "float", "type": "number" }, "type": "array" }, "values_digest": { "$ref": "#/components/schemas/ReqDef_SemanticDigest" } }, "required": [ "binding_id", "binding_digest", "generation", "source_entity_id", "source_revision", "model_digest", "preprocess_digest", "dimension", "purpose_id", "policy_digest", "values", "values_digest" ], "type": "object" }, "ReqDef_SemanticVectorMetric": { "enum": [ "cosine", "dot_product", "euclidean" ], "type": "string" }, "ReqDef_SequenceSource": { "description": "A graph-derived sequence source for `MineSequence` (CONCEPT:EG-KG.mining.prefixspan\n\u2014 Phase 4). Each node carrying `node_label` becomes one ordered sequence: the\nlist of `item_field` values gathered from its neighbors in `direction`,\npreserving the RESIDENT EDGE INSERTION ORDER (the natural \"ordered edge\nsequence per node\" \u2014 edges accumulate in the order they were added, so this\nis compute-near-data over the bitemporal write history without a separate\ntsdb/event-log dependency), optionally filtered to a `relation`.", "properties": { "direction": { "default": "out", "description": "Edge direction to gather neighbors: `out` (successors, default \u2014 the\nnatural \"what happened after\" order), `in` (predecessors), or `any`.", "type": "string" }, "item_field": { "description": "Which value of each neighbor becomes an item: `label` (the neighbor's\ntype/label, default) or `prop:` (a neighbor property value). When\n`None`, the neighbor's node id is used verbatim.", "type": [ "string", "null" ] }, "limit": { "description": "Cap the number of sequence owners scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances each become one ordered sequence.", "type": "string" }, "relation": { "description": "Optional edge-relation filter: only follow edges whose `relationship`\nproperty equals this. `None` \u21d2 all edges.", "type": [ "string", "null" ] } }, "required": [ "node_label" ], "type": "object" }, "ReqDef_ServedModalityIngestItem": { "additionalProperties": false, "description": "One element of an atomic, bounded served-modality ingest stream. Every item uses\nthe enclosing operation's modality and is decoded before any durable state changes.", "properties": { "bundle_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "expected_version": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "idempotency_ref": { "type": "string" }, "source_bytes": { "description": "Ephemeral decoder input; excluded from receipts, snapshots, events, and indexes.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "target_occurrence_id": { "type": "string" } }, "required": [ "idempotency_ref", "target_occurrence_id", "bundle_msgpack", "source_bytes" ], "type": "object" }, "ReqDef_ServedModalityKind": { "enum": [ "document", "image", "audio", "video" ], "type": "string" }, "ReqDef_ServedModalityOp": { "description": "One operation on the graph-scoped governed modality runtime.\n\nQuery authority is intentionally absent from this DTO. The server derives tenant,\naccess-policy, purpose, and classification scope from the cryptographically\nverified request context, so a caller cannot widen its own RLS boundary.", "oneOf": [ { "additionalProperties": false, "description": "Return the opaque policy references derived for this verified request. This\nlets a producer construct a matching certified `ArtifactBundle` without any\ndeployment-specific identifiers or paths in configuration.", "properties": { "operation": { "const": "authority", "type": "string" } }, "required": [ "operation" ], "type": "object" }, { "additionalProperties": false, "description": "Decode the concrete native format, validate that it matches the certified\nbundle, and atomically create or update one occurrence.", "properties": { "bundle_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "expected_version": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "idempotency_ref": { "type": "string" }, "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "operation": { "const": "ingest", "type": "string" }, "source_bytes": { "description": "Ephemeral source bytes. The runtime derives only normalized metadata and a\ncontent address; these bytes are omitted from snapshots, audit, CDC, and\nMutationBatch status/outbox records.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "target_occurrence_id": { "type": "string" } }, "required": [ "operation", "modality", "idempotency_ref", "target_occurrence_id", "bundle_msgpack", "source_bytes" ], "type": "object" }, { "additionalProperties": false, "description": "Decode and apply two or more records as one atomic bounded stream. A decode,\nauthority, OCC, or resource failure rolls back every item and emits no event.", "properties": { "items": { "items": { "$ref": "#/components/schemas/ReqDef_ServedModalityIngestItem" }, "type": "array" }, "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "operation": { "const": "ingest_stream", "type": "string" } }, "required": [ "operation", "modality", "items" ], "type": "object" }, { "additionalProperties": false, "properties": { "after_occurrence_id": { "default": null, "type": [ "string", "null" ] }, "include_cold": { "default": false, "type": "boolean" }, "limit": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "operation": { "const": "query", "type": "string" }, "segment_kind": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ServedSegmentKind" }, { "type": "null" } ], "default": null } }, "required": [ "operation", "modality" ], "type": "object" }, { "additionalProperties": false, "properties": { "after_occurrence_id": { "default": null, "type": [ "string", "null" ] }, "include_cold": { "default": false, "type": "boolean" }, "limit": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "operation": { "const": "native_query", "type": "string" }, "predicate": { "$ref": "#/components/schemas/ReqDef_ServedNativePredicate" } }, "required": [ "operation", "predicate" ], "type": "object" }, { "additionalProperties": false, "properties": { "expected_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_ref": { "type": "string" }, "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "occurrence_id": { "type": "string" }, "operation": { "const": "delete", "type": "string" } }, "required": [ "operation", "modality", "idempotency_ref", "occurrence_id", "expected_version" ], "type": "object" }, { "additionalProperties": false, "properties": { "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "occurrence_id": { "type": "string" }, "operation": { "const": "move_to_cold", "type": "string" } }, "required": [ "operation", "modality", "occurrence_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "occurrence_id": { "type": "string" }, "operation": { "const": "restore", "type": "string" } }, "required": [ "operation", "modality", "occurrence_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "after_sequence": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" }, "limit": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "operation": { "const": "events", "type": "string" } }, "required": [ "operation", "modality" ], "type": "object" }, { "additionalProperties": false, "description": "Return live, authority-partitioned storage/index/event counts. No identifier,\nsource byte, query text, path, or deployment field is included.", "properties": { "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "operation": { "const": "stats", "type": "string" } }, "required": [ "operation", "modality" ], "type": "object" }, { "additionalProperties": false, "description": "Physically collect authorized tombstoned records after retention has been\ndemonstrated. The durable idempotency/event ledger remains append-only.", "properties": { "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "operation": { "const": "collect_tombstones", "type": "string" }, "through_event_sequence": { "description": "Inclusive durable event fence. Tombstones newer than this checkpoint are\nretained, so collection cannot race an unobserved delete.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "operation", "modality", "through_event_sequence" ], "type": "object" }, { "additionalProperties": false, "description": "Return the concrete leaf component's TCK summary. This is deliberately not a\nrelease-readiness claim; G-14 derives that only from executable behavior plus\nsame-artifact performance evidence.", "properties": { "modality": { "$ref": "#/components/schemas/ReqDef_ServedModalityKind" }, "operation": { "const": "capabilities", "type": "string" } }, "required": [ "operation", "modality" ], "type": "object" } ] }, "ReqDef_ServedNativePredicate": { "description": "Native, index-backed query predicates. Document text is ephemeral request data;\nthe server converts it to an authority-keyed lexeme before index access and never\nincludes it in cursors, logs, receipts, or persisted state.", "oneOf": [ { "additionalProperties": false, "properties": { "page": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "predicate": { "const": "document_lexical", "type": "string" }, "term": { "type": "string" } }, "required": [ "predicate", "term" ], "type": "object" }, { "additionalProperties": false, "properties": { "height": { "format": "double", "type": "number" }, "predicate": { "const": "image_region", "type": "string" }, "width": { "format": "double", "type": "number" }, "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "predicate", "x", "y", "width", "height" ], "type": "object" }, { "additionalProperties": false, "properties": { "hash": { "format": "uint64", "minimum": 0, "type": "integer" }, "maximum_distance": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "predicate": { "const": "image_perceptual_hash", "type": "string" } }, "required": [ "predicate", "hash", "maximum_distance" ], "type": "object" }, { "additionalProperties": false, "properties": { "end_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "minimum_rms": { "format": "float", "type": "number" }, "predicate": { "const": "audio_window", "type": "string" }, "start_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "predicate", "start_ms", "end_ms", "minimum_rms" ], "type": "object" }, { "additionalProperties": false, "properties": { "end_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "keyframes_only": { "type": "boolean" }, "predicate": { "const": "video_window", "type": "string" }, "start_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "predicate", "start_ms", "end_ms", "keyframes_only" ], "type": "object" } ] }, "ReqDef_ServedSegmentKind": { "enum": [ "page", "paragraph", "table", "row", "region", "audio_range", "video_shot", "frame_range", "time_window", "code_symbol", "trace_span" ], "type": "string" }, "ReqDef_ServerDesiredState": { "description": "The operator's DESIRED state for a registered server.\n\nDesired, not observed: whether the server answered its last probe is a\ndiscovery observation (`FleetCatalog.RecordDiscovery`), and the two are\nnever collapsed into one status.", "enum": [ "enabled", "disabled" ], "type": "string" }, "ReqDef_ServerTransport": { "description": "How a registered server is reached. Closed on purpose: a transport the\nengine cannot name is `Unspecified`, never a free-form string.", "oneOf": [ { "const": "unspecified", "description": "A registration that predates the typed field, or did not say.", "type": "string" }, { "const": "stdio", "description": "A local child process speaking MCP over stdio.", "type": "string" }, { "const": "streamable_http", "description": "MCP streamable HTTP.", "type": "string" }, { "const": "sse", "description": "MCP over server-sent events.", "type": "string" }, { "const": "http", "description": "Plain HTTP JSON-RPC.", "type": "string" } ] }, "ReqDef_Sha256Digest": { "description": "A SHA-256 digest, serialised as 64 lower-case hex characters.", "type": "string" }, "ReqDef_SkillType": { "description": "How a skill is run. The four values the agent ecosystem declares.", "enum": [ "skill", "workflow", "graph", "mcp_skill" ], "type": "string" }, "ReqDef_SlotAssignment": { "additionalProperties": false, "description": "One slot of the assembled graph and the component bound to it.", "properties": { "component": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "slot": { "type": "string" } }, "required": [ "slot", "component" ], "type": "object" }, "ReqDef_SolveModelSpec": { "additionalProperties": false, "description": "A complete 0-1 integer programme: binary variables, labelled constraints and\na lexicographic objective whose first level is the most significant.", "properties": { "constraints": { "items": { "$ref": "#/components/schemas/ReqDef_ConstraintSpec" }, "type": "array" }, "objective": { "items": { "$ref": "#/components/schemas/ReqDef_ObjectiveLevelSpec" }, "type": "array" }, "variables": { "items": { "type": "string" }, "type": "array" } }, "required": [ "variables", "constraints", "objective" ], "type": "object" }, "ReqDef_SolveRequest": { "additionalProperties": false, "description": "One bounded 0-1 integer programme to solve.", "properties": { "config": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SolverConfigSpec" }, { "type": "null" } ], "default": null, "description": "Absent means the engine's default budget, leaf limit and denominator." }, "model": { "$ref": "#/components/schemas/ReqDef_SolveModelSpec" } }, "required": [ "model" ], "type": "object" }, "ReqDef_SolveStatus": { "description": "The outcome class of a solve.", "oneOf": [ { "const": "optimal", "description": "The incumbent is optimal and the tree or root proof certifies it.", "type": "string" }, { "additionalProperties": false, "description": "The search completed; its tree exceeded the certificate limit, so the\nproof is a reproducible deterministic derivation, not a certificate.", "properties": { "optimal_by_deterministic_search": { "additionalProperties": false, "properties": { "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes_expanded" ], "type": "object" } }, "required": [ "optimal_by_deterministic_search" ], "type": "object" }, { "additionalProperties": false, "description": "The budget ran out with a certified gap no larger than the accepted gap.", "properties": { "feasible_with_gap": { "additionalProperties": false, "properties": { "gap": { "$ref": "#/components/schemas/ReqDef_Scalar" } }, "required": [ "gap" ], "type": "object" } }, "required": [ "feasible_with_gap" ], "type": "object" }, { "additionalProperties": false, "description": "No feasible assignment exists; `core` lists the rows the proof uses.", "properties": { "infeasible": { "additionalProperties": false, "properties": { "core": { "items": { "$ref": "#/components/schemas/ReqDef_RowId" }, "type": "array" } }, "required": [ "core" ], "type": "object" } }, "required": [ "infeasible" ], "type": "object" }, { "additionalProperties": false, "description": "The search completed without a feasible assignment and without a\ncertificate-sized tree.", "properties": { "infeasible_by_deterministic_search": { "additionalProperties": false, "properties": { "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes_expanded" ], "type": "object" } }, "required": [ "infeasible_by_deterministic_search" ], "type": "object" }, { "const": "budget_exhausted", "description": "The budget ran out with no incumbent or a gap above the accepted gap.", "type": "string" } ] }, "ReqDef_SolverBudget": { "additionalProperties": false, "description": "A caller's per-request solver budget. It may only TIGHTEN the policy; a\nrequest that tries to widen one is refused with `POLICY_LOOSENING`.", "properties": { "max_why_not_per_slot": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_why_not_per_slot" ], "type": "object" }, "ReqDef_SolverConfig": { "additionalProperties": false, "description": "Deterministic work limits and gap acceptance. No wall clock is read.", "properties": { "accepted_gap": { "$ref": "#/components/schemas/ReqDef_Scalar" }, "bound_denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_certificate_leaves": { "format": "uint32", "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_certificate_leaves", "bound_denominator", "accepted_gap" ], "type": "object" }, "ReqDef_SolverConfigSpec": { "additionalProperties": false, "description": "Wire form of a [`SolverConfig`].", "properties": { "accepted_gap": { "$ref": "#/components/schemas/ReqDef_Scalar" }, "bound_denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_certificate_leaves": { "format": "uint32", "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_certificate_leaves", "bound_denominator", "accepted_gap" ], "type": "object" }, "ReqDef_SolverIdentity": { "additionalProperties": false, "description": "The solver identity a record was decided under.", "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_Algorithm" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "algorithm", "node_budget" ], "type": "object" }, "ReqDef_SourceChangeSet": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "authorization": { "$ref": "#/components/schemas/ReqDef_WriteBackAuthorizationDecision" }, "base_source_version": { "type": "string" }, "change_set_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "change_set_id": { "type": "string" }, "connector_id": { "type": "string" }, "desired_patch": { "additionalProperties": true, "type": "object" }, "entity_id": { "type": "string" }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "field_provenance": { "additionalProperties": { "type": "string" }, "type": "object" }, "field_scope": { "items": { "type": "string" }, "type": "array" }, "idempotency_key": { "type": "string" }, "policy_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "purpose": { "type": "string" }, "reconciliation_procedure": { "type": "string" }, "required_capability": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "source_instance_id": { "type": "string" }, "source_of_truth_rule": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "change_set_id", "change_set_digest", "tenant_id", "actor", "purpose", "connector_id", "source_instance_id", "entity_id", "field_scope", "base_source_version", "desired_patch", "source_of_truth_rule", "field_provenance", "required_capability", "policy_digest", "authorization", "idempotency_key", "expires_at_ms", "reconciliation_procedure" ], "type": "object" }, "ReqDef_SourceCheckpoint": { "additionalProperties": false, "properties": { "content_hash": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Digest256" }, { "type": "null" } ], "description": "Provider-owned content identity for the returned page or snapshot.\nEG binds it into checkpoint CAS and replay; it never invents a value." }, "pending_watermark": { "type": [ "string", "null" ] }, "position": { "$ref": "#/components/schemas/ReqDef_SourceJson" }, "stream": { "type": "string" }, "watermark": { "type": [ "string", "null" ] } }, "required": [ "stream", "position" ], "type": "object" }, "ReqDef_SourceEntityRef": { "additionalProperties": false, "properties": { "record_id": { "type": "string" }, "stream": { "type": "string" } }, "required": [ "stream", "record_id" ], "type": "object" }, "ReqDef_SourceIngestionBatch": { "additionalProperties": false, "properties": { "authoritative_live_ids": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_BoundedVec_SourceEntityRef_16384" }, { "type": "null" } ], "description": "Required only for `reconcile`. EG compares it with its prior durable\nlive-set marker and derives tombstones; callers never submit that diff." }, "connector": { "type": "string" }, "empty_authoritative_approval": { "description": "Required with an empty authoritative live set. The verified request must\nalso carry the dedicated empty-reconciliation capability.", "type": [ "string", "null" ] }, "expected_previous_checkpoint": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SourceCheckpoint" }, { "type": "null" } ], "description": "`None` is valid only when no cursor has ever committed for this source.\nOtherwise the authoritative transaction compares this exact digest with\nthe stored cursor and rejects stale/concurrent pages." }, "mode": { "$ref": "#/components/schemas/ReqDef_SourceIngestionMode" }, "provider_checkpoint": { "$ref": "#/components/schemas/ReqDef_SourceCheckpoint" }, "records": { "$ref": "#/components/schemas/ReqDef_BoundedVec_SourceRecord_1024" }, "relationships": { "$ref": "#/components/schemas/ReqDef_BoundedVec_SourceRelationship_4096", "default": [] }, "strict_schema": { "description": "Reject source payload/property keys not selected by their manifest map.", "type": "boolean" }, "withdrawals": { "$ref": "#/components/schemas/ReqDef_BoundedVec_SourceWithdrawal_1024", "default": [], "description": "Provider-declared tombstones are accepted only for `delta`." } }, "required": [ "connector", "mode", "strict_schema", "records", "provider_checkpoint" ], "type": "object" }, "ReqDef_SourceIngestionMode": { "enum": [ "full", "delta", "reconcile" ], "type": "string" }, "ReqDef_SourceIngestionRequest": { "$ref": "#/components/schemas/ReqDef_SourceIngestionBatch", "description": "A request whose structural invariants and byte bound were checked during\nconstruction/deserialization. Tenant, auth, mapping existence and the\npersisted cursor are deliberately server-side authority checks." }, "ReqDef_SourceJson": {}, "ReqDef_SourceRecord": { "additionalProperties": false, "properties": { "mapping_reference": { "description": "Exact Connector Manifest schema-mapping reference for this entity.", "type": "string" }, "payload": { "$ref": "#/components/schemas/ReqDef_SourceJson" }, "provenance": { "$ref": "#/components/schemas/ReqDef_SourceRecordProvenance" }, "record_id": { "type": "string" }, "stream": { "type": "string" }, "updated_at": { "type": [ "string", "null" ] } }, "required": [ "stream", "record_id", "mapping_reference", "payload", "provenance" ], "type": "object" }, "ReqDef_SourceRecordProvenance": { "additionalProperties": false, "properties": { "adapter_kind": { "type": "string" }, "connector": { "type": "string" }, "server": { "type": "string" }, "source_uri": { "type": "string" }, "tool": { "type": "string" }, "tool_schema_sha256": { "$ref": "#/components/schemas/ReqDef_Digest256" } }, "required": [ "connector", "adapter_kind", "server", "tool", "tool_schema_sha256", "source_uri" ], "type": "object" }, "ReqDef_SourceRelationship": { "additionalProperties": false, "description": "A provider-observed edge. EG derives its durable relationship identity from\nverified tenant/source authority, the exact relation reference and endpoints;\nthe caller cannot supply a competing identity or digest.", "properties": { "properties": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SourceJson" }, { "type": "null" } ] }, "provenance": { "$ref": "#/components/schemas/ReqDef_SourceRecordProvenance" }, "relation_reference": { "description": "Exact Connector Manifest resource-relation reference, for example\n`manifest:demo#resources/Document/relations/contains`.", "type": "string" }, "source": { "$ref": "#/components/schemas/ReqDef_SourceEntityRef" }, "target": { "$ref": "#/components/schemas/ReqDef_SourceEntityRef" } }, "required": [ "source", "target", "relation_reference", "provenance" ], "type": "object" }, "ReqDef_SourceWithdrawal": { "additionalProperties": false, "properties": { "entity": { "$ref": "#/components/schemas/ReqDef_SourceEntityRef" }, "reason": { "type": "string" } }, "required": [ "entity", "reason" ], "type": "object" }, "ReqDef_SpatialOpKind": { "description": "SPATIAL \u2014 the constructive geometry op applied by `Op::SpatialOp` (CONCEPT:EG-KG.ontology.concept-9).\nPure serde here (Pi-safe, no eg-geo dep); the executor maps it to eg-geo's `algebra`\nbehind eg-plan's `geo` gate. Unary ops (`Buffer`/`ConvexHull`/`Simplify`/`Centroid`)\nderive from the row geometry alone; binary ops (`Union`/`Intersection`/`Difference`)\ntake the second operand as a WKT literal.", "oneOf": [ { "additionalProperties": false, "description": "Grow the geometry outward by `distance` (a convex buffer polygon).", "properties": { "Buffer": { "properties": { "distance": { "format": "double", "type": "number" } }, "required": [ "distance" ], "type": "object" } }, "required": [ "Buffer" ], "type": "object" }, { "const": "ConvexHull", "description": "The convex hull of the geometry's vertices.", "type": "string" }, { "additionalProperties": false, "description": "Douglas\u2013Peucker vertex reduction at `tolerance`.", "properties": { "Simplify": { "properties": { "tolerance": { "format": "double", "type": "number" } }, "required": [ "tolerance" ], "type": "object" } }, "required": [ "Simplify" ], "type": "object" }, { "const": "Centroid", "description": "The centroid (a `Point`).", "type": "string" }, { "additionalProperties": false, "description": "The (convex) union of the row geometry with `wkt`.", "properties": { "Union": { "properties": { "wkt": { "type": "string" } }, "required": [ "wkt" ], "type": "object" } }, "required": [ "Union" ], "type": "object" }, { "additionalProperties": false, "description": "The intersection of the row geometry with `wkt` (Sutherland\u2013Hodgman; convex clip).", "properties": { "Intersection": { "properties": { "wkt": { "type": "string" } }, "required": [ "wkt" ], "type": "object" } }, "required": [ "Intersection" ], "type": "object" }, { "additionalProperties": false, "description": "The difference of the row geometry minus `wkt` (documented subset).", "properties": { "Difference": { "properties": { "wkt": { "type": "string" } }, "required": [ "wkt" ], "type": "object" } }, "required": [ "Difference" ], "type": "object" } ] }, "ReqDef_SplitSpec": { "description": "Train/test split knobs (seeded, deterministic \u2014 reuses `datascience::primitives::\ntrain_test_split`).", "properties": { "seed": { "default": 42, "format": "uint64", "minimum": 0, "type": "integer" }, "shuffle": { "default": true, "type": "boolean" }, "test_ratio": { "default": 0.25, "format": "double", "type": "number" } }, "type": "object" }, "ReqDef_SqlColumnRef": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "column_id": { "type": "string" }, "schema_id": { "type": "string" }, "table_id": { "type": "string" } }, "required": [ "catalog_id", "schema_id", "table_id", "column_id" ], "type": "object" }, "ReqDef_SqlSourceBatch": { "additionalProperties": false, "description": "Builder data for a checked submission. No request id, nonce, actor, tenant,\nclock, or client-guessed epoch participates in its semantic content digest.", "properties": { "columns": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_256" }, "expected_previous": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_CursorPosition" }, { "type": "null" } ] }, "expected_schema_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "expected_schema_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "mapping_descriptor": { "$ref": "#/components/schemas/ReqDef_SqlSourceMappingDescriptor" }, "partition": { "$ref": "#/components/schemas/ReqDef_SqlSourceText", "description": "Empty names the provider's unpartitioned stream. Tokens are preserved." }, "position": { "$ref": "#/components/schemas/ReqDef_CursorPosition" }, "rows": { "$ref": "#/components/schemas/ReqDef_BoundedVec_BoundedVec_SqlSourceCell_256_1024" }, "source": { "type": "string" }, "source_descriptor": { "$ref": "#/components/schemas/ReqDef_SqlSourceDescriptor" }, "table": { "type": "string" } }, "required": [ "source", "partition", "position", "source_descriptor", "mapping_descriptor", "table", "columns", "rows", "expected_schema_version", "expected_schema_digest" ], "type": "object" }, "ReqDef_SqlSourceBatchRequest": { "$ref": "#/components/schemas/ReqDef_SqlSourceBatch", "description": "Checked on deserialization before any SQL transaction can open. The\nserver must additionally preflight the outer frame using shared MsgpackLimits\nand verify tenant/actor, mapping authority, schema and persisted cursor in its\nauthoritative transaction. This type cannot verify those external facts." }, "ReqDef_SqlSourceCell": { "description": "A closed cell vocabulary; bytes and canonical JSON ride as MessagePack bin,\nintegers/timestamps stay i64, and embeddings stay finite f32 values.", "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "null", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "int", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "finite_float", "type": "string" }, "value": { "$ref": "#/components/schemas/ReqDef_SqlSourceFloat" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "text", "type": "string" }, "value": { "$ref": "#/components/schemas/ReqDef_SqlSourceText" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "bool", "type": "string" }, "value": { "type": "boolean" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "description": "Microseconds since Unix epoch, matching the native SQL cell convention.", "properties": { "kind": { "const": "timestamp", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "bytes", "type": "string" }, "value": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "json", "type": "string" }, "value": { "$ref": "#/components/schemas/ReqDef_SqlSourceJson" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "finite_vector", "type": "string" }, "value": { "$ref": "#/components/schemas/ReqDef_SqlSourceVector" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ReqDef_SqlSourceDescriptor": { "additionalProperties": false, "description": "Bounded source identity content. Metadata must be a JSON object and must not\ncontain credentials. A future adapter validates provider-specific authority;\nmerely presenting this descriptor does not grant source or table access.", "properties": { "dataset": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/ReqDef_SqlSourceJson" }, "provider": { "type": "string" } }, "required": [ "provider", "dataset", "metadata" ], "type": "object" }, "ReqDef_SqlSourceFloat": { "description": "A finite IEEE-754 double. Invalid values cannot enter through deserialization.", "format": "double", "type": "number" }, "ReqDef_SqlSourceJson": { "description": "Bounded JSON content, stored as canonical JSON bytes so object ordering does\nnot change semantic digests. This is JSON data, never JSON-encoded row cells.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "ReqDef_SqlSourceMappingDescriptor": { "additionalProperties": false, "description": "Actual bounded mapping content, not a caller's unverified digest assertion.\nFormat interpretation/normalization belongs to the future trusted adapter.", "properties": { "content": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "format": { "type": "string" } }, "required": [ "format", "content" ], "type": "object" }, "ReqDef_SqlSourceText": { "description": "Text is capped in UTF-8 bytes, without restricting source-system characters.", "type": "string" }, "ReqDef_SqlSourceVector": { "$ref": "#/components/schemas/ReqDef_BoundedVec_float_4096", "description": "A bounded, finite native f32 embedding. An empty embedding is invalid." }, "ReqDef_StatechartOp": { "description": "The statechart engine control-plane operation (CONCEPT:INT-P2-2).", "oneOf": [ { "additionalProperties": false, "description": "Register a statechart DEFINITION. `def_msgpack` is a MessagePack-encoded\n`eg_statechart::StatechartDef` (opaque here \u2014 decoded + validated at the\nverified boundary). Content-addressed and idempotent server-side: the response\ncarries the deterministic `def_id`.", "properties": { "Define": { "properties": { "def_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "def_msgpack" ], "type": "object" } }, "required": [ "Define" ], "type": "object" }, { "additionalProperties": false, "description": "Create a running INSTANCE of a stored definition in its initial state.\n`context` is the initial extended state (a JSON object, or null for empty).", "properties": { "Instantiate": { "properties": { "context": { "default": null }, "def_id": { "type": "string" } }, "required": [ "def_id" ], "type": "object" } }, "required": [ "Instantiate" ], "type": "object" }, { "additionalProperties": false, "description": "Deliver an EVENT to a durable instance. `payload` is optional structured data\nguards/actions may read. `expected_version`, when present, is an OCC token \u2014\nthe send is rejected if the stored instance version has moved on.", "properties": { "SendEvent": { "properties": { "event": { "type": "string" }, "expected_version": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "instance_id": { "type": "string" }, "payload": { "default": null } }, "required": [ "instance_id", "event" ], "type": "object" } }, "required": [ "SendEvent" ], "type": "object" }, { "additionalProperties": false, "description": "Fetch (rehydrate) an instance's current durable `(state, context)` + version.", "properties": { "GetState": { "properties": { "instance_id": { "type": "string" } }, "required": [ "instance_id" ], "type": "object" } }, "required": [ "GetState" ], "type": "object" }, { "additionalProperties": false, "description": "List instances owned by the caller, optionally filtered to one definition.", "properties": { "List": { "properties": { "def_id": { "default": null, "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "List" ], "type": "object" } ] }, "ReqDef_StatisticalPolicy": { "additionalProperties": false, "description": "The statistical half of a policy: the risk, coverage and support levels\nbelow which the engine abstains instead of acting.", "properties": { "alpha": { "$ref": "#/components/schemas/ReqDef_UnitRationalWire", "description": "Miscoverage level of the prediction set." }, "audit_sample": { "$ref": "#/components/schemas/ReqDef_UnitRationalWire", "description": "Share of decisions sampled into the audit stream." }, "delta": { "$ref": "#/components/schemas/ReqDef_UnitRationalWire", "description": "Failure probability of that guarantee." }, "epsilon": { "$ref": "#/components/schemas/ReqDef_UnitRationalWire", "description": "Risk level the controlled procedure must hold." }, "min_ess": { "$ref": "#/components/schemas/ReqDef_QuantisedValue", "description": "Smallest effective sample size an off-policy estimate may report." }, "min_outcome_fidelity": { "$ref": "#/components/schemas/ReqDef_TraceFidelityLevel" }, "min_support": { "description": "Fewest supporting records per option.", "format": "uint64", "minimum": 0, "type": "integer" }, "n_min": { "description": "Fewest records before any calibrated claim is made.", "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_public_features": { "description": "Whether tenant-public features may be read for this question.", "type": "boolean" } }, "required": [ "alpha", "epsilon", "delta", "n_min", "min_support", "min_ess", "min_outcome_fidelity", "tenant_public_features", "audit_sample" ], "type": "object" }, "ReqDef_StatisticalQuestion": { "additionalProperties": false, "description": "One named, classified question.", "properties": { "kind": { "$ref": "#/components/schemas/ReqDef_QuestionKind" }, "question_id": { "type": "string" }, "safety": { "$ref": "#/components/schemas/ReqDef_QuestionSafety" } }, "required": [ "question_id", "kind", "safety" ], "type": "object" }, "ReqDef_StructuralEquationWire": { "description": "Wire mirror of `eg_epistemic::StructuralEquation` (EPI-P3-3), keyed by the\nvariable `id` it defines \u2014 one entry of `Method::CausalEstimate::variables`.\n`parents` MUST name only ids that appear EARLIER in that same list (parents\nbefore children), mirroring `eg_epistemic::CausalGraph::add_variable`'s own\ntopological-order invariant; the handler surfaces a violation as an explicit\nerror, never a panic.", "properties": { "bias": { "format": "double", "type": "number" }, "id": { "type": "string" }, "noise_var": { "description": "Variance of this variable's own exogenous noise term (`0.0` = deterministic\ngiven its parents).", "format": "double", "type": "number" }, "parents": { "description": "`(parent id, weight)` pairs.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" } }, "required": [ "id", "parents", "bias", "noise_var" ], "type": "object" }, "ReqDef_SubgraphAlgorithm": { "description": "Which algorithm `MineSubgraph` runs (CONCEPT:EG-KG.mining.gspan-frequent-subgraph\n\u2014 Phase 4). `gspan` is the default (labeled frequent-subgraph patterns);\n`motif` is a label-agnostic topological census.", "enum": [ "gspan", "motif" ], "type": "string" }, "ReqDef_SubmitJobSpec": { "description": "Wire spec for [`JobOp::Submit`] (CONCEPT:INT-P2-1). `graph` is BOTH the tenancy\nanchor (where the eventual result claim lands) and the input-snapshot handle's\ngraph name \u2014 the facade stamps in the graph's live `GraphCore::version()` at\nsubmit time, so the snapshot handle is never client-supplied (a client cannot\nforge which graph-version a job actually ran against).\n\nWorker kernels reuse the same durable lease/publication state machine. The jobs\nfeature provides association-rule mining; the program-optimization feature adds\nthe graph-native, governed LM-program compiler.", "properties": { "actor": { "default": "", "type": "string" }, "backoff_ms": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" }, "deadline_unix_ms": { "default": null, "format": "int64", "type": [ "integer", "null" ] }, "graph": { "description": "Target graph: where the result claim lands, and whose `version()` at submit\ntime becomes the job's immutable input-snapshot handle.", "type": "string" }, "io_bytes": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "kind": { "$ref": "#/components/schemas/ReqDef_JobKind", "description": "The job kind + its parameters. `params_digest` lineage is derived from\n`kind`'s own fields by the facade \u2014 a client never supplies it directly." }, "max_attempts": { "default": 1, "description": "Retry cap (including the first attempt); `0`/`1` \u21d2 no retry. Default `1`.", "format": "uint32", "minimum": 0, "type": "integer" }, "memory_bytes": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_bytes": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "priority": { "default": 0, "format": "int32", "type": "integer" }, "purpose": { "default": "", "type": "string" }, "quota_cpu_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "required_capabilities": { "default": [], "items": { "type": "string" }, "type": "array" }, "tenant": { "default": "", "type": "string" }, "worker_pool": { "default": "", "type": "string" }, "worker_region": { "default": "", "type": "string" } }, "required": [ "graph", "kind" ], "type": "object" }, "ReqDef_SubmitWorkItemRequest": { "additionalProperties": false, "description": "Native WorkItem admission request. `context.tenant_id` and\n`context.graph` are checked against the verified request envelope; they are\nnot caller-controlled routing hints.", "properties": { "catalog_digest": { "type": "string" }, "command_digest": { "type": "string" }, "context": { "$ref": "#/components/schemas/ReqDef_RequestContext" }, "deadline_unix": { "format": "double", "type": [ "number", "null" ] }, "depends_on": { "items": { "type": "string" }, "type": "array" }, "idempotency_key": { "type": "string" }, "input_ref": { "type": "string" }, "kind": { "type": "string" }, "max_attempts": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_tenant_in_flight": { "description": "Tenant admission cap. The engine applies a bounded default when zero;\nit never permits a caller to raise the hard engine maximum.", "format": "uint64", "minimum": 0, "type": "integer" }, "metadata": { "additionalProperties": true, "type": "object" }, "model_digest": { "type": "string" }, "policy_digest": { "type": "string" }, "priority": { "format": "int64", "type": "integer" }, "provenance_refs": { "items": { "type": "string" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_NativeControlSchemaVersion" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "context", "idempotency_key", "command_digest", "kind", "priority", "depends_on", "input_ref", "policy_digest", "catalog_digest", "model_digest", "max_attempts", "metadata", "provenance_refs", "max_tenant_in_flight" ], "type": "object" }, "ReqDef_SubmitWorkItemsRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ReqDef_RequestContext" }, "idempotency_key": { "type": "string" }, "requests": { "items": { "$ref": "#/components/schemas/ReqDef_SubmitWorkItemRequest" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_NativeControlSchemaVersion" } }, "required": [ "schema_version", "context", "idempotency_key", "requests" ], "type": "object" }, "ReqDef_SvmKernel": { "description": "One-Class SVM kernel (CONCEPT:EG-KG.mining.oneclass-svm).", "enum": [ "rbf", "linear" ], "type": "string" }, "ReqDef_TemplateFacts": { "additionalProperties": false, "description": "One operator-published graph template an assembly may fill, pinned to the\nexact revision it was read at. Its `Agent` nodes are the slots.", "properties": { "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph_id": { "type": "string" }, "shape": { "$ref": "#/components/schemas/ReqDef_AgentGraphShape" } }, "required": [ "graph_id", "entry_revision", "definition_digest", "shape" ], "type": "object" }, "ReqDef_TemplateInstanceRef": { "additionalProperties": false, "description": "Where an instantiated agent came from.", "properties": { "bindings": { "additionalProperties": { "$ref": "#/components/schemas/ReqDef_ComponentDependency" }, "description": "Parameter name -> the component it was bound to. Ordered, so an\ninstance's digest does not depend on map iteration order.", "type": "object" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "template_id": { "type": "string" } }, "required": [ "template_id", "entry_revision", "definition_digest", "bindings" ], "type": "object" }, "ReqDef_TemplateParam": { "additionalProperties": false, "description": "One declared axis of variation.", "properties": { "kind": { "$ref": "#/components/schemas/ReqDef_AgentComponentKind", "description": "The kind the replacement must be. Checked against both the base\ncomponent and the binding, so a parameter cannot be used to smuggle a\ntool in where a model profile belongs." }, "name": { "description": "What a caller names when binding.", "type": "string" }, "replaces": { "description": "The component in the base definition this parameter replaces.\n\nIdentified by `component_id`, not by slot index. An index would be\nbrittle in exactly the way that matters: reordering a tool list -- which\n`definition_digest` deliberately treats as a no-op, since order carries\nno meaning -- would silently repoint every parameter.", "type": "string" }, "required": { "description": "When false, leaving this parameter unbound keeps the base component.", "type": "boolean" }, "summary": { "description": "Human-facing description of the axis, bounded.", "type": "string" } }, "required": [ "name", "replaces", "kind", "required", "summary" ], "type": "object" }, "ReqDef_TensorElementwiseOp": { "description": "TENSOR \u2014 the scalar op `TensorOpKind::Elementwise` applies to every element\n(CONCEPT:EG-KG.storage.content-addressed-dedup). Mirrors eg-tensor's `ElementwiseOp`; pure serde here.", "enum": [ "Add", "Sub", "Mul", "Div" ], "type": "string" }, "ReqDef_TensorOpKind": { "description": "TENSOR \u2014 the transform carried by `Op::TensorOp` (CONCEPT:EG-KG.storage.content-addressed-dedup): one of the\neg-tensor array ops, applied per-row to each row's tensor. `Slice` gathers a\nhyper-rectangle (`ranges[d] = (start, end)`, one per axis); `Reduce` collapses one\n`axis` with `kind`; `Elementwise` applies `op` with `scalar` to every element. PURE\nserde (only `usize`/`f64`/the two plain enums) \u2014 the actual N-D array math lives in\neg-tensor behind eg-plan's `tensor` gate; this is the wire variant.", "oneOf": [ { "additionalProperties": false, "properties": { "Slice": { "properties": { "ranges": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint", "minimum": 0, "type": "integer" }, { "format": "uint", "minimum": 0, "type": "integer" } ], "type": "array" }, "type": "array" } }, "required": [ "ranges" ], "type": "object" } }, "required": [ "Slice" ], "type": "object" }, { "additionalProperties": false, "properties": { "Reduce": { "properties": { "axis": { "format": "uint", "minimum": 0, "type": "integer" }, "kind": { "$ref": "#/components/schemas/ReqDef_TensorReduceKind" } }, "required": [ "axis", "kind" ], "type": "object" } }, "required": [ "Reduce" ], "type": "object" }, { "additionalProperties": false, "properties": { "Elementwise": { "properties": { "op": { "$ref": "#/components/schemas/ReqDef_TensorElementwiseOp" }, "scalar": { "format": "double", "type": "number" } }, "required": [ "op", "scalar" ], "type": "object" } }, "required": [ "Elementwise" ], "type": "object" } ] }, "ReqDef_TensorReduceKind": { "description": "TENSOR \u2014 how `TensorOpKind::Reduce` collapses one axis (CONCEPT:EG-KG.storage.content-addressed-dedup). Mirrors\neg-tensor's `ReduceKind`, but defined HERE (pure serde, no eg-tensor dep) so the\nwire stays Pi-safe; the executor maps it to eg-tensor's enum behind eg-plan's\n`tensor` gate.", "enum": [ "Sum", "Mean", "Max", "Min" ], "type": "string" }, "ReqDef_Term": { "additionalProperties": false, "description": "One `coefficient \u00b7 variable` term of a linear row.", "properties": { "coefficient": { "format": "int64", "type": "integer" }, "var": { "$ref": "#/components/schemas/ReqDef_VarId" } }, "required": [ "var", "coefficient" ], "type": "object" }, "ReqDef_TerminalOutcomeExtension": { "additionalProperties": false, "description": "Explicit optional extension for the current terminal WorkItem contract.\n\nThe protocol owner may add this as one `#[serde(default)]` field on the\nexisting terminal method. Keeping the extension grouped and optional\nmakes the generated contract change visible without changing the native\nterminal method's identity fields or inventing a second commit operation.", "properties": { "outcome_bundle": { "$ref": "#/components/schemas/ReqDef_CommitOutcomeBundle" }, "receipt_nodes": { "default": [], "items": { "$ref": "#/components/schemas/ReqDef_ReceiptNode" }, "type": "array" }, "run_event": { "$ref": "#/components/schemas/ReqDef_RunEvent", "description": "The one durable RunEvent carried by the native mutation outbox." } }, "required": [ "outcome_bundle", "run_event" ], "type": "object" }, "ReqDef_TextAlgorithm": { "description": "Which text-mining engine `MineText` runs (CONCEPT:EG-KG.mining.tfidf \u2014 Phase\n4). TF-IDF is the default (descriptive per-document term weights); `lda`/\n`nmf` fit a `k`-topic model.", "enum": [ "tfidf", "lda", "nmf" ], "type": "string" }, "ReqDef_TextSource": { "description": "A graph-derived text source for `MineText` (CONCEPT:EG-KG.mining.tfidf \u2014\nPhase 4). Each node carrying `node_label` contributes one document: its\n`field` string property, tokenized (lowercase, alnum-run split).", "properties": { "field": { "description": "The string property to tokenize into the document.", "type": "string" }, "limit": { "description": "Cap the number of nodes scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances each contribute one document.", "type": "string" } }, "required": [ "node_label", "field" ], "type": "object" }, "ReqDef_TimeAxis": { "description": "Which timeline an [`Op::AsOf`] instant pins (bi-temporal, KG-2.250).", "oneOf": [ { "const": "Valid", "description": "Valid (event) time \u2014 \"what was TRUE at the instant\" (`valid_from`/`valid_until`).", "type": "string" }, { "const": "Transaction", "description": "Transaction time \u2014 \"what we BELIEVED at the instant\" (`tx_from`/`tx_to`).", "type": "string" } ] }, "ReqDef_TimeSeriesWindowRef": { "additionalProperties": false, "properties": { "series_id": { "type": "string" }, "source_revision": { "type": "string" }, "window_end": { "type": "string" }, "window_start": { "type": "string" } }, "required": [ "series_id", "window_start", "window_end", "source_revision" ], "type": "object" }, "ReqDef_ToolEffect": { "description": "Whether invoking a tool can change anything.\n\nNot a hint. A read-only agent graph is one whose reachable tools are all\n[`ToolEffect::Read`], and that is a property worth being able to prove\nbefore a run rather than discover during one.", "enum": [ "read", "write" ], "type": "string" }, "ReqDef_ToolsetTransport": { "description": "Where a toolset's tools come from.", "oneOf": [ { "const": "mcp", "description": "An MCP server.", "type": "string" }, { "const": "function", "description": "In-process functions.", "type": "string" }, { "const": "skill", "description": "A skill pack.", "type": "string" } ] }, "ReqDef_TraceFidelity": { "description": "How complete the recorded trace is.", "oneOf": [ { "additionalProperties": false, "description": "Every step is present.", "properties": { "fidelity": { "const": "full_step", "type": "string" } }, "required": [ "fidelity" ], "type": "object" }, { "additionalProperties": false, "description": "Steps were dropped to stay inside the record bound; each is named.", "properties": { "dropped": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_16" }, "fidelity": { "const": "truncated", "type": "string" } }, "required": [ "fidelity", "dropped" ], "type": "object" } ] }, "ReqDef_TraceFidelityLevel": { "description": "How much of a run's trace has to survive for its outcome to count as a\nlabel. Mirrors the record's own [`super::TraceFidelity`] at policy\ngranularity.", "enum": [ "full_step", "tool_calls", "final_output" ], "type": "string" }, "ReqDef_TransactionSource": { "description": "A graph-derived transaction source for `MineAssociate` (CONCEPT:EG-KG.mining.graph-derived-transactions).\n\nEach node carrying `node_label` becomes one \"basket owner\"; the basket is the set\nof `item_field` values gathered from its neighbors (following edges in\n`direction`), optionally filtered to a `relation`. This turns node neighborhoods\ninto transactions so mining runs directly over resident graph data \u2014 the\ncross-modal hook (e.g. \"for each :Capability, the set of concepts it touches\" =\none transaction \u21d2 concept-co-occurrence rules).", "properties": { "direction": { "default": "out", "description": "Edge direction to gather neighbors: `out` (successors, default), `in`\n(predecessors), or `any` (both).", "type": "string" }, "item_field": { "description": "Which value of each neighbor becomes an item: `label` (the neighbor's\ntype/label, default) or `prop:` (a neighbor property value). When\n`None`, the neighbor's node id is used verbatim.", "type": [ "string", "null" ] }, "limit": { "description": "Cap the number of basket owners scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances each become one transaction/basket owner.", "type": "string" }, "relation": { "description": "Optional edge-relation filter: only follow edges whose `relationship`\nproperty equals this. `None` \u21d2 all edges.", "type": [ "string", "null" ] } }, "required": [ "node_label" ], "type": "object" }, "ReqDef_TransitionControlLeaseRequest": { "additionalProperties": false, "description": "`TransitionControlLease`: consume or end a lease, CAS on its read revision.", "properties": { "expected_revision": { "description": "The `revision` of the view the caller decided on.", "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "description": "Caller-stable retry identity for this transition.", "type": "string" }, "lease_id": { "type": "string" }, "tenant": { "description": "Must equal the verified request tenant.", "type": "string" }, "to": { "$ref": "#/components/schemas/ReqDef_ControlLeaseTarget" } }, "required": [ "tenant", "lease_id", "expected_revision", "to", "idempotency_key" ], "type": "object" }, "ReqDef_TreeNode": { "description": "A flat regression tree: node `i` is a leaf when `feature < 0`.", "properties": { "feature": { "format": "int64", "type": "integer" }, "left": { "format": "int64", "type": "integer" }, "right": { "format": "int64", "type": "integer" }, "threshold": { "format": "double", "type": "number" }, "value": { "format": "double", "type": "number" } }, "required": [ "feature", "threshold", "left", "right", "value" ], "type": "object" }, "ReqDef_TypedParam": { "additionalProperties": false, "description": "One named parameter of a question.", "properties": { "name": { "type": "string" }, "value": { "$ref": "#/components/schemas/ReqDef_TypedValue" } }, "required": [ "name", "value" ], "type": "object" }, "ReqDef_TypedValue": { "description": "A typed question parameter. Values are typed, never substituted into text:\na parameter cannot become part of a prompt or a query string.", "oneOf": [ { "properties": { "type": { "const": "bool", "type": "string" }, "value": { "type": "boolean" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "int", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "text", "type": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "iri", "type": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "iri_list", "type": "string" }, "value": { "$ref": "#/components/schemas/ReqDef_BoundedVec_string_64" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "rational", "type": "string" }, "value": { "$ref": "#/components/schemas/ReqDef_UnitRationalWire" } }, "required": [ "type", "value" ], "type": "object" } ] }, "ReqDef_UnitRationalWire": { "additionalProperties": false, "description": "An exact rational in `[0, 1]`: `numerator / denominator`.\n\nValidated on the way in rather than at each use site, because it appears in\nsix different records and a per-site check is a check that one of them\neventually forgets.", "properties": { "denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "numerator": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "numerator", "denominator" ], "type": "object" }, "ReqDef_UnknownCostRule": { "description": "What an unknown cost means when a budget is in force.", "oneOf": [ { "const": "exclude_when_strict", "description": "A strict budget excludes every candidate whose cost is unknown.", "type": "string" }, { "const": "rank_below_known", "description": "An unknown cost ranks below every known one, and is never read as zero.", "type": "string" } ] }, "ReqDef_VarId": { "description": "Index of a binary decision variable (its position in [`ModelSpec::variables`]).", "format": "uint32", "minimum": 0, "type": "integer" }, "ReqDef_VectorSource": { "description": "A graph-derived VECTOR source for `MineCluster` / `MineAnomaly`\n(CONCEPT:EG-KG.mining.node-embedding-source). Each node carrying `node_label`\ncontributes ONE feature row = its stored embedding vector, and its node id is\ncarried alongside so write-back can link the mined `:Cluster` / `:Anomaly` node\nback to it. This is the cross-modal hook \u2014 \"cluster / anomaly-detect the\nembeddings of these nodes\" runs compute-near-data over resident vectors.", "properties": { "limit": { "description": "Cap the number of nodes scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances each contribute one embedding row.", "type": "string" } }, "required": [ "node_label" ], "type": "object" }, "ReqDef_VersionExpectation": { "description": "Explicit OCC semantics captured before validation.", "oneOf": [ { "additionalProperties": false, "properties": { "graph": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "native": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "native" ], "type": "object" }, { "const": "unversioned", "description": "Valid only for a capability-bearing reserved-system operation.", "type": "string" } ] }, "ReqDef_Violation": { "description": "Why a candidate was removed before the solver ran.", "oneOf": [ { "additionalProperties": false, "description": "The request denied this component id.", "properties": { "violation": { "const": "denied", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "The component is withdrawn by its connector pack.", "properties": { "violation": { "const": "withdrawn", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "The component revision is retired.", "properties": { "violation": { "const": "retired", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "An external agent without the observation its policy requires.", "properties": { "violation": { "const": "ineligible_external_agent", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "available": { "format": "uint64", "minimum": 0, "type": "integer" }, "required": { "format": "uint64", "minimum": 0, "type": "integer" }, "violation": { "const": "context_window_too_small", "type": "string" } }, "required": [ "violation", "required", "available" ], "type": "object" }, { "additionalProperties": false, "properties": { "violation": { "const": "missing_tool_support", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "violation": { "const": "missing_structured_output", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "iri": { "type": "string" }, "violation": { "const": "missing_modality", "type": "string" } }, "required": [ "violation", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "Its cost is unknown and the budget is strict.", "properties": { "violation": { "const": "unknown_cost_under_strict_budget", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "level": { "$ref": "#/components/schemas/ReqDef_ObjectiveLevelKind" }, "violation": { "const": "over_budget", "type": "string" } }, "required": [ "violation", "level" ], "type": "object" }, { "additionalProperties": false, "description": "A template rule refused this component in this slot.", "properties": { "code": { "type": "string" }, "violation": { "const": "template_validation", "type": "string" } }, "required": [ "violation", "code" ], "type": "object" }, { "additionalProperties": false, "description": "A latency ceiling is in force and the component declares no p95. An\nundeclared latency is never read as zero.", "properties": { "violation": { "const": "unknown_latency_under_budget", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "Forcing this component into the assembly leaves no feasible answer.", "properties": { "violation": { "const": "infeasible_when_forced", "type": "string" } }, "required": [ "violation" ], "type": "object" } ] }, "ReqDef_VizColumnValues": { "description": "One column's values for [`VizDatasetSource::InlineColumns`] \u2014 mirrors\n`eg_viz_columnstore::ColumnData`'s two most common variants. This crate stays\ndependency-free; the handler converts to the real type at the verified\nboundary.", "oneOf": [ { "additionalProperties": false, "properties": { "F64": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "F64" ], "type": "object" }, { "additionalProperties": false, "properties": { "Utf8": { "items": { "type": "string" }, "type": "array" } }, "required": [ "Utf8" ], "type": "object" } ] }, "ReqDef_VizDatasetSource": { "description": "Where `VizOp::Render` gets its rows from.", "oneOf": [ { "additionalProperties": false, "description": "Caller-supplied columns, ingested verbatim into a fresh per-request\n`ColumnStore` under `VizRenderRequest::dataset_ref`.", "properties": { "InlineColumns": { "properties": { "columns": { "additionalProperties": { "$ref": "#/components/schemas/ReqDef_VizColumnValues" }, "type": "object" } }, "required": [ "columns" ], "type": "object" } }, "required": [ "InlineColumns" ], "type": "object" }, { "additionalProperties": false, "description": "A deterministic, seeded, ENGINE-SIDE-generated clustered scatter dataset \u2014\nnever shipped over the wire \u2014 proving high-density rendering without a\nhuge request payload. Produces `x`/`y` F64 columns with `clusters`\ndistinct Gaussian-ish blobs.", "properties": { "SyntheticScatterClusters": { "properties": { "clusters": { "format": "uint32", "minimum": 0, "type": "integer" }, "row_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "row_count", "clusters", "seed" ], "type": "object" } }, "required": [ "SyntheticScatterClusters" ], "type": "object" }, { "additionalProperties": false, "description": "A deterministic, seeded, ENGINE-SIDE-generated random graph (node ids\n`0..node_count`, `edge_count` edges, no self-loops, dedup not required) \u2014\nthe `MarkKind::Graph` V6-lite demo path. See `src/server/handlers/viz.rs`'s\nmodule doc for the exact dataset/column shape this ingests as.", "properties": { "SyntheticGraph": { "properties": { "edge_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "node_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_count", "edge_count", "seed" ], "type": "object" } }, "required": [ "SyntheticGraph" ], "type": "object" } ] }, "ReqDef_VizFormat": { "description": "Static export raster/vector format \u2014 mirrors `eg_viz_core::StaticExportFormat`\nfield-for-field, INCLUDING its `rename_all = \"snake_case\"` wire casing (so a\ncaller sends `\"png\"`/`\"svg\"`/`\"pdf\"`, not `\"Png\"`/`\"Svg\"`/`\"Pdf\"`). This crate\nstays dependency-free (no `eg-viz-core` dep), so the variant is not reused\ndirectly; the handler converts one-to-one.", "enum": [ "png", "svg", "pdf" ], "type": "string" }, "ReqDef_VizOp": { "description": "The native-visualization render control-plane operation (D-VZ-1, full V4).", "oneOf": [ { "additionalProperties": false, "description": "Resolve a `ViewSpec` against a dataset and render it to static image bytes.", "properties": { "Render": { "$ref": "#/components/schemas/ReqDef_VizRenderRequest" } }, "required": [ "Render" ], "type": "object" }, { "const": "CapabilityMatrix", "description": "Fetch the mark x surface capability matrix\n(`eg_viz_core::CapabilityMatrix::default_matrix`) \u2014 what a planner/UI reads\nto know which (mark, surface) pairs are real today.", "type": "string" }, { "additionalProperties": false, "description": "Look up a previously-produced render's durable provenance (lane V4) by\nthe `result_ref` a `VizOp::Render` response returned. Answers `None`\n(not an error) for an unknown/never-produced `result_ref`.", "properties": { "RenderProvenance": { "properties": { "result_ref": { "type": "string" } }, "required": [ "result_ref" ], "type": "object" } }, "required": [ "RenderProvenance" ], "type": "object" } ] }, "ReqDef_VizRenderRequest": { "description": "One `VizOp::Render` request: an opaque `eg_viz_core::ViewSpec` (as JSON \u2014 the\nhandler parses + validates it), which dataset to resolve it against, the\ntarget canvas size, the output format, and the frame budget\n`eg_viz_core::select_tier` resolves against.", "properties": { "dataset": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_VizDatasetSource" }, { "type": "null" } ], "default": null, "description": "`None` \u21d2 resolve against a `dataset_ref` this engine already has\nresident from an earlier request (lane V4's persistent ColumnStore \u2014\nsee `src/server/handlers/viz.rs`'s module doc); an unknown\n`dataset_ref` with no data supplied is a clear, typed \"unavailable\"\nerror, never a fabricated empty render. `Some` ingests (or\nre-ingests \u2014 content-addressed, so byte-identical data is a cheap\nno-op for the render cache) the given data under `dataset_ref` first." }, "dataset_ref": { "type": "string" }, "format": { "$ref": "#/components/schemas/ReqDef_VizFormat" }, "height_px": { "format": "uint32", "minimum": 0, "type": "integer" }, "max_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_primitives": { "format": "uint64", "minimum": 0, "type": "integer" }, "spec_json": { "description": "A caller-provided `eg_viz_core::ViewSpec`, as JSON. Opaque here (this\ncrate has no `eg-viz-core` dependency); the handler\n`serde_json::from_value`s and `ViewSpec::validate()`s it at the verified\nboundary, exactly as documented as unsupported here for silent misparse." }, "width_px": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "spec_json", "width_px", "height_px", "format", "max_primitives", "max_bytes", "dataset_ref" ], "type": "object" }, "ReqDef_WeightedLevel": { "additionalProperties": false, "description": "One weighted objective level.", "properties": { "level": { "$ref": "#/components/schemas/ReqDef_ObjectiveLevelKind" }, "weight": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "level", "weight" ], "type": "object" }, "ReqDef_WhyNot": { "additionalProperties": false, "description": "Why one candidate did not win its slot.", "properties": { "component_id": { "type": "string" }, "forced_objective": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_ObjectiveValue" }, { "type": "null" } ], "default": null, "description": "The objective it would have forced, when it was feasible but worse." }, "slot": { "type": "string" }, "violation": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Violation" }, { "type": "null" } ], "default": null, "description": "The rule that removed it, when it was not feasible at all." } }, "required": [ "component_id", "slot" ], "type": "object" }, "ReqDef_WorkItemClaimCapabilityMintRequest": { "additionalProperties": false, "description": "Native mint input. The authenticated worker/session and current lease\nauthority are deliberately absent: only the engine can derive them.", "properties": { "schema_version": { "$ref": "#/components/schemas/ReqDef_WorkItemClaimCapabilityRequestSchemaVersion" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "work_item_id" ], "type": "object" }, "ReqDef_WorkItemClaimCapabilityRequestSchemaVersion": { "description": "Versioned native capability request. The engine derives every authority\nfield (tenant, owner, lease epoch/fence, attempt, and expiry) from the\nauthenticated request context and the live WorkItem row; callers provide\nonly the opaque WorkItem identifier.", "enum": [ "1" ], "type": "string" }, "ReqDef_WorkItemClaimCapabilityVerifyRequest": { "additionalProperties": false, "description": "Native verify input. The capability is an opaque bounded byte string; no\npublic DTO can reconstruct authority from owner/epoch/fence/attempt fields.", "properties": { "capability": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ReqDef_WorkItemClaimCapabilityRequestSchemaVersion" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "work_item_id", "capability" ], "type": "object" }, "ReqDef_WriteBackAttempt": { "additionalProperties": false, "properties": { "applied_field_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "change_set_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "change_set_id": { "type": "string" }, "connector_observation_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "effect_status": { "$ref": "#/components/schemas/ReqDef_WriteBackEffectStatus" }, "idempotency_key": { "type": "string" }, "input_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "kind": { "$ref": "#/components/schemas/ReqDef_WriteBackAttemptKind" }, "outcome": { "$ref": "#/components/schemas/ReqDef_WriteBackOutcome" }, "output_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "post_source_version": { "type": "string" }, "pre_source_version": { "type": "string" }, "provenance_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "change_set_id", "change_set_digest", "idempotency_key", "kind", "input_digest", "output_digest", "pre_source_version", "post_source_version", "applied_field_digest", "outcome", "effect_status", "connector_observation_digest", "provenance_digest" ], "type": "object" }, "ReqDef_WriteBackAttemptKind": { "enum": [ "dry_run", "apply" ], "type": "string" }, "ReqDef_WriteBackAuthorizationDecision": { "additionalProperties": false, "properties": { "authorization_ref": { "type": "string" }, "authorized": { "type": "boolean" }, "decision_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "input_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" }, "mode": { "$ref": "#/components/schemas/ReqDef_WriteBackAuthorizationMode" }, "output_digest": { "$ref": "#/components/schemas/ReqDef_Digest256" } }, "required": [ "mode", "authorization_ref", "decision_digest", "input_digest", "output_digest", "authorized" ], "type": "object" }, "ReqDef_WriteBackAuthorizationMode": { "enum": [ "proposal_approval", "standing_policy", "manual_trigger" ], "type": "string" }, "ReqDef_WriteBackEffectStatus": { "enum": [ "no_effect", "applied", "outcome_uncertain" ], "type": "string" }, "ReqDef_WriteBackOp": { "oneOf": [ { "additionalProperties": false, "properties": { "change_set": { "$ref": "#/components/schemas/ReqDef_SourceChangeSet" }, "op": { "const": "create", "type": "string" } }, "required": [ "op", "change_set" ], "type": "object" }, { "additionalProperties": false, "properties": { "change_set_id": { "type": "string" }, "op": { "const": "get", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "change_set_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "attempt": { "$ref": "#/components/schemas/ReqDef_WriteBackAttempt" }, "op": { "const": "record_attempt", "type": "string" } }, "required": [ "op", "attempt" ], "type": "object" }, { "additionalProperties": false, "properties": { "observation": { "$ref": "#/components/schemas/ReqDef_ReconciliationObservation" }, "op": { "const": "record_reconciliation", "type": "string" } }, "required": [ "op", "observation" ], "type": "object" }, { "additionalProperties": false, "properties": { "after_sequence": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" }, "change_set_id": { "type": "string" }, "limit": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "op": { "const": "receipts", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "change_set_id", "limit" ], "type": "object" } ] }, "ReqDef_WriteBackOutcome": { "enum": [ "dry_run_ready", "applied", "conflict", "rejected", "outcome_uncertain" ], "type": "string" }, "ReqDef_YearData": { "description": "One fiscal year of standardized financial-statement inputs (forensic scores).", "properties": { "cfo": { "format": "double", "type": "number" }, "cogs": { "format": "double", "type": "number" }, "current_assets": { "format": "double", "type": "number" }, "current_liabilities": { "format": "double", "type": "number" }, "depreciation": { "format": "double", "type": "number" }, "ebit": { "format": "double", "type": "number" }, "long_term_debt": { "format": "double", "type": "number" }, "market_cap": { "format": "double", "type": "number" }, "net_income": { "format": "double", "type": "number" }, "ppe_net": { "format": "double", "type": "number" }, "receivables": { "format": "double", "type": "number" }, "retained_earnings": { "format": "double", "type": "number" }, "sales": { "format": "double", "type": "number" }, "sga": { "format": "double", "type": "number" }, "shares": { "format": "double", "type": "number" }, "total_assets": { "format": "double", "type": "number" }, "total_liabilities": { "format": "double", "type": "number" } }, "required": [ "sales", "cogs", "sga", "net_income", "cfo", "receivables", "current_assets", "current_liabilities", "ppe_net", "depreciation", "total_assets", "total_liabilities", "long_term_debt", "retained_earnings", "ebit", "market_cap", "shares" ], "type": "object" }, "Req_AcquireCapacity": { "additionalProperties": false, "description": "Atomically acquire one bounded multi-dimensional capacity lease set.\nThe native engine owns the cell epoch, fence, expiry, and idempotency\nrows; the request's owner digest is only an authenticated assertion.", "properties": { "method": { "const": "AcquireCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_CapacityAcquireRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AddEdge": { "additionalProperties": false, "properties": { "method": { "const": "AddEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AddEmbedding": { "additionalProperties": false, "properties": { "method": { "const": "AddEmbedding", "type": "string" }, "params": { "additionalProperties": false, "properties": { "embedding": { "items": { "format": "float", "type": "number" }, "type": "array" }, "node_id": { "type": "string" } }, "required": [ "node_id", "embedding" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AddNode": { "additionalProperties": false, "properties": { "method": { "const": "AddNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "node_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AddSceneObject": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 create a `:SceneObject` with LOCAL `pose_msgpack` (a\nMessagePack-encoded `{translation,rotation,scale}` JSON), optionally parented\nunder `parent` via a `CHILD_OF`/`HAS_CHILD` link. The id derives\ndeterministically from `(live node count, parent, pose)`, so WAL replay\nreproduces it. Returns the new object's id (`String`).", "properties": { "method": { "const": "AddSceneObject", "type": "string" }, "params": { "additionalProperties": false, "properties": { "parent": { "type": [ "string", "null" ] }, "pose_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "pose_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AddTriples": { "additionalProperties": false, "description": "Parse `turtle` OR `ntriples` (exactly one non-empty) and store the triples\ninto the request's graph (CONCEPT:EG-KG.ontology.kg-native-rdf-sparql). Returns a `Raw` `LoadReport`\n(`{triples, multivalue}`). Gated `rdf`; a build without it\ndrops the variant \u2192 the dispatch not-built catch-all.", "properties": { "method": { "const": "AddTriples", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ntriples": { "default": "", "description": "N-Triples document (empty \u21d2 use `turtle`).", "type": "string" }, "turtle": { "default": "", "description": "Turtle document (empty \u21d2 use `ntriples`).", "type": "string" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AgentAssemble": { "additionalProperties": false, "description": "Typed task/capability requirements -> a validated `AgentGraph` draft\nwith coverage derivations and a verifiable certificate, or a typed\nabstention. Reads one tenant-bound agent-library snapshot; commits\nnothing. Boxed like `SemanticIndex`/`KgDelegate` so one request cannot\nset the size of every `Method`.", "properties": { "method": { "const": "AgentAssemble", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_AssemblyRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AgentComponent": { "additionalProperties": false, "description": "Publish, retire, inspect, or SEARCH one durable agent component --\nlayer 1 of the hierarchy (RF-ADR-008): the model profiles, prompts,\ntools, MCP servers/prompts/resources, skills, schemas and predicates\nagents are assembled from. `Search` is the capability query this layer\nexists for: \"what does an agent trying to do XYZ need?\"", "properties": { "method": { "const": "AgentComponent", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_AgentComponentOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AgentGraph": { "additionalProperties": false, "description": "Publish, retire, or inspect one durable agent GRAPH -- a composition of\nAgent Library entries -- through the same authenticated ControlPlane\nowner (RF-ADR-008). `AgentLibrary` records what one agent IS; this\nrecords how several of them are composed to do a task.", "properties": { "method": { "const": "AgentGraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_AgentGraphOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AgentLibrary": { "additionalProperties": false, "description": "Publish, retire, inspect, or reconcile one durable EG Agent Library\ndefinition through the authenticated ControlPlane owner.", "properties": { "method": { "const": "AgentLibrary", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_AgentLibraryOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AgentTemplate": { "additionalProperties": false, "description": "Publish, retire, inspect or INSTANTIATE one durable agent template --\nRF-ADR-008 item C: a published agent plus declared axes of variation.\n`Instantiate` is the operation this layer exists for; it binds\nparameters and returns an ordinary `AgentLibraryEntryDraft`, so an\ninstance is admitted and delegated with no template-aware branch\nanywhere downstream.\n\nNot boxed at this level, for the same reason the three layers beside it\nare not: the only oversized request is the publish draft, and\n`AgentTemplateOp::Publish` already boxes it, so this variant is no\nlarger than `AgentComponent` next to it (asserted by\n`the_publish_request_is_boxed_so_a_template_op_stays_small`).", "properties": { "method": { "const": "AgentTemplate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_AgentTemplateOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AnalyticsJob": { "additionalProperties": false, "description": "The durable analytics-job plane (CONCEPT:INT-P2-1): async caller control\nplus verified remote-worker claim/renew/checkpoint/stage/publish/cancel over\na coordinator-owned `AnalyticsJob` state machine (`eg-jobs`),\nwhose eventual success commits a provenance'd `:Claim`/`:Evidence` pair (the\nSAME typed-node convention `eg-epistemic` reads). ONE variant wrapping an\ninternal op enum \u2014 mirrors `RbacAdmin { op }` above \u2014 so the whole\nfull surface costs exactly one `Method` arm. Gated `jobs`; the handler\n(`src/server/handlers/jobs.rs`)\nself-routes in `dispatch.rs` before the per-graph chain (jobs are keyed by\n`job_id` in their own `jobs.redb`, not a graph \u2014 like `TsAppend`/`Kv*`).", "properties": { "method": { "const": "AnalyticsJob", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_JobOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AppendStep": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-099 \u2014 APPEND a `:Step{action,reward,t,\u2026}` to trajectory\n`traj_id`. `action_msgpack` is a MessagePack-encoded JSON action (a string or\nstructured object); `reward`/`t` are caller-supplied (no clock/RNG \u21d2\ndeterministic). The step id derives from `(traj_id, step ordinal)`, so WAL\nreplay reproduces the identical chain. Returns `Raw(Option)` \u2014 the new\nstep id, or nil if the trajectory is absent.", "properties": { "method": { "const": "AppendStep", "type": "string" }, "params": { "additionalProperties": false, "properties": { "action_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "next_state_ref": { "default": null, "type": [ "string", "null" ] }, "reward": { "format": "double", "type": "number" }, "state_ref": { "default": null, "type": [ "string", "null" ] }, "t": { "format": "uint64", "minimum": 0, "type": "integer" }, "traj_id": { "type": "string" } }, "required": [ "traj_id", "action_msgpack", "reward", "t" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ApplyChangeEnvelope": { "additionalProperties": false, "description": "Atomically materialize one externally sourced object and all of its\ngovernance/provenance state. The embedded MutationBatch is the graph-row\nmutation authority; blob/feature/evidence/policy/lineage, content version,\ntyped cursor, durable status, and outbox share its commit point.", "properties": { "method": { "const": "ApplyChangeEnvelope", "type": "string" }, "params": { "additionalProperties": false, "properties": { "envelope": { "$ref": "#/components/schemas/ReqDef_ChangeEnvelope" } }, "required": [ "envelope" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ApplyChangeEnvelopes": { "additionalProperties": false, "description": "Atomically materialize a BATCH of externally sourced objects. Envelopes are\ngrouped by their `mutation.graph` and each graph's envelopes land in ONE\ncoalesced redb transaction (the atomic graph-batch); envelopes spanning\ngraphs split into independent per-graph sub-batches. Within a graph-batch the\ncommit is all-or-nothing \u2014 a single failing envelope aborts that graph's\ntransaction and every envelope in the graph reports the batch outcome. Across\ngraphs the sub-batches are independent (partial success). Per-envelope results\n(applied / idempotent-skip / conflict) are returned in request order. Same\npolicy class as `ApplyChangeEnvelope`. Bounded by `MAX_ENVELOPES_PER_BATCH`.", "properties": { "method": { "const": "ApplyChangeEnvelopes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "envelopes": { "items": { "$ref": "#/components/schemas/ReqDef_ChangeEnvelope" }, "type": "array" } }, "required": [ "envelopes" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ApplyLedger": { "additionalProperties": false, "properties": { "method": { "const": "ApplyLedger", "type": "string" }, "params": { "additionalProperties": false, "properties": { "transactions": { "items": { "type": "string" }, "type": "array" } }, "required": [ "transactions" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ApplyMultisigMutation": { "additionalProperties": false, "properties": { "method": { "const": "ApplyMultisigMutation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "mutation_type": { "type": "string" }, "query": { "type": "string" }, "signatures": { "items": { "type": "string" }, "type": "array" }, "threshold": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "signatures", "threshold", "mutation_type", "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ApplyMutation": { "additionalProperties": false, "properties": { "method": { "const": "ApplyMutation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "event_type": { "type": "string" }, "query": { "type": "string" } }, "required": [ "event_type", "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Asr": { "additionalProperties": false, "description": "Native ASR provider surface (GOC-33, `OWNER-VOICE-ASR`): a direct,\nnon-durable batch-file transcription call over the whisper-rs/\nwhisper.cpp provider in `eg-asr-whisper` \u2014 the wire surface\n`audio-transcriber`'s pluggable `TranscriptionProvider` seam reaches\nover the existing `epistemic_graph.client` transport (no second\ntransport). ONE variant wrapping an internal op enum, mirroring\n`Quantum { op }`/`Statechart { op }` above. Gated `asr-native`; the\nhandler (`src/server/handlers/asr.rs`) self-routes in `dispatch.rs`\nbefore the per-graph chain (a transcription reads no persisted graph\nstate and commits no durable `asr.result.v1` \u2014 see\n`crates/eg-audio/src/asr.rs`'s module doc for that authority\nboundary, owned by future worker/AU-orchestration work).", "properties": { "method": { "const": "Asr", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_AsrOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AuditProveInclusion": { "additionalProperties": false, "description": "Produce + server-side-verify a Merkle inclusion proof for one node against\na prior provenance anchor (CONCEPT:EG-KG.sharding.row-level-security, feature `security`) \u2014 the\nextension that lets [`AuditVerify`](Method::AuditVerify)'s tamper-evidence\nreach the ANCHORED NODES' CONTENT, not just the ordering of mutations. A\nperiodic engine job Merkle-hashes the target graph's `:ToolCall`/\n`:RunTrace` provenance-node window and folds the root into this SAME\nhash chain as one more entry (`audit::provenance_anchor_line`); this\nmethod re-hashes `node_id`'s CURRENT durable content and walks the\nanchor-time sibling path up to that chain-protected root \u2014 a mismatch\n(`MerkleInclusionReport.verified == false`) proves the node's durable\nbytes changed after anchoring, whether by raw tampering or an ordinary\nlater overwrite. `anchor_seq` selects a specific anchor by its\naudit-chain seq; `None` uses the target graph's most recent anchor.\nErrors when the graph has no anchor yet or `anchor_seq` names an entry\nthat is not one; `included == false` (not an error) means `node_id`\nsimply was not part of that anchor's window. Returns\n`Raw(MerkleInclusionReport)`.", "properties": { "method": { "const": "AuditProveInclusion", "type": "string" }, "params": { "additionalProperties": false, "properties": { "anchor_seq": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_AuditVerify": { "additionalProperties": false, "properties": { "method": { "const": "AuditVerify", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_Backup": { "additionalProperties": false, "description": "Take an ONLINE consistent backup under the operator-provisioned\n`EPISTEMIC_GRAPH_BACKUP_ROOT`. `destination` is a bounded logical bundle name,\nnever a host path. The RPC is disabled when no private root is configured.", "properties": { "method": { "const": "Backup", "type": "string" }, "params": { "additionalProperties": false, "properties": { "destination": { "type": "string" }, "label": { "type": [ "string", "null" ] } }, "required": [ "destination" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BatchL2Normalize": { "additionalProperties": false, "description": "CONCEPT:EG-KG.compute.l2-normalize-batch-vectors \u2014 L2-normalize a batch of vectors IN-ENGINE via the `eg-numeric`\nkernel (compute-near-data over a resident vector set): returns each row's unit\nvector `v/\u2016v\u2016` (feature `numeric`).", "properties": { "method": { "const": "BatchL2Normalize", "type": "string" }, "params": { "additionalProperties": false, "properties": { "vectors": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "vectors" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BatchUpdate": { "additionalProperties": false, "properties": { "method": { "const": "BatchUpdate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "operations_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "operations_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BeginTxn": { "additionalProperties": false, "properties": { "method": { "const": "BeginTxn", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "description": "Optional explicit target graph. An explicit `None` selects the request\nenvelope's `graph`.", "type": [ "string", "null" ] }, "isolation": { "description": "Reserved isolation hint; only snapshot isolation is implemented.", "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BestTrajectory": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-099 \u2014 the trajectory in `traj_ids` with the HIGHEST\ndiscounted return (prioritized replay / policy selection); ties broken by the\nsmaller id. Read-only. Returns `Raw(Option)` \u2014 nil for empty input.", "properties": { "method": { "const": "BestTrajectory", "type": "string" }, "params": { "additionalProperties": false, "properties": { "gamma": { "format": "double", "type": "number" }, "traj_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "traj_ids", "gamma" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BetweennessCentrality": { "additionalProperties": false, "properties": { "method": { "const": "BetweennessCentrality", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_BindQueue": { "additionalProperties": false, "description": "Bind `queue` to `exchange` under `routing_key` (idempotent).", "properties": { "method": { "const": "BindQueue", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" }, "queue": { "type": "string" }, "routing_key": { "type": "string" } }, "required": [ "exchange", "queue", "routing_key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BlobBegin": { "additionalProperties": false, "description": "Open an upload cursor; server allocates a cursor id and an empty accumulator.\n`chunk_size` is the fixed split size the client will use (records it on the\nmanifest for range-read math later); 0 \u21d2 the engine default.", "properties": { "method": { "const": "BlobBegin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "chunk_size": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BlobChunkGet": { "additionalProperties": false, "description": "Pull chunk `idx` of an open fetch cursor (one chunk per frame).", "properties": { "method": { "const": "BlobChunkGet", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "format": "uint64", "minimum": 0, "type": "integer" }, "idx": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "cursor", "idx" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BlobChunkPut": { "additionalProperties": false, "description": "Push one chunk into an open upload cursor. Hashed + stored on arrival; only\nthe digest is appended to the cursor (bounded memory).", "properties": { "method": { "const": "BlobChunkPut", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "format": "uint64", "minimum": 0, "type": "integer" }, "data": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "cursor", "data" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BlobCommit": { "additionalProperties": false, "description": "Finalize an upload cursor \u2192 assemble + store the manifest content-addressed,\nreturn the blob digest. Drops the cursor.", "properties": { "method": { "const": "BlobCommit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cursor" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BlobFetchBegin": { "additionalProperties": false, "description": "Open a fetch cursor for a stored blob digest; returns `(cursor, n_chunks)`.", "properties": { "method": { "const": "BlobFetchBegin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "digest": { "type": "string" } }, "required": [ "digest" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BlobFetchEnd": { "additionalProperties": false, "description": "Close a fetch cursor (client done streaming down). Idempotent.", "properties": { "method": { "const": "BlobFetchEnd", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cursor" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BlobGc": { "additionalProperties": false, "description": "Run the refcount mark-and-sweep GC: reclaim every zero-ref blob's manifest +\nthe chunks no surviving blob still lists. Returns `(blobs, chunks)` reclaimed.", "properties": { "method": { "const": "BlobGc", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_BlobRef": { "additionalProperties": false, "description": "Increment a blob's refcount \u2014 a `:Media` node now references it. Returns the\nnew count. (The graph link itself, `:Media-[:HAS_BLOB]->:Blob`, is created by\nthe caller via the normal node/edge methods; this maintains the GC refcount.)", "properties": { "method": { "const": "BlobRef", "type": "string" }, "params": { "additionalProperties": false, "properties": { "digest": { "type": "string" } }, "required": [ "digest" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BlobUnref": { "additionalProperties": false, "description": "Decrement a blob's refcount \u2014 a `:Media` reference was removed. Returns the\nnew count; a blob at 0 is eligible for the next `BlobGc`.", "properties": { "method": { "const": "BlobUnref", "type": "string" }, "params": { "additionalProperties": false, "properties": { "digest": { "type": "string" } }, "required": [ "digest" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BrokerAck": { "additionalProperties": false, "description": "Acknowledge (remove) a claimed message, freeing the consumer's in-flight slot\n(CONCEPT:EG-KG.compute.groups-qos-prefetch-honoring). Returns `Bool(true)` if the message existed.", "properties": { "method": { "const": "BrokerAck", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "queue": { "type": "string" } }, "required": [ "queue", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BrokerAckTag": { "additionalProperties": false, "description": "Acknowledge (remove) a claimed message by its positive `delivery_tag`\n(CONCEPT:EG-KG.compute.publisher-confirms-consumer-qos). The caller must name the claiming `consumer`; the\nstatus, current tag, and owner are fenced atomically. Returns `Bool(false)`\nfor an absent, stale, or foreign-owned generation.", "properties": { "method": { "const": "BrokerAckTag", "type": "string" }, "params": { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "delivery_tag": { "format": "int64", "type": "integer" } }, "required": [ "delivery_tag", "consumer" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BrokerConsume": { "additionalProperties": false, "description": "Consume one message from `queue` for a named consumer-group member\n(CONCEPT:EG-KG.compute.groups-qos-prefetch-honoring groups + QoS/prefetch, honoring EG-277 TTL / EG-278 priority /\nEG-279 delay). Claims the highest-priority, oldest, DUE, non-expired message,\nenforcing per-consumer `prefetch` (0 \u21d2 unlimited) and taking a visibility lease\nof `lease_ms` (0 \u21d2 no lease). Lazily dead-letters any expired messages it steps\nover. Returns `Raw(Option<(node_id, properties)>)` \u2014 nil \u21d2 nothing deliverable.", "properties": { "method": { "const": "BrokerConsume", "type": "string" }, "params": { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "group": { "type": "string" }, "lease_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "prefetch": { "format": "uint32", "minimum": 0, "type": "integer" }, "queue": { "type": "string" } }, "required": [ "queue", "group", "consumer", "now_ms", "lease_ms", "prefetch" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BrokerNackTag": { "additionalProperties": false, "description": "Nack a claimed message by its positive `delivery_tag` (CONCEPT:EG-KG.compute.publisher-confirms-consumer-qos). The caller\nmust name the claiming `consumer`; status, current tag, and owner are fenced\natomically. With `requeue` the message returns to claimable (at-least-once\nredelivery) unless its delivery budget is exhausted. Returns `String` outcome\n(`requeued`/`dead-lettered`/`dropped`/`absent`).", "properties": { "method": { "const": "BrokerNackTag", "type": "string" }, "params": { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "delivery_tag": { "format": "int64", "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "requeue": { "type": "boolean" } }, "required": [ "delivery_tag", "consumer", "requeue", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BrokerReject": { "additionalProperties": false, "description": "Reject a claimed message (CONCEPT:EG-KG.compute.dead-letter-queues). If `requeue` and the delivery count\nis under the queue's `max_delivery_count`, the message returns to claimable;\notherwise it is dead-lettered to the queue's DL target (with `x-death` metadata)\nor dropped. Returns `String` outcome (`requeued`/`dead-lettered`/`dropped`/\n`absent`).", "properties": { "method": { "const": "BrokerReject", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "queue": { "type": "string" }, "requeue": { "type": "boolean" } }, "required": [ "queue", "node_id", "requeue", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_BrokerRenewTag": { "additionalProperties": false, "description": "Extend a still-live claimed delivery lease for its current owner. The\nstatus, tag, owner, and unexpired lease are fenced atomically. The requested\ndeadline must advance the current deadline. `now_ms` is explicit so durable\nreplay is deterministic.", "properties": { "method": { "const": "BrokerRenewTag", "type": "string" }, "params": { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "delivery_tag": { "format": "int64", "type": "integer" }, "lease_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "delivery_tag", "consumer", "now_ms", "lease_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CancelRequest": { "additionalProperties": false, "description": "Cooperatively cancel an IN-FLIGHT request by its `target_req_id` (CONCEPT:EG-KG.query.streaming-spillable-collect,\nL36) \u2014 trips the `CancellationToken` the request-scoped registry (`server::request_cancel`)\nregistered for it, if one is still live. A REAL `Method::Sql` read currently threads a\nregistered token down to `collect_streaming`, which observes it at the next batch\nboundary and stops the stream short (chunk-granular, never mid-batch). Returns\n`ResultPayload::Bool(true)` iff a live cancellable request was found and cancelled,\n`false` when the request already finished, was never cancellable, or never existed \u2014\nnever an error (cancelling a request that already completed is a harmless no-op).", "properties": { "method": { "const": "CancelRequest", "type": "string" }, "params": { "additionalProperties": false, "properties": { "target_req_id": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "target_req_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CancelWorkItem": { "additionalProperties": false, "description": "Cancel a pending WorkItem without first manufacturing a worker lease.\nActive, unexpired leases are never stolen: their current owner must use\n`CommitWorkItemResult` with the matching epoch/fencing token instead.", "properties": { "method": { "const": "CancelWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "idempotency_key": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason_ref": { "default": null, "description": "Opaque reference to a redacted cancellation reason. The engine never\npersists a caller-supplied reason body in the control-plane node.", "type": [ "string", "null" ] }, "tenant": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "tenant", "work_item_id", "idempotency_key", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CapacityStatus": { "additionalProperties": false, "description": "Exact bounded native capacity read.", "properties": { "method": { "const": "CapacityStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_CapacityStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CasWorkItemMetadata": { "additionalProperties": false, "description": "Atomic compare-and-set on one WorkItem's non-authority SCHEDULING\nMETADATA (`checkpoint_id` / `metadata` / `prio_bucket`) \u2014 the native\nreplacement for a generic `CompareAndSetNodeFields` against a\nWorkItem row, which `work_item_capability::validate_generic_method`\n(RMDD-29) unconditionally refuses once the row is claimed (BUG-111).\nRuns inside the SAME durable WorkItem transaction as `ClaimWorkItem`/\n`RenewWorkItemLease`, never a side path. Cannot touch `status`/\n`lease_owner`/`lease_epoch`/`fencing_token`/`tenant` \u2014 the request\ncarries no such field \u2014 so it can never manufacture or extend native\nlease authority.", "properties": { "method": { "const": "CasWorkItemMetadata", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_CasWorkItemMetadataRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CatalogAssign": { "additionalProperties": false, "description": "Populate / assign an explicit catalog placement for `graph` (CONCEPT:EG-KG.sharding.empty-catalog-routing).\nFlips the ROUTE only \u2014 to MOVE the rows too use `Reshard`. Returns `Bool`.", "properties": { "method": { "const": "CatalogAssign", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "node": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "shard": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "shard" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CatalogList": { "additionalProperties": false, "description": "List every explicit catalog placement `{graph, shard, node}` (JSON).", "properties": { "method": { "const": "CatalogList", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_CatalogReassign": { "additionalProperties": false, "description": "Re-place `graph` onto `shard`, preserving its node placement (CONCEPT:EG-KG.sharding.empty-catalog-routing).", "properties": { "method": { "const": "CatalogReassign", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "shard": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "shard" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CatalogRemove": { "additionalProperties": false, "description": "Drop `graph`'s explicit placement \u2014 it reverts to EG-026 FNV-1a routing.", "properties": { "method": { "const": "CatalogRemove", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" } }, "required": [ "graph" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CausalCounterfactual": { "additionalProperties": false, "description": "EPI-P3-6 \u2014 Pearl's point-**counterfactual** recipe\n(`eg_epistemic::CausalGraph::counterfactual`, feature `epistemic-causal`):\n\"given that unit `actual` (a FULLY-observed assignment of every variable in\n`variables`) really happened, what would its variables have been had\n`do_values` held instead?\" \u2014 the three-step abduction/action/prediction\nrecipe (Pearl, *Causality*, ch. 7), replaying the SAME inferred exogenous\nnoise forward through the (surgered) structural equations.\n\nDETERMINISTIC given `actual` \u2014 not a calibrated distribution like\n`CausalEstimate` \u2014 so it returns a `CausalCounterfactualResult` (one POINT\nvalue per variable, in `variables` order) via `ResultPayload::raw` instead\nof a `CausalEstimateResult`. A pure function over request-carried inputs \u2014\nno graph snapshot is read. Gated `epistemic` at the wire level; the HANDLER\nadditionally requires `epistemic-causal` \u2014 same build-tier fallback\nconvention as `CausalEstimate`.", "properties": { "method": { "const": "CausalCounterfactual", "type": "string" }, "params": { "additionalProperties": false, "properties": { "actual": { "additionalProperties": { "format": "double", "type": "number" }, "type": "object" }, "do_values": { "additionalProperties": { "format": "double", "type": "number" }, "type": "object" }, "variables": { "items": { "$ref": "#/components/schemas/ReqDef_StructuralEquationWire" }, "type": "array" } }, "required": [ "variables", "actual", "do_values" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CausalEstimate": { "additionalProperties": false, "description": "EPI-P3-3 \u2014 a request-carried linear-Gaussian structural causal model query:\n`variables` defines the DAG's `StructuralEquation`s in topological\n(parents-before-children) order \u2014 the SAME invariant\n`eg_epistemic::CausalGraph::add_variable` enforces at construction. `mode`\n(EPI-P3-6) selects which of `eg_epistemic::CausalGraph`'s two\nnon-counterfactual queries `do_values` feeds:\n\n* `CausalQueryModeWire::Intervene` \u2014 a **do-calculus intervention**\n `P(\u00b7 | do(X\u2081=x\u2081, X\u2082=x\u2082, \u2026))`:\n `do_values` fixes the named variables via graph surgery\n (`CausalGraph::intervene`) \u2014 incoming edges are CUT, not conditioned on.\n* `CausalQueryModeWire::Observe` \u2014 the **observational** query\n `P(\u00b7 | X\u2081=x\u2081, X\u2082=x\u2082, \u2026)`: ordinary multivariate-Gaussian conditioning on\n the UNMUTILATED joint (`CausalGraph::observe`). Unlike `Intervene`,\n evidence propagates BACKWARD to ancestors too (e.g. a confounder) \u2014 the\n mechanism a naive \"condition on the evidence\" read of a causal question\n gets wrong, and exactly what distinguishes \"seeing X=x\" from \"doing X=x\".\n\nEither way, returns a calibrated `CausalEstimateResult` (mean/variance/\ncredible-interval per variable, in `variables` order) via\n`ResultPayload::raw`. A pure function over request-carried inputs \u2014 no graph\nsnapshot is read. Gated `epistemic` at the wire level; the HANDLER\nadditionally requires `epistemic-causal` \u2014 same build-tier fallback\nconvention as `ExplainEvidence`.\n\nThe crate's Pearl point-counterfactual (`CausalGraph::counterfactual`) is a\ndistinct, DETERMINISTIC (not distributional) query with its own request\nshape \u2014 see `CausalCounterfactual` below, not this variant.", "properties": { "method": { "const": "CausalEstimate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "do_values": { "additionalProperties": { "format": "double", "type": "number" }, "type": "object" }, "mode": { "$ref": "#/components/schemas/ReqDef_CausalQueryModeWire" }, "variables": { "items": { "$ref": "#/components/schemas/ReqDef_StructuralEquationWire" }, "type": "array" } }, "required": [ "variables", "do_values", "mode" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CdcRead": { "additionalProperties": false, "description": "Read the ordered change feed for `graph` from cursor `from_seq` (inclusive),\nup to `limit` events (CONCEPT:EG-KG.query.streaming-cdc-subscriptions). Returns a `Raw`\n`CdcReadResult` (B-8, 2026-08-13: `{events, gap, watermark, head_seq, epoch}` \u2014\nwas a bare `Vec`, which made a genuinely-caught-up cursor\nindistinguishable from one that silently fell off the ring; see\n`CdcReadResult`'s doc). The consumer re-reads from `last.seq + 1` to skip what\nit has seen, and MUST check `gap` before treating an empty `events` as \"caught\nup\" \u2014 `gap: true` means it is not. `limit` 0 \u21d2 a default cap.", "properties": { "method": { "const": "CdcRead", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from_seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "limit": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_seq" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CepPoll": { "additionalProperties": false, "description": "Poll a CEP subscription for the matches pushed since the last poll\n(CONCEPT:EG-KG.query.protocol-types), blocking up to `timeout_ms` for the FIRST one if none are ready\n(then returns whatever arrived). Returns a `Raw` `Vec`; an empty\nvec means \"nothing yet\" (re-poll to keep tailing). A dropped subscription (unknown\n`sub_id`) is an error.", "properties": { "method": { "const": "CepPoll", "type": "string" }, "params": { "additionalProperties": false, "properties": { "sub_id": { "format": "uint64", "minimum": 0, "type": "integer" }, "timeout_ms": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sub_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CepSubscribe": { "additionalProperties": false, "description": "Register a live CEP standing query (CONCEPT:EG-KG.query.protocol-types). `pattern_msgpack` is a\nMessagePack `CepPatternSpec` (the same pattern algebra `Op::Cep` carries); `buffer`\n(0 \u21d2 a default) bounds how many unconsumed matches are retained for a lagging\npoller before the oldest are dropped. Returns a `Count` \u2014 the subscription id to\npass to `CepPoll` / `CepUnsubscribe`.", "properties": { "method": { "const": "CepSubscribe", "type": "string" }, "params": { "additionalProperties": false, "properties": { "buffer": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "pattern_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "pattern_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CepUnsubscribe": { "additionalProperties": false, "description": "Drop a CEP standing query + its subscriber (CONCEPT:EG-KG.query.protocol-types). Returns `Bool` (true\nif it existed).", "properties": { "method": { "const": "CepUnsubscribe", "type": "string" }, "params": { "additionalProperties": false, "properties": { "sub_id": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sub_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ClaimNext": { "additionalProperties": false, "description": "Atomically claim the oldest pending node of `label` (CONCEPT:EG-KG.compute.atomically-claim-oldest-pending \u2014\nnative task queue). Under the topology write guard: among `label`'s nodes\nwhose `status == \"pending\"`, pick the smallest `seq`, merge\n`updates_msgpack` (the claim marker \u2014 computed CLIENT-side, carrying NO\nserver clock so WAL/Raft replay stays deterministic), and return\n`Raw(Option<(node_id, properties)>)` (nil \u21d2 nothing claimable). One\nin-engine resolve+CAS; deterministic over identical state, so a committed\nRaft entry / replayed WAL record reproduces the same claim.", "properties": { "method": { "const": "ClaimNext", "type": "string" }, "params": { "additionalProperties": false, "properties": { "label": { "type": "string" }, "updates_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "label", "updates_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ClaimWorkItem": { "additionalProperties": false, "description": "Atomically select and lease the next runnable `WorkItem` node. Selection is\ntenant/resource/fairness scoped, priority ascending, then deadline/creation\nordered. A negative result is authoritative and must not trigger another\nclaim path.", "properties": { "method": { "const": "ClaimWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_ClaimWorkItemRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CleanupDevelopmentLane": { "additionalProperties": false, "description": "Release retained disk and identity indexes after a distinct current\n`lane.cleanup` WorkItem proves the guarded filesystem effect complete.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "CleanupDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneCleanupCompleteRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ClearGraph": { "additionalProperties": false, "properties": { "method": { "const": "ClearGraph", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_ClearLedger": { "additionalProperties": false, "properties": { "method": { "const": "ClearLedger", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_CloseChannel": { "additionalProperties": false, "properties": { "method": { "const": "CloseChannel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "summary_embedding": { "description": "Optional embedding of the conversation summary.", "items": { "format": "float", "type": "number" }, "type": [ "array", "null" ] }, "topic_metadata": { "description": "Optional topic/metadata for the KG imprint.", "type": [ "string", "null" ] } }, "required": [ "channel_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ClusterHierarchyClusters": { "additionalProperties": false, "description": "`GET clusters(graph, level, parent_cluster_id?)` \u2014 one level of the\ncached hierarchy, optionally restricted to one parent's children.\n`level` 1 is the finest computed level; `parent_cluster_id` unset\nreturns every cluster at `level`. Errors if no hierarchy is cached yet\n(call `ClusterHierarchyRefresh` first).", "properties": { "method": { "const": "ClusterHierarchyClusters", "type": "string" }, "params": { "additionalProperties": false, "properties": { "level": { "format": "uint", "minimum": 0, "type": "integer" }, "parent_cluster_id": { "default": null, "type": [ "string", "null" ] } }, "required": [ "level" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ClusterHierarchyExpand": { "additionalProperties": false, "description": "`GET expand(graph, cluster_id)` \u2014 a level-1 cluster's individual member\nnodes/edges (read live off the current graph, keyed by the cached\nmembership) plus its child clusters (empty for a level-1 cluster, since\nlevel 1 is the finest computed level).", "properties": { "method": { "const": "ClusterHierarchyExpand", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cluster_id": { "type": "string" } }, "required": [ "cluster_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ClusterHierarchyRefresh": { "additionalProperties": false, "description": "(Re)compute the hierarchy for the request's graph and persist it,\nreplacing any previously cached hierarchy for the same graph.\n`ClusterHierarchyClusters`/`ClusterHierarchyExpand` serve the cached\nresult until this is called again \u2014 \"refreshable\", not\nrecomputed-per-request.", "properties": { "method": { "const": "ClusterHierarchyRefresh", "type": "string" }, "params": { "additionalProperties": false, "properties": { "label": { "default": null, "description": "Optional: restrict the clustered projection to nodes of this one\ntype \u2014 mirrors `MineCommunity::label`.", "type": [ "string", "null" ] }, "resolution": { "default": 1.0, "description": "Leiden resolution \u03b3 (higher \u21d2 more, smaller clusters).", "format": "double", "type": "number" }, "seed": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ClusterMembers": { "additionalProperties": false, "description": "Read the current cluster topology (CONCEPT:EG-KG.sharding.cluster-topology): every known Raft\ngroup's members, each with its role (`leader`/`follower`/`learner`),\nhealth and client-reachable endpoint. The response is an authenticated,\nbounded discovery snapshot carrying a stable `cluster_id`, monotonic\n`membership_epoch`/`placement_epoch`, immutable member identities and\ncertificate-rotation metadata. Gated `cluster:topology-read` -- NOT\n`admin:cluster-read` -- so an ordinary service role (not just a cluster\noperator) can discover where to reconnect after a failover. Always declared;\na non-raft build or a raft build with no live `MultiRaft` answers a\nwell-formed empty topology rather than an error. The Python client rejects\nunsigned, wrong-cluster, stale, or differently bound snapshots.", "properties": { "method": { "const": "ClusterMembers", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_Commit": { "additionalProperties": false, "description": "Commit the staged transaction (see the section doc above for the OCC\nserialization/apply contract). `idempotency_key` (B-9, 2026-08-13,\noptional) is a CALLER-chosen dedup key, extending the SAME\n`(tenant, graph, idempotency_key)`-scoped durable dedup mechanism\n`ApplyChangeEnvelope` uses (`change_envelope.rs`'s\n`idempotency_key`/`applied` vs `idempotent_skip` vocabulary) onto the\ntxn commit's own durable receipt, rather than a second mechanism.\nWithout it, retry-safety depends entirely on the caller still holding\nthe exact server-issued `txn_id` (already durable via the receipt) --\nprovably safe for \"commit succeeded, response lost, retry with the SAME\ntxn_id\", but NOT for \"I lost track of txn_id and had to re-`BeginTxn`\nand re-stage\" (a fresh `txn_id` looks like a brand-new transaction).\nWITH a caller key, a retry that re-stages under a fresh `txn_id` still\nlands on the SAME durable receipt and replay-skips.\n\nReturns `Bool` when `idempotency_key` is omitted (UNCHANGED wire shape).\nReturns a `Json` `{\"committed\": bool, \"replayed\": bool}` when a key is\nsupplied, so the caller can tell \"applied just now\" from \"already\napplied \u2014 this is the cached result\" (mirrors `ApplyChangeEnvelope`'s\n`applied`/`idempotent_skip` status).", "properties": { "method": { "const": "Commit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "idempotency_key": { "type": [ "string", "null" ] }, "txn_id": { "type": "string" } }, "required": [ "txn_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CommitWorkItemResult": { "additionalProperties": false, "description": "Publish a WorkItem terminal/retry result through the same authoritative\ntransaction as its state transition and mutation outbox. Result bodies are\nreferenced, never embedded, so the durable control plane stores no PII.", "properties": { "method": { "const": "CommitWorkItemResult", "type": "string" }, "params": { "additionalProperties": false, "properties": { "error_ref": { "default": null, "type": [ "string", "null" ] }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "outcome": { "type": "string" }, "outcome_extension": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_TerminalOutcomeExtension" }, { "type": "null" } ], "default": null, "description": "Optional RF-020/GOC-20 terminal receipts. When present, the\nmutation compiler lowers the bound receipt nodes to AddNode\noperations and one run-event outbox intent in this same batch.\n\nBoxed because it dominates the size of this variant and, through it,\nof EVERY `Method`. `Option>` and `Option` serialize\nidentically, so the wire form -- and the frozen contract -- are\nunchanged; only the in-memory layout moves." }, "result_ref": { "default": null, "type": [ "string", "null" ] }, "retryable": { "default": false, "type": "boolean" }, "tenant": { "type": "string" }, "work_item_id": { "type": "string" }, "worker_id": { "type": "string" } }, "required": [ "tenant", "work_item_id", "worker_id", "lease_epoch", "fencing_token", "idempotency_key", "outcome", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CommunityDetectEphemeral": { "additionalProperties": false, "description": "Stateless community detection over a call graph passed inline \u2014 NO tenant\nload, NO persistence. The ingest path previously bulk-loaded ~160k edges\ninto a throwaway tenant just to run this, then deleted the tenant; passing\nthe edges directly removes that whole round-trip + the tenant sprawl.\n\nEH-314: `edges` carries an explicit per-edge WEIGHT \u2014 the resolver\nconfidence a caller already computes (0.95 scoped down to 0.60 unique,\nEH-284) \u2014 and `quality` selects Modularity vs CPM (EH-283). This\nstateless path is the one actually taken in production, unlike its\npersisted-topology sibling `CommunityDetection` (which derives weight\nfrom `edge_properties` via `algorithms::community::resolver_confidence_weight`),\nso it needed its own weight/quality slot to make EH-283/EH-284 reachable\nat all. A caller sending `1.0` for every edge and omitting `quality`\ngets the byte-identical pre-EH-314 result: uniform-weight Modularity\nLeiden over the same topology.", "properties": { "method": { "const": "CommunityDetectEphemeral", "type": "string" }, "params": { "additionalProperties": false, "properties": { "edges": { "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" }, "node_ids": { "items": { "type": "string" }, "type": "array" }, "quality": { "$ref": "#/components/schemas/ReqDef_CommunityQualityFunction", "default": "modularity" }, "resolution": { "format": "double", "type": "number" } }, "required": [ "node_ids", "edges", "resolution" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CommunityDetection": { "additionalProperties": false, "properties": { "method": { "const": "CommunityDetection", "type": "string" }, "params": { "additionalProperties": false, "properties": { "resolution": { "format": "double", "type": "number" } }, "required": [ "resolution" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CompactNodesByType": { "additionalProperties": false, "properties": { "method": { "const": "CompactNodesByType", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_type": { "type": "string" }, "threshold": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "node_type", "threshold" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CompareAndSetNodeFields": { "additionalProperties": false, "description": "Atomic compare-and-set on a node's property blob (CONCEPT:EG-KG.compute.backend backend-\nagnostic atomic claim). `conditions_msgpack`/`updates_msgpack` are\nMessagePack-encoded JSON objects (field\u2192value maps, same encoding as\n`properties_msgpack`). Under the topology write guard: if every condition\nmatches the node's current value (a MISSING field reads as `null`), the\nupdates are merged in and `true` is returned; otherwise (node absent, any\ncondition fails, or decode fails) the node is left untouched and `false`\nis returned. One in-engine CAS suffices for all backends (the engine is\nthe authoritative store; mirrors follow).", "properties": { "method": { "const": "CompareAndSetNodeFields", "type": "string" }, "params": { "additionalProperties": false, "properties": { "conditions_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "node_id": { "type": "string" }, "updates_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "node_id", "conditions_msgpack", "updates_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ComputeSimilarityEdges": { "additionalProperties": false, "properties": { "method": { "const": "ComputeSimilarityEdges", "type": "string" }, "params": { "additionalProperties": false, "properties": { "threshold": { "format": "double", "type": "number" } }, "required": [ "threshold" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ConnectedComponents": { "additionalProperties": false, "properties": { "method": { "const": "ConnectedComponents", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_ConnectorPack": { "additionalProperties": false, "description": "Atomic connector MCP pack import and its admin surface.", "properties": { "method": { "const": "ConnectorPack", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_ConnectorPackOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Consolidate": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-221 \u2014 consolidate a cluster of `episodic_ids` into ONE\nsemantic node (LOCALIZED maintenance \u2014 nothing outside the cluster is\ntouched). `semantic_props_msgpack` is a MessagePack-encoded JSON object. The\nsemantic id derives deterministically from the sorted cluster, so WAL replay\nreproduces it. Returns the semantic node id (`String`).", "properties": { "method": { "const": "Consolidate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "episodic_ids": { "items": { "type": "string" }, "type": "array" }, "semantic_props_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "episodic_ids", "semantic_props_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CreateChannel": { "additionalProperties": false, "properties": { "method": { "const": "CreateChannel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "channel_type": { "$ref": "#/components/schemas/ReqDef_ChannelType" }, "creator": { "type": "string" }, "initial_members": { "items": { "type": "string" }, "type": "array" } }, "required": [ "channel_id", "channel_type", "creator", "initial_members" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CreateGraph": { "additionalProperties": false, "properties": { "method": { "const": "CreateGraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph_name": { "type": "string" }, "graph_type": { "$ref": "#/components/schemas/ReqDef_GraphType" } }, "required": [ "graph_name", "graph_type" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CreateMatView": { "additionalProperties": false, "description": "Create (or replace) a named, incrementally-maintained MATERIALIZED VIEW of a\ndistributed-compute result over `graphs`. The view is computed once, persisted,\nand refreshed incrementally on a delta (CONCEPT:EG-KG.storage.feature). Returns the row count.", "properties": { "method": { "const": "CreateMatView", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algo": { "$ref": "#/components/schemas/ReqDef_DistAlgo" }, "graphs": { "items": { "type": "string" }, "type": "array" }, "name": { "type": "string" } }, "required": [ "name", "graphs", "algo" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CreateNodeIfAbsent": { "additionalProperties": false, "description": "Create a node only when `node_id` is absent, returning `Bool(true)` only\nfor the inserting writer. The membership test and insert are one durable\natomic operation; an existing node is never overwritten.", "properties": { "method": { "const": "CreateNodeIfAbsent", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "node_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CreateSummaryNode": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-220 \u2014 create (or UPSERT) a hierarchical summary node at\nabstraction `level`, linked to each of `child_ids` via a `SUMMARIZES`\nprovenance edge. `props_msgpack` is a MessagePack-encoded JSON object (the\nLLM summary text + any caller fields; an `id` string is honoured). Durable +\ndeterministic (the id derives from `(level, sorted children)` with no clock),\nso WAL replay upserts the identical node. Returns the summary node id\n(`String`).", "properties": { "method": { "const": "CreateSummaryNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "child_ids": { "items": { "type": "string" }, "type": "array" }, "level": { "format": "uint32", "minimum": 0, "type": "integer" }, "props_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "level", "child_ids", "props_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_CypherQuery": { "additionalProperties": false, "properties": { "method": { "const": "CypherQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "mode": { "$ref": "#/components/schemas/ReqDef_CypherMode", "description": "Exact requested execution authority; no implicit or inferred mode." }, "query": { "type": "string" } }, "required": [ "query", "mode" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DecayMemories": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 batch-decay a caller-supplied working set of memory\n`ids` to the EXPLICIT `now_ms` (localized \u2014 no global scan). Returns `Count`\n(nodes decayed).", "properties": { "method": { "const": "DecayMemories", "type": "string" }, "params": { "additionalProperties": false, "properties": { "half_life_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "ids": { "items": { "type": "string" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "now_ms", "half_life_ms", "ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DecayNode": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 Ebbinghaus-decay a single memory node's importance to\nthe EXPLICIT `now_ms` given `half_life_ms`. Deterministic (caller clock).\nReturns `Bool` (whether it decayed/stamped the node).", "properties": { "method": { "const": "DecayNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "half_life_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "node_id": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_id", "now_ms", "half_life_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DecaySweep": { "additionalProperties": false, "properties": { "method": { "const": "DecaySweep", "type": "string" }, "params": { "additionalProperties": false, "properties": { "floor": { "format": "double", "type": "number" }, "half_life_secs": { "format": "double", "type": "number" }, "prune": { "type": "boolean" } }, "required": [ "half_life_secs", "floor", "prune" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Decide": { "additionalProperties": false, "description": "Statistical decision over library or RLS-filtered graph candidates.\nEVALUATE-ONLY: it answers records and commits none of them.", "properties": { "method": { "const": "Decide", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DecideRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DecisionCommit": { "additionalProperties": false, "description": "Snapshot-checked commit of one assembly `DecisionRecord` as a\n`DecisionRecord` component. Re-derives the record and compares the\ncatalog digest before writing, so a stale decision is refused rather\nthan stored.", "properties": { "method": { "const": "DecisionCommit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DecisionCommitRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DecisionEval": { "additionalProperties": false, "description": "Admin job: off-policy and calibration evaluation producing the\npromotion receipt a head must carry before it may be published.", "properties": { "method": { "const": "DecisionEval", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_DecisionEvalOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DecisionFit": { "additionalProperties": false, "description": "Admin job: fit a decision head into a Blob CAS draft artifact.", "properties": { "method": { "const": "DecisionFit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_DecisionFitOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DeclareExchange": { "additionalProperties": false, "description": "Declare (idempotently upsert) an exchange. `kind` is `direct`/`topic`/`fanout`.", "properties": { "method": { "const": "DeclareExchange", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" }, "kind": { "type": "string" } }, "required": [ "exchange", "kind" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DeclareQueue": { "additionalProperties": false, "description": "Set (idempotently upsert) a queue's policy node (CONCEPT:EG-KG.compute.dead-letter-queues DLQ /\nEG-277 TTL / EG-278 priority). All fields optional \u2014 an all-`None` policy is a\nno-op that keeps the queue behaving exactly as EG-275. Returns `String(\"ok\")`.", "properties": { "method": { "const": "DeclareQueue", "type": "string" }, "params": { "additionalProperties": false, "properties": { "dl_exchange": { "description": "EG-276: exchange to republish dead-lettered messages to (`None` \u21d2 drop).", "type": [ "string", "null" ] }, "dl_routing_key": { "description": "EG-276: routing key for dead-lettered messages (`None` \u21d2 reuse original).", "type": [ "string", "null" ] }, "max_delivery_count": { "description": "EG-276: max delivery attempts before a message is dead-lettered.", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "max_priority": { "description": "EG-278: max priority band the queue honors (advisory ceiling).", "format": "uint8", "maximum": 255, "minimum": 0, "type": [ "integer", "null" ] }, "message_ttl_ms": { "description": "EG-277: default per-message TTL in ms applied when a publish omits one.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "queue": { "type": "string" }, "queue_expiry_ms": { "description": "EG-277: queue-expiry hint in ms (unused-queue teardown; advisory).", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "queue" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DeferWorkItem": { "additionalProperties": false, "description": "Release a leased WorkItem back to `ready` at an explicit retry time\nwithout consuming an execution attempt. This is the native transition\nfor self-polling barriers and other cooperative deferrals.", "properties": { "method": { "const": "DeferWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "next_retry_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason_ref": { "default": null, "description": "Opaque reference only; no free-form reason body is retained.", "type": [ "string", "null" ] }, "tenant": { "type": "string" }, "work_item_id": { "type": "string" }, "worker_id": { "type": "string" } }, "required": [ "tenant", "work_item_id", "worker_id", "lease_epoch", "fencing_token", "idempotency_key", "next_retry_at_ms", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DegreeCentrality": { "additionalProperties": false, "properties": { "method": { "const": "DegreeCentrality", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DegreeCentralityAll": { "additionalProperties": false, "properties": { "method": { "const": "DegreeCentralityAll", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_DeleteExchange": { "additionalProperties": false, "description": "Delete an exchange and all of its bindings (queues/messages untouched).", "properties": { "method": { "const": "DeleteExchange", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" } }, "required": [ "exchange" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DeleteGraph": { "additionalProperties": false, "properties": { "method": { "const": "DeleteGraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph_name": { "type": "string" } }, "required": [ "graph_name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DevelopmentLaneStatus": { "additionalProperties": false, "description": "Bounded authenticated status page with maintained native counters.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "DevelopmentLaneStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DiffAgainst": { "additionalProperties": false, "properties": { "method": { "const": "DiffAgainst", "type": "string" }, "params": { "additionalProperties": false, "properties": { "other_graph": { "type": "string" } }, "required": [ "other_graph" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DiscountedReturn": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-099 \u2014 the DISCOUNTED return `\u03a3 gamma^t \u00b7 reward` over\ntrajectory `traj_id`'s ordered steps. Read-only, deterministic (`gamma`\ncaller-supplied). Returns `Float` (`0.0` for an absent/empty trajectory).", "properties": { "method": { "const": "DiscountedReturn", "type": "string" }, "params": { "additionalProperties": false, "properties": { "gamma": { "format": "double", "type": "number" }, "traj_id": { "type": "string" } }, "required": [ "traj_id", "gamma" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Discover": { "additionalProperties": false, "description": "CONCEPT:EG-KG.retrieval.one-round-trip-discovery \u2014 one-round-trip hybrid discovery. Given the caller's\nde-duplicated `keywords` plus a `query_embedding`, dense-retrieve candidate\nnodes via the HNSW index (the same batch primitive as `SemanticSearch`),\nthen re-rank each by BOTH its semantic similarity AND lexical keyword\noverlap over its `name`/`description`/`type`, returning the top-`k` with\ntheir human-readable text as `[{id,name,description,type,score}, \u2026]`.\nComplements `SemanticSearch` (which returns bare `(id, score)`): Discover\nfolds the keyword signal in and hydrates the result text in one call, so a\nrouter/orchestrator gets a ready-to-read shortlist without an N+1 metadata\nfetch. An empty `query_embedding` (embedder/vLLM unavailable) degrades to a\nbounded keyword-only scan.", "properties": { "method": { "const": "Discover", "type": "string" }, "params": { "additionalProperties": false, "properties": { "k": { "format": "uint", "minimum": 0, "type": "integer" }, "keywords": { "items": { "type": "string" }, "type": "array" }, "query_embedding": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "keywords", "query_embedding", "k" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DistributedCompute": { "additionalProperties": false, "description": "Run a distributed graph algorithm across `graphs` (each a shard/partition),\nwith `algo` selecting PageRank / ConnectedComponents / Bfs. Result is\n`ResultPayload::Raw` \u2014 `[id, score]` rows for PageRank, `[id, label]` for CC/BFS.", "properties": { "method": { "const": "DistributedCompute", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algo": { "$ref": "#/components/schemas/ReqDef_DistAlgo" }, "graphs": { "items": { "type": "string" }, "type": "array" } }, "required": [ "graphs", "algo" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DropContinuousQuery": { "additionalProperties": false, "description": "Drop a continuous query. Returns `Bool` (true if it existed).", "properties": { "method": { "const": "DropContinuousQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DropNamedGraph": { "additionalProperties": false, "description": "DROP the request's named graph (CONCEPT:EG-KG.query.named-graph-support): physically clear ALL of its RDF\ncontent \u2014 the property-graph nodes/edges AND the lossless multi-valued-literal\nquad-store rows for this graph. DURABLE (WAL-replayed as a clear). The SPARQL\n`DROP/CLEAR GRAPH` op + ontology lifecycle teardown route here. Returns a `Raw`\n`\"ok\"`. Gated `rdf`. (Distinct from `DeleteGraph`, which evicts the registry\nentry; this empties the graph's RDF while keeping the graph addressable.)", "properties": { "method": { "const": "DropNamedGraph", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_DropTrigger": { "additionalProperties": false, "description": "Drop a trigger. Returns `Bool`.", "properties": { "method": { "const": "DropTrigger", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsAdamStep": { "additionalProperties": false, "properties": { "method": { "const": "DsAdamStep", "type": "string" }, "params": { "additionalProperties": false, "properties": { "beta1": { "format": "double", "type": "number" }, "beta2": { "format": "double", "type": "number" }, "eps": { "format": "double", "type": "number" }, "grads": { "items": { "format": "double", "type": "number" }, "type": "array" }, "lr": { "format": "double", "type": "number" }, "m": { "items": { "format": "double", "type": "number" }, "type": "array" }, "params": { "items": { "format": "double", "type": "number" }, "type": "array" }, "t": { "format": "uint64", "minimum": 0, "type": "integer" }, "v": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "params", "grads", "m", "v", "lr", "beta1", "beta2", "eps", "t" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsComputeStats": { "additionalProperties": false, "properties": { "method": { "const": "DsComputeStats", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "data" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsCrossEntropy": { "additionalProperties": false, "properties": { "method": { "const": "DsCrossEntropy", "type": "string" }, "params": { "additionalProperties": false, "properties": { "labels": { "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" }, "logits": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "logits", "labels" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsDpoLoss": { "additionalProperties": false, "properties": { "method": { "const": "DsDpoLoss", "type": "string" }, "params": { "additionalProperties": false, "properties": { "beta": { "format": "double", "type": "number" }, "policy_chosen": { "items": { "format": "double", "type": "number" }, "type": "array" }, "policy_rejected": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ref_chosen": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ref_rejected": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "policy_chosen", "policy_rejected", "ref_chosen", "ref_rejected", "beta" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsFitEstimator": { "additionalProperties": false, "properties": { "method": { "const": "DsFitEstimator", "type": "string" }, "params": { "additionalProperties": false, "properties": { "estimator": { "type": "string" }, "params": { "$ref": "#/components/schemas/ReqDef_EstimatorParams", "default": {} }, "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "estimator", "x", "y" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsGrpoSurrogate": { "additionalProperties": false, "properties": { "method": { "const": "DsGrpoSurrogate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "advantage": { "items": { "format": "double", "type": "number" }, "type": "array" }, "clip_eps": { "format": "double", "type": "number" }, "logprob": { "items": { "format": "double", "type": "number" }, "type": "array" }, "old_logprob": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "logprob", "old_logprob", "advantage", "clip_eps" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsKMeans": { "additionalProperties": false, "properties": { "method": { "const": "DsKMeans", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "k": { "format": "uint", "minimum": 0, "type": "integer" }, "max_iter": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "data", "k", "max_iter" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsKlDivergence": { "additionalProperties": false, "properties": { "method": { "const": "DsKlDivergence", "type": "string" }, "params": { "additionalProperties": false, "properties": { "logprob": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ref_logprob": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "logprob", "ref_logprob" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsLinearRegression": { "additionalProperties": false, "properties": { "method": { "const": "DsLinearRegression", "type": "string" }, "params": { "additionalProperties": false, "properties": { "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "x", "y" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsLogSoftmax": { "additionalProperties": false, "properties": { "method": { "const": "DsLogSoftmax", "type": "string" }, "params": { "additionalProperties": false, "properties": { "logits": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "logits" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsPca": { "additionalProperties": false, "properties": { "method": { "const": "DsPca", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "n_components": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "data", "n_components" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsPredictEstimator": { "additionalProperties": false, "properties": { "method": { "const": "DsPredictEstimator", "type": "string" }, "params": { "additionalProperties": false, "properties": { "model": { "$ref": "#/components/schemas/ReqDef_FittedModel" }, "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "model", "x" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsSgdStep": { "additionalProperties": false, "properties": { "method": { "const": "DsSgdStep", "type": "string" }, "params": { "additionalProperties": false, "properties": { "grads": { "items": { "format": "double", "type": "number" }, "type": "array" }, "lr": { "format": "double", "type": "number" }, "params": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "params", "grads", "lr" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsSoftmax": { "additionalProperties": false, "properties": { "method": { "const": "DsSoftmax", "type": "string" }, "params": { "additionalProperties": false, "properties": { "logits": { "items": { "format": "double", "type": "number" }, "type": "array" }, "temperature": { "format": "double", "type": "number" } }, "required": [ "logits", "temperature" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_DsTrainTestSplit": { "additionalProperties": false, "properties": { "method": { "const": "DsTrainTestSplit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "labels": { "items": { "format": "double", "type": "number" }, "type": "array" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" }, "shuffle": { "type": "boolean" }, "test_ratio": { "format": "double", "type": "number" } }, "required": [ "data", "labels", "test_ratio", "shuffle", "seed" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_EdgeCount": { "additionalProperties": false, "properties": { "method": { "const": "EdgeCount", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_EpistemicStatus": { "additionalProperties": false, "description": "The Phase-3 acceptance capstone (EPI-P3-5, L53): \"what do we believe, why, on\nexactly which evidence, under whose authority, at what time, with what\nuncertainty, and what would invalidate it\" \u2014 for `node_id`, in ONE typed call\n(`eg_epistemic::epistemic_status`, feature `epistemic-tms`). Composes belief\n(`is_believed`/confidence), the proof tree (`why`), the diagnostic (`why_not`,\npopulated iff not believed), the counterfactual (`what_evidence_would_change_this`),\nand this claim's own bitemporal window \u2014 every sibling facet\n`eg_epistemic::query` exposes for ONE claim, so those are not separately wired\nas their own `Method`s (a caller wanting just one gets it off this result).\nReturns an `EpistemicStatusResult` via `ResultPayload::raw`. Gated `epistemic`\nat the wire level; the HANDLER additionally requires `epistemic-tms` \u2014 a build\nwith `epistemic` but not `epistemic-tms` falls to the graph_ops \"not available\nin this build\" catch-all (same convention as every other feature-gated arm).", "properties": { "method": { "const": "EpistemicStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_EvictBelow": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 prune the sub-`threshold`-importance members of the\nworking set `ids`. `delete == false` marks `forgotten` (provenance-preserving);\n`true` hard-removes. Deterministic (no clock). Returns the pruned ids (`Ids`,\nsorted).", "properties": { "method": { "const": "EvictBelow", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delete": { "type": "boolean" }, "ids": { "items": { "type": "string" }, "type": "array" }, "threshold": { "format": "double", "type": "number" } }, "required": [ "ids", "threshold", "delete" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_EvictLRU": { "additionalProperties": false, "properties": { "method": { "const": "EvictLRU", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_nodes": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "max_nodes" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ExplainBelief": { "additionalProperties": false, "description": "`EXPLAIN BELIEF ` \u2014 the FULL, un-flattened E1 justification tree\n(`eg_epistemic::JustificationGraph`, via `eg_plan::explain_belief_tree`) rooted at\n`node_id` \u2014 the standalone verbatim-tree surface E2's plan-`Op::ExplainBelief`\n(a flat `RowSet` projection) documents as a follow-up, mirroring\n`Method::OwlExplain`'s `ProofNodeWire`. Returns an `ExplainBeliefResult` via\n`ResultPayload::raw`. Gated `epistemic` (which implies `query`).\n\n`disclosure_level` (EPI-P3-4, L51) is `None` by default \u2014 the DEFAULT PATH IS\nUNCHANGED: the handler runs the classic un-redacted `explain_belief` and returns\n`ExplainBeliefResult` exactly as before this field existed. When `Some(_)`, the\ncaller opts INTO the policy-aware, RLS-redacted proof\n(`eg_epistemic::redact::explain_belief_redacted`, feature `epistemic-redaction`\non the facade, which pulls `eg-core/security`) \u2014 the handler then returns an\n`ExplainBeliefRedactedResult` INSTEAD of `ExplainBeliefResult` in the SAME\n`ResultPayload::raw` slot (the caller who set this field knows to decode the\nother type). The requested level is a CAP, never a grant: a caller may ask for a\nSTRICTER view than their own RLS access earns (e.g. always request\n`ExistenceOnly` for a privacy-conscious display) but can never loosen what\n`explain_belief_redacted` computes from their actual access \u2014 see\n`eg_epistemic::redact` module docs. If `epistemic-redaction` is OFF at build\ntime, a request naming `Some(_)` gets an explicit error response (never a silent\nfall-back to the un-redacted tree \u2014 that would leak exactly what redaction\nexists to hide).", "properties": { "method": { "const": "ExplainBelief", "type": "string" }, "params": { "additionalProperties": false, "properties": { "disclosure_level": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_DisclosureLevelWire" }, { "type": "null" } ] }, "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ExplainEvidence": { "additionalProperties": false, "description": "X-1 (CONCEPT:EG-X1) \u2014 resolve `node_id`'s cited multimodal evidence: build a\n`BeliefGraph` off the caller's `GraphView` and walk the SAME support/\ncontradiction/attack topology `ExplainBelief` walks, returning every\ntransitively-reachable node that carries one complete governed `EvidenceLocus`\n(page region, audio/video interval, row version, code range, trace span, \u2026).\nThe locus itself carries the opaque subject, policy, and derivation references\n(`eg_epistemic::evidence_citations`, feature `evidence-graph`) \u2014 \"here is\nexactly where in the source this claim's evidence came from.\" Returns an\n`ExplainEvidenceResult` via `ResultPayload::raw`. Gated `epistemic` at the wire\nlevel (implies `query`); the HANDLER additionally requires `evidence-graph` \u2014\na build with `epistemic` but not `evidence-graph` falls to the graph_ops \"not\navailable in this build\" catch-all (same convention as `EpistemicStatus`/\n`epistemic-tms`).", "properties": { "method": { "const": "ExplainEvidence", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ExplainPlan": { "additionalProperties": false, "description": "`EXPLAIN PLAN` \u2014 serialize `plan` as a [`crate::wire::Plan`]::PlanDag conversion\n(a linear plan is a degenerate chain, CONCEPT:EG-KG.query.plan-dag) both BEFORE and\nAFTER the DAG-aware cost optimizer (`eg_plan::optimizer::optimize_dag`), plus the\nactive rule set (`eg_plan::cost_opt_rule_names()`) \u2014 the optimizer rewrite trace.\nReturns an `ExplainPlanResult` via `ResultPayload::raw`. Gated `query` (same as\n`UnifiedQuery`).", "properties": { "method": { "const": "ExplainPlan", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ReqDef_Plan" } }, "required": [ "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ExplainPolicy": { "additionalProperties": false, "description": "`EXPLAIN POLICY` \u2014 run `plan` against BOTH the caller's RLS-filtered snapshot and\nthe UNFILTERED snapshot (reusing the SAME `eg_core::isolation::IsolationLayer`\n`filter_view` every read path already applies), reporting which result rows the\npolicy DENIED. With the `security` feature off (or no caller/RLS configured), no\nfiltering applies and `policy_denied_ids` is always empty. Returns an\n`ExplainPolicyResult` via `ResultPayload::raw`. Gated `query`.", "properties": { "method": { "const": "ExplainPolicy", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ReqDef_Plan" } }, "required": [ "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ExplainProvenance": { "additionalProperties": false, "description": "`EXPLAIN PROVENANCE` \u2014 run `plan` and, for each result row, resolve its\nEVIDENCE-FOR provenance (the SAME belief-substrate `EvidenceFor` resolution E2's\n`Op::EvidenceFor` op runs) over the `KnowledgeSet` (E3) row shape. With the\n`epistemic` feature OFF (or absent at runtime) every row's provenance is empty and\n`resolved` is `false` \u2014 the documented \"no epistemic resolution ran\" behavior E3's\n`KnowledgeSet` already carries (CONCEPT:EG-KG.query.knowledge-set). Returns an\nschema-generated `EvidenceBundle` via `ResultPayload::raw`. Gated `query`.", "properties": { "method": { "const": "ExplainProvenance", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ReqDef_Plan" } }, "required": [ "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ExplainProvenanceByIds": { "additionalProperties": false, "description": "`EXPLAIN PROVENANCE BY IDS` (CONCEPT:EG-KB-CURRENCY) \u2014 the ID-seeded sibling of\n`ExplainProvenance`: skip the `Plan`/`Op` algebra entirely and resolve the SAME\nprotocol evidence claims directly for `ids` \u2014 the\nshape a caller that already has a set of node ids from ANY other read path\n(a Cypher `MATCH`, a SQL `SELECT`, a prior `UnifiedQuery`) needs to \"currency-\nupgrade\" a plain id list into calibrated, cited, time-versioned rows without\nhand-building an `Op` plan first. `ids` is deduplicated, first-occurrence order\npreserved (mirrors `RowSet::from_ids`); an id absent from the graph is silently\nskipped (never fabricated). Returns an `EvidenceBundle` via\n`ResultPayload::raw`, byte-identical in shape to `ExplainProvenance`'s. Gated\n`query` (same as `ExplainProvenance`).", "properties": { "method": { "const": "ExplainProvenanceByIds", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ExportSqliteFile": { "additionalProperties": false, "description": "Export user tables OUT to a fresh, valid `sqlite3` `.db` logical filename `path` that the\n`sqlite3` CLI can open (CONCEPT:EG-KG.query.full-protocol). `tables` empty \u21d2 every user table; else\nexactly the named tables (each must exist). Publication is private and atomic.\nReturns aggregate table counts without a host path.", "properties": { "method": { "const": "ExportSqliteFile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "path": { "type": "string" }, "tables": { "default": [], "items": { "type": "string" }, "type": "array" } }, "required": [ "path" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceAdfTest": { "additionalProperties": false, "properties": { "method": { "const": "FinanceAdfTest", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_lag": { "format": "uint", "minimum": 0, "type": "integer" }, "series": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "series", "max_lag" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceAlphaCombinationEngine": { "additionalProperties": false, "properties": { "method": { "const": "FinanceAlphaCombinationEngine", "type": "string" }, "params": { "additionalProperties": false, "properties": { "lookback": { "format": "uint", "minimum": 0, "type": "integer" }, "returns_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "returns_matrix", "lookback" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceAvellanedaStoikov": { "additionalProperties": false, "properties": { "method": { "const": "FinanceAvellanedaStoikov", "type": "string" }, "params": { "additionalProperties": false, "properties": { "gamma": { "format": "double", "type": "number" }, "inventory": { "format": "double", "type": "number" }, "kappa": { "format": "double", "type": "number" }, "mid": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" }, "tau": { "format": "double", "type": "number" } }, "required": [ "mid", "inventory", "sigma", "gamma", "kappa", "tau" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceBayesianKelly": { "additionalProperties": false, "properties": { "method": { "const": "FinanceBayesianKelly", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "c": { "format": "double", "type": "number" }, "n_quadrature": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "alpha", "beta", "c", "n_quadrature" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceBlackLitterman": { "additionalProperties": false, "properties": { "method": { "const": "FinanceBlackLitterman", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "market_weights": { "items": { "format": "double", "type": "number" }, "type": "array" }, "pick_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "risk_aversion": { "format": "double", "type": "number" }, "tau": { "format": "double", "type": "number" }, "views": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "market_weights", "cov_matrix", "views", "pick_matrix", "tau", "risk_aversion" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceBreakevenAlpha": { "additionalProperties": false, "properties": { "method": { "const": "FinanceBreakevenAlpha", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delta": { "format": "double", "type": "number" }, "p": { "format": "double", "type": "number" }, "v_h": { "format": "double", "type": "number" }, "v_l": { "format": "double", "type": "number" } }, "required": [ "delta", "p", "v_h", "v_l" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceBrierScore": { "additionalProperties": false, "properties": { "method": { "const": "FinanceBrierScore", "type": "string" }, "params": { "additionalProperties": false, "properties": { "forecasts": { "items": { "format": "double", "type": "number" }, "type": "array" }, "outcomes": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "forecasts", "outcomes" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceCombineAlphas": { "additionalProperties": false, "properties": { "method": { "const": "FinanceCombineAlphas", "type": "string" }, "params": { "additionalProperties": false, "properties": { "signals": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "weights": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "signals", "weights" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceConvergenceGate": { "additionalProperties": false, "properties": { "method": { "const": "FinanceConvergenceGate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "min_agree": { "format": "uint", "minimum": 0, "type": "integer" }, "strengths": { "items": { "format": "double", "type": "number" }, "type": "array" }, "strong_threshold": { "format": "double", "type": "number" } }, "required": [ "strengths", "strong_threshold", "min_agree" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceCrossSectionalRank": { "additionalProperties": false, "properties": { "method": { "const": "FinanceCrossSectionalRank", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cross_section": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "cross_section" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceCvar": { "additionalProperties": false, "properties": { "method": { "const": "FinanceCvar", "type": "string" }, "params": { "additionalProperties": false, "properties": { "confidence": { "format": "double", "type": "number" }, "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns", "confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceDeflatedSharpe": { "additionalProperties": false, "properties": { "method": { "const": "FinanceDeflatedSharpe", "type": "string" }, "params": { "additionalProperties": false, "properties": { "n_trials": { "format": "uint", "minimum": 0, "type": "integer" }, "observed_sr": { "format": "double", "type": "number" }, "sr_returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "observed_sr", "n_trials", "sr_returns" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceDetectRegimes": { "additionalProperties": false, "properties": { "method": { "const": "FinanceDetectRegimes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_iter": { "format": "uint", "minimum": 0, "type": "integer" }, "n_states": { "format": "uint", "minimum": 0, "type": "integer" }, "observations": { "items": { "format": "double", "type": "number" }, "type": "array" }, "tol": { "format": "double", "type": "number" } }, "required": [ "observations", "n_states", "max_iter", "tol" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceDieboldMariano": { "additionalProperties": false, "properties": { "method": { "const": "FinanceDieboldMariano", "type": "string" }, "params": { "additionalProperties": false, "properties": { "h": { "format": "uint", "minimum": 0, "type": "integer" }, "losses_a": { "items": { "format": "double", "type": "number" }, "type": "array" }, "losses_b": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "losses_a", "losses_b", "h" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceDownsideDeviation": { "additionalProperties": false, "properties": { "method": { "const": "FinanceDownsideDeviation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "target": { "format": "double", "type": "number" } }, "required": [ "returns", "target" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceDrawdownSeries": { "additionalProperties": false, "properties": { "method": { "const": "FinanceDrawdownSeries", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceEffectiveIndependentN": { "additionalProperties": false, "properties": { "method": { "const": "FinanceEffectiveIndependentN", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "returns_matrix" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceEfficientFrontier": { "additionalProperties": false, "properties": { "method": { "const": "FinanceEfficientFrontier", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "expected_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "target_return": { "format": "double", "type": "number" } }, "required": [ "expected_returns", "cov_matrix", "target_return" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceEmpiricalKelly": { "additionalProperties": false, "properties": { "method": { "const": "FinanceEmpiricalKelly", "type": "string" }, "params": { "additionalProperties": false, "properties": { "b": { "format": "double", "type": "number" }, "historical_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "n_simulations": { "format": "uint", "minimum": 0, "type": "integer" }, "p": { "format": "double", "type": "number" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "p", "b", "historical_returns", "n_simulations", "seed" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceEwma": { "additionalProperties": false, "properties": { "method": { "const": "FinanceEwma", "type": "string" }, "params": { "additionalProperties": false, "properties": { "span": { "format": "uint", "minimum": 0, "type": "integer" }, "values": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "values", "span" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceExpectedPnlRate": { "additionalProperties": false, "properties": { "method": { "const": "FinanceExpectedPnlRate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "a": { "format": "double", "type": "number" }, "alpha": { "format": "double", "type": "number" }, "delta": { "format": "double", "type": "number" }, "kappa": { "format": "double", "type": "number" }, "p": { "format": "double", "type": "number" }, "v_h": { "format": "double", "type": "number" }, "v_l": { "format": "double", "type": "number" } }, "required": [ "delta", "a", "kappa", "alpha", "p", "v_h", "v_l" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceForensicReport": { "additionalProperties": false, "properties": { "method": { "const": "FinanceForensicReport", "type": "string" }, "params": { "additionalProperties": false, "properties": { "prior_year": { "$ref": "#/components/schemas/ReqDef_YearData" }, "this_year": { "$ref": "#/components/schemas/ReqDef_YearData" } }, "required": [ "this_year", "prior_year" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceGlostenMilgromSpread": { "additionalProperties": false, "properties": { "method": { "const": "FinanceGlostenMilgromSpread", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "p": { "format": "double", "type": "number" } }, "required": [ "alpha", "p" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceGltQuotes": { "additionalProperties": false, "properties": { "method": { "const": "FinanceGltQuotes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "a": { "format": "double", "type": "number" }, "gamma": { "format": "double", "type": "number" }, "inventory": { "format": "double", "type": "number" }, "kappa": { "format": "double", "type": "number" }, "mid": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" } }, "required": [ "mid", "inventory", "sigma", "gamma", "kappa", "a" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceHardimanBouchaud": { "additionalProperties": false, "properties": { "method": { "const": "FinanceHardimanBouchaud", "type": "string" }, "params": { "additionalProperties": false, "properties": { "n_windows": { "format": "uint", "minimum": 0, "type": "integer" }, "t_horizon": { "format": "double", "type": "number" }, "times": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "times", "t_horizon", "n_windows" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceHawkesMle": { "additionalProperties": false, "properties": { "method": { "const": "FinanceHawkesMle", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_iter": { "format": "uint", "minimum": 0, "type": "integer" }, "t_horizon": { "format": "double", "type": "number" }, "times": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "times", "t_horizon", "max_iter" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceInformationCoefficient": { "additionalProperties": false, "properties": { "method": { "const": "FinanceInformationCoefficient", "type": "string" }, "params": { "additionalProperties": false, "properties": { "forward_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "signal": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "signal", "forward_returns" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceInformationRatio": { "additionalProperties": false, "properties": { "method": { "const": "FinanceInformationRatio", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ic": { "format": "double", "type": "number" }, "n_independent": { "format": "double", "type": "number" } }, "required": [ "ic", "n_independent" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceKalmanBeta": { "additionalProperties": false, "properties": { "method": { "const": "FinanceKalmanBeta", "type": "string" }, "params": { "additionalProperties": false, "properties": { "asset_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "beta0": { "format": "double", "type": "number" }, "market_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "p0": { "format": "double", "type": "number" }, "q": { "format": "double", "type": "number" }, "r": { "format": "double", "type": "number" } }, "required": [ "market_returns", "asset_returns", "q", "r", "beta0", "p0" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceKalmanFilter1d": { "additionalProperties": false, "properties": { "method": { "const": "FinanceKalmanFilter1d", "type": "string" }, "params": { "additionalProperties": false, "properties": { "f": { "format": "double", "type": "number" }, "h": { "format": "double", "type": "number" }, "observations": { "items": { "format": "double", "type": "number" }, "type": "array" }, "p0": { "format": "double", "type": "number" }, "q": { "format": "double", "type": "number" }, "r": { "format": "double", "type": "number" }, "x0": { "format": "double", "type": "number" } }, "required": [ "observations", "f", "q", "h", "r", "x0", "p0" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceKalmanVolatility": { "additionalProperties": false, "properties": { "method": { "const": "FinanceKalmanVolatility", "type": "string" }, "params": { "additionalProperties": false, "properties": { "annualization": { "format": "double", "type": "number" }, "log_var0": { "format": "double", "type": [ "number", "null" ] }, "p0": { "format": "double", "type": "number" }, "q": { "format": "double", "type": "number" }, "r": { "format": "double", "type": "number" }, "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns", "q", "r", "p0", "annualization" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceKellyFraction": { "additionalProperties": false, "properties": { "method": { "const": "FinanceKellyFraction", "type": "string" }, "params": { "additionalProperties": false, "properties": { "c": { "format": "double", "type": "number" }, "fraction": { "format": "double", "type": "number" }, "q": { "format": "double", "type": "number" } }, "required": [ "q", "c", "fraction" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceKyleLambda": { "additionalProperties": false, "properties": { "method": { "const": "FinanceKyleLambda", "type": "string" }, "params": { "additionalProperties": false, "properties": { "price_changes": { "items": { "format": "double", "type": "number" }, "type": "array" }, "signed_order_flow": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "price_changes", "signed_order_flow" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceLogitQuotes": { "additionalProperties": false, "properties": { "method": { "const": "FinanceLogitQuotes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "boundary_m": { "format": "double", "type": "number" }, "gamma": { "format": "double", "type": "number" }, "inventory": { "format": "double", "type": "number" }, "kappa": { "format": "double", "type": "number" }, "p_mid": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" }, "tau": { "format": "double", "type": "number" } }, "required": [ "p_mid", "inventory", "sigma", "gamma", "kappa", "tau", "boundary_m" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceMarketImpact": { "additionalProperties": false, "properties": { "method": { "const": "FinanceMarketImpact", "type": "string" }, "params": { "additionalProperties": false, "properties": { "average_daily_volume": { "format": "double", "type": "number" }, "daily_volatility": { "format": "double", "type": "number" }, "impact_coefficient": { "format": "double", "type": "number" }, "order_quantity": { "format": "double", "type": "number" } }, "required": [ "daily_volatility", "order_quantity", "average_daily_volume", "impact_coefficient" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceMarkovTransitionMatrix": { "additionalProperties": false, "properties": { "method": { "const": "FinanceMarkovTransitionMatrix", "type": "string" }, "params": { "additionalProperties": false, "properties": { "n_states": { "format": "uint", "minimum": 0, "type": "integer" }, "states": { "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "states", "n_states" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceMatchOrders": { "additionalProperties": false, "properties": { "method": { "const": "FinanceMatchOrders", "type": "string" }, "params": { "additionalProperties": false, "properties": { "orders": { "items": { "$ref": "#/components/schemas/ReqDef_Order" }, "type": "array" } }, "required": [ "orders" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceMaxDrawdown": { "additionalProperties": false, "properties": { "method": { "const": "FinanceMaxDrawdown", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceMeanReversion": { "additionalProperties": false, "properties": { "method": { "const": "FinanceMeanReversion", "type": "string" }, "params": { "additionalProperties": false, "properties": { "values": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "values", "window" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceMicropriceSeries": { "additionalProperties": false, "properties": { "method": { "const": "FinanceMicropriceSeries", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ask_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ask_sz": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_sz": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "bid_px", "bid_sz", "ask_px", "ask_sz" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceMomentum": { "additionalProperties": false, "properties": { "method": { "const": "FinanceMomentum", "type": "string" }, "params": { "additionalProperties": false, "properties": { "lookback": { "format": "uint", "minimum": 0, "type": "integer" }, "prices": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "prices", "lookback" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceMonteCarloVar": { "additionalProperties": false, "properties": { "method": { "const": "FinanceMonteCarloVar", "type": "string" }, "params": { "additionalProperties": false, "properties": { "confidence": { "format": "double", "type": "number" }, "mean": { "format": "double", "type": "number" }, "n_simulations": { "format": "uint", "minimum": 0, "type": "integer" }, "std_dev": { "format": "double", "type": "number" } }, "required": [ "mean", "std_dev", "n_simulations", "confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceOfiSeries": { "additionalProperties": false, "properties": { "method": { "const": "FinanceOfiSeries", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ask_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ask_sz": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_sz": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ts": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window_secs": { "format": "double", "type": "number" } }, "required": [ "ts", "bid_px", "bid_sz", "ask_px", "ask_sz", "window_secs" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceOptimizePortfolio": { "additionalProperties": false, "properties": { "method": { "const": "FinanceOptimizePortfolio", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "expected_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "max_weight": { "format": "double", "type": [ "number", "null" ] }, "min_weight": { "format": "double", "type": [ "number", "null" ] }, "risk_free_rate": { "format": "double", "type": "number" } }, "required": [ "expected_returns", "cov_matrix", "risk_free_rate" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceOrderBookImbalance": { "additionalProperties": false, "properties": { "method": { "const": "FinanceOrderBookImbalance", "type": "string" }, "params": { "additionalProperties": false, "properties": { "v_ask": { "items": { "format": "double", "type": "number" }, "type": "array" }, "v_bid": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "v_bid", "v_ask" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceOuCalibrate": { "additionalProperties": false, "properties": { "method": { "const": "FinanceOuCalibrate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "dt": { "format": "double", "type": "number" }, "spread": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "spread", "dt" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceOuOptimalThresholds": { "additionalProperties": false, "properties": { "method": { "const": "FinanceOuOptimalThresholds", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cost": { "format": "double", "type": "number" }, "mu": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" }, "sigma_eq": { "format": "double", "type": "number" }, "theta": { "format": "double", "type": "number" } }, "required": [ "theta", "mu", "sigma", "sigma_eq", "cost" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinancePairsTrading": { "additionalProperties": false, "properties": { "method": { "const": "FinancePairsTrading", "type": "string" }, "params": { "additionalProperties": false, "properties": { "lookback": { "format": "uint", "minimum": 0, "type": "integer" }, "prices_a": { "items": { "format": "double", "type": "number" }, "type": "array" }, "prices_b": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "prices_a", "prices_b", "lookback" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinancePosteriorCredibleInterval": { "additionalProperties": false, "properties": { "method": { "const": "FinancePosteriorCredibleInterval", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "level": { "format": "double", "type": "number" } }, "required": [ "alpha", "beta", "level" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceProbabilityBacktestOverfit": { "additionalProperties": false, "properties": { "method": { "const": "FinanceProbabilityBacktestOverfit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "insample": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "oos": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "insample", "oos" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinancePurgedCpcv": { "additionalProperties": false, "properties": { "method": { "const": "FinancePurgedCpcv", "type": "string" }, "params": { "additionalProperties": false, "properties": { "embargo": { "format": "uint", "minimum": 0, "type": "integer" }, "n_groups": { "format": "uint", "minimum": 0, "type": "integer" }, "n_samples": { "format": "uint", "minimum": 0, "type": "integer" }, "n_test_groups": { "format": "uint", "minimum": 0, "type": "integer" }, "purge_window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "n_samples", "n_groups", "n_test_groups", "purge_window", "embargo" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceQueueImbalance": { "additionalProperties": false, "properties": { "method": { "const": "FinanceQueueImbalance", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ask_q": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ask_rate": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_q": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_rate": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "bid_q", "ask_q", "bid_rate", "ask_rate" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceRealizedVolTick": { "additionalProperties": false, "properties": { "method": { "const": "FinanceRealizedVolTick", "type": "string" }, "params": { "additionalProperties": false, "properties": { "mid": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "mid", "window" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceRiskMetrics": { "additionalProperties": false, "properties": { "method": { "const": "FinanceRiskMetrics", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "risk_free_rate": { "format": "double", "type": "number" } }, "required": [ "returns", "risk_free_rate" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceRiskParity": { "additionalProperties": false, "properties": { "method": { "const": "FinanceRiskParity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "cov_matrix" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceRollingZscore": { "additionalProperties": false, "properties": { "method": { "const": "FinanceRollingZscore", "type": "string" }, "params": { "additionalProperties": false, "properties": { "values": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "values", "window" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceSabrCalibrate": { "additionalProperties": false, "properties": { "method": { "const": "FinanceSabrCalibrate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "beta": { "format": "double", "type": "number" }, "f": { "format": "double", "type": "number" }, "market_vols": { "items": { "format": "double", "type": "number" }, "type": "array" }, "strikes": { "items": { "format": "double", "type": "number" }, "type": "array" }, "t": { "format": "double", "type": "number" } }, "required": [ "f", "t", "strikes", "market_vols", "beta" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceSabrImpliedVol": { "additionalProperties": false, "properties": { "method": { "const": "FinanceSabrImpliedVol", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "f": { "format": "double", "type": "number" }, "k": { "format": "double", "type": "number" }, "nu": { "format": "double", "type": "number" }, "rho": { "format": "double", "type": "number" }, "t": { "format": "double", "type": "number" } }, "required": [ "f", "k", "t", "alpha", "beta", "rho", "nu" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceSabrSmile": { "additionalProperties": false, "properties": { "method": { "const": "FinanceSabrSmile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "f": { "format": "double", "type": "number" }, "nu": { "format": "double", "type": "number" }, "rho": { "format": "double", "type": "number" }, "strikes": { "items": { "format": "double", "type": "number" }, "type": "array" }, "t": { "format": "double", "type": "number" } }, "required": [ "f", "strikes", "t", "alpha", "beta", "rho", "nu" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceSignalDecay": { "additionalProperties": false, "properties": { "method": { "const": "FinanceSignalDecay", "type": "string" }, "params": { "additionalProperties": false, "properties": { "half_life": { "format": "double", "type": "number" }, "signal": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "signal", "half_life" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceSpreadReversion": { "additionalProperties": false, "properties": { "method": { "const": "FinanceSpreadReversion", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ask_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "bid_px", "ask_px", "window" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceStressTest": { "additionalProperties": false, "properties": { "method": { "const": "FinanceStressTest", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "expected_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "shock_factors": { "items": { "format": "double", "type": "number" }, "type": "array" }, "weights": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "weights", "expected_returns", "cov_matrix", "shock_factors" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceSurveillanceRisk": { "additionalProperties": false, "properties": { "method": { "const": "FinanceSurveillanceRisk", "type": "string" }, "params": { "additionalProperties": false, "properties": { "baseline_sigma": { "format": "double", "type": "number" }, "buy_vol": { "items": { "format": "double", "type": "number" }, "type": "array" }, "p_mean": { "items": { "format": "double", "type": "number" }, "type": "array" }, "price_changes": { "items": { "format": "double", "type": "number" }, "type": "array" }, "sell_vol": { "items": { "format": "double", "type": "number" }, "type": "array" }, "signed_flow": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "buy_vol", "sell_vol", "p_mean", "signed_flow", "price_changes", "baseline_sigma" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceTwap": { "additionalProperties": false, "properties": { "method": { "const": "FinanceTwap", "type": "string" }, "params": { "additionalProperties": false, "properties": { "interval_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "n_slices": { "format": "uint", "minimum": 0, "type": "integer" }, "start_time": { "format": "uint64", "minimum": 0, "type": "integer" }, "total_quantity": { "format": "double", "type": "number" } }, "required": [ "total_quantity", "n_slices", "start_time", "interval_secs" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceVar": { "additionalProperties": false, "properties": { "method": { "const": "FinanceVar", "type": "string" }, "params": { "additionalProperties": false, "properties": { "confidence": { "format": "double", "type": "number" }, "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns", "confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceVpinPm": { "additionalProperties": false, "properties": { "method": { "const": "FinanceVpinPm", "type": "string" }, "params": { "additionalProperties": false, "properties": { "buy_vol": { "items": { "format": "double", "type": "number" }, "type": "array" }, "p_mean": { "items": { "format": "double", "type": "number" }, "type": "array" }, "sell_vol": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "buy_vol", "sell_vol", "p_mean" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FinanceVwap": { "additionalProperties": false, "properties": { "method": { "const": "FinanceVwap", "type": "string" }, "params": { "additionalProperties": false, "properties": { "interval_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "start_time": { "format": "uint64", "minimum": 0, "type": "integer" }, "total_quantity": { "format": "double", "type": "number" }, "volume_profile": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "total_quantity", "volume_profile", "start_time", "interval_secs" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FindCycle": { "additionalProperties": false, "properties": { "method": { "const": "FindCycle", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_FinishDevelopmentLane": { "additionalProperties": false, "description": "Release active-count charge after the exact lifecycle WorkItem reaches a\nterminal state while retaining disk/exclusivity until cleanup.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "FinishDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneFinishRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FiredTriggers": { "additionalProperties": false, "description": "Poll the fired-trigger log for `graph` from cursor `from_seq` (CONCEPT:EG-KG.query.wire-codec):\nthe reactions that fired since the cursor. Returns a `Raw` `FiredTriggersResult`\n(B-8 follow-up, 2026-08-13: `{fired, gap, watermark, head_seq, epoch}` \u2014 the\nfired-trigger log is a second bounded ring with the identical ephemerality as\nthe CDC ring `CdcRead` reads; see `CdcReadResult`'s doc); the consumer\ndispatches each action then resumes from `last.fire_seq + 1`, and MUST check\n`gap` before treating an empty `fired` as \"caught up\".", "properties": { "method": { "const": "FiredTriggers", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from_seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "limit": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_seq" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_FleetCatalog": { "additionalProperties": false, "description": "The fleet catalog (EH-345): the server registry's discovery\nobservations and operator overrides, plus ONE read projection that joins\nthem with the `AgentComponent` records connector packs publish. Not a\nsecond catalog: tools, prompts, resources and skills stay\n`AgentComponent`s and servers stay `:Server` rows; this op family records\nwhich principal observed which connector, and reads the join. Writes\nself-translate into `CreateNodeIfAbsent`/`CompareAndSetNodeFields`\nagainst `__commons__`; reads never take a request graph. Tenant and\nprincipal come only from the verified request context.", "properties": { "method": { "const": "FleetCatalog", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_FleetCatalogOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Fork": { "additionalProperties": false, "properties": { "method": { "const": "Fork", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_FromMsgpack": { "additionalProperties": false, "properties": { "method": { "const": "FromMsgpack", "type": "string" }, "params": { "additionalProperties": false, "properties": { "msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetBlastRadius": { "additionalProperties": false, "properties": { "method": { "const": "GetBlastRadius", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_depth": { "format": "uint", "minimum": 0, "type": "integer" }, "node_id": { "type": "string" } }, "required": [ "node_id", "max_depth" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetChangeCursor": { "additionalProperties": false, "description": "Read the current typed source cursor. Cursors are partition scoped and are\nnever compared as strings.", "properties": { "method": { "const": "GetChangeCursor", "type": "string" }, "params": { "additionalProperties": false, "properties": { "partition": { "default": "", "type": "string" }, "source": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "source", "tenant" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetChangeEnvelope": { "additionalProperties": false, "description": "Read a committed envelope by stable identity for retry reconciliation.", "properties": { "method": { "const": "GetChangeEnvelope", "type": "string" }, "params": { "additionalProperties": false, "properties": { "envelope_id": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "envelope_id", "tenant" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetChannelMembers": { "additionalProperties": false, "properties": { "method": { "const": "GetChannelMembers", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" } }, "required": [ "channel_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetChannelMessages": { "additionalProperties": false, "properties": { "method": { "const": "GetChannelMessages", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "limit": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "channel_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetContentVersion": { "additionalProperties": false, "description": "Read the current typed content version for an object in this graph/tenant.", "properties": { "method": { "const": "GetContentVersion", "type": "string" }, "params": { "additionalProperties": false, "properties": { "object_id": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "object_id", "tenant" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetContextView": { "additionalProperties": false, "properties": { "method": { "const": "GetContextView", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "max_tokens": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "agent_id", "max_tokens" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetControlLease": { "additionalProperties": false, "description": "The caller's view of one control lease, or `null` when no lease with\nthis id is visible to `tenant` (which must equal the verified tenant).", "properties": { "method": { "const": "GetControlLease", "type": "string" }, "params": { "additionalProperties": false, "properties": { "lease_id": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "tenant", "lease_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetEdgeProperties": { "additionalProperties": false, "properties": { "method": { "const": "GetEdgeProperties", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetEdgePropertiesBatch": { "additionalProperties": false, "description": "Batch edge property read: `Raw` list of `properties_msgpack | nil` in input\norder (nil \u21d2 no such edge). Bounded by `MAX_BATCH_IDS`.", "properties": { "method": { "const": "GetEdgePropertiesBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "edges": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" } }, "required": [ "edges" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetEdges": { "additionalProperties": false, "properties": { "method": { "const": "GetEdges", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_GetEdgesPage": { "additionalProperties": false, "description": "Keyset-bounded edge fetch \u2014 the edge sibling of `GetNodesByLabel`. Return\nat most `limit` edges ordered by `(source, target, ordinal)`; `ordinal`\ndistinguishes parallel edges stored under the same `(source, target)`\npair (CONCEPT:EG-KG.ingest.resets-socket-so-assimilation). `after` is an exclusive `(source, target,\nordinal)` cursor (`None` starts at the first edge); callers advance it to\nthe last row returned. `limit == 0` means no cap. Unlike `GetEdges`\n(which materializes the WHOLE graph), this bounds the wire payload to\n`limit`, so a full edge walk no longer trips the `RESULT_TOO_LARGE`\noverload guard. Returns a `Raw`-encoded `Vec<(String, String, u32,\nVec)>` (source, target, ordinal, properties_msgpack).", "properties": { "method": { "const": "GetEdgesPage", "type": "string" }, "params": { "additionalProperties": false, "properties": { "after": { "default": null, "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "uint32", "minimum": 0, "type": "integer" } ], "type": [ "array", "null" ] }, "limit": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetIdentity": { "additionalProperties": false, "description": "Read back one principal's currently-registered identity (CONCEPT:EG-KG.compute.feature).\n`RegisterIdentity` REPLACES an agent's whole role set on every call -- there is no\nmerge -- so a caller that wants to ADD a role without silently dropping one already\ngranted by a prior admission pass must read the current set back first; this closes\nthat gap. The handler returns `Option` (`eg_types::acl::AgentIdentity`):\n`None` means \"no identity registered for `agent_id`\" (unknown), which callers MUST\nkeep distinct from `Some(identity)` carrying an empty `roles` Vec (registered,\nCONFIRMED to hold no roles) -- conflating the two would reintroduce the exact\nblind-upsert ambiguity this RPC exists to eliminate. Gated `security:admin`, the same\nscope `RegisterIdentity` already requires, so this grants no new privilege to anyone\nwho could not already call `RegisterIdentity`.", "properties": { "method": { "const": "GetIdentity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" } }, "required": [ "agent_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetLedger": { "additionalProperties": false, "properties": { "method": { "const": "GetLedger", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_GetMatView": { "additionalProperties": false, "description": "Read a materialized view's current rows by name (`ResultPayload::Raw`).", "properties": { "method": { "const": "GetMatView", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetNeighbors": { "additionalProperties": false, "properties": { "method": { "const": "GetNeighbors", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetNeighborsBatch": { "additionalProperties": false, "description": "Batch neighbor read: fetch neighbor ids for many nodes in ONE round-trip\ninstead of N `GetNeighbors` calls (D-DPF-1 \u2014 the N+1 this closes). Returns\na `Raw` list of `[node_id, Vec]` in input order; a missing/absent\nnode yields an empty neighbor list rather than failing the whole batch, so\none bad id in a large discover-then-hydrate batch cannot sink the rest.\nBounded by `MAX_BATCH_IDS`.", "properties": { "method": { "const": "GetNeighborsBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetNodeProperties": { "additionalProperties": false, "properties": { "method": { "const": "GetNodeProperties", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetNodePropertiesBatch": { "additionalProperties": false, "description": "Batch property read: fetch properties for many nodes in ONE round-trip\ninstead of N `GetNodeProperties` calls. Returns a `Raw` list of\n`[node_id, properties_msgpack | nil]` in input order (nil \u21d2 absent), so the\ncaller learns which ids were missing. Bounded by `MAX_BATCH_IDS`.", "properties": { "method": { "const": "GetNodePropertiesBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetNodes": { "additionalProperties": false, "properties": { "method": { "const": "GetNodes", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_GetNodesByLabel": { "additionalProperties": false, "description": "Labeled + keyset-bounded node fetch: return at most `limit` nodes whose\n`type`/`label`/`labels` matches `label`, ordered by node id. `after` is an\nexclusive node-id cursor (`None` starts at the first id); callers advance\nit to the last id returned. `limit == 0` means no cap. Unlike\n`GetNodes` (which materializes the WHOLE graph), this bounds the wire\npayload to `limit`, so a `MATCH (n:Label) \u2026 LIMIT k` no longer pulls every\nnode's properties off the engine. (CONCEPT:EG-KG.txn.per-graph-write-isolation)\n\nAn empty `label` (CONCEPT:EG-KG.query.unlabeled-scan-limit-pushdown) means \"no label filter\" \u2014 a bounded scan\nof the whole node store, still honouring `limit`. Use this for an\nunlabeled `MATCH (n) \u2026 LIMIT k`: it stays bounded instead of falling back\nto `GetNodes`, which trips the `RESULT_TOO_LARGE` overload guard even when\nthe caller only wanted `k` rows.", "properties": { "method": { "const": "GetNodesByLabel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "after": { "default": null, "type": [ "string", "null" ] }, "label": { "type": "string" }, "limit": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "label", "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetPredecessors": { "additionalProperties": false, "properties": { "method": { "const": "GetPredecessors", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetRdf": { "additionalProperties": false, "description": "Serialize the request's graph back OUT to RDF as N-Triples (CONCEPT:EG-KG.ontology.kg-native-rdf-sparql).\nReturns a `Raw` `String` (the canonical, order-independent form) \u2014 the\ndatatype/lang-faithful inverse of `AddTriples`. Read-only.", "properties": { "method": { "const": "GetRdf", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_GetShortestPath": { "additionalProperties": false, "properties": { "method": { "const": "GetShortestPath", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetSubgraph": { "additionalProperties": false, "properties": { "method": { "const": "GetSubgraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetSuccessors": { "additionalProperties": false, "properties": { "method": { "const": "GetSuccessors", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetWorkItem": { "additionalProperties": false, "description": "The caller's view of one native WorkItem row, or `null` when no row with\nthis id is visible to `tenant`. `tenant` must equal the verified request\ntenant (`ACCESS_DENIED` otherwise); lease owner, epoch and fencing token\nare never returned. See [`crate::work_item_read`].", "properties": { "method": { "const": "GetWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "tenant": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "tenant", "work_item_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GetWorkItemOutcome": { "additionalProperties": false, "description": "A terminal WorkItem of `tenant` and the provenance (RunTrace /\nToolCall refs and the verified OutcomeEvaluation receipt) its native\n`CommitWorkItemResult { outcome_extension }` bound, or `null` when the\nitem is not visible or carries no committed outcome (graph-os EG-3).", "properties": { "method": { "const": "GetWorkItemOutcome", "type": "string" }, "params": { "additionalProperties": false, "properties": { "tenant": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "tenant", "work_item_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GraphColoring": { "additionalProperties": false, "properties": { "method": { "const": "GraphColoring", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_GraphLearnFit": { "additionalProperties": false, "properties": { "method": { "const": "GraphLearnFit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "params": { "$ref": "#/components/schemas/ReqDef_GraphLearnParams", "default": { "alpha": 0.5, "basis": "chebyshev", "degree": 4, "epochs": 200, "hidden": 0, "lr": 0.05, "neg_ratio": 1.0, "seed": 42 }, "description": "Training + architecture knobs (all defaulted)." }, "source": { "$ref": "#/components/schemas/ReqDef_GraphSource", "description": "The graph-derived subgraph to learn over (node label + relation/direction)." }, "writeback": { "default": false, "description": "Materialize the learned per-feature `:EdgeFunction` nodes (a graph write).", "type": "boolean" } }, "required": [ "source" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GraphLearnPredict": { "additionalProperties": false, "properties": { "method": { "const": "GraphLearnPredict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "candidate_pairs": { "default": [], "description": "Explicit candidate pairs `(src, dst)` to score. Empty \u21d2 score the top-k\nhighest-probability MISSING links across the subgraph.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "model": { "description": "A fitted `KanLinkModel` blob (as returned by `GraphLearnFit`)." }, "source": { "$ref": "#/components/schemas/ReqDef_GraphSource", "description": "The subgraph providing the structural features (usually the same source)." }, "top_k": { "default": 50, "description": "Cap on returned predictions (0 \u21d2 uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "writeback": { "default": false, "description": "Materialize each scored pair as a typed `:PredictedEdge` node (a graph write).", "type": "boolean" } }, "required": [ "model", "source" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GraphQl": { "additionalProperties": false, "properties": { "method": { "const": "GraphQl", "type": "string" }, "params": { "additionalProperties": false, "properties": { "query": { "type": "string" }, "variables": { "description": "Optional GraphQL `$variables` \u2014 a JSON object bound at execution\n(CONCEPT:EG-KG.query.fragments-variables-directives variables, wired through the wire path as an EG-064\nfollow-up). The handler binds these via `execute_with_variables`\n(`@skip`/`@include` + `$var` args). `None` is encoded explicitly and means\nan empty binding." } }, "required": [ "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GraphSchema": { "additionalProperties": false, "description": "Attach, replace or detach one keyed schema source on the request graph.", "properties": { "method": { "const": "GraphSchema", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_GraphSchemaOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_GraphSchemaList": { "additionalProperties": false, "description": "List the request graph's schema sources and its composed digest.", "properties": { "method": { "const": "GraphSchemaList", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_HasEdge": { "additionalProperties": false, "properties": { "method": { "const": "HasEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_HasNode": { "additionalProperties": false, "properties": { "method": { "const": "HasNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_HasNodesBatch": { "additionalProperties": false, "description": "Batch existence check: `Raw` list of bools in input order.", "properties": { "method": { "const": "HasNodesBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Health": { "additionalProperties": false, "properties": { "method": { "const": "Health", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_IcvConfigure": { "additionalProperties": false, "description": "X5-enforce (CONCEPT:EG-KG.ontology.rdf-update-guard) \u2014 (re)register a graph's\nSHACL shapes as WRITE-TIME closed-world integrity constraints (ICV, reusing\n`eg-shacl`'s existing `IcvPolicyRegistry`/`WriteGuard` verbatim \u2014 no new\nvalidator). The required `mode` value is `\"enforce\"`: a violating change ABORTS the\n`AddTriples`/`RemoveTriples`/`ApplyMutation` commit with the introduced\nviolations, each carrying its SPARQL witness). `graph` names the target graph;\n`None` sets the DEFAULT-graph policy. `shapes` is the SHACL shapes Turtle\ndocument \u2014 e.g. the SHACL a connector-manifest compiler emits alongside its\nRLS/ABAC policy output (agent-utilities side) and must be non-empty. Like `ShaclValidate`,\nthis variant is UNCONDITIONAL in the enum; the HANDLER is gated `shacl` \u2014 a\nbuild without it drops the handler arm and the request falls through to the\ndispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "IcvConfigure", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "mode": { "type": "string" }, "shapes": { "type": "string" } }, "required": [ "mode", "shapes" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ImportSqliteFile": { "additionalProperties": false, "description": "Import every user table (+ its rows) from logical `.db` filename `path`\ninto the engine's user-table store (CONCEPT:EG-KG.query.eg-feature). A table that already exists\nis REPLACED (drop-then-recreate) so the import mirrors the file. Returns a `Json`\nreport `{\"source\":\"sqlite\", \"imported_tables\":[{\"table\",\"rows\"},\u2026]}`.", "properties": { "method": { "const": "ImportSqliteFile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "path": { "type": "string" } }, "required": [ "path" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_InDegree": { "additionalProperties": false, "properties": { "method": { "const": "InDegree", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_IndexRepository": { "additionalProperties": false, "description": "Parse a batch AND resolve cross-file call/import edges in one round-trip\n(CONCEPT:EG-KG.compute.turn-each-project). The blob is the same MessagePack `Vec<(file_path,\nsource_bytes)>` as `ParseFiles`, but the batch is treated as one\nresolution scope (a repository, or a delta set): the response is a SINGLE\nresolved `IndexResult` whose `calls`/`depends_on` edges point at real node\nids, not bare names. Its ordered `file_outcomes` preserve success,\nunsupported, and error dispositions plus content/parser-capability\ndigests for every submitted file. Use this (not `ParseFiles`) to ingest a\nrepo's symbol graph; use `ParseFiles` only when per-file raw results are\nwanted.", "properties": { "method": { "const": "IndexRepository", "type": "string" }, "params": { "additionalProperties": false, "properties": { "files_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "files_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_InvalidateEdge": { "additionalProperties": false, "description": "Non-destructively CLOSE a contradicted edge's temporal windows (KG-2.251):\nsets `valid_until = invalid_at` and `tx_to = tx_now` on the matching edge\ninstead of deleting it, so an `AS OF` before `invalid_at` still sees the fact.\nA durable mutation (WAL-replayed deterministically from its explicit args).", "properties": { "method": { "const": "InvalidateEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "invalid_at": { "format": "uint64", "minimum": 0, "type": "integer" }, "relationship": { "type": "string" }, "source_id": { "type": "string" }, "target_id": { "type": "string" }, "tx_now": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source_id", "target_id", "relationship", "invalid_at", "tx_now" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_IssueControlLease": { "additionalProperties": false, "description": "Issue one active control lease: an immutable, time-boxed grant record.\nA row already holding the id answers `collision` and is left untouched.\n`request.tenant` must equal the verified request tenant. See\n[`crate::control_lease`].", "properties": { "method": { "const": "IssueControlLease", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_IssueControlLeaseRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_JoinChannel": { "additionalProperties": false, "properties": { "method": { "const": "JoinChannel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "channel_id": { "type": "string" } }, "required": [ "channel_id", "agent_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_KgDelegate": { "additionalProperties": false, "description": "Authenticate and lower an Agent Library delegation through the native\nWorkItem admission command log. The retained library entry is resolved\nby the library owner at the handler boundary.", "properties": { "method": { "const": "KgDelegate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_KgDelegateRequest", "description": "Boxed: a pinned delegation request carries the whole Agent Library\nentry reference and would otherwise set the size of EVERY `Method`.\n`Box` is transparent to serde, so the wire form is unchanged." } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_KnowledgeStream": { "additionalProperties": false, "description": "Pull one bounded Arrow `KnowledgeBatch` from any served query family.\n`cursor=None` opens a snapshot; passing the returned cursor resumes only\nwhen authority, graph snapshot, query, schema and batch size still match.\nThis is the sole native result contract and returns bounded Arrow IPC.", "properties": { "method": { "const": "KnowledgeStream", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_KnowledgeStreamRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_KvCas": { "additionalProperties": false, "description": "Atomic compare-and-swap: set `(namespace, key)` to `new` (`None` \u21d2 delete) iff\nthe current value equals `expected` (both absent \u21d2 the key must not exist).\nReturns whether the swap happened. `expected`/`new` are MessagePack `bin`.", "properties": { "method": { "const": "KvCas", "type": "string" }, "params": { "additionalProperties": false, "properties": { "expected": { "default": null, "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "key": { "type": "string" }, "namespace": { "type": "string" }, "new": { "default": null, "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "namespace", "key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_KvDelete": { "additionalProperties": false, "description": "Delete `(namespace, key)`; returns whether the key existed.", "properties": { "method": { "const": "KvDelete", "type": "string" }, "params": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "namespace": { "type": "string" } }, "required": [ "namespace", "key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_KvGet": { "additionalProperties": false, "description": "Fetch the value bytes at `(namespace, key)`; result is the bytes or null.", "properties": { "method": { "const": "KvGet", "type": "string" }, "params": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "namespace": { "type": "string" } }, "required": [ "namespace", "key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_KvPut": { "additionalProperties": false, "description": "Store `value` at `(namespace, key)` (overwrite). Durable commit-before-ack.\n`value` is a MessagePack `bin` (serde_bytes) \u2014 opaque bytes, stored verbatim.", "properties": { "method": { "const": "KvPut", "type": "string" }, "params": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "namespace": { "type": "string" }, "value": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "namespace", "key", "value" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_KvScan": { "additionalProperties": false, "description": "Ordered `(key, value)` pairs in `namespace` whose key starts with `prefix`\n(empty prefix \u21d2 the whole namespace). `limit == 0` \u21d2 no cap.", "properties": { "method": { "const": "KvScan", "type": "string" }, "params": { "additionalProperties": false, "properties": { "limit": { "format": "uint", "minimum": 0, "type": "integer" }, "namespace": { "type": "string" }, "prefix": { "type": "string" } }, "required": [ "namespace", "prefix", "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_LeaveChannel": { "additionalProperties": false, "properties": { "method": { "const": "LeaveChannel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "channel_id": { "type": "string" } }, "required": [ "channel_id", "agent_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ListChannels": { "additionalProperties": false, "properties": { "method": { "const": "ListChannels", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_ListGraphs": { "additionalProperties": false, "properties": { "method": { "const": "ListGraphs", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_ListRegisteredServers": { "additionalProperties": false, "description": "List the live fleet server registry from the engine-owned `__commons__`\ngraph. The request graph is never an authority input: the server forces\n`__commons__`, applies the verified caller's graph ACL and row-level\nprojection, and returns a keyset page sorted by UTF-8 server name. A\ncontinuation cursor is fenced by both the graph revision and a canonical\ndigest of the complete live typed snapshot; a changed/expired row makes\nthe cursor stale and requires a restart. In the single-node/full runtime\nthis is an authoritative local committed read. A clustered deployment\nmust not describe it as cluster-linearizable until a cluster read barrier\nis added to this route.", "properties": { "method": { "const": "ListRegisteredServers", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_RegisteredServerListRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ListTriggers": { "additionalProperties": false, "description": "List the triggers registered on `graph`. Returns a `Raw` `Vec`.", "properties": { "method": { "const": "ListTriggers", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" } }, "required": [ "graph" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ListWorkItems": { "additionalProperties": false, "description": "One bounded page of `tenant`'s WorkItems, optionally of one `kind`.\nPages by the limit / scan / byte bounds of `AgentComponent.Search`; an\nempty page may still carry `next_cursor`. The cursor is opaque and\nbound to the tenant it was minted for.", "properties": { "method": { "const": "ListWorkItems", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "default": null, "type": [ "string", "null" ] }, "kind": { "default": null, "type": [ "string", "null" ] }, "limit": { "format": "uint32", "minimum": 0, "type": "integer" }, "metadata_match": { "additionalProperties": true, "default": null, "description": "Keep only items whose top-level `metadata` holds every one of these\nkey/value pairs exactly (at most 8 keys) -- e.g. a correlation id or\nan event subject (graph-os EG-5). Filters within the same bounded\nscan, so it never widens a page's cost.", "type": [ "object", "null" ] }, "tenant": { "type": "string" } }, "required": [ "tenant", "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Maintain": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 decay-THEN-evict the working set `ids` in ONE atomic\npass as of the EXPLICIT `now_ms` (the primitive the AU maintenance loop\nschedules). Deterministic (caller clock). Returns `Raw((decayed_count,\npruned_ids))`.", "properties": { "method": { "const": "Maintain", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delete": { "type": "boolean" }, "evict_threshold": { "format": "double", "type": "number" }, "half_life_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "ids": { "items": { "type": "string" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "ids", "now_ms", "half_life_ms", "evict_threshold", "delete" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MatchOntologyTerms": { "additionalProperties": false, "description": "CONCEPT:EG-ORCH.routing.lexical-capability-escalation \u2014 embedding-free lexical classification gate: which\ncapability-node terms (Tool/Skill/MCPServer names+synonyms) appear in the\nquery. The \"free\" tier between structural routing and `SemanticSearch`.", "properties": { "method": { "const": "MatchOntologyTerms", "type": "string" }, "params": { "additionalProperties": false, "properties": { "query": { "type": "string" } }, "required": [ "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MaterializationStatus": { "additionalProperties": false, "description": "Seam 3 \u2014 query the CURRENT status (`\"Fresh\"`/`\"Stale\"`/`\"Retracted\"`, or\nabsent if never registered) of a materialization tracked on the SAME\nper-graph durable incremental reasoning projection. Read-only \u2014 does not\nitself recompute anything. Returns a\n`MaterializationStatusResult` via `ResultPayload::raw`. Same build-tier\nfallback convention as `RecomputeMaterialization`.", "properties": { "method": { "const": "MaterializationStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "id": { "type": "string" } }, "required": [ "id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Metrics": { "additionalProperties": false, "properties": { "method": { "const": "Metrics", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_MineAnomaly": { "additionalProperties": false, "description": "Anomaly / outlier detection (CONCEPT:EG-KG.mining.isolation-forest). Scores\nevery feature row for how anomalous it is via z-score/MAD, Isolation Forest,\nLOF, or One-Class SVM, and flags rows over `threshold` (per-algorithm default\nwhen unset). Rows come from EITHER explicit `features`, a 1-D `values` series\n(each value \u2192 one row \u2014 the tsdb RCA hook), OR a graph-derived `source` (node\nembeddings). Returns rows `{id, anomaly_score, is_anomaly}`. With\n`writeback=true` it materializes each flagged row as a typed `:Anomaly` node\nlinked to its source node \u2014 a graph MUTATION (write, WAL-replayed\ndeterministically). Gated `mining`.", "properties": { "method": { "const": "MineAnomaly", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_AnomalyAlgorithm", "default": "zscore", "description": "Which detector to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per flagged anomaly\n(E6) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from\nthe row's anomaly score. Requires `writeback`.", "type": "boolean" }, "features": { "default": [], "description": "Explicit feature matrix \u2014 each row a point. Empty \u21d2 use `values`/`source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "gamma": { "default": 0.0, "description": "One-Class SVM RBF gamma; `\u2264 0` \u21d2 the `1/n_features` default.", "format": "double", "type": "number" }, "k": { "default": 20, "description": "LOF neighbor count.", "format": "uint", "minimum": 0, "type": "integer" }, "kernel": { "$ref": "#/components/schemas/ReqDef_SvmKernel", "default": "rbf", "description": "One-Class SVM kernel: `rbf` (default) \u00b7 `linear`." }, "n_trees": { "default": 100, "description": "Isolation Forest tree count.", "format": "uint", "minimum": 0, "type": "integer" }, "nu": { "default": 0.1, "description": "One-Class SVM \u03bd \u2208 (0,1] (upper bound on the outlier fraction).", "format": "double", "type": "number" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source) \u2014 see\n`MineCluster::plan`. Takes precedence over `source`; ignored when\n`features`/`values` is non-empty." }, "sample_size": { "default": 256, "description": "Isolation Forest subsample size.", "format": "uint", "minimum": 0, "type": "integer" }, "seed": { "default": 0, "description": "Seed for Isolation Forest (deterministic).", "format": "uint64", "minimum": 0, "type": "integer" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `features` and\n`values` are both empty." }, "threshold": { "default": null, "description": "Flag threshold (higher score = more anomalous). Unset \u21d2 per-algorithm default.", "format": "double", "type": [ "number", "null" ] }, "values": { "default": [], "description": "1-D series convenience \u2014 each scalar becomes a one-element row (e.g. a\ntsdb window for root-cause analysis). Used when `features` is empty.", "items": { "format": "double", "type": "number" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize each flagged row as a typed `:Anomaly` node linked to its source.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineAssociate": { "additionalProperties": false, "properties": { "method": { "const": "MineAssociate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_MineAlgorithm", "default": "fpgrowth", "description": "Which frequent-itemset engine to run (all agree; FP-Growth default)." }, "as_claim": { "description": "ADDITIONALLY materialize a first-class epistemic object per rule (E6,\nCONCEPT:EG-KG.epistemic.epistemic-substrate): a `:Claim` (confidence seeded\nfrom the rule's quality score, normalized to `[0,1]`) plus a provenance\n`:Evidence` node, both `SUPPORTS`-linked to the claim so the `eg_epistemic`\nbelief layer can propagate confidence over the mined finding. Requires\n`writeback` (the `:AssociationRule` node is the claim's evidence anchor).\nGated `all(mining, epistemic)`; unset \u21d2 write-back is byte-identical.", "type": "boolean" }, "min_confidence": { "default": 0.5, "description": "Minimum rule confidence (0.0\u20131.0) to emit.", "format": "double", "type": "number" }, "min_support": { "default": 0.1, "description": "Minimum fractional support (0.0\u20131.0) an itemset must meet.", "format": "double", "type": "number" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_TransactionSource" }, { "type": "null" } ], "description": "Graph-derived transaction source (compute-near-data). Used when\n`transactions` is empty." }, "transactions": { "description": "Explicit transactions \u2014 each a set of item labels. Empty \u21d2 use `source`.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize each rule as a typed `:AssociationRule` node linked to its\nitem nodes (the discovery flywheel). Makes this a graph write.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineCausalImpact": { "additionalProperties": false, "description": "Causal impact estimation (CONCEPT:EG-KG.mining.causal-impact): interrupted\ntime series (a single `series`) or difference-in-differences (`series` +\nnon-empty `control`), split at `intervention_index`. Mirrors\n`MineForecast`'s \"caller hands in the tsdb window\" convention \u2014 no direct\ntsdb coupling. With `writeback=true` materializes a typed `:CausalEffect`\nnode \u2014 a graph MUTATION, WAL-replayed by re-estimating deterministically.\nGated `mining`.", "properties": { "method": { "const": "MineCausalImpact", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the estimate\n(E6) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded\nfrom the estimate's own significance (`1 - two_sided_p`). Requires\n`writeback`.", "type": "boolean" }, "control": { "default": [], "description": "The control series for difference-in-differences. Empty \u21d2 plain\ninterrupted-time-series (no control).", "items": { "format": "double", "type": "number" }, "type": "array" }, "intervention_index": { "default": 0, "description": "Index of the FIRST post-intervention observation (in BOTH series for DiD).", "format": "uint", "minimum": 0, "type": "integer" }, "series": { "default": [], "description": "The (treatment, for DiD) series to analyze \u2014 required.", "items": { "format": "double", "type": "number" }, "type": "array" }, "series_id": { "default": "", "description": "Optional identity for the write-back `:CausalEffect` node. Empty \u21d2\nderived from the input series + algorithm.", "type": "string" }, "writeback": { "default": false, "description": "Materialize the estimate as a typed `:CausalEffect` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineClassifyFit": { "additionalProperties": false, "description": "Classification \u2014 FIT (CONCEPT:EG-KG.mining.naive-bayes). PREDICTIVE: fit a\nclassifier over labeled feature rows and return a serializable model blob\n(`FittedClassifier`), mirroring `DsFitEstimator`. Completes the classifier\nfamily beyond the datascience tree/forest/boosting estimators with Naive Bayes\n(Gaussian/Multinomial), k-NN, one-vs-rest logistic regression, and linear SVC.\nRows come from EITHER explicit `x` OR a graph-derived `source` (node embeddings\nwith OWL/ontology feature vectors \u2014 \"classify nodes using their embeddings\").\nRead-only (no graph mutation). Gated `mining`.", "properties": { "method": { "const": "MineClassifyFit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_ClassifyAlgorithm", "default": "gaussiannb", "description": "Which classifier to fit." }, "alpha": { "default": 1.0, "description": "Multinomial NB Laplace smoothing.", "format": "double", "type": "number" }, "c": { "default": 1.0, "description": "Linear-SVC inverse-regularization C.", "format": "double", "type": "number" }, "epochs": { "default": 300, "description": "Logistic / SVC gradient-descent epochs.", "format": "uint", "minimum": 0, "type": "integer" }, "k": { "default": 5, "description": "k-NN neighbor count.", "format": "uint", "minimum": 0, "type": "integer" }, "l2": { "default": 0.0, "description": "Logistic L2 regularization strength.", "format": "double", "type": "number" }, "lr": { "default": 0.1, "description": "Logistic / SVC learning rate.", "format": "double", "type": "number" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source) \u2014 see\n`MineCluster::plan`. Takes precedence over `source`; ignored when `x`\nis non-empty. NOTE: `y` labels must still align by position with the\nplan's resulting row order." }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `x` is empty." }, "x": { "default": [], "description": "Explicit feature matrix \u2014 each row a sample. Empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "default": [], "description": "Integer class labels, one per row (required).", "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineClassifyPredict": { "additionalProperties": false, "description": "Classification \u2014 PREDICT (CONCEPT:EG-KG.mining.naive-bayes). Takes a fitted\n`model` blob back plus a feature matrix and returns per-row `{labels, proba}`,\nmirroring `DsPredictEstimator`. Rows come from EITHER explicit `x` OR a\ngraph-derived `source` (node embeddings). With `writeback=true` it materializes\neach prediction as a typed `:Classification` node linked to its source node \u2014 a\ngraph MUTATION (write, WAL-replayed deterministically). Gated `mining`.", "properties": { "method": { "const": "MineClassifyPredict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per prediction (D3,\nmirroring E6) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence is\nseeded from the prediction's OWN max class probability (`out.proba[i]`'s\nargmax), already `[0,1]` by construction (a probability simplex row).\nRequires `writeback`.", "type": "boolean" }, "model": { "$ref": "#/components/schemas/ReqDef_FittedClassifier", "description": "The fitted model blob from `MineClassifyFit`." }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source) \u2014 see\n`MineCluster::plan`. Takes precedence over `source`; ignored when `x`\nis non-empty." }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `x` is empty." }, "writeback": { "default": false, "description": "Materialize each prediction as a typed `:Classification` node linked to its\nsource node.", "type": "boolean" }, "x": { "default": [], "description": "Explicit feature matrix \u2014 each row a sample. Empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "model" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineCluster": { "additionalProperties": false, "description": "Clustering (CONCEPT:EG-KG.mining.dbscan-density \u2014 completing the family beyond\nk-Means/spectral). Partitions a feature matrix into clusters via DBSCAN,\nhierarchical agglomerative, GMM (EM), or k-medoids (PAM). Rows come from\nEITHER explicit `features` OR a graph-derived `source` (the embeddings of a\nnode label \u2014 the cross-modal \"cluster the vectors of these nodes\" hook).\nReturns rows `{cluster_id, members, centroid, score}` (+ GMM\n`responsibilities`). With `writeback=true` it materializes each cluster as a\ntyped `:Cluster` node linked to its member nodes \u2014 a graph MUTATION, so it\nclassifies as a write and WAL-replays by re-clustering deterministically.\nGated `mining`; a build without it drops the variant.", "properties": { "method": { "const": "MineCluster", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_ClusterAlgorithm", "default": "dbscan", "description": "Which clustering engine to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per cluster (E6) \u2014\nsee [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\ncluster's compactness score. Requires `writeback`.", "type": "boolean" }, "eps": { "default": 0.5, "description": "DBSCAN neighborhood radius.", "format": "double", "type": "number" }, "features": { "default": [], "description": "Explicit feature matrix \u2014 each row a point. Empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "k": { "default": 3, "description": "Target cluster count for hierarchical / GMM / k-medoids.", "format": "uint", "minimum": 0, "type": "integer" }, "linkage": { "$ref": "#/components/schemas/ReqDef_Linkage", "default": "average", "description": "Hierarchical linkage: `single` \u00b7 `complete` \u00b7 `average` (default)." }, "max_iter": { "default": 100, "description": "EM / PAM iteration cap (GMM, k-medoids).", "format": "uint", "minimum": 0, "type": "integer" }, "min_pts": { "default": 5, "description": "DBSCAN minimum points (incl. self) for a core point.", "format": "uint", "minimum": 0, "type": "integer" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source): an\nupstream cross-modal RETRIEVAL plan (`Op::Scan|Filter|Traverse|Rank|\u2026`),\nexecuted FIRST over the resident graph/vector/SQL/time modalities; the\nresulting RowSet ids are then resolved to their stored embeddings (the\nSAME lookup `VectorSource` uses) to build this op's feature rows \u2014 so\n`retrieve \u2192 cluster \u2192 writeback` is ONE plan, ONE round-trip\n(compute-near-data, no client marshalling between retrieve and mine).\nTakes precedence over `source` when present; ignored when `features`\nis non-empty. Gated additionally on `query` (the plan algebra lives\nbehind that feature) \u2014 a `mining`-only build without `query` drops\nthis field." }, "seed": { "default": 0, "description": "Seed for GMM's k-means++ init (deterministic).", "format": "uint64", "minimum": 0, "type": "integer" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `features` is empty." }, "writeback": { "default": false, "description": "Materialize each cluster as a typed `:Cluster` node linked to members.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineCommunity": { "additionalProperties": false, "description": "Community detection as a mining family (CONCEPT:EG-KG.mining.community-writeback):\nwraps the EXISTING GDS Louvain / label-propagation kernels\n(`eg_compute::graph_algos`, already exposed on the Cypher `CALL gds.*`\nsurface) \u2014 adds NO new algorithm, only the epistemic writeback. Runs over\nthe resident graph (optionally restricted to one node `label`, like\n`MineSubgraph`). With `writeback=true` materializes each community as a\ntyped `:Community` node linked to its members \u2014 a graph MUTATION,\nWAL-replayed by re-detecting deterministically. Gated `mining`.", "properties": { "method": { "const": "MineCommunity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_CommunityAlgorithm", "default": "louvain", "description": "Which existing GDS kernel to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per community (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from\nthe community's own internal-edge density (already `[0,1]`). Requires `writeback`.", "type": "boolean" }, "label": { "default": null, "description": "Optional: restrict the projected graph to nodes of this one type.", "type": [ "string", "null" ] }, "max_iterations": { "default": 100, "description": "Iteration/sweep cap.", "format": "uint", "minimum": 0, "type": "integer" }, "resolution": { "default": 1.0, "description": "Louvain modularity resolution (ignored by label-propagation).", "format": "double", "type": "number" }, "seed": { "default": 0, "description": "Seed for Louvain's deterministic shuffle (ignored by label-propagation).", "format": "uint64", "minimum": 0, "type": "integer" }, "weighted": { "default": true, "description": "Weight neighbor votes by edge weight (label-propagation only; ignored by Louvain).", "type": "boolean" }, "writeback": { "default": false, "description": "Materialize each community as a typed `:Community` node linked to its members.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineEntityResolve": { "additionalProperties": false, "description": "Entity resolution + record linkage (CONCEPT:EG-KG.mining.entity-resolution).\nDISTINCT from the existing always-on `ResolveCandidates` op (all-pairs\ncosine + union-find dedup-ladder proposals, no epistemic writeback): this\nmining family instead supports BOTH Jaccard record linkage over token\nattributes (`records`, blocked by an explicit `block_keys`) AND cosine\nentity resolution over embeddings (`vectors`/`source`, blocked by a grid\nbucket), and materializes each match as a typed `:EntityMatch` node \u2014 a\ngraph MUTATION, WAL-replayed by re-resolving deterministically. Gated `mining`.", "properties": { "method": { "const": "MineEntityResolve", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per match (E6) \u2014\nsee [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\nmatch's OWN similarity. Requires `writeback`.", "type": "boolean" }, "block_keys": { "default": [], "description": "Blocking key per record, same length as `records`. All-empty-string\n(or shorter than `records`) \u21d2 one global block (no blocking).", "items": { "type": "string" }, "type": "array" }, "bucket_precision": { "default": 1, "description": "Grid-bucket rounding precision for the `vectors`/`source` blocking path.", "format": "int32", "type": "integer" }, "ids": { "default": [], "description": "Optional external ids parallel to `records`/`vectors` (the explicit\npaths only \u2014 `source` supplies its own resident node ids). Shorter\nthan the input \u21d2 missing entries fall back to their index.", "items": { "type": "string" }, "type": "array" }, "records": { "default": [], "description": "Token-attribute records (Jaccard record linkage). Empty \u21d2 use\n`vectors`/`source`.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings) \u2014 used when `records`\nand `vectors` are both empty." }, "threshold": { "default": 0.5, "description": "Minimum similarity (Jaccard or Cosine, `[0,1]`) to emit a match.", "format": "double", "type": "number" }, "vectors": { "default": [], "description": "Explicit embedding rows (cosine entity resolution). Used when\n`records` is empty; empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize each match as a typed `:EntityMatch` node linked to both\nmembers (when they are resident node ids).", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineForecast": { "additionalProperties": false, "description": "Classical time-series forecasting (CONCEPT:EG-KG.mining.arima \u2014 Phase 4).\nForecasts `horizon` future points (with an approximate confidence band)\nfrom a 1-D `values` series \u2014 a tsdb window handed in by the caller,\nmirroring `MineAnomaly`'s client-supplied `values` cut (the native\nin-handler TsScan source is the same documented follow-up). `algorithm`\nselects ARIMA(p,d,q) (Hannan-Rissanen), additive Holt-Winters/ETS\n(degrades to Holt linear-trend when `period` is 0), or a classical STL-\nstyle decomposition + trend/seasonal extrapolation. With\n`writeback=true` it materializes the forecast as a typed `:Forecast`\nnode \u2014 linked to a resident node named `series_id` when one exists \u2014 a\ngraph MUTATION, WAL-replayed by re-forecasting deterministically. Gated\n`mining`.", "properties": { "method": { "const": "MineForecast", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_ForecastAlgorithm", "default": "arima", "description": "Which forecasting engine to run." }, "alpha": { "default": 0.3, "description": "Holt-Winters level smoothing.", "format": "double", "type": "number" }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the forecast (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\nforecast's `confidence` band level. Requires `writeback`.", "type": "boolean" }, "beta": { "default": 0.1, "description": "Holt-Winters trend smoothing.", "format": "double", "type": "number" }, "confidence": { "default": 0.95, "description": "Two-sided confidence level for the forecast band (e.g. `0.95`).", "format": "double", "type": "number" }, "d": { "default": 1, "description": "ARIMA differencing order.", "format": "uint", "minimum": 0, "type": "integer" }, "gamma": { "default": 0.1, "description": "Holt-Winters seasonal smoothing.", "format": "double", "type": "number" }, "horizon": { "default": 10, "description": "Steps to forecast beyond the series.", "format": "uint", "minimum": 0, "type": "integer" }, "p": { "default": 1, "description": "ARIMA autoregressive order.", "format": "uint", "minimum": 0, "type": "integer" }, "period": { "default": 0, "description": "Seasonal period for Holt-Winters / STL (`0` \u21d2 non-seasonal Holt\nlinear-trend fallback for Holt-Winters; trend-only for STL).", "format": "uint", "minimum": 0, "type": "integer" }, "q": { "default": 0, "description": "ARIMA moving-average order.", "format": "uint", "minimum": 0, "type": "integer" }, "series_id": { "default": "", "description": "Optional identity for the write-back `:Forecast` node; when it names\na resident node, the forecast is linked `FORECAST_OF` \u2192 that node.\nEmpty \u21d2 the node id is derived from the input `values` + `algorithm`.", "type": "string" }, "values": { "default": [], "description": "The 1-D series to forecast (required \u2014 a tsdb window handed in by\nthe caller).", "items": { "format": "double", "type": "number" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize the forecast as a typed `:Forecast` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineOntologyGap": { "additionalProperties": false, "description": "Ontology-gap detection (CONCEPT:EG-KG.mining.ontology-gap): scans the\nresident graph's own node-`type`/edge-`relationship` class shape (GRAPH-NATIVE \u2014\nno `rdf`/OWL-reasoner dependency) for completeness gaps: no declared\nproperties, an unresolved `subClassOf` parent (an orphan subclass), or a\nfully disconnected class. With `writeback=true` materializes each gap as a\ntyped `:OntologyGap` node linked to its class \u2014 a graph MUTATION,\nWAL-replayed by re-scanning deterministically. Gated `mining`.", "properties": { "method": { "const": "MineOntologyGap", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per gap (E6) \u2014 see\n[`Method::MineAssociate::as_claim`]. Confidence is seeded from the\ngap kind's fixed documented severity (`eg_compute::mining::ontology_gap::GapKind::severity`).\nRequires `writeback`.", "type": "boolean" }, "label": { "default": null, "description": "Optional: restrict the scan to class nodes of this one type\n(`None` \u21d2 every node whose `type`/`node_type` is `Class` or `OwlClass`).", "type": [ "string", "null" ] }, "writeback": { "default": false, "description": "Materialize each gap as a typed `:OntologyGap` node linked to its class.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineProcess": { "additionalProperties": false, "description": "Process mining (CONCEPT:EG-KG.mining.process-mining): directly-follows\ngraph + alpha-miner-lite footprint (causal / parallel / choice relations,\nstart/end activity sets) over ordered event `traces`. With\n`writeback=true` materializes the footprint as a typed `:ProcessModel`\nnode \u2014 a graph MUTATION, WAL-replayed by re-mining deterministically.\nGated `mining`.", "properties": { "method": { "const": "MineProcess", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the model (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from\nthe fraction of observed activity pairs classified `causal`/`parallel`\n(vs. `choice`) \u2014 a log-coverage proxy, already `[0,1]`. Requires `writeback`.", "type": "boolean" }, "process_id": { "default": "", "description": "Optional identity for the write-back `:ProcessModel` node. Empty \u21d2\nderived from the mined footprint's own shape.", "type": "string" }, "traces": { "default": [], "description": "Ordered activity-label traces \u2014 each a time-ordered event sequence\n(an activity may repeat within a trace). Required.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize the footprint as a typed `:ProcessModel` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineReduce": { "additionalProperties": false, "description": "Dimensionality reduction (CONCEPT:EG-KG.mining.truncated-svd). DESCRIPTIVE:\ntransform a feature matrix into low-D `coords` via truncated SVD, LDA\n(supervised \u2014 needs `labels`), UMAP, or t-SNE. Rows come from EITHER explicit\n`x` OR a graph-derived `source` (node embeddings \u2014 \"reduce these node vectors\nfor the graphviz\"). Returns rows `{id, coords}`. With `writeback=true` it\nmaterializes each row's reduced vector as a typed `:Embedding2D` node linked to\nits source node \u2014 a graph MUTATION (write, WAL-replayed deterministically).\nGated `mining`.", "properties": { "method": { "const": "MineReduce", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_ReduceAlgorithm", "default": "svd", "description": "Which reduction engine to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) \u2014 D3, mirroring E6 \u2014 but\nONLY for `svd` (`ReduceAlgorithm::Svd`), the one engine with a principled\n`[0,1]` quality score: the retained EXPLAINED-VARIANCE RATIO\n(`\u03a3 retained singular_values\u00b2 / \u03a3 ALL row sum-of-squares`, i.e. how much of\nthe rows' total variance the kept components capture). `lda`/`umap`/`tsne`\nhave no such score (LDA's discriminant eigenvalues aren't returned;\nUMAP/t-SNE are approximate neighborhood LAYOUTS with no reconstruction-error\nanalogue) \u2014 for those, `as_claim=true` is a documented no-op (no claim is\nwritten; see [`Method::MineAssociate::as_claim`] for the general shape).\nRequires `writeback`.", "type": "boolean" }, "epochs": { "default": 300, "description": "UMAP / t-SNE optimization epochs.", "format": "uint", "minimum": 0, "type": "integer" }, "labels": { "default": [], "description": "Class labels, one per row \u2014 REQUIRED for LDA (ignored otherwise).", "items": { "format": "int64", "type": "integer" }, "type": "array" }, "lr": { "default": 100.0, "description": "t-SNE learning rate.", "format": "double", "type": "number" }, "min_dist": { "default": 0.1, "description": "UMAP minimum embedded distance.", "format": "double", "type": "number" }, "n_components": { "default": 2, "description": "Target dimensionality of the embedding.", "format": "uint", "minimum": 0, "type": "integer" }, "n_neighbors": { "default": 15, "description": "UMAP neighbor count.", "format": "uint", "minimum": 0, "type": "integer" }, "perplexity": { "default": 30.0, "description": "t-SNE perplexity.", "format": "double", "type": "number" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source) \u2014 see\n`MineCluster::plan`. Takes precedence over `source`; ignored when `x`\nis non-empty." }, "seed": { "default": 0, "description": "Seed for UMAP / t-SNE (deterministic layout).", "format": "uint64", "minimum": 0, "type": "integer" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `x` is empty." }, "writeback": { "default": false, "description": "Materialize each row's reduced vector as a typed `:Embedding2D` node.", "type": "boolean" }, "x": { "default": [], "description": "Explicit feature matrix \u2014 each row a point. Empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineRetrievalQuality": { "additionalProperties": false, "description": "Retrieval-quality evaluation (CONCEPT:EG-KG.mining.retrieval-quality):\nprecision@k / recall@k / MRR over stored retrieval `traces`. With\n`writeback=true` materializes the aggregate report as a typed\n`:RetrievalQuality` node \u2014 a graph MUTATION, WAL-replayed by\nre-evaluating deterministically. Gated `mining`.", "properties": { "method": { "const": "MineRetrievalQuality", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the report (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from\nthe report's own F1 (harmonic mean of precision@k/recall@k, already\n`[0,1]`). Requires `writeback`.", "type": "boolean" }, "k": { "default": 0, "description": "Precision/recall/MRR cutoff. `0` \u21d2 use each trace's full retrieved list.", "format": "uint", "minimum": 0, "type": "integer" }, "query_id": { "default": "", "description": "Optional identity for the write-back `:RetrievalQuality` node. Empty \u21d2\nderived from the input traces.", "type": "string" }, "traces": { "default": [], "description": "Retrieval traces to evaluate \u2014 required.", "items": { "$ref": "#/components/schemas/ReqDef_RetrievalTraceSpec" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize the aggregate report as a typed `:RetrievalQuality` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineRiskPropagation": { "additionalProperties": false, "description": "Seeded risk propagation (CONCEPT:EG-KG.mining.risk-propagation): personalized\nPageRank over a directed weighted graph (`edges`), restarting to a `seed`\nrisk distribution instead of teleporting uniformly. With `writeback=true`\nmaterializes each node's propagated score as a typed `:RiskScore` node \u2014 a\ngraph MUTATION, WAL-replayed by re-propagating deterministically. Gated `mining`.", "properties": { "method": { "const": "MineRiskPropagation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per scored node (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\nnode's own propagated share (already `[0,1]`, mass-conserving). Requires `writeback`.", "type": "boolean" }, "damping": { "default": 0.85, "description": "Damping factor (probability of following an edge vs. restarting to `seed`).", "format": "double", "type": "number" }, "edges": { "default": [], "description": "Weighted directed edges `(from_id, to_id, weight)`; `weight` clamped `>= 0`.", "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" }, "max_iterations": { "default": 100, "description": "Hard iteration cap.", "format": "uint", "minimum": 0, "type": "integer" }, "nodes": { "default": [], "description": "Node ids, index-aligned with `seed` and referenced by `edges`.", "items": { "type": "string" }, "type": "array" }, "seed": { "default": [], "description": "Seed risk per node, index-aligned with `nodes` (any non-negative\nscale \u2014 normalized internally; all-zero \u21d2 all-zero result).", "items": { "format": "double", "type": "number" }, "type": "array" }, "tolerance": { "default": 1e-09, "description": "L1 convergence tolerance.", "format": "double", "type": "number" }, "writeback": { "default": false, "description": "Materialize each node's propagated score as a typed `:RiskScore` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineRootCause": { "additionalProperties": false, "description": "Root-cause propagation (CONCEPT:EG-KG.mining.root-cause): given a directed\nweighted dependency graph (`edges`, `cause -> effect`) and a per-node\nanomaly `scores` vector (the existing `anomaly` family's own output, or\nany other score), find the most-likely upstream root cause of one\n`symptom` node. With `writeback=true` materializes the top candidate as a\ntyped `:RootCause` node linked to the symptom \u2014 a graph MUTATION,\nWAL-replayed by re-searching deterministically. Gated `mining`.", "properties": { "method": { "const": "MineRootCause", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the top\ncandidate (E6) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence\nmirrors `anomaly`'s `score / (1 + score)` mapping over the candidate's\nOWN raw responsibility score (normalizing against the candidate list\nwould be trivially `1.0` for the top candidate). Requires `writeback`.", "type": "boolean" }, "decay": { "default": 0.85, "description": "Per-hop score decay `(0,1]` (mirrors PageRank's damping factor).", "format": "double", "type": "number" }, "edges": { "default": [], "description": "Dependency edges `(cause_id, effect_id, weight)`; `weight` clamped to `[0,1]`.", "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" }, "max_hops": { "default": 5, "description": "Search depth cap.", "format": "uint", "minimum": 0, "type": "integer" }, "nodes": { "default": [], "description": "Node ids, index-aligned with `scores` and referenced by `edges`.", "items": { "type": "string" }, "type": "array" }, "scores": { "default": [], "description": "Anomaly score per node, index-aligned with `nodes` (negative clamps to `0.0`).", "items": { "format": "double", "type": "number" }, "type": "array" }, "symptom": { "default": "", "description": "The already-flagged anomalous node whose root cause to find (required).", "type": "string" }, "writeback": { "default": false, "description": "Materialize the top candidate as a typed `:RootCause` node linked to the symptom.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineSequence": { "additionalProperties": false, "description": "Sequential-pattern mining (CONCEPT:EG-KG.mining.prefixspan \u2014 Phase 4).\nFinds frequent ORDERED subsequences (PrefixSpan or GSP; both agree) over\nEITHER explicit `sequences` (each a time-ordered list of item labels \u2014 an\nitem may repeat) OR a graph-derived `source` that turns each node's\nordered neighbor list (following resident edge insertion order) into one\nsequence \u2014 the \"what reliably follows what\" hook (evolution/commit\ntimelines, event streams). Returns rows `{items, support, count}`. With\n`writeback=true` it materializes each pattern as a typed\n`:SequentialPattern` node linked to any item that is a resident node \u2014 a\ngraph MUTATION, WAL-replayed by re-mining deterministically. Gated\n`mining`.", "properties": { "method": { "const": "MineSequence", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_MineSeqAlgorithm", "default": "prefixspan", "description": "Which sequential-pattern engine to run (both agree; PrefixSpan default)." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per pattern (E6) \u2014\nsee [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\npattern's support. Requires `writeback`.", "type": "boolean" }, "min_support": { "default": 0.1, "description": "Minimum fractional support (0.0\u20131.0) a pattern must meet.", "format": "double", "type": "number" }, "sequences": { "default": [], "description": "Explicit ordered sequences \u2014 each a time-ordered list of item labels.\nEmpty \u21d2 use `source`.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_SequenceSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived sequence source (compute-near-data). Used when\n`sequences` is empty." }, "writeback": { "default": false, "description": "Materialize each pattern as a typed `:SequentialPattern` node linked to\nits resident item nodes.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineSubgraph": { "additionalProperties": false, "description": "Frequent subgraph mining + motif counting (CONCEPT:EG-KG.mining.gspan-frequent-subgraph\n\u2014 Phase 4, the graph-native differentiator). UNLIKE every other mining\nop in this family, this one mines the RESIDENT GRAPH's own topology\ndirectly \u2014 no rows/vectors handed in. `gspan` finds frequent connected\nsubgraph PATTERNS (level-wise growth up to `max_edges` edges,\ncanonicalized + exactly re-counted); `motif` censuses small\nlabel-agnostic topological motifs (wedges, triangles, directed\n3-cycles). `label`, when given, restricts the scanned host graph to\nnodes of that one type (both edge endpoints must match) \u2014 `None` scans\nthe whole resident graph heterogeneously. With `writeback=true`\n(`gspan` only) each frequent pattern is materialized as a typed\n`:FrequentSubgraph` node, linked to every host node appearing in any of\nits embeddings \u2014 a graph MUTATION, WAL-replayed by re-mining\ndeterministically. Gated `mining`.", "properties": { "method": { "const": "MineSubgraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_SubgraphAlgorithm", "default": "gspan", "description": "Which algorithm to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per frequent pattern\n(E6, `gspan` only) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence\nis seeded from the pattern's support. Requires `writeback`.", "type": "boolean" }, "label": { "default": null, "description": "Optional: restrict the host graph to nodes of this one type.\n`None` \u21d2 the whole resident graph (heterogeneous).", "type": [ "string", "null" ] }, "max_edges": { "default": 3, "description": "Pattern-size growth cap (tractability). Ignored by `motif`.", "format": "uint", "minimum": 0, "type": "integer" }, "min_support": { "default": 0.1, "description": "Minimum fractional support (0.0\u20131.0, of the host's total edge\ncount) a pattern's embedding count must meet. Ignored by `motif`.", "format": "double", "type": "number" }, "writeback": { "default": false, "description": "Materialize each frequent pattern as a typed `:FrequentSubgraph`\nnode (`gspan` only \u2014 a no-op for `motif`, which has no patterns).", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MineText": { "additionalProperties": false, "description": "Text mining (CONCEPT:EG-KG.mining.tfidf \u2014 Phase 4). `tfidf` returns each\ndocument's term weights (descriptive, read-only); `lda`/`nmf` fit a\n`k`-topic model over the corpus. Documents come from EITHER explicit\n`docs` (each a pre-tokenized `Vec` \u2014 use `tokenize`-equivalent\nclient-side, or pass raw words) OR a graph-derived `source` that\ntokenizes a text property off a node label (compute-near-data \u2014 no\nTantivy/eg-text dependency). With `writeback=true` (`lda`/`nmf` only)\neach topic is materialized as a typed `:Topic` node, linked to any\nsource document that is a resident node \u2014 a graph MUTATION,\nWAL-replayed by re-mining deterministically. Gated `mining`.", "properties": { "method": { "const": "MineText", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ReqDef_TextAlgorithm", "default": "tfidf", "description": "Which text-mining engine to run." }, "alpha": { "default": 0.1, "description": "LDA symmetric doc-topic Dirichlet prior.", "format": "double", "type": "number" }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per topic (D3, mirroring\nE6) \u2014 `lda`/`nmf` only, a no-op for `tfidf` (which has no topics, mirroring\n`writeback`). Quality = the topic's mean doc-membership strength among the\ndocuments DOMINANTLY assigned to it (`mean(doc_topics[d][t])` over docs `d`\nwhose argmax topic is `t`) \u2014 a topic-coherence proxy: both LDA's Dirichlet\nposterior and NMF's row-normalized `W` are already `[0,1]` distributions that\nsum to 1 across topics (see `eg_compute::mining::text` module docs), so this\nis a principled, already-bounded score requiring no extra normalization.\nRequires `writeback`.", "type": "boolean" }, "beta": { "default": 0.01, "description": "LDA symmetric topic-term Dirichlet prior.", "format": "double", "type": "number" }, "docs": { "default": [], "description": "Explicit pre-tokenized documents. Empty \u21d2 use `source`.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "iterations": { "default": 200, "description": "Gibbs sweeps (`lda`) / multiplicative-update iterations (`nmf`).", "format": "uint", "minimum": 0, "type": "integer" }, "k": { "default": 3, "description": "Topic count for `lda`/`nmf`.", "format": "uint", "minimum": 0, "type": "integer" }, "seed": { "default": 0, "description": "Seed for LDA's Gibbs sampler / NMF's initial factors (deterministic).", "format": "uint64", "minimum": 0, "type": "integer" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_TextSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived text source (compute-near-data). Used when `docs` is\nempty." }, "top_n": { "default": 10, "description": "How many terms to keep per document/topic row.", "format": "uint", "minimum": 0, "type": "integer" }, "writeback": { "default": false, "description": "Materialize each topic as a typed `:Topic` node (`lda`/`nmf` only \u2014\na no-op for `tfidf`, which has no topics to write back).", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MinimumSpanningTree": { "additionalProperties": false, "properties": { "method": { "const": "MinimumSpanningTree", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_MiningPipelineCompare": { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelineCompare", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "The pipeline whose two versions to compare.", "type": "string" }, "version_a": { "description": "The two `:Model` versions to diff (held-out metrics).", "format": "uint64", "minimum": 0, "type": "integer" }, "version_b": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "name", "version_a", "version_b" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MiningPipelineEvaluate": { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelineEvaluate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "The pipeline whose stored model to score.", "type": "string" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_GraphSource" }, { "type": "null" } ], "default": null, "description": "Node source to build the evaluation features from (via the model's stored\nfeature recipe). Empty \u21d2 use explicit `x`." }, "version": { "default": 0, "description": "Model version to evaluate; `0` \u21d2 the currently-served version.", "format": "uint64", "minimum": 0, "type": "integer" }, "x": { "default": [], "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "default": [], "description": "Ground-truth integer labels; empty \u21d2 read the model's `label_property`.", "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MiningPipelinePredict": { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelinePredict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "The pipeline to predict with.", "type": "string" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_GraphSource" }, { "type": "null" } ], "default": null, "description": "Node source to predict over (rebuilds features via the model's recipe).\nEmpty \u21d2 use explicit `x`." }, "version": { "default": 0, "description": "Model version; `0` \u21d2 the currently-served version.", "format": "uint64", "minimum": 0, "type": "integer" }, "writeback": { "default": false, "description": "Materialize each prediction as a typed `:Prediction` node linked to its\nsource node (a graph write).", "type": "boolean" }, "x": { "default": [], "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MiningPipelineServe": { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelineServe", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "The pipeline whose version to deploy.", "type": "string" }, "version": { "description": "The `:Model` version to mark served (predict-by-name then resolves it).", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "name", "version" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MiningPipelineTrain": { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelineTrain", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "Pipeline name \u2014 versioned `:Model` artifacts are keyed by it (`v1`, `v2`\u2026).", "type": "string" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ReqDef_GraphSource" }, { "type": "null" } ], "default": null, "description": "The graph-derived node source the feature steps read. Empty \u21d2 `x` explicit." }, "spec": { "$ref": "#/components/schemas/ReqDef_PipelineSpec", "description": "The composable pipeline recipe (features \u2192 split \u2192 model)." }, "writeback": { "default": true, "description": "Persist the fitted model as a versioned `:Model` node (a graph write).\n`false` \u21d2 dry-run: fit + report metrics without materializing an artifact.", "type": "boolean" }, "x": { "default": [], "description": "Explicit feature matrix \u2014 each row a sample. Empty \u21d2 built from `source`\nvia the spec's feature steps.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "default": [], "description": "Explicit integer labels aligned to the rows / source node order. Empty \u21d2\nread from each node's `spec.label_property` (node classification).", "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "required": [ "name", "spec" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MintWorkItemClaimCapability": { "additionalProperties": false, "description": "Mint an opaque native capability for the caller's currently-live\nWorkItem lease. All authority bindings are derived in the engine from\nthe verified request context and the authoritative WorkItem row.", "properties": { "method": { "const": "MintWorkItemClaimCapability", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_WorkItemClaimCapabilityMintRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MultiGraphBatchUpdate": { "additionalProperties": false, "description": "Batched CROSS-GRAPH write (CONCEPT:EG-KG.storage.multi-graph-batch-write). One\nround-trip carries a `BatchUpdate`-shaped op list for MANY named graphs; the\nserver applies each graph's sub-batch through the normal per-graph write\npath CONCURRENTLY, so N distinct graphs commit across N of the K redb shard\nwriters in parallel instead of the client serializing N round-trips that\neach re-acquire one lock. `batches_msgpack` decodes to\n`Vec<(graph_name, operations_msgpack)>` \u2014 each inner blob is exactly a\n`BatchUpdate.operations_msgpack`, so it REUSES the existing batch primitive\n(no new per-op op). Carries its graphs in the METHOD (like `NlQuery`), so it\nis routed BEFORE the single-`graph` graph-op path in dispatch. The reply is\n`{ \"results\": { graph: }, \"errors\": { graph: msg } }`.", "properties": { "method": { "const": "MultiGraphBatchUpdate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "batches_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "batches_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_MutationOutbox": { "additionalProperties": false, "description": "Operator view and in-order re-delivery of one owner's mutation outbox.", "properties": { "method": { "const": "MutationOutbox", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_MutationOutboxOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_NlQuery": { "additionalProperties": false, "description": "Natural-language \u2192 executable query \u2192 rows. `text` is the NL request, `graph`\nthe target graph (the `/nl` HTTP facade path has no request envelope, so the\ngraph rides the method; over the wire an empty `graph` falls back to the request\nenvelope's graph). The handler resolves a configured/injected `NlPlanner`, turns\nthe NL into a UQL query string, and runs it through the IDENTICAL deterministic\n`UnifiedQueryText` pipeline (`eg_plan::uql::parse` \u2192 the fused executor) \u2014 NO new\nexecution path, and no LLM in the engine core. Result via `ResultPayload::raw` \u2014\nthe SAME `[id, score|nil]` rows as `UnifiedQuery`.\n\nUNCONDITIONAL in the enum (like `RbacAdmin`); the HANDLER is gated behind the\nfacade `nl-query` feature. A build WITHOUT `nl-query` falls to the dispatch \"not\navailable in this build\" catch-all \u2014 so the wire stays compatible while the NL\nsurface is a build-tier choice.", "properties": { "method": { "const": "NlQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "default": "", "type": "string" }, "text": { "type": "string" } }, "required": [ "text" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_NodeCount": { "additionalProperties": false, "properties": { "method": { "const": "NodeCount", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_NodeIds": { "additionalProperties": false, "properties": { "method": { "const": "NodeIds", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_ObserveDevelopmentLane": { "additionalProperties": false, "description": "Replace the monotonic observed retained footprint on one exact hold.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "ObserveDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneObserveRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ObserveScreen": { "additionalProperties": false, "description": "Turn a captured desktop frame into durable session/frame/UIElement graph\nentities in one round-trip (CONCEPT:AU-KG.ontology.owl-screen-bridge). The blob is a MessagePack map\n`{session_id, frame_seq, prev_frame_id, prev_hash, png: bin, elements: [..]}`;\nthe response is a SINGLE `ScreenObservationResult` (nodes + edges), mirroring\n`IndexRepository`. The screenshot bytes never persist \u2014 only its dimensions +\ncontent hash do, for frame-diff.", "properties": { "method": { "const": "ObserveScreen", "type": "string" }, "params": { "additionalProperties": false, "properties": { "obs_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "obs_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_OutDegree": { "additionalProperties": false, "properties": { "method": { "const": "OutDegree", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_OwlExplain": { "additionalProperties": false, "description": "OWL proof-tree EXPLANATION (CONCEPT:EG-KG.ontology.owl-proof-tree-explanation) \u2014 Stardog's flagship\n\"explanation\" feature, native here. Classifies the request's graph (its own TBox\naxioms, loaded via `AddTriples`, plus any extra `ontology` Turtle) with confidence\npropagation, then reconstructs the FULL recursive proof tree for the ONE named-class\nsubsumption `sub \u2291 sup` \u2014 WHICH axiom(s) + WHICH premise subsumption(s) derived it,\nrecursively down to the asserted/reflexive leaves \u2014 via\n[`crate`]-independent reconstruction of `eg_rdf::owl::Classification::explain`'s\njustification DAG (CONCEPT:EG-KG.ontology.justification-tracking). Returns a `Raw`\n[`OwlExplainResult`]. Read-only (does not mutate the graph). Gated `owl`.", "properties": { "method": { "const": "OwlExplain", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ontology": { "default": "", "description": "Extra OWL axioms as Turtle (empty \u21d2 reason over the graph's own axioms).", "type": "string" }, "sub": { "description": "The SUBCLASS side of the subsumption to explain (a class IRI, `<...>` or bare \u2014\ncanonicalized the same way `target_class` is elsewhere).", "type": "string" }, "sup": { "description": "The SUPERCLASS side of the subsumption to explain.", "type": "string" } }, "required": [ "sub", "sup" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_OwlReason": { "additionalProperties": false, "description": "Run the native OWL 2 (EL\u207a + RL) reasoner over the request's graph and\nmaterialize entailments (CONCEPT:EG-KG.ontology.incremental-materialization). Classifies the OWL axioms already\nin the graph (the TBox loaded via `AddTriples`) plus any extra `ontology`\nTurtle, then returns a `Raw` [`OwlReasonResult`]: the derived named-class\nsubsumptions, the inferred instance\u2192class memberships (incl. ones reached only\nthrough existential restrictions / role chains), and a consistency verdict. The\n`Op::Reason` plan op reuses the SAME classifier as a RowSet source. Read-only\n(it does not mutate the graph). Gated `owl`.", "properties": { "method": { "const": "OwlReason", "type": "string" }, "params": { "additionalProperties": false, "properties": { "class_base": { "default": "", "description": "The absolute namespace a bare string node `type` (e.g. `\"Agent\"`) is\nbridged into before classification (`eg_rdf::owl::bridge_type_to_class`) \u2014\nindependent of `target_class`, which ONLY controls filtering (BUG-281: the\ntwo used to be conflated, so an empty `target_class` \u2014 its own documented\n\"all classes\" case \u2014 could never supply a namespace, and a caller wanting\n\"reason over everything\" always hit `OwlReason requires an absolute target\nclass`). Empty \u21d2 fall back to `target_class`'s own namespace when\n`target_class` is absolute (the pre-existing convenience for a caller that\nonly ever set one field); a class bridge for a bare string `type` is only\npossible once SOME absolute namespace is available from either field.", "type": "string" }, "min_confidence": { "description": "Confidence threshold \u03c4 in `[0,1]` (CONCEPT:EG-KG.ontology.concept-13). The result carries a\nper-entailment confidence (axioms/facts may be uncertain; the closure\npropagates it \u2014 `eg:confidence` annotations \u00d7 the per-node confidence \u00d7\nEbbinghaus decay). Only entailments with `confidence \u2265 min_confidence` are\nreturned. `0.0` keeps everything (and a HARD ontology yields all `1.0`).", "format": "double", "type": "number" }, "ontology": { "default": "", "description": "Extra OWL axioms as Turtle (empty \u21d2 reason over the graph's own axioms).", "type": "string" }, "target_class": { "default": "", "description": "When set, restrict the returned instance memberships to this class (its\ninferred members) \u2014 the materialize-one-class shape. Empty \u21d2 all classes.", "type": "string" } }, "required": [ "min_confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_OwlReasonDistributed": { "additionalProperties": false, "description": "DISTRIBUTED confidence-weighted OWL reasoning over the UNION of `graphs`\n(CONCEPT:EG-KG.ontology.concept-13): gathers each graph/shard's TBox axioms + decayed-confidence\ntype facts, runs ONE weighted EL\u207a/RL closure over the union (the cross-shard\nunion-read seam \u2014 KG-2.171), and returns the SAME [`OwlReasonResult`] a\nsingle-graph `OwlReason` would over the same axioms in one graph. The single-\nshard fast path stays `OwlReason`. Read-only. Gated `owl`.", "properties": { "method": { "const": "OwlReasonDistributed", "type": "string" }, "params": { "additionalProperties": false, "properties": { "class_base": { "default": "", "description": "See `OwlReason::class_base` (BUG-281) \u2014 independent of `target_class`.", "type": "string" }, "graphs": { "description": "The graphs (shards) whose axioms + facts to union and reason over.", "items": { "type": "string" }, "type": "array" }, "min_confidence": { "description": "Confidence threshold \u03c4 in `[0,1]` (see `OwlReason::min_confidence`).", "format": "double", "type": "number" }, "ontology": { "default": "", "description": "Extra OWL axioms as Turtle (a shared TBox over the sharded ABox; empty \u21d2\nonly the axioms already present across the graphs).", "type": "string" }, "target_class": { "default": "", "description": "Restrict instance memberships to this class (empty \u21d2 all classes).", "type": "string" } }, "required": [ "graphs", "min_confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PageRank": { "additionalProperties": false, "properties": { "method": { "const": "PageRank", "type": "string" }, "params": { "additionalProperties": false, "properties": { "damping": { "format": "double", "type": "number" }, "iterations": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "damping", "iterations" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ParseFile": { "additionalProperties": false, "properties": { "method": { "const": "ParseFile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "file_path": { "type": "string" }, "source": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "file_path", "source" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ParseFiles": { "additionalProperties": false, "description": "Batched parse: one round-trip for N files (CONCEPT:EG-KG.memory.forgetting-curve-decay). The blob is\na MessagePack-encoded `Vec<(file_path, source_bytes)>`; the response is an\nordered `Vec`, one per input file. Mirrors `BatchUpdate`.", "properties": { "method": { "const": "ParseFiles", "type": "string" }, "params": { "additionalProperties": false, "properties": { "files_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "files_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PersonalizedPageRank": { "additionalProperties": false, "properties": { "method": { "const": "PersonalizedPageRank", "type": "string" }, "params": { "additionalProperties": false, "properties": { "damping": { "format": "double", "type": "number" }, "iterations": { "format": "uint", "minimum": 0, "type": "integer" }, "seed_nodes": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" } }, "required": [ "seed_nodes", "damping", "iterations" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Ping": { "additionalProperties": false, "properties": { "method": { "const": "Ping", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_PlacementAdmin": { "additionalProperties": false, "description": "Drive the placement-catalog admin API (CONCEPT:EG-KG.sharding.placement-catalog-admin-rpc):\n[`PlacementAdminOp::Assign`] (the placement DECISION leg), [`PlacementAdminOp::Move`]\n(the full PLAN \u2192 EXECUTE \u2192 CATALOG-UPDATE leg \u2014 snapshot \u2192 per-graph\ndurability-barrier catch-up \u2192 fenced cutover, reusing the already-proven\n`TenantManager::move_partition` state machine, crash-safe via its durable move\njournal), or [`PlacementAdminOp::AbortMove`] (roll back before the cutover\nfence). Raft/cluster only; a non-clustered build returns a typed \"not available\"\nerror. Returns operation-specific JSON \u2014 see [`PlacementAdminOp`].", "properties": { "method": { "const": "PlacementAdmin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_PlacementAdminOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PlacementRoute": { "additionalProperties": false, "description": "Resolve `(tenant, sub_key)`'s current placement (CONCEPT:EG-KG.sharding.placement-route-rpc). `client_epoch`\nis the caller's last-known routing epoch for this partition (`0` if never\nresolved). Returns the schema-generated `PlacementRoute`. A placed route\nalways has a non-zero epoch; an authoritative unplaced route uses epoch zero.", "properties": { "method": { "const": "PlacementRoute", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_PlacementRouteRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PlanMatViewDefine": { "additionalProperties": false, "description": "Define (or replace) a plan-backed materialized view `name` over `graph`, whose\ndefinition is the cross-modal `plan`. Executes the plan once, caches the result,\nand persists the definition durably. Returns the row count of the first\nmaterialization.", "properties": { "method": { "const": "PlanMatViewDefine", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "name": { "type": "string" }, "plan": { "$ref": "#/components/schemas/ReqDef_Plan" } }, "required": [ "name", "graph", "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PlanMatViewDrop": { "additionalProperties": false, "description": "Drop a plan-backed matview: remove its definition from RAM + the durable tier and\ninvalidate its cached result. Returns `Bool(true)` if it existed.", "properties": { "method": { "const": "PlanMatViewDrop", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PlanMatViewGet": { "additionalProperties": false, "description": "Read a plan-backed materialized view's current rows by name\n(`ResultPayload::Raw`, `[id, score|nil]`). Serves the cached result when fresh;\nrecomputes (and re-caches) when a write to the underlying graph \u2014 or an explicit\nCDC change signal \u2014 retired it.", "properties": { "method": { "const": "PlanMatViewGet", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PlanMatViewRefresh": { "additionalProperties": false, "description": "Force a re-materialization of a plan-backed matview NOW (bypassing the freshness\ncheck), re-executing its stored plan and re-caching. Returns the fresh row count.", "properties": { "method": { "const": "PlanMatViewRefresh", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PruneByLifecycle": { "additionalProperties": false, "properties": { "method": { "const": "PruneByLifecycle", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_age_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "min_score": { "format": "double", "type": "number" } }, "required": [ "max_age_secs", "min_score" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Publish": { "additionalProperties": false, "description": "Publish `payload` to `exchange` with `routing_key`; the engine routes it to all\nmatched queues atomically. Returns the delivered-queue count (`Count`).", "properties": { "method": { "const": "Publish", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "routing_key": { "type": "string" } }, "required": [ "exchange", "routing_key", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PublishConfirmed": { "additionalProperties": false, "description": "Publish with a publisher confirm (CONCEPT:EG-KG.compute.publisher-confirms-consumer-qos) \u2014 a superset of [`PublishEx`]\nthat also allocates a monotonic delivery-tag. Returns `Raw(ConfirmToken)` with\n`confirmed = true` once durably enqueued (exchange exists) or a nack on an\nunknown exchange. The tag increments on every call (confirms and nacks alike).", "properties": { "method": { "const": "PublishConfirmed", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delay_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "exchange": { "type": "string" }, "now_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "priority": { "default": 0, "format": "int64", "type": "integer" }, "routing_key": { "type": "string" }, "ttl_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "exchange", "routing_key", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PublishEx": { "additionalProperties": false, "description": "Policy-carrying publish (CONCEPT:EG-KG.compute.message-ttl-expiry/278/279). Superset of [`Publish`]:\nstamps per-message `priority` (EG-278), and \u2014 resolving relative intents\nagainst the EXPLICIT `now_ms` \u2014 a `deliver_at` eta (EG-279 delay) and an\n`expires_at` deadline (EG-277 TTL). With `priority == 0` and all options\n`None`, produces a message node identical to a plain [`Publish`]. Returns the\ndelivered-queue count (`Count`).", "properties": { "method": { "const": "PublishEx", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delay_ms": { "default": null, "description": "EG-279: hold the message non-claimable for this many ms from `now_ms`.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "exchange": { "type": "string" }, "now_ms": { "default": null, "description": "Caller clock (ms since epoch) used to resolve `delay_ms`/`ttl_ms` to\nabsolute etas \u2014 explicit so WAL replay is deterministic.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "priority": { "default": 0, "description": "EG-278: priority band; higher is delivered first (default 0).", "format": "int64", "type": "integer" }, "routing_key": { "type": "string" }, "ttl_ms": { "default": null, "description": "EG-277: per-message TTL in ms from `now_ms` (falls back to queue TTL).", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "exchange", "routing_key", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_PublishIdempotent": { "additionalProperties": false, "description": "Publish with an OPTIONAL `(producer_id, seq)` idempotency stamp for\neffectively-once delivery (CONCEPT:EG-KG.ingest.broker-reject-publish) \u2014 a superset of [`PublishConfirmed`].\nWith `producer_id == None` this is the plain at-least-once path (byte-identical\nto [`PublishEx`]). With `producer_id == Some`, the broker dedups against that\nproducer's durable monotonic high-water mark: a `seq` at/under the mark is a\nDUPLICATE (dropped but still confirmed), a `seq` above it advances the mark and\nthe message is enqueued. Returns `Raw(IdempotentPublish)`\n(`confirmed`/`duplicate`/`delivered`). Deterministic: the dedup + mark bump\nderive purely from graph state + explicit args, so WAL/Raft replay reproduces\nbyte-identical state.", "properties": { "method": { "const": "PublishIdempotent", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delay_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "exchange": { "type": "string" }, "now_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "priority": { "default": 0, "format": "int64", "type": "integer" }, "producer_id": { "default": null, "description": "Stable publisher identity; `None`/empty \u21d2 at-least-once (no dedup).", "type": [ "string", "null" ] }, "routing_key": { "type": "string" }, "seq": { "default": 0, "description": "Per-producer monotonic sequence number (dedup key).", "format": "int64", "type": "integer" }, "ttl_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "exchange", "routing_key", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Quantum": { "additionalProperties": false, "description": "The agent-facing quantum control-plane surface (Q8, CONCEPT:EG-KG.compute.quantum-agent-api):\n`quantum_rank`/`optimize_with_qaoa`/`quantum_expectation` over a registered\n`eg_quantum_core::backend::QuantumBackend` (today: `eg-quantum-sim`'s\n`sv-cpu`/`stabilizer`). ONE variant wrapping an internal op enum \u2014 mirrors\n`AnalyticsJob { op }`/`Statechart { op }` above \u2014 so the whole surface costs\nexactly one `Method` arm. Gated `quantum`; the handler\n(`src/server/handlers/quantum.rs`) self-routes in `dispatch.rs` before the\nper-graph chain (a quantum run reads no persisted graph state and writes\nnothing durable \u2014 every result is returned to the caller as a proposal,\nnever committed \u2014 like `AnalyticsJob`/`Statechart`/`TsAppend`/`Kv*`).", "properties": { "method": { "const": "Quantum", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_QuantumOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_QueryDevelopmentLane": { "additionalProperties": false, "description": "Exact authenticated read of one lane hold or tombstone.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "QueryDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneQueryRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_QueryWorkItemReservation": { "additionalProperties": false, "description": "Exact bounded read of a native reservation or retained lifecycle tombstone.", "properties": { "method": { "const": "QueryWorkItemReservation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_ResourceReservationStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RaftAddLearner": { "additionalProperties": false, "description": "Attach `node_id` (reachable at `addr`) to `group` as a NON-VOTING\nLEARNER (CONCEPT:EG-KG.storage.kg-kg-2). Starts replication immediately and BLOCKS\nuntil the learner's log is caught up, but does NOT change the voter\nset \u2014 quorum size and fault tolerance are unaffected. The safe,\nalways-available first step before optionally promoting the node with\n`RaftChangeMembership`. `group` defaults to the single-group\ndeployment's `raft::DEFAULT_GROUP` (0) when omitted. Returns `Bool` on\nsuccess.", "properties": { "method": { "const": "RaftAddLearner", "type": "string" }, "params": { "additionalProperties": false, "properties": { "addr": { "type": "string" }, "group": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "node_id": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_id", "addr" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RaftChangeMembership": { "additionalProperties": false, "description": "Set `group`'s VOTER set to exactly `voters` (CONCEPT:EG-KG.storage.kg-kg-2) \u2014 openraft\n`change_membership`. The usual way to PROMOTE one or more learners\nadded via `RaftAddLearner`: pass the full desired voter set (existing\nvoters plus the learner(s) being promoted). Refuses to produce an\nempty voter set. `group` defaults to `raft::DEFAULT_GROUP` (0) when\nomitted. Returns `Bool` on success.", "properties": { "method": { "const": "RaftChangeMembership", "type": "string" }, "params": { "additionalProperties": false, "properties": { "group": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "voters": { "items": { "format": "uint64", "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "voters" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RankByProvenance": { "additionalProperties": false, "description": "EPI-P3-3 \u2014 provenance-aware retrieval ranking: order request-carried\n`candidates` by a weighted blend of similarity AND evidence quality/\nprovenance (source reliability, corroboration, calibration precision,\nfreshness) rather than similarity alone (`eg_epistemic::rank`, feature\n`epistemic-causal`). A pure function over request-carried inputs \u2014 no graph\nsnapshot is read. Returns a `RankByProvenanceResult` via `ResultPayload::raw`.\nSame build-tier fallback convention as `ExplainEvidence`/`CausalEstimate`.", "properties": { "method": { "const": "RankByProvenance", "type": "string" }, "params": { "additionalProperties": false, "properties": { "candidates": { "items": { "$ref": "#/components/schemas/ReqDef_RetrievalCandidateWire" }, "type": "array" }, "weights": { "$ref": "#/components/schemas/ReqDef_RankWeightsWire", "default": { "evidence_quality": 0.5, "similarity": 0.5 } } }, "required": [ "candidates" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RbacAdmin": { "additionalProperties": false, "description": "Administer the RBAC role/grant policy (CONCEPT:EG-KG.compute.feature). Unconditional in the\nenum; the handler is gated behind the `security` feature (a non-security build\nfalls to the dispatch \"not available in this build\" catch-all, like EG-090's\nbackup/restore on a non-redb build).", "properties": { "method": { "const": "RbacAdmin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_RbacAdminOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ReadContinuousQuery": { "additionalProperties": false, "description": "Read the current incrementally-maintained result of a continuous query. Returns\na `Raw` `ContinuousQueryResult`.", "properties": { "method": { "const": "ReadContinuousQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RebalanceExecute": { "additionalProperties": false, "description": "Compute a rebalance plan AND execute it move-by-move via online resharding\n(CONCEPT:EG-KG.backend.r3-plan-execution, R3 plan execution). Each move is one online `Reshard` \u2014 online,\none graph at a time, other graphs unaffected. Returns the executed moves' reports.", "properties": { "method": { "const": "RebalanceExecute", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_moves": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "tolerance": { "format": "double", "type": [ "number", "null" ] } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RebalancePlan": { "additionalProperties": false, "description": "Compute (do NOT execute) a rebalance plan over live per-shard/per-graph load\n(CONCEPT:EG-KG.sharding.even-load-rebalance). Returns the ordered `{graph, from_shard, to_shard}` moves +\nthe per-shard load it planned against, as JSON.", "properties": { "method": { "const": "RebalancePlan", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_moves": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "tolerance": { "format": "double", "type": [ "number", "null" ] } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ReclaimExpiredCapacity": { "additionalProperties": false, "description": "Reclaim a bounded page of expired capacity leases.", "properties": { "method": { "const": "ReclaimExpiredCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_CapacityReclaimRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ReclaimWorkItemResources": { "additionalProperties": false, "description": "Atomically reclaim an expired or superseded reservation. A stale worker\ncannot use this operation to release a newer attempt's capacity.", "properties": { "method": { "const": "ReclaimWorkItemResources", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_ResourceReservationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RecomputeMaterialization": { "additionalProperties": false, "description": "Fenced recompute/writeback for one stale materialization. The expected source\ngraph version must exactly match the durable reasoning projection watermark.\nReplicated serving commits an opaque recompute intent with the authoritative\ngraph version fence, then the durable outbox worker resolves provenance from\nthe graph post-image and fsyncs the side projection before acknowledging it.\nA late recompute fails with `STALE_RECOMPUTE_FENCE` rather than overwriting a\nnewer invalidation.", "properties": { "method": { "const": "RecomputeMaterialization", "type": "string" }, "params": { "additionalProperties": false, "properties": { "derived_id": { "type": "string" }, "expected_source_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "derived_id", "expected_source_graph_version" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Reconcile": { "additionalProperties": false, "properties": { "method": { "const": "Reconcile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph_name": { "type": "string" }, "msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "graph_name", "msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ReconcileCapacity": { "additionalProperties": false, "description": "Return bounded native cells/leases for reconciliation and status.", "properties": { "method": { "const": "ReconcileCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_CapacityStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RefreshMatView": { "additionalProperties": false, "description": "Incrementally refresh a materialized view after the underlying graphs changed \u2014\nrecomputes only the affected vertices on the delta. Returns the row count.", "properties": { "method": { "const": "RefreshMatView", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RegisterContinuousQuery": { "additionalProperties": false, "description": "Register a continuous query (CONCEPT:EG-KG.query.streaming-cdc-subscriptions): a named, incrementally-\nmaintained aggregate/filter view over a graph's CDC feed. `spec_msgpack` is a\nMessagePack `ContinuousQuerySpec`. Returns a `String` (the name). Re-registering\nthe same name replaces it (and re-seeds from the current graph state).", "properties": { "method": { "const": "RegisterContinuousQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "spec_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "name", "spec_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RegisterForeignSource": { "additionalProperties": false, "description": "Register (or replace) a foreign RowSet source under `name`. `source` is the\n[`crate::wire::ForeignSourceSpec`] (a remote engine or an HTTP/JSON API). A\nlater `ForeignScan` can name this registered source by id (the registry-backed\nform) instead of inlining the whole spec. Returns the name on success.", "properties": { "method": { "const": "RegisterForeignSource", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "source": { "$ref": "#/components/schemas/ReqDef_ForeignSourceSpec" } }, "required": [ "name", "source" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RegisterIdentity": { "additionalProperties": false, "properties": { "method": { "const": "RegisterIdentity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "role": { "$ref": "#/components/schemas/ReqDef_AgentRole" }, "roles": { "description": "RBAC role names this agent holds (CONCEPT:EG-KG.compute.feature).", "items": { "type": "string" }, "type": "array" }, "signature": { "type": "string" }, "teams": { "items": { "type": "string" }, "type": "array" } }, "required": [ "agent_id", "role", "teams", "signature", "roles" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RegisterServer": { "additionalProperties": false, "description": "Push-register (or renew, idempotently) this server's fleet identity\n(CONCEPT:EG-KG.sharding.server-registry) as a `:Server` node in\n`__commons__`. `name` becomes the node id `srv:` (must match\n`^[A-Za-z0-9_.-]{1,128}$`, the same bound au's config-sync ingestion\nenforces); `url` is a bounded opaque endpoint reference (never a raw\ncredentialed URL \u2014 callers pass the same kind of privacy-safe reference\nau's `persistence_reference` produces); `resources_json` is an optional,\nsize-bounded opaque JSON object (non-sensitive metadata, mirrors au's\n`_mcp_persistence_resources`); `ttl_secs` is the caller's requested lease\nduration (bounded server-side). The SERVER computes the absolute\n`lease_expires_at_ms`/`last_heartbeat_ms` from its own clock \u2014 it never\ntrusts a caller-supplied timestamp. Re-calling with the SAME `name`\nrenews the lease (a heartbeat is just a repeat `RegisterServer` call) and\nrefreshes every other field, exactly like the internal topology self-report\nsemantics; `registered_at_ms` is preserved from the prior row if one\nexists. A periodic engine sweep expires (removes) a `:Server` node whose\nlease has lapsed, emitting a CDC `RemoveNode` event. Returns `Bool` on\nsuccess.\n\n`transport` and `desired` are the operator's typed registration claim\n(how the server is reached, and whether it should be used). Both default\nfor a caller that predates them: `unspecified` and `enabled`.", "properties": { "method": { "const": "RegisterServer", "type": "string" }, "params": { "additionalProperties": false, "properties": { "desired": { "$ref": "#/components/schemas/ReqDef_ServerDesiredState", "default": "enabled" }, "name": { "type": "string" }, "resources_json": { "default": "", "type": "string" }, "transport": { "$ref": "#/components/schemas/ReqDef_ServerTransport", "default": "unspecified" }, "ttl_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "url": { "type": "string" } }, "required": [ "name", "url", "ttl_secs" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RegisterTrigger": { "additionalProperties": false, "description": "Register a trigger/reaction (CONCEPT:EG-KG.query.wire-codec): when a CDC change in `graph`\nmatches `label` (empty \u21d2 any) + `op` (\"add\"|\"remove\"|\"update\"|\"any\"), record a\nfiring carrying `action_msgpack` (an opaque reaction payload). Returns the name.", "properties": { "method": { "const": "RegisterTrigger", "type": "string" }, "params": { "additionalProperties": false, "properties": { "action_msgpack": { "default": [], "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "graph": { "type": "string" }, "label": { "default": "", "type": "string" }, "name": { "type": "string" }, "op": { "type": "string" } }, "required": [ "name", "graph", "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RegisterUdf": { "additionalProperties": false, "description": "Register (compile + cache) a WASM UDF under `id`. `wasm` is the module bytes\n(the `.wasm` binary). The module must export `memory`/`alloc`/`udf` and import\nNOTHING (the empty linker rejects any host import). Replaces a prior UDF of the\nsame id. Returns the id on success.", "properties": { "method": { "const": "RegisterUdf", "type": "string" }, "params": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "wasm": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "id", "wasm" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Reinforce": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 reinforce a memory node: bump access/recency +\nimportance as of the EXPLICIT `now_ms` (no server clock \u21d2 deterministic\nreplay). Returns `Bool` (whether the node existed).", "properties": { "method": { "const": "Reinforce", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "weight": { "format": "double", "type": "number" } }, "required": [ "node_id", "now_ms", "weight" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ReleaseCapacity": { "additionalProperties": false, "description": "Release every named capacity lease in one all-or-nothing transaction.", "properties": { "method": { "const": "ReleaseCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_CapacityLeaseMutationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ReleaseWorkItemResources": { "additionalProperties": false, "description": "Atomically release the exact current/terminal WorkItem reservation while\nretaining its lifecycle tombstone for exact idempotent replay.", "properties": { "method": { "const": "ReleaseWorkItemResources", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_ResourceReservationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RemoveEdge": { "additionalProperties": false, "properties": { "method": { "const": "RemoveEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RemoveNode": { "additionalProperties": false, "properties": { "method": { "const": "RemoveNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RemoveTriples": { "additionalProperties": false, "description": "Physically RETRACT triples from the request's graph (CONCEPT:EG-KG.query.named-graph-support) \u2014 the\ninverse of `AddTriples`. Parses `turtle` OR `ntriples` (exactly one non-empty)\nand surgically removes each triple (a literal triple drops the property cell; a\nresource triple removes the one matching typed edge). DURABLE (WAL-replayed by\nre-parsing + re-removing). This is the reusable retract op the ontology UNLOAD\npath + SPARQL `DELETE DATA` build on. Returns a `Raw` count. Gated `rdf`.", "properties": { "method": { "const": "RemoveTriples", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ntriples": { "default": "", "description": "N-Triples document (empty \u21d2 use `turtle`).", "type": "string" }, "turtle": { "default": "", "description": "Turtle document (empty \u21d2 use `ntriples`).", "type": "string" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RenewCapacity": { "additionalProperties": false, "description": "Renew every named capacity lease in one all-or-nothing transaction.", "properties": { "method": { "const": "RenewCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_CapacityLeaseMutationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RenewDevelopmentLane": { "additionalProperties": false, "description": "Renew one existing lane hold in place. This never appends a WorkItem or\nhistory row and requires the current WorkItem lease/fence.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "RenewDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneRenewRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RenewWorkItemLease": { "additionalProperties": false, "description": "Renew an existing WorkItem lease. Both epoch and fencing token must match\nthe durable row, preventing a superseded worker from extending ownership.", "properties": { "method": { "const": "RenewWorkItemLease", "type": "string" }, "params": { "additionalProperties": false, "properties": { "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant": { "type": "string" }, "work_item_id": { "type": "string" }, "worker_id": { "type": "string" } }, "required": [ "tenant", "work_item_id", "worker_id", "lease_epoch", "fencing_token", "now_ms", "lease_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Reparent": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 re-parent scene object `node_id` under `new_parent`\n(`None` \u21d2 detach to a root). Deterministic. Returns `Bool` (whether it acted).", "properties": { "method": { "const": "Reparent", "type": "string" }, "params": { "additionalProperties": false, "properties": { "new_parent": { "type": [ "string", "null" ] }, "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ReserveDevelopmentLane": { "additionalProperties": false, "description": "Atomically allocate the typed development-lane hold for the exact\n`lane.lifecycle` WorkItem attempt/fence. Branch and managed-worktree\nuniqueness plus every configured quota scope are charged together.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "ReserveDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneReserveRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ReserveWorkItemResources": { "additionalProperties": false, "description": "Atomically reserve the immutable shared-host resources for the exact\nWorkItem attempt/fence. The engine re-reads the WorkItem admission\nextension and host records; request fields are assertions, never a\ncaller-owned reservation ledger.", "properties": { "method": { "const": "ReserveWorkItemResources", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_ResourceReservationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Reshard": { "additionalProperties": false, "description": "Online-move `graph`'s durable rows to shard `to_shard` while the engine RUNS,\nthen flip the catalog route (CONCEPT:EG-KG.backend.catalog-shard-resolve). Returns a `ReshardReport` JSON.", "properties": { "method": { "const": "Reshard", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "to_shard": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "to_shard" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ResolveCandidates": { "additionalProperties": false, "description": "Native entity-resolution candidate generator (CONCEPT:AU-KG.compute.when-exposes-native) \u2014 composes\nembedding similarity + clustering into one server-side READ op that returns\nmerge proposals (same_as / extends). Never mutates; the client applies via\n`BatchUpdate`. The escalation tier for the agent-utilities dedup ladder.", "properties": { "method": { "const": "ResolveCandidates", "type": "string" }, "params": { "additionalProperties": false, "properties": { "merge_threshold": { "format": "double", "type": "number" }, "node_type": { "default": null, "type": [ "string", "null" ] }, "sim_threshold": { "format": "double", "type": "number" } }, "required": [ "sim_threshold", "merge_threshold" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ResolveConflict": { "additionalProperties": false, "description": "EPI-P3-7 (gap-fill) \u2014 standalone paraconsistent conflict resolution: run Dung\nabstract-argumentation semantics (`eg_epistemic::tms`, feature `epistemic-tms`)\nover a `BeliefGraph` built from the caller's `GraphView`, and report \u2014 for each\nof `node_ids` \u2014 whether it SURVIVES, is DEFEATED, or stays UNDECIDED under\n`semantics` (`\"grounded\"` (default) | `\"preferred\"` | `\"stable\"`). This is the\nSAME grounded/preferred/stable extension machinery `Method::EpistemicStatus`\nalready composes internally (via `is_skeptically_accepted`) for a single claim's\nacceptance \u2014 reachable here as a standalone, multi-claim, semantics-selectable\nop instead of only inside that capstone. Returns a `ResolveConflictResult`\n(surviving/defeated/undecided id lists + the raw extension set(s) the verdict\nwas computed from) via `ResultPayload::raw`. Gated `epistemic` at the wire\nlevel; the HANDLER additionally requires `epistemic-tms` \u2014 a build with\n`epistemic` but not `epistemic-tms` falls to the graph_ops \"not available in\nthis build\" catch-all (same convention as `EpistemicStatus`/`WhatChanged`).", "properties": { "method": { "const": "ResolveConflict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" }, "semantics": { "default": "grounded", "type": "string" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ResourceReservationStatus": { "additionalProperties": false, "description": "Bounded native reservation reconciliation/status read. No local mirror\nis sufficient to answer this operation.", "properties": { "method": { "const": "ResourceReservationStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_ResourceReservationStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ResourceStatsPage": { "additionalProperties": false, "description": "Return one bounded, ACL-filtered ResourceStats page. `cursor` is an opaque\nexclusive graph-name key from the previous response's `next_cursor`; `limit`\nmust be between one and the server's finite maximum; `summary` suppresses all\nper-graph/per-tenant arrays while retaining aggregate counters. The body is\nthe only current resource-statistics request shape.", "properties": { "method": { "const": "ResourceStatsPage", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "default": null, "type": [ "string", "null" ] }, "limit": { "default": 128, "format": "uint", "minimum": 0, "type": "integer" }, "summary": { "default": false, "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Restore": { "additionalProperties": false, "description": "Restore the logical bundle name `source` from the operator-provisioned backup\nroot (CONCEPT:EG-KG.sharding.reshard-on-restore). The engine holds an\nexclusive lock on its live store, so this stages the rebuilt copy in an\nengine-owned sibling directory and returns only an opaque stage reference for\nthe operator to correlate after stopping the engine;\nan in-place restore uses the offline `restore` CLI. Returns a `RestoreReport` JSON.", "properties": { "method": { "const": "Restore", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source": { "type": "string" }, "target_shards": { "description": "Required current target layout. Setting this to a different value from the\nbundle proves restore-time migration rather than silently preserving K.", "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "source", "target_shards" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Rollback": { "additionalProperties": false, "properties": { "method": { "const": "Rollback", "type": "string" }, "params": { "additionalProperties": false, "properties": { "txn_id": { "type": "string" } }, "required": [ "txn_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RunDatalogReasoning": { "additionalProperties": false, "properties": { "method": { "const": "RunDatalogReasoning", "type": "string" }, "params": { "additionalProperties": false, "properties": { "domain_rules": { "default": [], "description": "(property, domain_type) \u2014 subjects of `property` are inferred to be `domain_type`.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "inverse_properties": { "default": [], "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "property_chains": { "default": [], "description": "(predicate_a, predicate_b, inferred_predicate) \u2014 chain composition.", "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "range_rules": { "default": [], "description": "(property, range_type) \u2014 objects of `property` are inferred to be `range_type`.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "subclass_relations": { "default": [], "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "subproperty_relations": { "default": [], "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "symmetric_properties": { "default": [], "items": { "type": "string" }, "type": "array" }, "transitive_properties": { "default": [], "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RunRules": { "additionalProperties": false, "properties": { "method": { "const": "RunRules", "type": "string" }, "params": { "additionalProperties": false, "properties": { "derived_only": { "default": false, "description": "When true, return only the DERIVED facts (omit the asserted base).", "type": "boolean" }, "min_confidence": { "default": 0.0, "description": "Drop facts whose confidence is below this threshold.", "format": "double", "type": "number" }, "ontology_ttl": { "default": "", "description": "Optional Turtle carrying extra TBox axioms AND/OR ABox facts (empty \u21d2 reason\nover the graph's own folded axioms/facts only).", "type": "string" }, "query_predicate": { "default": null, "description": "When set, restrict the returned facts to this predicate (IRI or bare name).", "type": [ "string", "null" ] }, "rules": { "default": [], "description": "User rule strings (SWRL-ish / Datalog syntax).", "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_RunUdf": { "additionalProperties": false, "description": "Run a registered WASM UDF `id` over an opaque `input` payload, returning the\nUDF's output bytes (`ResultPayload::Raw`). Sandboxed + fuel-limited: an\ninfinite-loop UDF is KILLED (a trap error), never a hang. The bytes are opaque\nto the engine \u2014 the caller serializes/deserializes its own row payload.", "properties": { "method": { "const": "RunUdf", "type": "string" }, "params": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "input": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "id", "input" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SceneChildren": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 the direct transform children of scene object\n`node_id` (targets of its `HAS_CHILD` edges), sorted + deduped. Read-only.\nReturns `Ids`.", "properties": { "method": { "const": "SceneChildren", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SemanticIndex": { "additionalProperties": false, "description": "Drive one durable semantic binding and its S1-S6 tiered ingestion\nqueue (RF-019). This is the surface an external connector uses to make\nsomething searchable: admit a binding, feed authoritative SQL source\nrows into S1, then subscribe a worker, claim stage leases for its queue\nclass, and complete each stage against its predecessor proof.\n\nBoxed, unlike the four agent layers beside it: `SemanticIndexOp`'s\nstage-completion variants carry a lease, a transition, an artifact and a\nsuccessor intent together, which is far larger than any agent op and\nwould otherwise set the size of EVERY `Method`. `Box` is transparent to\nserde, so the wire form is unchanged.\n\nDeclared unconditionally, like the `semantic_index` DTO module it is\nbuilt from: the wire contract is one contract in every build. The\nengine-side durable tier it needs is what carries the `ann-redb` gate,\nso the dispatch arm refuses by name in a build without it -- exactly\nhow the four agent layers refuse in a build without `redb`.", "properties": { "method": { "const": "SemanticIndex", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_SemanticIndexOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SemanticSearch": { "additionalProperties": false, "properties": { "method": { "const": "SemanticSearch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "n_results": { "format": "uint", "minimum": 0, "type": "integer" }, "query_embedding": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "query_embedding", "n_results" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SendMessage": { "additionalProperties": false, "properties": { "method": { "const": "SendMessage", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "payload": { "type": "string" }, "sender": { "type": "string" } }, "required": [ "channel_id", "sender", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ServedModality": { "additionalProperties": false, "properties": { "method": { "const": "ServedModality", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_ServedModalityOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SetPose": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 overwrite scene object `node_id`'s LOCAL pose with\n`pose_msgpack`. Deterministic. Returns `Bool` (whether the node existed).", "properties": { "method": { "const": "SetPose", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "pose_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "node_id", "pose_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ShaclValidate": { "additionalProperties": false, "description": "Validate `data_graph` against SHACL constraints (CONCEPT:EG-KG.ontology.concept-6).\nOmitted or empty `shapes` selects the request graph's composed\nGraphSchema shapes (immutable core plus its attached dynamic sources).\nA non-empty document remains an explicit, ad-hoc shapes graph.\nAn EMPTY `data_graph` validates against the LIVE RDF of the request's graph (the\nsame triples `GetRdf` would export). Returns a `Json` `sh:ValidationReport`.\nRead-only. Handler gated `shacl` (implies `rdf`).", "properties": { "method": { "const": "ShaclValidate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data_graph": { "default": "", "description": "The data graph as a Turtle document; empty \u21d2 use the request's live graph.", "type": "string" }, "shapes": { "default": null, "description": "An explicit shapes graph as Turtle. Omitted/empty uses the request\ngraph's composed GraphSchema authority.", "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ShexValidate": { "additionalProperties": false, "description": "Validate `data_graph` against a **ShExJ** `schema` for a `shape_map` (a list of\n`[node_iri, shape_label]` pairs; `\"START\"` selects the schema's start shape)\n(CONCEPT:EG-KG.compute.concept-2). `data_graph` is an RDF Turtle document; an EMPTY `data_graph`\nvalidates against the LIVE RDF of the request's graph (the same triples `GetRdf`\nwould export). Returns a `Json` `ShexReport`. Read-only. Handler gated `shex`\n(implies `rdf`).", "properties": { "method": { "const": "ShexValidate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data_graph": { "default": "", "description": "The data graph as a Turtle document; empty \u21d2 use the request's live graph.", "type": "string" }, "schema": { "description": "The ShEx schema as a ShExJ (JSON abstract-syntax) document.", "type": "string" }, "shape_map": { "default": [], "description": "The shape map: `[node_iri, shape_label]` pairs. `shape_label` may be `\"START\"`.", "items": { "items": { "type": "string" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": "array" } }, "required": [ "schema" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Shutdown": { "additionalProperties": false, "properties": { "method": { "const": "Shutdown", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_Solve": { "additionalProperties": false, "description": "General bounded 0-1 integer programme with an independently verifiable\ncertificate. Pure compute: no store, no clock, no float.", "properties": { "method": { "const": "Solve", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_SolveRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SourceIngest": { "additionalProperties": false, "description": "RF-ADR-009 native ingestion authority. Resolves the exact Connector\nManifest mapping under the verified tenant, admits raw records to CAS,\nmaps them and atomically commits graph material, provenance and cursor.", "properties": { "method": { "const": "SourceIngest", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_SourceIngestionRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SourceIngestStatus": { "additionalProperties": false, "description": "Latest authoritative SourceIngest checkpoint for restart/failover CAS\nrecovery. Tenant and graph are taken only from verified request context.", "properties": { "method": { "const": "SourceIngestStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "connector": { "type": "string" }, "stream": { "type": "string" } }, "required": [ "connector", "stream" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Sparql": { "additionalProperties": false, "description": "Evaluate a SPARQL 1.1 SELECT over the request's graph (CONCEPT:EG-KG.ontology.concept-11).\nReturns a `Raw` [`SparqlResult`] (`{vars, rows}`; each row a cell list aligned\nto `vars`, an unbound cell is `nil`). Read-only. Gated `sparql`.\n\n`base_iri` + `type_convention` carry an OPTIONAL LPG\u2192RDF projection vocabulary\n(CONCEPT:EG-KG.ontology.lpg-rdf-projection-vocabulary). Both default to empty \u21d2 the IDENTITY projection (node-type\nand property keys emitted verbatim, no `rdf:type` synthesis), which preserves\nthe prior behavior for every existing caller. A caller (e.g. agent-utilities)\nthat sets `base_iri = \"http://agent-utilities.dev/ontology#\"` +\n`type_convention = \"camel\"` makes the engine project the LIVE property graph\ninto that vocabulary \u2014 ` rdf:type ` and\n` ` \u2014 so a by-class query (`?s a au:Agent`) resolves\nnatively. The engine itself hardcodes NO ontology URL; the vocabulary is the\ncaller's.", "properties": { "method": { "const": "Sparql", "type": "string" }, "params": { "additionalProperties": false, "properties": { "base_iri": { "default": "", "description": "Projection base namespace IRI. Empty \u21d2 identity projection.", "type": "string" }, "query": { "type": "string" }, "type_convention": { "default": "", "description": "`rdf:type` object naming: `\"camel\"` \u21d2 CamelCase the type local name under\n`base_iri`; empty / `\"raw\"` \u21d2 verbatim. Only meaningful with `base_iri`.", "type": "string" } }, "required": [ "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SparqlVirtual": { "additionalProperties": false, "description": "OBDA / R2RML VIRTUAL GRAPH query (CONCEPT:EG-KG.query.r2rml-virtual-graph /\nCONCEPT:EG-KG.query.obda-query-rewrite) \u2014 Ontology-Based Data Access: run a SPARQL query\nagainst a set of foreign tabular sources exposed as RDF via an R2RML-style\nmapping, WITHOUT ever materializing the whole dataset. `tables` names the\nengine's OWN SQL user tables (the `eg_query::TableStore` behind `query`, the same\nstore `Method::Sql` DDL/DML and `ImportSqliteFile` write) to register as foreign\nsources under their own table name (a [`TriplesMap::logical_source`] target);\n`mapping` is either a standard R2RML Turtle document (`@prefix rr: \u2026`) or the\ncompact EG-101 textual form (`SOURCE`/`SUBJECT`/`CLASS`/`COLUMN`/`REF`/`CONST`\ndirectives) \u2014 auto-detected. The query rewrites to a projection-pushed scan of\nonly the query-relevant table columns (see `eg_rdf::obda`), materializes ONLY\nthose triples into a transient view, and evaluates the SAME SPARQL engine over\nit \u2014 so this is a REAL query-rewrite OBDA path, not a full ETL/materialize step.\nReturns a `Raw` [`SparqlResult`]. Read-only (never writes the user table OR the\nrequest's graph). Gated `obda` (implies `sparql` + `query`).", "properties": { "method": { "const": "SparqlVirtual", "type": "string" }, "params": { "additionalProperties": false, "properties": { "external_sources": { "default": [], "description": "LIVE external relational sources (Postgres/MySQL) registered as foreign OBDA\nsources IN ADDITION to `tables` (CONCEPT:EG-KG.query.obda-predicate-pushdown,\nW4.11). Each binds a `logical_source` name to an external DB table; the query's\ncolumn projection AND its row-level `FILTER`s are pushed into a real\n`SELECT \u2026 WHERE \u2026`. Needs a `federation-sql` server build for the live path.\nEmpty \u21d2 engine-own-tables-only (the prior behavior).", "items": { "$ref": "#/components/schemas/ReqDef_ObdaExternalSource" }, "type": "array" }, "mapping": { "description": "An R2RML Turtle document OR the compact EG-101 textual mapping form.", "type": "string" }, "query": { "description": "The SPARQL query to run against the virtual graph.", "type": "string" }, "tables": { "description": "The user-table names the mapping's `TriplesMap`s reference as\n`logical_source`s \u2014 each is registered as a foreign source under its own\nname before the mapping is parsed and the query is run.", "items": { "type": "string" }, "type": "array" } }, "required": [ "query", "mapping", "tables" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Sql": { "additionalProperties": false, "properties": { "method": { "const": "Sql", "type": "string" }, "params": { "additionalProperties": false, "properties": { "params_msgpack": { "default": [], "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "query": { "type": "string" } }, "required": [ "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SqlSourceBatch": { "additionalProperties": false, "description": "Typed SQL source batch. One native SQL-catalog MutationBatch commits the\nrows, provider cursor, exact source epoch, terminal result and dirty outbox\natomically. Its authority is process-local: clustered mode refuses it.", "properties": { "method": { "const": "SqlSourceBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "batch": { "$ref": "#/components/schemas/ReqDef_SqlSourceBatchRequest" } }, "required": [ "batch" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_StaleMaterializations": { "additionalProperties": false, "description": "Seam 3 follow-up (SURPASS gap-closure: \"give staleness a consumer\") \u2014 the bulk\ncounterpart of [`Method::MaterializationStatus`]: every opaque materialization\nreference CURRENTLY `Stale` in this graph's durable projection.\nSame build-tier fallback convention as `MaterializationStatus`.", "properties": { "method": { "const": "StaleMaterializations", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_StartTrajectory": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-099 \u2014 START (or UPSERT) a `:Trajectory` (episode).\n`props_msgpack` is a MessagePack-encoded JSON object (an `id` string is\nhonoured). The id derives deterministically from `(live node count, props)`,\nmonotonic under replay, so WAL replay reproduces it. Returns the trajectory id\n(`String`).", "properties": { "method": { "const": "StartTrajectory", "type": "string" }, "params": { "additionalProperties": false, "properties": { "props_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "props_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Statechart": { "additionalProperties": false, "description": "The native finite-state-machine / statechart engine (CONCEPT:INT-P2-2):\ndefine/instantiate/send_event/get_state/list over a durable, rehydratable\n`MachineInstance` `(state, context)` record in `statecharts.redb` (`eg-statechart`).\nONE variant wrapping an internal op enum \u2014 mirrors `AnalyticsJob { op }` above \u2014\nso the whole engine surface costs exactly one `Method` arm. Gated `statechart`;\nthe handler (`src/server/handlers/statechart.rs`) self-routes in `dispatch.rs`\nbefore the per-graph chain (instances are keyed by `instance_id` in their own\n`statecharts.redb`, not a graph \u2014 like `AnalyticsJob`/`TsAppend`/`Kv*`).", "properties": { "method": { "const": "Statechart", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_StatechartOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_StreamCommitOffset": { "additionalProperties": false, "description": "Commit a consumer-group's read `offset` on `stream` so it can resume\n(CONCEPT:EG-KG.compute.replayable-append-log). Idempotent upsert; returns `String(\"ok\")`.", "properties": { "method": { "const": "StreamCommitOffset", "type": "string" }, "params": { "additionalProperties": false, "properties": { "group": { "type": "string" }, "offset": { "format": "int64", "type": "integer" }, "stream": { "type": "string" } }, "required": [ "stream", "group", "offset" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_StreamCommittedOffset": { "additionalProperties": false, "description": "Read a consumer-group's committed offset on `stream` (CONCEPT:EG-KG.compute.replayable-append-log). Returns\n`Raw(Option)` \u2014 nil \u21d2 the group has never committed. Read-only.", "properties": { "method": { "const": "StreamCommittedOffset", "type": "string" }, "params": { "additionalProperties": false, "properties": { "group": { "type": "string" }, "stream": { "type": "string" } }, "required": [ "stream", "group" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_StreamDeclare": { "additionalProperties": false, "description": "Declare (idempotently upsert) a stream's retention policy (CONCEPT:EG-KG.compute.replayable-append-log).\nBoth bounds optional \u2014 an all-`None` policy is an unbounded append log that a\ntrim never touches. Also ensures the offset counter so the stream is publishable.\nReturns `String(\"ok\")`.", "properties": { "method": { "const": "StreamDeclare", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_age_ms": { "description": "Drop messages older than this many ms (`now_ms - ts`) on trim.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "max_messages": { "description": "Keep at most this many newest messages (older dropped on trim).", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "stream": { "type": "string" } }, "required": [ "stream" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_StreamPublish": { "additionalProperties": false, "description": "Append `payload` to `stream`, returning its assigned monotonic offset (`Count`)\n(CONCEPT:EG-KG.compute.replayable-append-log). The message is RETAINED (read by offset), never auto-consumed.", "properties": { "method": { "const": "StreamPublish", "type": "string" }, "params": { "additionalProperties": false, "properties": { "now_ms": { "description": "Caller clock (ms) stamped as the message `ts` for age-based retention.", "format": "uint64", "minimum": 0, "type": "integer" }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "stream": { "type": "string" } }, "required": [ "stream", "payload", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_StreamRead": { "additionalProperties": false, "description": "Read up to `max` retained messages from `stream` starting at `from_offset`,\nWITHOUT deleting (CONCEPT:EG-KG.compute.replayable-append-log \u2014 replay). `from_offset < 0` \u21d2 from the current\nend (\"only new\"); `0` \u21d2 earliest; otherwise that explicit offset. `max == 0` \u21d2\nuncapped. Returns `Raw(Vec<(offset, payload)>)` ascending by offset. Read-only.", "properties": { "method": { "const": "StreamRead", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from_offset": { "format": "int64", "type": "integer" }, "max": { "format": "uint64", "minimum": 0, "type": "integer" }, "stream": { "type": "string" } }, "required": [ "stream", "from_offset", "max" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_StreamTrim": { "additionalProperties": false, "description": "Trim `stream` per its declared retention (CONCEPT:EG-KG.compute.replayable-append-log): drop messages beyond\n`max_messages` (oldest first) and/or older than `max_age_ms`. Returns `Count`\nof messages removed. An undeclared / unbounded stream trims nothing.", "properties": { "method": { "const": "StreamTrim", "type": "string" }, "params": { "additionalProperties": false, "properties": { "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "stream": { "type": "string" } }, "required": [ "stream", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_StronglyConnectedComponents": { "additionalProperties": false, "properties": { "method": { "const": "StronglyConnectedComponents", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_SubmitWorkItem": { "additionalProperties": false, "description": "Idempotent WorkItem admission and command-log append.", "properties": { "method": { "const": "SubmitWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_SubmitWorkItemRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SubmitWorkItems": { "additionalProperties": false, "description": "Bounded all-or-nothing WorkItem admission batch.", "properties": { "method": { "const": "SubmitWorkItems", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_SubmitWorkItemsRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SummariesAtLevel": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-220 \u2014 all summary node ids at abstraction `level`, sorted +\ndeduped. Read-only. Returns `Ids`.", "properties": { "method": { "const": "SummariesAtLevel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "level": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "level" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SummaryChildren": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-220 \u2014 the direct children of summary node `node_id` (targets\nof its `SUMMARIZES` edges), sorted + deduped. Read-only. Returns `Ids`.", "properties": { "method": { "const": "SummaryChildren", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SupersedeEdge": { "additionalProperties": false, "description": "Atomically supersede a prior edge with a new one (KG-2.251): close the prior\nedge's validity window and insert `properties_msgpack` as the new edge under\none write guard. Non-destructive \u2014 the prior edge survives for history.", "properties": { "method": { "const": "SupersedeEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "prior_relationship": { "type": "string" }, "prior_source": { "type": "string" }, "prior_target": { "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "source_id": { "type": "string" }, "target_id": { "type": "string" }, "tx_now": { "format": "uint64", "minimum": 0, "type": "integer" }, "valid_at": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source_id", "target_id", "properties_msgpack", "prior_source", "prior_target", "prior_relationship", "valid_at", "tx_now" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_SweepExpired": { "additionalProperties": false, "description": "Reaper sweep (CONCEPT:EG-KG.compute.message-ttl-expiry): dead-letter/drop messages whose `expires_at`\nhas passed and return messages whose visibility lease has expired to claimable,\nacross every known queue. Called periodically by the scheduler with the current\nclock. Returns `Count` of messages acted on.", "properties": { "method": { "const": "SweepExpired", "type": "string" }, "params": { "additionalProperties": false, "properties": { "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_ToMsgpack": { "additionalProperties": false, "properties": { "method": { "const": "ToMsgpack", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_TopologicalSort": { "additionalProperties": false, "properties": { "method": { "const": "TopologicalSort", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_TouchNodes": { "additionalProperties": false, "properties": { "method": { "const": "TouchNodes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TransitionControlLease": { "additionalProperties": false, "description": "Move one control lease along a legal edge (`active -> consumed |\nrevoked | expired`, `consumed -> revoked | expired`), compare-and-set\non the revision the caller read. A lease never returns to `active`.", "properties": { "method": { "const": "TransitionControlLease", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_TransitionControlLeaseRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TsAppend": { "additionalProperties": false, "properties": { "method": { "const": "TsAppend", "type": "string" }, "params": { "additionalProperties": false, "properties": { "bucket_ns": { "description": "Bucket/time-partition width in nanoseconds (series-creation parameter).", "format": "uint64", "minimum": 0, "type": "integer" }, "field_names": { "default": [], "description": "Optional field names (series-creation metadata).", "items": { "type": "string" }, "type": "array" }, "n_fields": { "description": "Field count per point (1 for a scalar series, N for OHLCV\u2026). Used only\nwhen the series is NEW; an existing series' stored schema wins.", "format": "uint", "minimum": 0, "type": "integer" }, "points_msgpack": { "description": "MessagePack `Vec<(i64, Vec)>` \u2014 the batch of points (one round-trip).", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "series_id": { "type": "string" } }, "required": [ "series_id", "n_fields", "bucket_ns", "points_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TsAsofJoin": { "additionalProperties": false, "properties": { "method": { "const": "TsAsofJoin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "left_ts_msgpack": { "description": "MessagePack `Vec` \u2014 the left event timestamps (ns).", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "series_id": { "description": "The \"right\" series each left event is joined to by nearest-prior ts.", "type": "string" }, "tolerance": { "default": 0, "description": "Optional tolerance (ns); a match older than this is dropped (`None` =\nunbounded). `-1` encodes `None` over the wire.", "format": "int64", "type": "integer" } }, "required": [ "series_id", "left_ts_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TsDeleteSeries": { "additionalProperties": false, "description": "Retention: drop `series_id` ENTIRELY -- every chunk plus its meta row -- in\none durable write. Same legal-hold boundary as `TsEvict`. Returns the number\nof chunks removed (`ResultPayload::Count`; `0` for an unknown or held\nseries). Unlike `TsEvict`, a subsequently re-appended series with the same\nid starts fresh (no stale count/span carried over).", "properties": { "method": { "const": "TsDeleteSeries", "type": "string" }, "params": { "additionalProperties": false, "properties": { "series_id": { "type": "string" } }, "required": [ "series_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TsEvict": { "additionalProperties": false, "description": "Retention: drop every point of `series_id` strictly older than `cutoff` (ns).\nA whole-series-empty legal hold blocks this (`SeriesStore::evict_before`) --\nheld data survives a retention sweep, provably. Returns the number of WHOLE\nchunk buckets removed (`ResultPayload::Count`); a straddling bucket is\ntrimmed in place rather than counted as removed. This is the SECOND durable\nwrite in the `Ts*` family (alongside `TsAppend`) -- routed through the same\n`MutationBatch`-compiled path so retention is commit-before-ack durable, not\na best-effort background trim.", "properties": { "method": { "const": "TsEvict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cutoff": { "format": "int64", "type": "integer" }, "series_id": { "type": "string" } }, "required": [ "series_id", "cutoff" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TsGapFill": { "additionalProperties": false, "properties": { "method": { "const": "TsGapFill", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from": { "format": "int64", "type": "integer" }, "series_id": { "type": "string" }, "step": { "description": "Grid step (ns) for the LOCF densification.", "format": "int64", "type": "integer" }, "to": { "format": "int64", "type": "integer" } }, "required": [ "series_id", "from", "to", "step" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TsListSeries": { "additionalProperties": false, "description": "Enumerate every series id under the CALLER's own tenant+graph scope (never\ncross-tenant/cross-graph -- mirrors every other `Ts*` method's `scoped_key`\nderivation). Returns the caller-facing series ids as `ResultPayload::raw`\n(`Vec`), decoded server-side from the store's internally-encoded\n`SeriesKey`s and filtered to this scope -- the encoded key itself never\ncrosses the wire. This is what makes `TsEvict`/`TsDeleteSeries` reachable\nfor a multi-series retention sweep: without an enumeration primitive a\ncaller has no way to discover which series exist to retain/evict at all.", "properties": { "method": { "const": "TsListSeries", "type": "string" } }, "required": [ "method" ], "type": "object" }, "Req_TsRange": { "additionalProperties": false, "properties": { "method": { "const": "TsRange", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from": { "description": "Inclusive lower / exclusive upper ts bound (ns).", "format": "int64", "type": "integer" }, "series_id": { "type": "string" }, "to": { "format": "int64", "type": "integer" } }, "required": [ "series_id", "from", "to" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TsWindow": { "additionalProperties": false, "properties": { "method": { "const": "TsWindow", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agg": { "description": "Aggregate function: one of first/last/min/max/mean/sum/count.", "type": "string" }, "from": { "format": "int64", "type": "integer" }, "series_id": { "type": "string" }, "to": { "format": "int64", "type": "integer" }, "width": { "description": "Window width (ns) for the bucketed aggregate.", "format": "int64", "type": "integer" } }, "required": [ "series_id", "from", "to", "width", "agg" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnAddEdge": { "additionalProperties": false, "properties": { "method": { "const": "TxnAddEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "source_id": { "type": "string" }, "target_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "source_id", "target_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnAddEmbedding": { "additionalProperties": false, "description": "Stage a VECTOR upsert into a txn (CONCEPT:EG-KG.txn.reader-never-sees-node \u2014 cross-modal ACID). The\nembedding lands atomically WITH the txn's graph/property/blob-ref writes in ONE\nredb `WriteTransaction` at commit \u2014 never a node without its vector.", "properties": { "method": { "const": "TxnAddEmbedding", "type": "string" }, "params": { "additionalProperties": false, "properties": { "embedding": { "items": { "format": "float", "type": "number" }, "type": "array" }, "graph": { "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id", "embedding" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnAddMeasurement": { "additionalProperties": false, "description": "Stage a TIME-SERIES measurement batch into a txn (CONCEPT:EG-KG.backend.cross-modal-atomic-commit \u2014 extended\ncross-modal staging). The points land atomically WITH the txn's graph/property/\nvector/blob writes in ONE redb `WriteTransaction` at commit \u2014 never a node\nwithout its measurements. `points` is the SAME MessagePack `Vec<(i64 ts, Vec\nvalues)>` blob `TsAppend` carries (kept opaque here so the protocol enum stays\nfree of any eg-tsdb type). Ungated in the enum like the `Ts*` family; the\nstaging/commit handler is `tsdb`-gated at the facade, so a slim build reaches the\ndispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnAddMeasurement", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "points": { "description": "MessagePack `Vec<(i64, Vec)>` \u2014 the batch of points (one round-trip).", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "series": { "description": "Target series id the points belong to.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "series", "points" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnAddNode": { "additionalProperties": false, "properties": { "method": { "const": "TxnAddNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "description": "Optional target graph for THIS staged op (CONCEPT:EG-KG.txn.routes-cross-shard-txn \u2014 multi-graph\ntxn). An explicit `None` selects the txn's default graph.\nA staged op naming a graph that resolves to a DIFFERENT Raft group makes\nthe txn CROSS-SHARD, routed through 2PC at commit.", "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnAxiom": { "additionalProperties": false, "description": "Stage OWL AXIOMS (Turtle) into a txn (CONCEPT:EG-KG.txn.extended-cross-modal \u2014 extended cross-modal\nstaging). At commit the `turtle` axioms lower to graph node/edge writes in the\nSAME atomic `WriteTransaction` so the OWL reasoner sees them consistently with the\ntxn's other staged modalities. Gated `owl` (mirrors `OwlReason`); a build without\nit drops the variant \u2192 the dispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnAxiom", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "turtle": { "description": "OWL axioms as Turtle to stage into the txn.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "turtle" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnBlobRef": { "additionalProperties": false, "description": "Stage a BLOB REFERENCE into a txn (CONCEPT:EG-KG.txn.reader-never-sees-node \u2014 cross-modal ACID). Records\na durable graph-side link (`__blob__` node property) to an already-stored,\ncontent-addressed blob; lands atomically with the node/vector/property at commit.", "properties": { "method": { "const": "TxnBlobRef", "type": "string" }, "params": { "additionalProperties": false, "properties": { "digest": { "type": "string" }, "graph": { "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id", "digest" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnCas": { "additionalProperties": false, "properties": { "method": { "const": "TxnCas", "type": "string" }, "params": { "additionalProperties": false, "properties": { "conditions_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "graph": { "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "txn_id": { "type": "string" }, "updates_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "txn_id", "node_id", "conditions_msgpack", "updates_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnConstruct": { "additionalProperties": false, "description": "Stage a SPARQL CONSTRUCT into a txn (CONCEPT:EG-KG.query.extended-cross-modal \u2014 extended cross-modal\nstaging). At commit the `sparql` CONSTRUCT's produced triples lower to graph\nnode/edge writes in the SAME atomic `WriteTransaction`. Gated `sparql` (mirrors\n`Sparql`); a build without it drops the variant \u2192 the dispatch \"not available in\nthis build\" catch-all.", "properties": { "method": { "const": "TxnConstruct", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "sparql": { "description": "SPARQL CONSTRUCT query whose triples are staged into the txn.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "sparql" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnMaterializeBelief": { "additionalProperties": false, "description": "Stage a MATERIALIZE-BELIEF op into a txn (CONCEPT:EG-KG.epistemic.epistemic-substrate,\nD5 \u2014 the explicit, AUDITED \"materialize belief\" op the `eg_epistemic` crate docs\ncall for: `BeliefState.confidence` is derived and \"NEVER written back onto\n`NodeData.confidence` \u2026 unless a caller runs an explicit, logged materialize\nbelief op\"). Computes the propagated belief for `node_id` (via\n`eg_epistemic::propagate_confidence` over the graph's SUPPORTS/CONTRADICTS/\nATTACKS evidence topology, read from the txn's COMMITTED snapshot \u2014 the SAME\n\"evaluate now\" shape `TxnPlanWriteback`/`TxnConstruct` use) and stages ONE\nunconditional `CompareAndSetNodeFields` that writes it onto that node's\n`NodeData.confidence` \u2014 landing atomically with the txn's other staged\nmodalities at commit (`GraphTxnState::stage_plan_writeback`, reused verbatim \u2014\nsame OCC read-set capture + cross-modal commit shape as `TxnAxiom`/\n`TxnConstruct`/`TxnPlanWriteback`). The write rides the ALREADY-audited\n`CompareAndSetNodeFields` path (the tamper-evident hash chain, CONCEPT:\nEG-KG.sharding.row-level-security, plus the unconditional in-memory ledger) \u2014\nnever silent, no new audit mechanism. OPT-IN: this is the ONLY path that ever\nwrites a derived belief back onto stored confidence; nothing else in the engine\ndoes so implicitly. Gated `epistemic`; a build without it drops the variant \u2192\nthe dispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnMaterializeBelief", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "node_id": { "description": "The node whose propagated belief is computed and written back.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnPlanWriteback": { "additionalProperties": false, "description": "Stage a PLANNER WRITEBACK into a txn (CONCEPT:EG-KG.query.plan-dag, D7 \u2014 the\nplanner-writeback ACID seam). `plan` (the SAME `wire::Plan` AST `UnifiedQuery`\ncarries) runs READ-ONLY against the txn's committed snapshot; each id in its\nresult `RowSet` becomes an `AddEdge { source_id: anchor_id, target_id: id,\nrelationship }` \u2014 e.g. materializing a `Reason`/`Traverse`-inferred edge set \u2014\nstaged (via `GraphTxnState::stage_plan_writeback`, copying the `TxnAxiom`/\n`TxnConstruct` shape verbatim) into the SAME atomic `WriteTransaction` as the\ntxn's other modalities. Gated `query` (mirrors `UnifiedQuery`); a build without\nit drops the variant \u2192 the dispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnPlanWriteback", "type": "string" }, "params": { "additionalProperties": false, "properties": { "anchor_id": { "description": "The edge SOURCE every materialized edge is anchored to.", "type": "string" }, "graph": { "type": [ "string", "null" ] }, "plan": { "$ref": "#/components/schemas/ReqDef_Plan", "description": "The plan whose result `RowSet` is materialized as edges." }, "relationship": { "description": "The `relationship` property every materialized edge carries.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "plan", "anchor_id", "relationship" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnRemoveEdge": { "additionalProperties": false, "properties": { "method": { "const": "TxnRemoveEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "source_id": { "type": "string" }, "target_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnRemoveNode": { "additionalProperties": false, "properties": { "method": { "const": "TxnRemoveNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnUnifiedQuery": { "additionalProperties": false, "description": "Run a UNIFIED cross-modal query INSIDE a txn with read-your-own-writes\n(CONCEPT:EG-KG.query.txn-cross-modal-ryow \u2014 in-txn cross-modal RYOW). Executes the SAME `wire::Plan` AST as\n`UnifiedQuery`, but over a snapshot OVERLAID with the txn's staged (uncommitted)\nwrite-set, so a staged node/edge/embedding is visible to THIS txn before commit\nand invisible off-txn until commit. Read-only w.r.t. the committed store. Gated\n`query` (the plan AST + DataFusion filter leg); a slim build drops the variant \u2192\nthe dispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnUnifiedQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ReqDef_Plan" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_TxnUnifiedQueryText": { "additionalProperties": false, "description": "In-txn unified query, TEXT surface \u2014 UQL (CONCEPT:EG-KG.query.txn-cross-modal-ryow). The human/agent-\nwritable counterpart of `TxnUnifiedQuery`: a UQL `text` string PARSED into the\nSAME `wire::Plan` AST and run through the IDENTICAL overlaid in-txn executor. Same\n`query`-gating + read-your-own-writes semantics as `TxnUnifiedQuery`.", "properties": { "method": { "const": "TxnUnifiedQueryText", "type": "string" }, "params": { "additionalProperties": false, "properties": { "text": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "text" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UnbindQueue": { "additionalProperties": false, "description": "Remove a specific `exchange`/`queue`/`routing_key` binding.", "properties": { "method": { "const": "UnbindQueue", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" }, "queue": { "type": "string" }, "routing_key": { "type": "string" } }, "required": [ "exchange", "queue", "routing_key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UnifiedQuery": { "additionalProperties": false, "properties": { "method": { "const": "UnifiedQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ReqDef_Plan" } }, "required": [ "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UnifiedQueryText": { "additionalProperties": false, "properties": { "method": { "const": "UnifiedQueryText", "type": "string" }, "params": { "additionalProperties": false, "properties": { "text": { "type": "string" } }, "required": [ "text" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UnionGetNeighbors": { "additionalProperties": false, "description": "Neighbour ids unioned + deduped across every graph that contains the anchor.", "properties": { "method": { "const": "UnionGetNeighbors", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graphs": { "items": { "type": "string" }, "type": "array" }, "node_id": { "type": "string" } }, "required": [ "graphs", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UnionGetNodeProperties": { "additionalProperties": false, "description": "First-found node properties across `graphs` (in order); `Null` if absent\nin every graph.", "properties": { "method": { "const": "UnionGetNodeProperties", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graphs": { "items": { "type": "string" }, "type": "array" }, "node_id": { "type": "string" } }, "required": [ "graphs", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UnionGetNodesByLabel": { "additionalProperties": false, "description": "Label scan unioned + deduped by node id across `graphs` (limit 0 \u21d2 no cap).", "properties": { "method": { "const": "UnionGetNodesByLabel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graphs": { "items": { "type": "string" }, "type": "array" }, "label": { "type": "string" }, "limit": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "graphs", "label", "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UpdateCapacityCell": { "additionalProperties": false, "description": "Controller/admin CAS for a capacity cell epoch and resource dimension.", "properties": { "method": { "const": "UpdateCapacityCell", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_CapacityCellUpdateRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UpdateDevelopmentLaneQuota": { "additionalProperties": false, "description": "Controller/admin-only monotonic quota-policy update.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "UpdateDevelopmentLaneQuota", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_DevelopmentLaneQuotaUpdateRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_UpdateResourceHost": { "additionalProperties": false, "description": "Monotonic host capacity/heartbeat/policy update. Held accounting remains\nnative and cannot be overwritten by telemetry.", "properties": { "method": { "const": "UpdateResourceHost", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_ResourceHostUpdateRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_VerifyWorkItemClaimCapability": { "additionalProperties": false, "description": "Verify an opaque native WorkItem capability against the current live\nlease before any private payload/body lookup.", "properties": { "method": { "const": "VerifyWorkItemClaimCapability", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ReqDef_WorkItemClaimCapabilityVerifyRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Vf2SubgraphMatch": { "additionalProperties": false, "description": "VF2 subgraph isomorphism match of `pattern_graph_name` against this graph\n(CONCEPT:EG-KG.mining.gspan-frequent-subgraph). The backtracking search is NP-hard with no bound\notherwise, so it stops early once it collects `max_results` matches or spends\n`max_steps` candidate-pair attempts (whichever first). `0` for either \u21d2 the\nengine's conservative built-in default (`eg_core::graph::DEFAULT_VF2_MAX_RESULTS`/\n`DEFAULT_VF2_MAX_STEPS`) \u2014 a caller wanting more must ask for it explicitly.\nReturns a `Raw`-encoded [`Vf2MatchResult`].", "properties": { "method": { "const": "Vf2SubgraphMatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_results": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "max_steps": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "pattern_graph_name": { "type": "string" } }, "required": [ "pattern_graph_name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Viz": { "additionalProperties": false, "description": "Native visualization render surface (D-VZ-1 lanes V4 \"engine integration\" /\nV6 \"graph-native marks\"): resolve a caller-provided `eg_viz_core::ViewSpec`\nagainst a dataset (caller-supplied inline columns, or deterministic\nengine-side synthetic data) and render it to static PNG/SVG/PDF bytes, or\nfetch the mark x surface capability matrix. ONE variant wrapping an\ninternal op enum \u2014 mirrors `AnalyticsJob { op }`/`Statechart { op }` above\n\u2014 so the whole render surface costs exactly one `Method` arm. Gated `viz`;\nthe handler (`src/server/handlers/viz.rs`, facade feature\n`viz-static-export`) self-routes in `dispatch.rs` before the per-graph\nchain \u2014 a render is NOT graph-scoped (it resolves a FRESH per-request\n`ColumnStore`, never a live graph read), exactly like `AnalyticsJob`/\n`Statechart` above. V4-LITE, not full V4: no tile cache, no provenance\ninherited from a durable job, no view over a resident `GraphCore` \u2014 see\n`crate::viz`'s module doc.", "properties": { "method": { "const": "Viz", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_VizOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_Watch": { "additionalProperties": false, "description": "LISTEN/NOTIFY-style long-poll subscription (CONCEPT:EG-KG.query.wire-codec): return the\nmatching CDC changes for `graph` since `from_seq`, blocking up to `timeout_ms`\nfor the FIRST one if none are pending yet (then returns what arrived). `label`\n(empty \u21d2 all) filters by node/edge label. Returns a `Raw` `WatchBatch`\n(`{events, next_seq, gap, watermark, head_seq, epoch}` \u2014 B-8, 2026-08-13: tails\nthe identical ephemeral ring `CdcRead` does, so it carries the same gap\nsignalling; see `CdcReadResult`'s doc); the client passes `next_seq` back to\nresume, and MUST check `gap` before treating an empty `events` as \"caught up\".\nTransport-compatible: one Request \u2192 one Response, cursor-driven.", "properties": { "method": { "const": "Watch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from_seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "label": { "default": "", "type": "string" }, "timeout_ms": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_seq" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_WhatChanged": { "additionalProperties": false, "description": "**what_changed**(tx_from, tx_to) (EPI-P3-5, L53): between two transaction times,\nwhich beliefs changed and why (`eg_epistemic::what_changed`, feature\n`epistemic-tms`) \u2014 the one acceptance-query facet that is NOT a sub-field of\n`EpistemicStatus` (it is a whole-graph temporal DIFF, not a single claim's\nstatus), so it gets its own `Method`. Returns a `WhatChangedResult` via\n`ResultPayload::raw`. Same build-tier fallback convention as `EpistemicStatus`.", "properties": { "method": { "const": "WhatChanged", "type": "string" }, "params": { "additionalProperties": false, "properties": { "tx_from": { "format": "uint64", "minimum": 0, "type": "integer" }, "tx_to": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "tx_from", "tx_to" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_WorldTransform": { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 the WORLD pose of scene object `node_id` (its local\npose composed up the `CHILD_OF` chain). Read-only. Returns `Json` \u2014 the\n`{translation,rotation,scale}` object, or `null` if the node is absent / has\nno pose.", "properties": { "method": { "const": "WorldTransform", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "Req_WriteBack": { "additionalProperties": false, "description": "EG-owned D18 source change sets and append-only write-back receipts.\nThe engine records governed observations; it never calls a vendor API.", "properties": { "method": { "const": "WriteBack", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ReqDef_WriteBackOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, "ResDef_Cluster_BoundedVec_FleetCatalogRow_256": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_FleetCatalogRow" }, "maxItems": 256, "type": "array" }, "ResDef_Cluster_BoundedVec_RegisteredServerView_256": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_RegisteredServerView" }, "maxItems": 256, "type": "array" }, "ResDef_Cluster_CatalogListing": { "description": "`CatalogList`.", "properties": { "placements": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_CatalogPlacement" }, "type": "array" } }, "required": [ "placements" ], "type": "object" }, "ResDef_Cluster_CatalogPlacement": { "description": "An explicit tenant-catalog placement.", "properties": { "graph": { "type": "string" }, "node": { "description": "`null` for the local node.", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "shard": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "shard" ], "type": "object" }, "ResDef_Cluster_ClusterDiscoverySnapshot": { "description": "`ClusterMembers`: a signed, context-bound cluster topology snapshot.", "properties": { "auth_binding": { "$ref": "#/components/schemas/ResDef_Cluster_DiscoveryAuthBinding" }, "cluster_id": { "type": "string" }, "groups": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_ClusterGroup" }, "type": "array" }, "leader": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Cluster_ClusterLeader" }, { "type": "null" } ] }, "leaders": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_ClusterLeader" }, "type": "array" }, "membership_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "placement_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "signature": { "description": "`hmac-sha256:` over the canonical snapshot.", "type": "string" } }, "required": [ "schema_version", "cluster_id", "membership_epoch", "placement_epoch", "leaders", "groups", "auth_binding", "signature" ], "type": "object" }, "ResDef_Cluster_ClusterGroup": { "description": "One Raft group and its members.", "properties": { "group_id": { "format": "uint64", "minimum": 0, "type": "integer" }, "leader_id": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "members": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_ClusterMember" }, "type": "array" } }, "required": [ "group_id", "members" ], "type": "object" }, "ResDef_Cluster_ClusterLeader": { "description": "The current leader of one Raft group.", "properties": { "group_id": { "format": "uint64", "minimum": 0, "type": "integer" }, "node_id": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "group_id", "node_id" ], "type": "object" }, "ResDef_Cluster_ClusterMember": { "description": "One member of a Raft group.", "properties": { "certificate": { "$ref": "#/components/schemas/ResDef_Cluster_ClusterMemberCertificate" }, "client_endpoint": { "type": "string" }, "health": { "description": "`healthy` when the group has an elected leader, else `degraded`.", "type": "string" }, "member_identity": { "type": "string" }, "node_id": { "format": "uint64", "minimum": 0, "type": "integer" }, "role": { "description": "`leader`, `follower` or `learner`.", "type": "string" }, "tls_name": { "type": [ "string", "null" ] } }, "required": [ "node_id", "member_identity", "role", "client_endpoint", "health", "certificate" ], "type": "object" }, "ResDef_Cluster_ClusterMemberCertificate": { "description": "Certificate metadata a member self-reported. Never key material.", "properties": { "id": { "type": [ "string", "null" ] }, "not_after_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "not_before_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "rotation_epoch": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "rotation_epoch" ], "type": "object" }, "ResDef_Cluster_Digest256": { "description": "32 bytes of SHA-256 as lowercase hexadecimal", "maxLength": 64, "minLength": 64, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "ResDef_Cluster_DiscoveryAuthBinding": { "description": "Digests of the verified request context a discovery snapshot is signed for.", "properties": { "agent_digest": { "type": "string" }, "principal_digest": { "type": "string" }, "tenant_digest": { "type": "string" } }, "required": [ "tenant_digest", "principal_digest", "agent_digest" ], "type": "object" }, "ResDef_Cluster_DiscoveryCounts": { "additionalProperties": false, "description": "How many of each MCP primitive the probe saw.", "properties": { "prompts": { "format": "uint32", "minimum": 0, "type": "integer" }, "resources": { "format": "uint32", "minimum": 0, "type": "integer" }, "skills": { "format": "uint32", "minimum": 0, "type": "integer" }, "tools": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "tools", "skills", "prompts", "resources" ], "type": "object" }, "ResDef_Cluster_DiscoveryOutcome": { "description": "What the probe found.", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "reachable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "description": "Recorded rather than omitted: \"unavailable\" must never look identical to\n\"empty\". `error` is caller-redacted text; it is bounded here and never\ninterpreted.", "properties": { "error": { "type": "string" }, "status": { "const": "unreachable", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ] }, "ResDef_Cluster_DiscoveryScope": { "description": "Under whose authority a discovery observation was made.\n\nClosed, and deliberately two-valued. A local/stdio probe has no provider\ngrant to fingerprint, so it is tenant-local and visible to the tenant; a\nprobe made with a principal's OAuth grant saw what THAT grant allows, so it\nis visible only to that principal while that grant is current. There is no\nthird \"global\" value: an observation that cannot say which of the two it is\nis not recorded.", "oneOf": [ { "additionalProperties": false, "properties": { "authority": { "const": "tenant_local", "type": "string" } }, "required": [ "authority" ], "type": "object" }, { "additionalProperties": false, "description": "`grant_digest` is the broker-minted fingerprint of the grant the probe\nused. The principal is NOT a field: the server binds it from the\nverified request context.", "properties": { "authority": { "const": "oauth_grant", "type": "string" }, "grant_digest": { "$ref": "#/components/schemas/ResDef_Cluster_Digest256" } }, "required": [ "authority", "grant_digest" ], "type": "object" } ] }, "ResDef_Cluster_DistResult": { "description": "The result of a distributed computation, in a wire-ready form. Serialized to\n`ResultPayload::Raw` by the handler.", "oneOf": [ { "additionalProperties": false, "description": "PageRank: `(id, score)` rows, sorted by id (deterministic).", "properties": { "Scores": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" } }, "required": [ "Scores" ], "type": "object" }, { "additionalProperties": false, "description": "Connected components: `(id, component_repr_index)` rows, sorted by id. The\ncomponent label is the index of the component's representative in the sorted\nvertex list (a stable small int), so it round-trips losslessly.", "properties": { "Labels": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "int64", "type": "integer" } ], "type": "array" }, "type": "array" } }, "required": [ "Labels" ], "type": "object" } ] }, "ResDef_Cluster_FleetCatalogCursor": { "additionalProperties": false, "description": "Where a page resumes, fenced to the snapshot that produced it.", "properties": { "after_id": { "type": "string" }, "after_name": { "description": "Exclusive `(lowercased name, id)` lower bound for the next page.", "type": "string" }, "snapshot_digest": { "$ref": "#/components/schemas/ResDef_Cluster_Digest256", "description": "Digest of the whole visible, filtered snapshot of the page's kind. The\nfence is content, not a graph revision: a registry heartbeat that changes\nnothing this kind shows must not invalidate a caller's cursor." } }, "required": [ "after_name", "after_id", "snapshot_digest" ], "type": "object" }, "ResDef_Cluster_FleetCatalogKind": { "description": "Which kind of row a page lists.", "enum": [ "discoveries", "tools", "prompts", "resources", "skills" ], "type": "string" }, "ResDef_Cluster_FleetCatalogLookup": { "additionalProperties": false, "description": "The visible rows for a lookup, in request order. Unknown and invisible ids\nare both simply absent.", "properties": { "commons_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "observed_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "rows": { "$ref": "#/components/schemas/ResDef_Cluster_BoundedVec_FleetCatalogRow_256" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "rows", "commons_revision", "observed_at_ms" ], "type": "object" }, "ResDef_Cluster_FleetCatalogPage": { "additionalProperties": false, "description": "One bounded page of one kind, fenced to the snapshot it was cut from.", "properties": { "commons_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "$ref": "#/components/schemas/ResDef_Cluster_FleetCatalogKind" }, "next_cursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Cluster_FleetCatalogCursor" }, { "type": "null" } ] }, "observed_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "rows": { "$ref": "#/components/schemas/ResDef_Cluster_BoundedVec_FleetCatalogRow_256" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "snapshot_digest": { "$ref": "#/components/schemas/ResDef_Cluster_Digest256" }, "total": { "description": "Every visible row matching the request's filter, across all pages.", "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "kind", "rows", "total", "commons_revision", "snapshot_digest", "observed_at_ms" ], "type": "object" }, "ResDef_Cluster_FleetCatalogRow": { "description": "One row of any kind.", "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "discovery", "type": "string" }, "row": { "$ref": "#/components/schemas/ResDef_Cluster_FleetDiscoveryRow" } }, "required": [ "kind", "row" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "tool", "type": "string" }, "row": { "$ref": "#/components/schemas/ResDef_Cluster_FleetToolRow" } }, "required": [ "kind", "row" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "prompt", "type": "string" }, "row": { "$ref": "#/components/schemas/ResDef_Cluster_FleetPromptRow" } }, "required": [ "kind", "row" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "resource", "type": "string" }, "row": { "$ref": "#/components/schemas/ResDef_Cluster_FleetResourceRow" } }, "required": [ "kind", "row" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "skill", "type": "string" }, "row": { "$ref": "#/components/schemas/ResDef_Cluster_FleetSkillRow" } }, "required": [ "kind", "row" ], "type": "object" } ] }, "ResDef_Cluster_FleetComponentRef": { "additionalProperties": false, "description": "The part of every content row that identifies its component revision.", "properties": { "acl": { "$ref": "#/components/schemas/ResDef_Cluster_FleetRowAcl" }, "connector": { "type": "string" }, "definition_digest": { "type": "string" }, "description": { "type": "string" }, "enabled": { "description": "Published, and its server is not registered as disabled.", "type": "boolean" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "id": { "description": "The `AgentComponent` id (`mcp://`).", "type": "string" }, "name": { "description": "The name the server itself uses.", "type": "string" }, "server_name": { "type": "string" } }, "required": [ "id", "name", "description", "server_name", "connector", "enabled", "entry_revision", "definition_digest", "acl" ], "type": "object" }, "ResDef_Cluster_FleetDiscoveryRow": { "additionalProperties": false, "description": "One server's latest observation under one scope.", "properties": { "acl": { "$ref": "#/components/schemas/ResDef_Cluster_FleetRowAcl" }, "connector": { "type": "string" }, "counts": { "$ref": "#/components/schemas/ResDef_Cluster_DiscoveryCounts" }, "id": { "description": "`srvobs::` -- stable across revisions.", "type": "string" }, "observed_at_ms": { "description": "Server clock, never the caller's.", "format": "uint64", "minimum": 0, "type": "integer" }, "outcome": { "$ref": "#/components/schemas/ResDef_Cluster_DiscoveryOutcome" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "scope": { "$ref": "#/components/schemas/ResDef_Cluster_DiscoveryScope" }, "server_name": { "type": "string" } }, "required": [ "id", "server_name", "scope", "connector", "outcome", "counts", "observed_at_ms", "revision", "acl" ], "type": "object" }, "ResDef_Cluster_FleetPromptRow": { "additionalProperties": false, "properties": { "component": { "$ref": "#/components/schemas/ResDef_Cluster_FleetComponentRef" }, "uri": { "type": "string" } }, "required": [ "component", "uri" ], "type": "object" }, "ResDef_Cluster_FleetResourceRow": { "additionalProperties": false, "properties": { "component": { "$ref": "#/components/schemas/ResDef_Cluster_FleetComponentRef" }, "media_type": { "type": [ "string", "null" ] }, "resource_kind": { "$ref": "#/components/schemas/ResDef_Cluster_ResourceKind" }, "uri": { "type": "string" } }, "required": [ "component", "uri", "resource_kind" ], "type": "object" }, "ResDef_Cluster_FleetRowAcl": { "additionalProperties": false, "description": "Who may see a row, and who published what it shows.", "properties": { "publisher": { "description": "The opaque persistence id of the principal that wrote the underlying\nrecord: the observer for a discovery row, the importer for a component.", "type": "string" }, "tenant_id": { "type": "string" }, "visibility": { "$ref": "#/components/schemas/ResDef_Cluster_FleetVisibility" } }, "required": [ "tenant_id", "visibility", "publisher" ], "type": "object" }, "ResDef_Cluster_FleetSkillRow": { "additionalProperties": false, "properties": { "classification": { "description": "`skill_type`'s display label, computed by the engine.", "type": "string" }, "component": { "$ref": "#/components/schemas/ResDef_Cluster_FleetComponentRef" }, "override_revision": { "description": "The override record's revision, when an override decided `skill_type`.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "skill_type": { "$ref": "#/components/schemas/ResDef_Cluster_SkillType" }, "skill_type_source": { "$ref": "#/components/schemas/ResDef_Cluster_SkillTypeSource" }, "uri": { "type": "string" } }, "required": [ "component", "uri", "skill_type", "classification", "skill_type_source" ], "type": "object" }, "ResDef_Cluster_FleetToolRow": { "additionalProperties": false, "properties": { "component": { "$ref": "#/components/schemas/ResDef_Cluster_FleetComponentRef" }, "effect": { "$ref": "#/components/schemas/ResDef_Cluster_ToolEffect" }, "input_schema_digest": { "description": "`sha256:` of the served input schema, when the pack pinned one.", "type": [ "string", "null" ] }, "tool_mode": { "$ref": "#/components/schemas/ResDef_Cluster_ToolMode" } }, "required": [ "component", "effect", "tool_mode" ], "type": "object" }, "ResDef_Cluster_FleetVisibility": { "description": "Who may see a row, as the engine decided it.", "oneOf": [ { "additionalProperties": false, "description": "Every verified principal of the tenant.", "properties": { "scope": { "const": "tenant", "type": "string" } }, "required": [ "scope" ], "type": "object" }, { "additionalProperties": false, "description": "Only `principal` (an opaque persistence id), while the grant that made\nthe observation is current.", "properties": { "principal": { "type": "string" }, "scope": { "const": "principal", "type": "string" } }, "required": [ "scope", "principal" ], "type": "object" } ] }, "ResDef_Cluster_FleetWriteDisposition": { "description": "What a fleet catalog write did.", "oneOf": [ { "const": "written", "description": "A new revision was committed.", "type": "string" }, { "const": "replayed", "description": "The stored record already said exactly this; nothing was committed.", "type": "string" } ] }, "ResDef_Cluster_FleetWriteReceipt": { "additionalProperties": false, "description": "What one fleet catalog write committed.", "properties": { "disposition": { "$ref": "#/components/schemas/ResDef_Cluster_FleetWriteDisposition" }, "observed_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "record_id": { "description": "The logical record id (a discovery id, or `ovr::`).", "type": "string" }, "revision": { "description": "The record's revision after this write.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "record_id", "revision", "disposition", "observed_at_ms" ], "type": "object" }, "ResDef_Cluster_GraphCreated": { "description": "`CreateGraph`: the created graph's name.", "properties": { "created": { "type": "string" } }, "required": [ "created" ], "type": "object" }, "ResDef_Cluster_GraphDeleted": { "description": "`DeleteGraph`: the deleted graph's name.", "properties": { "deleted": { "type": "string" } }, "required": [ "deleted" ], "type": "object" }, "ResDef_Cluster_GraphLifecycleHealth": { "description": "Graph materialization counts reported by `Health`.", "properties": { "all_resident_materializations_valid": { "type": "boolean" }, "catalog_graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "complete_graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "failed_graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "partial_graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "resident_graphs": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "catalog_graphs", "resident_graphs", "complete_graphs", "partial_graphs", "failed_graphs", "all_resident_materializations_valid" ], "type": "object" }, "ResDef_Cluster_GraphListing": { "description": "One graph the caller may read.", "properties": { "completeness_cursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Cluster_MaterializationCursor" }, { "type": "null" } ] }, "index_manifests": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_IndexManifestListing" }, "type": "array" }, "materialization": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Cluster_MaterializationPhase" }, { "type": "null" } ] }, "name": { "type": "string" }, "source_snapshot_version": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "type": { "$ref": "#/components/schemas/ResDef_Cluster_GraphType" }, "valid": { "type": "boolean" } }, "required": [ "name", "type", "valid", "index_manifests" ], "type": "object" }, "ResDef_Cluster_GraphType": { "description": "Graph type for multi-tenant registry.", "enum": [ "Agent", "Team", "Global", "Commons" ], "type": "string" }, "ResDef_Cluster_GroupReshardResult": { "description": "One graph a placement move transferred between Raft groups.", "properties": { "from_group": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "nodes_transferred": { "format": "uint64", "minimum": 0, "type": "integer" }, "to_group": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_group", "to_group", "nodes_transferred" ], "type": "object" }, "ResDef_Cluster_HealthReport": { "description": "`Health`: liveness plus the served-operation set clients negotiate against.", "properties": { "graph_lifecycle": { "$ref": "#/components/schemas/ResDef_Cluster_GraphLifecycleHealth" }, "mem_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "ops": { "items": { "type": "string" }, "type": "array" }, "status": { "type": "string" }, "uptime_s": { "format": "uint64", "minimum": 0, "type": "integer" }, "version": { "type": "string" } }, "required": [ "status", "uptime_s", "mem_bytes", "version", "graph_lifecycle", "ops" ], "type": "object" }, "ResDef_Cluster_IndexCompleteness": { "description": "Source rows a maintained index covers.", "properties": { "complete": { "type": "boolean" }, "edges": { "format": "uint64", "minimum": 0, "type": "integer" }, "nodes": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes", "edges", "complete" ], "type": "object" }, "ResDef_Cluster_IndexManifestListing": { "description": "One server-maintained index of a listed graph.", "properties": { "build_version": { "format": "uint32", "minimum": 0, "type": "integer" }, "completeness_cursor": { "$ref": "#/components/schemas/ResDef_Cluster_IndexCompleteness" }, "kind": { "description": "`label`, `property`, `ontology`, `vector`, `text`, ...", "type": "string" }, "source_snapshot_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "validity": { "description": "`building`, `valid`, `stale` or `failed`.", "type": "string" } }, "required": [ "kind", "source_snapshot_version", "build_version", "completeness_cursor", "validity" ], "type": "object" }, "ResDef_Cluster_MaterializationCursor": { "description": "Row offsets a partial materialization has reached.", "properties": { "edge_offset": { "format": "uint64", "minimum": 0, "type": "integer" }, "node_offset": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_offset", "edge_offset" ], "type": "object" }, "ResDef_Cluster_MaterializationPhase": { "description": "How much of a graph incarnation is materialized in memory.", "enum": [ "catalog_only", "partial", "complete", "failed" ], "type": "string" }, "ResDef_Cluster_PlacementEpoch": { "description": "`PlacementAdmin` op `assign`: the new routing epoch.", "properties": { "epoch": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "epoch" ], "type": "object" }, "ResDef_Cluster_PlacementMoveResult": { "description": "`PlacementAdmin` op `move`: the settled online partition move.", "properties": { "epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "graphs": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_GroupReshardResult" }, "type": "array" }, "range": { "description": "`[range_start, range_end]`.", "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint64", "minimum": 0, "type": "integer" }, { "format": "uint64", "minimum": 0, "type": "integer" } ], "type": "array" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant": { "type": "string" } }, "required": [ "tenant", "range", "target", "epoch", "graphs" ], "type": "object" }, "ResDef_Cluster_PlacementRouteSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Cluster_PlacementRouteWire": { "description": "The `PlacementRoute` wire response: the schema-locked route fields plus\n`endpoints`, the client-reachable members of the resolved group, leader first\n(empty when no cluster topology is known).\n\nDeliberately a separate type from [`crate::epistemic_operations::PlacementRoute`],\nwhose cross-repo DTO carries no deployment endpoint material and denies unknown\nfields: a consumer of a route response must decode this tolerant superset.", "properties": { "authoritative": { "type": "boolean" }, "endpoints": { "items": { "type": "string" }, "type": "array" }, "epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "group": { "format": "uint64", "minimum": 0, "type": "integer" }, "leader_ref": { "type": [ "string", "null" ] }, "partition_ref": { "type": "string" }, "placed": { "type": "boolean" }, "route_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Cluster_PlacementRouteSchemaVersion" }, "stale": { "type": "boolean" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "route_id", "tenant_ref", "partition_ref", "authoritative", "placed", "group", "epoch", "fencing_token", "stale", "endpoints" ], "type": "object" }, "ResDef_Cluster_RebalanceExecution": { "description": "`RebalanceExecute`: every move the plan executed, in order.", "properties": { "executed": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_ShardReshardReport" }, "type": "array" } }, "required": [ "executed" ], "type": "object" }, "ResDef_Cluster_RebalanceMove": { "description": "One planned graph move.", "properties": { "from_shard": { "format": "uint32", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "to_shard": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_shard", "to_shard" ], "type": "object" }, "ResDef_Cluster_RebalancePlanReport": { "description": "`RebalancePlan`: the ordered moves plus the per-shard loads they were planned on.", "properties": { "moves": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_RebalanceMove" }, "type": "array" }, "shards": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_ShardLoadSummary" }, "type": "array" } }, "required": [ "moves", "shards" ], "type": "object" }, "ResDef_Cluster_RegisteredServerCursor": { "additionalProperties": false, "description": "Stable continuation over one complete live registry snapshot.", "properties": { "after_name": { "description": "Exclusive server-name lower bound for the next page.", "type": "string" }, "registry_digest": { "$ref": "#/components/schemas/ResDef_Cluster_Digest256", "description": "Canonical digest of every live, visible typed server in that image." }, "registry_revision": { "description": "`GraphCore::version()` of the `__commons__` image that produced the page.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "after_name", "registry_revision", "registry_digest" ], "type": "object" }, "ResDef_Cluster_RegisteredServerListPage": { "additionalProperties": false, "description": "One revision- and digest-fenced live registry page.", "properties": { "entries": { "$ref": "#/components/schemas/ResDef_Cluster_BoundedVec_RegisteredServerView_256" }, "next_cursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Cluster_RegisteredServerCursor" }, { "type": "null" } ] }, "observed_at_ms": { "description": "Server-authoritative wall-clock observation used for lease filtering.", "format": "uint64", "minimum": 0, "type": "integer" }, "registry_digest": { "$ref": "#/components/schemas/ResDef_Cluster_Digest256" }, "registry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "total_live": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "entries", "observed_at_ms", "total_live", "registry_revision", "registry_digest" ], "type": "object" }, "ResDef_Cluster_RegisteredServerView": { "additionalProperties": false, "description": "One currently live, well-typed `:Server` row.", "properties": { "desired": { "$ref": "#/components/schemas/ResDef_Cluster_ServerDesiredState" }, "last_heartbeat_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "name": { "type": "string" }, "registered_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "resources": true, "transport": { "$ref": "#/components/schemas/ResDef_Cluster_ServerTransport" }, "ttl_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "url": { "type": "string" } }, "required": [ "name", "url", "transport", "desired", "resources", "ttl_secs", "registered_at_ms", "last_heartbeat_ms", "lease_expires_at_ms" ], "type": "object" }, "ResDef_Cluster_ResourceKind": { "description": "What an MCP resource carries, from its URI scheme.", "enum": [ "skill", "prompt", "resource" ], "type": "string" }, "ResDef_Cluster_ServerDesiredState": { "description": "The operator's DESIRED state for a registered server.\n\nDesired, not observed: whether the server answered its last probe is a\ndiscovery observation (`FleetCatalog.RecordDiscovery`), and the two are\nnever collapsed into one status.", "enum": [ "enabled", "disabled" ], "type": "string" }, "ResDef_Cluster_ServerTransport": { "description": "How a registered server is reached. Closed on purpose: a transport the\nengine cannot name is `Unspecified`, never a free-form string.", "oneOf": [ { "const": "unspecified", "description": "A registration that predates the typed field, or did not say.", "type": "string" }, { "const": "stdio", "description": "A local child process speaking MCP over stdio.", "type": "string" }, { "const": "streamable_http", "description": "MCP streamable HTTP.", "type": "string" }, { "const": "sse", "description": "MCP over server-sent events.", "type": "string" }, { "const": "http", "description": "Plain HTTP JSON-RPC.", "type": "string" } ] }, "ResDef_Cluster_ShardLoadSummary": { "description": "The load of one shard the plan was computed against.", "properties": { "graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "shard": { "format": "uint32", "minimum": 0, "type": "integer" }, "total": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "shard", "total", "graphs" ], "type": "object" }, "ResDef_Cluster_ShardReshardReport": { "description": "One graph moved between durable shards.", "properties": { "audit": { "format": "uint64", "minimum": 0, "type": "integer" }, "delta_edges": { "format": "uint64", "minimum": 0, "type": "integer" }, "delta_nodes": { "format": "uint64", "minimum": 0, "type": "integer" }, "edges": { "format": "uint64", "minimum": 0, "type": "integer" }, "from_shard": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "ledger": { "format": "uint64", "minimum": 0, "type": "integer" }, "no_op": { "description": "The graph already lived on the target shard; nothing moved.", "type": "boolean" }, "nodes": { "format": "uint64", "minimum": 0, "type": "integer" }, "semantic": { "format": "uint64", "minimum": 0, "type": "integer" }, "to_shard": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_shard", "to_shard", "nodes", "edges", "ledger", "semantic", "audit", "delta_nodes", "delta_edges", "no_op" ], "type": "object" }, "ResDef_Cluster_SkillType": { "description": "How a skill is run. The four values the agent ecosystem declares.", "enum": [ "skill", "workflow", "graph", "mcp_skill" ], "type": "string" }, "ResDef_Cluster_SkillTypeSource": { "description": "Which authority a skill row's type came from.", "oneOf": [ { "const": "override", "description": "A durable operator override. Wins over everything else.", "type": "string" }, { "const": "declared", "description": "The skill's own declaration, as its pack published it.", "type": "string" }, { "const": "default", "description": "Nothing declared one; an ordinary atomic skill.", "type": "string" } ] }, "ResDef_Cluster_ToolEffect": { "description": "Whether invoking a tool can change anything.\n\nNot a hint. A read-only agent graph is one whose reachable tools are all\n[`ToolEffect::Read`], and that is a property worth being able to prove\nbefore a run rather than discover during one.", "enum": [ "read", "write" ], "type": "string" }, "ResDef_Cluster_ToolMode": { "description": "Whether a tool takes the condensed `action` + `params_json` calling shape.", "oneOf": [ { "enum": [ "condensed", "verbose" ], "type": "string" }, { "const": "undeclared", "description": "The publisher did not declare one. Never guessed from the schema.", "type": "string" } ] }, "ResDef_Compute_AdamResult": { "description": "One Adam step: the updated parameters and moment estimates.", "properties": { "m": { "items": { "format": "double", "type": "number" }, "type": "array" }, "params": { "items": { "format": "double", "type": "number" }, "type": "array" }, "v": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "params", "m", "v" ], "type": "object" }, "ResDef_Compute_AdfResult": { "description": "Augmented Dickey-Fuller test result.", "properties": { "crit_10pct": { "format": "double", "type": "number" }, "crit_1pct": { "description": "Finite-sample-interpolated MacKinnon critical values (constant, no trend).", "format": "double", "type": "number" }, "crit_5pct": { "format": "double", "type": "number" }, "n_obs": { "format": "uint", "minimum": 0, "type": "integer" }, "p_value_approx": { "description": "Approximate p-value (monotone interpolation across the critical points).", "format": "double", "type": "number" }, "stationary_10pct": { "type": "boolean" }, "stationary_1pct": { "type": "boolean" }, "stationary_5pct": { "type": "boolean" }, "statistic": { "format": "double", "type": "number" }, "used_lag": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "statistic", "used_lag", "n_obs", "crit_1pct", "crit_5pct", "crit_10pct", "p_value_approx", "stationary_1pct", "stationary_5pct", "stationary_10pct" ], "type": "object" }, "ResDef_Compute_Algorithm": { "description": "The solver algorithm that produced a certificate.", "oneOf": [ { "const": "depth_first_dual_ascent", "description": "Propagation, greedy incumbent, depth-first branch-and-bound with a\ndual-ascent Lagrangian bound, pre-order leaf-bound certificate.", "type": "string" } ] }, "ResDef_Compute_AnomalyMiningResult": { "description": "`MineAnomaly`.", "properties": { "n_anomalies": { "format": "uint", "minimum": 0, "type": "integer" }, "n_rows": { "format": "uint", "minimum": 0, "type": "integer" }, "rows": { "items": { "$ref": "#/components/schemas/ResDef_Compute_AnomalyRow" }, "type": "array" }, "threshold": { "format": "double", "type": "number" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "rows", "n_rows", "n_anomalies", "threshold", "written_back" ], "type": "object" }, "ResDef_Compute_AnomalyRow": { "description": "One scored row of `MineAnomaly`.", "properties": { "anomaly_score": { "format": "double", "type": "number" }, "id": { "$ref": "#/components/schemas/ResDef_Compute_RowRef" }, "is_anomaly": { "type": "boolean" } }, "required": [ "id", "anomaly_score", "is_anomaly" ], "type": "object" }, "ResDef_Compute_AssociationMiningResult": { "description": "`MineAssociate`.", "properties": { "n_rules": { "format": "uint", "minimum": 0, "type": "integer" }, "n_transactions": { "format": "uint", "minimum": 0, "type": "integer" }, "rules": { "items": { "$ref": "#/components/schemas/ResDef_Compute_AssociationRuleRow" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "rules", "n_transactions", "n_rules", "written_back" ], "type": "object" }, "ResDef_Compute_AssociationRuleRow": { "description": "One association rule.", "properties": { "antecedent": { "items": { "type": "string" }, "type": "array" }, "confidence": { "format": "double", "type": "number" }, "consequent": { "items": { "type": "string" }, "type": "array" }, "lift": { "format": "double", "type": "number" }, "support": { "format": "double", "type": "number" } }, "required": [ "antecedent", "consequent", "support", "confidence", "lift" ], "type": "object" }, "ResDef_Compute_BoundProof": { "description": "The lower-bound evidence a certificate carries.", "oneOf": [ { "additionalProperties": false, "description": "A complete pre-order search tree.", "properties": { "tree": { "additionalProperties": false, "properties": { "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ProofNode" }, "type": "array" } }, "required": [ "nodes" ], "type": "object" } }, "required": [ "tree" ], "type": "object" }, { "additionalProperties": false, "description": "Only the root dual (the tree exceeded the certificate leaf limit).", "properties": { "root": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Compute_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "root" ], "type": "object" } ] }, "ResDef_Compute_CausalImpactMiningResult": { "description": "`MineCausalImpact`.", "properties": { "confidence": { "format": "double", "type": "number" }, "effect_size": { "format": "double", "type": "number" }, "method": { "description": "`its` (interrupted time series) or `did` (difference in differences).", "type": "string" }, "post_mean": { "format": "double", "type": "number" }, "pre_mean": { "format": "double", "type": "number" }, "relative_effect": { "format": "double", "type": "number" }, "std_error": { "format": "double", "type": "number" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "pre_mean", "post_mean", "effect_size", "relative_effect", "std_error", "confidence", "method", "written_back" ], "type": "object" }, "ResDef_Compute_CausalRelationRow": { "description": "A causal (`from` \u2192 `to`) activity relation.", "properties": { "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to" ], "type": "object" }, "ResDef_Compute_Certificate": { "additionalProperties": false, "description": "Everything a verifier needs, and nothing it must trust.", "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Compute_Algorithm" }, "config": { "$ref": "#/components/schemas/ResDef_Compute_SolverConfig" }, "incumbent": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Compute_Incumbent" }, { "type": "null" } ] }, "lower_bound": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Compute_Scalar" }, { "type": "null" } ], "description": "Certified scalar lower bound, when any bound leaf exists." }, "model_digest": { "$ref": "#/components/schemas/ResDef_Compute_Sha256Digest" }, "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" }, "proof": { "$ref": "#/components/schemas/ResDef_Compute_BoundProof" }, "status": { "$ref": "#/components/schemas/ResDef_Compute_SolveStatus" } }, "required": [ "model_digest", "algorithm", "config", "status", "proof", "nodes_expanded" ], "type": "object" }, "ResDef_Compute_ClassificationMiningResult": { "description": "`MineClassifyPredict`.", "properties": { "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "n_rows": { "format": "uint", "minimum": 0, "type": "integer" }, "rows": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ClassifiedRow" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "rows", "classes", "n_rows", "written_back" ], "type": "object" }, "ResDef_Compute_ClassifiedRow": { "description": "One classified row of `MineClassifyPredict`.", "properties": { "id": { "$ref": "#/components/schemas/ResDef_Compute_RowRef" }, "label": { "format": "int64", "type": "integer" }, "proba": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "id", "label", "proba" ], "type": "object" }, "ResDef_Compute_ClassifierFitResult": { "description": "`MineClassifyFit`: the fitted classifier, passed back to `MineClassifyPredict`.", "properties": { "algorithm": { "type": "string" }, "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "model": { "$ref": "#/components/schemas/ResDef_Compute_FittedClassifier" }, "n_samples": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "model", "algorithm", "n_samples", "classes" ], "type": "object" }, "ResDef_Compute_ClassifyPrediction": { "description": "Predictions of a `classify`-family model.", "properties": { "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "model_id": { "type": "string" }, "n_rows": { "format": "uint", "minimum": 0, "type": "integer" }, "rows": { "items": { "$ref": "#/components/schemas/ResDef_Compute_PipelineClassifiedRow" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "model_id", "rows", "classes", "n_rows", "written_back" ], "type": "object" }, "ResDef_Compute_ClusterExpansion": { "description": "`ClusterHierarchyExpand`: a level-1 cluster expands to its member nodes and edges\n(`child_clusters` empty); a coarser cluster expands to its children one level\nfiner (`nodes` and `edges` empty).", "properties": { "child_clusters": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ClusterSummary" }, "type": "array" }, "edges": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ClusterMemberEdge" }, "type": "array" }, "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ClusterMemberNode" }, "type": "array" } }, "required": [ "nodes", "edges", "child_clusters" ], "type": "object" }, "ResDef_Compute_ClusterHierarchySummary": { "description": "`ClusterHierarchyRefresh`: what was computed and whether it was cached durably.", "properties": { "base_edge_count": { "format": "uint", "minimum": 0, "type": "integer" }, "base_node_count": { "format": "uint", "minimum": 0, "type": "integer" }, "cached": { "description": "`false` when the backend has no persistence to cache the hierarchy in.", "type": "boolean" }, "graph": { "type": "string" }, "levels": { "description": "Number of computed levels (level 1 is the finest).", "format": "uint", "minimum": 0, "type": "integer" }, "top_level_clusters": { "description": "Cluster count of the coarsest level; 0 when no level was computed.", "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "graph", "levels", "base_node_count", "base_edge_count", "top_level_clusters", "cached" ], "type": "object" }, "ResDef_Compute_ClusterLevelView": { "description": "`ClusterHierarchyClusters`: one level of the cached hierarchy.", "properties": { "clusters": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ClusterSummary" }, "type": "array" }, "inter_cluster_edges": { "items": { "$ref": "#/components/schemas/ResDef_Compute_InterClusterEdge" }, "type": "array" }, "level": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "level", "clusters", "inter_cluster_edges" ], "type": "object" }, "ResDef_Compute_ClusterMemberEdge": { "description": "An edge between two member nodes of a level-1 cluster.", "properties": { "dst_id": { "type": "string" }, "src_id": { "type": "string" }, "type": { "description": "The edge's `relationship` property, or `\"_\"` when it has none.", "type": "string" } }, "required": [ "src_id", "dst_id", "type" ], "type": "object" }, "ResDef_Compute_ClusterMemberNode": { "description": "A member node of a level-1 cluster, read live off the graph.", "properties": { "id": { "type": "string" }, "properties": { "description": "The node's stored properties, decoded; `null` when undecodable." } }, "required": [ "id", "properties" ], "type": "object" }, "ResDef_Compute_ClusterMiningResult": { "description": "`MineCluster`.", "properties": { "clusters": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ClusterRow" }, "type": "array" }, "labels": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "n_clusters": { "description": "Clusters with a non-negative id.", "format": "uint", "minimum": 0, "type": "integer" }, "n_rows": { "format": "uint", "minimum": 0, "type": "integer" }, "responsibilities": { "description": "Per-row soft assignments; present only for a mixture model.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": [ "array", "null" ] }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "clusters", "labels", "n_rows", "n_clusters", "written_back" ], "type": "object" }, "ResDef_Compute_ClusterRow": { "description": "One cluster; `cluster_id` is negative for a noise bucket.", "properties": { "centroid": { "items": { "format": "double", "type": "number" }, "type": "array" }, "cluster_id": { "format": "int64", "type": "integer" }, "members": { "items": { "$ref": "#/components/schemas/ResDef_Compute_RowRef" }, "type": "array" }, "score": { "format": "double", "type": "number" } }, "required": [ "cluster_id", "members", "centroid", "score" ], "type": "object" }, "ResDef_Compute_ClusterSummary": { "description": "One cluster as served to a visualization client.", "properties": { "edge_count": { "description": "Sum of internal-edge weight (directed).", "format": "double", "type": "number" }, "id": { "description": "Stable, globally-addressable id: `\"L{level}-{local_index}\"`.", "type": "string" }, "label": { "type": "string" }, "node_count": { "format": "uint", "minimum": 0, "type": "integer" }, "top_node_types": { "description": "Up to 5 most common node types among the members, descending.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "uint", "minimum": 0, "type": "integer" } ], "type": "array" }, "type": "array" } }, "required": [ "id", "label", "node_count", "edge_count", "top_node_types" ], "type": "object" }, "ResDef_Compute_CommunityMiningResult": { "description": "`MineCommunity`.", "properties": { "communities": { "items": { "$ref": "#/components/schemas/ResDef_Compute_CommunityRow" }, "type": "array" }, "deadline_hit": { "description": "`true` when the budget expired before convergence: the partition is the\nbest found so far, and a writeback has already persisted it.", "type": "boolean" }, "modularity": { "description": "`null` for an algorithm that does not optimize modularity.", "format": "double", "type": [ "number", "null" ] }, "n_nodes": { "format": "uint", "minimum": 0, "type": "integer" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "communities", "n_nodes", "written_back", "deadline_hit" ], "type": "object" }, "ResDef_Compute_CommunityRow": { "description": "One detected community.", "properties": { "density": { "format": "double", "type": "number" }, "members": { "items": { "type": "string" }, "type": "array" } }, "required": [ "members", "density" ], "type": "object" }, "ResDef_Compute_ConvergenceGate": { "description": "Conviction gate over N signal strengths.", "properties": { "agree": { "format": "uint", "minimum": 0, "type": "integer" }, "direction": { "format": "int32", "type": "integer" }, "fraction": { "format": "double", "type": "number" }, "pass": { "type": "boolean" }, "total": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "agree", "total", "fraction", "direction", "pass" ], "type": "object" }, "ResDef_Compute_CrossEntropyResult": { "description": "Mean categorical cross-entropy and its gradient w.r.t. the logits.", "properties": { "grad": { "description": "dL/dlogits, shape == logits (softmax - one_hot, averaged over the batch).", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "loss": { "format": "double", "type": "number" } }, "required": [ "loss", "grad" ], "type": "object" }, "ResDef_Compute_CvSplit": { "description": "One purged combinatorial cross-validation split.", "properties": { "test": { "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" }, "train": { "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "train", "test" ], "type": "object" }, "ResDef_Compute_DatasetStats": { "description": "Dataset statistics.", "properties": { "correlation_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "maxs": { "items": { "format": "double", "type": "number" }, "type": "array" }, "means": { "items": { "format": "double", "type": "number" }, "type": "array" }, "mins": { "items": { "format": "double", "type": "number" }, "type": "array" }, "n_features": { "format": "uint", "minimum": 0, "type": "integer" }, "n_samples": { "format": "uint", "minimum": 0, "type": "integer" }, "stds": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "means", "stds", "mins", "maxs", "correlation_matrix", "n_samples", "n_features" ], "type": "object" }, "ResDef_Compute_DecisionTree": { "properties": { "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Compute_TreeNode" }, "type": "array" } }, "required": [ "nodes" ], "type": "object" }, "ResDef_Compute_DieboldMariano": { "description": "Diebold-Mariano test of equal predictive accuracy.", "properties": { "a_better": { "type": "boolean" }, "p_value": { "format": "double", "type": "number" }, "statistic": { "format": "double", "type": "number" } }, "required": [ "statistic", "p_value", "a_better" ], "type": "object" }, "ResDef_Compute_DirectlyFollowsRow": { "description": "A directly-follows edge between two activities.", "properties": { "count": { "format": "uint", "minimum": 0, "type": "integer" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "count" ], "type": "object" }, "ResDef_Compute_DistResult": { "description": "The result of a distributed computation, in a wire-ready form. Serialized to\n`ResultPayload::Raw` by the handler.", "oneOf": [ { "additionalProperties": false, "description": "PageRank: `(id, score)` rows, sorted by id (deterministic).", "properties": { "Scores": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" } }, "required": [ "Scores" ], "type": "object" }, { "additionalProperties": false, "description": "Connected components: `(id, component_repr_index)` rows, sorted by id. The\ncomponent label is the index of the component's representative in the sorted\nvertex list (a stable small int), so it round-trips losslessly.", "properties": { "Labels": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "int64", "type": "integer" } ], "type": "array" }, "type": "array" } }, "required": [ "Labels" ], "type": "object" } ] }, "ResDef_Compute_DocTerms": { "description": "A document's weighted terms.", "properties": { "doc_id": { "type": "string" }, "terms": { "items": { "$ref": "#/components/schemas/ResDef_Compute_TermWeight" }, "type": "array" } }, "required": [ "doc_id", "terms" ], "type": "object" }, "ResDef_Compute_DpoResult": { "description": "Bradley-Terry DPO loss and its gradients w.r.t. the chosen/rejected log-probs.", "properties": { "grad_chosen": { "items": { "format": "double", "type": "number" }, "type": "array" }, "grad_rejected": { "items": { "format": "double", "type": "number" }, "type": "array" }, "loss": { "format": "double", "type": "number" } }, "required": [ "loss", "grad_chosen", "grad_rejected" ], "type": "object" }, "ResDef_Compute_DualEntry": { "additionalProperties": false, "description": "One non-zero rational multiplier numerator.", "properties": { "numerator": { "$ref": "#/components/schemas/ResDef_Compute_Scalar" }, "row": { "$ref": "#/components/schemas/ResDef_Compute_RowId" } }, "required": [ "row", "numerator" ], "type": "object" }, "ResDef_Compute_EdgeFunctionRow": { "description": "One learned first-layer edge function.", "properties": { "basis": { "description": "Polynomial basis family: `chebyshev` or `jacobi`.", "type": "string" }, "coefficients": { "items": { "format": "double", "type": "number" }, "type": "array" }, "feature": { "type": "string" }, "hidden_output": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "feature", "hidden_output", "basis", "coefficients" ], "type": "object" }, "ResDef_Compute_EntityMatchRow": { "description": "One matched record pair.", "properties": { "block_key": { "type": "string" }, "left": { "type": "string" }, "right": { "type": "string" }, "similarity": { "format": "double", "type": "number" } }, "required": [ "left", "right", "similarity", "block_key" ], "type": "object" }, "ResDef_Compute_EntityResolutionMiningResult": { "description": "`MineEntityResolve`.", "properties": { "matches": { "items": { "$ref": "#/components/schemas/ResDef_Compute_EntityMatchRow" }, "type": "array" }, "n_matches": { "format": "uint", "minimum": 0, "type": "integer" }, "n_records": { "format": "uint", "minimum": 0, "type": "integer" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "matches", "n_records", "n_matches", "written_back" ], "type": "object" }, "ResDef_Compute_EstimatorPrediction": { "description": "Predictions of an `estimator`-family model.", "properties": { "model_id": { "type": "string" }, "n_rows": { "format": "uint", "minimum": 0, "type": "integer" }, "rows": { "items": { "$ref": "#/components/schemas/ResDef_Compute_PipelineValueRow" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "model_id", "rows", "n_rows", "written_back" ], "type": "object" }, "ResDef_Compute_Fill": { "description": "Fill result from order matching.", "properties": { "fill_price": { "format": "double", "type": "number" }, "fill_quantity": { "format": "double", "type": "number" }, "order_id": { "type": "string" }, "side": { "type": "string" } }, "required": [ "order_id", "fill_price", "fill_quantity", "side" ], "type": "object" }, "ResDef_Compute_FittedClassifier": { "description": "Serializable fitted classifier returned by `mining::classify::fit` and consumed\nback by `mining::classify::predict` (the PREDICTIVE fit\u2192blob\u2192predict pair). Lives\nin eg-types so `Method::MineClassifyPredict` can embed the model over the wire \u2014\nexactly like `FittedModel` carries the datascience regressors. `classes` is the\nsorted set of integer labels; every score/proba vector is column-ordered by it.", "oneOf": [ { "description": "Gaussian Naive Bayes \u2014 per-class prior + per-feature (mean, variance).", "properties": { "kind": { "const": "GaussianNb", "type": "string" }, "model": { "properties": { "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "means": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "priors": { "items": { "format": "double", "type": "number" }, "type": "array" }, "vars": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "classes", "priors", "means", "vars" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "Multinomial Naive Bayes \u2014 per-class log-prior + Laplace-smoothed feature log-probs.", "properties": { "kind": { "const": "MultinomialNb", "type": "string" }, "model": { "properties": { "class_log_prior": { "items": { "format": "double", "type": "number" }, "type": "array" }, "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "feature_log_prob": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "classes", "class_log_prior", "feature_log_prob" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "k-NN \u2014 the lazy classifier stores its training rows + labels for the vote.", "properties": { "kind": { "const": "Knn", "type": "string" }, "model": { "properties": { "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "k": { "format": "uint", "minimum": 0, "type": "integer" }, "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "required": [ "k", "classes", "x", "y" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "One-vs-rest linear classifier (`kind` = `logistic` | `svc`): a weight vector +\nbias per class. Prediction is argmax of the per-class score.", "properties": { "kind": { "const": "LinearOvr", "type": "string" }, "model": { "properties": { "biases": { "items": { "format": "double", "type": "number" }, "type": "array" }, "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "kind": { "type": "string" }, "weights": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "kind", "classes", "weights", "biases" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" } ] }, "ResDef_Compute_FittedModel": { "description": "Serializable fitted model returned by `fit_estimator`.", "oneOf": [ { "properties": { "kind": { "const": "Linear", "type": "string" }, "model": { "properties": { "coefficients": { "items": { "format": "double", "type": "number" }, "type": "array" }, "intercept": { "format": "double", "type": "number" } }, "required": [ "coefficients", "intercept" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Tree", "type": "string" }, "model": { "$ref": "#/components/schemas/ResDef_Compute_DecisionTree" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Forest", "type": "string" }, "model": { "properties": { "trees": { "items": { "$ref": "#/components/schemas/ResDef_Compute_DecisionTree" }, "type": "array" } }, "required": [ "trees" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "GradientBoosting", "type": "string" }, "model": { "properties": { "init": { "format": "double", "type": "number" }, "learning_rate": { "format": "double", "type": "number" }, "trees": { "items": { "$ref": "#/components/schemas/ResDef_Compute_DecisionTree" }, "type": "array" } }, "required": [ "init", "learning_rate", "trees" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "AdaBoost", "type": "string" }, "model": { "properties": { "trees": { "items": { "$ref": "#/components/schemas/ResDef_Compute_DecisionTree" }, "type": "array" }, "weights": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "trees", "weights" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Svr", "type": "string" }, "model": { "properties": { "dual_coef": { "items": { "format": "double", "type": "number" }, "type": "array" }, "gamma": { "format": "double", "type": "number" }, "intercept": { "format": "double", "type": "number" }, "kernel": { "type": "string" }, "support_vectors": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "support_vectors", "dual_coef", "intercept", "kernel", "gamma" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" } ] }, "ResDef_Compute_ForecastMiningResult": { "description": "`MineForecast`.", "properties": { "algorithm": { "type": "string" }, "forecast": { "items": { "format": "double", "type": "number" }, "type": "array" }, "horizon": { "format": "uint", "minimum": 0, "type": "integer" }, "lower": { "items": { "format": "double", "type": "number" }, "type": "array" }, "n_obs": { "format": "uint", "minimum": 0, "type": "integer" }, "residual": { "items": { "format": "double", "type": "number" }, "type": [ "array", "null" ] }, "seasonal": { "items": { "format": "double", "type": "number" }, "type": [ "array", "null" ] }, "trend": { "description": "STL decomposition components; present only for the `stl` algorithm.", "items": { "format": "double", "type": "number" }, "type": [ "array", "null" ] }, "upper": { "items": { "format": "double", "type": "number" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "forecast", "lower", "upper", "algorithm", "horizon", "n_obs", "written_back" ], "type": "object" }, "ResDef_Compute_ForensicReport": { "description": "Forensic-accounting scores for one fiscal year against the prior one.", "properties": { "accruals_ratio": { "format": "double", "type": "number" }, "f_score": { "format": "int32", "type": "integer" }, "flags": { "description": "Human-readable flags that crossed a threshold.", "items": { "type": "string" }, "type": "array" }, "m_score": { "format": "double", "type": "number" }, "verdict": { "type": "string" }, "z_score": { "format": "double", "type": "number" } }, "required": [ "m_score", "z_score", "f_score", "accruals_ratio", "flags", "verdict" ], "type": "object" }, "ResDef_Compute_GraphlearnPrediction": { "description": "The top missing links scored by a `graphlearn`-family model.", "properties": { "model_id": { "type": "string" }, "n_predicted": { "format": "uint", "minimum": 0, "type": "integer" }, "predicted": { "items": { "$ref": "#/components/schemas/ResDef_Compute_PredictedLink" }, "type": "array" } }, "required": [ "model_id", "predicted", "n_predicted" ], "type": "object" }, "ResDef_Compute_GrpoResult": { "description": "PPO/GRPO clipped surrogate loss and its gradient w.r.t. `logprob`.", "properties": { "grad": { "items": { "format": "double", "type": "number" }, "type": "array" }, "loss": { "format": "double", "type": "number" } }, "required": [ "loss", "grad" ], "type": "object" }, "ResDef_Compute_GspanMiningResult": { "description": "gSpan frequent-subgraph patterns.", "properties": { "algorithm": { "type": "string" }, "n_host_edges": { "format": "uint", "minimum": 0, "type": "integer" }, "n_host_nodes": { "format": "uint", "minimum": 0, "type": "integer" }, "patterns": { "items": { "$ref": "#/components/schemas/ResDef_Compute_SubgraphPatternRow" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "patterns", "algorithm", "n_host_nodes", "n_host_edges", "written_back" ], "type": "object" }, "ResDef_Compute_HawkesFit": { "description": "An exponential-kernel Hawkes process fit.", "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "branching_ratio": { "format": "double", "type": "number" }, "converged": { "type": "boolean" }, "half_life_seconds": { "format": "double", "type": "number" }, "log_likelihood": { "format": "double", "type": "number" }, "mu": { "format": "double", "type": "number" } }, "required": [ "mu", "alpha", "beta", "branching_ratio", "half_life_seconds", "log_likelihood", "converged" ], "type": "object" }, "ResDef_Compute_Incumbent": { "additionalProperties": false, "description": "A feasible assignment and its objective value.", "properties": { "objective": { "$ref": "#/components/schemas/ResDef_Compute_ObjectiveValue" }, "selected": { "items": { "type": "boolean" }, "type": "array" } }, "required": [ "selected", "objective" ], "type": "object" }, "ResDef_Compute_InterClusterEdge": { "description": "An edge between two clusters of one served level, by array-local index into\nthat response's `clusters`.", "properties": { "dst_idx": { "format": "uint32", "minimum": 0, "type": "integer" }, "src_idx": { "format": "uint32", "minimum": 0, "type": "integer" }, "weight": { "format": "double", "type": "number" } }, "required": [ "src_idx", "dst_idx", "weight" ], "type": "object" }, "ResDef_Compute_KMeansResult": { "description": "Result of K-means clustering.", "properties": { "centroids": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "inertia": { "format": "double", "type": "number" }, "labels": { "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" }, "n_iterations": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "labels", "centroids", "inertia", "n_iterations" ], "type": "object" }, "ResDef_Compute_KalmanState": { "description": "Filtered states and variances of a scalar Kalman filter.", "properties": { "states": { "items": { "format": "double", "type": "number" }, "type": "array" }, "variances": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "states", "variances" ], "type": "object" }, "ResDef_Compute_LagrangeDual": { "additionalProperties": false, "description": "Row multipliers `numerator / denominator`, entries strictly ordered by row.", "properties": { "denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "entries": { "items": { "$ref": "#/components/schemas/ResDef_Compute_DualEntry" }, "type": "array" } }, "required": [ "denominator", "entries" ], "type": "object" }, "ResDef_Compute_LeafProof": { "description": "How a leaf of the search tree is closed.", "oneOf": [ { "additionalProperties": false, "description": "`L(dual, path)` is a lower bound on every feasible completion.", "properties": { "bound": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Compute_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "bound" ], "type": "object" }, { "additionalProperties": false, "description": "`L(dual, path)` with a zero objective is positive: no feasible completion.", "properties": { "infeasible": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Compute_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "infeasible" ], "type": "object" } ] }, "ResDef_Compute_LevelValue": { "additionalProperties": false, "description": "Value of one objective level under an assignment.", "properties": { "known": { "$ref": "#/components/schemas/ResDef_Compute_Scalar", "description": "Sum of the known coefficients of the selected variables." }, "unknown_selected": { "description": "How many selected variables have an unknown coefficient at this level.", "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "known", "unknown_selected" ], "type": "object" }, "ResDef_Compute_LinkPrediction": { "description": "`GraphLearnPredict`: scored links and the model digest that scored them.", "properties": { "model": { "description": "Digest of the model, `kanlink:`.", "type": "string" }, "n_predicted": { "format": "uint", "minimum": 0, "type": "integer" }, "predicted": { "items": { "$ref": "#/components/schemas/ResDef_Compute_PredictedLink" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "predicted", "n_predicted", "model", "written_back" ], "type": "object" }, "ResDef_Compute_LinkPredictorFit": { "description": "`GraphLearnFit`: the fitted model and a summary of what it learned.", "properties": { "basis": { "type": "string" }, "degree": { "format": "uint", "minimum": 0, "type": "integer" }, "edge_functions": { "items": { "$ref": "#/components/schemas/ResDef_Compute_EdgeFunctionRow" }, "type": "array" }, "edge_functions_written": { "format": "uint", "minimum": 0, "type": "integer" }, "model": { "description": "The fitted model, passed back verbatim to `GraphLearnPredict`. Opaque on the\nwire (the request carries it as JSON too), so no KAN type leaks here." }, "n_edges": { "format": "uint", "minimum": 0, "type": "integer" }, "n_nodes": { "format": "uint", "minimum": 0, "type": "integer" }, "train_auc": { "format": "double", "type": "number" } }, "required": [ "model", "n_nodes", "n_edges", "train_auc", "basis", "degree", "edge_functions", "edge_functions_written" ], "type": "object" }, "ResDef_Compute_MergeProposal": { "description": "One proposed entity-resolution action returned by `ResolveCandidates`.\n\nThe compute implementation owns the algorithm and therefore cannot be a\ndependency of this bottom-of-DAG crate. This wire mirror keeps the result\ncontract typed while preserving the implementation's four serialized fields.", "properties": { "canonical": { "type": "string" }, "kind": { "type": "string" }, "members": { "items": { "type": "string" }, "type": "array" }, "score": { "format": "double", "type": "number" } }, "required": [ "canonical", "members", "score", "kind" ], "type": "object" }, "ResDef_Compute_MotifCountsRow": { "description": "Three-node motif counts.", "properties": { "directed_cycle3": { "format": "uint", "minimum": 0, "type": "integer" }, "triangle": { "format": "uint", "minimum": 0, "type": "integer" }, "wedge": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "wedge", "triangle", "directed_cycle3" ], "type": "object" }, "ResDef_Compute_MotifMiningResult": { "description": "Motif counting over the host graph; never writes back.", "properties": { "algorithm": { "type": "string" }, "motifs": { "$ref": "#/components/schemas/ResDef_Compute_MotifCountsRow" }, "n_host_edges": { "format": "uint", "minimum": 0, "type": "integer" }, "n_host_nodes": { "format": "uint", "minimum": 0, "type": "integer" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "motifs", "algorithm", "n_host_nodes", "n_host_edges", "written_back" ], "type": "object" }, "ResDef_Compute_ObjectiveValue": { "additionalProperties": false, "description": "Every level's value plus the exact scalarised objective.", "properties": { "levels": { "items": { "$ref": "#/components/schemas/ResDef_Compute_LevelValue" }, "type": "array" }, "scalar": { "$ref": "#/components/schemas/ResDef_Compute_Scalar" } }, "required": [ "levels", "scalar" ], "type": "object" }, "ResDef_Compute_OntologyGapMiningResult": { "description": "`MineOntologyGap`.", "properties": { "gaps": { "items": { "$ref": "#/components/schemas/ResDef_Compute_OntologyGapRow" }, "type": "array" }, "n_classes": { "format": "uint", "minimum": 0, "type": "integer" }, "n_gaps": { "format": "uint", "minimum": 0, "type": "integer" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "gaps", "n_classes", "n_gaps", "written_back" ], "type": "object" }, "ResDef_Compute_OntologyGapRow": { "description": "One ontology gap.", "properties": { "class": { "type": "string" }, "kind": { "type": "string" }, "severity": { "format": "double", "type": "number" } }, "required": [ "class", "kind", "severity" ], "type": "object" }, "ResDef_Compute_OntologyMatch": { "description": "One capability term found in a query by the ontology lexical gate\n(CONCEPT:EG-ORCH.routing.lexical-capability-escalation). `term` is the matched alias/name, `node_type` its capability\nclass (Tool/Skill/MCPServer/\u2026), `label` the owning node's display name,\n`mcp_server` the owning fleet server (so a caller can bind that server's\ntoolset directly), and `score` the matched term's character length.", "properties": { "label": { "type": "string" }, "mcp_server": { "type": "string" }, "node_type": { "type": "string" }, "score": { "format": "double", "type": "number" }, "term": { "type": "string" } }, "required": [ "term", "node_type", "label", "mcp_server", "score" ], "type": "object" }, "ResDef_Compute_OptimizationResult": { "description": "A mean-variance / risk-parity / Black-Litterman portfolio.", "properties": { "expected_return": { "format": "double", "type": "number" }, "expected_volatility": { "format": "double", "type": "number" }, "method": { "type": "string" }, "sharpe_ratio": { "format": "double", "type": "number" }, "weights": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "weights", "expected_return", "expected_volatility", "sharpe_ratio", "method" ], "type": "object" }, "ResDef_Compute_OuParams": { "description": "Calibrated Ornstein-Uhlenbeck parameters.", "properties": { "half_life": { "format": "double", "type": "number" }, "mu": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" }, "sigma_eq": { "format": "double", "type": "number" }, "theta": { "format": "double", "type": "number" } }, "required": [ "theta", "mu", "sigma", "half_life", "sigma_eq" ], "type": "object" }, "ResDef_Compute_OuThresholds": { "description": "MFPT-optimal Ornstein-Uhlenbeck entry/exit thresholds.", "properties": { "entry_long": { "format": "double", "type": "number" }, "entry_short": { "format": "double", "type": "number" }, "exit": { "format": "double", "type": "number" }, "expected_return_per_unit_time": { "format": "double", "type": "number" }, "z": { "format": "double", "type": "number" } }, "required": [ "entry_long", "entry_short", "exit", "z", "expected_return_per_unit_time" ], "type": "object" }, "ResDef_Compute_PCAResult": { "description": "Result of PCA dimensionality reduction.", "properties": { "components": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "explained_variance": { "items": { "format": "double", "type": "number" }, "type": "array" }, "explained_variance_ratio": { "items": { "format": "double", "type": "number" }, "type": "array" }, "transformed": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "components", "explained_variance", "explained_variance_ratio", "transformed" ], "type": "object" }, "ResDef_Compute_ParallelRelationRow": { "description": "A parallel activity relation.", "properties": { "a": { "type": "string" }, "b": { "type": "string" } }, "required": [ "a", "b" ], "type": "object" }, "ResDef_Compute_PatternEdge": { "description": "A labeled edge of a frequent subgraph pattern, by pattern-local node index.", "properties": { "from": { "format": "uint", "minimum": 0, "type": "integer" }, "label": { "type": "string" }, "to": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "from", "to", "label" ], "type": "object" }, "ResDef_Compute_PipelineClassifiedRow": { "description": "One classified row.", "properties": { "id": { "type": "string" }, "label": { "format": "int64", "type": "integer" }, "proba": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "id", "label", "proba" ], "type": "object" }, "ResDef_Compute_PipelineComparison": { "description": "`MiningPipelineCompare`: two versions' recorded metrics and their numeric diff.", "properties": { "algorithm_a": { "type": "string" }, "algorithm_b": { "type": "string" }, "diff": { "description": "`b - a` for every numeric primary metric both versions share; `null` when\neither version has no metric object." }, "metrics_a": true, "metrics_b": true, "name": { "type": "string" }, "version_a": { "format": "uint64", "minimum": 0, "type": "integer" }, "version_b": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "name", "version_a", "version_b", "algorithm_a", "algorithm_b", "metrics_a", "metrics_b", "diff" ], "type": "object" }, "ResDef_Compute_PipelineEvaluation": { "description": "`MiningPipelineEvaluate`: metrics of a served tabular model on caller data.", "properties": { "family": { "type": "string" }, "metrics": { "description": "The family's metric object (accuracy/F1 for classify, R\u00b2/RMSE for estimator)." }, "n": { "format": "uint", "minimum": 0, "type": "integer" }, "name": { "type": "string" }, "version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "name", "version", "family", "metrics", "n" ], "type": "object" }, "ResDef_Compute_PipelinePrediction": { "description": "`MiningPipelinePredict`: the body is selected by the served model's family,\npublished as the `family` field.", "oneOf": [ { "$ref": "#/components/schemas/ResDef_Compute_ClassifyPrediction", "properties": { "family": { "const": "classify", "type": "string" } }, "required": [ "family" ], "type": "object" }, { "$ref": "#/components/schemas/ResDef_Compute_EstimatorPrediction", "properties": { "family": { "const": "estimator", "type": "string" } }, "required": [ "family" ], "type": "object" }, { "$ref": "#/components/schemas/ResDef_Compute_GraphlearnPrediction", "properties": { "family": { "const": "graphlearn", "type": "string" } }, "required": [ "family" ], "type": "object" } ] }, "ResDef_Compute_PipelineServeResult": { "description": "`MiningPipelineServe`: the version now served for `name`.", "properties": { "model_id": { "type": "string" }, "name": { "type": "string" }, "served": { "type": "boolean" }, "version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "name", "version", "model_id", "served" ], "type": "object" }, "ResDef_Compute_PipelineTrainResult": { "description": "`MiningPipelineTrain`: the trained version and its held-out metrics.", "properties": { "algorithm": { "type": "string" }, "classes": { "description": "The label classes of a classifier; `null` for other families." }, "family": { "type": "string" }, "metrics": { "description": "Per-split metric objects; their keys depend on the model family." }, "model_id": { "type": "string" }, "n_features": { "format": "uint", "minimum": 0, "type": "integer" }, "n_test": { "format": "uint", "minimum": 0, "type": "integer" }, "n_train": { "format": "uint", "minimum": 0, "type": "integer" }, "name": { "type": "string" }, "version": { "description": "The assigned version; 0 when not written back.", "format": "uint64", "minimum": 0, "type": "integer" }, "written_back": { "type": "boolean" } }, "required": [ "name", "version", "model_id", "family", "algorithm", "metrics", "n_features", "n_train", "n_test", "classes", "written_back" ], "type": "object" }, "ResDef_Compute_PipelineValueRow": { "description": "One regressed row.", "properties": { "id": { "type": "string" }, "value": { "format": "double", "type": "number" } }, "required": [ "id", "value" ], "type": "object" }, "ResDef_Compute_PosteriorCredibleInterval": { "description": "A Bayesian posterior credible interval.", "properties": { "lower": { "format": "double", "type": "number" }, "upper": { "format": "double", "type": "number" } }, "required": [ "lower", "upper" ], "type": "object" }, "ResDef_Compute_PredictedLink": { "description": "One predicted link.", "properties": { "dst": { "type": "string" }, "score": { "format": "double", "type": "number" }, "src": { "type": "string" } }, "required": [ "src", "dst", "score" ], "type": "object" }, "ResDef_Compute_ProcessMiningResult": { "description": "`MineProcess`.", "properties": { "causal": { "items": { "$ref": "#/components/schemas/ResDef_Compute_CausalRelationRow" }, "type": "array" }, "dfg": { "items": { "$ref": "#/components/schemas/ResDef_Compute_DirectlyFollowsRow" }, "type": "array" }, "end_activities": { "items": { "type": "string" }, "type": "array" }, "n_activities": { "format": "uint", "minimum": 0, "type": "integer" }, "n_traces": { "format": "uint", "minimum": 0, "type": "integer" }, "parallel": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ParallelRelationRow" }, "type": "array" }, "start_activities": { "items": { "type": "string" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "dfg", "causal", "parallel", "start_activities", "end_activities", "n_traces", "n_activities", "written_back" ], "type": "object" }, "ResDef_Compute_ProofNode": { "description": "One pre-order node of the search-tree proof.", "oneOf": [ { "additionalProperties": false, "properties": { "branch": { "additionalProperties": false, "properties": { "first": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ResDef_Compute_VarId" } }, "required": [ "var", "first" ], "type": "object" } }, "required": [ "branch" ], "type": "object" }, { "additionalProperties": false, "properties": { "forced": { "additionalProperties": false, "properties": { "row": { "$ref": "#/components/schemas/ResDef_Compute_RowId" }, "value": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ResDef_Compute_VarId" } }, "required": [ "var", "value", "row" ], "type": "object" } }, "required": [ "forced" ], "type": "object" }, { "additionalProperties": false, "properties": { "leaf": { "additionalProperties": false, "properties": { "proof": { "$ref": "#/components/schemas/ResDef_Compute_LeafProof" } }, "required": [ "proof" ], "type": "object" } }, "required": [ "leaf" ], "type": "object" } ] }, "ResDef_Compute_QueueSignal": { "description": "Queue-imbalance skew and per-side fill times.", "properties": { "ask_fill_time": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_fill_time": { "items": { "format": "double", "type": "number" }, "type": "array" }, "skew": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "skew", "bid_fill_time", "ask_fill_time" ], "type": "object" }, "ResDef_Compute_Quote": { "description": "A two-sided market-making quote.", "properties": { "ask": { "format": "double", "type": "number" }, "bid": { "format": "double", "type": "number" }, "half_spread": { "format": "double", "type": "number" }, "reservation": { "format": "double", "type": "number" }, "withdraw": { "description": "True when an inventory / boundary cap says \"withdraw, do not quote\".", "type": "boolean" } }, "required": [ "bid", "ask", "reservation", "half_spread", "withdraw" ], "type": "object" }, "ResDef_Compute_ReducedRow": { "description": "One embedded row of `MineReduce`.", "properties": { "coords": { "items": { "format": "double", "type": "number" }, "type": "array" }, "id": { "$ref": "#/components/schemas/ResDef_Compute_RowRef" } }, "required": [ "id", "coords" ], "type": "object" }, "ResDef_Compute_ReductionMiningResult": { "description": "`MineReduce`.", "properties": { "algorithm": { "type": "string" }, "n_components": { "format": "uint", "minimum": 0, "type": "integer" }, "n_rows": { "format": "uint", "minimum": 0, "type": "integer" }, "rows": { "items": { "$ref": "#/components/schemas/ResDef_Compute_ReducedRow" }, "type": "array" }, "singular_values": { "description": "Present only for an algorithm that produces singular values.", "items": { "format": "double", "type": "number" }, "type": [ "array", "null" ] }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "rows", "algorithm", "n_rows", "n_components", "written_back" ], "type": "object" }, "ResDef_Compute_RegimeResult": { "description": "A fitted Gaussian HMM regime model.", "properties": { "initial_probs": { "description": "Initial state probabilities", "items": { "format": "double", "type": "number" }, "type": "array" }, "log_likelihood": { "description": "Log-likelihood of the final model", "format": "double", "type": "number" }, "means": { "description": "State means (emission parameters)", "items": { "format": "double", "type": "number" }, "type": "array" }, "n_iterations": { "description": "Number of EM iterations until convergence", "format": "uint", "minimum": 0, "type": "integer" }, "states": { "description": "Most likely state sequence (Viterbi path)", "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" }, "stds": { "description": "State standard deviations", "items": { "format": "double", "type": "number" }, "type": "array" }, "transition_matrix": { "description": "Transition matrix (n_states x n_states)", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "states", "means", "stds", "transition_matrix", "initial_probs", "log_likelihood", "n_iterations" ], "type": "object" }, "ResDef_Compute_RegressionResult": { "description": "Result of an ordinary-least-squares regression.", "properties": { "coefficients": { "items": { "format": "double", "type": "number" }, "type": "array" }, "intercept": { "format": "double", "type": "number" }, "r_squared": { "format": "double", "type": "number" }, "residuals": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "coefficients", "intercept", "r_squared", "residuals" ], "type": "object" }, "ResDef_Compute_RetrievalQualityMiningResult": { "description": "`MineRetrievalQuality`: aggregate retrieval metrics over the traces.", "properties": { "f1": { "format": "double", "type": "number" }, "k": { "format": "uint", "minimum": 0, "type": "integer" }, "mrr": { "format": "double", "type": "number" }, "n_queries": { "format": "uint", "minimum": 0, "type": "integer" }, "ndcg_at_k": { "format": "double", "type": "number" }, "precision_at_k": { "format": "double", "type": "number" }, "recall_at_k": { "format": "double", "type": "number" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "precision_at_k", "recall_at_k", "mrr", "f1", "ndcg_at_k", "n_queries", "k", "written_back" ], "type": "object" }, "ResDef_Compute_RiskMetrics": { "description": "Summary risk metrics of a return series.", "properties": { "calmar_ratio": { "format": "double", "type": "number" }, "cvar_95": { "format": "double", "type": "number" }, "cvar_99": { "format": "double", "type": "number" }, "downside_deviation": { "format": "double", "type": "number" }, "max_drawdown": { "format": "double", "type": "number" }, "sortino_ratio": { "format": "double", "type": "number" }, "var_95": { "format": "double", "type": "number" }, "var_99": { "format": "double", "type": "number" }, "volatility": { "format": "double", "type": "number" } }, "required": [ "var_95", "var_99", "cvar_95", "cvar_99", "max_drawdown", "volatility", "downside_deviation", "sortino_ratio", "calmar_ratio" ], "type": "object" }, "ResDef_Compute_RiskPropagationMiningResult": { "description": "`MineRiskPropagation`.", "properties": { "converged": { "type": "boolean" }, "iterations": { "format": "uint", "minimum": 0, "type": "integer" }, "scores": { "items": { "$ref": "#/components/schemas/ResDef_Compute_RiskScoreRow" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "scores", "iterations", "converged", "written_back" ], "type": "object" }, "ResDef_Compute_RiskScoreRow": { "description": "One node's propagated risk.", "properties": { "node": { "type": "string" }, "score": { "format": "double", "type": "number" } }, "required": [ "node", "score" ], "type": "object" }, "ResDef_Compute_RootCauseCandidateRow": { "description": "One root-cause candidate.", "properties": { "hops": { "format": "uint", "minimum": 0, "type": "integer" }, "node": { "type": "string" }, "score": { "format": "double", "type": "number" } }, "required": [ "node", "score", "hops" ], "type": "object" }, "ResDef_Compute_RootCauseMiningResult": { "description": "`MineRootCause`.", "properties": { "best": { "description": "The top candidate; `null` when there is none.", "type": [ "string", "null" ] }, "candidates": { "items": { "$ref": "#/components/schemas/ResDef_Compute_RootCauseCandidateRow" }, "type": "array" }, "symptom": { "type": "string" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "symptom", "candidates", "written_back" ], "type": "object" }, "ResDef_Compute_RowId": { "description": "Index of a constraint (its position in [`ModelSpec::constraints`]). Every\nconstraint lowers to exactly one linear row, so this is also the row index.", "format": "uint32", "minimum": 0, "type": "integer" }, "ResDef_Compute_RowRef": { "anyOf": [ { "type": "string" }, { "format": "uint", "minimum": 0, "type": "integer" } ], "description": "A row of a vector-mining input: its node id when the rows came from a node\nsource, else its index in the explicit input matrix." }, "ResDef_Compute_SabrFit": { "description": "A SABR smile calibration with `beta` fixed.", "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "converged": { "type": "boolean" }, "nu": { "format": "double", "type": "number" }, "rho": { "format": "double", "type": "number" }, "rmse": { "format": "double", "type": "number" } }, "required": [ "alpha", "beta", "rho", "nu", "rmse", "converged" ], "type": "object" }, "ResDef_Compute_Scalar": { "description": "An exact 128-bit signed integer (objective values, bounds, multipliers).", "type": "string" }, "ResDef_Compute_SequenceMiningResult": { "description": "`MineSequence`.", "properties": { "n_patterns": { "format": "uint", "minimum": 0, "type": "integer" }, "n_sequences": { "format": "uint", "minimum": 0, "type": "integer" }, "patterns": { "items": { "$ref": "#/components/schemas/ResDef_Compute_SequentialPatternRow" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "patterns", "n_sequences", "n_patterns", "written_back" ], "type": "object" }, "ResDef_Compute_SequentialPatternRow": { "description": "One frequent sequential pattern.", "properties": { "count": { "format": "uint", "minimum": 0, "type": "integer" }, "items": { "items": { "type": "string" }, "type": "array" }, "support": { "format": "double", "type": "number" } }, "required": [ "items", "support", "count" ], "type": "object" }, "ResDef_Compute_Sha256Digest": { "description": "A SHA-256 digest, serialised as 64 lower-case hex characters.", "type": "string" }, "ResDef_Compute_SolveResult": { "additionalProperties": false, "description": "A solved model: the certificate plus the digest a caller pins it by.", "properties": { "certificate": { "$ref": "#/components/schemas/ResDef_Compute_Certificate" }, "certificate_digest": { "$ref": "#/components/schemas/ResDef_Compute_Sha256Digest" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "certificate", "certificate_digest" ], "type": "object" }, "ResDef_Compute_SolveStatus": { "description": "The outcome class of a solve.", "oneOf": [ { "const": "optimal", "description": "The incumbent is optimal and the tree or root proof certifies it.", "type": "string" }, { "additionalProperties": false, "description": "The search completed; its tree exceeded the certificate limit, so the\nproof is a reproducible deterministic derivation, not a certificate.", "properties": { "optimal_by_deterministic_search": { "additionalProperties": false, "properties": { "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes_expanded" ], "type": "object" } }, "required": [ "optimal_by_deterministic_search" ], "type": "object" }, { "additionalProperties": false, "description": "The budget ran out with a certified gap no larger than the accepted gap.", "properties": { "feasible_with_gap": { "additionalProperties": false, "properties": { "gap": { "$ref": "#/components/schemas/ResDef_Compute_Scalar" } }, "required": [ "gap" ], "type": "object" } }, "required": [ "feasible_with_gap" ], "type": "object" }, { "additionalProperties": false, "description": "No feasible assignment exists; `core` lists the rows the proof uses.", "properties": { "infeasible": { "additionalProperties": false, "properties": { "core": { "items": { "$ref": "#/components/schemas/ResDef_Compute_RowId" }, "type": "array" } }, "required": [ "core" ], "type": "object" } }, "required": [ "infeasible" ], "type": "object" }, { "additionalProperties": false, "description": "The search completed without a feasible assignment and without a\ncertificate-sized tree.", "properties": { "infeasible_by_deterministic_search": { "additionalProperties": false, "properties": { "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes_expanded" ], "type": "object" } }, "required": [ "infeasible_by_deterministic_search" ], "type": "object" }, { "const": "budget_exhausted", "description": "The budget ran out with no incumbent or a gap above the accepted gap.", "type": "string" } ] }, "ResDef_Compute_SolverConfig": { "additionalProperties": false, "description": "Deterministic work limits and gap acceptance. No wall clock is read.", "properties": { "accepted_gap": { "$ref": "#/components/schemas/ResDef_Compute_Scalar" }, "bound_denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_certificate_leaves": { "format": "uint32", "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_certificate_leaves", "bound_denominator", "accepted_gap" ], "type": "object" }, "ResDef_Compute_SpreadReversion": { "description": "Rolling spread z-score and its mean-reversion signal.", "properties": { "signal": { "items": { "format": "double", "type": "number" }, "type": "array" }, "zscore": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "zscore", "signal" ], "type": "object" }, "ResDef_Compute_SubgraphMiningResult": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Compute_GspanMiningResult" }, { "$ref": "#/components/schemas/ResDef_Compute_MotifMiningResult" } ], "description": "`MineSubgraph`: the body is selected by the request's algorithm." }, "ResDef_Compute_SubgraphPatternRow": { "description": "One frequent subgraph pattern.", "properties": { "count": { "format": "uint", "minimum": 0, "type": "integer" }, "edges": { "items": { "$ref": "#/components/schemas/ResDef_Compute_PatternEdge" }, "type": "array" }, "nodes": { "description": "Node labels, indexed by pattern-local node index.", "items": { "type": "string" }, "type": "array" }, "support": { "format": "double", "type": "number" } }, "required": [ "nodes", "edges", "support", "count" ], "type": "object" }, "ResDef_Compute_SurveillanceRisk": { "description": "Continuous-time-Kyle surveillance estimate over a trailing book/flow window.", "properties": { "cumulative_suspicion": { "format": "double", "type": "number" }, "detection_hazard": { "format": "double", "type": "number" }, "informed_share": { "format": "double", "type": "number" }, "kyle_lambda": { "format": "double", "type": "number" }, "legal_risk_score": { "format": "double", "type": "number" }, "stealth_ratio": { "format": "double", "type": "number" } }, "required": [ "kyle_lambda", "informed_share", "detection_hazard", "cumulative_suspicion", "stealth_ratio", "legal_risk_score" ], "type": "object" }, "ResDef_Compute_TermWeight": { "description": "A weighted term.", "properties": { "term": { "type": "string" }, "weight": { "format": "double", "type": "number" } }, "required": [ "term", "weight" ], "type": "object" }, "ResDef_Compute_TextMiningResult": { "description": "`MineText`.", "properties": { "algorithm": { "description": "Absent when there were no documents to mine.", "type": [ "string", "null" ] }, "doc_terms": { "items": { "$ref": "#/components/schemas/ResDef_Compute_DocTerms" }, "type": "array" }, "doc_topics": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "n_docs": { "format": "uint", "minimum": 0, "type": "integer" }, "topics": { "items": { "$ref": "#/components/schemas/ResDef_Compute_TopicTerms" }, "type": "array" }, "written_back": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "doc_terms", "topics", "doc_topics", "n_docs", "written_back" ], "type": "object" }, "ResDef_Compute_TopicTerms": { "description": "A topic's weighted terms.", "properties": { "terms": { "items": { "$ref": "#/components/schemas/ResDef_Compute_TermWeight" }, "type": "array" }, "topic_id": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "topic_id", "terms" ], "type": "object" }, "ResDef_Compute_TrainTestSplitResult": { "description": "The four partitions of a train/test split.", "properties": { "x_test": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "x_train": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y_test": { "items": { "format": "double", "type": "number" }, "type": "array" }, "y_train": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "x_train", "x_test", "y_train", "y_test" ], "type": "object" }, "ResDef_Compute_TreeNode": { "description": "A flat regression tree: node `i` is a leaf when `feature < 0`.", "properties": { "feature": { "format": "int64", "type": "integer" }, "left": { "format": "int64", "type": "integer" }, "right": { "format": "int64", "type": "integer" }, "threshold": { "format": "double", "type": "number" }, "value": { "format": "double", "type": "number" } }, "required": [ "feature", "threshold", "left", "right", "value" ], "type": "object" }, "ResDef_Compute_VarId": { "description": "Index of a binary decision variable (its position in [`ModelSpec::variables`]).", "format": "uint32", "minimum": 0, "type": "integer" }, "ResDef_Compute_Vf2MatchResult": { "description": "Materialized result of a bounded VF2 subgraph-isomorphism search.\n\n`truncated` is true when either the requested match limit or search-step\nbudget stopped the search before the candidate space was exhausted.", "properties": { "matches": { "items": { "additionalProperties": { "type": "string" }, "type": "object" }, "type": "array" }, "truncated": { "type": "boolean" } }, "required": [ "matches", "truncated" ], "type": "object" }, "ResDef_Coordination_AgentGraphEntryRef": { "additionalProperties": false, "description": "One pinned agent GRAPH, as a delegation target (RF-ADR-008).\n\nMirrors [`AgentLibraryEntryRef`] exactly: both pin the record's\n`definition_digest`.\n\n# Why a delegation pins the RECORD digest and a composing parent does not\n\nA [`crate::agent_graph::AgentGraphNodeKind::Graph`] node deliberately pins\nthe child's `shape_digest` -- what a parent composes is the child's\nBEHAVIOUR, and the child's governance is re-checked live at every\nresolution, so pinning a stale copy of it would force a cascading republish\nof an entire tree for a change that alters no behaviour.\n\nA delegation is the opposite question. It names a record IDENTITY, and it is\nthe audit point: `synthesis_evidence` -- which RF-ADR-008 section D says is what\nmakes a synthesized graph auditable and reproducible -- is inside\n`definition_digest` and outside `shape_digest`, as are `version`, the actor\nscope, the purpose, the policy digest and the admitted\n`composed_work_ceiling`. A delegation that pinned only the shape would\nattest to what ran while leaving WHY it was composed unpinned.\n\nDo not \"unify\" the two by giving both the same digest: they answer different\nquestions, and [`crate::agent_graph::AgentGraphEntry`]'s own impl-block doc\ncarries the other half of this note.\n\nThe behaviour pin is not lost: `definition_digest` is a hash OVER\n`shape_digest`, and a shape digest covers every node, while an agent node\npins its own `definition_digest`, which pins every component it is assembled\nfrom. So the record digest still pins the ENTIRE tree transitively -- which\nis why a graph target needs no separate `model_digest` (see\n[`KgDelegateRequest::model_digest`]).", "properties": { "actor_scope": { "type": "string" }, "composed_work_ceiling": { "description": "The composed work ceiling this graph was admitted with --\n`CompositionFacts::total_work` from its publish.\n\nCarried rather than recomputed for two reasons. An executor cannot\nderive it without re-resolving the whole composition tree, and more\nimportantly it must honour the ceiling that was VALIDATED at admission,\nnot one it recomputes later against a tree that may have grown new\nrevisions.", "format": "uint64", "minimum": 0, "type": "integer" }, "definition_digest": { "description": "The published RECORD digest -- see the type doc for why this is the\nrecord digest and not the shape digest.", "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "graph_id", "entry_revision", "definition_digest", "actor_scope", "purpose_id", "policy_digest", "composed_work_ceiling" ], "type": "object" }, "ResDef_Coordination_AgentLibraryEntryRef": { "additionalProperties": false, "description": "The retained Agent Library identity pinned by a delegation.\n\nThe fields mirror the current Agent Library entry identity: the tenant and\nactor/purpose/policy binding are checked at admission, while the definition\nand source digests pin the exact retained revision. EG never resolves this\nreference from a local cache; the admission owner supplies the retained\nentry and compares this exact value before creating a WorkItem.", "properties": { "actor_scope": { "type": "string" }, "agent_id": { "type": "string" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" }, "source_revision_digest": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "agent_id", "entry_revision", "definition_digest", "source_revision", "source_revision_digest", "actor_scope", "purpose_id", "policy_digest" ], "type": "object" }, "ResDef_Coordination_AnalyticsJobRecord": { "additionalProperties": false, "description": "The durable analytics-job record, as a caller sees it.", "properties": { "algo": { "$ref": "#/components/schemas/ResDef_Coordination_JobAlgoVersion" }, "cancel_requested": { "type": "boolean" }, "created_at_ms": { "format": "int64", "type": "integer" }, "input_snapshot": { "$ref": "#/components/schemas/ResDef_Coordination_JobInputSnapshot" }, "job_id": { "type": "string" }, "last_worker_ref": { "type": "string" }, "lease": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_JobWorkerLease" }, { "type": "null" } ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "not_before_ms": { "format": "int64", "type": "integer" }, "output": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_JobResult" }, { "type": "null" } ] }, "policy": { "$ref": "#/components/schemas/ResDef_Coordination_JobPolicy" }, "retry": { "$ref": "#/components/schemas/ResDef_Coordination_JobRetryPolicy" }, "state": { "$ref": "#/components/schemas/ResDef_Coordination_JobState" }, "updated_at_ms": { "format": "int64", "type": "integer" } }, "required": [ "job_id", "input_snapshot", "policy", "algo", "retry", "state", "cancel_requested", "lease_epoch", "last_worker_ref", "not_before_ms", "created_at_ms", "updated_at_ms" ], "type": "object" }, "ResDef_Coordination_BoundedVec_FeatureStandardisation_32": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_FeatureStandardisation" }, "maxItems": 32, "type": "array" }, "ResDef_Coordination_BoundedVec_OpeEstimateView_8": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_OpeEstimateView" }, "maxItems": 8, "type": "array" }, "ResDef_Coordination_BoundedVec_PooledRate_64": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_PooledRate" }, "maxItems": 64, "type": "array" }, "ResDef_Coordination_BoundedVec_QuantisedValue_32": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "maxItems": 32, "type": "array" }, "ResDef_Coordination_BoundedVec_string_16": { "items": { "type": "string" }, "maxItems": 16, "type": "array" }, "ResDef_Coordination_CalibrationMethod": { "description": "How the scores were calibrated, if at all.", "enum": [ "temperature", "vector", "dirichlet", "isotonic", "none" ], "type": "string" }, "ResDef_Coordination_CalibrationStatement": { "additionalProperties": false, "description": "The calibration behind a decision's probabilities.", "properties": { "alpha": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire" }, { "type": "null" } ], "default": null }, "coverage_lower": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire" }, { "type": "null" } ], "default": null }, "coverage_upper": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire" }, { "type": "null" } ], "default": null }, "method": { "$ref": "#/components/schemas/ResDef_Coordination_CalibrationMethod" }, "n_calibration": { "format": "uint64", "minimum": 0, "type": "integer" }, "synthetic": { "description": "True when the calibration set was synthetic.", "type": "boolean" } }, "required": [ "method", "n_calibration", "synthetic" ], "type": "object" }, "ResDef_Coordination_CapacityAcquireResult": { "additionalProperties": false, "properties": { "available": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityAvailability" }, "type": "array" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityDecision" }, "leases": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityLease" }, "type": "array" }, "message": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_NativeControlSchemaVersion" } }, "required": [ "schema_version", "decision", "leases", "available" ], "type": "object" }, "ResDef_Coordination_CapacityAvailability": { "additionalProperties": false, "properties": { "available": { "format": "uint64", "minimum": 0, "type": "integer" }, "cell_id": { "type": "string" }, "requested": { "format": "uint64", "minimum": 0, "type": "integer" }, "resource_class": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityResourceClass" } }, "required": [ "cell_id", "resource_class", "available", "requested" ], "type": "object" }, "ResDef_Coordination_CapacityCell": { "additionalProperties": false, "description": "A durable capacity pool. `capacity` is the cell's total admittable amount at\nits current `epoch`; `reserved_floor` is the slice never available to\n`BackgroundIngestion` (invariant: \"Interactive and orchestration floors are\nreserved; background uses spare capacity but cannot starve a tenant\nindefinitely\").", "properties": { "capacity": { "format": "uint64", "minimum": 0, "type": "integer" }, "cell_id": { "type": "string" }, "epoch": { "description": "Monotonic authority epoch (GOC-03 fencing concept, vendored \u2014 see module\ndoc). Bumped on cell-authority failover/repartition; an acquire/renew\ncarrying an epoch below this is a stale-authority rejection, never a\nbest-effort read of a foreign shape.", "format": "uint64", "minimum": 0, "type": "integer" }, "parent_id": { "type": [ "string", "null" ] }, "policy_digest": { "description": "sha256 digest of the policy/catalog/model snapshot this cell was\nprovisioned under (checked at every hop per the lane doc's \"Security and\nprivacy\" section); opaque here, verified upstream.", "type": "string" }, "reserved_floor": { "format": "uint64", "minimum": 0, "type": "integer" }, "resource_class": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityResourceClass" }, "updated_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cell_id", "resource_class", "capacity", "reserved_floor", "epoch", "policy_digest", "updated_at_ms" ], "type": "object" }, "ResDef_Coordination_CapacityCellUpdateResult": { "additionalProperties": false, "properties": { "cell": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityCell" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityDecision" }, "message": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_NativeControlSchemaVersion" } }, "required": [ "schema_version", "decision", "cell" ], "type": "object" }, "ResDef_Coordination_CapacityDecision": { "enum": [ "accepted", "replayed", "released", "renewed", "reclaimed", "exhausted", "stale_epoch", "stale_fence", "expired", "not_found", "idempotency_conflict", "invalid", "backpressure" ], "type": "string" }, "ResDef_Coordination_CapacityLease": { "additionalProperties": false, "description": "One tenant's durable claim on a `CapacityCell`. Field set matches the lane\ndoc's frozen schema.", "properties": { "actor_digest": { "description": "Opaque authenticated actor identity (GOC-15 verified carrier digest).", "type": "string" }, "amount": { "format": "uint64", "minimum": 0, "type": "integer" }, "cell_id": { "type": "string" }, "cost_budget_micros": { "description": "Spend ceiling in **micro-units (1e-6) of the deployment's accounting\ncurrency** \u2014 exact integer, never a float.\n\nThis was `Option` and that was wrong three ways, not just\ninconvenient for the `Eq` derive:\n\n1. **`NaN`/`\u00b1Inf`/negative were representable and unvalidated.**\n `validate()` checks neither budget field, so a `NaN` ceiling passed\n silently. A budget is a *control*; a control that admits a value\n which compares false against everything fails open.\n2. **Float accumulation is inexact and non-associative.** A distributed\n cost ledger summing leases must reach the same total on every node\n regardless of summation order. `f64` does not guarantee that.\n3. **`NaN` is not JSON-representable.** It serializes to a bare `NaN`\n token that strict parsers reject, so a non-finite ceiling is an\n interop hazard at the AU boundary, not merely an odd number.\n\nAn unsigned integer makes all three unrepresentable rather than\nvalidated-against, and matches `token_budget` \u2014 the sibling ceiling in\nthis same struct, which was already exact. `None` means unbounded;\n`Some(0)` means \"may spend nothing\", a genuinely different state.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "fence_token": { "description": "Non-zero, unguessable-in-practice token minted at acquire time (GOC-03\nfencing concept, vendored). Renew/release must present the exact value\nlast minted for this `lease_id`; a mismatch is `StaleFence`.", "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "issued_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "description": "The `CapacityCell::epoch` this lease was acquired under. A renew/release\npresenting a lease whose `lease_epoch` is behind the cell's CURRENT\nepoch is `StaleEpoch` \u2014 the cell was repartitioned/failed-over and this\nholder's authority no longer applies, independent of whether its\n`expires_at_ms` has passed yet.", "format": "uint64", "minimum": 0, "type": "integer" }, "lease_id": { "type": "string" }, "priority": { "$ref": "#/components/schemas/ResDef_Coordination_LeasePriority" }, "renewed_count": { "format": "uint32", "minimum": 0, "type": "integer" }, "resource_class": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityResourceClass" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "state": { "$ref": "#/components/schemas/ResDef_Coordination_LeaseState" }, "tenant_ref": { "type": "string" }, "token_budget": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "lease_id", "work_item_id", "tenant_ref", "actor_digest", "cell_id", "resource_class", "amount", "priority", "fence_token", "lease_epoch", "issued_at_ms", "expires_at_ms", "renewed_count", "idempotency_key", "state" ], "type": "object" }, "ResDef_Coordination_CapacityMutationResult": { "additionalProperties": false, "properties": { "decision": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityDecision" }, "leases": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityLease" }, "type": "array" }, "message": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_NativeControlSchemaVersion" } }, "required": [ "schema_version", "decision", "leases" ], "type": "object" }, "ResDef_Coordination_CapacityReclaimResult": { "additionalProperties": false, "properties": { "decision": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityDecision" }, "next_cursor": { "type": [ "string", "null" ] }, "reclaimed_lease_ids": { "items": { "type": "string" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_NativeControlSchemaVersion" } }, "required": [ "schema_version", "decision", "reclaimed_lease_ids" ], "type": "object" }, "ResDef_Coordination_CapacityResourceClass": { "description": "The resource a `CapacityCell` doles out. Mirrors the lane doc's \"CPU/LLM/GPU\ncapacity\" plus the existing AU gates this composes with\n(`resource_priority.py`'s shared-LLM gate, `worker_scheduler.py`'s host\nworker pool, `gpu_group_budget.py`'s per-GPU/model floors).", "oneOf": [ { "const": "llm_generator", "description": "Shared LLM generator admission slots (composes with `resource_priority.py`).", "type": "string" }, { "const": "llm_embedding", "description": "A separate embedding endpoint's admission slots \u2014 never contends with\n`LlmGenerator` (mirrors `resource_priority.py`'s separate embedding gate key).", "type": "string" }, { "const": "gpu", "description": "GPU compute units (composes with `gpu_group_budget.py`).", "type": "string" }, { "const": "worker", "description": "Host worker pool slots (composes with `worker_scheduler.py`).", "type": "string" }, { "const": "cpu", "description": "CPU-bound compute slots.", "type": "string" }, { "const": "broker", "description": "Message-broker/engine dispatch admission slots.", "type": "string" } ] }, "ResDef_Coordination_CapacityStatusResult": { "additionalProperties": false, "properties": { "cells": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityCell" }, "type": "array" }, "leases": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityLease" }, "type": "array" }, "next_cursor": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_NativeControlSchemaVersion" } }, "required": [ "schema_version", "cells", "leases" ], "type": "object" }, "ResDef_Coordination_CasWorkItemMetadataOutcome": { "description": "Three distinct outcomes \u2014 deliberately never collapsed to a bool. A\nfalsy/empty return here would be indistinguishable at the call site from\n\"no such item\" (AU-P0-3 fail-closed doctrine): a worker that cannot tell\n\"I lost a race\" from \"the item vanished\" cannot safely decide whether to\nretry, re-read, or abandon its lease.", "oneOf": [ { "const": "applied", "description": "The compare-and-set matched and the field was durably written.", "type": "string" }, { "const": "conflict", "description": "The row exists but the observed condition (status / lease fence /\nthe field's own expected prior value) no longer matches \u2014 a genuine\nlost race, not an error. The caller re-reads and decides whether to\nretry.", "type": "string" }, { "const": "not_found", "description": "No WorkItem row `work_item_id` exists in this graph for `tenant_ref`.", "type": "string" } ] }, "ResDef_Coordination_CasWorkItemMetadataResult": { "additionalProperties": false, "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "outcome": { "$ref": "#/components/schemas/ResDef_Coordination_CasWorkItemMetadataOutcome" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_CasWorkItemMetadataResultSchemaVersion" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "outcome", "work_item_id", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_CasWorkItemMetadataResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_ClaimWorkItemResult": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "claimed": { "type": "boolean" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "kind": { "type": [ "string", "null" ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "lease_expires_at_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "lease_holder_ref": { "type": [ "string", "null" ] }, "max_attempts": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "payload_ref": { "type": [ "string", "null" ] }, "reason": { "$ref": "#/components/schemas/ResDef_Coordination_ClaimWorkItemResultReason" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_ClaimWorkItemResultSchemaVersion" }, "tenant_in_flight": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "claimed", "reason", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_ClaimWorkItemResultReason": { "enum": [ "claimed", "empty", "tenant_quota" ], "type": "string" }, "ResDef_Coordination_ClaimWorkItemResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_ClaimedAnalyticsJob": { "description": "The job a worker claimed: its record plus the opaque executor payload the worker\nruns, which only the claiming worker ever receives.", "properties": { "algo": { "$ref": "#/components/schemas/ResDef_Coordination_JobAlgoVersion" }, "cancel_requested": { "type": "boolean" }, "created_at_ms": { "format": "int64", "type": "integer" }, "input_payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": [ "array", "null" ] }, "input_snapshot": { "$ref": "#/components/schemas/ResDef_Coordination_JobInputSnapshot" }, "job_id": { "type": "string" }, "last_worker_ref": { "type": "string" }, "lease": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_JobWorkerLease" }, { "type": "null" } ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "not_before_ms": { "format": "int64", "type": "integer" }, "output": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_JobResult" }, { "type": "null" } ] }, "policy": { "$ref": "#/components/schemas/ResDef_Coordination_JobPolicy" }, "retry": { "$ref": "#/components/schemas/ResDef_Coordination_JobRetryPolicy" }, "state": { "$ref": "#/components/schemas/ResDef_Coordination_JobState" }, "updated_at_ms": { "format": "int64", "type": "integer" } }, "required": [ "job_id", "input_snapshot", "policy", "algo", "retry", "state", "cancel_requested", "lease_epoch", "last_worker_ref", "not_before_ms", "created_at_ms", "updated_at_ms" ], "type": "object" }, "ResDef_Coordination_ControlLeaseIssueOutcome": { "description": "How an issue resolved.", "oneOf": [ { "enum": [ "issued" ], "type": "string" }, { "const": "collision", "description": "A row with this id already exists; nothing was written.", "type": "string" } ] }, "ResDef_Coordination_ControlLeaseIssued": { "additionalProperties": false, "description": "Result of `IssueControlLease`. `changed_work_item_ids` names the rows the\ncommit wrote, so the serving projection refreshes from authority exactly as\nit does for a WorkItem transition.", "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "lease": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_ControlLeaseView" }, { "type": "null" } ] }, "outcome": { "$ref": "#/components/schemas/ResDef_Coordination_ControlLeaseIssueOutcome" } }, "required": [ "outcome", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_ControlLeaseStatus": { "description": "Where a control lease is in its one-way lifecycle.", "oneOf": [ { "enum": [ "active", "revoked", "expired" ], "type": "string" }, { "const": "consumed", "description": "A single-use grant that has been spent; still live until it is\nrevoked or expires.", "type": "string" } ] }, "ResDef_Coordination_ControlLeaseTransition": { "additionalProperties": false, "description": "Result of `TransitionControlLease`. On `conflict` the CURRENT view is\nreturned so a caller can decide again without a second read.", "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "lease": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_ControlLeaseView" }, { "type": "null" } ] }, "outcome": { "$ref": "#/components/schemas/ResDef_Coordination_ControlLeaseTransitionOutcome" } }, "required": [ "outcome", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_ControlLeaseTransitionOutcome": { "description": "How a transition resolved.", "oneOf": [ { "enum": [ "applied" ], "type": "string" }, { "const": "conflict", "description": "The edge is not legal from the lease's current status, or the lease\nmoved past `expected_revision`.", "type": "string" }, { "const": "not_found", "description": "No lease with this id is visible to the tenant.", "type": "string" } ] }, "ResDef_Coordination_ControlLeaseView": { "additionalProperties": false, "description": "The caller's view of one control lease.", "properties": { "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "grant": { "additionalProperties": true, "type": "object" }, "hard_expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "issued_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "type": "string" }, "lease_id": { "type": "string" }, "revision": { "description": "Row revision: 1 at issue, bumped by every transition.", "format": "uint64", "minimum": 0, "type": "integer" }, "status": { "$ref": "#/components/schemas/ResDef_Coordination_ControlLeaseStatus" } }, "required": [ "lease_id", "kind", "status", "grant", "issued_at_ms", "expires_at_ms", "hard_expires_at_ms", "revision" ], "type": "object" }, "ResDef_Coordination_DecisionEvalReceipt": { "additionalProperties": false, "description": "The receipt a head must carry before it may be published.", "properties": { "calibration": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_CalibrationStatement" }, { "type": "null" } ], "default": null }, "estimates": { "$ref": "#/components/schemas/ResDef_Coordination_BoundedVec_OpeEstimateView_8" }, "exclusions": { "$ref": "#/components/schemas/ResDef_Coordination_LabelExclusions" }, "failed_gates": { "$ref": "#/components/schemas/ResDef_Coordination_BoundedVec_string_16", "default": [], "description": "Every promotion gate that failed, by name. Empty exactly when `passed`." }, "head_digest": { "type": "string" }, "metrics": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_FullLabelMetrics" }, { "type": "null" } ], "default": null }, "n_records": { "format": "uint64", "minimum": 0, "type": "integer" }, "passed": { "type": "boolean" }, "policy_digest": { "type": "string" }, "pooled": { "$ref": "#/components/schemas/ResDef_Coordination_BoundedVec_PooledRate_64", "default": [], "description": "Bandit regime only: pooled per-option success rates at min support." }, "receipt_digest": { "type": "string" }, "synthetic": { "type": "boolean" } }, "required": [ "receipt_digest", "head_digest", "policy_digest", "n_records", "estimates", "exclusions", "passed", "synthetic" ], "type": "object" }, "ResDef_Coordination_DecisionHeadBody": { "additionalProperties": false, "description": "The body of a `DecisionHead` component, and of a fit job's draft.", "properties": { "calibration": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_HeadCalibration" }, { "type": "null" } ], "default": null }, "feature_schema_digest": { "description": "`sha256:` content digest of the feature schema body it reads.", "type": "string" }, "kind": { "$ref": "#/components/schemas/ResDef_Coordination_HeadKind" }, "n_training": { "format": "uint64", "minimum": 0, "type": "integer" }, "regime": { "$ref": "#/components/schemas/ResDef_Coordination_FittedRegime" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "standardisation": { "$ref": "#/components/schemas/ResDef_Coordination_BoundedVec_FeatureStandardisation_32" }, "synthetic": { "type": "boolean" }, "training_records_digest": { "description": "Digest of the admitted training items, in order.", "type": "string" }, "weights": { "$ref": "#/components/schemas/ResDef_Coordination_BoundedVec_QuantisedValue_32" } }, "required": [ "schema_version", "kind", "regime", "feature_schema_digest", "standardisation", "weights", "training_records_digest", "n_training", "synthetic" ], "type": "object" }, "ResDef_Coordination_DecisionJobKind": { "description": "Which of the two jobs a row is.", "enum": [ "fit", "eval" ], "type": "string" }, "ResDef_Coordination_DecisionJobOutput": { "description": "What a finished job produced.", "oneOf": [ { "additionalProperties": false, "properties": { "draft": { "$ref": "#/components/schemas/ResDef_Coordination_DecisionHeadBody", "description": "The draft body itself; publishing it as a `DecisionHead` needs a\npassed evaluation receipt naming `draft_sha256`." }, "draft_length": { "format": "uint64", "minimum": 0, "type": "integer" }, "draft_sha256": { "type": "string" }, "exclusions": { "$ref": "#/components/schemas/ResDef_Coordination_LabelExclusions" }, "head_digest": { "type": "string" }, "output": { "const": "fit", "type": "string" }, "synthetic": { "type": "boolean" }, "training_records_digest": { "type": "string" } }, "required": [ "output", "draft_sha256", "draft_length", "head_digest", "training_records_digest", "synthetic", "draft", "exclusions" ], "type": "object" }, { "additionalProperties": false, "description": "Boxed: a receipt is several times the size of every other arm.", "properties": { "output": { "const": "eval", "type": "string" }, "receipt": { "$ref": "#/components/schemas/ResDef_Coordination_DecisionEvalReceipt" } }, "required": [ "output", "receipt" ], "type": "object" } ] }, "ResDef_Coordination_DecisionJobRecord": { "additionalProperties": false, "description": "One durable decision-job row.", "properties": { "job_id": { "type": "string" }, "kind": { "$ref": "#/components/schemas/ResDef_Coordination_DecisionJobKind" }, "request_digest": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "state": { "$ref": "#/components/schemas/ResDef_Coordination_DecisionJobState" }, "submitted_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "job_id", "kind", "tenant_id", "request_digest", "submitted_at_ms", "state" ], "type": "object" }, "ResDef_Coordination_DecisionJobState": { "description": "Where a job is.", "oneOf": [ { "additionalProperties": false, "properties": { "state": { "const": "queued", "type": "string" } }, "required": [ "state" ], "type": "object" }, { "additionalProperties": false, "properties": { "state": { "const": "running", "type": "string" } }, "required": [ "state" ], "type": "object" }, { "additionalProperties": false, "description": "Boxed: the output carries a whole head or receipt.", "properties": { "output": { "$ref": "#/components/schemas/ResDef_Coordination_DecisionJobOutput" }, "state": { "const": "succeeded", "type": "string" } }, "required": [ "state", "output" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "type": "string" }, "state": { "const": "failed", "type": "string" } }, "required": [ "state", "code" ], "type": "object" }, { "additionalProperties": false, "properties": { "state": { "const": "cancelled", "type": "string" } }, "required": [ "state" ], "type": "object" } ] }, "ResDef_Coordination_DelegationTarget": { "description": "What a delegation runs.\n\n# Why one delegation, not one per node\n\nA graph delegation admits exactly ONE work item. The child agent runs are\nthe executor's business, bounded by the graph's own composed ceiling.\n\nThe alternative -- admitting one work item per node -- was rejected because\n`max_tenant_in_flight` would then make a graph UNSCHEDULABLE whenever its\nnode count exceeded the tenant's limit: the parent would hold a slot while\nwaiting for children that cannot get one. That is a deadlock, not a\nthrottle.\n\nSo the two bounds govern two different things, and both are needed:\n\n* `max_tenant_in_flight` bounds how many DELEGATIONS a tenant may have in\n flight;\n* `composed_work_ceiling` bounds what one delegation may do INTERNALLY.\n\nWithout the second, a graph would be a way to escape the first by fanning\nout. `MAX_COMPOSITION_WORK` is the global cap that makes the escape\nimpossible rather than merely discouraged.", "oneOf": [ { "description": "One published agent (layer 2).", "properties": { "entry": { "$ref": "#/components/schemas/ResDef_Coordination_AgentLibraryEntryRef" }, "target": { "const": "agent", "type": "string" } }, "required": [ "target", "entry" ], "type": "object" }, { "description": "One published agent graph -- a team (layer 3).", "properties": { "graph": { "$ref": "#/components/schemas/ResDef_Coordination_AgentGraphEntryRef", "description": "Boxed: a graph ref is the larger variant, and an unboxed enum pays\nits size on every delegation including single-agent ones." }, "target": { "const": "graph", "type": "string" } }, "required": [ "target", "graph" ], "type": "object" } ] }, "ResDef_Coordination_DevelopmentLaneCleanupCompleteResult": { "additionalProperties": false, "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneCleanupCompleteResultDecision" }, "hold": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHold" }, { "type": "null" } ] }, "hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "quota_charge": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaCharge" }, { "type": "null" } ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneCleanupCompleteResultSchemaVersion" }, "tombstone": { "type": "boolean" } }, "required": [ "schema_version", "decision", "hold_revision", "lifecycle_revision", "tombstone", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneCleanupCompleteResultDecision": { "enum": [ "accepted", "idempotent", "stale", "conflict", "input_conflict", "quota", "policy", "drained", "not_found", "wrong_kind", "wrong_tenant", "wrong_owner", "wrong_attempt", "wrong_lease_epoch", "wrong_fence", "expired", "terminal", "cleanup_required", "exclusivity", "invalid" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneCleanupCompleteResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneFinishResult": { "additionalProperties": false, "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneFinishResultDecision" }, "hold": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHold" }, { "type": "null" } ] }, "hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "quota_charge": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaCharge" }, { "type": "null" } ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneFinishResultSchemaVersion" }, "tombstone": { "type": "boolean" } }, "required": [ "schema_version", "decision", "hold_revision", "lifecycle_revision", "tombstone", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneFinishResultDecision": { "enum": [ "accepted", "idempotent", "stale", "conflict", "input_conflict", "quota", "policy", "drained", "not_found", "wrong_kind", "wrong_tenant", "wrong_owner", "wrong_attempt", "wrong_lease_epoch", "wrong_fence", "expired", "terminal", "cleanup_required", "exclusivity", "invalid" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneFinishResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneHold": { "additionalProperties": false, "properties": { "active_count_charged": { "type": "boolean" }, "allocation_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "base_ref": { "type": "string" }, "base_sha": { "type": "string" }, "branch": { "type": "string" }, "cleanup_attempt": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "cleanup_fencing_token": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "cleanup_lease_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "cleanup_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_work_item_fence": { "type": [ "string", "null" ] }, "cleanup_work_item_id": { "type": [ "string", "null" ] }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "fairness_group": { "type": "string" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "host_target_alias": { "type": [ "string", "null" ] }, "host_target_kind": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHoldHostTargetKind" }, "input_fingerprint": { "type": "string" }, "lane_id": { "type": "string" }, "last_renewed_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "quota_charge": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaCharge" }, "quota_policy_name": { "type": "string" }, "quota_policy_version": { "type": "string" }, "repository_id": { "type": "string" }, "request_id": { "type": "string" }, "retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHoldSchemaVersion" }, "session_id": { "type": "string" }, "state": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHoldState" }, "tenant_ref": { "type": "string" }, "tombstone": { "type": "boolean" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" }, "workspace_ref": { "type": "string" }, "worktree_locator": { "type": "string" } }, "required": [ "schema_version", "hold_id", "lane_id", "tenant_ref", "request_id", "work_item_id", "owner_id", "session_id", "fairness_group", "workspace_ref", "repository_id", "base_ref", "base_sha", "branch", "worktree_locator", "host_target_kind", "host_ref", "quota_policy_name", "quota_policy_version", "input_fingerprint", "predicted_disk_bytes", "observed_disk_bytes", "retained_disk_bytes", "active_count_charged", "quota_charge", "state", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "hold_revision", "lifecycle_revision", "allocation_revision", "cleanup_revision", "expires_at_ms", "last_renewed_at_ms", "tombstone" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneHoldHostTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneHoldSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneHoldState": { "enum": [ "allocating", "active", "submitted", "released", "expired", "cleanup_pending", "cleaned", "aborted", "absent" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneObserveResult": { "additionalProperties": false, "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneObserveResultDecision" }, "hold": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHold" }, { "type": "null" } ] }, "hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "quota_charge": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaCharge" }, { "type": "null" } ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneObserveResultSchemaVersion" }, "tombstone": { "type": "boolean" } }, "required": [ "schema_version", "decision", "hold_revision", "lifecycle_revision", "tombstone", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneObserveResultDecision": { "enum": [ "accepted", "idempotent", "stale", "conflict", "input_conflict", "quota", "policy", "drained", "not_found", "wrong_kind", "wrong_tenant", "wrong_owner", "wrong_attempt", "wrong_lease_epoch", "wrong_fence", "expired", "terminal", "cleanup_required", "exclusivity", "invalid" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneObserveResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneQueryResult": { "additionalProperties": false, "properties": { "decision": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQueryResultDecision" }, "hold": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHold" }, { "type": "null" } ] }, "hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQueryResultSchemaVersion" }, "tombstone": { "type": "boolean" } }, "required": [ "schema_version", "decision", "hold_revision", "lifecycle_revision", "tombstone" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneQueryResultDecision": { "enum": [ "accepted", "idempotent", "stale", "conflict", "input_conflict", "quota", "policy", "drained", "not_found", "wrong_kind", "wrong_tenant", "wrong_owner", "wrong_attempt", "wrong_lease_epoch", "wrong_fence", "expired", "terminal", "cleanup_required", "exclusivity", "invalid" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneQueryResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneQuotaCharge": { "additionalProperties": false, "properties": { "global_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaChargeSchemaVersion" }, "session_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "tenant_count", "owner_count", "session_count", "workspace_count", "repository_count", "host_count", "global_count", "tenant_predicted_disk_bytes", "owner_predicted_disk_bytes", "session_predicted_disk_bytes", "workspace_predicted_disk_bytes", "repository_predicted_disk_bytes", "host_predicted_disk_bytes", "global_predicted_disk_bytes", "tenant_observed_disk_bytes", "owner_observed_disk_bytes", "session_observed_disk_bytes", "workspace_observed_disk_bytes", "repository_observed_disk_bytes", "host_observed_disk_bytes", "global_observed_disk_bytes", "tenant_retained_disk_bytes", "owner_retained_disk_bytes", "session_retained_disk_bytes", "workspace_retained_disk_bytes", "repository_retained_disk_bytes", "host_retained_disk_bytes", "global_retained_disk_bytes", "revision", "policy_revision" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneQuotaChargeSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneQuotaPolicy": { "additionalProperties": false, "properties": { "drain_only": { "type": "boolean" }, "global_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_observation_staleness_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "min_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_name": { "type": "string" }, "policy_version": { "type": "string" }, "repository_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaPolicySchemaVersion" }, "session_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "policy_name", "policy_version", "tenant_count_limit", "owner_count_limit", "session_count_limit", "workspace_count_limit", "repository_count_limit", "host_count_limit", "global_count_limit", "tenant_predicted_disk_bytes", "owner_predicted_disk_bytes", "session_predicted_disk_bytes", "workspace_predicted_disk_bytes", "repository_predicted_disk_bytes", "host_predicted_disk_bytes", "global_predicted_disk_bytes", "tenant_observed_disk_bytes", "owner_observed_disk_bytes", "session_observed_disk_bytes", "workspace_observed_disk_bytes", "repository_observed_disk_bytes", "host_observed_disk_bytes", "global_observed_disk_bytes", "tenant_retained_disk_bytes", "owner_retained_disk_bytes", "session_retained_disk_bytes", "workspace_retained_disk_bytes", "repository_retained_disk_bytes", "host_retained_disk_bytes", "global_retained_disk_bytes", "min_ttl_ms", "max_ttl_ms", "max_observation_staleness_ms", "drain_only" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneQuotaPolicySchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneQuotaUpdateResult": { "additionalProperties": false, "properties": { "counters": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaCharge" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaUpdateResultDecision" }, "policy": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaPolicy" }, { "type": "null" } ] }, "policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaUpdateResultSchemaVersion" } }, "required": [ "schema_version", "decision", "counters", "policy_revision" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneQuotaUpdateResultDecision": { "enum": [ "accepted", "idempotent", "stale", "conflict", "quota", "policy", "drained", "invalid" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneQuotaUpdateResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneRenewResult": { "additionalProperties": false, "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneRenewResultDecision" }, "hold": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHold" }, { "type": "null" } ] }, "hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "quota_charge": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaCharge" }, { "type": "null" } ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneRenewResultSchemaVersion" }, "tombstone": { "type": "boolean" } }, "required": [ "schema_version", "decision", "hold_revision", "lifecycle_revision", "tombstone", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneRenewResultDecision": { "enum": [ "accepted", "idempotent", "stale", "conflict", "input_conflict", "quota", "policy", "drained", "not_found", "wrong_kind", "wrong_tenant", "wrong_owner", "wrong_attempt", "wrong_lease_epoch", "wrong_fence", "expired", "terminal", "cleanup_required", "exclusivity", "invalid" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneRenewResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneResult": { "additionalProperties": false, "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneResultDecision" }, "hold": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHold" }, { "type": "null" } ] }, "hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "quota_charge": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaCharge" }, { "type": "null" } ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneResultSchemaVersion" }, "tombstone": { "type": "boolean" } }, "required": [ "schema_version", "decision", "hold_revision", "lifecycle_revision", "tombstone", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneResultDecision": { "enum": [ "accepted", "idempotent", "stale", "conflict", "input_conflict", "quota", "policy", "drained", "not_found", "wrong_kind", "wrong_tenant", "wrong_owner", "wrong_attempt", "wrong_lease_epoch", "wrong_fence", "expired", "terminal", "cleanup_required", "exclusivity", "invalid" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_DevelopmentLaneStatusResult": { "additionalProperties": false, "properties": { "complete": { "type": "boolean" }, "counters": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaCharge" }, "holds": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneHold" }, "type": "array" }, "next_cursor": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneStatusResultSchemaVersion" }, "tenant_active_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tombstone": { "type": "boolean" } }, "required": [ "schema_version", "complete", "holds", "counters", "tenant_active_count", "tenant_retained_disk_bytes", "tombstone" ], "type": "object" }, "ResDef_Coordination_DevelopmentLaneStatusResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_FeatureStandardisation": { "additionalProperties": false, "description": "How one raw feature is standardised before the head reads it, and the\nrange it was seen in at fit time. A value outside that range is\nout-of-distribution and the decision abstains (drift, \u00a76.3).", "properties": { "center": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "lower": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "scale": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue", "description": "Strictly positive." }, "upper": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" } }, "required": [ "center", "scale", "lower", "upper" ], "type": "object" }, "ResDef_Coordination_FittedRegime": { "description": "Which labels the head was fitted on.", "oneOf": [ { "const": "full_label", "description": "Human or constructed acceptability sets: coverage and risk claims hold\non that distribution.", "type": "string" }, { "const": "bandit_label", "description": "Executed-option outcomes only: no coverage or \"best option\" claim.", "type": "string" } ] }, "ResDef_Coordination_FullLabelMetrics": { "additionalProperties": false, "description": "Full-label metrics of a candidate head, each rate an exact fraction of the\nadmitted items and each interval a Clopper-Pearson interval at `delta`.", "properties": { "act_risk_upper": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire" }, "acted": { "description": "Items the act rule acted on, and how many of those were wrong.", "format": "uint64", "minimum": 0, "type": "integer" }, "acted_wrong": { "format": "uint64", "minimum": 0, "type": "integer" }, "brier": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "coverage_lower": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire" }, "coverage_upper": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire" }, "covered": { "description": "Prediction set meets the acceptability set.", "format": "uint64", "minimum": 0, "type": "integer" }, "expected_calibration_error": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "log_loss": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "n_items": { "format": "uint64", "minimum": 0, "type": "integer" }, "set_size_total": { "description": "Sum of prediction-set sizes; mean = this / n_items.", "format": "uint64", "minimum": 0, "type": "integer" }, "top1_hits": { "description": "Top-1 lands in the acceptability set.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "n_items", "top1_hits", "log_loss", "brier", "expected_calibration_error", "covered", "coverage_lower", "coverage_upper", "acted", "acted_wrong", "act_risk_upper", "set_size_total" ], "type": "object" }, "ResDef_Coordination_GraphResourceStats": { "description": "Per-graph resource snapshot (CONCEPT:EG-KG.compute.lane-v).", "properties": { "edges": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "hibernated": { "description": "`true` if hibernated (in-RAM state dropped, durable in redb).", "type": "boolean" }, "memory_bytes": { "description": "Approximate resident RAM, bytes.", "format": "uint64", "minimum": 0, "type": "integer" }, "nodes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant": { "type": "string" } }, "required": [ "graph", "tenant", "nodes", "edges", "memory_bytes", "hibernated" ], "type": "object" }, "ResDef_Coordination_HeadCalibration": { "additionalProperties": false, "description": "The calibration a full-label head carries.", "properties": { "act_threshold": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, { "type": "null" } ], "default": null, "description": "The certified act threshold on the top probability, when the selective\nrisk procedure certified one. `None` means the head never acts." }, "alpha": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire", "description": "Miscoverage level the prediction set is calibrated at." }, "coverage_lower": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire", "description": "Realised coverage interval on the calibration items." }, "coverage_upper": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire" }, "inverse_temperature": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue", "description": "Multiplies the logits before the softmax (temperature scaling)." }, "n_calibration": { "format": "uint64", "minimum": 0, "type": "integer" }, "risk": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_RiskStatement" }, { "type": "null" } ], "default": null }, "set_threshold": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue", "description": "Largest nonconformity `1 - p` admitted into the prediction set." }, "synthetic": { "type": "boolean" } }, "required": [ "inverse_temperature", "alpha", "set_threshold", "coverage_lower", "coverage_upper", "n_calibration", "synthetic" ], "type": "object" }, "ResDef_Coordination_HeadKind": { "description": "Which head shape a fit produces.", "oneOf": [ { "const": "weighted_features", "description": "One weight per feature; an advisory score that never acts.", "type": "string" }, { "const": "listwise_logistic", "description": "A listwise logistic model over the candidate set.", "type": "string" } ] }, "ResDef_Coordination_JobAlgoVersion": { "additionalProperties": false, "description": "The full algorithm lineage a job's result is bound to.", "properties": { "algorithm": { "type": "string" }, "code_version": { "type": "string" }, "env_version": { "type": "string" }, "family": { "type": "string" }, "params_digest": { "type": "string" } }, "required": [ "family", "algorithm", "params_digest", "code_version", "env_version" ], "type": "object" }, "ResDef_Coordination_JobCheckpoint": { "additionalProperties": false, "description": "The last progress checkpoint a job wrote.", "properties": { "progress": { "format": "double", "type": "number" }, "stage": { "type": "string" }, "state_blob": { "description": "An opaque external state reference, as bytes.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": [ "array", "null" ] }, "updated_at_ms": { "format": "int64", "type": "integer" } }, "required": [ "progress", "stage", "updated_at_ms" ], "type": "object" }, "ResDef_Coordination_JobInputSnapshot": { "additionalProperties": false, "description": "The graph snapshot a job reads.", "properties": { "content_digest": { "type": "string" }, "dataset_ref": { "type": "string" }, "graph": { "type": "string" }, "version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "graph", "version", "dataset_ref", "content_digest" ], "type": "object" }, "ResDef_Coordination_JobPlacement": { "additionalProperties": false, "description": "Where a job may run.", "properties": { "pool": { "type": "string" }, "region": { "type": "string" }, "required_capabilities": { "items": { "type": "string" }, "type": "array" } }, "required": [ "pool", "region", "required_capabilities" ], "type": "object" }, "ResDef_Coordination_JobPolicy": { "additionalProperties": false, "description": "The authority and limits a job runs under.", "properties": { "actor": { "type": "string" }, "deadline_unix_ms": { "format": "int64", "type": [ "integer", "null" ] }, "placement": { "$ref": "#/components/schemas/ResDef_Coordination_JobPlacement" }, "policy_fingerprint": { "type": "string" }, "priority": { "format": "int32", "type": "integer" }, "purpose": { "type": "string" }, "quota_cpu_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "resources": { "$ref": "#/components/schemas/ResDef_Coordination_JobResourceBudget" }, "tenant": { "type": "string" } }, "required": [ "tenant", "actor", "purpose", "priority", "policy_fingerprint", "resources", "placement" ], "type": "object" }, "ResDef_Coordination_JobReproducibilityManifest": { "description": "Reproducibility manifest bound server-side to the leased job lineage.", "properties": { "algorithm_ref": { "type": "string" }, "environment_version": { "type": "string" }, "implementation_version": { "type": "string" }, "input_content_digest": { "type": "string" }, "input_dataset_ref": { "type": "string" }, "input_snapshot_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "params_digest": { "type": "string" }, "policy_fingerprint": { "type": "string" } }, "required": [ "input_dataset_ref", "input_content_digest", "input_snapshot_version", "algorithm_ref", "params_digest", "implementation_version", "environment_version", "policy_fingerprint" ], "type": "object" }, "ResDef_Coordination_JobResourceBudget": { "additionalProperties": false, "description": "A job's resource budget.", "properties": { "cpu_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "io_bytes": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "memory_bytes": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_bytes": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "ResDef_Coordination_JobResult": { "description": "KnowledgeBatch-shaped result currency accepted by [`JobOp::WorkerStage`].", "properties": { "calibration": { "default": null, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "double", "type": "number" }, { "format": "double", "type": "number" } ], "type": [ "array", "null" ] }, "content_digest": { "type": "string" }, "counterexample_refs": { "default": [], "items": { "type": "string" }, "type": "array" }, "dataset_ref": { "type": "string" }, "evidence_refs": { "default": [], "items": { "type": "string" }, "type": "array" }, "reproducibility": { "$ref": "#/components/schemas/ResDef_Coordination_JobReproducibilityManifest" }, "rows": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "schema": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_JobResultColumn" }, "type": "array" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "uncertainty": { "default": null, "format": "double", "type": [ "number", "null" ] } }, "required": [ "schema_version", "dataset_ref", "content_digest", "schema", "rows", "reproducibility" ], "type": "object" }, "ResDef_Coordination_JobResultColumn": { "description": "Portable typed result column for remote analytics workers.", "properties": { "logical_type": { "type": "string" }, "name": { "type": "string" }, "nullable": { "type": "boolean" } }, "required": [ "name", "logical_type", "nullable" ], "type": "object" }, "ResDef_Coordination_JobRetryPolicy": { "additionalProperties": false, "description": "A job's retry policy and attempt counter.", "properties": { "attempts_made": { "format": "uint32", "minimum": 0, "type": "integer" }, "backoff_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_attempts": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "max_attempts", "backoff_ms", "attempts_made" ], "type": "object" }, "ResDef_Coordination_JobState": { "description": "A job's lifecycle state.", "oneOf": [ { "enum": [ "Submitted" ], "type": "string" }, { "additionalProperties": false, "properties": { "Running": { "additionalProperties": false, "properties": { "checkpoint": { "$ref": "#/components/schemas/ResDef_Coordination_JobCheckpoint" } }, "required": [ "checkpoint" ], "type": "object" } }, "required": [ "Running" ], "type": "object" }, { "additionalProperties": false, "description": "The typed result is durable; its evidence-bearing claims are not yet.", "properties": { "Publishing": { "additionalProperties": false, "properties": { "checkpoint": { "$ref": "#/components/schemas/ResDef_Coordination_JobCheckpoint" }, "result_ref": { "type": "string" } }, "required": [ "result_ref", "checkpoint" ], "type": "object" } }, "required": [ "Publishing" ], "type": "object" }, { "additionalProperties": false, "properties": { "Succeeded": { "additionalProperties": false, "properties": { "checkpoint": { "$ref": "#/components/schemas/ResDef_Coordination_JobCheckpoint" }, "result_ref": { "type": "string" } }, "required": [ "result_ref", "checkpoint" ], "type": "object" } }, "required": [ "Succeeded" ], "type": "object" }, { "additionalProperties": false, "properties": { "Failed": { "additionalProperties": false, "properties": { "checkpoint": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_JobCheckpoint" }, { "type": "null" } ] }, "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" } }, "required": [ "Failed" ], "type": "object" }, { "additionalProperties": false, "properties": { "Cancelled": { "additionalProperties": false, "properties": { "checkpoint": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_JobCheckpoint" }, { "type": "null" } ] } }, "type": "object" } }, "required": [ "Cancelled" ], "type": "object" } ] }, "ResDef_Coordination_JobWorkerLease": { "additionalProperties": false, "description": "Fenced ownership of one job attempt by a worker slot.", "properties": { "acquired_at_ms": { "format": "int64", "type": "integer" }, "epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "expires_at_ms": { "format": "int64", "type": "integer" }, "worker_ref": { "type": "string" } }, "required": [ "worker_ref", "epoch", "acquired_at_ms", "expires_at_ms" ], "type": "object" }, "ResDef_Coordination_KgDelegateDecision": { "enum": [ "accepted", "replayed" ], "type": "string" }, "ResDef_Coordination_KgDelegateResult": { "additionalProperties": false, "description": "Result returned after the existing WorkItem admission transaction commits.\nThe outbox id is the native admission outbox identity; EG does not mint a\nparallel delegation ledger.", "properties": { "capability_digest": { "type": "string" }, "catalog_digest": { "type": "string" }, "command_digest": { "type": "string" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_KgDelegateDecision" }, "delegation_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "model_digest": { "default": null, "type": [ "string", "null" ] }, "outbox_id": { "type": "string" }, "policy_digest": { "type": "string" }, "run_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_KgDelegateSchemaVersion" }, "target": { "$ref": "#/components/schemas/ResDef_Coordination_DelegationTarget", "description": "Echoes the admitted target, so a caller reading a receipt knows exactly\nwhat ran without resolving anything." }, "trace_id": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "decision", "delegation_id", "run_id", "trace_id", "work_item_id", "outbox_id", "idempotency_key", "target", "command_digest", "capability_digest", "catalog_digest", "policy_digest" ], "type": "object" }, "ResDef_Coordination_KgDelegateSchemaVersion": { "oneOf": [ { "const": "2", "description": "Format identity, not a component name (RF-ADR-006). See\n[`KG_DELEGATE_VERSION`] for what changed.", "type": "string" } ] }, "ResDef_Coordination_LabelExclusions": { "additionalProperties": false, "description": "Why items were refused as labels, by reason.", "properties": { "below_fidelity_floor": { "format": "uint64", "minimum": 0, "type": "integer" }, "censored": { "format": "uint64", "minimum": 0, "type": "integer" }, "llm_resolved": { "format": "uint64", "minimum": 0, "type": "integer" }, "not_observation": { "format": "uint64", "minimum": 0, "type": "integer" }, "outside_window": { "format": "uint64", "minimum": 0, "type": "integer" }, "pinned": { "format": "uint64", "minimum": 0, "type": "integer" }, "propensity_not_executed_policy": { "format": "uint64", "minimum": 0, "type": "integer" }, "self_reported": { "format": "uint64", "minimum": 0, "type": "integer" }, "unapproved_principal": { "format": "uint64", "minimum": 0, "type": "integer" }, "wrong_regime": { "format": "uint64", "minimum": 0, "type": "integer" }, "zero_executed_propensity": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "outside_window", "wrong_regime", "llm_resolved", "self_reported", "not_observation", "censored", "below_fidelity_floor", "propensity_not_executed_policy", "pinned", "unapproved_principal", "zero_executed_propensity" ], "type": "object" }, "ResDef_Coordination_LeasePriority": { "description": "The same four priority tiers `resource_priority.py::PriorityClass` defines,\nvendored here (not imported \u2014 this crate has no Python interop and must not\ndepend on AU) so a `CapacityLease` carries the identical vocabulary the AU\nscheduler already enforces at the LLM gate. `#[derive(Ord)]` on a fieldless\nenum compares by DECLARATION ORDER, so listing `Interactive` first and\n`BackgroundIngestion` last gives `Interactive < Orchestration < Hydration <\nBackgroundIngestion`, matching `core/cognitive_scheduler.py::SchedulerPriority`'s\n\"lower value = higher priority\" convention. `Orchestration`/`Hydration` are\nNOT equal-priority under this `Ord` (AU's equal LLM-gate WEIGHT for the two\nis a separate lookup table, `_PRIORITY_WEIGHTS`, not an enum-ordinal fact \u2014\nsee `resource_priority.py`); only `may_spend_reserved_floor` below is a\nhard cell-admission rule.", "enum": [ "interactive", "orchestration", "hydration", "background_ingestion" ], "type": "string" }, "ResDef_Coordination_LeaseRenewalRefusal": { "description": "Why a `RenewWorkItemLease` renewed nothing.", "oneOf": [ { "const": "missing", "description": "No WorkItem has this id.", "type": "string" }, { "const": "fenced", "description": "The caller no longer holds the live lease it named.", "type": "string" } ] }, "ResDef_Coordination_LeaseState": { "description": "Lifecycle state of one `CapacityLease` (mirrors `work_item.py`'s closed\nstate vocabulary convention \u2014 a plain closed string-like enum, not an\nopen-ended status field).", "oneOf": [ { "enum": [ "active", "renewed", "released" ], "type": "string" }, { "const": "expired", "description": "Expiry reached with no renewal; capacity is reclaimable. A holder that\nkeeps working past this point is the classic fencing defect this module\nexists to prevent \u2014 `try_renew`/`try_release` reject a caller presenting\na lease in (or past) this state.", "type": "string" }, { "const": "reclaimed", "description": "An `ReclaimExpired` sweep already returned this lease's amount to the\ncell. Terminal, like `Released`.", "type": "string" } ] }, "ResDef_Coordination_NativeControlSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_OpeEstimateView": { "additionalProperties": false, "description": "One estimator's interval on the candidate head's value.", "properties": { "effective_sample_size": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "estimator": { "$ref": "#/components/schemas/ResDef_Coordination_OpeEstimatorKind" }, "lower": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "unsupported_mass": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire", "description": "Share of logged probability mass the candidate policy does not cover." }, "upper": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "value": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" } }, "required": [ "estimator", "value", "lower", "upper", "effective_sample_size", "unsupported_mass" ], "type": "object" }, "ResDef_Coordination_OpeEstimatorKind": { "description": "Which off-policy estimator an evaluation runs.", "enum": [ "ips", "clipped_ips", "snips", "switch", "doubly_robust" ], "type": "string" }, "ResDef_Coordination_PooledRate": { "additionalProperties": false, "description": "One option's pooled success rate (Beta-Binomial, class -> option), reported\nonly when its own trials reach the policy's `min_support`.", "properties": { "class_key": { "type": "string" }, "option_id": { "type": "string" }, "posterior_mean": { "$ref": "#/components/schemas/ResDef_Coordination_QuantisedValue" }, "trials": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "class_key", "option_id", "trials", "posterior_mean" ], "type": "object" }, "ResDef_Coordination_QuantScaleTag": { "description": "The fixed-point scale a [`QuantisedValue`] is read on. Mirrors\n`eg_numeric`'s `QuantScale`.", "oneOf": [ { "const": "pico", "description": "`value / 10^12`.", "type": "string" }, { "const": "q32", "description": "`value / 2^32`.", "type": "string" } ] }, "ResDef_Coordination_QuantisedValue": { "additionalProperties": false, "description": "An exact fixed-point number: `value` read on `scale`.", "properties": { "scale": { "$ref": "#/components/schemas/ResDef_Coordination_QuantScaleTag" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "scale", "value" ], "type": "object" }, "ResDef_Coordination_ResourceCapacitySnapshot": { "additionalProperties": false, "properties": { "cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "process_slots": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cpu_weight", "memory_mib", "disk_mib", "process_slots", "host_revision" ], "type": "object" }, "ResDef_Coordination_ResourceHostUpdateCapacitySnapshot": { "additionalProperties": false, "properties": { "cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "process_slots": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cpu_weight", "memory_mib", "disk_mib", "process_slots" ], "type": "object" }, "ResDef_Coordination_ResourceHostUpdateDiskPolicySnapshot": { "additionalProperties": false, "properties": { "blocked": { "type": "boolean" }, "high_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "low_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "policy_key": { "type": "string" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "policy_key", "blocked", "revision" ], "type": "object" }, "ResDef_Coordination_ResourceHostUpdateResult": { "additionalProperties": false, "properties": { "accepted": { "type": "boolean" }, "draining": { "type": "boolean" }, "held_cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_process_slots": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "host_snapshot": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_ResourceHostUpdateSnapshot" }, { "type": "null" } ] }, "quarantined": { "type": "boolean" }, "reason": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceHostUpdateResultReason" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceHostUpdateResultSchemaVersion" } }, "required": [ "schema_version", "accepted", "reason", "host_ref", "revision", "held_cpu_weight", "held_memory_mib", "held_disk_mib", "held_process_slots", "draining", "quarantined" ], "type": "object" }, "ResDef_Coordination_ResourceHostUpdateResultReason": { "enum": [ "accepted", "stale_host", "conflict", "not_found" ], "type": "string" }, "ResDef_Coordination_ResourceHostUpdateResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_ResourceHostUpdateSnapshot": { "additionalProperties": false, "properties": { "capacity": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceHostUpdateCapacitySnapshot" }, "disk_capacity_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_policies": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceHostUpdateDiskPolicySnapshot" }, "type": "array" }, "disk_used_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "draining": { "type": "boolean" }, "heartbeat_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "heartbeat_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_process_slots": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "labels": { "items": { "type": "string" }, "type": "array" }, "observed": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceHostUpdateCapacitySnapshot" }, "quarantined": { "type": "boolean" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "target_alias": { "type": [ "string", "null" ] }, "target_kind": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceHostUpdateSnapshotTargetKind" } }, "required": [ "host_ref", "revision", "capacity", "observed", "heartbeat_at_ms", "heartbeat_ttl_ms", "draining", "quarantined", "labels", "target_kind", "disk_used_mib", "disk_capacity_mib", "held_cpu_weight", "held_memory_mib", "held_disk_mib", "held_process_slots", "disk_policies" ], "type": "object" }, "ResDef_Coordination_ResourceHostUpdateSnapshotTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ResDef_Coordination_ResourceRequirement": { "additionalProperties": false, "properties": { "cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "process_slots": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cpu_weight", "memory_mib", "disk_mib", "process_slots" ], "type": "object" }, "ResDef_Coordination_ResourceReservationDiskPolicySnapshot": { "additionalProperties": false, "properties": { "blocked": { "type": "boolean" }, "high_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "low_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "policy_key": { "type": "string" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "policy_key", "blocked", "revision" ], "type": "object" }, "ResDef_Coordination_ResourceReservationHostCapacitySnapshot": { "additionalProperties": false, "properties": { "cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "process_slots": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cpu_weight", "memory_mib", "disk_mib", "process_slots" ], "type": "object" }, "ResDef_Coordination_ResourceReservationHostSnapshot": { "additionalProperties": false, "properties": { "capacity": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationHostCapacitySnapshot" }, "disk_capacity_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_policies": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationDiskPolicySnapshot" }, "type": "array" }, "disk_used_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "draining": { "type": "boolean" }, "heartbeat_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "heartbeat_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_process_slots": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "labels": { "items": { "type": "string" }, "type": "array" }, "observed": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationHostCapacitySnapshot" }, "quarantined": { "type": "boolean" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "target_alias": { "type": [ "string", "null" ] }, "target_kind": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationHostSnapshotTargetKind" } }, "required": [ "host_ref", "revision", "capacity", "observed", "heartbeat_at_ms", "heartbeat_ttl_ms", "draining", "quarantined", "labels", "target_kind", "disk_used_mib", "disk_capacity_mib", "held_cpu_weight", "held_memory_mib", "held_disk_mib", "held_process_slots", "disk_policies" ], "type": "object" }, "ResDef_Coordination_ResourceReservationHostSnapshotTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ResDef_Coordination_ResourceReservationRecord": { "additionalProperties": false, "properties": { "anti_affinity": { "items": { "type": "string" }, "type": "array" }, "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "branch": { "type": "string" }, "branch_exclusive": { "type": "boolean" }, "capacity_snapshot": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceCapacitySnapshot" }, "concurrency_key": { "type": "string" }, "concurrency_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_high_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_low_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_policy_key": { "type": "string" }, "expected_host_revision": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "expected_lifecycle_revision": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "fairness_cost": { "format": "uint64", "minimum": 0, "type": "integer" }, "fairness_group": { "type": "string" }, "fence": { "type": "string" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "input_fingerprint": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "profile_name": { "type": "string" }, "profile_version": { "type": "string" }, "repository_exclusive": { "type": "boolean" }, "repository_id": { "type": "string" }, "required_labels": { "items": { "type": "string" }, "type": "array" }, "requirement": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceRequirement" }, "reservation_id": { "type": "string" }, "reserved_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "selected_target": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceTargetSnapshot" }, "state": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationRecordState" }, "target_alias": { "type": [ "string", "null" ] }, "target_kind": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationRecordTargetKind" }, "tenant_ref": { "type": "string" }, "tombstone": { "type": "boolean" }, "work_item_id": { "type": "string" } }, "required": [ "reservation_id", "tenant_ref", "owner_id", "work_item_id", "fence", "attempt", "lease_epoch", "fencing_token", "input_fingerprint", "host_ref", "profile_name", "profile_version", "requirement", "capacity_snapshot", "selected_target", "target_kind", "repository_id", "branch", "concurrency_key", "repository_exclusive", "branch_exclusive", "required_labels", "anti_affinity", "fairness_group", "fairness_cost", "disk_policy_key", "reserved_at_ms", "expires_at_ms", "state", "revision", "lifecycle_revision", "tombstone" ], "type": "object" }, "ResDef_Coordination_ResourceReservationRecordState": { "enum": [ "reserved", "released", "reclaimed", "expired", "superseded", "absent" ], "type": "string" }, "ResDef_Coordination_ResourceReservationRecordTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ResDef_Coordination_ResourceReservationResult": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationResultDecision" }, "fairness_debt": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_process_slots": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": [ "string", "null" ] }, "host_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "record": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationRecord" }, { "type": "null" } ] }, "reservation_id": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationResultSchemaVersion" }, "state": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationResultState" }, "tombstone": { "type": "boolean" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "decision", "work_item_id", "attempt", "lease_epoch", "fencing_token", "lifecycle_revision", "host_revision", "state", "held_cpu_weight", "held_memory_mib", "held_disk_mib", "held_process_slots", "fairness_debt", "tombstone", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_ResourceReservationResultDecision": { "enum": [ "accepted", "idempotent", "stale", "conflict", "input_conflict", "capacity", "policy", "drained", "quarantined", "stale_host", "labels", "anti_affinity", "disk", "concurrency", "exclusivity", "not_found" ], "type": "string" }, "ResDef_Coordination_ResourceReservationResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_ResourceReservationResultState": { "enum": [ "reserved", "released", "reclaimed", "expired", "superseded", "absent" ], "type": "string" }, "ResDef_Coordination_ResourceReservationStatusResult": { "additionalProperties": false, "properties": { "complete": { "type": "boolean" }, "fairness_debt": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_process_slots": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": [ "string", "null" ] }, "host_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_snapshot": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationHostSnapshot" }, { "type": "null" } ] }, "next_cursor": { "type": [ "string", "null" ] }, "orphan_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "reservations": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationSummary" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationStatusResultSchemaVersion" }, "superseded_count": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "complete", "host_revision", "held_cpu_weight", "held_memory_mib", "held_disk_mib", "held_process_slots", "fairness_debt", "reservations", "orphan_count", "superseded_count" ], "type": "object" }, "ResDef_Coordination_ResourceReservationStatusResultSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_ResourceReservationSummary": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "fairness_group": { "type": "string" }, "held_cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "held_process_slots": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "profile_name": { "type": "string" }, "reservation_id": { "type": "string" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "state": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationSummaryState" }, "tombstone": { "type": "boolean" }, "work_item_id": { "type": "string" } }, "required": [ "reservation_id", "work_item_id", "attempt", "host_ref", "profile_name", "fairness_group", "state", "revision", "expires_at_ms", "held_cpu_weight", "held_memory_mib", "held_disk_mib", "held_process_slots", "tombstone" ], "type": "object" }, "ResDef_Coordination_ResourceReservationSummaryState": { "enum": [ "reserved", "released", "reclaimed", "expired", "superseded", "absent" ], "type": "string" }, "ResDef_Coordination_ResourceSnapshot": { "description": "The full resource snapshot returned by `Method::ResourceStatsPage`\n(CONCEPT:EG-KG.compute.lane-v) and scraped into Prometheus: the signals an\nautoscaler (OS-5.27) needs in one round-trip.", "properties": { "budget_evictions_total": { "description": "Cumulative LRU nodes evicted by the budget enforcer (rate = delta/interval).", "format": "uint64", "minimum": 0, "type": "integer" }, "budget_hibernations_total": { "description": "Cumulative graphs hibernated by the budget enforcer.", "format": "uint64", "minimum": 0, "type": "integer" }, "coalescer_operations_total": { "description": "Cumulative structural operations applied by the coalescer, including\noperations that used the bounded inline fallback.", "format": "uint64", "minimum": 0, "type": "integer" }, "coalescer_queue_bytes": { "description": "Approximate bytes held by those queued writes.", "format": "uint64", "minimum": 0, "type": "integer" }, "coalescer_queue_depth": { "description": "Number of structural writes waiting in all per-graph coalescer queues.", "format": "uint64", "minimum": 0, "type": "integer" }, "cursor": { "description": "Exclusive keyset cursor accepted for this page, if any.", "type": [ "string", "null" ] }, "effective_cpu_cores": { "description": "Effective cgroup-aware CPU lanes after the shared headroom policy.", "format": "uint64", "minimum": 0, "type": "integer" }, "effective_memory_limit_bytes": { "description": "Effective cgroup-aware RAM after the shared headroom policy.", "format": "uint64", "minimum": 0, "type": "integer" }, "global_ceiling_bytes": { "description": "Configured global ceiling. The cgroup-aware automatic policy is always\npositive; an explicit override can lower it but cannot disable it.", "format": "uint64", "minimum": 0, "type": "integer" }, "graph_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "graphs": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_GraphResourceStats" }, "type": "array" }, "has_more": { "type": "boolean" }, "hibernated_graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "in_flight": { "description": "Requests currently holding an admission permit (in-flight depth).", "format": "uint64", "minimum": 0, "type": "integer" }, "inflight_permits_available": { "description": "Admission permits still available (`max_inflight - in_flight`); a small value\nmeans the queue is saturated (shedding BUSY).", "format": "uint64", "minimum": 0, "type": "integer" }, "limit": { "description": "Finite page size applied to the detail arrays (or the explicit request\nlimit in summary mode).", "format": "uint64", "minimum": 0, "type": "integer" }, "next_cursor": { "description": "Exclusive cursor for the next visible page. `None` means this page was\nthe final page after ACL/tenant filtering.", "type": [ "string", "null" ] }, "process_rss_bytes": { "description": "Current process RSS (falling back to peak RSS), bytes -- the OS-observed\nfootprint used for calibration and hard-ceiling pressure.", "format": "uint64", "minimum": 0, "type": "integer" }, "resident_graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "summary": { "description": "`true` when this response intentionally omits detail arrays.", "type": "boolean" }, "tenant_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_count_truncated": { "description": "True when the bounded tenant rollup reached its cap. In that case\n`tenant_count` is a lower bound and the returned tenant array is partial.", "type": "boolean" }, "tenants": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_TenantResourceStats" }, "type": "array" }, "total_edges": { "format": "uint64", "minimum": 0, "type": "integer" }, "total_memory_bytes": { "description": "Total resident RAM across all graphs (sum of `memory_bytes`).", "format": "uint64", "minimum": 0, "type": "integer" }, "total_nodes": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "limit", "has_more", "summary", "total_memory_bytes", "process_rss_bytes", "global_ceiling_bytes", "total_nodes", "total_edges", "graph_count", "tenant_count", "resident_graphs", "hibernated_graphs", "effective_cpu_cores", "effective_memory_limit_bytes", "tenant_count_truncated", "in_flight", "inflight_permits_available", "budget_evictions_total", "budget_hibernations_total", "coalescer_queue_depth", "coalescer_queue_bytes", "coalescer_operations_total", "tenants", "graphs" ], "type": "object" }, "ResDef_Coordination_ResourceTargetSnapshot": { "additionalProperties": false, "properties": { "alias": { "type": [ "string", "null" ] }, "capability_labels": { "items": { "type": "string" }, "type": "array" }, "kind": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceTargetSnapshotKind" } }, "required": [ "kind", "capability_labels" ], "type": "object" }, "ResDef_Coordination_ResourceTargetSnapshotKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ResDef_Coordination_RiskMethod": { "description": "Which controlled procedure produced the risk statement.", "enum": [ "learn_then_test", "conformal_risk_control" ], "type": "string" }, "ResDef_Coordination_RiskStatement": { "additionalProperties": false, "description": "The risk guarantee an acted-on decision carries.", "properties": { "delta": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire", "description": "Failure probability of that control." }, "epsilon": { "$ref": "#/components/schemas/ResDef_Coordination_UnitRationalWire", "description": "Risk level the procedure controls." }, "method": { "$ref": "#/components/schemas/ResDef_Coordination_RiskMethod" }, "n_calibration": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "method", "epsilon", "delta", "n_calibration" ], "type": "object" }, "ResDef_Coordination_StatechartAction": { "description": "One action a step performed or asks the interpreter to perform.", "oneOf": [ { "additionalProperties": false, "properties": { "do": { "const": "assign", "type": "string" }, "key": { "type": "string" }, "value": { "$ref": "#/components/schemas/ResDef_Coordination_StatechartActionValue" } }, "required": [ "do", "key", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "do": { "const": "remove", "type": "string" }, "key": { "type": "string" } }, "required": [ "do", "key" ], "type": "object" }, { "additionalProperties": false, "properties": { "do": { "const": "emit", "type": "string" }, "signal": { "type": "string" } }, "required": [ "do", "signal" ], "type": "object" }, { "additionalProperties": false, "properties": { "do": { "const": "log", "type": "string" }, "message": { "type": "string" } }, "required": [ "do", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "args": true, "do": { "const": "custom", "type": "string" }, "name": { "type": "string" } }, "required": [ "do", "name", "args" ], "type": "object" } ] }, "ResDef_Coordination_StatechartActionValue": { "description": "Where an `assign` action takes its value from.", "oneOf": [ { "additionalProperties": false, "properties": { "from": { "const": "const", "type": "string" }, "value": true }, "required": [ "from", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "from": { "const": "event", "type": "string" }, "key": { "type": "string" } }, "required": [ "from", "key" ], "type": "object" }, { "additionalProperties": false, "properties": { "from": { "const": "context", "type": "string" }, "key": { "type": "string" } }, "required": [ "from", "key" ], "type": "object" } ] }, "ResDef_Coordination_StatechartConfiguration": { "additionalProperties": false, "description": "The active states of an instance, plus composite-state history memory.", "properties": { "active": { "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "history": { "additionalProperties": { "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "type": "object" } }, "required": [ "active", "history" ], "type": "object" }, "ResDef_Coordination_StatechartDefinitionId": { "additionalProperties": false, "description": "`Statechart` op `Define`: the content-addressed definition id.", "properties": { "def_id": { "type": "string" } }, "required": [ "def_id" ], "type": "object" }, "ResDef_Coordination_StatechartEventOutcome": { "additionalProperties": false, "description": "`Statechart` op `SendEvent`: the instance after the event and the step it took.", "properties": { "actions": { "description": "Every action of the step, context mutations included.", "items": { "$ref": "#/components/schemas/ResDef_Coordination_StatechartAction" }, "type": "array" }, "effects": { "description": "The actions the interpreter still has to perform.", "items": { "$ref": "#/components/schemas/ResDef_Coordination_StatechartAction" }, "type": "array" }, "fired": { "type": "boolean" }, "fired_label": { "type": [ "string", "null" ] }, "instance": { "$ref": "#/components/schemas/ResDef_Coordination_StatechartInstance" }, "no_op_reason": { "description": "`NoTransitionDefined` or `AllGuardsFalse` on a no-op.", "type": [ "string", "null" ] } }, "required": [ "instance", "fired", "actions", "effects" ], "type": "object" }, "ResDef_Coordination_StatechartInstance": { "additionalProperties": false, "description": "A durable statechart instance. `context` is the extended state the caller's\ndefinition and events wrote.", "properties": { "actor": { "type": "string" }, "configuration": { "$ref": "#/components/schemas/ResDef_Coordination_StatechartConfiguration" }, "context": { "additionalProperties": true, "type": "object" }, "created_at_ms": { "format": "int64", "type": "integer" }, "def_id": { "type": "string" }, "events_seen": { "format": "uint64", "minimum": 0, "type": "integer" }, "instance_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/ResDef_Coordination_StatechartInstanceStatus" }, "tenant": { "type": "string" }, "transitions_fired": { "format": "uint64", "minimum": 0, "type": "integer" }, "updated_at_ms": { "format": "int64", "type": "integer" }, "version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "instance_id", "def_id", "configuration", "context", "version", "status", "tenant", "actor", "events_seen", "transitions_fired", "created_at_ms", "updated_at_ms" ], "type": "object" }, "ResDef_Coordination_StatechartInstanceList": { "additionalProperties": false, "description": "`Statechart` op `List`: the caller's instances.", "properties": { "count": { "format": "uint64", "minimum": 0, "type": "integer" }, "instance_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "instance_ids", "count" ], "type": "object" }, "ResDef_Coordination_StatechartInstanceStatus": { "description": "Whether an instance has reached a final state.", "enum": [ "active", "final" ], "type": "string" }, "ResDef_Coordination_SubmitWorkItemResult": { "additionalProperties": false, "properties": { "admitted_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "command_digest": { "type": "string" }, "command_sequence": { "format": "uint64", "minimum": 0, "type": "integer" }, "created": { "type": "boolean" }, "dependency_count": { "format": "uint32", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "max_tenant_in_flight": { "format": "uint64", "minimum": 0, "type": "integer" }, "outbox_id": { "type": "string" }, "provenance_refs": { "items": { "type": "string" }, "type": "array" }, "replayed": { "type": "boolean" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_NativeControlSchemaVersion" }, "status": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "work_item_id", "status", "created", "replayed", "command_sequence", "idempotency_key", "dependency_count", "admitted_count", "max_tenant_in_flight", "outbox_id", "command_digest", "provenance_refs", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_SubmitWorkItemsResult": { "additionalProperties": false, "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "outbox_id": { "type": "string" }, "replayed": { "type": "boolean" }, "results": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_SubmitWorkItemResult" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_NativeControlSchemaVersion" } }, "required": [ "schema_version", "results", "replayed", "outbox_id", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_TenantResourceStats": { "description": "Per-tenant rollup (CONCEPT:EG-KG.compute.lane-v).", "properties": { "budget_bytes": { "description": "The tenant's configured byte budget (before the fair-share cap).", "format": "uint64", "minimum": 0, "type": "integer" }, "edges": { "format": "uint64", "minimum": 0, "type": "integer" }, "graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "hibernated_graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "nodes": { "format": "uint64", "minimum": 0, "type": "integer" }, "over_budget": { "description": "`true` when `memory_bytes > budget_bytes` (the enforcer is reclaiming).", "type": "boolean" }, "resident_graphs": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant": { "type": "string" } }, "required": [ "tenant", "graphs", "resident_graphs", "hibernated_graphs", "nodes", "edges", "memory_bytes", "budget_bytes", "over_budget" ], "type": "object" }, "ResDef_Coordination_UnitRationalWire": { "additionalProperties": false, "description": "An exact rational in `[0, 1]`: `numerator / denominator`.\n\nValidated on the way in rather than at each use site, because it appears in\nsix different records and a per-site check is a check that one of them\neventually forgets.", "properties": { "denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "numerator": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "numerator", "denominator" ], "type": "object" }, "ResDef_Coordination_WorkItemCancelStatus": { "description": "The status a `CancelWorkItem` answers with.", "oneOf": [ { "enum": [ "cancelled" ], "type": "string" }, { "const": "missing", "description": "No WorkItem with this id is visible to the tenant.", "type": "string" }, { "const": "noop", "description": "The WorkItem was already terminal; nothing changed.", "type": "string" }, { "const": "in_flight", "description": "The WorkItem is running under a live lease and cannot be cancelled now.", "type": "string" }, { "const": "not_cancellable", "description": "The WorkItem is in a state cancellation does not apply to.", "type": "string" } ] }, "ResDef_Coordination_WorkItemClaimCapabilityDecision": { "description": "Privacy-safe decision vocabulary. No authority tuple, owner, lease, or\ncapability metadata is projected in the result.", "enum": [ "minted", "replayed", "verified", "input_conflict", "not_found", "unauthorized", "expired", "stale", "malformed", "retention_exhausted" ], "type": "string" }, "ResDef_Coordination_WorkItemClaimCapabilityResult": { "additionalProperties": false, "description": "Capability operation result. Only mint/replay returns the opaque bytes;\nverification returns a boolean and a privacy-safe decision.", "properties": { "capability": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": [ "array", "null" ] }, "decision": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemClaimCapabilityDecision" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemClaimCapabilityResultSchemaVersion" }, "valid": { "type": "boolean" } }, "required": [ "schema_version", "decision", "valid" ], "type": "object" }, "ResDef_Coordination_WorkItemClaimCapabilityResultSchemaVersion": { "description": "Stable result schema for the narrow native claim-capability checkpoint.", "enum": [ "1" ], "type": "string" }, "ResDef_Coordination_WorkItemCommitStatus": { "description": "The status a `CommitWorkItemResult` answers with.", "oneOf": [ { "enum": [ "succeeded", "failed", "cancelled" ], "type": "string" }, { "const": "missing", "description": "No WorkItem with this id is visible to the tenant.", "type": "string" }, { "const": "noop", "description": "The WorkItem was already terminal; nothing changed.", "type": "string" }, { "const": "fenced", "description": "The caller no longer holds the live lease it named.", "type": "string" }, { "const": "dead_letter", "description": "A retryable failure that exhausted its attempts.", "type": "string" }, { "const": "retry_scheduled", "description": "A retryable failure below its attempt ceiling, rescheduled with backoff.", "type": "string" } ] }, "ResDef_Coordination_WorkItemDeferStatus": { "description": "The status a `DeferWorkItem` answers with.", "oneOf": [ { "const": "missing", "description": "No WorkItem with this id exists.", "type": "string" }, { "const": "fenced", "description": "The caller no longer holds the live lease it named.", "type": "string" }, { "const": "deferred", "description": "The lease was released and the WorkItem returned to `ready` for a later retry.", "type": "string" } ] }, "ResDef_Coordination_WorkItemDeferral": { "description": "`DeferWorkItem`. A deferral carries the bumped fence and the retry schedule.", "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "defer_count": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "fencing_token": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "next_retry_at_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "status": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemDeferStatus" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "status", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_WorkItemLeaseRenewal": { "description": "`RenewWorkItemLease`. A renewal carries the renewed lease; a refusal carries only\nits reason. Every outcome names the WorkItem rows it changed, so the serving\nprojection can be refreshed from authority.", "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "lease_expires_at_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "reason": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_LeaseRenewalRefusal" }, { "type": "null" } ] }, "renewed": { "type": "boolean" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "renewed", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_WorkItemOutcomeView": { "additionalProperties": false, "description": "`GetWorkItemOutcome`: a terminal WorkItem and the provenance its commit\nbound (graph-os EG-3). `outcome` is the OutcomeEvaluation receipt's stored\nproperties, verified against the digest the commit recorded -- `None` when\nthe bundle committed without one (a `degraded` outcome).", "properties": { "outcome": { "additionalProperties": true, "type": [ "object", "null" ] }, "outcome_ref": { "type": "string" }, "tool_call_refs": { "items": { "type": "string" }, "type": "array" }, "trace_ref": { "type": "string" }, "work_item": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemView" } }, "required": [ "work_item", "trace_ref", "tool_call_refs", "outcome_ref" ], "type": "object" }, "ResDef_Coordination_WorkItemPage": { "additionalProperties": false, "description": "One page of `ListWorkItems`.", "properties": { "items": { "items": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemView" }, "type": "array" }, "next_cursor": { "description": "`Some` when more of the graph remains to be scanned; hand it back\nunmodified to continue. A page may be empty and still carry one.", "type": [ "string", "null" ] } }, "required": [ "items" ], "type": "object" }, "ResDef_Coordination_WorkItemStatus": { "description": "Where a WorkItem is in its lifecycle.", "oneOf": [ { "enum": [ "succeeded", "failed", "cancelled" ], "type": "string" }, { "const": "submitted", "description": "Admitted, waiting on dependencies.", "type": "string" }, { "const": "ready", "description": "Claimable.", "type": "string" }, { "const": "leased", "description": "Claimed under a live lease, not yet started.", "type": "string" }, { "const": "running", "description": "Executing under a live lease.", "type": "string" }, { "const": "dead_letter", "description": "A retryable failure that exhausted its attempts.", "type": "string" } ] }, "ResDef_Coordination_WorkItemTransition": { "description": "A terminal-direction WorkItem transition (`CommitWorkItemResult`,\n`CancelWorkItem`). The WorkItem id and fence are present once the item was found;\nthe fence is present only when the transition applied.", "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "status": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemCommitStatus" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "status", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_WorkItemTransition2": { "description": "A terminal-direction WorkItem transition (`CommitWorkItemResult`,\n`CancelWorkItem`). The WorkItem id and fence are present once the item was found;\nthe fence is present only when the transition applied.", "properties": { "changed_work_item_ids": { "items": { "type": "string" }, "type": "array" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "status": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemCancelStatus" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "status", "changed_work_item_ids" ], "type": "object" }, "ResDef_Coordination_WorkItemView": { "additionalProperties": false, "description": "The caller's view of one WorkItem row.", "properties": { "input_ref": { "description": "The `input_ref` the item was submitted with.", "type": "string" }, "kind": { "type": "string" }, "metadata": { "additionalProperties": true, "description": "The caller-owned scheduling metadata, as last written.", "type": "object" }, "status": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemStatus" }, "updated_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "version": { "description": "Row revision: 1 at submission, bumped by every native write of the row.\nA reader compares two views of the same item by it.", "format": "uint64", "minimum": 0, "type": "integer" }, "work_item_id": { "type": "string" } }, "required": [ "work_item_id", "kind", "status", "input_ref", "metadata", "version", "updated_at_ms" ], "type": "object" }, "ResDef_Coordination_WorkerJobClaim": { "description": "`AnalyticsJob` op `WorkerClaim`: the claimed job and the lease fencing it.", "properties": { "job": { "$ref": "#/components/schemas/ResDef_Coordination_ClaimedAnalyticsJob" }, "lease": { "$ref": "#/components/schemas/ResDef_Coordination_JobWorkerLease" } }, "required": [ "job", "lease" ], "type": "object" }, "ResDef_Graph_CompactNodesResult": { "description": "Result of `Method::CompactNodesByType`: the ids of the nodes compaction removed.", "properties": { "removed_nodes": { "items": { "type": "string" }, "type": "array" } }, "required": [ "removed_nodes" ], "type": "object" }, "ResDef_Graph_DecayStats": { "description": "Result of an Ebbinghaus forgetting-curve decay sweep (CONCEPT:EG-KG.compute.typed-graph-model).\n\n`*_decayed` count items whose belief `confidence` was reduced this sweep;\n`*_pruned` count items removed because their decayed confidence fell below\nthe sweep `floor`.", "properties": { "edges_decayed": { "format": "uint", "minimum": 0, "type": "integer" }, "edges_pruned": { "format": "uint", "minimum": 0, "type": "integer" }, "nodes_decayed": { "format": "uint", "minimum": 0, "type": "integer" }, "nodes_pruned": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "nodes_decayed", "edges_decayed", "nodes_pruned", "edges_pruned" ], "type": "object" }, "ResDef_Graph_GraphDiff": { "description": "What another graph has relative to this one (`Method::DiffAgainst`): nodes and\n`(source, target)` edge keys added or removed, and nodes whose property bytes differ.", "properties": { "edges_added": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "edges_removed": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "nodes_added": { "items": { "type": "string" }, "type": "array" }, "nodes_modified": { "items": { "type": "string" }, "type": "array" }, "nodes_removed": { "items": { "type": "string" }, "type": "array" } }, "required": [ "nodes_added", "nodes_removed", "nodes_modified", "edges_added", "edges_removed" ], "type": "object" }, "ResDef_Graph_GraphMetrics": { "description": "Runtime metrics for monitoring and observability.", "properties": { "active_nodes": { "format": "uint", "minimum": 0, "type": "integer" }, "archived_nodes": { "format": "uint", "minimum": 0, "type": "integer" }, "compacted_nodes": { "format": "uint", "minimum": 0, "type": "integer" }, "edge_count": { "format": "uint", "minimum": 0, "type": "integer" }, "last_prune_removed": { "format": "uint", "minimum": 0, "type": "integer" }, "node_count": { "format": "uint", "minimum": 0, "type": "integer" }, "total_mutations": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_count", "edge_count", "total_mutations", "last_prune_removed", "active_nodes", "compacted_nodes", "archived_nodes" ], "type": "object" }, "ResDef_Graph_LoadReport": { "description": "Summary of an RDF triple load (`eg_rdf::mapping::load_triples`).", "properties": { "multivalue": { "description": "Multi-valued literal extras encountered (second+ literal per `(s,p)`).", "format": "uint", "minimum": 0, "type": "integer" }, "triples": { "description": "Total triples consumed.", "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "triples", "multivalue" ], "type": "object" }, "ResDef_Graph_PropertyBlob": { "description": "A node or edge property object exactly as stored -- MessagePack bytes, carried as a\nMessagePack `bin` on the wire.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "ResDef_Graph_PruneStats": { "description": "Result of a lifecycle-aware pruning operation.", "properties": { "edges_removed": { "format": "uint", "minimum": 0, "type": "integer" }, "nodes_archived": { "format": "uint", "minimum": 0, "type": "integer" }, "nodes_removed": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "nodes_removed", "edges_removed", "nodes_archived" ], "type": "object" }, "ResDef_Graph_ScenePose": { "description": "A scene object's composed world transform (`Method::WorldTransform`) -- the wire\nprojection of `eg_core::scene::Pose`, the same `{translation, rotation, scale}` object a\nscene node stores under its `pose` property.", "properties": { "rotation": { "$ref": "#/components/schemas/ResDef_Graph_SceneQuat" }, "scale": { "$ref": "#/components/schemas/ResDef_Graph_SceneVec3" }, "translation": { "$ref": "#/components/schemas/ResDef_Graph_SceneVec3" } }, "required": [ "translation", "rotation", "scale" ], "type": "object" }, "ResDef_Graph_SceneQuat": { "description": "A rotation quaternion `(x, y, z, w)` of a scene-graph pose on the wire.", "properties": { "w": { "format": "double", "type": "number" }, "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" }, "z": { "format": "double", "type": "number" } }, "required": [ "x", "y", "z", "w" ], "type": "object" }, "ResDef_Graph_SceneVec3": { "description": "A 3-vector of a scene-graph pose on the wire.", "properties": { "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" }, "z": { "format": "double", "type": "number" } }, "required": [ "x", "y", "z" ], "type": "object" }, "ResDef_Graph_SparqlUpdateReport": { "description": "What one SPARQL UPDATE changed, whichever path executed it.\n\n`ApplyMutation` has two executors: the per-graph gateway (one graph, the update\nruns against its staged image) and the coordinated SPARQL-HTTP saga (the\n`sparql_http_update_v1` event, which may create and rewrite several graphs). Both\nanswer with this one body; a per-graph update reports `updated_graphs: 1` and\n`created_graphs: 0`.", "properties": { "created_graphs": { "description": "Graphs this update created.", "format": "uint64", "minimum": 0, "type": "integer" }, "deleted": { "description": "Triples deleted.", "format": "uint64", "minimum": 0, "type": "integer" }, "inserted": { "description": "Triples inserted.", "format": "uint64", "minimum": 0, "type": "integer" }, "operations": { "description": "Update operations applied (one per `;`-separated clause).", "format": "uint64", "minimum": 0, "type": "integer" }, "updated_graphs": { "description": "Graphs whose committed image this update replaced.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "operations", "inserted", "deleted", "updated_graphs", "created_graphs" ], "type": "object" }, "ResDef_Graph_SubgraphEdge": { "description": "One edge of a `Method::GetSubgraph` result -- one entry per parallel edge.", "properties": { "properties": { "description": "The edge's property object, or `null` when it does not decode." }, "source": { "type": "string" }, "target": { "type": "string" } }, "required": [ "source", "target", "properties" ], "type": "object" }, "ResDef_Graph_SubgraphNode": { "description": "One node of a `Method::GetSubgraph` result, with its decoded property object.", "properties": { "id": { "type": "string" }, "properties": { "description": "The node's property object, or `null` when it does not decode." } }, "required": [ "id", "properties" ], "type": "object" }, "ResDef_Graph_SubgraphResult": { "description": "The induced subgraph over a node-id set (`Method::GetSubgraph`): the nodes that exist\nand every edge among them.", "properties": { "edges": { "items": { "$ref": "#/components/schemas/ResDef_Graph_SubgraphEdge" }, "type": "array" }, "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Graph_SubgraphNode" }, "type": "array" } }, "required": [ "nodes", "edges" ], "type": "object" }, "ResDef_Ingestion_AgentLibraryCompositeRef": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "model_profile_digest": { "type": "string" }, "ontology_set_digest": { "type": "string" }, "role_digest": { "type": "string" }, "skill_set_digest": { "type": "string" }, "system_prompt_digest": { "type": "string" }, "tool_set_digest": { "type": "string" } }, "required": [ "agent_id", "role_digest", "system_prompt_digest", "tool_set_digest", "skill_set_digest", "model_profile_digest", "ontology_set_digest" ], "type": "object" }, "ResDef_Ingestion_AsrTranscriptSegment": { "description": "One validated transcript segment.", "properties": { "avg_logprob": { "description": "Present only for a calibrated provider quality estimate.", "format": "float", "type": [ "number", "null" ] }, "end": { "format": "double", "type": "number" }, "no_speech_prob": { "format": "float", "type": [ "number", "null" ] }, "start": { "description": "Seconds from the start of the audio.", "format": "double", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "ResDef_Ingestion_AsrTranscription": { "description": "Result of `AsrOp::TranscribeFile`: the whole transcript plus its validated\nsegments.", "properties": { "language": { "description": "The language the provider transcribed in.", "type": "string" }, "segments": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_AsrTranscriptSegment" }, "type": "array" }, "text": { "description": "Every segment's text, space-joined and trimmed.", "type": "string" }, "timing_available": { "description": "False when the provider reported no segment timing (`start`/`end` are then 0).", "type": "boolean" } }, "required": [ "text", "language", "segments", "timing_available" ], "type": "object" }, "ResDef_Ingestion_BoundedVec_IndexDiagnostic_8": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_IndexDiagnostic" }, "maxItems": 8, "type": "array" }, "ResDef_Ingestion_BoundedVec_RawAdmissionReceipt_1024": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_RawAdmissionReceipt" }, "maxItems": 1024, "type": "array" }, "ResDef_Ingestion_BoundedVec_RawRelationshipAdmissionReceipt_4096": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_RawRelationshipAdmissionReceipt" }, "maxItems": 4096, "type": "array" }, "ResDef_Ingestion_BoundedVec_SourceMappingReceipt_5120": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceMappingReceipt" }, "maxItems": 5120, "type": "array" }, "ResDef_Ingestion_BoundedVec_SourceRelationshipTombstoneReceipt_4096": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceRelationshipTombstoneReceipt" }, "maxItems": 4096, "type": "array" }, "ResDef_Ingestion_BoundedVec_SourceTombstoneReceipt_16384": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceTombstoneReceipt" }, "maxItems": 16384, "type": "array" }, "ResDef_Ingestion_CanonicalTextAssetRef": { "additionalProperties": false, "properties": { "asset_id": { "type": "string" }, "asset_revision": { "type": "string" }, "content_digest": { "type": "string" } }, "required": [ "asset_id", "asset_revision", "content_digest" ], "type": "object" }, "ResDef_Ingestion_CommittedVersion": { "description": "Exact authoritative version transition committed with a durable record.", "oneOf": [ { "enum": [ "none" ], "type": "string" }, { "additionalProperties": false, "properties": { "graph": { "properties": { "source": { "format": "uint64", "minimum": 0, "type": "integer" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source", "target" ], "type": "object" } }, "required": [ "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "native": { "properties": { "source": { "format": "uint64", "minimum": 0, "type": "integer" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source", "target" ], "type": "object" } }, "required": [ "native" ], "type": "object" } ] }, "ResDef_Ingestion_Digest256": { "description": "32 bytes of SHA-256 as lowercase hexadecimal", "maxLength": 64, "minLength": 64, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "ResDef_Ingestion_DiscoverHit": { "description": "One ranked node of `Method::Discover`, hydrated with its human-readable text.", "properties": { "description": { "type": "string" }, "id": { "type": "string" }, "name": { "description": "The node's `name`, or its id when it has none.", "type": "string" }, "score": { "description": "Combined keyword + semantic score.", "format": "float", "type": "number" }, "type": { "type": "string" } }, "required": [ "id", "name", "description", "type", "score" ], "type": "object" }, "ResDef_Ingestion_DurabilityDomain": { "description": "Authoritative durability domain for an operation.", "enum": [ "graph_rows", "graph_snapshot", "rdf_dataset", "sql_catalog", "blob_store", "kv_store", "time_series", "analytics_job", "semantic_index", "broker", "cross_modal", "multi_graph", "lifecycle", "control_plane" ], "type": "string" }, "ResDef_Ingestion_ExtractedEdge": { "description": "An extracted graph edge.", "properties": { "edge_type": { "type": "string" }, "properties": { "additionalProperties": { "type": "string" }, "type": "object" }, "source": { "type": "string" }, "target": { "type": "string" } }, "required": [ "source", "target", "edge_type", "properties" ], "type": "object" }, "ResDef_Ingestion_ExtractedNode": { "description": "An extracted graph node: the shape the AST and screen enrichments share, so the\ncaller's persist path is one.", "properties": { "node_id": { "type": "string" }, "node_type": { "type": "string" }, "properties": { "additionalProperties": { "type": "string" }, "type": "object" } }, "required": [ "node_id", "node_type", "properties" ], "type": "object" }, "ResDef_Ingestion_GraphTextPropertyRef": { "additionalProperties": false, "properties": { "graph_id": { "type": "string" }, "property_id": { "type": "string" }, "type_id": { "type": "string" } }, "required": [ "graph_id", "type_id", "property_id" ], "type": "object" }, "ResDef_Ingestion_IncarnationId": { "description": "Opaque logical-generation identity. It is never derived from a resource name.", "type": "string" }, "ResDef_Ingestion_IndexDiagnostic": { "description": "One bounded, machine-readable diagnostic for a repository-index input.", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "ResDef_Ingestion_IndexFileOutcome": { "description": "The exact outcome of one input file in an `IndexRepository` batch.\n\nOutcomes are returned one-for-one and in the same order as the submitted\nfiles. Both digests use the canonical `sha256:` spelling.", "properties": { "content_digest": { "type": "string" }, "diagnostics": { "$ref": "#/components/schemas/ResDef_Ingestion_BoundedVec_IndexDiagnostic_8", "description": "Bounded by the engine. The current parser emits at most one diagnostic\nfor an input, while the vector leaves room for richer parsers without a\nwire-shape change." }, "file_path": { "type": "string" }, "parser_capability_digest": { "type": "string" }, "status": { "$ref": "#/components/schemas/ResDef_Ingestion_IndexFileStatus" } }, "required": [ "file_path", "status", "content_digest", "parser_capability_digest", "diagnostics" ], "type": "object" }, "ResDef_Ingestion_IndexFileStatus": { "description": "Per-file disposition produced by [`IndexResult`]. It is deliberately\nseparate from `ParseResult`: an unsupported parser capability and a source\nfile containing no declarations are not the same outcome.", "enum": [ "success", "unsupported", "error" ], "type": "string" }, "ResDef_Ingestion_IndexResult": { "description": "Resolved, cross-file symbol graph for a batch of files \u2014 the response shape\nof the `IndexRepository` RPC. Unlike `ParseFiles` (one raw `ParseResult` per\nfile), this is a SINGLE merged graph whose `calls`/`inherits`/`realizes`/\n`depends_on` edges point at real node ids.", "properties": { "calls_resolved": { "description": "Call sites bound to a definition (numerator of call-resolution coverage).", "format": "uint", "minimum": 0, "type": "integer" }, "calls_scope_resolved": { "description": "Of `calls_resolved`, those bound by receiver/class scope (CONCEPT:EG-KG.compute.type-scope-resolved-call).", "format": "uint", "minimum": 0, "type": "integer" }, "calls_type_resolved": { "description": "Of `calls_resolved`, those disambiguated by argument-count match.", "format": "uint", "minimum": 0, "type": "integer" }, "calls_unresolved": { "description": "Call sites seen but not bound (external/stdlib/ambiguous) \u2014 the remainder.", "format": "uint", "minimum": 0, "type": "integer" }, "edges": { "description": "`IMPLEMENTS` (file\u2192symbol) + resolved `calls` (symbol\u2192symbol) + `inherits`/\n`realizes` (class\u2192class) + resolved `depends_on` (file\u2192file). Raw unresolved\n`calls_raw`/`depends_on_raw` edges are dropped \u2014 they're superseded here.", "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ExtractedEdge" }, "type": "array" }, "file_outcomes": { "description": "Exactly one outcome per submitted file, in input order. An unsupported\nextension is explicit and never represented as an empty success.", "items": { "$ref": "#/components/schemas/ResDef_Ingestion_IndexFileOutcome" }, "type": "array" }, "files_parsed": { "description": "Successfully parsed inputs. This is not the submitted batch size: see\n`file_outcomes` for unsupported and failed inputs.", "format": "uint", "minimum": 0, "type": "integer" }, "imports_resolved": { "description": "Import statements bound to an in-batch file.", "format": "uint", "minimum": 0, "type": "integer" }, "imports_unresolved": { "description": "Import statements seen but not bound (external packages, unknown layout).", "format": "uint", "minimum": 0, "type": "integer" }, "inherits_edges": { "description": "Class\u2192base `inherits` edges emitted.", "format": "uint", "minimum": 0, "type": "integer" }, "nodes": { "description": "Every SYMBOL node across all files \u2014 ONE row per declaration site, never\ndeduplicated. The doc used to claim \"deduplicated by node id\" and\n`collect_result_nodes` never did it; the DOC was the wrong half. Under the\nold content-addressed id, deduplicating would have been a data-loss bug:\nbyte-identical declarations shared an id but not their facts (`file_path`,\n`line`, byte range), so collapsing them would have thrown away every\noccurrence but the first. Ids are now per-occurrence\n(CONCEPT:EG-KG.compute.symbol-occurrence-id), so uniqueness holds by\nconstruction and there is nothing left to dedupe \u2014 provided the batch\ncarries each file path once, which is the caller's contract (a path\nrepeated in `files` is parsed twice and would repeat its ids). The\ninternal `call_sites` resolution-input property is stripped before return.", "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ExtractedNode" }, "type": "array" }, "realizes_edges": { "description": "Class\u2192interface `realizes` edges emitted.", "format": "uint", "minimum": 0, "type": "integer" }, "similar_edges": { "description": "Model-free `similar_to` edges emitted (CONCEPT:EG-KG.compute.model-free-similar-code).", "format": "uint", "minimum": 0, "type": "integer" }, "symbols_extracted": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "nodes", "edges", "symbols_extracted", "files_parsed", "file_outcomes", "calls_resolved", "calls_unresolved", "calls_scope_resolved", "calls_type_resolved", "inherits_edges", "realizes_edges", "similar_edges", "imports_resolved", "imports_unresolved" ], "type": "object" }, "ResDef_Ingestion_LakehouseVectorProjectionRef": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "namespace_id": { "type": "string" }, "projection_id": { "type": "string" }, "source_revision": { "type": "string" }, "table_id": { "type": "string" } }, "required": [ "catalog_id", "namespace_id", "table_id", "projection_id", "source_revision" ], "type": "object" }, "ResDef_Ingestion_LogicalName": { "description": "Validated graph or native-resource name with no filesystem semantics.", "type": "string" }, "ResDef_Ingestion_McpCatalogSnapshotBinding": { "additionalProperties": false, "description": "Exact identity of the served MCP catalog snapshot this pack came from.\n\nThe pack digest binds this whole value. Consequently a stored resource can\nnever be mistaken for one observed under a different configuration,\nconnection or authorization scope even when its own body is byte-identical.", "properties": { "authorization_scope_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, "catalog_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "child_connection_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "configuration_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "snapshot_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" } }, "required": [ "configuration_revision", "catalog_generation", "snapshot_digest", "child_connection_generation", "authorization_scope_digest" ], "type": "object" }, "ResDef_Ingestion_MultimodalAssetRef": { "additionalProperties": false, "properties": { "asset_id": { "type": "string" }, "asset_revision": { "type": "string" }, "content_digest": { "type": "string" }, "media_kind": { "type": "string" } }, "required": [ "asset_id", "media_kind", "asset_revision", "content_digest" ], "type": "object" }, "ResDef_Ingestion_MutationOutboxIntent": { "additionalProperties": false, "description": "A projection/index/CDC/audit/lineage notification to publish after commit.", "properties": { "headers": { "additionalProperties": { "type": "string" }, "type": "object" }, "key": { "type": "string" }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "topic": { "type": "string" } }, "required": [ "topic", "key", "payload", "headers" ], "type": "object" }, "ResDef_Ingestion_MutationOutboxLease": { "additionalProperties": false, "description": "Durable lease over an outbox row.", "properties": { "attempt": { "format": "uint32", "minimum": 0, "type": "integer" }, "consumer": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_until_ms": { "description": "EXCLUSIVE upper bound, mirroring `eg_transaction::outbox::rows::\nOutboxDelivery::lease_until_ms` (the durable row this lease is\nissued over): valid while `now_ms < lease_until_ms`, expired once\n`now_ms >= lease_until_ms`. `now_ms == lease_until_ms` is already\nexpired, not still valid.", "format": "uint64", "minimum": 0, "type": "integer" }, "record": { "$ref": "#/components/schemas/ResDef_Ingestion_MutationOutboxRecord" } }, "required": [ "record", "consumer", "lease_epoch", "lease_until_ms", "attempt" ], "type": "object" }, "ResDef_Ingestion_MutationOutboxRecord": { "additionalProperties": false, "description": "One durable outbox row.", "properties": { "batch_id": { "type": "string" }, "commit_sequence": { "default": null, "description": "The scope version after the batch committed. Legacy rows may omit\nthis field and are rejected when their original order is unverifiable.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "committed_version": { "$ref": "#/components/schemas/ResDef_Ingestion_CommittedVersion" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "identity": { "$ref": "#/components/schemas/ResDef_Ingestion_MutationScopeIdentity" }, "intent": { "$ref": "#/components/schemas/ResDef_Ingestion_MutationOutboxIntent" }, "ordinal": { "format": "uint32", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "batch_id", "ordinal", "identity", "committed_version", "intent", "created_at_ms" ], "type": "object" }, "ResDef_Ingestion_MutationScope": { "description": "Typed logical owner of a durable mutation.", "oneOf": [ { "additionalProperties": false, "properties": { "graph": { "$ref": "#/components/schemas/ResDef_Ingestion_LogicalName" }, "kind": { "const": "graph", "type": "string" } }, "required": [ "kind", "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "domain": { "$ref": "#/components/schemas/ResDef_Ingestion_DurabilityDomain" }, "kind": { "const": "native", "type": "string" }, "resource": { "$ref": "#/components/schemas/ResDef_Ingestion_LogicalName" } }, "required": [ "kind", "domain", "resource" ], "type": "object" } ] }, "ResDef_Ingestion_MutationScopeDigest": { "description": "Canonical SHA-256 identity digest persisted with every authority-bearing row.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "maxItems": 32, "minItems": 32, "type": "array" }, "ResDef_Ingestion_MutationScopeIdentity": { "additionalProperties": false, "description": "Tenant + typed logical owner + exact lifecycle generation.", "properties": { "identity_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_MutationScopeDigest" }, "incarnation_id": { "$ref": "#/components/schemas/ResDef_Ingestion_IncarnationId" }, "scope": { "$ref": "#/components/schemas/ResDef_Ingestion_MutationScope" }, "tenant": { "$ref": "#/components/schemas/ResDef_Ingestion_ScopeTenantId" } }, "required": [ "tenant", "scope", "incarnation_id", "identity_digest" ], "type": "object" }, "ResDef_Ingestion_OutboxConsumerStatus": { "additionalProperties": false, "description": "One consumer's standing on one outbox -- the fields that mean the same\nthing regardless of WHICH durable outbox backs the view. Shared by\n[`MutationOutboxStatusView`] (this generic outbox) and\n[`crate::result_contract::ingestion::SemanticOutboxStatus`] (the\nsemantic-index stage queue's own outbox), which otherwise built an\nidentical 13-field struct independently; each view keeps its own\nsystem-specific fields (a schema version and the head-of-queue detail\nhere, claim counters there) beside this rather than inside it, and this\ntype is neither `#[serde(flatten)]`ed nor a wire-visible name of its\nown's alternative -- it is a genuinely nested field, precisely so both\ncontainers can keep `#[serde(deny_unknown_fields)]`, which `flatten`\ncannot coexist with.\n\nSeveral counters carry an explicit `_is_lower_bound` flag rather than being\nsilently approximate: a saturated index can only be scanned so far, and an\noperator deciding whether to rewind needs to know that \"12\" might mean\n\"at least 12\".", "properties": { "capacity": { "format": "uint32", "minimum": 0, "type": "integer" }, "consumer": { "type": "string" }, "dead_lettered": { "format": "uint64", "minimum": 0, "type": "integer" }, "delivered": { "format": "uint64", "minimum": 0, "type": "integer" }, "index_complete": { "type": "boolean" }, "inflight": { "format": "uint32", "minimum": 0, "type": "integer" }, "inflight_is_lower_bound": { "type": "boolean" }, "lag_rows": { "format": "uint64", "minimum": 0, "type": "integer" }, "lag_versions": { "format": "uint64", "minimum": 0, "type": "integer" }, "live": { "type": "boolean" }, "oldest_pending_age_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "pending": { "format": "uint64", "minimum": 0, "type": "integer" }, "pending_is_lower_bound": { "type": "boolean" }, "saturated": { "type": "boolean" }, "topic": { "default": null, "type": [ "string", "null" ] } }, "required": [ "consumer", "live", "capacity", "inflight", "inflight_is_lower_bound", "pending", "pending_is_lower_bound", "delivered", "dead_lettered", "oldest_pending_age_ms", "lag_rows", "lag_versions", "saturated", "index_complete" ], "type": "object" }, "ResDef_Ingestion_ParseResult": { "description": "Result of `Method::ParseFile`, and one entry of `Method::ParseFiles`: the raw,\nunresolved symbol graph of one source file.", "properties": { "edges": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ExtractedEdge" }, "type": "array" }, "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ExtractedNode" }, "type": "array" }, "symbols_extracted": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "nodes", "edges", "symbols_extracted" ], "type": "object" }, "ResDef_Ingestion_QuantumExpectationResult": { "description": "Result of [`QuantumOp::Expectation`].", "properties": { "backend_id": { "type": "string" }, "circuit_hash": { "description": "Hex digest of the executed circuit.", "type": "string" }, "exact": { "description": "The backend's own exactness verdict for the raw run.", "type": "boolean" }, "expectation_value": { "description": "Sample-mean estimate of the Z-parity observable.", "format": "double", "type": "number" }, "fidelity_hint": { "format": "double", "type": [ "number", "null" ] }, "formalism": { "description": "The backend's simulation formalism, as its `snake_case` name.", "type": [ "string", "null" ] }, "noise_model_id": { "type": [ "string", "null" ] }, "observable_qubits": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "type": "array" }, "operation": { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumOperationKind" }, "peak_memory_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "planner": { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumPlannerReport" }, "proposal": { "description": "Always true at this surface: a result is a proposal, never a hard constraint.", "type": "boolean" }, "seed": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "stderr": { "format": "double", "type": "number" }, "wall_time_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "backend_id", "circuit_hash", "exact", "proposal", "wall_time_ms", "peak_memory_bytes", "operation", "planner", "observable_qubits", "expectation_value", "stderr" ], "type": "object" }, "ResDef_Ingestion_QuantumOperationKind": { "description": "Which [`QuantumOp`] produced a result.", "enum": [ "rank", "optimize_qaoa", "expectation" ], "type": "string" }, "ResDef_Ingestion_QuantumPlannerAuditEntry": { "description": "One rule the backend planner evaluated, with its note.", "properties": { "note": { "type": "string" }, "rule": { "type": "string" } }, "required": [ "rule", "note" ], "type": "object" }, "ResDef_Ingestion_QuantumPlannerReport": { "description": "The backend planner's decision for a run.", "properties": { "audit_trail": { "description": "Every rule considered, in evaluation order.", "items": { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumPlannerAuditEntry" }, "type": "array" }, "backend_override_requested": { "type": [ "string", "null" ] }, "chosen_backend": { "type": "string" }, "chosen_family": { "description": "The chosen backend's family, as its `snake_case` name.", "type": [ "string", "null" ] }, "rule": { "description": "The rule that decided.", "type": "string" } }, "required": [ "chosen_backend", "rule", "audit_trail" ], "type": "object" }, "ResDef_Ingestion_QuantumQaoaResult": { "description": "Result of [`QuantumOp::OptimizeQaoa`].", "properties": { "backend_id": { "type": "string" }, "circuit_hash": { "description": "Hex digest of the executed circuit.", "type": "string" }, "cut_value": { "format": "double", "type": "number" }, "exact": { "description": "The backend's own exactness verdict for the raw run.", "type": "boolean" }, "fidelity_hint": { "format": "double", "type": [ "number", "null" ] }, "formalism": { "description": "The backend's simulation formalism, as its `snake_case` name.", "type": [ "string", "null" ] }, "noise_model_id": { "type": [ "string", "null" ] }, "operation": { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumOperationKind" }, "p_layers": { "format": "uint32", "minimum": 0, "type": "integer" }, "partition": { "additionalProperties": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "description": "Node id -> the side (0 or 1) of the best sampled cut.", "type": "object" }, "peak_memory_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "planner": { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumPlannerReport" }, "proposal": { "description": "Always true at this surface: a result is a proposal, never a hard constraint.", "type": "boolean" }, "seed": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "variational_optimizer": { "description": "The fixed angle schedule used (no variational loop runs).", "type": "string" }, "wall_time_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "backend_id", "circuit_hash", "exact", "proposal", "wall_time_ms", "peak_memory_bytes", "operation", "planner", "partition", "cut_value", "p_layers", "variational_optimizer" ], "type": "object" }, "ResDef_Ingestion_QuantumRankResult": { "description": "Result of [`QuantumOp::Rank`].", "properties": { "backend_id": { "type": "string" }, "circuit_hash": { "description": "Hex digest of the executed circuit.", "type": "string" }, "exact": { "description": "The backend's own exactness verdict for the raw run.", "type": "boolean" }, "fidelity_hint": { "format": "double", "type": [ "number", "null" ] }, "formalism": { "description": "The backend's simulation formalism, as its `snake_case` name.", "type": [ "string", "null" ] }, "noise_model_id": { "type": [ "string", "null" ] }, "operation": { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumOperationKind" }, "peak_memory_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "planner": { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumPlannerReport" }, "proposal": { "description": "Always true at this surface: a result is a proposal, never a hard constraint.", "type": "boolean" }, "ranked_candidates": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumRankedCandidate" }, "type": "array" }, "seed": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "wall_time_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "backend_id", "circuit_hash", "exact", "proposal", "wall_time_ms", "peak_memory_bytes", "operation", "planner", "ranked_candidates" ], "type": "object" }, "ResDef_Ingestion_QuantumRankedCandidate": { "description": "One candidate of [`QuantumOp::Rank`], scored.", "properties": { "id": { "type": "string" }, "probability": { "description": "Marginal probability of the candidate's qubit measuring 1.", "format": "double", "type": "number" }, "rank": { "description": "Zero-based position, best first.", "format": "uint", "minimum": 0, "type": "integer" }, "weight": { "format": "double", "type": "number" } }, "required": [ "id", "weight", "probability", "rank" ], "type": "object" }, "ResDef_Ingestion_RawAdmissionReceipt": { "additionalProperties": false, "description": "One raw artifact admitted to content-addressed storage and bound to its\nsource identity. `deduplicated` reports an earlier identical artifact in\nthis batch (stable across replay); the CAS may also reuse bytes admitted by\nprior batches. Every record retains its own durable provenance binding.", "properties": { "deduplicated": { "type": "boolean" }, "raw_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, "record_id": { "type": "string" }, "stream": { "type": "string" } }, "required": [ "stream", "record_id", "raw_digest", "deduplicated" ], "type": "object" }, "ResDef_Ingestion_RawRelationshipAdmissionReceipt": { "additionalProperties": false, "properties": { "deduplicated": { "type": "boolean" }, "raw_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, "relationship_id": { "type": "string" } }, "required": [ "relationship_id", "raw_digest", "deduplicated" ], "type": "object" }, "ResDef_Ingestion_ScopeTenantId": { "description": "Validated tenant security boundary. Bytes are retained exactly as supplied.", "type": "string" }, "ResDef_Ingestion_ScreenObservationResult": { "description": "Result of `Method::ObserveScreen`: one captured frame as session/frame/UI-element\ngraph entities.", "properties": { "changed": { "description": "False when the frame is byte-identical to the previous one (no visual change).", "type": "boolean" }, "edges": { "description": "session-`hasObservation`->frame, frame-`hasElement`->element, and\nprevframe-`succeededBy`->frame (only when the frame actually changed).", "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ExtractedEdge" }, "type": "array" }, "element_count": { "format": "uint", "minimum": 0, "type": "integer" }, "frame_id": { "type": "string" }, "hash": { "description": "FNV-1a hash of the PNG bytes \u2014 the caller passes it back as `prev_hash`.", "format": "uint64", "minimum": 0, "type": "integer" }, "height": { "format": "uint32", "minimum": 0, "type": "integer" }, "nodes": { "description": "The session node + the frame node + one node per UI element.", "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ExtractedNode" }, "type": "array" }, "width": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "nodes", "edges", "frame_id", "width", "height", "hash", "changed", "element_count" ], "type": "object" }, "ResDef_Ingestion_SemanticAnnIndexIdentity": { "additionalProperties": false, "properties": { "ann_index_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_id": { "type": "string" }, "dimension": { "format": "uint32", "minimum": 0, "type": "integer" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "method": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticAnnIndexMethod" }, "model_digest": { "type": "string" }, "parameters_digest": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "method", "parameters_digest", "generation", "source_revision", "model_digest", "dimension", "purpose_id", "policy_digest", "ann_index_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticAnnIndexMethod": { "enum": [ "hnsw", "ivf_pq" ], "type": "string" }, "ResDef_Ingestion_SemanticBinding": { "additionalProperties": false, "properties": { "actor_scope": { "type": "string" }, "ann_index_identity": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticAnnIndexIdentity" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_id": { "type": "string" }, "created_at": { "type": "string" }, "dimension": { "format": "uint32", "minimum": 0, "type": "integer" }, "durable_state": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticBindingState" }, "effective_actor_scope": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index_identity": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticLexicalIndexIdentity" }, "maintenance_policy_id": { "type": "string" }, "metric": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticVectorMetric" }, "model_digest": { "type": "string" }, "model_id": { "type": "string" }, "model_revision": { "type": "string" }, "policy_digest": { "type": "string" }, "policy_identity": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticPolicyIdentity" }, "preprocess_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "queue_profile_id": { "type": "string" }, "source_field_set_digest": { "type": "string" }, "source_revision": { "type": "string" }, "source_schema_digest": { "type": "string" }, "source_selector": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticSourceSelector" }, "tenant_id": { "type": "string" }, "vector_target_id": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "tenant_id", "actor_scope", "effective_actor_scope", "purpose_id", "policy_identity", "policy_digest", "source_selector", "source_schema_digest", "source_revision", "source_field_set_digest", "vector_target_id", "dimension", "metric", "model_id", "model_revision", "preprocess_digest", "model_digest", "generation", "maintenance_policy_id", "queue_profile_id", "lexical_index_identity", "ann_index_identity", "created_at", "durable_state" ], "type": "object" }, "ResDef_Ingestion_SemanticBindingPage": { "additionalProperties": false, "description": "One page of the bounded binding catalog.\n\nAn OBJECT, never a bare array, for the reason\n[`crate::agent_component::AgentComponentSearchPage`] is one: a read that\nstarts life as a JSON array can only grow a cursor by breaking every reader\nthat already parses it.", "properties": { "entries": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticBinding" }, "type": "array" }, "next_cursor": { "description": "Where to resume. OPAQUE: engine-produced and only ever handed back\nunmodified, and it cannot address a binding outside the owner that\nminted it.", "type": [ "string", "null" ] } }, "required": [ "entries" ], "type": "object" }, "ResDef_Ingestion_SemanticBindingState": { "enum": [ "pending", "building", "live", "disabled", "failed", "dropping" ], "type": "string" }, "ResDef_Ingestion_SemanticDigest": { "description": "A SHA-256 semantic contract identity as `sha256:<64 lowercase hex>`", "maxLength": 71, "minLength": 71, "pattern": "^sha256:[0-9a-f]{64}$", "type": "string" }, "ResDef_Ingestion_SemanticGenerationAggregate": { "additionalProperties": false, "properties": { "aggregate_artifact_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "aggregate_receipt_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "completed_entity_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "entity_set_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "expected_entity_count": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "expected_entity_count", "completed_entity_count", "entity_set_digest", "aggregate_receipt_digest", "aggregate_artifact_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticGenerationCheckpoint": { "additionalProperties": false, "properties": { "aggregate": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticGenerationAggregate" }, "artifact_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_id": { "type": "string" }, "checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "completed_at": { "type": "string" }, "dependency": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticGenerationDependency" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_revision": { "type": "string" }, "stage": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStage" } }, "required": [ "binding_id", "binding_digest", "generation", "source_revision", "stage", "aggregate", "dependency", "artifact_digest", "completed_at", "checkpoint_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticGenerationCheckpointUpdate": { "additionalProperties": false, "description": "One exact checkpoint compare-and-swap carried with an S3/S5 completion.\nThe owner store must load the expected predecessor, insert `member`,\nrecompute the complete sorted aggregate from authoritative entity rows,\nand compare it with `successor` in the same transaction.", "properties": { "expected_previous_checkpoint_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, { "type": "null" } ] }, "expected_previous_completed_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "member": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticGenerationMember" }, "successor": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticGenerationCheckpoint" } }, "required": [ "expected_previous_completed_count", "member", "successor" ], "type": "object" }, "ResDef_Ingestion_SemanticGenerationDependency": { "oneOf": [ { "additionalProperties": false, "properties": { "dependency": { "const": "none", "type": "string" } }, "required": [ "dependency" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "dependency": { "const": "checkpoint", "type": "string" }, "stage": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStage" } }, "required": [ "dependency", "stage", "checkpoint_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "ann_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "dependency": { "const": "activation", "type": "string" }, "lexical_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" } }, "required": [ "dependency", "lexical_checkpoint_digest", "ann_checkpoint_digest" ], "type": "object" } ] }, "ResDef_Ingestion_SemanticGenerationMember": { "additionalProperties": false, "properties": { "artifact_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "receipt_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "source_entity_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "source_entity_id", "source_revision", "receipt_digest", "artifact_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticLexicalIndexIdentity": { "additionalProperties": false, "properties": { "analyzer_config_digest": { "type": "string" }, "analyzer_id": { "type": "string" }, "analyzer_revision": { "type": "string" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_id": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "analyzer_id", "analyzer_revision", "analyzer_config_digest", "generation", "source_revision", "purpose_id", "policy_digest", "lexical_index_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticMutationReceipt": { "description": "Durable receipt returned by the semantic-index owner for a committed mutation.\nThe runtime type lives above `eg-types`; this wire mirror keeps the contract at\nthe bottom of the crate DAG while retaining the exact serialized fields.", "properties": { "batch_id": { "type": "string" }, "mutation_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "replayed": { "type": "boolean" }, "source_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "target_version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "batch_id", "mutation_digest", "source_version", "target_version", "replayed" ], "type": "object" }, "ResDef_Ingestion_SemanticOutboxStatus": { "description": "Wire view of the outbox status returned by the semantic stage queue. The\nfields every outbox-status view shares live in\n[`OutboxConsumerStatus`]; `consecutive_claims`/`total_claims` are this\nqueue's own.", "properties": { "consecutive_claims": { "format": "uint32", "minimum": 0, "type": "integer" }, "status": { "$ref": "#/components/schemas/ResDef_Ingestion_OutboxConsumerStatus" }, "total_claims": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "status", "consecutive_claims", "total_claims" ], "type": "object" }, "ResDef_Ingestion_SemanticPolicyComponents": { "additionalProperties": false, "properties": { "rbac_policy_digest": { "type": "string" }, "rbac_policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "row_policy_digest": { "type": "string" }, "row_policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_acl_digest": { "type": "string" }, "source_acl_revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "rbac_policy_revision", "rbac_policy_digest", "row_policy_revision", "row_policy_digest", "source_acl_revision", "source_acl_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticPolicyIdentity": { "additionalProperties": false, "properties": { "components": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticPolicyComponents" }, "effective_actor_scope": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "effective_actor_scope", "purpose_id", "components", "policy_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticQueueClass": { "enum": [ "fast", "medium", "slow_heavy" ], "type": "string" }, "ResDef_Ingestion_SemanticSourceSelector": { "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "sql_column_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Ingestion_SqlColumnRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "graph_text_property_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Ingestion_GraphTextPropertyRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "canonical_text_asset", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Ingestion_CanonicalTextAssetRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "agent_library_composite", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Ingestion_AgentLibraryCompositeRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "multimodal_asset_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Ingestion_MultimodalAssetRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "time_series_window_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Ingestion_TimeSeriesWindowRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "lakehouse_vector_projection_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Ingestion_LakehouseVectorProjectionRef" } }, "required": [ "kind", "selector" ], "type": "object" } ] }, "ResDef_Ingestion_SemanticSqlSourceIdentity": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "column_id": { "type": "string" }, "record_identity_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest", "description": "Server-derived digest of the stable row identity. Raw predicates and\nprimary-key values are intentionally not transport fields." }, "schema_id": { "type": "string" }, "source_identity_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "table_id": { "type": "string" }, "tenant_scope": { "type": "string" } }, "required": [ "tenant_scope", "catalog_id", "schema_id", "table_id", "column_id", "record_identity_digest", "source_identity_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticSqlSourceManifest": { "additionalProperties": false, "properties": { "authorization_receipt_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "manifest_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "source_acl_digest": { "type": "string" }, "source_acl_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_content_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "source_entity_id": { "type": "string" }, "source_field_set_digest": { "type": "string" }, "source_identity": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticSqlSourceIdentity" }, "source_revision": { "type": "string" }, "source_schema_digest": { "type": "string" }, "source_schema_revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "binding_id", "binding_digest", "generation", "source_identity", "source_entity_id", "source_revision", "source_content_digest", "source_schema_revision", "source_schema_digest", "source_field_set_digest", "source_acl_revision", "source_acl_digest", "authorization_receipt_digest", "completed_receipt_digest", "completed_at", "manifest_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticSqlSourcePageAdmission": { "description": "Bounded continuation returned by one semantic source-page admission turn.", "properties": { "complete": { "type": "boolean" }, "next_cursor": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": [ "array", "null" ] }, "receipts": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt" }, "type": "array" } }, "required": [ "receipts", "complete" ], "type": "object" }, "ResDef_Ingestion_SemanticSqlSourceReconciliationAdmission": { "description": "Bounded continuation returned by one semantic source-reconciliation turn.", "properties": { "complete": { "type": "boolean" }, "page_count": { "format": "uint", "minimum": 0, "type": "integer" }, "receipts": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt" }, "type": "array" }, "rows_seen": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_bytes_seen": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_revision": { "type": "string" }, "wakeup_consumed": { "type": "boolean" } }, "required": [ "receipts", "source_revision", "page_count", "complete", "wakeup_consumed", "rows_seen", "source_bytes_seen" ], "type": "object" }, "ResDef_Ingestion_SemanticStage": { "enum": [ "S1", "S2", "S3", "S4", "S5", "S6" ], "type": "string" }, "ResDef_Ingestion_SemanticStageIntent": { "additionalProperties": false, "properties": { "binding_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "binding_id": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "input_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "intent_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "predecessor": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStagePredecessor" }, "scope": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageScope" }, "source_revision": { "type": "string" }, "stage": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStage" } }, "required": [ "binding_id", "binding_digest", "generation", "scope", "source_revision", "stage", "predecessor", "input_digest", "intent_digest" ], "type": "object" }, "ResDef_Ingestion_SemanticStageLeaseEntry": { "additionalProperties": false, "description": "One claimed stage lease, with the intent it leases and the queue class that\nintent's stage belongs to.\n\nThe class is returned rather than assumed because it is what a tiered worker\nroutes on: an S1 `Fast` row and an S5 `SlowHeavy` row are the same shape and\nwildly different work.", "properties": { "intent": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageIntent" }, "lease": { "$ref": "#/components/schemas/ResDef_Ingestion_MutationOutboxLease" }, "queue_class": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticQueueClass" } }, "required": [ "lease", "intent", "queue_class" ], "type": "object" }, "ResDef_Ingestion_SemanticStageLeasePage": { "additionalProperties": false, "description": "The bounded result of one claim turn.", "properties": { "entries": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageLeaseEntry" }, "type": "array" }, "more_available": { "description": "Whether the selection scan stopped at its page bound, so an immediate\nsecond claim may find more.", "type": "boolean" }, "queue_class": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticQueueClass", "description": "The class this turn asked for. Echoed so a worker can prove the tier it\ngot is the tier it wanted." }, "released_other_class": { "description": "How many claimed rows belonged to another queue class and were released\nback unexecuted. A persistently non-zero value means this consumer is\ncompeting with the wrong tier, which is an operational fact worth\nsurfacing rather than silently absorbing.", "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "queue_class", "entries", "more_available", "released_other_class" ], "type": "object" }, "ResDef_Ingestion_SemanticStageOutcome": { "enum": [ "completed", "idempotent_noop", "deferred_backpressured", "parked_awaiting_predecessor", "rejected_dead_letter" ], "type": "string" }, "ResDef_Ingestion_SemanticStagePredecessor": { "oneOf": [ { "additionalProperties": false, "properties": { "proof": { "const": "none", "type": "string" } }, "required": [ "proof" ], "type": "object" }, { "additionalProperties": false, "properties": { "proof": { "const": "entity_receipt", "type": "string" }, "receipt_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "stage": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStage" } }, "required": [ "proof", "stage", "receipt_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "proof": { "const": "generation_checkpoint", "type": "string" }, "stage": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStage" } }, "required": [ "proof", "stage", "checkpoint_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticGenerationCheckpoint" }, "proof": { "const": "generation_coverage", "type": "string" } }, "required": [ "proof", "checkpoint" ], "type": "object" }, { "additionalProperties": false, "properties": { "ann_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "lexical_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "proof": { "const": "activation", "type": "string" } }, "required": [ "proof", "lexical_checkpoint_digest", "ann_checkpoint_digest" ], "type": "object" } ] }, "ResDef_Ingestion_SemanticStageReceipt": { "additionalProperties": false, "properties": { "completed_at": { "type": "string" }, "cursor": { "type": "string" }, "intent_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" }, "outcome": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageOutcome" }, "output_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticDigest" } }, "required": [ "intent_digest", "output_digest", "cursor", "completed_at", "outcome" ], "type": "object" }, "ResDef_Ingestion_SemanticStageScope": { "oneOf": [ { "additionalProperties": false, "properties": { "scope": { "const": "entity", "type": "string" }, "source_entity_id": { "type": "string" } }, "required": [ "scope", "source_entity_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "scope": { "const": "generation", "type": "string" } }, "required": [ "scope" ], "type": "object" } ] }, "ResDef_Ingestion_SemanticStageTransition": { "additionalProperties": false, "properties": { "generation_checkpoint": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticGenerationCheckpointUpdate" }, { "type": "null" } ] }, "intent": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageIntent" }, "receipt": { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageReceipt" } }, "required": [ "intent", "receipt" ], "type": "object" }, "ResDef_Ingestion_SemanticVectorMetric": { "enum": [ "cosine", "dot_product", "euclidean" ], "type": "string" }, "ResDef_Ingestion_ServedModalityApplyDisposition": { "enum": [ "Applied", "IdempotentReplay" ], "type": "string" }, "ResDef_Ingestion_ServedModalityApplyOutcome": { "properties": { "disposition": { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityApplyDisposition" }, "event_sequence": { "format": "uint64", "minimum": 0, "type": "integer" }, "observation_version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "disposition", "observation_version", "event_sequence" ], "type": "object" }, "ResDef_Ingestion_ServedModalityAuthority": { "properties": { "access_policy_ref": { "type": "string" }, "maximum_classification": { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityClassification" }, "purpose_ref": { "type": "string" }, "tenant_ref": { "type": "string" } }, "required": [ "tenant_ref", "access_policy_ref", "purpose_ref", "maximum_classification" ], "type": "object" }, "ResDef_Ingestion_ServedModalityCapabilities": { "properties": { "component_not_applicable": { "format": "uint", "minimum": 0, "type": "integer" }, "component_pass": { "format": "uint", "minimum": 0, "type": "integer" }, "component_ready": { "type": "boolean" }, "component_total": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "component_ready", "component_pass", "component_not_applicable", "component_total" ], "type": "object" }, "ResDef_Ingestion_ServedModalityClassification": { "enum": [ "public", "internal", "confidential", "restricted" ], "type": "string" }, "ResDef_Ingestion_ServedModalityEvent": { "properties": { "access_policy_ref": { "type": "string" }, "kind": { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityEventKind" }, "observation_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "occurrence_id": { "type": "string" }, "sequence": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_ref": { "type": "string" } }, "required": [ "sequence", "occurrence_id", "observation_version", "kind", "tenant_ref", "access_policy_ref" ], "type": "object" }, "ResDef_Ingestion_ServedModalityEventKind": { "enum": [ "ingested", "updated", "deleted", "moved_to_cold", "restored", "reindexed" ], "type": "string" }, "ResDef_Ingestion_ServedModalityStats": { "properties": { "active_records": { "format": "uint", "minimum": 0, "type": "integer" }, "events": { "format": "uint", "minimum": 0, "type": "integer" }, "modality_index_postings": { "format": "uint", "minimum": 0, "type": "integer" }, "native_index_keys": { "format": "uint", "minimum": 0, "type": "integer" }, "native_index_postings": { "format": "uint", "minimum": 0, "type": "integer" }, "segment_index_postings": { "format": "uint", "minimum": 0, "type": "integer" }, "snapshot_bytes": { "format": "uint", "minimum": 0, "type": "integer" }, "tombstoned_records": { "format": "uint", "minimum": 0, "type": "integer" }, "total_records": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "active_records", "total_records", "tombstoned_records", "modality_index_postings", "segment_index_postings", "native_index_keys", "native_index_postings", "events", "snapshot_bytes" ], "type": "object" }, "ResDef_Ingestion_ServedModalityTombstoneCollection": { "properties": { "collected": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "collected" ], "type": "object" }, "ResDef_Ingestion_SourceCheckpoint": { "additionalProperties": false, "properties": { "content_hash": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ], "description": "Provider-owned content identity for the returned page or snapshot.\nEG binds it into checkpoint CAS and replay; it never invents a value." }, "pending_watermark": { "type": [ "string", "null" ] }, "position": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceJson" }, "stream": { "type": "string" }, "watermark": { "type": [ "string", "null" ] } }, "required": [ "stream", "position" ], "type": "object" }, "ResDef_Ingestion_SourceEntityRef": { "additionalProperties": false, "properties": { "record_id": { "type": "string" }, "stream": { "type": "string" } }, "required": [ "stream", "record_id" ], "type": "object" }, "ResDef_Ingestion_SourceIngestStatus": { "additionalProperties": false, "description": "Latest checkpoint accepted by the one EG ingestion authority for a source\npartition. `None` means no batch has committed; callers must not substitute\na local checkpoint in that case.", "properties": { "accepted_checkpoint": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_SourceCheckpoint" }, { "type": "null" } ] }, "accepted_checkpoint_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ] }, "committed_graph_version": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "connector": { "type": "string" }, "content_hash": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ] }, "last_batch_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ] }, "last_receipt_id": { "type": [ "string", "null" ] }, "live_set_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ] }, "relationship_live_set_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ] }, "stream": { "type": "string" } }, "required": [ "connector", "stream" ], "type": "object" }, "ResDef_Ingestion_SourceIngestionDisposition": { "enum": [ "committed", "replayed" ], "type": "string" }, "ResDef_Ingestion_SourceIngestionMode": { "enum": [ "full", "delta", "reconcile" ], "type": "string" }, "ResDef_Ingestion_SourceIngestionReceipt": { "additionalProperties": false, "description": "Terminal receipt returned only after canonical mutation, raw references,\nprovenance and cursor state have committed. Its stable `receipt_digest`\nis the replay currency for the same batch digest.", "properties": { "accepted_checkpoint": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceCheckpoint" }, "accepted_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, "affected_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "batch_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, "committed_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "content_hash": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ] }, "disposition": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceIngestionDisposition" }, "live_set_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ] }, "mappings": { "$ref": "#/components/schemas/ResDef_Ingestion_BoundedVec_SourceMappingReceipt_5120" }, "mode": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceIngestionMode" }, "raw_admissions": { "$ref": "#/components/schemas/ResDef_Ingestion_BoundedVec_RawAdmissionReceipt_1024" }, "receipt_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, "receipt_id": { "type": "string" }, "relationship_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "relationship_live_set_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, { "type": "null" } ] }, "relationship_raw_admissions": { "$ref": "#/components/schemas/ResDef_Ingestion_BoundedVec_RawRelationshipAdmissionReceipt_4096" }, "relationship_tombstoned_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "relationship_tombstones": { "$ref": "#/components/schemas/ResDef_Ingestion_BoundedVec_SourceRelationshipTombstoneReceipt_4096" }, "tombstoned_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "tombstones": { "$ref": "#/components/schemas/ResDef_Ingestion_BoundedVec_SourceTombstoneReceipt_16384" } }, "required": [ "receipt_id", "disposition", "mode", "batch_digest", "mappings", "raw_admissions", "relationship_raw_admissions", "tombstones", "relationship_tombstones", "accepted_checkpoint", "accepted_checkpoint_digest", "affected_count", "relationship_count", "tombstoned_count", "relationship_tombstoned_count", "committed_graph_version", "receipt_digest" ], "type": "object" }, "ResDef_Ingestion_SourceJson": {}, "ResDef_Ingestion_SourceMappingKind": { "enum": [ "entity", "relationship" ], "type": "string" }, "ResDef_Ingestion_SourceMappingReceipt": { "additionalProperties": false, "properties": { "catalog": { "$ref": "#/components/schemas/ResDef_Ingestion_McpCatalogSnapshotBinding" }, "connector_pack_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, "kind": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceMappingKind" }, "mapping_digest": { "$ref": "#/components/schemas/ResDef_Ingestion_Digest256" }, "mapping_reference": { "type": "string" } }, "required": [ "kind", "mapping_reference", "mapping_digest", "connector_pack_digest", "catalog" ], "type": "object" }, "ResDef_Ingestion_SourceRelationshipTombstoneReceipt": { "additionalProperties": false, "properties": { "reason": { "type": "string" }, "relationship_id": { "type": "string" }, "source": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceEntityRef" }, "target": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceEntityRef" } }, "required": [ "relationship_id", "source", "target", "reason" ], "type": "object" }, "ResDef_Ingestion_SourceTombstoneReceipt": { "additionalProperties": false, "properties": { "entity": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceEntityRef" }, "node_id": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "entity", "node_id", "reason" ], "type": "object" }, "ResDef_Ingestion_SqlColumnRef": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "column_id": { "type": "string" }, "schema_id": { "type": "string" }, "table_id": { "type": "string" } }, "required": [ "catalog_id", "schema_id", "table_id", "column_id" ], "type": "object" }, "ResDef_Ingestion_TimeSeriesWindowRef": { "additionalProperties": false, "properties": { "series_id": { "type": "string" }, "source_revision": { "type": "string" }, "window_end": { "type": "string" }, "window_start": { "type": "string" } }, "required": [ "series_id", "window_start", "window_end", "source_revision" ], "type": "object" }, "ResDef_Ingestion_VizCapabilityEntry": { "properties": { "level": { "type": "string" }, "mark": { "type": "string" }, "notes": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "surface": { "type": "string" }, "target_wave": { "type": [ "string", "null" ] } }, "required": [ "mark", "surface", "level", "status" ], "type": "object" }, "ResDef_Ingestion_VizCapabilityMatrix": { "properties": { "entries": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_VizCapabilityEntry" }, "type": "array" } }, "required": [ "entries" ], "type": "object" }, "ResDef_Ingestion_VizFormat": { "description": "Static export raster/vector format \u2014 mirrors `eg_viz_core::StaticExportFormat`\nfield-for-field, INCLUDING its `rename_all = \"snake_case\"` wire casing (so a\ncaller sends `\"png\"`/`\"svg\"`/`\"pdf\"`, not `\"Png\"`/`\"Svg\"`/`\"Pdf\"`). This crate\nstays dependency-free (no `eg-viz-core` dep), so the variant is not reused\ndirectly; the handler converts one-to-one.", "enum": [ "png", "svg", "pdf" ], "type": "string" }, "ResDef_Ingestion_VizPayloadRef": { "properties": { "byte_len": { "format": "uint64", "minimum": 0, "type": "integer" }, "id": { "type": "string" }, "kind": { "type": "string" } }, "required": [ "id", "kind", "byte_len" ], "type": "object" }, "ResDef_Ingestion_VizProvenanceRecord": { "properties": { "algo_family": { "type": "string" }, "algo_name": { "type": "string" }, "content_fingerprint": { "format": "uint64", "minimum": 0, "type": "integer" }, "dataset_ref": { "type": "string" }, "exact": { "type": "boolean" }, "format": { "type": "string" }, "height_px": { "format": "uint32", "minimum": 0, "type": "integer" }, "lod_tier": { "type": "string" }, "produced_at_unix_ms": { "format": "int64", "type": "integer" }, "query_hash": { "type": "string" }, "result_ref": { "type": "string" }, "row_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "wall_time_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "width_px": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "result_ref", "query_hash", "dataset_ref", "content_fingerprint", "algo_family", "algo_name", "lod_tier", "exact", "row_count", "width_px", "height_px", "format", "wall_time_ms", "produced_at_unix_ms" ], "type": "object" }, "ResDef_Ingestion_VizRenderResponse": { "properties": { "bytes": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "cached": { "type": "boolean" }, "content_type": { "type": "string" }, "format": { "$ref": "#/components/schemas/ResDef_Ingestion_VizFormat" }, "result_ref": { "type": "string" }, "view_result": { "$ref": "#/components/schemas/ResDef_Ingestion_VizViewResult" } }, "required": [ "view_result", "format", "content_type", "result_ref", "cached", "bytes" ], "type": "object" }, "ResDef_Ingestion_VizViewResult": { "properties": { "exact": { "type": "boolean" }, "lod_tier": { "type": "string" }, "payloads": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_VizPayloadRef" }, "type": "array" }, "produced_at_unix_ms": { "format": "int64", "type": "integer" }, "query_hash": { "type": "string" }, "reduction": { "type": "string" }, "row_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "seed": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "wall_time_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "query_hash", "row_count", "lod_tier", "reduction", "exact", "payloads", "wall_time_ms", "produced_at_unix_ms" ], "type": "object" }, "ResDef_Messaging_CdcEvent": { "description": "One ordered change in a graph's CDC feed (CONCEPT:EG-KG.query.streaming-cdc-subscriptions). `seq` is the per-graph\nmonotonic cursor: a consumer tails with `CdcRead { from_seq }` and re-reads from a\nlater `seq` to skip what it has already seen. `before`/`after` carry the affected\nnode/edge property blob (MessagePack) pre- and post-mutation; `None` means absent\n(an add has no `before`, a remove no `after`).", "properties": { "after": { "default": [], "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "before": { "default": [], "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "graph": { "type": "string" }, "had_after": { "default": false, "description": "True when `after` carried a value.", "type": "boolean" }, "had_before": { "default": false, "description": "True when `before` carried a value (distinguishes an empty blob from absent).", "type": "boolean" }, "kind": { "$ref": "#/components/schemas/ResDef_Messaging_CdcKind" }, "label": { "default": "", "description": "The change's `type`/label property after the mutation (for label-filtered\nwatch + triggers); best-effort decoded from `after` (else `before`).", "type": "string" }, "node_id": { "description": "The node id for node changes / the edge source for edge changes.", "type": "string" }, "seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "target_id": { "default": "", "description": "The edge target (empty for node changes).", "type": "string" } }, "required": [ "seq", "graph", "kind", "node_id" ], "type": "object" }, "ResDef_Messaging_CdcKind": { "description": "The kind of a captured change. Mirrors the durable-mutation `Method` set the CDC\nfeed records (the ledger's `is_durable_mutation` family), flattened to the unit a\nconsumer reasons about (node add/remove/update, edge add/remove).", "enum": [ "AddNode", "RemoveNode", "UpdateNode", "AddEdge", "RemoveEdge" ], "type": "string" }, "ResDef_Messaging_CdcReadResult": { "description": "Materialized result of a `Method::CdcRead` call (B-8, 2026-08-13). Same\ndefect class as `GetLedger` (BUG A1): `CdcHub` (`src/server/cdc.rs`) backs\n`CdcRead`/`Watch`/`FiredTriggers` with a bounded, per-graph, PURELY\nIN-MEMORY ring (default 65,536 entries, `EPISTEMIC_GRAPH_CDC_RING` to\noverride) \u2014 deliberately EPHEMERAL, not durable (see that module's own\ndoc for the reasoning and why durability is a separate, out-of-scope,\nstorage-format decision). A caller that persists a `from_seq` cursor and\nresumes tailing can fall off the back of that ring in two distinct ways\nthat both used to look exactly like \"nothing happened\":\n\n 1. **within-epoch trim** \u2014 the ring exceeded its cap and dropped the\n oldest entries past `from_seq` (same process, same epoch).\n 2. **epoch reset** \u2014 the process restarted (or the graph's feed was\n rewound by `ClearGraph`/`FromMsgpack`/`Reconcile`), so the feed's\n seq numbering restarted from 0 in a FRESH epoch. This is the more\n dangerous case: `from_seq` can be numerically \"in range\" of the new\n epoch's `[watermark, head_seq]` window WITHOUT naming the same\n events at all \u2014 a purely numeric `from_seq <= head_seq` check\n cannot tell the two epochs apart. `epoch` exists for exactly this:\n it is a fresh id minted once when the hub is constructed\n (`CdcHub::new()`), stable for the process's life. A caller that\n persists `(epoch, from_seq)` alongside its cursor and observes a\n DIFFERENT `epoch` on a later read has PROOF the feed restarted\n under it, even when the server's own numeric check above could not\n catch it.\n\n`gap: true` covers case 1 (server-detectable) explicitly \u2014 `events` is\nalways empty in that case, and `watermark`/`head_seq` are the current\nvalues so the caller can re-seed (`watermark` to replay everything still\nretained, `head_seq` to resume from \"now\" and accept the gap). `gap:\nfalse` means `events` is a complete, contiguous read from `from_seq`\nWITHIN the returned `epoch` \u2014 the caller is still responsible for\ncomparing `epoch` across resumed reads to catch case 2.", "properties": { "epoch": { "description": "This hub instance's process-lifetime epoch id. See the struct doc.", "format": "uint64", "minimum": 0, "type": "integer" }, "events": { "items": { "$ref": "#/components/schemas/ResDef_Messaging_CdcEvent" }, "type": "array" }, "gap": { "description": "True when `from_seq` fell behind the retained ring window in THIS\nepoch. `events` is always empty when `gap` is true.", "type": "boolean" }, "head_seq": { "description": "The current head seq (next to be assigned) for this graph in this epoch.", "format": "uint64", "minimum": 0, "type": "integer" }, "watermark": { "description": "Oldest seq this epoch's ring can currently vouch for (0 if nothing\nhas been trimmed yet in this epoch, INCLUDING right after a restart \u2014\nwhich is exactly why `epoch` exists alongside it).", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "events", "gap", "watermark", "head_seq", "epoch" ], "type": "object" }, "ResDef_Messaging_CepEvent": { "properties": { "attrs": { "additionalProperties": true, "default": {}, "type": "object" }, "key": { "type": "string" }, "ts": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "ts", "key" ], "type": "object" }, "ResDef_Messaging_CepMatch": { "properties": { "end_ts": { "format": "uint64", "minimum": 0, "type": "integer" }, "events": { "items": { "$ref": "#/components/schemas/ResDef_Messaging_CepEvent" }, "type": "array" }, "start_ts": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "events", "start_ts", "end_ts" ], "type": "object" }, "ResDef_Messaging_ChannelCreated": { "description": "Result of `Method::CreateChannel`.", "properties": { "channel": { "type": "string" } }, "required": [ "channel" ], "type": "object" }, "ResDef_Messaging_ChannelDeparture": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Messaging_ChannelImprint" }, { "$ref": "#/components/schemas/ResDef_Messaging_ChannelDepartureStatus" } ], "description": "Result of `Method::LeaveChannel` and `Method::CloseChannel`: the channel's imprint\nwhen the call closed it, else a bare status string." }, "ResDef_Messaging_ChannelDepartureStatus": { "description": "How a leave or close ended when it produced no imprint.", "enum": [ "left", "closed" ], "type": "string" }, "ResDef_Messaging_ChannelImprint": { "description": "KG imprint created when a channel is closed.", "properties": { "channel_id": { "type": "string" }, "channel_type": { "$ref": "#/components/schemas/ResDef_Messaging_ChannelType" }, "closed_at": { "format": "uint64", "minimum": 0, "type": "integer" }, "created_at": { "format": "uint64", "minimum": 0, "type": "integer" }, "creator": { "type": "string" }, "message_count": { "format": "uint", "minimum": 0, "type": "integer" }, "participants": { "items": { "type": "string" }, "type": "array" }, "summary_embedding": { "items": { "format": "float", "type": "number" }, "type": [ "array", "null" ] }, "topic_metadata": { "type": [ "string", "null" ] } }, "required": [ "channel_id", "channel_type", "creator", "participants", "message_count", "created_at", "closed_at" ], "type": "object" }, "ResDef_Messaging_ChannelMessage": { "description": "A single message in a channel.", "properties": { "payload": { "type": "string" }, "sender": { "type": "string" }, "timestamp": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sender", "payload", "timestamp" ], "type": "object" }, "ResDef_Messaging_ChannelSummary": { "description": "One channel visible to the caller, as `Method::ListChannels` lists it.", "properties": { "id": { "type": "string" }, "members": { "description": "Number of members.", "format": "uint", "minimum": 0, "type": "integer" }, "type": { "$ref": "#/components/schemas/ResDef_Messaging_ChannelType" } }, "required": [ "id", "type", "members" ], "type": "object" }, "ResDef_Messaging_ChannelType": { "description": "Channel type for dynamic communication.", "oneOf": [ { "const": "PeerToPeer", "description": "1:1 direct messaging between two agents.", "type": "string" }, { "const": "Group", "description": "Many-to-many group channel.", "type": "string" } ] }, "ResDef_Messaging_ConfirmToken": { "description": "A publisher-confirm token (CONCEPT:EG-KG.compute.publisher-confirms-consumer-qos): a\nbroker-wide monotonic `delivery_tag` identifying the publish, plus whether the broker\ndurably accepted it (`confirmed`) or nacked it (unknown exchange). Mirrors AMQP\npublisher confirms / Kafka acks.", "properties": { "confirmed": { "type": "boolean" }, "delivery_tag": { "format": "int64", "type": "integer" } }, "required": [ "delivery_tag", "confirmed" ], "type": "object" }, "ResDef_Messaging_ContinuousQueryResult": { "description": "Current result of a continuous query \u2014 the incrementally-maintained value plus the\nCDC `seq` it reflects (so a reader knows how current it is).", "properties": { "name": { "type": "string" }, "through_seq": { "description": "The CDC seq this result has folded in up to (the watermark).", "format": "uint64", "minimum": 0, "type": "integer" }, "value": { "description": "The aggregate value (count, or sum).", "format": "double", "type": "number" } }, "required": [ "name", "value", "through_seq" ], "type": "object" }, "ResDef_Messaging_FiredAction": { "description": "A recorded trigger firing (CONCEPT:EG-KG.query.wire-codec). Returned by `FiredTriggers` so a\nreaction consumer pulls the action payload + the change that fired it.", "properties": { "action": { "default": [], "description": "The opaque action payload registered with the trigger (MessagePack).", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "change_seq": { "description": "The CDC seq of the change that fired the trigger.", "format": "uint64", "minimum": 0, "type": "integer" }, "fire_seq": { "description": "Per-graph monotonic fired-id (the cursor for `FiredTriggers`).", "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "node_id": { "type": "string" }, "trigger": { "type": "string" } }, "required": [ "fire_seq", "trigger", "graph", "change_seq", "node_id" ], "type": "object" }, "ResDef_Messaging_FiredTriggersResult": { "description": "Materialized result of a `Method::FiredTriggers` call (B-8 follow-up,\n2026-08-13). The fired-trigger log is a SECOND bounded in-memory ring on\nthe same per-graph `GraphFeed` the CDC ring lives on (`src/server/cdc.rs`),\nwith the identical ephemerality and the identical two gap shapes\n`CdcReadResult` documents \u2014 within-epoch trim and epoch reset \u2014 over its\nown `fire_seq` cursor rather than the CDC `seq` cursor. See\n`CdcReadResult`'s doc for the full reasoning; the fields here mean exactly\nthe same thing, scoped to the fired-trigger log instead of the change feed.", "properties": { "epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "fired": { "items": { "$ref": "#/components/schemas/ResDef_Messaging_FiredAction" }, "type": "array" }, "gap": { "type": "boolean" }, "head_seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "watermark": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "fired", "gap", "watermark", "head_seq", "epoch" ], "type": "object" }, "ResDef_Messaging_IdempotentPublish": { "description": "Outcome of an idempotent publish (CONCEPT:EG-KG.ingest.broker-reject-publish).\n`confirmed` mirrors the EG-284 publisher-confirm (the exchange existed / the broker\naccepted it); `duplicate` is `true` when a `(producer_id, seq)` stamp was recognised\nas already-seen and the message was DROPPED (effectively-once \u2014 a duplicate still\nconfirms so the retrying publisher stops); `delivered` is the number of queues the\nmessage was routed to (`0` for a duplicate or an unroutable/nacked publish).", "properties": { "confirmed": { "type": "boolean" }, "delivered": { "format": "uint", "minimum": 0, "type": "integer" }, "duplicate": { "type": "boolean" } }, "required": [ "confirmed", "duplicate", "delivered" ], "type": "object" }, "ResDef_Messaging_TriggerInfo": { "description": "One trigger registration (CONCEPT:EG-KG.query.wire-codec). When a CDC change in `graph` matches\n`label` + `op`, the trigger fires its `action` (an opaque MessagePack payload the\nconsumer interprets \u2014 e.g. a notification topic / a webhook spec). Fired actions\nare recorded in a per-graph fired log a client polls with `FiredTriggers`.", "properties": { "fire_count": { "description": "How many times this trigger has fired.", "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "label": { "default": "", "type": "string" }, "name": { "type": "string" }, "op": { "description": "\"add\" | \"remove\" | \"update\" | \"any\" \u2014 the change kind that fires it.", "type": "string" } }, "required": [ "name", "graph", "op", "fire_count" ], "type": "object" }, "ResDef_Messaging_WatchBatch": { "description": "A batch returned by a `Watch` long-poll (CONCEPT:EG-KG.query.wire-codec): the matching changes\nsince the client's cursor plus the next cursor to resume from.\n\nB-8 (2026-08-13): `Watch` tails the SAME bounded, explicitly-ephemeral\n`CdcHub` ring `CdcRead` does (`src/server/cdc.rs`'s module doc) via the\nidentical `from_seq` cursor, so it can fall off the back of that ring in\nthe identical two ways `CdcReadResult` documents (within-epoch trim, or\nan epoch reset from a process restart / `ClearGraph`/`FromMsgpack`/\n`Reconcile`) \u2014 an empty `events` used to be indistinguishable from \"caught\nup\". `gap: true` makes that explicit (`events` is then always empty);\n`watermark`/`head_seq`/`epoch` carry the same meaning as on\n`CdcReadResult` so a caller resuming `Watch` can detect the gap exactly\nthe same way.", "properties": { "epoch": { "default": 0, "description": "This hub instance's process-lifetime epoch id. See `CdcReadResult::epoch`.", "format": "uint64", "minimum": 0, "type": "integer" }, "events": { "items": { "$ref": "#/components/schemas/ResDef_Messaging_CdcEvent" }, "type": "array" }, "gap": { "default": false, "description": "True when `from_seq` could not be served contiguously (see the struct\ndoc). `events` is always empty when `gap` is true.", "type": "boolean" }, "head_seq": { "default": 0, "description": "The current head seq (next to be assigned) for this graph in this epoch.", "format": "uint64", "minimum": 0, "type": "integer" }, "next_seq": { "description": "The cursor to pass as `from_seq` next time (one past the last delivered seq).", "format": "uint64", "minimum": 0, "type": "integer" }, "watermark": { "default": 0, "description": "Oldest seq this epoch's ring can currently vouch for. See\n`CdcReadResult::watermark` \u2014 same field, same ephemeral-ring caveat.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "events", "next_seq" ], "type": "object" }, "ResDef_Query_AbstainReason": { "description": "Why the engine declined to answer.", "oneOf": [ { "additionalProperties": false, "description": "A required capability no candidate covers.", "properties": { "iri": { "type": "string" }, "reason": { "const": "uncovered_capability", "type": "string" } }, "required": [ "reason", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "A declared capability IRI that is not a native term.", "properties": { "iri": { "type": "string" }, "reason": { "const": "unresolved_capability_iri", "type": "string" } }, "required": [ "reason", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "Free text no mapping resolved to a task.", "properties": { "reason": { "const": "unmapped_task", "type": "string" }, "text_digest": { "type": "string" } }, "required": [ "reason", "text_digest" ], "type": "object" }, { "additionalProperties": false, "description": "The constraints named cannot be satisfied together.", "properties": { "constraints": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "reason": { "const": "infeasible", "type": "string" } }, "required": [ "reason", "constraints" ], "type": "object" }, { "additionalProperties": false, "description": "The search budget ran out above the accepted gap.", "properties": { "incumbent": { "default": null, "type": [ "string", "null" ] }, "lower_bound": { "$ref": "#/components/schemas/ResDef_Query_Scalar" }, "reason": { "const": "budget_exhausted", "type": "string" } }, "required": [ "reason", "lower_bound" ], "type": "object" }, { "additionalProperties": false, "description": "A fact the objective needs is absent on a candidate.", "properties": { "component_id": { "type": "string" }, "field": { "type": "string" }, "reason": { "const": "unknown_fact", "type": "string" } }, "required": [ "reason", "component_id", "field" ], "type": "object" }, { "additionalProperties": false, "description": "An external agent without its required observation.", "properties": { "component_id": { "type": "string" }, "reason": { "const": "ineligible_external_agent", "type": "string" } }, "required": [ "reason", "component_id" ], "type": "object" }, { "additionalProperties": false, "description": "The record itself would exceed the durable record bound.", "properties": { "bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason": { "const": "record_too_large", "type": "string" } }, "required": [ "reason", "bytes" ], "type": "object" }, { "additionalProperties": false, "description": "The request tried to widen the pinned policy.", "properties": { "field": { "type": "string" }, "reason": { "const": "policy_loosening", "type": "string" } }, "required": [ "reason", "field" ], "type": "object" }, { "additionalProperties": false, "description": "Statistical: below the policy's support, coverage or risk floor. It\nnames no invisible data, by construction.", "properties": { "reason": { "const": "insufficient_confidence", "type": "string" } }, "required": [ "reason" ], "type": "object" } ] }, "ResDef_Query_AgentComponentContentRequest": { "additionalProperties": false, "description": "Read one component revision's bytes.", "properties": { "component_id": { "type": "string" }, "entry_revision": { "default": null, "description": "`None` reads the current published revision.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "component_id" ], "type": "object" }, "ResDef_Query_AgentComponentDraft": { "additionalProperties": false, "description": "Caller-supplied inputs for one component revision.", "properties": { "actor_scope": { "type": "string" }, "attributes": { "additionalProperties": { "type": "string" }, "default": {}, "description": "Extension point. New facts belong here until they earn a typed field,\nso the vocabulary can grow without a wire break.", "type": "object" }, "classification": { "default": [], "description": "Ontology terms this component is classified under -- the terms it\nPROVIDES. Matched against a task's required capabilities by\nsubsumption (`crate::agent_ontology::satisfies`), which is what makes\n\"what does an agent doing XYZ need?\" a traversal rather than a prompt.", "items": { "type": "string" }, "type": "array" }, "component_id": { "type": "string" }, "content_digest": { "description": "Pins the component's actual bytes, wherever they live. The bytes\nthemselves are deliberately not stored here.", "type": "string" }, "content_ref": { "default": null, "description": "How to fetch those bytes. `None` for a component that is fully\ndescribed by its facts (a model profile names a provider model; there\nis no artifact to fetch).", "type": [ "string", "null" ] }, "declared_capabilities": { "default": [], "description": "Capability IRIs the publisher DECLARES this component provides, as\ndistinct from the curated `classification` above. A declaration is a\nclaim and is recorded as one, so a decision that leans on it is\nclassified by that claim.", "items": { "type": "string" }, "type": "array" }, "declared_required_capabilities": { "default": [], "description": "The publisher's own statement of what it requires, kept beside the\ncurated `required_capabilities` for the same reason\n`declared_capabilities` is kept beside `classification`.", "items": { "type": "string" }, "type": "array" }, "facts": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentFacts" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentKind" }, "policy_digest": { "type": "string" }, "provenance": { "$ref": "#/components/schemas/ResDef_Query_ComponentProvenance", "description": "Where this component came from. See [`ComponentProvenance`]." }, "purpose_id": { "type": "string" }, "required_capabilities": { "default": [], "description": "Capability IRIs this component NEEDS from whatever it is assembled\nwith. The assembly layer's coverage question is over this list.", "items": { "type": "string" }, "type": "array" }, "requires": { "default": [], "description": "What this component needs, each pinned to an exact revision.", "items": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "type": "array" }, "source_revision": { "type": "string" }, "source_revision_digest": { "type": "string" }, "summary": { "description": "The component's own description of itself, bounded.\n\nThis is INTERFACE, not content, and the distinction is what decides\nwhether it belongs here. An MCP tool's description is what a model\nreads to decide whether to call it, so it is part of the tool's\ncontract and has to be queryable. A system prompt's *body* is content\nand stays out; only its shape (mode, budget, variables) comes in.", "type": "string" }, "tenant_id": { "type": "string" }, "version": { "type": "string" } }, "required": [ "component_id", "kind", "version", "content_digest", "facts", "provenance", "summary", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "source_revision", "source_revision_digest" ], "type": "object" }, "ResDef_Query_AgentComponentFacts": { "description": "Kind-specific facts an optimizer needs in order to CHOOSE a component.\n\nTyped for the kinds selection actually turns on, and\n[`AgentComponentFacts::Opaque`] for the rest. New facts go in\n`attributes` on the entry rather than as new variants, so extending the\nvocabulary does not break the wire.", "oneOf": [ { "properties": { "context_window_tokens": { "format": "uint32", "minimum": 0, "type": "integer" }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_CostFacts" }, { "type": "null" } ], "default": null }, "facts": { "const": "model_profile", "type": "string" }, "latency_declared": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_DeclaredLatency" }, { "type": "null" } ], "default": null }, "latency_observed_ref": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ObservationRef" }, { "type": "null" } ], "default": null, "description": "The evaluation that MEASURED this profile's latency, when one\nexists. A declared latency and a measured one are different claims\nand a selection that cannot tell them apart cannot say which it used." }, "max_output_tokens": { "format": "uint32", "minimum": 0, "type": "integer" }, "modalities": { "$ref": "#/components/schemas/ResDef_Query_ModalityFacts", "default": { "input": [], "output": [] } }, "model_identity": { "type": "string" }, "provider": { "type": "string" }, "supports_structured_output": { "type": "boolean" }, "supports_tools": { "type": "boolean" }, "supports_vision": { "type": "boolean" } }, "required": [ "facts", "provider", "model_identity", "context_window_tokens", "max_output_tokens", "supports_tools", "supports_structured_output", "supports_vision" ], "type": "object" }, { "properties": { "facts": { "const": "system_prompt", "type": "string" }, "prompt_mode": { "$ref": "#/components/schemas/ResDef_Query_PromptMode" }, "token_estimate": { "description": "Budgeting input: a graph's prompts have to fit its model's context.", "format": "uint32", "minimum": 0, "type": "integer" }, "variables": { "description": "Names a dynamic prompt expects to be given. Empty for a static one.", "items": { "type": "string" }, "type": "array" } }, "required": [ "facts", "prompt_mode", "token_estimate", "variables" ], "type": "object" }, { "properties": { "cost": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_CostFacts" }, { "type": "null" } ], "default": null }, "destructive_hint": { "default": null, "type": [ "boolean", "null" ] }, "effect": { "$ref": "#/components/schemas/ResDef_Query_ToolEffect" }, "facts": { "const": "tool", "type": "string" }, "idempotent_hint": { "default": null, "type": [ "boolean", "null" ] }, "input_schema_digest": { "default": null, "description": "`sha256:` of the served-and-serialized input schema section.", "type": [ "string", "null" ] }, "latency_declared": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_DeclaredLatency" }, { "type": "null" } ], "default": null }, "modalities": { "$ref": "#/components/schemas/ResDef_Query_ModalityFacts", "default": { "input": [], "output": [] } }, "open_world_hint": { "default": null, "type": [ "boolean", "null" ] }, "output_schema_digest": { "default": null, "description": "`None` means the tool declares no output schema.", "type": [ "string", "null" ] }, "read_only_hint": { "default": null, "type": [ "boolean", "null" ] }, "required_scopes": { "description": "Authz actions a caller must hold. An agent that cannot hold them\ncannot be given this tool.", "items": { "type": "string" }, "type": "array" } }, "required": [ "facts", "effect", "required_scopes" ], "type": "object" }, { "properties": { "facts": { "const": "toolset", "type": "string" }, "transport": { "$ref": "#/components/schemas/ResDef_Query_ToolsetTransport" } }, "required": [ "facts", "transport" ], "type": "object" }, { "description": "Every other kind. Structure and dependencies still apply; there is just\nnothing kind-specific that selection turns on.", "properties": { "facts": { "const": "opaque", "type": "string" } }, "required": [ "facts" ], "type": "object" } ] }, "ResDef_Query_AgentComponentKind": { "description": "What kind of part this is.\n\nClosed on purpose. Every kind is either referenced from an agent slot \u2014\n[`crate::agent_library::AgentLibraryEntry`],\n[`crate::agent_library::AgentRuntimeContract`] or\n[`crate::agent_graph`] \u2014 or is catalog content an agent is VALIDATED or\nDECIDED against. Both belong to the same closed set for the same reason: a\npart nothing can name is a part nothing can reason about.", "oneOf": [ { "const": "model_profile", "description": "An LLM and the profile it is invoked under (`model_profile_ref`).", "type": "string" }, { "const": "system_prompt", "description": "Instructions, static or dynamic (`system_prompt_ref`).", "type": "string" }, { "const": "tool", "description": "One callable tool (`tool_refs`). An MCP server's tools ingest as these.", "type": "string" }, { "const": "toolset", "description": "A group of tools with one provenance: an MCP server, a function\ntoolset, a skill pack (`toolset_refs`).", "type": "string" }, { "const": "mcp_server", "description": "An MCP server itself -- the thing a set of tools/prompts/resources is\nserved BY. Modelled separately from `Toolset` because impact analysis\nasks about the server (\"this server is down / its schema moved --\nwhich agents are affected?\"), and that question needs the server to be\na node, not an attribute of each tool.", "type": "string" }, { "const": "mcp_prompt", "description": "An MCP prompt: a named, parameterized prompt template a server offers.", "type": "string" }, { "const": "mcp_resource", "description": "An MCP resource: addressable context a server exposes for reading.", "type": "string" }, { "const": "skill", "description": "A pydantic-ai skill (`skill_refs`).", "type": "string" }, { "const": "ontology", "description": "An ontology or vocabulary (`ontology_refs`).", "type": "string" }, { "const": "schema", "description": "A deps/output contract schema (`deps_contract`, `output_contract`).", "type": "string" }, { "const": "output_validator", "description": "An `@agent.output_validator` (`output_validator_refs`).", "type": "string" }, { "const": "predicate", "description": "A predicate behind a graph decision node or edge condition\n(`AgentGraphNodeKind::Decision::decision`, `AgentGraphEdge::condition`).\nBoth slots pin a `ComponentDependency` of this kind, so republishing a\npredicate cannot re-route an already-approved graph.", "type": "string" }, { "const": "shapes", "description": "A SHACL shapes graph a component or request graph is validated against.", "type": "string" }, { "const": "a2a_agent_card", "description": "An A2A agent card: an external agent's own declaration of itself.", "type": "string" }, { "const": "decision_record", "description": "One durable decision record. Published by the engine only; a caller\nthat tries to publish one is refused by name.", "type": "string" }, { "const": "decision_policy", "description": "A decision policy body: what \"better\" means and when to abstain.", "type": "string" }, { "const": "decision_head", "description": "A fitted statistical decision head.", "type": "string" }, { "const": "feature_schema", "description": "The feature schema a decision head is fitted and evaluated against.", "type": "string" }, { "const": "rubric", "description": "A scoring rubric a decision is judged by.", "type": "string" }, { "const": "nl_template", "description": "A natural-language template a decision surface renders with.", "type": "string" } ] }, "ResDef_Query_AgentComponentMutationKind": { "description": "Which durable mutation a component operation performs.", "oneOf": [ { "enum": [ "publish", "retire" ], "type": "string" }, { "const": "withdraw", "description": "A pack entry that vanished from its connector's current pack. Unlike\n`Retire` this is REVERSIBLE: the entry coming back republishes it.", "type": "string" }, { "const": "republish", "description": "A withdrawn pack entry returning in a later import.", "type": "string" } ] }, "ResDef_Query_AgentComponentOp": { "description": "Typed component wire operations.", "oneOf": [ { "description": "Boxed for the same reason as the other two layers: a publish request\ncarries a whole draft and would otherwise set the size of every\n`Method`.", "properties": { "op": { "const": "publish", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentPublishRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "op": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentRetireRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "component_id": { "type": "string" }, "op": { "const": "current", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "component_id" ], "type": "object" }, { "properties": { "component_id": { "type": "string" }, "op": { "const": "history", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "component_id" ], "type": "object" }, { "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentStatusRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "description": "Capability search -- the query this layer exists for.", "properties": { "op": { "const": "search", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentSearchRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "description": "Read one revision's engine-owned bytes back, digest-verified.", "properties": { "op": { "const": "content", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentContentRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ResDef_Query_AgentComponentPublishRequest": { "additionalProperties": false, "properties": { "component": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentDraft" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext", "description": "Shared with the other two layers: components are published into the\nsame owner as the agents and graphs that reference them, so they share\nits mutation context rather than growing a parallel copy of it." }, "evaluation_receipt_digest": { "default": null, "description": "`sha256:` of the evaluation receipt that qualified this revision.\nREQUIRED for [`AgentComponentKind::DecisionHead`]: a head decides what\nthe engine does, so publishing one without the receipt that measured it\nis the one case where \"we can evaluate it later\" is not recoverable.", "type": [ "string", "null" ] } }, "required": [ "context", "component" ], "type": "object" }, "ResDef_Query_AgentComponentRetireRequest": { "additionalProperties": false, "properties": { "component_id": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" } }, "required": [ "context", "component_id" ], "type": "object" }, "ResDef_Query_AgentComponentSearchRequest": { "additionalProperties": false, "description": "Find components by what they can do.\n\nThe wire form of *\"what does an agent trying to do XYZ need?\"*. A caller\nsupplies a `task` (resolved through the native ontology), explicit\n`capabilities`, or at least one `kind`. A kind-only request is the bounded,\npaginated catalog-listing form; a request with no selector is refused, and\nso is a `task` the native ontology does not know (it would resolve to no\ncapability and widen into an unfiltered listing).\n\n# Why this is paginated\n\nThis is the capability-discovery query the whole component layer exists to\nserve, so it is the one read whose result set grows with the tenant rather\nthan with the request. An unpaginated form has two failure modes and no\nrecovery from either: the response size is bounded only by the corpus, and a\ntenant whose component count passes the scan bound is refused on EVERY\nsearch forever. [`AgentComponentSearchPage`] exists so neither is possible,\nand it is an object rather than a bare array because turning an array into\nan object later is a read-side wire break.", "properties": { "capabilities": { "default": [], "description": "Capability terms the component must satisfy by subsumption.", "items": { "type": "string" }, "type": "array" }, "cursor": { "default": null, "description": "Where to resume, from a previous page's\n[`AgentComponentSearchPage::next_cursor`].\n\nOPAQUE: it is produced by the engine and only ever handed back\nunmodified. It carries a binding to the tenant it was minted for, so one\ntenant's cursor is refused by name against another's search rather than\nsilently resuming somewhere.", "type": [ "string", "null" ] }, "kinds": { "default": [], "description": "Restrict to these kinds. Empty means every kind.", "items": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentKind" }, "type": "array" }, "limit": { "default": null, "description": "How many entries this page may carry, at most\n[`MAX_AGENT_COMPONENT_SEARCH_LIMIT`]. `None` requests the maximum.", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "read_only": { "default": false, "description": "When true, exclude anything side-effecting. The reason this is a\nfirst-class filter rather than a caller-side one: assembling a\nread-only agent is a common, security-relevant request, and a caller\nthat has to filter afterwards can forget to.", "type": "boolean" }, "task": { "default": null, "description": "An ontology task term, e.g. `eg:task/research`.", "type": [ "string", "null" ] }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id" ], "type": "object" }, "ResDef_Query_AgentComponentStatusRequest": { "additionalProperties": false, "properties": { "component_id": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentMutationKind" } }, "required": [ "context", "component_id", "kind" ], "type": "object" }, "ResDef_Query_AgentGraphDraft": { "additionalProperties": false, "description": "Caller-supplied inputs for one composed graph.", "properties": { "actor_scope": { "type": "string" }, "graph_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "shape": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphShape" }, "synthesis_evidence": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "Why this shape: the evidence an optimizer (or a human) composed it from.\n`None` for a hand-authored graph. RF-ADR-008 requires a SYNTHESIZED\nshape to carry it -- a shape without evidence is a guess, and the\npremise of a context engine is that the context is the justification." }, "tenant_id": { "type": "string" }, "version": { "type": "string" } }, "required": [ "graph_id", "version", "shape", "tenant_id", "actor_scope", "purpose_id", "policy_digest" ], "type": "object" }, "ResDef_Query_AgentGraphEdge": { "additionalProperties": false, "description": "A directed edge, optionally conditional.", "properties": { "condition": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "Only meaningful out of a [`AgentGraphNodeKind::Decision`]; `None` is an\nunconditional edge.\n\nPinned for the same reason a decision node's predicate is: an unpinned\ncondition would let a republished predicate silently re-route an\napproved graph." }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to" ], "type": "object" }, "ResDef_Query_AgentGraphEntryRef": { "additionalProperties": false, "description": "One pinned agent GRAPH, as a delegation target (RF-ADR-008).\n\nMirrors [`AgentLibraryEntryRef`] exactly: both pin the record's\n`definition_digest`.\n\n# Why a delegation pins the RECORD digest and a composing parent does not\n\nA [`crate::agent_graph::AgentGraphNodeKind::Graph`] node deliberately pins\nthe child's `shape_digest` -- what a parent composes is the child's\nBEHAVIOUR, and the child's governance is re-checked live at every\nresolution, so pinning a stale copy of it would force a cascading republish\nof an entire tree for a change that alters no behaviour.\n\nA delegation is the opposite question. It names a record IDENTITY, and it is\nthe audit point: `synthesis_evidence` -- which RF-ADR-008 section D says is what\nmakes a synthesized graph auditable and reproducible -- is inside\n`definition_digest` and outside `shape_digest`, as are `version`, the actor\nscope, the purpose, the policy digest and the admitted\n`composed_work_ceiling`. A delegation that pinned only the shape would\nattest to what ran while leaving WHY it was composed unpinned.\n\nDo not \"unify\" the two by giving both the same digest: they answer different\nquestions, and [`crate::agent_graph::AgentGraphEntry`]'s own impl-block doc\ncarries the other half of this note.\n\nThe behaviour pin is not lost: `definition_digest` is a hash OVER\n`shape_digest`, and a shape digest covers every node, while an agent node\npins its own `definition_digest`, which pins every component it is assembled\nfrom. So the record digest still pins the ENTIRE tree transitively -- which\nis why a graph target needs no separate `model_digest` (see\n[`KgDelegateRequest::model_digest`]).", "properties": { "actor_scope": { "type": "string" }, "composed_work_ceiling": { "description": "The composed work ceiling this graph was admitted with --\n`CompositionFacts::total_work` from its publish.\n\nCarried rather than recomputed for two reasons. An executor cannot\nderive it without re-resolving the whole composition tree, and more\nimportantly it must honour the ceiling that was VALIDATED at admission,\nnot one it recomputes later against a tree that may have grown new\nrevisions.", "format": "uint64", "minimum": 0, "type": "integer" }, "definition_digest": { "description": "The published RECORD digest -- see the type doc for why this is the\nrecord digest and not the shape digest.", "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "graph_id", "entry_revision", "definition_digest", "actor_scope", "purpose_id", "policy_digest", "composed_work_ceiling" ], "type": "object" }, "ResDef_Query_AgentGraphMutationKind": { "description": "Which durable mutation a graph operation performs.", "enum": [ "publish", "retire" ], "type": "string" }, "ResDef_Query_AgentGraphNode": { "additionalProperties": false, "description": "One node: an identity, what it does, and the contracts it speaks.\n\nThe contracts are restated here rather than looked up from the referenced\nentry so a shape can be validated on its own, without resolving every agent\nit names. They are digest-pinned, so a shape whose restated contract has\ndrifted from the published entry is detectable at admission.", "properties": { "deps_contract": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "What this node consumes. `None` = takes the graph's own input." }, "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphNodeKind" }, "node_id": { "type": "string" }, "output_contract": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "What this node produces. `None` = produces nothing a successor can bind." } }, "required": [ "node_id", "kind" ], "type": "object" }, "ResDef_Query_AgentGraphNodeKind": { "description": "What one node in the graph does.", "oneOf": [ { "additionalProperties": false, "description": "Run one published Agent Library entry.", "properties": { "agent": { "properties": { "agent_id": { "type": "string" }, "definition_digest": { "description": "The exact definition this shape was composed against. Pinning the\ndigest is what stops a graph from silently changing behaviour when\nsomeone republishes an agent under the same id.", "type": "string" } }, "required": [ "agent_id", "definition_digest" ], "type": "object" } }, "required": [ "agent" ], "type": "object" }, { "additionalProperties": false, "description": "Instantiate a template with bound parameters, then run it.", "properties": { "template": { "properties": { "bindings": { "additionalProperties": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "description": "Parameter name -> the component it is bound to, each PINNED.\n\nBare strings here would break the invariant the rest of this type\nrests on: every other reference in a shape is pinned by digest, so\nrepublishing a component cannot change what a graph does. An unpinned\ntemplate binding would be the one hole through which it could.\nOrdered so the shape digest does not depend on map iteration order.", "type": "object" }, "definition_digest": { "type": "string" }, "template_id": { "type": "string" } }, "required": [ "template_id", "definition_digest", "bindings" ], "type": "object" } }, "required": [ "template" ], "type": "object" }, { "additionalProperties": false, "description": "Run another published GRAPH as one step -- the hierarchical case\n(RF-ADR-008): teams composed of teams.\n\n`shape_digest` pins the exact child revision, for the same reason an\nagent node pins `definition_digest`: republishing the child under the\nsame id must not silently change what this graph does. It also has a\nsecond, larger consequence -- see the module's composition notes -- in\nthat it makes the composition acyclic by construction.", "properties": { "graph": { "properties": { "graph_id": { "type": "string" }, "shape_digest": { "type": "string" } }, "required": [ "graph_id", "shape_digest" ], "type": "object" } }, "required": [ "graph" ], "type": "object" }, { "additionalProperties": false, "description": "Choose an outgoing edge by evaluating each edge's condition.\n\nThe predicate is PINNED, like every other reference in a shape.\nA bare `decision_ref: String` was the one remaining hole: republishing\nthe predicate an approved, digest-pinned graph routes through would\nchange which branch that graph executes, and no `shape_digest` would\nmove. [`AgentComponentKind::Predicate`] exists for exactly this slot.", "properties": { "decision": { "properties": { "decision": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" } }, "required": [ "decision" ], "type": "object" } }, "required": [ "decision" ], "type": "object" }, { "const": "fanout", "description": "Take every outgoing edge concurrently.", "type": "string" }, { "const": "join", "description": "Wait for every inbound edge before continuing.", "type": "string" }, { "const": "end", "description": "Terminal node.", "type": "string" } ] }, "ResDef_Query_AgentGraphOp": { "description": "Typed agent-graph wire operations.\n\nDeliberately the same five-operation shape as\n[`crate::agent_library::AgentLibraryOp`]: publish and retire are durable\nrevisions, `Current`/`History` are tenant-bound read snapshots, and `Status`\nresolves a prior attempt's receipt. A reader who knows one knows the other.", "oneOf": [ { "description": "Boxed for the same reason as `AgentLibraryOp::Publish`: the request\ncarries a whole graph draft and is far larger than every other\noperation, so an unboxed variant would make each `AgentGraphOp` -- and\nthrough it each `Method` -- pay that size. `Box` is transparent to\nserde, so the wire form is unchanged.", "properties": { "op": { "const": "publish", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphPublishRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "op": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphRetireRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "graph_id": { "type": "string" }, "op": { "const": "current", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "graph_id" ], "type": "object" }, { "properties": { "graph_id": { "type": "string" }, "op": { "const": "history", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "graph_id" ], "type": "object" }, { "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphStatusRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ResDef_Query_AgentGraphPublishRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext", "description": "Reused from [`crate::agent_library`] rather than cloned. Agent graphs\nare published into the SAME durable owner as agent entries, so they\nshare its mutation context: a parallel copy would be a second field set\nthat has to be kept in lockstep with the first for no gain\n(RF-RULING-004, one physical authority)." }, "graph": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphDraft" } }, "required": [ "context", "graph" ], "type": "object" }, "ResDef_Query_AgentGraphRetireRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "graph_id": { "type": "string" } }, "required": [ "context", "graph_id" ], "type": "object" }, "ResDef_Query_AgentGraphShape": { "additionalProperties": false, "description": "The composed shape: nodes, edges, and where a run starts.", "properties": { "edges": { "items": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphEdge" }, "type": "array" }, "entry_node": { "type": "string" }, "max_iterations": { "description": "Hard ceiling on node executions for one run. Required, because a shape\nmay contain cycles and a cycle without a ceiling is an unbounded run.", "format": "uint32", "minimum": 0, "type": "integer" }, "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphNode" }, "type": "array" } }, "required": [ "entry_node", "nodes", "edges", "max_iterations" ], "type": "object" }, "ResDef_Query_AgentGraphStatusRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "graph_id": { "type": "string" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphMutationKind" } }, "required": [ "context", "graph_id", "kind" ], "type": "object" }, "ResDef_Query_AgentLibraryCompositeRef": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "model_profile_digest": { "type": "string" }, "ontology_set_digest": { "type": "string" }, "role_digest": { "type": "string" }, "skill_set_digest": { "type": "string" }, "system_prompt_digest": { "type": "string" }, "tool_set_digest": { "type": "string" } }, "required": [ "agent_id", "role_digest", "system_prompt_digest", "tool_set_digest", "skill_set_digest", "model_profile_digest", "ontology_set_digest" ], "type": "object" }, "ResDef_Query_AgentLibraryEntryDraft": { "additionalProperties": false, "description": "Caller-supplied, immutable definition inputs for one built agent.\n\nEvery component is represented by an opaque reference and a digest. Raw\nprompts, secrets, tool output, and runtime context deliberately have no\nfield in this type and therefore cannot become part of durable identity.", "properties": { "actor_scope": { "type": "string" }, "agent_id": { "type": "string" }, "instantiated_from": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_TemplateInstanceRef" }, { "type": "null" } ], "default": null, "description": "Which template produced this agent, if any (RF-ADR-008 item C).\n\n`None` for a hand-authored agent. Present on an instance so \"which agents\ncame from this template?\" is a traversal -- the same reason components\nare pinned rather than named. Otherwise inert: an instance is admitted,\ndelegated and pinned exactly like any other agent, which is what keeps\nthose paths free of a template-aware branch." }, "model_identity": { "description": "Kept alongside `model_profile`: the profile is the pinned component,\nthis is the model it names. A reader answering \"what model does this\nagent run on?\" should not have to resolve a component to find out.", "type": "string" }, "model_profile": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "ontologies": { "items": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "type": "array" }, "package_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "role": { "type": "string" }, "role_digest": { "type": "string" }, "runtime": { "$ref": "#/components/schemas/ResDef_Query_AgentRuntimeContract", "default": { "deps_contract": null, "model_settings": { "max_output_tokens": null, "parallel_tool_calls": null, "request_timeout_ms": null, "seed": null, "stop_sequences": [], "temperature_milli": null, "top_p_milli": null }, "output_contract": null, "output_mode": null, "output_validator_refs": [], "prompt_mode": null, "retry_policy": { "model_retries": 0, "output_retries": 0 }, "toolset_refs": [], "usage_limits": { "input_tokens_limit": null, "output_tokens_limit": null, "request_limit": null, "tool_calls_limit": null } }, "description": "How this agent RUNS -- output/deps contracts, model settings, budgets.\nSee [`AgentRuntimeContract`]. An empty contract is a plain-text agent\nwith engine-default budgets." }, "skills": { "items": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "type": "array" }, "source_revision": { "description": "The source revision is an opaque, source-controlled revision identity;\nits content/provenance digest is carried separately below.", "type": "string" }, "source_revision_digest": { "type": "string" }, "system_prompt": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency", "description": "The components this agent is assembled from, each pinned to an exact\nL1 revision (RF-ADR-008). These were opaque `*_ref` strings plus a\nper-set digest; pinning them by `(component_id, kind, definition_digest)`\nis what connects the hierarchy:\n\n* \"which agents use this tool?\" becomes a traversal, not a string match;\n* republishing a component changes its digest, so an agent assembled\n from the old one no longer resolves -- silently inheriting a changed\n tool is no longer possible;\n* each slot's `kind` is checked, so a tool cannot be wired in where a\n model profile belongs.\n\nThe former `*_set_digest` fields are gone: a digest over the whole set\nwas pinning what the per-item digests now pin individually, and\n`definition_digest` already covers the sorted list." }, "tenant_id": { "type": "string" }, "tools": { "items": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "type": "array" }, "version": { "type": "string" } }, "required": [ "agent_id", "package_id", "version", "role", "role_digest", "system_prompt", "tools", "skills", "model_profile", "model_identity", "ontologies", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "source_revision", "source_revision_digest" ], "type": "object" }, "ResDef_Query_AgentLibraryEntryRef": { "additionalProperties": false, "description": "The retained Agent Library identity pinned by a delegation.\n\nThe fields mirror the current Agent Library entry identity: the tenant and\nactor/purpose/policy binding are checked at admission, while the definition\nand source digests pin the exact retained revision. EG never resolves this\nreference from a local cache; the admission owner supplies the retained\nentry and compares this exact value before creating a WorkItem.", "properties": { "actor_scope": { "type": "string" }, "agent_id": { "type": "string" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" }, "source_revision_digest": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "agent_id", "entry_revision", "definition_digest", "source_revision", "source_revision_digest", "actor_scope", "purpose_id", "policy_digest" ], "type": "object" }, "ResDef_Query_AgentLibraryLifecycle": { "description": "The retained lifecycle of one Agent Library definition.\n\n`Retired` is a durable tombstone. It remains in the revision stream and\ncannot be replaced by a later publish, preserving the definition's\nprovenance and preventing silent resurrection of an agent identity.\n\n`Withdrawn` is the reversible counterpart, and it exists only for connector\npack members: a pack that stops serving an entry has not decided the entry\nwas wrong, only that it is no longer offered, and a later import that\noffers it again must be able to republish it. Collapsing the two would make\nevery transient publisher outage a permanent tombstone.", "enum": [ "published", "retired", "withdrawn" ], "type": "string" }, "ResDef_Query_AgentLibraryMutationContext": { "additionalProperties": false, "description": "Caller and authorization facts required by one Agent Library write.\n\nThe storage seam copies these values into the durable action receipt and\nchecks the tenant before admission. The request boundary derives them from\nthe verified carrier; the entry's actor scope, purpose, and policy digest\nremain historical definition provenance and are retained independently.\nAuthentication and policy decisions remain above this pure DTO.", "properties": { "actor_scope": { "type": "string" }, "attempt_nonce": { "$ref": "#/components/schemas/ResDef_Query_Nonce", "description": "The verified attempt nonce. Every Agent Library mutation must receive\nthis from its authenticated producer; the storage owner never mints a\nfallback nonce because doing so would create a second replay authority." }, "caller_principal": { "description": "Privacy-safe authenticated caller identity, bound by the request\nboundary and copied to the action receipt/outbox actor header.", "type": "string" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_revision": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "idempotency_key": { "type": "string" }, "policy_decision_id": { "type": "string" }, "policy_digest": { "type": "string" }, "policy_revision": { "type": "string" }, "principal": { "description": "Serving authority for the native owner ledger. The authenticated\ncaller is carried separately in `caller_principal`.", "type": "string" }, "purpose_id": { "type": "string" }, "request_id": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" }, "trace_id": { "type": [ "string", "null" ] } }, "required": [ "request_id", "principal", "caller_principal", "attempt_nonce", "tenant_id", "actor_scope", "purpose_id", "policy_revision", "policy_digest", "policy_decision_id", "idempotency_key", "created_at_ms" ], "type": "object" }, "ResDef_Query_AgentLibraryMutationKind": { "description": "Mutation kind carried by an Agent Library outbox event.", "enum": [ "publish", "retire" ], "type": "string" }, "ResDef_Query_AgentLibraryOp": { "description": "Typed Agent Library wire operations. The persistence owner remains the\nsingle implementation for every operation; this enum only carries the\nauthenticated request across the existing engine dispatch boundary.", "oneOf": [ { "additionalProperties": false, "description": "Boxed: a publish request carries the whole entry draft and is far\nlarger than every other operation, so an unboxed variant would make\neach `AgentLibraryOp` -- and through it each `Method` -- pay that\nsize. `Box` is transparent to serde, so the wire form is unchanged.", "properties": { "operation": { "const": "publish", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryPublishRequest" } }, "required": [ "operation", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "operation": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryRetireRequest" } }, "required": [ "operation", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "operation": { "const": "current", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "operation", "tenant_id", "agent_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "operation": { "const": "history", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "operation", "tenant_id", "agent_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "operation": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryStatusRequest" } }, "required": [ "operation", "request" ], "type": "object" } ] }, "ResDef_Query_AgentLibraryPublishRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "entry": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryEntryDraft" } }, "required": [ "context", "entry" ], "type": "object" }, "ResDef_Query_AgentLibraryRetireRequest": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" } }, "required": [ "context", "agent_id" ], "type": "object" }, "ResDef_Query_AgentLibraryStatusRequest": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationKind" } }, "required": [ "context", "agent_id", "kind" ], "type": "object" }, "ResDef_Query_AgentModelSettings": { "additionalProperties": false, "description": "Bounded model-invocation settings (pydantic-ai `ModelSettings`).\n\nEvery continuous setting is an INTEGER in thousandths, never a float. These\nvalues are hashed into `definition_digest`, and floats have no canonical\nbyte form for that purpose: `NaN != NaN` breaks `Eq`, `0.0` and `-0.0` are\nequal but hash differently, and the same value can format differently across\nplatforms and serde versions. A reproducible definition digest cannot be\nbuilt on any of that, so the wire type carries milli-units and the harness\ndivides by 1000 when it constructs the model settings.", "properties": { "max_output_tokens": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "parallel_tool_calls": { "type": [ "boolean", "null" ] }, "request_timeout_ms": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "seed": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "stop_sequences": { "items": { "type": "string" }, "type": "array" }, "temperature_milli": { "description": "Sampling temperature in thousandths (`700` = 0.7).", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "top_p_milli": { "description": "Nucleus-sampling mass in thousandths (`950` = 0.95).", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "stop_sequences" ], "type": "object" }, "ResDef_Query_AgentOutputMode": { "description": "How the model is asked to produce the agent's structured output.\n\nMirrors pydantic-ai's `ToolOutput` / `NativeOutput` / `PromptedOutput`.", "oneOf": [ { "const": "text", "description": "Free text \u2014 pydantic-ai's default `output_type=str`.", "type": "string" }, { "const": "tool", "description": "A synthesized tool call carries the structured result.", "type": "string" }, { "const": "native", "description": "The provider's own structured-output mode.", "type": "string" }, { "const": "prompted", "description": "The schema is described in the prompt and parsed from the reply.", "type": "string" } ] }, "ResDef_Query_AgentPromptMode": { "description": "Whether the system prompt is fixed at publish time or resolved per run.\n\npydantic-ai distinguishes `Agent(system_prompt=\u2026)` from `@agent.system_prompt`\n/ `@agent.instructions`. The distinction is durable identity, not style: a\nstatic prompt's digest pins the prompt itself, while a dynamic prompt's\ndigest can only pin the FUNCTION that produces it. A dynamic prompt must\ntherefore be digest-bound again at resolution time, and a reader that cannot\ntell the two apart cannot know whether `system_prompt_digest` covers the text\nthe model actually saw.", "enum": [ "static", "dynamic" ], "type": "string" }, "ResDef_Query_AgentRetryPolicy": { "additionalProperties": false, "description": "Retry budgets that belong to the agent definition, not to one delegation.\n\nDistinct from `KgDelegateRequest::max_attempts`, which is how many times the\nENGINE will re-admit the work item. These are how many times the agent will\nask the model again within a single run after a tool error or an output that\nfails validation (pydantic-ai `retries` / `output_retries`).", "properties": { "model_retries": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "output_retries": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "model_retries", "output_retries" ], "type": "object" }, "ResDef_Query_AgentRole": { "description": "Role of an agent in the system hierarchy.", "oneOf": [ { "const": "System", "description": "System-level (can do anything).", "type": "string" }, { "additionalProperties": false, "description": "Manager agent with subordinates.", "properties": { "Manager": { "properties": { "subordinates": { "items": { "type": "string" }, "type": "array" } }, "required": [ "subordinates" ], "type": "object" } }, "required": [ "Manager" ], "type": "object" }, { "const": "Agent", "description": "Regular agent.", "type": "string" } ] }, "ResDef_Query_AgentRuntimeContract": { "additionalProperties": false, "description": "The part of an agent's definition that governs how it RUNS, as opposed to\nwhich components it is assembled from.\n\nGrouped into one nested type rather than flattened into\n[`AgentLibraryEntryDraft`] deliberately. The draft, the entry, `create`,\n`retire` and `as_draft` each restate every field, so a flat shape would pay\nfive edits per field and grow a 23-field struct to 35 \u2014 the exact sprawl\nRF-ADR-008 exists to avoid. It also names a real concept: two agents with\nthe same components but different output contracts are different agents.\n\nEvery field participates in `definition_digest`.", "properties": { "deps_contract": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "description": "The agent's typed input (pydantic-ai `deps_type`). `None` = no deps." }, "model_settings": { "$ref": "#/components/schemas/ResDef_Query_AgentModelSettings" }, "output_contract": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "description": "The agent's typed output (pydantic-ai `output_type`). `None` with\n[`AgentOutputMode::Text`] is the plain-text default." }, "output_mode": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_AgentOutputMode" }, { "type": "null" } ] }, "output_validator_refs": { "description": "`@agent.output_validator` functions, by reference.", "items": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "type": "array" }, "prompt_mode": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_AgentPromptMode" }, { "type": "null" } ], "description": "`None` is read as [`AgentPromptMode::Static`]." }, "retry_policy": { "$ref": "#/components/schemas/ResDef_Query_AgentRetryPolicy" }, "toolset_refs": { "description": "Grouped tool sources \u2014 a `FunctionToolset`, an MCP server, a skill pack.\n\n`tools` on the entry is the flattened resolution of these WHERE THE\nPUBLISHER CAN FLATTEN THEM, so a reader that only cares which individual\ntools exist need not walk the grouping. The engine does not, and cannot,\nenforce that: a toolset is an L1 reference, its contents live in the\nsystem that owns it, and resolving an MCP server's tool list is not\nsomething this contract can do at publish time. Treating the flattening\nas an invariant would therefore be asserting a property nothing checks.\n\nSo the capability proof covers BOTH lists instead \u2014 see\n[`AgentLibraryEntry::tool_surface_digest`]. An agent that names a toolset\nit did not flatten still has that toolset inside the digest delegation\nadmits, rather than a proof over a strict subset of what it can call.", "items": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "type": "array" }, "usage_limits": { "$ref": "#/components/schemas/ResDef_Query_AgentUsageLimits" } }, "required": [ "output_validator_refs", "toolset_refs", "model_settings", "retry_policy", "usage_limits" ], "type": "object" }, "ResDef_Query_AgentTemplateDraft": { "additionalProperties": false, "description": "Caller-supplied inputs for one template revision.", "properties": { "actor_scope": { "type": "string" }, "base": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryEntryDraft", "description": "The default agent. Valid and runnable on its own." }, "params": { "items": { "$ref": "#/components/schemas/ResDef_Query_TemplateParam" }, "type": "array" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" }, "version": { "type": "string" } }, "required": [ "template_id", "version", "base", "params", "tenant_id", "actor_scope", "purpose_id", "policy_digest" ], "type": "object" }, "ResDef_Query_AgentTemplateInstantiateRequest": { "additionalProperties": false, "description": "Bind a template's parameters and get back an ordinary agent draft.\n\nA READ: it resolves durable state and computes, but commits nothing. The\ncaller publishes the returned draft through `AgentLibrary::Publish` exactly\nas it would a hand-authored one -- which is the whole point of the design,\nand the reason there is no template-aware branch in admission or delegation.\n\n`entry_revision` pins which template revision to bind. `None` means the\nhead. Pinning matters because [`TemplateInstanceRef`] records a revision:\nreproducing an existing instance means binding the revision it named, not\nwhatever the head has since become.", "properties": { "agent_id": { "description": "The instance's own agent id. Supplied, not derived -- see\n[`AgentTemplateEntry::instantiate`].", "type": "string" }, "bindings": { "additionalProperties": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "default": {}, "type": "object" }, "entry_revision": { "default": null, "description": "The revision to bind, or the head when absent.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "template_id", "agent_id" ], "type": "object" }, "ResDef_Query_AgentTemplateMutationKind": { "description": "Which durable mutation a template operation performs.", "enum": [ "publish", "retire" ], "type": "string" }, "ResDef_Query_AgentTemplateOp": { "description": "Typed template wire operations.", "oneOf": [ { "description": "Boxed for the same reason as the other three layers: a publish request\ncarries a whole draft -- and this one embeds an entire\n[`AgentLibraryEntryDraft`] as its base, so it is the largest of the\nfour -- and would otherwise set the size of every `Method`. `Box` is\ntransparent to serde, so the wire form is unchanged.", "properties": { "op": { "const": "publish", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentTemplatePublishRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "op": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentTemplateRetireRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "properties": { "op": { "const": "current", "type": "string" }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "template_id" ], "type": "object" }, { "properties": { "op": { "const": "history", "type": "string" }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "template_id" ], "type": "object" }, { "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentTemplateStatusRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "description": "Bind parameters and return an ordinary agent draft -- the query this\nlayer exists for. A read: nothing is committed until the caller\npublishes the draft through the agent library.\n\nNOT boxed, unlike `Publish`: this request carries only ids and a\nbounded binding map, so it is smaller than `Status`'s mutation context\nand boxing it would buy an allocation on a read path for nothing.", "properties": { "op": { "const": "instantiate", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AgentTemplateInstantiateRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ResDef_Query_AgentTemplatePublishRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext", "description": "Shared with the other three layers: templates are published into the\nsame owner as the components, agents and graphs they are built from, so\nthey share its mutation context rather than growing a parallel copy of\nit." }, "template": { "$ref": "#/components/schemas/ResDef_Query_AgentTemplateDraft" } }, "required": [ "context", "template" ], "type": "object" }, "ResDef_Query_AgentTemplateRetireRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "template_id": { "type": "string" } }, "required": [ "context", "template_id" ], "type": "object" }, "ResDef_Query_AgentTemplateStatusRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentTemplateMutationKind" }, "template_id": { "type": "string" } }, "required": [ "context", "template_id", "kind" ], "type": "object" }, "ResDef_Query_AgentUsageLimits": { "additionalProperties": false, "description": "Per-run consumption ceilings (pydantic-ai `UsageLimits`).\n\n`None` means \"the engine's bounded default\", never \"unlimited\" \u2014 an agent\ndefinition cannot opt out of a ceiling, only decline to tighten it.", "properties": { "input_tokens_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_tokens_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "request_limit": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "tool_calls_limit": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "ResDef_Query_Algorithm": { "description": "The solver algorithm that produced a certificate.", "oneOf": [ { "const": "depth_first_dual_ascent", "description": "Propagation, greedy incumbent, depth-first branch-and-bound with a\ndual-ascent Lagrangian bound, pre-order leaf-bound certificate.", "type": "string" } ] }, "ResDef_Query_AnomalyAlgorithm": { "description": "Which detector `MineAnomaly` runs (CONCEPT:EG-KG.mining.isolation-forest).", "enum": [ "zscore", "isoforest", "lof", "ocsvm" ], "type": "string" }, "ResDef_Query_AsrOp": { "description": "`Method::Asr { op }`'s request shape. `audio_wav` carries the actual PCM\nbytes over the wire (MessagePack handles binary natively \u2014 no base64\ninflation); `model_path`/`model_sha256` are a caller-resolved,\nalready-verified model reference (GOC-36 owns acquisition; this crate\nnever resolves a bare model name into a path or URL).", "oneOf": [ { "additionalProperties": false, "properties": { "TranscribeFile": { "properties": { "audio_wav": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "language": { "default": null, "type": [ "string", "null" ] }, "model_path": { "type": "string" }, "model_sha256": { "type": "string" }, "translate": { "default": false, "type": "boolean" }, "window_ms": { "default": 0, "description": "Bounded streaming window, milliseconds. `0`/absent \u21d2 handler\ndefault (30_000 \u2014 see `handlers::asr`).", "format": "uint32", "minimum": 0, "type": "integer" }, "word_timing": { "default": false, "type": "boolean" } }, "required": [ "model_path", "model_sha256", "audio_wav" ], "type": "object" } }, "required": [ "TranscribeFile" ], "type": "object" } ] }, "ResDef_Query_AssemblyConstraints": { "additionalProperties": false, "description": "Non-capability requirements the assembly must satisfy.", "properties": { "context_budget_tokens": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "cost_budget": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_CostBudget" }, { "type": "null" } ], "default": null }, "max_components": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "max_p95_latency_ms": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "modalities_in": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_16", "default": [] }, "modalities_out": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_16", "default": [] }, "require_structured_output": { "default": false, "type": "boolean" }, "require_tools": { "default": false, "type": "boolean" } }, "type": "object" }, "ResDef_Query_AssemblyRequest": { "additionalProperties": false, "description": "One assembly question.", "properties": { "candidates": { "$ref": "#/components/schemas/ResDef_Query_LibraryCandidateScope" }, "policy": { "$ref": "#/components/schemas/ResDef_Query_DecisionPolicyRef" }, "requirements": { "$ref": "#/components/schemas/ResDef_Query_AssemblyRequirements" }, "solver": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SolverBudget" }, { "type": "null" } ], "default": null }, "templates": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_AgentGraphEntryRef_8", "default": [], "description": "Candidate graph templates. Empty asks for a one-agent graph." }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "requirements", "candidates", "policy" ], "type": "object" }, "ResDef_Query_AssemblyRequirements": { "additionalProperties": false, "description": "What the assembled agent has to be able to do.", "properties": { "capabilities": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_32", "default": [], "description": "Native `eg:capability/*` IRIs." }, "constraints": { "$ref": "#/components/schemas/ResDef_Query_AssemblyConstraints", "default": { "context_budget_tokens": null, "cost_budget": null, "max_components": null, "max_p95_latency_ms": null, "modalities_in": [], "modalities_out": [], "require_structured_output": false, "require_tools": false } }, "denies": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64", "default": [], "description": "Component ids that must not be selected." }, "pins": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_ComponentDependency_64", "default": [] }, "task_mappings": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_ClaimedTaskMapping_32", "default": [] }, "tasks": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_32", "default": [], "description": "Native `eg:task/*` IRIs." }, "unmapped_task_digests": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_32", "default": [], "description": "Digests of free text no mapping covered. Each becomes an abstention\nreason rather than a silently dropped requirement." } }, "type": "object" }, "ResDef_Query_AuditDraw": { "additionalProperties": false, "description": "One audit-sampling draw. An acted decision is sampled into human review\nwith a KNOWN inclusion probability, so review results re-enter calibration\nweighted by its inverse and the review queue carries no selection bias.", "properties": { "inclusion_probability": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, "sampled": { "type": "boolean" } }, "required": [ "inclusion_probability", "sampled" ], "type": "object" }, "ResDef_Query_AuthorityContext": { "additionalProperties": false, "description": "Complete attempt-specific authority context. Its digest intentionally binds\nrequest/trace identity, timestamps, and nonce and therefore MUST NOT be used\nas the stable operation replay identity.", "properties": { "actor": { "type": "string" }, "audience": { "type": "string" }, "authority_scope": { "$ref": "#/components/schemas/ResDef_Query_AuthorityScope" }, "catalog_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "context_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "expires_at": { "format": "int64", "type": "integer" }, "idempotency_key": { "type": [ "string", "null" ] }, "ingress_surface": { "type": "string" }, "issued_at": { "format": "int64", "type": "integer" }, "nonce": { "$ref": "#/components/schemas/ResDef_Query_Nonce" }, "operation": { "type": "string" }, "policy_decision_id": { "type": "string" }, "policy_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "policy_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_revision": { "type": "string" }, "protocol_id": { "type": "string" }, "purpose_kind": { "type": "string" }, "purpose_resource": { "type": [ "string", "null" ] }, "request_id": { "type": "string" }, "schema_version": { "type": "string" }, "tenant": { "type": "string" }, "trace_id": { "type": "string" } }, "required": [ "schema_version", "protocol_id", "catalog_digest", "request_id", "trace_id", "ingress_surface", "actor", "audience", "tenant", "authority_scope", "purpose_kind", "operation", "policy_revision", "policy_epoch", "policy_decision_id", "policy_digest", "issued_at", "expires_at", "nonce", "context_digest" ], "type": "object" }, "ResDef_Query_AuthorityPolicyWire": { "description": "Wire mirror of `eg_epistemic::AuthorityPolicy` \u2014 the confidence-weighting policy an\n`EpistemicStatus` was computed under (\"under whose authority\").", "properties": { "attack_multiplier": { "format": "double", "type": "number" }, "prior_strength": { "format": "double", "type": "number" }, "source_reliability": { "format": "double", "type": "number" } }, "required": [ "source_reliability", "attack_multiplier", "prior_strength" ], "type": "object" }, "ResDef_Query_AuthorityScope": { "additionalProperties": false, "description": "A materialized scope derived from verified authority. Parent scopes must be\nsorted and unique so equal authority never has multiple byte spellings.", "properties": { "graph_incarnation": { "type": [ "string", "null" ] }, "kind": { "type": "string" }, "parent_scope_ids": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "scope_id": { "type": "string" }, "tenant": { "type": [ "string", "null" ] } }, "required": [ "kind", "scope_id", "parent_scope_ids" ], "type": "object" }, "ResDef_Query_BlobReference": { "properties": { "blob_id": { "type": "string" }, "digest": { "type": "string" }, "digest_algorithm": { "type": "string" }, "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "media_type": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ResDef_Query_MaterialOperation" } }, "required": [ "blob_id", "operation", "digest_algorithm", "digest", "media_type", "length" ], "type": "object" }, "ResDef_Query_BoundProof": { "description": "The lower-bound evidence a certificate carries.", "oneOf": [ { "additionalProperties": false, "description": "A complete pre-order search tree.", "properties": { "tree": { "additionalProperties": false, "properties": { "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Query_ProofNode" }, "type": "array" } }, "required": [ "nodes" ], "type": "object" } }, "required": [ "tree" ], "type": "object" }, { "additionalProperties": false, "description": "Only the root dual (the tree exceeded the certificate leaf limit).", "properties": { "root": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Query_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "root" ], "type": "object" } ] }, "ResDef_Query_BoundedVec_AbstainReason_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_AbstainReason" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_AgentComponentKind_16": { "items": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentKind" }, "maxItems": 16, "type": "array" }, "ResDef_Query_BoundedVec_AgentGraphEntryRef_8": { "items": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphEntryRef" }, "maxItems": 8, "type": "array" }, "ResDef_Query_BoundedVec_BoundedVec_SqlSourceCell_256_1024": { "items": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_SqlSourceCell_256" }, "maxItems": 1024, "type": "array" }, "ResDef_Query_BoundedVec_CandidateFacts_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_CandidateFacts" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_ClaimedTaskMapping_32": { "items": { "$ref": "#/components/schemas/ResDef_Query_ClaimedTaskMapping" }, "maxItems": 32, "type": "array" }, "ResDef_Query_BoundedVec_ComponentDependency_256": { "items": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "maxItems": 256, "type": "array" }, "ResDef_Query_BoundedVec_ComponentDependency_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_CoverageDerivation_32": { "items": { "$ref": "#/components/schemas/ResDef_Query_CoverageDerivation" }, "maxItems": 32, "type": "array" }, "ResDef_Query_BoundedVec_DerivationEdge_16": { "items": { "$ref": "#/components/schemas/ResDef_Query_DerivationEdge" }, "maxItems": 16, "type": "array" }, "ResDef_Query_BoundedVec_Digest256_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_Elimination_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_Elimination" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_LabelledItem_4096": { "items": { "$ref": "#/components/schemas/ResDef_Query_LabelledItem" }, "maxItems": 4096, "type": "array" }, "ResDef_Query_BoundedVec_ObjectiveLevelKind_8": { "items": { "$ref": "#/components/schemas/ResDef_Query_ObjectiveLevelKind" }, "maxItems": 8, "type": "array" }, "ResDef_Query_BoundedVec_OpeEstimatorKind_8": { "items": { "$ref": "#/components/schemas/ResDef_Query_OpeEstimatorKind" }, "maxItems": 8, "type": "array" }, "ResDef_Query_BoundedVec_PackEntry_1024": { "items": { "$ref": "#/components/schemas/ResDef_Query_PackEntry" }, "maxItems": 1024, "type": "array" }, "ResDef_Query_BoundedVec_PackRef_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_PackRef" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_PremiseRef_1024": { "items": { "$ref": "#/components/schemas/ResDef_Query_PremiseRef" }, "maxItems": 1024, "type": "array" }, "ResDef_Query_BoundedVec_PremiseRef_32": { "items": { "$ref": "#/components/schemas/ResDef_Query_PremiseRef" }, "maxItems": 32, "type": "array" }, "ResDef_Query_BoundedVec_QuantisedValue_32": { "items": { "$ref": "#/components/schemas/ResDef_Query_QuantisedValue" }, "maxItems": 32, "type": "array" }, "ResDef_Query_BoundedVec_ScoredOption_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_ScoredOption" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_SlotAssignment_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_SlotAssignment" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_SourceEntityRef_16384": { "items": { "$ref": "#/components/schemas/ResDef_Query_SourceEntityRef" }, "maxItems": 16384, "type": "array" }, "ResDef_Query_BoundedVec_SourceRecord_1024": { "items": { "$ref": "#/components/schemas/ResDef_Query_SourceRecord" }, "maxItems": 1024, "type": "array" }, "ResDef_Query_BoundedVec_SourceRelationship_4096": { "items": { "$ref": "#/components/schemas/ResDef_Query_SourceRelationship" }, "maxItems": 4096, "type": "array" }, "ResDef_Query_BoundedVec_SourceWithdrawal_1024": { "items": { "$ref": "#/components/schemas/ResDef_Query_SourceWithdrawal" }, "maxItems": 1024, "type": "array" }, "ResDef_Query_BoundedVec_SqlSourceCell_256": { "items": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceCell" }, "maxItems": 256, "type": "array" }, "ResDef_Query_BoundedVec_StatisticalDecisionRecord_256": { "items": { "$ref": "#/components/schemas/ResDef_Query_StatisticalDecisionRecord" }, "maxItems": 256, "type": "array" }, "ResDef_Query_BoundedVec_TemplateFacts_8": { "items": { "$ref": "#/components/schemas/ResDef_Query_TemplateFacts" }, "maxItems": 8, "type": "array" }, "ResDef_Query_BoundedVec_TypedParam_16": { "items": { "$ref": "#/components/schemas/ResDef_Query_TypedParam" }, "maxItems": 16, "type": "array" }, "ResDef_Query_BoundedVec_TypedParam_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_TypedParam" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_UnitRationalWire_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_WeightedLevel_8": { "items": { "$ref": "#/components/schemas/ResDef_Query_WeightedLevel" }, "maxItems": 8, "type": "array" }, "ResDef_Query_BoundedVec_WhyNot_64": { "items": { "$ref": "#/components/schemas/ResDef_Query_WhyNot" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_float_4096": { "items": { "format": "float", "type": "number" }, "maxItems": 4096, "type": "array" }, "ResDef_Query_BoundedVec_int64_2048": { "items": { "format": "int64", "type": "integer" }, "maxItems": 2048, "type": "array" }, "ResDef_Query_BoundedVec_string_1024": { "items": { "type": "string" }, "maxItems": 1024, "type": "array" }, "ResDef_Query_BoundedVec_string_16": { "items": { "type": "string" }, "maxItems": 16, "type": "array" }, "ResDef_Query_BoundedVec_string_256": { "items": { "type": "string" }, "maxItems": 256, "type": "array" }, "ResDef_Query_BoundedVec_string_32": { "items": { "type": "string" }, "maxItems": 32, "type": "array" }, "ResDef_Query_BoundedVec_string_64": { "items": { "type": "string" }, "maxItems": 64, "type": "array" }, "ResDef_Query_BoundedVec_string_8": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "ResDef_Query_CalibrationMethod": { "description": "How the scores were calibrated, if at all.", "enum": [ "temperature", "vector", "dirichlet", "isotonic", "none" ], "type": "string" }, "ResDef_Query_CalibrationStatement": { "additionalProperties": false, "description": "The calibration behind a decision's probabilities.", "properties": { "alpha": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, { "type": "null" } ], "default": null }, "coverage_lower": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, { "type": "null" } ], "default": null }, "coverage_upper": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, { "type": "null" } ], "default": null }, "method": { "$ref": "#/components/schemas/ResDef_Query_CalibrationMethod" }, "n_calibration": { "format": "uint64", "minimum": 0, "type": "integer" }, "synthetic": { "description": "True when the calibration set was synthetic.", "type": "boolean" } }, "required": [ "method", "n_calibration", "synthetic" ], "type": "object" }, "ResDef_Query_CalibrationWire": { "description": "Wire mirror of `eg_epistemic::Calibration` (EPI-P3-3) \u2014 the calibrated interval\nbacking a `RetrievalCandidateWire`'s evidence-quality score, when the candidate\nhas one.", "properties": { "evidence_count": { "format": "uint", "minimum": 0, "type": "integer" }, "interval": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "double", "type": "number" }, { "format": "double", "type": "number" } ], "type": "array" }, "level": { "format": "double", "type": "number" } }, "required": [ "interval", "level", "evidence_count" ], "type": "object" }, "ResDef_Query_CandidateFacts": { "additionalProperties": false, "description": "Everything known about one candidate at decision time.", "properties": { "classification": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "component_id": { "type": "string" }, "declared_capabilities": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fact_premises": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_PremiseRef_32", "description": "The premises the facts above rest on." }, "facts": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentFacts" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentKind" }, "lifecycle": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryLifecycle" }, "required_capabilities": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "requires": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_ComponentDependency_256" } }, "required": [ "component_id", "kind", "entry_revision", "definition_digest", "lifecycle", "classification", "required_capabilities", "declared_capabilities", "requires", "facts", "fact_premises" ], "type": "object" }, "ResDef_Query_CandidateSource": { "description": "Where the options come from.\nNot `Eq`: the cross-modal plan carries floats, so equality on a graph-sourced\ncandidate scope is partial, exactly as it is on `Method` itself.", "oneOf": [ { "additionalProperties": false, "description": "A tenant-bound agent library scope.", "properties": { "scope": { "$ref": "#/components/schemas/ResDef_Query_LibraryCandidateScope" }, "source": { "const": "agent_library", "type": "string" } }, "required": [ "source", "scope" ], "type": "object" }, { "additionalProperties": false, "description": "An RLS-filtered cross-modal plan over one named graph -- the same\npublic plan type `Method::UnifiedQuery` accepts, so there is one plan\nvocabulary. The plan only names the candidate id set; it may not rank\nor truncate before visibility, because a top-k taken over invisible\nrows would move visible ones.", "properties": { "graph": { "type": "string" }, "plan": { "$ref": "#/components/schemas/ResDef_Query_Plan" }, "source": { "const": "graph", "type": "string" } }, "required": [ "source", "graph", "plan" ], "type": "object" } ] }, "ResDef_Query_CandidateSourceRecord": { "description": "Where the candidates came from.", "oneOf": [ { "additionalProperties": false, "description": "One tenant-bound agent library snapshot.", "properties": { "classification_under": { "default": null, "type": [ "string", "null" ] }, "kinds": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_AgentComponentKind_16" }, "source": { "const": "agent_library", "type": "string" } }, "required": [ "source", "kinds" ], "type": "object" }, { "additionalProperties": false, "description": "An RLS-filtered graph plan, pinned by its plan digest.", "properties": { "plan_digest": { "type": "string" }, "source": { "const": "graph", "type": "string" } }, "required": [ "source", "plan_digest" ], "type": "object" } ] }, "ResDef_Query_CanonicalTextAssetRef": { "additionalProperties": false, "properties": { "asset_id": { "type": "string" }, "asset_revision": { "type": "string" }, "content_digest": { "type": "string" } }, "required": [ "asset_id", "asset_revision", "content_digest" ], "type": "object" }, "ResDef_Query_CapacityAcquireRequest": { "additionalProperties": false, "properties": { "cost_budget_micros": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "demands": { "items": { "$ref": "#/components/schemas/ResDef_Query_CapacityDemand" }, "type": "array" }, "idempotency_key": { "type": "string" }, "lease_id": { "type": [ "string", "null" ] }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_digest": { "description": "Opaque owner digest. The server compares this to the authenticated\nprincipal/agent binding; callers cannot choose a different owner.", "type": "string" }, "priority": { "$ref": "#/components/schemas/ResDef_Query_LeasePriority" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_NativeControlSchemaVersion" }, "tenant_ref": { "type": "string" }, "token_budget": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_digest", "idempotency_key", "priority", "demands", "ttl_ms", "now_ms" ], "type": "object" }, "ResDef_Query_CapacityCell": { "additionalProperties": false, "description": "A durable capacity pool. `capacity` is the cell's total admittable amount at\nits current `epoch`; `reserved_floor` is the slice never available to\n`BackgroundIngestion` (invariant: \"Interactive and orchestration floors are\nreserved; background uses spare capacity but cannot starve a tenant\nindefinitely\").", "properties": { "capacity": { "format": "uint64", "minimum": 0, "type": "integer" }, "cell_id": { "type": "string" }, "epoch": { "description": "Monotonic authority epoch (GOC-03 fencing concept, vendored \u2014 see module\ndoc). Bumped on cell-authority failover/repartition; an acquire/renew\ncarrying an epoch below this is a stale-authority rejection, never a\nbest-effort read of a foreign shape.", "format": "uint64", "minimum": 0, "type": "integer" }, "parent_id": { "type": [ "string", "null" ] }, "policy_digest": { "description": "sha256 digest of the policy/catalog/model snapshot this cell was\nprovisioned under (checked at every hop per the lane doc's \"Security and\nprivacy\" section); opaque here, verified upstream.", "type": "string" }, "reserved_floor": { "format": "uint64", "minimum": 0, "type": "integer" }, "resource_class": { "$ref": "#/components/schemas/ResDef_Query_CapacityResourceClass" }, "updated_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cell_id", "resource_class", "capacity", "reserved_floor", "epoch", "policy_digest", "updated_at_ms" ], "type": "object" }, "ResDef_Query_CapacityCellUpdateRequest": { "additionalProperties": false, "properties": { "cell": { "$ref": "#/components/schemas/ResDef_Query_CapacityCell" }, "expected_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_NativeControlSchemaVersion" } }, "required": [ "schema_version", "cell", "now_ms" ], "type": "object" }, "ResDef_Query_CapacityDemand": { "additionalProperties": false, "properties": { "amount": { "format": "uint64", "minimum": 0, "type": "integer" }, "cell_id": { "type": "string" }, "resource_class": { "$ref": "#/components/schemas/ResDef_Query_CapacityResourceClass" } }, "required": [ "cell_id", "resource_class", "amount" ], "type": "object" }, "ResDef_Query_CapacityLeaseFence": { "additionalProperties": false, "properties": { "fence_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_id": { "type": "string" } }, "required": [ "lease_id", "lease_epoch", "fence_token" ], "type": "object" }, "ResDef_Query_CapacityLeaseMutationRequest": { "additionalProperties": false, "properties": { "idempotency_key": { "type": [ "string", "null" ] }, "leases": { "items": { "$ref": "#/components/schemas/ResDef_Query_CapacityLeaseFence" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_digest": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_NativeControlSchemaVersion" }, "tenant_ref": { "type": "string" }, "ttl_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "schema_version", "tenant_ref", "owner_digest", "leases", "now_ms" ], "type": "object" }, "ResDef_Query_CapacityReclaimRequest": { "additionalProperties": false, "properties": { "cell_id": { "type": [ "string", "null" ] }, "cursor": { "type": [ "string", "null" ] }, "max_count": { "format": "uint32", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_NativeControlSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "max_count", "now_ms" ], "type": "object" }, "ResDef_Query_CapacityResourceClass": { "description": "The resource a `CapacityCell` doles out. Mirrors the lane doc's \"CPU/LLM/GPU\ncapacity\" plus the existing AU gates this composes with\n(`resource_priority.py`'s shared-LLM gate, `worker_scheduler.py`'s host\nworker pool, `gpu_group_budget.py`'s per-GPU/model floors).", "oneOf": [ { "const": "llm_generator", "description": "Shared LLM generator admission slots (composes with `resource_priority.py`).", "type": "string" }, { "const": "llm_embedding", "description": "A separate embedding endpoint's admission slots \u2014 never contends with\n`LlmGenerator` (mirrors `resource_priority.py`'s separate embedding gate key).", "type": "string" }, { "const": "gpu", "description": "GPU compute units (composes with `gpu_group_budget.py`).", "type": "string" }, { "const": "worker", "description": "Host worker pool slots (composes with `worker_scheduler.py`).", "type": "string" }, { "const": "cpu", "description": "CPU-bound compute slots.", "type": "string" }, { "const": "broker", "description": "Message-broker/engine dispatch admission slots.", "type": "string" } ] }, "ResDef_Query_CapacityStatusRequest": { "additionalProperties": false, "properties": { "cell_id": { "type": [ "string", "null" ] }, "cursor": { "type": [ "string", "null" ] }, "lease_id": { "type": [ "string", "null" ] }, "max_count": { "format": "uint32", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_NativeControlSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "max_count" ], "type": "object" }, "ResDef_Query_CasWorkItemMetadataLeaseFence": { "additionalProperties": false, "description": "The live lease tuple a lease-holding caller (checkpoint / request-input)\nfences on, exactly like `RenewWorkItemLease`. Omit `expected_lease` on\nthe request entirely for a lease-less external/scheduler caller\n(submit-input / set-priority), which fences on `expected_status` (and,\nfor submit-input, the tenant + the field's own expected prior value)\ninstead.", "properties": { "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "worker_ref": { "type": "string" } }, "required": [ "worker_ref", "lease_epoch", "fencing_token" ], "type": "object" }, "ResDef_Query_CasWorkItemMetadataRequest": { "additionalProperties": false, "description": "Atomic single-field compare-and-set on one WorkItem's scheduling\nmetadata. Exactly one field-pair \u2014 (`expected_checkpoint_id`,\n`set_checkpoint_id`) xor (`expected_metadata_msgpack`,\n`set_metadata_msgpack`) xor (`expected_prio_bucket`, `set_prio_bucket`)\n\u2014 must be present; the engine rejects a request naming zero or more than\none. `expected_status` must be non-empty: the caller always names the\nexact status set the row must currently be in.", "properties": { "expected_checkpoint_id": { "type": [ "string", "null" ] }, "expected_lease": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_CasWorkItemMetadataLeaseFence" }, { "type": "null" } ] }, "expected_metadata_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": [ "array", "null" ] }, "expected_prio_bucket": { "format": "int64", "type": [ "integer", "null" ] }, "expected_status": { "items": { "type": "string" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_CasWorkItemMetadataRequestSchemaVersion" }, "set_checkpoint_id": { "type": [ "string", "null" ] }, "set_metadata_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": [ "array", "null" ] }, "set_prio_bucket": { "format": "int64", "type": [ "integer", "null" ] }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "expected_status", "now_ms" ], "type": "object" }, "ResDef_Query_CasWorkItemMetadataRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_CausalCounterfactualResult": { "description": "Materialized result of a `Method::CausalCounterfactual` run (EPI-P3-6): one\nPOINT value per variable \u2014 not a calibrated distribution, since Pearl's\npoint-counterfactual is deterministic given the abduced exogenous noise \u2014 in\nthe SAME order as the request's `variables` list. Returned via\n`ResultPayload::raw`.", "properties": { "values": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" } }, "required": [ "values" ], "type": "object" }, "ResDef_Query_CausalEstimateResult": { "description": "Materialized result of a `Method::CausalEstimate` run: one estimate per\nvariable, in the SAME order as the request's `variables` list. Returned via\n`ResultPayload::raw`.", "properties": { "estimates": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "$ref": "#/components/schemas/ResDef_Query_CausalEstimateWire" } ], "type": "array" }, "type": "array" } }, "required": [ "estimates" ], "type": "object" }, "ResDef_Query_CausalEstimateWire": { "description": "Wire mirror of `eg_epistemic::CausalEstimate` (EPI-P3-3) \u2014 a calibrated mean/\nvariance/credible-interval result of one causal query for one variable.", "properties": { "interval": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "double", "type": "number" }, { "format": "double", "type": "number" } ], "type": "array" }, "level": { "format": "double", "type": "number" }, "mean": { "format": "double", "type": "number" }, "variance": { "format": "double", "type": "number" } }, "required": [ "mean", "variance", "interval", "level" ], "type": "object" }, "ResDef_Query_CausalQueryModeWire": { "description": "Which of `eg_epistemic::CausalGraph`'s two non-counterfactual queries\n`Method::CausalEstimate::do_values` feeds (EPI-P3-6).", "enum": [ "Intervene", "Observe" ], "type": "string" }, "ResDef_Query_CepAttrPredSpec": { "description": "STREAM \u2014 a per-event attribute predicate for a CEP matcher (CONCEPT:EG-KG.query.pipelined-execution). Mirrors\neg-stream's `AttrPredicate`, but defined HERE (pure serde, no eg-stream dep) so the\nwire stays Pi-safe; the executor maps it to eg-stream's enum behind eg-plan's\n`stream` gate.", "oneOf": [ { "additionalProperties": false, "properties": { "Eq": { "properties": { "field": { "type": "string" }, "value": true }, "required": [ "field", "value" ], "type": "object" } }, "required": [ "Eq" ], "type": "object" }, { "additionalProperties": false, "properties": { "Gt": { "properties": { "field": { "type": "string" }, "value": { "format": "double", "type": "number" } }, "required": [ "field", "value" ], "type": "object" } }, "required": [ "Gt" ], "type": "object" }, { "additionalProperties": false, "properties": { "Lt": { "properties": { "field": { "type": "string" }, "value": { "format": "double", "type": "number" } }, "required": [ "field", "value" ], "type": "object" } }, "required": [ "Lt" ], "type": "object" }, { "additionalProperties": false, "properties": { "Exists": { "properties": { "field": { "type": "string" } }, "required": [ "field" ], "type": "object" } }, "required": [ "Exists" ], "type": "object" } ] }, "ResDef_Query_CepMatcherSpec": { "description": "STREAM \u2014 one event matcher: an optional event `key` + attribute predicates that ALL\nmust hold (CONCEPT:EG-KG.query.pipelined-execution). Mirrors eg-stream's `EventMatcher`; pure serde here.", "properties": { "key": { "default": null, "type": [ "string", "null" ] }, "preds": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_CepAttrPredSpec" }, "type": "array" } }, "type": "object" }, "ResDef_Query_CepNodeSpec": { "description": "STREAM \u2014 the CEP pattern tree (CONCEPT:EG-KG.query.pipelined-execution): `Sequence` (matchers in order within\nthe window), `Within` (a duration constraint wrapping an inner pattern), `Absence`\n(`a` NOT-followed-by `b` within `within`). Mirrors eg-stream's `CepPattern`; pure\nserde \u2014 the actual NFA lives in eg-stream behind eg-plan's `stream` gate.", "oneOf": [ { "additionalProperties": false, "properties": { "Sequence": { "items": { "$ref": "#/components/schemas/ResDef_Query_CepMatcherSpec" }, "type": "array" } }, "required": [ "Sequence" ], "type": "object" }, { "additionalProperties": false, "properties": { "Within": { "properties": { "pattern": { "$ref": "#/components/schemas/ResDef_Query_CepNodeSpec" }, "within": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "within", "pattern" ], "type": "object" } }, "required": [ "Within" ], "type": "object" }, { "additionalProperties": false, "properties": { "Absence": { "properties": { "a": { "$ref": "#/components/schemas/ResDef_Query_CepMatcherSpec" }, "b": { "$ref": "#/components/schemas/ResDef_Query_CepMatcherSpec" }, "within": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "a", "b", "within" ], "type": "object" } }, "required": [ "Absence" ], "type": "object" } ] }, "ResDef_Query_CepPatternSpec": { "description": "STREAM \u2014 the full CEP spec carried by `Op::Cep` (CONCEPT:EG-KG.query.pipelined-execution): the `pattern` tree\nand the `window` it is evaluated over. PURE serde \u2014 the executor turns it into an\neg-stream `run(pattern, events, window)` call behind eg-plan's `stream` gate; this is\nthe wire variant.", "properties": { "pattern": { "$ref": "#/components/schemas/ResDef_Query_CepNodeSpec" }, "window": { "$ref": "#/components/schemas/ResDef_Query_CepWindowSpec" } }, "required": [ "pattern", "window" ], "type": "object" }, "ResDef_Query_CepWindowSpec": { "description": "STREAM \u2014 the sliding / tumbling window a CEP pattern runs over (CONCEPT:EG-KG.query.pipelined-execution).\nMirrors eg-stream's `Window`; pure serde here.", "oneOf": [ { "additionalProperties": false, "properties": { "Sliding": { "properties": { "size": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "size" ], "type": "object" } }, "required": [ "Sliding" ], "type": "object" }, { "additionalProperties": false, "properties": { "Tumbling": { "properties": { "size": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "size" ], "type": "object" } }, "required": [ "Tumbling" ], "type": "object" } ] }, "ResDef_Query_Certificate": { "additionalProperties": false, "description": "Everything a verifier needs, and nothing it must trust.", "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_Algorithm" }, "config": { "$ref": "#/components/schemas/ResDef_Query_SolverConfig" }, "incumbent": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Incumbent" }, { "type": "null" } ] }, "lower_bound": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Scalar" }, { "type": "null" } ], "description": "Certified scalar lower bound, when any bound leaf exists." }, "model_digest": { "$ref": "#/components/schemas/ResDef_Query_Sha256Digest" }, "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" }, "proof": { "$ref": "#/components/schemas/ResDef_Query_BoundProof" }, "status": { "$ref": "#/components/schemas/ResDef_Query_SolveStatus" } }, "required": [ "model_digest", "algorithm", "config", "status", "proof", "nodes_expanded" ], "type": "object" }, "ResDef_Query_ChangeCursor": { "properties": { "expected_previous": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_CursorPosition" }, { "type": "null" } ] }, "partition": { "default": "", "type": "string" }, "position": { "$ref": "#/components/schemas/ResDef_Query_CursorPosition" }, "source": { "type": "string" } }, "required": [ "source", "position" ], "type": "object" }, "ResDef_Query_ChangeEnvelope": { "properties": { "blobs": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_BlobReference" }, "type": "array" }, "commit_descriptor_ref": { "description": "Opaque `CommitDescriptor::commit_id` this envelope's mutation was\npublished under. See `commit_seq`.", "type": [ "string", "null" ] }, "commit_seq": { "description": "GOC-03 \u2014 the [`crate::commit_descriptor::CommitDescriptor::commit_seq`]\nthis envelope's mutation was published under, once the durable\ncommit-descriptor index is wired into the commit path (GOC-03-W03/W05).\nAdditive and optional so an envelope predating that wiring, or one whose\nsurface does not yet register a commit-descriptor participant, remains\nvalid; a populated value MUST be paired with `commit_descriptor_ref`\n(see `validate`) and must match a real descriptor recorded by the commit\nindex \u2014 this module does not itself construct or verify that pairing.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "content_version": { "$ref": "#/components/schemas/ResDef_Query_ContentVersion" }, "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ChangeCursor" }, { "type": "null" } ] }, "envelope_id": { "type": "string" }, "evidence": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_EvidenceRecord" }, "type": "array" }, "features": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_FeatureRecord" }, "type": "array" }, "lineage": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_LineageRecord" }, "type": "array" }, "mutation": { "$ref": "#/components/schemas/ResDef_Query_MutationBatch" }, "policies": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_PolicyRecord" }, "type": "array" }, "privacy": { "$ref": "#/components/schemas/ResDef_Query_PrivacyAttestation" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "envelope_id", "mutation", "content_version", "privacy" ], "type": "object" }, "ResDef_Query_ChangeEnvelopeRecord": { "properties": { "committed_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "envelope": { "$ref": "#/components/schemas/ResDef_Query_ChangeEnvelope" } }, "required": [ "envelope", "committed_at_ms" ], "type": "object" }, "ResDef_Query_ChangedBeliefWire": { "description": "Wire mirror of `eg_epistemic::query::ChangedBelief` \u2014 one entry of a\n`Method::WhatChanged` result.", "properties": { "believed_after": { "type": "boolean" }, "believed_before": { "type": "boolean" }, "confidence_after": { "format": "double", "type": "number" }, "confidence_before": { "format": "double", "type": "number" }, "evidence_added": { "items": { "type": "string" }, "type": "array" }, "evidence_removed": { "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "id", "believed_before", "believed_after", "confidence_before", "confidence_after", "evidence_added", "evidence_removed", "reason" ], "type": "object" }, "ResDef_Query_ChannelType": { "description": "Channel type for dynamic communication.", "oneOf": [ { "const": "PeerToPeer", "description": "1:1 direct messaging between two agents.", "type": "string" }, { "const": "Group", "description": "Many-to-many group channel.", "type": "string" } ] }, "ResDef_Query_ClaimProvenance": { "additionalProperties": false, "description": "How a free-text task was mapped onto native task IRIs, and by what.\n\nA mapping is a CLAIM, never a proof: it is recorded with its producer so a\nrecord that leans on one is classified by its weakest premise.", "properties": { "model_profile": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "default": null }, "producer": { "type": "string" }, "prompt_digest": { "default": null, "type": [ "string", "null" ] } }, "required": [ "producer" ], "type": "object" }, "ResDef_Query_ClaimWorkItemRequest": { "additionalProperties": false, "properties": { "fairness_group": { "type": [ "string", "null" ] }, "lease_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_tenant_in_flight": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "queue_ref": { "type": [ "string", "null" ] }, "resource_class": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_ClaimWorkItemRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": [ "string", "null" ] }, "worker_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "worker_ref", "now_ms", "lease_ms", "max_tenant_in_flight" ], "type": "object" }, "ResDef_Query_ClaimWorkItemRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_ClaimedTaskMapping": { "additionalProperties": false, "description": "One claimed free-text-to-task mapping.", "properties": { "provenance": { "$ref": "#/components/schemas/ResDef_Query_ClaimProvenance" }, "task_iris": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_8" }, "text_digest": { "description": "`sha256:` of the free text, never the text.", "type": "string" } }, "required": [ "text_digest", "task_iris", "provenance" ], "type": "object" }, "ResDef_Query_ClassifyAlgorithm": { "description": "Which classifier `MineClassifyFit` fits (CONCEPT:EG-KG.mining.naive-bayes).", "oneOf": [ { "const": "gaussiannb", "description": "Gaussian Naive Bayes (default) \u2014 continuous features.", "type": "string" }, { "const": "multinomialnb", "description": "Multinomial Naive Bayes \u2014 count features.", "type": "string" }, { "const": "knn", "description": "k-nearest-neighbor majority vote.", "type": "string" }, { "const": "logistic", "description": "One-vs-rest logistic regression.", "type": "string" }, { "const": "svc", "description": "One-vs-rest linear SVM (SVC).", "type": "string" } ] }, "ResDef_Query_ClusterAlgorithm": { "description": "Which clustering engine `MineCluster` runs (CONCEPT:EG-KG.mining.dbscan-density).", "enum": [ "dbscan", "hierarchical", "gmm", "kmedoids" ], "type": "string" }, "ResDef_Query_Coefficient": { "description": "An objective coefficient. `Unknown` is never read as zero: a level that\nholds unknown coefficients ranks every selection of an unknown-cost\nvariable below every all-known selection (the \"unknown tier\").", "oneOf": [ { "enum": [ "unknown" ], "type": "string" }, { "additionalProperties": false, "properties": { "known": { "format": "int64", "type": "integer" } }, "required": [ "known" ], "type": "object" } ] }, "ResDef_Query_ColdStart": { "description": "What the engine does before a head is calibrated.", "oneOf": [ { "additionalProperties": false, "description": "Only the deterministic constraint ladder runs.", "properties": { "mode": { "const": "deterministic_only", "type": "string" } }, "required": [ "mode" ], "type": "object" }, { "additionalProperties": false, "description": "Scores are produced and labelled uncalibrated; nothing acts on them.", "properties": { "mode": { "const": "advisory_uncalibrated", "type": "string" } }, "required": [ "mode" ], "type": "object" }, { "additionalProperties": false, "description": "Bounded exploration is allowed within `budget`.", "properties": { "budget": { "$ref": "#/components/schemas/ResDef_Query_ExplorationBudget" }, "mode": { "const": "explore", "type": "string" } }, "required": [ "mode", "budget" ], "type": "object" } ] }, "ResDef_Query_CommitOutcomeBundle": { "additionalProperties": false, "description": "The one atomic terminal result/artifact/provenance/outbox unit a WorkItem\ncommits under (lane doc \"Schemas/APIs\"). `work_item_id`/`fence_token` bind\nthis bundle to the SAME lease epoch/fencing token\n`Method::CommitWorkItemResult` already CAS's on\n(`src/server/mutation_batch.rs`'s `WorkItemBatchIdentity`) \u2014 a stale or\nduplicate writer is rejected there today, and this bundle's eventual\nnative applier must reuse that identical fencing rather than inventing a\nsecond one.", "properties": { "artifacts": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_OutcomeArtifactRef" }, "type": "array" }, "capability_digest": { "description": "Digest of the capability/tool catalog snapshot the run executed\nagainst (GOC-19/GOC-21 currency binding).", "type": "string" }, "catalog_digest": { "type": "string" }, "completeness": { "$ref": "#/components/schemas/ResDef_Query_OutcomeCompleteness" }, "delegation_id": { "description": "Delegation identity shared by the admission WorkItem and all terminal\nreceipt nodes. This is not a second commit identity; the native\nWorkItem batch/outbox remains authoritative.", "type": "string" }, "delegator_id": { "description": "Authenticated delegator (A), distinct from the selected Agent Library\nentry (B) and from the worker holding the lease.", "type": "string" }, "event_sequence": { "description": "Monotonic, process-anchored sequence for this run\n(`observability/trace_ontology.next_event_sequence()`'s existing\nauthority \u2014 this bundle does not mint a second one).", "format": "uint64", "minimum": 0, "type": "integer" }, "executor_lease_actor": { "description": "The worker identity that held the lease for this terminal transition.", "type": "string" }, "fence_token": { "description": "The lease fencing token this bundle commits under \u2014 MUST match the\ndurable WorkItem row's current `fencing_token`; a stale value is\nrejected exactly like `CommitWorkItemResult`'s existing fencing CAS.", "format": "uint64", "minimum": 0, "type": "integer" }, "langfuse_observation_refs": { "default": [], "description": "Opaque Langfuse observation receipts attached to this same run. The\nobservation store is a projection and never a second authority.", "items": { "$ref": "#/components/schemas/ResDef_Query_LangfuseObservationRef" }, "type": "array" }, "missing_refs": { "default": [], "description": "Names of the specific required components missing when\n`completeness != Complete` (e.g. `\"tool_call:3\"`,\n`\"outcome_evaluation\"`). Empty only when `completeness == Complete`.", "items": { "type": "string" }, "type": "array" }, "model_digest": { "type": "string" }, "outbox_id": { "description": "Identity of the one durable outbox row this bundle's commit publishes.", "type": "string" }, "outcome": { "description": "The exact terminal outcome supplied to `CommitWorkItemResult`.", "type": "string" }, "outcome_ref": { "description": "Opaque reference to the durable OutcomeEvaluation node.", "type": "string" }, "policy_digest": { "type": "string" }, "result_digest": { "description": "sha256 digest of the canonical encoded result body, present whenever\n`result_ref` is. A repair/reconcile pass may never change this once\ncommitted (lane doc: \"Repair is idempotent and cannot alter result\ndigest\").", "type": [ "string", "null" ] }, "result_ref": { "description": "Opaque, immutable reference to the terminal result body. Never the\nbody itself \u2014 mirrors `Method::CommitWorkItemResult`'s existing\n`result_ref: Option`.", "type": [ "string", "null" ] }, "run_id": { "description": "Opaque run identity this bundle's RunTrace/ToolCall/OutcomeEvaluation\nare keyed under (`observability/trace_ontology.py`'s trace id family).", "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "selected_agent_id": { "description": "Retained Agent Library identity selected at admission (B).", "type": "string" }, "tool_call_refs": { "default": [], "description": "Opaque references to the durable ToolCall nodes this bundle's\nprovenance batch wrote, in call order. Never synthesized from a\nprogress receipt or free-text log \u2014 every entry names a real node this\nSAME bundle committed.", "items": { "type": "string" }, "type": "array" }, "trace_ref": { "description": "Opaque reference to the durable RunTrace node this bundle's provenance\nbatch wrote (`observability/trace_ontology.py`'s trace node id).", "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "delegation_id", "delegator_id", "selected_agent_id", "executor_lease_actor", "outcome", "work_item_id", "fence_token", "run_id", "trace_ref", "outcome_ref", "capability_digest", "catalog_digest", "policy_digest", "model_digest", "event_sequence", "completeness", "outbox_id" ], "type": "object" }, "ResDef_Query_CommittedVersion": { "description": "Exact authoritative version transition committed with a durable record.", "oneOf": [ { "enum": [ "none" ], "type": "string" }, { "additionalProperties": false, "properties": { "graph": { "properties": { "source": { "format": "uint64", "minimum": 0, "type": "integer" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source", "target" ], "type": "object" } }, "required": [ "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "native": { "properties": { "source": { "format": "uint64", "minimum": 0, "type": "integer" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source", "target" ], "type": "object" } }, "required": [ "native" ], "type": "object" } ] }, "ResDef_Query_CommunityAlgorithm": { "description": "Which existing GDS kernel `MineCommunity` wraps (CONCEPT:EG-KG.mining.community-writeback).", "enum": [ "louvain", "labelprop" ], "type": "string" }, "ResDef_Query_CommunityQualityFunction": { "description": "Quality (objective) function `CommunityDetectEphemeral` optimizes (EH-314) \u2014\nthe wire mirror of `eg_compute::graph_algos::QualityFunction`, kept as its\nown type here rather than reused directly so `eg-types` never depends on\n`eg-compute`; the server handler maps one to the other\n(`src/server/handlers/graph_ops/algorithms.rs`), the same split\n`CommunityAlgorithm`/`to_community_algo` already use for `MineCommunity`.\n`Modularity` (the pre-EH-314 behaviour) has a well-known resolution limit\non large graphs; `Cpm` (Constant Potts Model) removes it \u2014 see EG's own\n`QualityFunction` doc for the exact math. Defaulting to `Modularity` is\nwhat keeps a caller that sends no `quality` byte-identical to the\npre-EH-314 kernel.\n\nNot gated behind `mining`/`ml-pipeline` (unlike this file's other wire\nenums) \u2014 `CommunityDetectEphemeral` is a base compute method, always\ncompiled.", "enum": [ "modularity", "cpm" ], "type": "string" }, "ResDef_Query_ComponentDependency": { "additionalProperties": false, "description": "One pinned requirement of a component.\n\nThe `kind` is carried alongside the id so a dependency can be type-checked\nwithout resolving it: a [`AgentComponentKind::Tool`] whose input schema\npoints at a [`AgentComponentKind::ModelProfile`] is rejected structurally,\nnot at run time. The `definition_digest` pins the exact revision, so a\ndependency cannot silently change under a component that was reviewed\nagainst it.", "properties": { "component_id": { "type": "string" }, "definition_digest": { "type": "string" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentKind" } }, "required": [ "component_id", "kind", "definition_digest" ], "type": "object" }, "ResDef_Query_ComponentProvenance": { "description": "Where a component was ingested FROM.\n\nSource packages and MCP servers remain the origin of skills, tools, prompts\nand resources; EG is where they are recorded so they can be queried. That\nsplit only works if the origin travels with the record: without it, \"which\nagents break if this MCP server changes?\" cannot be answered, and a\nre-ingest cannot tell an updated component from a new one.", "oneOf": [ { "description": "Declared directly in EG; no upstream system owns it.", "properties": { "origin": { "const": "native", "type": "string" } }, "required": [ "origin" ], "type": "object" }, { "description": "Ingested from a source package (an `agent-packages/*` distribution).", "properties": { "origin": { "const": "source_package", "type": "string" }, "package_id": { "type": "string" }, "package_version": { "type": "string" } }, "required": [ "origin", "package_id", "package_version" ], "type": "object" }, { "description": "Ingested by listing an MCP server's surface.\n\n`server` PINS the [`AgentComponentKind::McpServer`] record by\n`(id, kind, digest)`, so the server is one node every tool/prompt/\nresource it serves hangs off AND the server a record claims is the\nserver that was reviewed. It was a bare `server_component_id: String`\n-- the last unpinned cross-record reference in this contract -- and an\nid alone is unresolvable in principle: no admission check can tell an\ningest that named the reviewed server from one that named a different\nserver, or a republished one whose tool surface has since moved.\n\nA full [`ComponentDependency`] rather than an id+digest pair, because\nthe kind belongs inside the pin exactly as it does everywhere else\nhere: resolution is by `(id, kind, digest)`, and carrying the kind is\nwhat lets admission refuse a provenance that names a `Toolset` where\nthe serving server belongs instead of discovering it at execution.", "properties": { "origin": { "const": "mcp_server", "type": "string" }, "server": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "upstream_name": { "description": "The name the server itself uses. Distinct from `component_id`,\nwhich is EG-scoped: two servers may both expose a `search` tool.", "type": "string" } }, "required": [ "origin", "server", "upstream_name" ], "type": "object" } ] }, "ResDef_Query_ConnectorPackBindRequest": { "additionalProperties": false, "description": "Bind a connector to the importer allowed to publish its packs.", "properties": { "connector": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "importer": { "type": "string" } }, "required": [ "context", "connector", "importer" ], "type": "object" }, "ResDef_Query_ConnectorPackImportRequest": { "additionalProperties": false, "description": "Import one pack atomically.", "properties": { "allow_mass_withdrawal": { "default": false, "description": "An import that withdraws most of a connector's surface is usually a\nbroken build, not an intention, so it needs a second, administrative\ngrant rather than the ordinary pack-control one.", "type": "boolean" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "expected_head": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_PackHeadRef" }, { "type": "null" } ], "default": null, "description": "Compare-and-set against the head the caller last saw." }, "index": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackIndex" } }, "required": [ "context", "index" ], "type": "object" }, "ResDef_Query_ConnectorPackIndex": { "additionalProperties": false, "description": "One connector's complete published surface.", "properties": { "archive": { "$ref": "#/components/schemas/ResDef_Query_PackArchiveRef" }, "catalog": { "$ref": "#/components/schemas/ResDef_Query_McpCatalogSnapshotBinding", "description": "The exact served generation/digest observed by the catalog lister." }, "connector": { "type": "string" }, "entries": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_PackEntry_1024" }, "pack_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256", "description": "The digest of everything above, recomputed by the engine before\nanything is committed." }, "producer": { "$ref": "#/components/schemas/ResDef_Query_PackProducer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "server": { "$ref": "#/components/schemas/ResDef_Query_PackEntry", "description": "The MCP server entry itself. Every other entry hangs off it." }, "server_package_version": { "type": "string" } }, "required": [ "schema_version", "connector", "server", "server_package_version", "archive", "entries", "producer", "catalog", "pack_digest" ], "type": "object" }, "ResDef_Query_ConnectorPackOp": { "description": "Every connector-pack operation.", "oneOf": [ { "additionalProperties": false, "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackStatusRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Boxed: an import carries a whole pack index and would otherwise set the\nsize of every `Method`.", "properties": { "op": { "const": "import", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackImportRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "bind", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackBindRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "unbind", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackUnbindRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "retire", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackRetireRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "reproject", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackReprojectRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "const": "reconcile_bodies", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackReconcileRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ResDef_Query_ConnectorPackReconcileRequest": { "additionalProperties": false, "description": "Sweep engine-owned bodies no revision holds any more.", "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" } }, "required": [ "context" ], "type": "object" }, "ResDef_Query_ConnectorPackReprojectRequest": { "additionalProperties": false, "description": "Re-project the current head into the graph.", "properties": { "connector": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" } }, "required": [ "context", "connector" ], "type": "object" }, "ResDef_Query_ConnectorPackRetireRequest": { "additionalProperties": false, "description": "Permanently retire named entries of a connector.", "properties": { "connector": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "uris": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_1024" } }, "required": [ "context", "connector", "uris" ], "type": "object" }, "ResDef_Query_ConnectorPackStatusRequest": { "additionalProperties": false, "description": "Read one connector's pack state.", "properties": { "connector": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "connector" ], "type": "object" }, "ResDef_Query_ConnectorPackUnbindRequest": { "additionalProperties": false, "description": "Remove a connector's importer binding.", "properties": { "connector": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" } }, "required": [ "context", "connector" ], "type": "object" }, "ResDef_Query_ConstraintBody": { "description": "The typed body of a constraint.", "oneOf": [ { "additionalProperties": false, "description": "A general linear row with integer coefficients.", "properties": { "linear": { "additionalProperties": false, "properties": { "relation": { "$ref": "#/components/schemas/ResDef_Query_Relation" }, "rhs": { "format": "int64", "type": "integer" }, "terms": { "items": { "$ref": "#/components/schemas/ResDef_Query_Term" }, "type": "array" } }, "required": [ "terms", "relation", "rhs" ], "type": "object" } }, "required": [ "linear" ], "type": "object" }, { "additionalProperties": false, "description": "`antecedent \u21d2 consequent` (`consequent \u2212 antecedent \u2265 0`).", "properties": { "implication": { "additionalProperties": false, "properties": { "antecedent": { "$ref": "#/components/schemas/ResDef_Query_VarId" }, "consequent": { "$ref": "#/components/schemas/ResDef_Query_VarId" } }, "required": [ "antecedent", "consequent" ], "type": "object" } }, "required": [ "implication" ], "type": "object" }, { "additionalProperties": false, "description": "`antecedent \u21d2 at least one consequent` (a conditional covering row).", "properties": { "implies_any": { "additionalProperties": false, "properties": { "antecedent": { "$ref": "#/components/schemas/ResDef_Query_VarId" }, "consequents": { "items": { "$ref": "#/components/schemas/ResDef_Query_VarId" }, "type": "array" } }, "required": [ "antecedent", "consequents" ], "type": "object" } }, "required": [ "implies_any" ], "type": "object" }, { "additionalProperties": false, "description": "Exactly one of `vars` is selected.", "properties": { "exactly_one": { "additionalProperties": false, "properties": { "vars": { "items": { "$ref": "#/components/schemas/ResDef_Query_VarId" }, "type": "array" } }, "required": [ "vars" ], "type": "object" } }, "required": [ "exactly_one" ], "type": "object" }, { "additionalProperties": false, "description": "At most `k` of `vars` are selected.", "properties": { "at_most": { "additionalProperties": false, "properties": { "k": { "format": "uint32", "minimum": 0, "type": "integer" }, "vars": { "items": { "$ref": "#/components/schemas/ResDef_Query_VarId" }, "type": "array" } }, "required": [ "vars", "k" ], "type": "object" } }, "required": [ "at_most" ], "type": "object" }, { "additionalProperties": false, "description": "At least `k` of `vars` are selected (`k = 1` is a covering row).", "properties": { "at_least": { "additionalProperties": false, "properties": { "k": { "format": "uint32", "minimum": 0, "type": "integer" }, "vars": { "items": { "$ref": "#/components/schemas/ResDef_Query_VarId" }, "type": "array" } }, "required": [ "vars", "k" ], "type": "object" } }, "required": [ "at_least" ], "type": "object" }, { "additionalProperties": false, "description": "`var` is pinned to `value`.", "properties": { "fix": { "additionalProperties": false, "properties": { "value": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ResDef_Query_VarId" } }, "required": [ "var", "value" ], "type": "object" } }, "required": [ "fix" ], "type": "object" } ] }, "ResDef_Query_ConstraintSpec": { "additionalProperties": false, "description": "A labelled constraint. The label names the constraint in explanations\n(for example an infeasibility core).", "properties": { "body": { "$ref": "#/components/schemas/ResDef_Query_ConstraintBody" }, "label": { "type": "string" } }, "required": [ "label", "body" ], "type": "object" }, "ResDef_Query_ContentVersion": { "properties": { "digest": { "type": "string" }, "digest_algorithm": { "type": "string" }, "object_id": { "type": "string" }, "previous_digest": { "type": [ "string", "null" ] }, "source_version": { "$ref": "#/components/schemas/ResDef_Query_ContentVersionPosition", "description": "Typed source-side version. It is never compared lexically." } }, "required": [ "object_id", "digest_algorithm", "digest", "source_version" ], "type": "object" }, "ResDef_Query_ContentVersionPosition": { "oneOf": [ { "properties": { "kind": { "const": "sequence", "type": "string" }, "value": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "timestamp_millis", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "opaque", "type": "string" }, "value": { "properties": { "value": { "type": "string" }, "version_type": { "type": "string" } }, "required": [ "version_type", "value" ], "type": "object" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ResDef_Query_ContextView": { "description": "Optimized context view returned by get_context_view.", "properties": { "agent_id": { "type": "string" }, "budget_max": { "format": "uint32", "minimum": 0, "type": "integer" }, "budget_used": { "format": "uint32", "minimum": 0, "type": "integer" }, "edges": { "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } ], "type": "array" }, "type": "array" }, "nodes": { "items": { "type": "string" }, "type": "array" } }, "required": [ "agent_id", "nodes", "edges", "budget_used", "budget_max" ], "type": "object" }, "ResDef_Query_ControlLeaseTarget": { "description": "The state a transition moves a lease to.", "enum": [ "consumed", "revoked", "expired" ], "type": "string" }, "ResDef_Query_CostBudget": { "additionalProperties": false, "description": "A currency-denominated ceiling on the selection's declared cost.", "properties": { "currency": { "description": "ISO 4217, exactly three ASCII uppercase letters.", "type": "string" }, "max_micros": { "format": "uint64", "minimum": 0, "type": "integer" }, "strict": { "description": "Strict means an unknown cost is excluded rather than ranked below.", "type": "boolean" } }, "required": [ "currency", "max_micros", "strict" ], "type": "object" }, "ResDef_Query_CostFacts": { "additionalProperties": false, "description": "What one invocation costs, plus who says so and how strongly.", "properties": { "currency": { "description": "ISO 4217: exactly three ASCII uppercase letters.", "type": "string" }, "input_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "per_call_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "price_source": { "$ref": "#/components/schemas/ResDef_Query_PriceSource" }, "quality": { "$ref": "#/components/schemas/ResDef_Query_FactQuality" } }, "required": [ "currency", "price_source", "quality" ], "type": "object" }, "ResDef_Query_CoverageDerivation": { "additionalProperties": false, "description": "How one required capability is covered, step by step.", "properties": { "chain": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_DerivationEdge_16" }, "covered_by": { "default": null, "description": "The component that covers it, or `None` when nothing does.", "type": [ "string", "null" ] }, "required": { "type": "string" } }, "required": [ "required", "chain" ], "type": "object" }, "ResDef_Query_CursorPosition": { "oneOf": [ { "properties": { "kind": { "const": "sequence", "type": "string" }, "value": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "timestamp_millis", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "description": "Provider-defined cursors are never ordered lexically.", "properties": { "kind": { "const": "opaque", "type": "string" }, "value": { "properties": { "cursor_type": { "description": "Stable provider cursor type (for example `page_token_v2`).", "type": "string" }, "value": { "type": "string" } }, "required": [ "cursor_type", "value" ], "type": "object" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ResDef_Query_CypherMode": { "description": "Required execution authority for a Cypher statement.\n\nThe caller must declare whether a statement is a read or mutation. The\nserver parses the statement and rejects a mismatch, so a mutation can never\nobtain read authorization by hiding a keyword in comments, literals, or an\nunsupported clause.", "enum": [ "read", "write" ], "type": "string" }, "ResDef_Query_DecideRequest": { "additionalProperties": false, "description": "One statistical decision request.\nNot `Eq`, for the same reason [`CandidateSource`] is not.", "properties": { "candidates": { "$ref": "#/components/schemas/ResDef_Query_CandidateSource" }, "feature_schema": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "head": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "Absent asks for the deterministic ladder only." }, "max_records": { "default": null, "description": "At most [`MAX_DECIDE_RECORDS`].", "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] }, "params": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_TypedParam_64", "default": [], "description": "Sorted by name and unique." }, "policy": { "$ref": "#/components/schemas/ResDef_Query_DecisionPolicyRef" }, "question": { "$ref": "#/components/schemas/ResDef_Query_StatisticalQuestion" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "question", "candidates", "feature_schema", "policy" ], "type": "object" }, "ResDef_Query_DecisionBatch": { "additionalProperties": false, "description": "One evaluate-only answer: the records the decision produced, and the digest\nof the inputs they share.", "properties": { "inputs_digest": { "type": "string" }, "records": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_StatisticalDecisionRecord_256" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "inputs_digest", "records" ], "type": "object" }, "ResDef_Query_DecisionCommitRequest": { "additionalProperties": false, "description": "Commit one assembly record as a durable `DecisionRecord` component.", "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryMutationContext" }, "expected_catalog_digest": { "description": "Compare-and-set: the catalog digest the record was decided against.", "type": "string" }, "record": { "$ref": "#/components/schemas/ResDef_Query_DecisionRecord", "description": "This wave commits library-sourced v1 records only." } }, "required": [ "context", "record", "expected_catalog_digest" ], "type": "object" }, "ResDef_Query_DecisionEvalOp": { "description": "Evaluate a candidate decision head.", "oneOf": [ { "additionalProperties": false, "description": "Enqueue the job. The only mutating op. Boxed: a submission\ncarries its whole labelled dataset.", "properties": { "op": { "const": "submit", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_DecisionEvalRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Read one submitted job's row.", "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_DecisionJobStatusRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ResDef_Query_DecisionEvalRequest": { "additionalProperties": false, "description": "Evaluate a candidate head against recorded decisions.", "properties": { "approved_commit_principals": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64", "default": [], "description": "Commit principals whose bandit records may be evaluated on." }, "candidate": { "$ref": "#/components/schemas/ResDef_Query_EvalCandidate" }, "dataset": { "$ref": "#/components/schemas/ResDef_Query_LabelledDataset", "description": "The labelled items the candidate is evaluated on." }, "estimators": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_OpeEstimatorKind_8" }, "gold_set_digest": { "default": null, "type": [ "string", "null" ] }, "idempotency_key": { "type": "string" }, "policy": { "$ref": "#/components/schemas/ResDef_Query_DecisionPolicyRef" }, "tenant_id": { "type": "string" }, "window": { "$ref": "#/components/schemas/ResDef_Query_RecordWindow" } }, "required": [ "tenant_id", "idempotency_key", "candidate", "policy", "estimators", "window", "dataset" ], "type": "object" }, "ResDef_Query_DecisionFitOp": { "description": "Fit a decision head.", "oneOf": [ { "additionalProperties": false, "description": "Enqueue the job. The only mutating op. Boxed: a submission\ncarries its whole labelled dataset.", "properties": { "op": { "const": "submit", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_DecisionFitRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Read one submitted job's row.", "properties": { "op": { "const": "status", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_DecisionJobStatusRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ResDef_Query_DecisionFitRequest": { "additionalProperties": false, "description": "Fit a decision head into a draft artifact.", "properties": { "approved_commit_principals": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64", "default": [], "description": "Commit principals whose bandit records may train. Empty admits none." }, "dataset": { "$ref": "#/components/schemas/ResDef_Query_LabelledDataset", "description": "The labelled items, pinned: a full-label regime's `gold_set_digest`\nmust equal this dataset's digest." }, "feature_schema": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "head_kind": { "$ref": "#/components/schemas/ResDef_Query_HeadKind" }, "idempotency_key": { "type": "string" }, "label_regime": { "$ref": "#/components/schemas/ResDef_Query_LabelRegime" }, "optimiser": { "$ref": "#/components/schemas/ResDef_Query_OptimiserSpec" }, "policy": { "$ref": "#/components/schemas/ResDef_Query_DecisionPolicyRef" }, "tenant_id": { "type": "string" }, "window": { "$ref": "#/components/schemas/ResDef_Query_RecordWindow" } }, "required": [ "tenant_id", "idempotency_key", "head_kind", "feature_schema", "policy", "label_regime", "window", "optimiser", "dataset" ], "type": "object" }, "ResDef_Query_DecisionInputs": { "additionalProperties": false, "description": "The complete input set, digested as `inputs_digest`.", "properties": { "candidates": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_CandidateFacts_64", "description": "Sorted by `component_id`, so the digest does not depend on read order." }, "catalog_digest": { "type": "string" }, "ontology_digest": { "type": "string" }, "policy": { "$ref": "#/components/schemas/ResDef_Query_DecisionPolicy" }, "policy_digest": { "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_AssemblyRequest" }, "solver": { "$ref": "#/components/schemas/ResDef_Query_SolverIdentity" }, "templates": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_TemplateFacts_8", "default": [], "description": "The graph templates the request named, read at their pinned revisions.\nEmpty asks for a one-agent graph." } }, "required": [ "request", "candidates", "ontology_digest", "policy", "policy_digest", "catalog_digest", "solver" ], "type": "object" }, "ResDef_Query_DecisionJobStatusRequest": { "additionalProperties": false, "description": "Ask after one submitted job.", "properties": { "job_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "job_id" ], "type": "object" }, "ResDef_Query_DecisionOutcome": { "description": "The conclusion of one assembly decision.", "oneOf": [ { "additionalProperties": false, "description": "An assembly, with the certificate that proves it optimal. Boxed: the\ncertificate's own proof tree dwarfs every other field this enum\ncarries (320 bytes vs. `Abstained`'s 24), so every `DecisionOutcome`\nvalue would otherwise pay `Solved`'s size even when it holds the far\nsmaller `Abstained` variant.", "properties": { "certificate": { "$ref": "#/components/schemas/ResDef_Query_Certificate" }, "graph_digest": { "type": "string" }, "outcome": { "const": "solved", "type": "string" }, "slots": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_SlotAssignment_64" } }, "required": [ "outcome", "graph_digest", "slots", "certificate" ], "type": "object" }, { "additionalProperties": false, "description": "No assembly, and exactly why.", "properties": { "outcome": { "const": "abstained", "type": "string" }, "reasons": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_AbstainReason_64" } }, "required": [ "outcome", "reasons" ], "type": "object" } ] }, "ResDef_Query_DecisionPolicy": { "additionalProperties": false, "description": "The complete decision policy.", "properties": { "a2a_requires_observation": { "description": "Whether an A2A agent card needs an observation before it is selectable.", "type": "boolean" }, "accepted_gap": { "$ref": "#/components/schemas/ResDef_Query_Scalar", "description": "Largest objective gap accepted instead of reporting budget exhaustion." }, "cold_start": { "$ref": "#/components/schemas/ResDef_Query_ColdStart" }, "max_nogood_rounds": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_slots": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_templates": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_why_not_per_slot": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" }, "objective": { "$ref": "#/components/schemas/ResDef_Query_ObjectiveOrder" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "statistical": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_StatisticalPolicy" }, { "type": "null" } ], "default": null }, "unknown_cost": { "$ref": "#/components/schemas/ResDef_Query_UnknownCostRule" } }, "required": [ "schema_version", "objective", "unknown_cost", "accepted_gap", "node_budget", "max_templates", "max_slots", "max_nogood_rounds", "max_why_not_per_slot", "a2a_requires_observation", "cold_start" ], "type": "object" }, "ResDef_Query_DecisionPolicyRef": { "description": "Which policy decides this request.", "oneOf": [ { "additionalProperties": false, "description": "The engine default policy.", "properties": { "policy": { "const": "default", "type": "string" } }, "required": [ "policy" ], "type": "object" }, { "additionalProperties": false, "description": "A published `DecisionPolicy` component, pinned by revision digest.", "properties": { "component": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "policy": { "const": "pinned", "type": "string" } }, "required": [ "policy", "component" ], "type": "object" } ] }, "ResDef_Query_DecisionQuestion": { "description": "The question a record answers. One variant in this wave; the tag exists so\na later question does not have to break the record shape.", "enum": [ "assemble" ], "type": "string" }, "ResDef_Query_DecisionRecord": { "additionalProperties": false, "description": "One assembly decision, in full.", "properties": { "caller_principal": { "description": "Privacy-safe persistence id of the caller, never a display name.", "type": "string" }, "candidate_source": { "$ref": "#/components/schemas/ResDef_Query_CandidateSourceRecord" }, "created_at_ms": { "description": "Recorded, and never read by the math.", "format": "uint64", "minimum": 0, "type": "integer" }, "derivation_class": { "$ref": "#/components/schemas/ResDef_Query_DerivationClass" }, "derivations": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_CoverageDerivation_32" }, "eliminated": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_Elimination_64" }, "evidence_class": { "$ref": "#/components/schemas/ResDef_Query_EvidenceClass" }, "inputs": { "$ref": "#/components/schemas/ResDef_Query_DecisionInputs" }, "inputs_digest": { "type": "string" }, "outcome": { "$ref": "#/components/schemas/ResDef_Query_DecisionOutcome" }, "premises": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_PremiseRef_1024" }, "question": { "$ref": "#/components/schemas/ResDef_Query_DecisionQuestion" }, "record_digest": { "type": "string" }, "record_id": { "type": "string" }, "resolution_kind": { "$ref": "#/components/schemas/ResDef_Query_ResolutionKind" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" }, "trace_fidelity": { "$ref": "#/components/schemas/ResDef_Query_TraceFidelity" }, "why_not": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_WhyNot_64" } }, "required": [ "schema_version", "record_id", "tenant_id", "caller_principal", "created_at_ms", "question", "candidate_source", "inputs", "inputs_digest", "resolution_kind", "evidence_class", "derivation_class", "trace_fidelity", "premises", "eliminated", "derivations", "outcome", "why_not", "record_digest" ], "type": "object" }, "ResDef_Query_DecisionTree": { "properties": { "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Query_TreeNode" }, "type": "array" } }, "required": [ "nodes" ], "type": "object" }, "ResDef_Query_DeclaredCost": { "additionalProperties": false, "description": "What one invocation costs, exactly, in a named currency.\n\nInteger micros, never a float: a budget comparison that depends on binary\nrounding is a budget that decides differently on two hosts. The same\nshape a connector pack entry declares for itself\n([`crate::connector_pack::PackCost`]) \u2014 one owner for \"what does this\ninvocation cost\", whether the number arrived via a pack import or was\notherwise declared.", "properties": { "currency": { "description": "ISO 4217: exactly three ASCII uppercase letters.", "type": "string" }, "input_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "per_call_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "currency" ], "type": "object" }, "ResDef_Query_DeclaredLatency": { "additionalProperties": false, "description": "A publisher's declared latency profile.", "properties": { "p50_ms": { "format": "uint32", "minimum": 0, "type": "integer" }, "p95_ms": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "p50_ms", "p95_ms" ], "type": "object" }, "ResDef_Query_DelegationTarget": { "description": "What a delegation runs.\n\n# Why one delegation, not one per node\n\nA graph delegation admits exactly ONE work item. The child agent runs are\nthe executor's business, bounded by the graph's own composed ceiling.\n\nThe alternative -- admitting one work item per node -- was rejected because\n`max_tenant_in_flight` would then make a graph UNSCHEDULABLE whenever its\nnode count exceeded the tenant's limit: the parent would hold a slot while\nwaiting for children that cannot get one. That is a deadlock, not a\nthrottle.\n\nSo the two bounds govern two different things, and both are needed:\n\n* `max_tenant_in_flight` bounds how many DELEGATIONS a tenant may have in\n flight;\n* `composed_work_ceiling` bounds what one delegation may do INTERNALLY.\n\nWithout the second, a graph would be a way to escape the first by fanning\nout. `MAX_COMPOSITION_WORK` is the global cap that makes the escape\nimpossible rather than merely discouraged.", "oneOf": [ { "description": "One published agent (layer 2).", "properties": { "entry": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryEntryRef" }, "target": { "const": "agent", "type": "string" } }, "required": [ "target", "entry" ], "type": "object" }, { "description": "One published agent graph -- a team (layer 3).", "properties": { "graph": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphEntryRef", "description": "Boxed: a graph ref is the larger variant, and an unboxed enum pays\nits size on every delegation including single-agent ones." }, "target": { "const": "graph", "type": "string" } }, "required": [ "target", "graph" ], "type": "object" } ] }, "ResDef_Query_DerivationClass": { "description": "How the derivation itself was produced. Only checkable derivations are\nadmitted in this wave, so the enum has one arm and a name.", "enum": [ "proof" ], "type": "string" }, "ResDef_Query_DerivationEdge": { "additionalProperties": false, "description": "One `narrower \u2291 broader` step of a coverage chain.", "properties": { "broader": { "type": "string" }, "class": { "$ref": "#/components/schemas/ResDef_Query_PremiseClass" }, "narrower": { "type": "string" }, "source": { "$ref": "#/components/schemas/ResDef_Query_EdgeSource" } }, "required": [ "narrower", "broader", "source", "class" ], "type": "object" }, "ResDef_Query_DevelopmentLaneCleanupCompleteRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "cleanup_work_item_fence": { "type": "string" }, "cleanup_work_item_id": { "type": "string" }, "expected_hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "removal_proof_ref": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneCleanupCompleteRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "cleanup_work_item_id", "cleanup_work_item_fence", "cleanup_attempt", "cleanup_lease_epoch", "cleanup_fencing_token", "hold_id", "expected_hold_revision", "removal_proof_ref", "idempotency_key", "now_ms" ], "type": "object" }, "ResDef_Query_DevelopmentLaneCleanupCompleteRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneFinishRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneFinishRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "terminal_state": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneFinishRequestTerminalState" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "hold_id", "expected_hold_revision", "terminal_state", "idempotency_key", "now_ms" ], "type": "object" }, "ResDef_Query_DevelopmentLaneFinishRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneFinishRequestTerminalState": { "enum": [ "succeeded", "failed", "cancelled", "dead_letter" ], "type": "string" }, "ResDef_Query_DevelopmentLaneIntent": { "additionalProperties": false, "properties": { "base_ref": { "type": "string" }, "base_sha": { "type": "string" }, "branch": { "type": "string" }, "fairness_group": { "type": "string" }, "host_ref": { "type": "string" }, "host_target_alias": { "type": [ "string", "null" ] }, "host_target_kind": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneIntentHostTargetKind" }, "input_fingerprint": { "type": "string" }, "lane_id": { "type": "string" }, "owner_id": { "type": "string" }, "predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "quota_policy_name": { "type": "string" }, "quota_policy_version": { "type": "string" }, "repository_id": { "type": "string" }, "request_id": { "type": "string" }, "resource_reservation_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneIntentSchemaVersion" }, "session_id": { "type": "string" }, "tenant_ref": { "type": "string" }, "ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_ref": { "type": "string" }, "worktree_locator": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "request_id", "lane_id", "repository_id", "base_ref", "base_sha", "branch", "host_target_kind", "host_ref", "resource_reservation_id", "workspace_ref", "worktree_locator", "owner_id", "session_id", "fairness_group", "quota_policy_name", "quota_policy_version", "predicted_disk_bytes", "ttl_ms", "input_fingerprint" ], "type": "object" }, "ResDef_Query_DevelopmentLaneIntentHostTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ResDef_Query_DevelopmentLaneIntentSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneObserveRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "observation_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneObserveRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "hold_id", "expected_hold_revision", "observed_disk_bytes", "observation_revision", "idempotency_key", "now_ms" ], "type": "object" }, "ResDef_Query_DevelopmentLaneObserveRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneQueryRequest": { "additionalProperties": false, "properties": { "hold_id": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneQueryRequestSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "hold_id", "now_ms" ], "type": "object" }, "ResDef_Query_DevelopmentLaneQueryRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneQuotaPolicy": { "additionalProperties": false, "properties": { "drain_only": { "type": "boolean" }, "global_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "global_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_observation_staleness_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "min_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_name": { "type": "string" }, "policy_version": { "type": "string" }, "repository_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "repository_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneQuotaPolicySchemaVersion" }, "session_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "session_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_count_limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_observed_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_predicted_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "workspace_retained_disk_bytes": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "policy_name", "policy_version", "tenant_count_limit", "owner_count_limit", "session_count_limit", "workspace_count_limit", "repository_count_limit", "host_count_limit", "global_count_limit", "tenant_predicted_disk_bytes", "owner_predicted_disk_bytes", "session_predicted_disk_bytes", "workspace_predicted_disk_bytes", "repository_predicted_disk_bytes", "host_predicted_disk_bytes", "global_predicted_disk_bytes", "tenant_observed_disk_bytes", "owner_observed_disk_bytes", "session_observed_disk_bytes", "workspace_observed_disk_bytes", "repository_observed_disk_bytes", "host_observed_disk_bytes", "global_observed_disk_bytes", "tenant_retained_disk_bytes", "owner_retained_disk_bytes", "session_retained_disk_bytes", "workspace_retained_disk_bytes", "repository_retained_disk_bytes", "host_retained_disk_bytes", "global_retained_disk_bytes", "min_ttl_ms", "max_ttl_ms", "max_observation_staleness_ms", "drain_only" ], "type": "object" }, "ResDef_Query_DevelopmentLaneQuotaPolicySchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneQuotaUpdateRequest": { "additionalProperties": false, "properties": { "expected_policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_policy_version": { "type": [ "string", "null" ] }, "idempotency_key": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneQuotaPolicy" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneQuotaUpdateRequestSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "policy", "expected_policy_revision", "idempotency_key", "now_ms" ], "type": "object" }, "ResDef_Query_DevelopmentLaneQuotaUpdateRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneRenewRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "expected_hold_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "hold_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneRenewRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "hold_id", "expected_hold_revision", "ttl_ms", "idempotency_key", "now_ms" ], "type": "object" }, "ResDef_Query_DevelopmentLaneRenewRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneReserveRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "intent": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneIntent" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneReserveRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_fence": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "attempt", "lease_epoch", "fencing_token", "work_item_fence", "intent", "idempotency_key", "now_ms" ], "type": "object" }, "ResDef_Query_DevelopmentLaneReserveRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_DevelopmentLaneStatusRequest": { "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "hold_id": { "type": [ "string", "null" ] }, "lane_id": { "type": [ "string", "null" ] }, "limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneStatusRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "tenant_ref", "limit", "now_ms" ], "type": "object" }, "ResDef_Query_DevelopmentLaneStatusRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_Digest256": { "description": "32 bytes of SHA-256 as lowercase hexadecimal", "maxLength": 64, "minLength": 64, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "ResDef_Query_DisclosureLevelWire": { "description": "Wire mirror of `eg_epistemic::redact::DisclosureLevel` (EPI-P3-4, L51) \u2014 the\n`Method::ExplainBelief::disclosure_level` request field AND the\n`ExplainBeliefRedactedResult::level` response field share this one type. Plain\nserde/enum, no `eg-epistemic` dependency needed here (`eg-types` sits BELOW\n`eg-epistemic` in the crate DAG).", "enum": [ "Full", "Skeleton", "ExistenceOnly" ], "type": "string" }, "ResDef_Query_DiscoveryCounts": { "additionalProperties": false, "description": "How many of each MCP primitive the probe saw.", "properties": { "prompts": { "format": "uint32", "minimum": 0, "type": "integer" }, "resources": { "format": "uint32", "minimum": 0, "type": "integer" }, "skills": { "format": "uint32", "minimum": 0, "type": "integer" }, "tools": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "tools", "skills", "prompts", "resources" ], "type": "object" }, "ResDef_Query_DiscoveryOutcome": { "description": "What the probe found.", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "reachable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "description": "Recorded rather than omitted: \"unavailable\" must never look identical to\n\"empty\". `error` is caller-redacted text; it is bounded here and never\ninterpreted.", "properties": { "error": { "type": "string" }, "status": { "const": "unreachable", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ] }, "ResDef_Query_DiscoveryScope": { "description": "Under whose authority a discovery observation was made.\n\nClosed, and deliberately two-valued. A local/stdio probe has no provider\ngrant to fingerprint, so it is tenant-local and visible to the tenant; a\nprobe made with a principal's OAuth grant saw what THAT grant allows, so it\nis visible only to that principal while that grant is current. There is no\nthird \"global\" value: an observation that cannot say which of the two it is\nis not recorded.", "oneOf": [ { "additionalProperties": false, "properties": { "authority": { "const": "tenant_local", "type": "string" } }, "required": [ "authority" ], "type": "object" }, { "additionalProperties": false, "description": "`grant_digest` is the broker-minted fingerprint of the grant the probe\nused. The principal is NOT a field: the server binds it from the\nverified request context.", "properties": { "authority": { "const": "oauth_grant", "type": "string" }, "grant_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" } }, "required": [ "authority", "grant_digest" ], "type": "object" } ] }, "ResDef_Query_DistAlgo": { "description": "The distributed graph algorithm a `DistributedCompute` / matview runs across\nshards (CONCEPT:EG-KG.storage.feature). Each is a vertex-centric (Pregel/GAS) computation the\ncross-shard superstep coordinator drives; the single-shard fast path stays the\nalways-on `PageRank`/`ConnectedComponents` ops.", "oneOf": [ { "additionalProperties": false, "description": "PageRank \u2014 `damping`\u00b7rank-mass propagation for `iterations` supersteps. The\ncross-shard result matches the single-graph result on the UNION graph.", "properties": { "PageRank": { "properties": { "damping": { "format": "double", "type": "number" }, "iterations": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "damping", "iterations" ], "type": "object" } }, "required": [ "PageRank" ], "type": "object" }, { "const": "ConnectedComponents", "description": "Weakly-connected components \u2014 every vertex labeled with its component's\nrepresentative, via label-propagation supersteps to a fixpoint.", "type": "string" }, { "additionalProperties": false, "description": "BFS levels from `source` \u2014 every reachable vertex labeled with its hop distance.", "properties": { "Bfs": { "properties": { "source": { "type": "string" } }, "required": [ "source" ], "type": "object" } }, "required": [ "Bfs" ], "type": "object" } ] }, "ResDef_Query_DualEntry": { "additionalProperties": false, "description": "One non-zero rational multiplier numerator.", "properties": { "numerator": { "$ref": "#/components/schemas/ResDef_Query_Scalar" }, "row": { "$ref": "#/components/schemas/ResDef_Query_RowId" } }, "required": [ "row", "numerator" ], "type": "object" }, "ResDef_Query_DurabilityDomain": { "description": "Authoritative durability domain for an operation.", "enum": [ "graph_rows", "graph_snapshot", "rdf_dataset", "sql_catalog", "blob_store", "kv_store", "time_series", "analytics_job", "semantic_index", "broker", "cross_modal", "multi_graph", "lifecycle", "control_plane" ], "type": "string" }, "ResDef_Query_EdgeSource": { "description": "Which side of a subsumption edge the engine got it from.", "oneOf": [ { "additionalProperties": false, "description": "The engine's own ontology.", "properties": { "edge": { "const": "native_ontology", "type": "string" } }, "required": [ "edge" ], "type": "object" }, { "additionalProperties": false, "description": "A component's own classification list.", "properties": { "component_id": { "type": "string" }, "edge": { "const": "component_classification", "type": "string" } }, "required": [ "edge", "component_id" ], "type": "object" } ] }, "ResDef_Query_Elimination": { "additionalProperties": false, "description": "One eliminated candidate and the rule that removed it.", "properties": { "component_id": { "type": "string" }, "violation": { "$ref": "#/components/schemas/ResDef_Query_Violation" } }, "required": [ "component_id", "violation" ], "type": "object" }, "ResDef_Query_EpistemicStatusResult": { "description": "Materialized result of a `Method::EpistemicStatus` run. Returned via\n`ResultPayload::raw`.", "properties": { "status": { "$ref": "#/components/schemas/ResDef_Query_EpistemicStatusWire" } }, "required": [ "status" ], "type": "object" }, "ResDef_Query_EpistemicStatusWire": { "description": "Wire mirror of `eg_epistemic::query::EpistemicStatus` \u2014 the Phase-3 acceptance\ncapstone (see `Method::EpistemicStatus` docs).", "properties": { "attacking": { "items": { "type": "string" }, "type": "array" }, "authority": { "$ref": "#/components/schemas/ResDef_Query_AuthorityPolicyWire" }, "believed": { "type": "boolean" }, "claim": { "type": "string" }, "confidence": { "format": "double", "type": "number" }, "contradicting": { "items": { "type": "string" }, "type": "array" }, "evidence": { "items": { "type": "string" }, "type": "array" }, "proof": { "$ref": "#/components/schemas/ResDef_Query_JustificationNodeWire" }, "tx_time": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } ], "type": [ "array", "null" ] }, "uncertainty": { "format": "double", "type": "number" }, "valid_time": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } ], "type": [ "array", "null" ] }, "what_would_invalidate": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_MinimalFlipSetWire" }, { "type": "null" } ] }, "why_not": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_WhyNotWire" }, { "type": "null" } ] } }, "required": [ "claim", "believed", "confidence", "uncertainty", "proof", "evidence", "contradicting", "attacking", "authority" ], "type": "object" }, "ResDef_Query_EstimatorParams": { "description": "Hyperparameters for the estimators. All optional; per-estimator defaults are\napplied at fit time to mirror scikit-learn's defaults.", "properties": { "C": { "format": "double", "type": [ "number", "null" ] }, "alpha": { "format": "double", "type": [ "number", "null" ] }, "epsilon": { "format": "double", "type": [ "number", "null" ] }, "gamma": { "format": "double", "type": [ "number", "null" ] }, "kernel": { "type": [ "string", "null" ] }, "l1_ratio": { "format": "double", "type": [ "number", "null" ] }, "learning_rate": { "format": "double", "type": [ "number", "null" ] }, "max_depth": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "max_features": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "max_iter": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "min_samples_leaf": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "min_samples_split": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "n_estimators": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "random_state": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "subsample": { "format": "double", "type": [ "number", "null" ] }, "tol": { "format": "double", "type": [ "number", "null" ] } }, "type": "object" }, "ResDef_Query_EvalCandidate": { "description": "What is being evaluated.", "oneOf": [ { "additionalProperties": false, "description": "A fit job's draft artifact, pinned by content digest.", "properties": { "candidate": { "const": "draft_artifact", "type": "string" }, "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "sha256": { "type": "string" } }, "required": [ "candidate", "sha256", "length" ], "type": "object" }, { "additionalProperties": false, "description": "An already-published head.", "properties": { "candidate": { "const": "published_head", "type": "string" }, "head": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" } }, "required": [ "candidate", "head" ], "type": "object" } ] }, "ResDef_Query_EvidenceAddressWire": { "description": "DAG-safe wire mirror of `eg_modality::EvidenceAddress`.", "oneOf": [ { "properties": { "end": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "const": "character_range", "type": "string" }, "start": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "start", "end" ], "type": "object" }, { "properties": { "col_end": { "format": "uint64", "minimum": 0, "type": "integer" }, "col_start": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "const": "table_cell_range", "type": "string" }, "row_end": { "format": "uint64", "minimum": 0, "type": "integer" }, "row_start": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "row_start", "row_end", "col_start", "col_end" ], "type": "object" }, { "properties": { "height": { "format": "double", "type": "number" }, "kind": { "const": "image_region", "type": "string" }, "width": { "format": "double", "type": "number" }, "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "kind", "x", "y", "width", "height" ], "type": "object" }, { "properties": { "height": { "format": "double", "type": "number" }, "kind": { "const": "page_region", "type": "string" }, "page": { "format": "uint32", "minimum": 0, "type": "integer" }, "width": { "format": "double", "type": "number" }, "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "kind", "page", "x", "y", "width", "height" ], "type": "object" }, { "properties": { "end_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "const": "audio_range", "type": "string" }, "start_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "start_ms", "end_ms" ], "type": "object" }, { "properties": { "end_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "const": "video_time_range", "type": "string" }, "start_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "start_ms", "end_ms" ], "type": "object" }, { "properties": { "end_frame": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "const": "frame_range", "type": "string" }, "start_frame": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "start_frame", "end_frame" ], "type": "object" }, { "properties": { "end_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "const": "metric_window", "type": "string" }, "start_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "start_ms", "end_ms" ], "type": "object" }, { "properties": { "kind": { "const": "point", "type": "string" }, "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "kind", "x", "y" ], "type": "object" }, { "properties": { "kind": { "const": "row_version", "type": "string" }, "row_ref": { "type": "string" }, "version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "row_ref", "version" ], "type": "object" }, { "properties": { "end_line": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "code_symbol", "type": "string" }, "revision_ref": { "type": "string" }, "start_line": { "format": "uint32", "minimum": 0, "type": "integer" }, "symbol_ref": { "type": "string" } }, "required": [ "kind", "revision_ref", "symbol_ref", "start_line", "end_line" ], "type": "object" }, { "properties": { "kind": { "const": "trace_span", "type": "string" }, "span_ref": { "type": "string" }, "trace_ref": { "type": "string" } }, "required": [ "kind", "trace_ref", "span_ref" ], "type": "object" } ] }, "ResDef_Query_EvidenceBundle": { "additionalProperties": false, "properties": { "answer_ref": { "type": [ "string", "null" ] }, "bundle_id": { "type": "string" }, "claims": { "items": { "$ref": "#/components/schemas/ResDef_Query_EvidenceClaim" }, "type": "array" }, "next_action_refs": { "items": { "type": "string" }, "type": "array" }, "policy_exclusions": { "items": { "type": "string" }, "type": "array" }, "resolved": { "type": "boolean" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_EvidenceBundleSchemaVersion" } }, "required": [ "schema_version", "bundle_id", "resolved", "claims", "policy_exclusions", "next_action_refs" ], "type": "object" }, "ResDef_Query_EvidenceBundleSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_EvidenceCitationWire": { "description": "Wire mirror of `eg_epistemic::EvidenceCitation` \u2014 one node bearing on a claim\n(support/contradiction/attack), together with its complete governed locus.\n`kind` is the `Debug`-rendered `eg_epistemic::EdgeKind`\n(`\"Supports\"`/`\"Contradicts\"`/`\"Attacks\"`), the SAME flat-string convention\n`JustificationNodeWire::rule` uses for its `JustRule`. `locus` reuses\n[`EvidenceLocusWire`] (the governed evidence-locus wire mirror \u2014\n`epistemic` implies `query`, so it is always nameable here).", "properties": { "evidence_id": { "type": "string" }, "kind": { "description": "One of `\"Supports\"`, `\"Contradicts\"`, `\"Attacks\"`.", "type": "string" }, "locus": { "$ref": "#/components/schemas/ResDef_Query_EvidenceLocusWire" }, "resolved": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ResolvedArtifactWire" }, { "type": "null" } ], "default": null, "description": "SURPASS gap-closure (\"unify the two evidence resolvers\"): the REAL content\nthis citation's `locus` resolves to, via `eg_alignment::EvidenceResolver`\n(`src/server/blob/cas_resolver.rs`'s `CasEvidenceResolver`, the SAME\nengine-backed resolver that previously had zero served-RPC call sites \u2014 only\nits own unit tests exercised it). `None` when the build lacks the `alignment`\nfeature, no blob store is configured, or the resolver had nothing for the\nlocus subject (e.g. a dangling `blob_ref`) \u2014 degrades to the\npre-existing locus-only behavior, never a fabricated resolution." } }, "required": [ "evidence_id", "kind", "locus" ], "type": "object" }, "ResDef_Query_EvidenceClaim": { "additionalProperties": false, "properties": { "claim_ref": { "type": "string" }, "confidence": { "format": "double", "type": "number" }, "contradiction_refs": { "items": { "type": "string" }, "type": "array" }, "evidence_locus_refs": { "items": { "type": "string" }, "type": "array" }, "kind": { "type": "string" }, "policy_labels": { "items": { "type": "string" }, "type": "array" }, "proof_refs": { "items": { "type": "string" }, "type": "array" }, "score": { "format": "double", "type": [ "number", "null" ] }, "source_refs": { "items": { "type": "string" }, "type": "array" }, "transaction_time": { "$ref": "#/components/schemas/ResDef_Query_EvidenceTimeRange" }, "valid_time": { "$ref": "#/components/schemas/ResDef_Query_EvidenceTimeRange" } }, "required": [ "claim_ref", "kind", "confidence", "valid_time", "transaction_time", "source_refs", "evidence_locus_refs", "contradiction_refs", "proof_refs", "policy_labels" ], "type": "object" }, "ResDef_Query_EvidenceClass": { "description": "The weakest class of evidence the conclusion rests on.", "enum": [ "proof", "observation", "claim" ], "type": "string" }, "ResDef_Query_EvidenceLocusWire": { "description": "The sole located-evidence wire representation. Its custom deserializer rejects\nunsafe references and malformed coordinates before a request reaches a handler.", "properties": { "address": { "$ref": "#/components/schemas/ResDef_Query_EvidenceAddressWire" }, "derivation_ref": { "type": "string" }, "id": { "type": "string" }, "policy_ref": { "type": "string" }, "subject": { "$ref": "#/components/schemas/ResDef_Query_EvidenceResourceWire" } }, "required": [ "id", "subject", "address", "policy_ref", "derivation_ref" ], "type": "object" }, "ResDef_Query_EvidenceRecord": { "properties": { "content_digest": { "type": "string" }, "evidence_id": { "type": "string" }, "locus_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "modality": { "type": "string" }, "object_id": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ResDef_Query_MaterialOperation" } }, "required": [ "evidence_id", "operation", "object_id", "modality", "locus_msgpack", "content_digest" ], "type": "object" }, "ResDef_Query_EvidenceResourceWire": { "description": "DAG-safe wire mirror of `eg_modality::ResourceId` for an evidence subject.", "oneOf": [ { "properties": { "id": { "type": "string" }, "kind": { "const": "artifact", "type": "string" } }, "required": [ "kind", "id" ], "type": "object" }, { "properties": { "id": { "type": "string" }, "kind": { "const": "occurrence", "type": "string" } }, "required": [ "kind", "id" ], "type": "object" }, { "properties": { "id": { "type": "string" }, "kind": { "const": "rendition", "type": "string" } }, "required": [ "kind", "id" ], "type": "object" }, { "properties": { "id": { "type": "string" }, "kind": { "const": "segment", "type": "string" } }, "required": [ "kind", "id" ], "type": "object" }, { "properties": { "id": { "type": "string" }, "kind": { "const": "feature", "type": "string" } }, "required": [ "kind", "id" ], "type": "object" }, { "properties": { "id": { "type": "string" }, "kind": { "const": "evidence_locus", "type": "string" } }, "required": [ "kind", "id" ], "type": "object" } ] }, "ResDef_Query_EvidenceTimeRange": { "additionalProperties": false, "properties": { "end_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "start_ms": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "ResDef_Query_ExistenceSignalWire": { "description": "Wire mirror of `eg_epistemic::redact::ExistenceSignal`.", "enum": [ "Supported", "Contradicted", "Uncertain" ], "type": "string" }, "ResDef_Query_ExplainBeliefRedactedResult": { "description": "Result of a `Method::ExplainBelief` call that set `disclosure_level` (feature\n`epistemic-redaction`) \u2014 returned via `ResultPayload::raw` INSTEAD OF\n`ExplainBeliefResult` for that same call (the caller who set `disclosure_level`\nalready knows to decode this type). Wire mirror of\n`eg_epistemic::redact::RedactedJustificationGraph`.", "properties": { "existence": { "$ref": "#/components/schemas/ResDef_Query_ExistenceSignalWire" }, "level": { "$ref": "#/components/schemas/ResDef_Query_DisclosureLevelWire" }, "root": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_RedactedJustificationNodeWire" }, { "type": "null" } ], "description": "`Some` at `Full`/`Skeleton`; `None` at `ExistenceOnly` (no structure rendered)." } }, "required": [ "level", "existence" ], "type": "object" }, "ResDef_Query_ExplainBeliefResponse": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ExplainBeliefRedactedResult" }, { "$ref": "#/components/schemas/ResDef_Query_ExplainBeliefResult" } ], "description": "Unified response body for `Method::ExplainBelief`.\n\nThe classic and disclosure-aware forms remain distinct on the wire while the\nmethod has one stable result type for callers that support both modes." }, "ResDef_Query_ExplainBeliefResult": { "description": "Materialized result of a `Method::ExplainBelief` run. Returned via `ResultPayload::raw`.", "properties": { "root": { "$ref": "#/components/schemas/ResDef_Query_JustificationNodeWire" } }, "required": [ "root" ], "type": "object" }, "ResDef_Query_ExplainEvidenceResult": { "description": "Materialized result of a `Method::ExplainEvidence` run. Returned via\n`ResultPayload::raw`.", "properties": { "citations": { "items": { "$ref": "#/components/schemas/ResDef_Query_EvidenceCitationWire" }, "type": "array" } }, "required": [ "citations" ], "type": "object" }, "ResDef_Query_ExplainNodeWire": { "description": "One node of an `EXPLAIN PLAN` dump \u2014 the wire projection of an `eg_plan::dag::PlanNode`,\nannotated with the SAME plan-time cost/cardinality estimate\n(`eg_plan::ModalityCardinality`) the cost optimizer itself reorders on \u2014 so `EXPLAIN\nPLAN` proves *why* a rewrite happened (bounded candidate/rerank/decode work, not just\n*that* the op order changed). All estimate fields are plan-time abstract-unit numbers\nover the SAME RLS-filtered snapshot the plan would execute against (CONCEPT:GOC-12,\ncross-modal query intelligence) \u2014 never derived from an unfiltered store, so a denied\nrow can never inflate another agent's estimated candidate/cost numbers either (see\n`eg-types` Rule R1: cost metadata lives on this wire projection, never on `Op` itself).", "properties": { "estimated_cost_cpu": { "description": "Estimated CPU work in abstract units (`eg_plan::CostEstimate::cpu`).", "format": "double", "type": "number" }, "estimated_cost_io": { "description": "Estimated I/O work in abstract units \u2014 index probes / blob reads\n(`eg_plan::CostEstimate::io`).", "format": "double", "type": "number" }, "estimated_rows_in": { "description": "Estimated rows flowing INTO this node \u2014 `0.0` for a source (no inputs), the prior\nnode's `estimated_rows_out` for a single-input node, and the SUM of every input's\n`estimated_rows_out` for a multi-input (fan-in/join) node \u2014 a documented, safe\nover-estimate for the rare branch case; execution semantics are unaffected either\nway since EXPLAIN never executes an op.", "format": "double", "type": "number" }, "estimated_rows_out": { "description": "Estimated rows this node emits (`eg_plan::Cardinality::rows_out`).", "format": "double", "type": "number" }, "estimated_selectivity": { "description": "Estimated output selectivity \u2014 `rows_out / rows_in`, clamped `[0, 1]`\n(`eg_plan::ModalityCardinality::selectivity`); `1.0` for a source.", "format": "double", "type": "number" }, "id": { "format": "uint", "minimum": 0, "type": "integer" }, "inputs": { "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" }, "op": { "description": "`Debug`-rendered `eg_plan::Op`.", "type": "string" } }, "required": [ "id", "op", "inputs", "estimated_rows_in", "estimated_rows_out", "estimated_selectivity", "estimated_cost_cpu", "estimated_cost_io" ], "type": "object" }, "ResDef_Query_ExplainPlanResult": { "description": "Materialized result of a `Method::ExplainPlan` run. Returned via `ResultPayload::raw`.", "properties": { "after": { "description": "The plan as a `PlanDag` AFTER `eg_plan::optimizer::optimize_dag`.", "items": { "$ref": "#/components/schemas/ResDef_Query_ExplainNodeWire" }, "type": "array" }, "applied_rules": { "description": "The active optimizer rule set, in application order (`eg_plan::cost_opt_rule_names()`).", "items": { "type": "string" }, "type": "array" }, "before": { "description": "The plan as a `PlanDag` BEFORE the DAG-aware cost optimizer.", "items": { "$ref": "#/components/schemas/ResDef_Query_ExplainNodeWire" }, "type": "array" } }, "required": [ "before", "after", "applied_rules" ], "type": "object" }, "ResDef_Query_ExplainPolicyResult": { "description": "Materialized result of a `Method::ExplainPolicy` run (CONCEPT:EG-KG.sharding.row-level-security).\nReturned via `ResultPayload::raw`.", "properties": { "policy_denied_ids": { "description": "Ids present in the UNFILTERED result but absent from `visible_ids` \u2014 what the\npolicy denied. Always empty when no RLS filtering applied (no `security` feature,\nor no caller/RLS on this connection).", "items": { "type": "string" }, "type": "array" }, "visible_ids": { "description": "Ids the caller's RLS-filtered view actually returns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "visible_ids", "policy_denied_ids" ], "type": "object" }, "ResDef_Query_ExplorationBudget": { "additionalProperties": false, "description": "How much exploration a cold, uncalibrated question may spend.", "properties": { "fraction": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, "questions": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_16", "description": "Question ids exploration is permitted for. Empty forbids it everywhere." }, "spend_at_risk_micros": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "fraction", "spend_at_risk_micros", "questions" ], "type": "object" }, "ResDef_Query_ExplorationRecord": { "additionalProperties": false, "description": "A committed exploration draw: the seed is committed before the draw and\nrevealed after, so the draw cannot be chosen after the fact.", "properties": { "budget_digest": { "type": "string" }, "revealed_seed": { "default": null, "type": [ "string", "null" ] }, "seed_commitment": { "type": "string" } }, "required": [ "seed_commitment", "budget_digest" ], "type": "object" }, "ResDef_Query_FactQuality": { "description": "How strong one declared fact is.\n\nA connector pack carries no measurement and no operator attestation, so a\nprice read out of one is neither measured nor estimated: it is\n[`FactQuality::Declared`], and a record that used it says so.", "enum": [ "measured", "estimated", "declared", "unavailable" ], "type": "string" }, "ResDef_Query_FeatureMatrixRef": { "description": "How the feature matrix the decision read is pinned.", "oneOf": [ { "additionalProperties": false, "description": "Small matrices travel inline, exactly, on a named fixed-point scale.", "properties": { "candidate_ids": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "feature_names": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_32" }, "matrix": { "const": "inline", "type": "string" }, "scale": { "$ref": "#/components/schemas/ResDef_Query_QuantScaleTag" }, "values": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_int64_2048" } }, "required": [ "matrix", "candidate_ids", "feature_names", "scale", "values" ], "type": "object" }, { "additionalProperties": false, "description": "Larger ones are pinned by content digest.", "properties": { "columns": { "format": "uint32", "minimum": 0, "type": "integer" }, "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "matrix": { "const": "blob", "type": "string" }, "rows": { "format": "uint32", "minimum": 0, "type": "integer" }, "sha256": { "type": "string" } }, "required": [ "matrix", "sha256", "length", "rows", "columns" ], "type": "object" } ] }, "ResDef_Query_FeatureRecord": { "properties": { "feature_id": { "type": "string" }, "kind": { "type": "string" }, "model_version": { "type": "string" }, "object_id": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ResDef_Query_MaterialOperation" }, "value_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "feature_id", "operation", "object_id", "kind", "value_msgpack", "model_version" ], "type": "object" }, "ResDef_Query_FeatureStep": { "description": "One ordered feature-construction step. Steps run left\u2192right: the first PRODUCING\nstep (`Embedding`/`NodeVector`) yields the `(node_id, row)` matrix; later transform\nsteps (`Normalize`) rewrite the rows in place. An empty step list \u21d2 the caller's\nexplicit `x` matrix is used verbatim.", "oneOf": [ { "description": "Structural node embeddings computed over the label subgraph \u2014 `method` is\n`fastrp` (default, training-free) or `node2vec` (biased walks + SGNS). The\nwalk/epoch knobs apply to `node2vec`; `iterations` to `fastrp`.", "properties": { "dim": { "default": 64, "format": "uint", "minimum": 0, "type": "integer" }, "epochs": { "default": 5, "format": "uint", "minimum": 0, "type": "integer" }, "iterations": { "default": 3, "format": "uint", "minimum": 0, "type": "integer" }, "method": { "default": "fastrp", "type": "string" }, "seed": { "default": 7, "format": "uint64", "minimum": 0, "type": "integer" }, "step": { "const": "embedding", "type": "string" }, "walk_length": { "default": 40, "format": "uint", "minimum": 0, "type": "integer" }, "walks_per_node": { "default": 10, "format": "uint", "minimum": 0, "type": "integer" }, "window": { "default": 5, "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "step" ], "type": "object" }, { "description": "Read each source node's pre-stored embedding vector from the SemanticStore\n(the \"classify these nodes by their existing embeddings\" path).", "properties": { "step": { "const": "node_vector", "type": "string" } }, "required": [ "step" ], "type": "object" }, { "description": "L2-normalize each feature row in place (a zero row is left untouched).", "properties": { "step": { "const": "normalize", "type": "string" } }, "required": [ "step" ], "type": "object" } ] }, "ResDef_Query_FittedClassifier": { "description": "Serializable fitted classifier returned by `mining::classify::fit` and consumed\nback by `mining::classify::predict` (the PREDICTIVE fit\u2192blob\u2192predict pair). Lives\nin eg-types so `Method::MineClassifyPredict` can embed the model over the wire \u2014\nexactly like `FittedModel` carries the datascience regressors. `classes` is the\nsorted set of integer labels; every score/proba vector is column-ordered by it.", "oneOf": [ { "description": "Gaussian Naive Bayes \u2014 per-class prior + per-feature (mean, variance).", "properties": { "kind": { "const": "GaussianNb", "type": "string" }, "model": { "properties": { "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "means": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "priors": { "items": { "format": "double", "type": "number" }, "type": "array" }, "vars": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "classes", "priors", "means", "vars" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "Multinomial Naive Bayes \u2014 per-class log-prior + Laplace-smoothed feature log-probs.", "properties": { "kind": { "const": "MultinomialNb", "type": "string" }, "model": { "properties": { "class_log_prior": { "items": { "format": "double", "type": "number" }, "type": "array" }, "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "feature_log_prob": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "classes", "class_log_prior", "feature_log_prob" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "k-NN \u2014 the lazy classifier stores its training rows + labels for the vote.", "properties": { "kind": { "const": "Knn", "type": "string" }, "model": { "properties": { "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "k": { "format": "uint", "minimum": 0, "type": "integer" }, "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "required": [ "k", "classes", "x", "y" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "description": "One-vs-rest linear classifier (`kind` = `logistic` | `svc`): a weight vector +\nbias per class. Prediction is argmax of the per-class score.", "properties": { "kind": { "const": "LinearOvr", "type": "string" }, "model": { "properties": { "biases": { "items": { "format": "double", "type": "number" }, "type": "array" }, "classes": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "kind": { "type": "string" }, "weights": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "kind", "classes", "weights", "biases" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" } ] }, "ResDef_Query_FittedModel": { "description": "Serializable fitted model returned by `fit_estimator`.", "oneOf": [ { "properties": { "kind": { "const": "Linear", "type": "string" }, "model": { "properties": { "coefficients": { "items": { "format": "double", "type": "number" }, "type": "array" }, "intercept": { "format": "double", "type": "number" } }, "required": [ "coefficients", "intercept" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Tree", "type": "string" }, "model": { "$ref": "#/components/schemas/ResDef_Query_DecisionTree" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Forest", "type": "string" }, "model": { "properties": { "trees": { "items": { "$ref": "#/components/schemas/ResDef_Query_DecisionTree" }, "type": "array" } }, "required": [ "trees" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "GradientBoosting", "type": "string" }, "model": { "properties": { "init": { "format": "double", "type": "number" }, "learning_rate": { "format": "double", "type": "number" }, "trees": { "items": { "$ref": "#/components/schemas/ResDef_Query_DecisionTree" }, "type": "array" } }, "required": [ "init", "learning_rate", "trees" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "AdaBoost", "type": "string" }, "model": { "properties": { "trees": { "items": { "$ref": "#/components/schemas/ResDef_Query_DecisionTree" }, "type": "array" }, "weights": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "trees", "weights" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" }, { "properties": { "kind": { "const": "Svr", "type": "string" }, "model": { "properties": { "dual_coef": { "items": { "format": "double", "type": "number" }, "type": "array" }, "gamma": { "format": "double", "type": "number" }, "intercept": { "format": "double", "type": "number" }, "kernel": { "type": "string" }, "support_vectors": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "support_vectors", "dual_coef", "intercept", "kernel", "gamma" ], "type": "object" } }, "required": [ "kind", "model" ], "type": "object" } ] }, "ResDef_Query_FleetCatalogCursor": { "additionalProperties": false, "description": "Where a page resumes, fenced to the snapshot that produced it.", "properties": { "after_id": { "type": "string" }, "after_name": { "description": "Exclusive `(lowercased name, id)` lower bound for the next page.", "type": "string" }, "snapshot_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256", "description": "Digest of the whole visible, filtered snapshot of the page's kind. The\nfence is content, not a graph revision: a registry heartbeat that changes\nnothing this kind shows must not invalidate a caller's cursor." } }, "required": [ "after_name", "after_id", "snapshot_digest" ], "type": "object" }, "ResDef_Query_FleetCatalogKind": { "description": "Which kind of row a page lists.", "enum": [ "discoveries", "tools", "prompts", "resources", "skills" ], "type": "string" }, "ResDef_Query_FleetCatalogListRequest": { "additionalProperties": false, "description": "Read one bounded page of one kind.", "properties": { "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_FleetCatalogCursor" }, { "type": "null" } ], "default": null }, "grant_digests": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_Digest256_64", "default": [], "description": "The caller's CURRENT grant fingerprints. Only narrows: an OAuth-scoped\nrow is visible when its principal is the verified caller AND its grant\nis listed here; nothing listed here can widen past the caller." }, "kind": { "$ref": "#/components/schemas/ResDef_Query_FleetCatalogKind" }, "limit": { "default": null, "description": "`None` selects the maximum page size.", "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] }, "query": { "default": null, "description": "Case-insensitive substring over name, server name and description.", "type": [ "string", "null" ] } }, "required": [ "kind" ], "type": "object" }, "ResDef_Query_FleetCatalogLookupRequest": { "additionalProperties": false, "description": "Read the visible rows for a batch of ids of any kind: component ids for\ncontent rows, discovery ids for observations. An id the caller may not see\nis absent from the answer exactly as an unknown id is.", "properties": { "grant_digests": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_Digest256_64", "default": [] }, "ids": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_256" } }, "required": [ "ids" ], "type": "object" }, "ResDef_Query_FleetCatalogOp": { "description": "Every fleet catalog operation.\n\nThe read/write split and the authorization action live on the op, so the\ncapability ledger and the server's write classifier cannot disagree about\nan operation.", "oneOf": [ { "additionalProperties": false, "description": "Record one server's latest discovery observation under one scope.", "properties": { "op": { "const": "record_discovery", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_FleetDiscoveryRecordRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Set one durable operator override on a published component.", "properties": { "op": { "const": "set_override", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_FleetOverrideSetRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Clear one durable operator override.", "properties": { "op": { "const": "clear_override", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_FleetOverrideClearRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Read one bounded, snapshot-fenced page of one kind.", "properties": { "op": { "const": "list", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_FleetCatalogListRequest" } }, "required": [ "op", "request" ], "type": "object" }, { "additionalProperties": false, "description": "Read the visible rows for a batch of ids, of any kind.", "properties": { "op": { "const": "lookup", "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Query_FleetCatalogLookupRequest" } }, "required": [ "op", "request" ], "type": "object" } ] }, "ResDef_Query_FleetDiscoveryRecordRequest": { "additionalProperties": false, "description": "Record one server's latest discovery observation under one scope.\n\nOne record per `(tenant, server_name, scope)`; a later observation replaces\nthe earlier one through a compare-and-set on its revision.", "properties": { "connector": { "description": "The connector whose pack holds what this probe observed. The join from\nobservation to content: every `mcp:/...` component inherits\nthis observation's visibility.", "type": "string" }, "counts": { "$ref": "#/components/schemas/ResDef_Query_DiscoveryCounts", "default": { "prompts": 0, "resources": 0, "skills": 0, "tools": 0 } }, "expected_revision": { "default": null, "description": "`None` writes unconditionally; `Some(0)` requires that no record exists\nyet; `Some(n)` requires the stored revision to be exactly `n`.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "outcome": { "$ref": "#/components/schemas/ResDef_Query_DiscoveryOutcome" }, "scope": { "$ref": "#/components/schemas/ResDef_Query_DiscoveryScope" }, "server_name": { "description": "The registry name the server registers under.", "type": "string" } }, "required": [ "server_name", "scope", "connector", "outcome" ], "type": "object" }, "ResDef_Query_FleetOverride": { "description": "One durable operator override. Closed, one variant per field.", "oneOf": [ { "additionalProperties": false, "description": "Reclassify a skill. Survives every re-import of its pack, because the\nimport never writes override records and the projection applies them at\nread time.", "properties": { "field": { "const": "skill_type", "type": "string" }, "skill_type": { "$ref": "#/components/schemas/ResDef_Query_SkillType" } }, "required": [ "field", "skill_type" ], "type": "object" } ] }, "ResDef_Query_FleetOverrideClearRequest": { "additionalProperties": false, "description": "Clear one durable operator override. A cleared override is a tombstone\nrevision, not a deletion, so the compare-and-set chain never restarts.", "properties": { "component_id": { "type": "string" }, "expected_revision": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "field": { "$ref": "#/components/schemas/ResDef_Query_FleetOverrideField" } }, "required": [ "component_id", "field" ], "type": "object" }, "ResDef_Query_FleetOverrideField": { "description": "The field an override record governs; one record per `(component, field)`.", "enum": [ "skill_type" ], "type": "string" }, "ResDef_Query_FleetOverrideSetRequest": { "additionalProperties": false, "description": "Set one durable operator override.", "properties": { "component_id": { "type": "string" }, "expected_revision": { "default": null, "description": "Same compare-and-set meaning as on a discovery record.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "value": { "$ref": "#/components/schemas/ResDef_Query_FleetOverride" } }, "required": [ "component_id", "value" ], "type": "object" }, "ResDef_Query_ForecastAlgorithm": { "description": "Which forecasting engine `MineForecast` runs (CONCEPT:EG-KG.mining.arima \u2014\nPhase 4). ARIMA is the default (Hannan-Rissanen AR(p)/MA(q) after `d`-order\ndifferencing); `holtwinters` degrades to Holt's linear-trend method when\n`period` is 0; `stl` is a classical decomposition + extrapolation.", "enum": [ "arima", "holtwinters", "stl" ], "type": "string" }, "ResDef_Query_ForeignSourceSpec": { "description": "A FOREIGN (external) RowSet source for the federation `Op::ForeignScan`\n(CONCEPT:EG-KG.query.query-federation, Lane P). A federated query reads rows from a source OUTSIDE\nthe local engine and composes them with the local graph/vector/SQL ops \u2014 so a\n`ForeignScan` is just another RowSet leaf, like `Scan`/`Reason`/`SparqlBgp`. Two\nkinds, behind one wire enum; the `ForeignSource` trait in eg-plan turns each into\na [`crate::RowSet`].", "oneOf": [ { "additionalProperties": false, "description": "A REMOTE epistemic-graph engine, reached over the SAME length-prefixed\nMessagePack + HMAC transport this engine speaks. The federation client\nconnects to `endpoint` (a `host:port` TCP address), sends a `UnifiedQueryText`\n(UQL) \u2014 or, when `uql` is empty, a `CypherQuery` \u2014 against the remote `graph`,\nand projects the result rows into a local RowSet. Every request is an `eg2.`\nverified-context envelope; an empty secret or incomplete context fails before\ndialing. This composes the engine with ANOTHER engine without a Python\nround-trip \u2014 the cross-engine federation seam.", "properties": { "RemoteEngine": { "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_RequestContextClaims", "default": { "agent_id": "", "audience": "", "delegation": [], "policy_version": "", "principal": "", "roles": [], "scopes": [], "tenant": "" }, "description": "Identity, tenant, audience, capabilities, active policy version, and\ndelegation path signed into every remote request. The receiving engine\nindependently checks these claims against deployment policy and RBAC.\nBoxed: `RequestContextClaims` is the single field that made this the\nlargest `ForeignSourceSpec` variant by a wide margin." }, "cypher": { "default": "", "description": "A Cypher query run on the remote when `uql` is empty (must `RETURN` an id\ncolumn named by `id_field`).", "type": "string" }, "endpoint": { "description": "`host:port` of the remote engine's TCP listener.", "type": "string" }, "graph": { "description": "The remote graph to query (e.g. `__commons__`).", "type": "string" }, "id_field": { "default": "", "description": "For the Cypher path: the RETURN column that carries the node id. Ignored on\nthe UQL path (a UQL plan's rows are already `[id, score?]`).", "type": "string" }, "secret": { "default": "", "description": "HMAC-SHA256 secret used by the remote verified-context issuer. Empty is\ninvalid; native federation never downgrades to insecure or legacy auth.", "type": "string" }, "uql": { "default": "", "description": "A UQL query run on the remote (its rows seed the RowSet). When empty, `cypher`\nis used instead.", "type": "string" } }, "required": [ "endpoint", "graph" ], "type": "object" } }, "required": [ "RemoteEngine" ], "type": "object" }, { "additionalProperties": false, "description": "A GENERIC HTTP/JSON source. The federation client issues an HTTP GET to `url`\n(pure-Rust rustls client \u2014 NOT openssl, gated OUT of the Pi tier), walks the\nJSON response to the array at `json_path` (a dotted path, e.g. `data.items`),\nand maps each element into a RowSet row via `field_map`: the element field\nnamed `field_map.id` becomes the row id, and (optionally) `field_map.score`\nbecomes the row score. Any external REST API thereby becomes a joinable RowSet.", "properties": { "HttpJson": { "properties": { "field_map": { "$ref": "#/components/schemas/ResDef_Query_HttpFieldMap", "description": "Maps a JSON element to a RowSet row (which field is the id / the score)." }, "json_path": { "default": "", "description": "Dotted path to the JSON array of rows (empty \u21d2 the response is itself the\narray).", "type": "string" }, "url": { "description": "The HTTP(S) URL to GET.", "type": "string" } }, "required": [ "url", "field_map" ], "type": "object" } }, "required": [ "HttpJson" ], "type": "object" }, { "additionalProperties": false, "description": "An EXTERNAL relational-SQL database (Postgres/MySQL/\u2026) (CONCEPT:EG-KG.query.feature). The\nfederation client connects to `dsn`, runs `query`, and maps each result row to a\nRowSet row: the column named `id_field` becomes the row id (stringified), and\n(optionally) `score_field` becomes the row score. This lets ONE unified plan JOIN\nan external SQL table with the LOCAL graph/vector \u2014 the \"engine federates external\nSQL\" half that sql-mcp alone cannot give: sql-mcp speaks SQL to the engine, this\nlets the engine speak SQL OUT to a foreign RDBMS and fuse the rows in-plan.\n\nThis wire variant is PURE serde (it carries only the DSN + query strings), so it\nis present whenever `federation` is on. The actual SQL *driver* (a pure-Rust /\nrustls client \u2014 NEVER openssl) lives in eg-plan behind its own `federation-sql`\ngate and is folded OUT of the Pi tier (the Pi contract: no SQL driver / rustls /\nopenssl). A `federation` build WITHOUT `federation-sql` accepts + registers a\n`Sql` spec but errors clearly if a plan actually tries to fetch it.", "properties": { "Sql": { "properties": { "dsn": { "description": "The external database DSN (e.g. `postgres://host:5432/db`).", "type": "string" }, "id_field": { "description": "The result column whose value is the row id (stringified).", "type": "string" }, "query": { "description": "The SQL query to run against the external DB. Its result columns are mapped\nto RowSet rows via `id_field` / `score_field`.", "type": "string" }, "score_field": { "default": null, "description": "The result column whose numeric value is the row score (absent \u21d2 unscored).", "type": [ "string", "null" ] } }, "required": [ "dsn", "query", "id_field" ], "type": "object" } }, "required": [ "Sql" ], "type": "object" }, { "additionalProperties": false, "description": "A NAMED reference to a foreign source registered in the executor's\n`ForeignSourceRegistry` (CONCEPT:EG-KG.query.closure-backed-source). Unlike the self-describing variants\nabove (which carry the full connection spec inline), this carries ONLY a `name`\n\u2014 the executor resolves it to a concrete, pre-registered [`ForeignSource`] at\nplan time. This is the resolution seam the UQL `FOREIGN \"\"` clause needs:\nthe parser only ever sees a name, and binding that name to a live source lives\nwith the server/facade (which owns the registry), not in the wire DTO. A `Named`\nspec handed to a source builder WITHOUT a registry is a clean typed error, never\na silent empty set.", "properties": { "Named": { "properties": { "name": { "description": "The registry key naming a pre-registered foreign source.", "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "Named" ], "type": "object" } ] }, "ResDef_Query_FuseClock": { "description": "FUSE \u2014 the DECLARED time base [`Op::SensorAlign`] resamples onto\n(CONCEPT:EG-KG.query.multi-rate-sensor-stream). This is what separates `SensorAlign` from `Op::SensorFuse`:\n`SensorFuse` fuses onto the UNION clock of the samples themselves (data-driven instants,\ntolerance/ASOF only), while `SensorAlign` fuses onto a clock the CALLER declares, so the\noutput instants are independent of when the sensors happened to fire.\n\n* `Uniform { from_ns, to_ns, step_ns }` \u2014 the half-open grid `from_ns, from_ns+step_ns,\n \u2026 < to_ns`. One fused row per grid instant.\n* `Tumbling { width_ns, step_ns }` \u2014 EG-067 tumbling windows of `width_ns` aligned as\n `(t/width)*width` spanning the union sample span, each internally resampled onto a\n `step_ns` sub-grid. One fused row per window.\n\nAll bounds are INTEGER nanoseconds, not `f64` seconds: a grid instant has to be exact\n(it is an output identity), and integer ns keeps it so.", "oneOf": [ { "additionalProperties": false, "properties": { "uniform": { "properties": { "from_ns": { "format": "int64", "type": "integer" }, "step_ns": { "format": "int64", "type": "integer" }, "to_ns": { "format": "int64", "type": "integer" } }, "required": [ "from_ns", "to_ns", "step_ns" ], "type": "object" } }, "required": [ "uniform" ], "type": "object" }, { "additionalProperties": false, "properties": { "tumbling": { "properties": { "step_ns": { "format": "int64", "type": "integer" }, "width_ns": { "format": "int64", "type": "integer" } }, "required": [ "width_ns", "step_ns" ], "type": "object" } }, "required": [ "tumbling" ], "type": "object" } ] }, "ResDef_Query_FuseInterp": { "description": "FUSE \u2014 the per-channel interpolation mode carried by [`FuseStream`]\n(CONCEPT:EG-KG.query.multi-rate-sensor-stream). Chosen PER STREAM because modalities differ: a pose is\n`Linear`-interpolable, a discrete mode/label wants `AsofHold`, a noisy raw reading may\nwant `Nearest`. PURE serde \u2014 the resampling math lives in `eg_tsdb::fusion` behind\neg-plan's `timeseries` gate; this is the wire variant.", "oneOf": [ { "const": "nearest", "description": "The closest sample in time to the grid instant (either side); a tie resolves to the\nEARLIER sample so the result is deterministic.", "type": "string" }, { "const": "linear", "description": "Linear interpolation between the two samples bracketing the grid instant. An instant\nOUTSIDE the sample span is a GAP \u2014 no extrapolation.", "type": "string" }, { "const": "asof_hold", "description": "Last-known value at-or-before the grid instant (forward-fill / zero-order hold). An\ninstant before the first sample is a GAP.", "type": "string" } ] }, "ResDef_Query_FuseStream": { "description": "FUSE \u2014 one input stream to [`Op::SensorAlign`] (CONCEPT:EG-KG.query.multi-rate-sensor-stream): the sensor\n`layer` (a node label / `type`, resolved off the snapshot exactly as `Op::SensorFuse`\nresolves its streams) plus the [`FuseInterp`] mode that channel is resampled under.\nPURE serde; this is the wire variant.", "properties": { "interp": { "$ref": "#/components/schemas/ResDef_Query_FuseInterp" }, "layer": { "type": "string" } }, "required": [ "layer", "interp" ], "type": "object" }, "ResDef_Query_Grant": { "description": "A grant binding a role to an (`resource`, `action`, `effect`) triple\n(CONCEPT:EG-KG.compute.feature).", "properties": { "action": { "$ref": "#/components/schemas/ResDef_Query_RbacAction" }, "effect": { "$ref": "#/components/schemas/ResDef_Query_GrantEffect" }, "resource": { "$ref": "#/components/schemas/ResDef_Query_ResourceSelector" }, "role": { "type": "string" } }, "required": [ "role", "resource", "action", "effect" ], "type": "object" }, "ResDef_Query_GrantEffect": { "description": "Whether a [`Grant`] permits or forbids the action (CONCEPT:EG-KG.compute.feature).", "enum": [ "Allow", "Deny" ], "type": "string" }, "ResDef_Query_GraphLearnParams": { "description": "Training + architecture knobs for `GraphLearnFit` (CONCEPT:EG-KG.graphlearn.link-predictor).", "properties": { "alpha": { "default": 0.5, "description": "1-hop neighbour-aggregation self-retention for the node-feature channel.", "format": "double", "type": "number" }, "basis": { "default": "chebyshev", "description": "Polynomial basis for the edge functions: `chebyshev` (default) or `jacobi`.", "type": "string" }, "degree": { "default": 4, "description": "Polynomial degree per edge function.", "format": "uint", "minimum": 0, "type": "integer" }, "epochs": { "default": 200, "description": "Adam training epochs.", "format": "uint", "minimum": 0, "type": "integer" }, "hidden": { "default": 0, "description": "Hidden width; `0` \u21d2 a single interpretable layer (one edge fn per feature).", "format": "uint", "minimum": 0, "type": "integer" }, "lr": { "default": 0.05, "description": "Adam learning rate.", "format": "double", "type": "number" }, "neg_ratio": { "default": 1.0, "description": "Negatives (sampled non-edges) per positive edge.", "format": "double", "type": "number" }, "seed": { "default": 42, "description": "Seed for negative sampling + parameter init (deterministic).", "format": "uint64", "minimum": 0, "type": "integer" } }, "type": "object" }, "ResDef_Query_GraphSchemaOp": { "description": "Attach, replace or detach one keyed schema source.", "oneOf": [ { "additionalProperties": false, "description": "Attach or replace the documents under `source_id`. At least one\ndocument must be given; attaching nothing is a detach, and saying so\nexplicitly is what stops an empty request from silently clearing a key.", "properties": { "if_composed_digest": { "default": null, "description": "Compare-and-set against the composed digest the caller last saw.", "type": [ "string", "null" ] }, "ontology_ttl": { "default": null, "type": [ "string", "null" ] }, "op": { "const": "attach", "type": "string" }, "shapes_ttl": { "default": null, "type": [ "string", "null" ] }, "source_id": { "type": "string" } }, "required": [ "op", "source_id" ], "type": "object" }, { "additionalProperties": false, "description": "Attach the current head of a connector's pack, under its reserved key.", "properties": { "connector": { "type": "string" }, "if_composed_digest": { "default": null, "type": [ "string", "null" ] }, "op": { "const": "attach_pack", "type": "string" } }, "required": [ "op", "connector" ], "type": "object" }, { "additionalProperties": false, "properties": { "if_composed_digest": { "default": null, "type": [ "string", "null" ] }, "op": { "const": "detach", "type": "string" }, "source_id": { "type": "string" } }, "required": [ "op", "source_id" ], "type": "object" } ] }, "ResDef_Query_GraphSource": { "description": "A graph-derived subgraph source for `GraphLearn*` (CONCEPT:EG-KG.graphlearn.link-predictor).\n\nEvery node carrying `node_label` becomes a vertex; edges among them (following\n`direction`, optionally filtered to `relation`) are the observed positive links\nthe KAN learns from. Isolated label instances are kept as candidate endpoints.", "properties": { "direction": { "default": "any", "description": "Edge direction to gather links: `any` (both, default \u2014 links are undirected\nfor prediction), `out` (successors), or `in` (predecessors).", "type": "string" }, "limit": { "description": "Cap the number of label nodes scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances form the learning subgraph's vertices.", "type": "string" }, "relation": { "description": "Optional edge-relation filter: only use edges whose `relationship` equals\nthis. `None` \u21d2 all edges among the label's nodes.", "type": [ "string", "null" ] } }, "required": [ "node_label" ], "type": "object" }, "ResDef_Query_GraphTextPropertyRef": { "additionalProperties": false, "properties": { "graph_id": { "type": "string" }, "property_id": { "type": "string" }, "type_id": { "type": "string" } }, "required": [ "graph_id", "type_id", "property_id" ], "type": "object" }, "ResDef_Query_GraphType": { "description": "Graph type for multi-tenant registry.", "enum": [ "Agent", "Team", "Global", "Commons" ], "type": "string" }, "ResDef_Query_HeadKind": { "description": "Which head shape a fit produces.", "oneOf": [ { "const": "weighted_features", "description": "One weight per feature; an advisory score that never acts.", "type": "string" }, { "const": "listwise_logistic", "description": "A listwise logistic model over the candidate set.", "type": "string" } ] }, "ResDef_Query_HttpFieldMap": { "description": "Which JSON element fields become a RowSet row's id / score (for\n[`ForeignSourceSpec::HttpJson`]).", "properties": { "id": { "description": "The element field whose value is the row id (stringified).", "type": "string" }, "score": { "default": null, "description": "The element field whose numeric value is the row score (absent \u21d2 unscored).", "type": [ "string", "null" ] } }, "required": [ "id" ], "type": "object" }, "ResDef_Query_IncarnationId": { "description": "Opaque logical-generation identity. It is never derived from a resource name.", "type": "string" }, "ResDef_Query_Incumbent": { "additionalProperties": false, "description": "A feasible assignment and its objective value.", "properties": { "objective": { "$ref": "#/components/schemas/ResDef_Query_ObjectiveValue" }, "selected": { "items": { "type": "boolean" }, "type": "array" } }, "required": [ "selected", "objective" ], "type": "object" }, "ResDef_Query_IssueControlLeaseRequest": { "additionalProperties": false, "description": "`IssueControlLease`: create one active lease, refused if the id exists.", "properties": { "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "grant": { "additionalProperties": true, "description": "The immutable grant body.", "type": "object" }, "hard_expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "description": "Caller-stable retry identity for this issue.", "type": "string" }, "issued_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "description": "Caller-defined lease family, e.g. `browser.control`.", "type": "string" }, "lease_id": { "type": "string" }, "tenant": { "description": "Must equal the verified request tenant.", "type": "string" } }, "required": [ "tenant", "lease_id", "kind", "grant", "issued_at_ms", "expires_at_ms", "hard_expires_at_ms", "idempotency_key" ], "type": "object" }, "ResDef_Query_ItemLabel": { "description": "The label of one item.", "oneOf": [ { "additionalProperties": false, "properties": { "acceptable": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "label": { "const": "gold", "type": "string" }, "source": { "$ref": "#/components/schemas/ResDef_Query_LabelSource" } }, "required": [ "label", "acceptable", "source" ], "type": "object" }, { "additionalProperties": false, "description": "One logged, executed decision.", "properties": { "commit_principal": { "type": "string" }, "evaluation": { "$ref": "#/components/schemas/ResDef_Query_OutcomeEvaluation" }, "executed": { "type": "string" }, "label": { "const": "logged", "type": "string" }, "logging_propensities": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_UnitRationalWire_64", "description": "Aligned with the item's candidates; must sum to exactly one." }, "pinned": { "description": "A pinned decision had propensity one by fiat and is excluded from\noff-policy estimates.", "type": "boolean" }, "propensity_source": { "$ref": "#/components/schemas/ResDef_Query_PropensitySource" } }, "required": [ "label", "executed", "logging_propensities", "propensity_source", "pinned", "commit_principal", "evaluation" ], "type": "object" } ] }, "ResDef_Query_JobKind": { "description": "Which analytics computation a job runs (CONCEPT:INT-P2-1).", "oneOf": [ { "additionalProperties": false, "description": "Association-rule mining over explicit transactions (mirrors\n`Method::MineAssociate`'s non-graph-derived path).", "properties": { "MineAssociate": { "properties": { "algorithm": { "default": "fpgrowth", "description": "`\"apriori\" | \"fpgrowth\" | \"eclat\"`; unrecognized \u21d2 facade error.", "type": "string" }, "min_confidence": { "default": 0.5, "format": "double", "type": "number" }, "min_support": { "default": 0.1, "format": "double", "type": "number" }, "transactions": { "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" } }, "required": [ "transactions" ], "type": "object" } }, "required": [ "MineAssociate" ], "type": "object" }, { "additionalProperties": false, "description": "Governed graph-native program compilation. The nested MessagePack is a\nversioned `eg_program::OptimizationRequest`; `eg-types` remains the bottom\nof the crate DAG and the server decodes/rebinds it at the verified boundary.", "properties": { "ProgramOptimize": { "properties": { "request_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "request_msgpack" ], "type": "object" } }, "required": [ "ProgramOptimize" ], "type": "object" } ] }, "ResDef_Query_JobOp": { "description": "The analytics-job control-plane operation (CONCEPT:INT-P2-1).", "oneOf": [ { "additionalProperties": false, "description": "Submit a new job. Runs asynchronously off the request \u2014 the response carries\nthe freshly durable `Submitted` job record (including its server-issued id),\nnot the eventual result.", "properties": { "Submit": { "$ref": "#/components/schemas/ResDef_Query_SubmitJobSpec" } }, "required": [ "Submit" ], "type": "object" }, { "additionalProperties": false, "description": "Fetch a job's current durable state (including checkpoint/progress).", "properties": { "Status": { "properties": { "job_id": { "type": "string" } }, "required": [ "job_id" ], "type": "object" } }, "required": [ "Status" ], "type": "object" }, { "additionalProperties": false, "description": "Cooperatively cancel a job (immediate if not yet started; the running\nexecutor observes the flag and stops otherwise).", "properties": { "Cancel": { "properties": { "job_id": { "type": "string" } }, "required": [ "job_id" ], "type": "object" } }, "required": [ "Cancel" ], "type": "object" }, { "additionalProperties": false, "description": "Resume a job from its last checkpoint \u2014 a `Failed` job with retries\nremaining, or a `Running` job orphaned by a crashed/restarted process.", "properties": { "Resume": { "properties": { "job_id": { "type": "string" } }, "required": [ "job_id" ], "type": "object" } }, "required": [ "Resume" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically claim the highest-priority eligible job. `worker_instance`\ndistinguishes concurrent slots for one authenticated principal; the server\nhashes it with the verified identity before persistence.", "properties": { "WorkerClaim": { "properties": { "capabilities": { "default": [], "items": { "type": "string" }, "type": "array" }, "lease_ms": { "default": 60000, "format": "uint64", "minimum": 0, "type": "integer" }, "worker_instance": { "default": "", "type": "string" } }, "type": "object" } }, "required": [ "WorkerClaim" ], "type": "object" }, { "additionalProperties": false, "description": "Renew the exact lease epoch owned by this authenticated worker slot.", "properties": { "WorkerRenew": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_ms": { "default": 60000, "format": "uint64", "minimum": 0, "type": "integer" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch" ], "type": "object" } }, "required": [ "WorkerRenew" ], "type": "object" }, { "additionalProperties": false, "description": "Persist a fenced progress checkpoint. `state_ref`, when present, must be an\nopaque external state reference rather than inline source/user content.", "properties": { "WorkerCheckpoint": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "progress": { "format": "double", "type": "number" }, "stage": { "type": "string" }, "state_ref": { "default": null, "type": [ "string", "null" ] }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch", "progress", "stage" ], "type": "object" } }, "required": [ "WorkerCheckpoint" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically stage the complete typed result before publication.", "properties": { "WorkerStage": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "result": { "$ref": "#/components/schemas/ResDef_Query_JobResult" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch", "result" ], "type": "object" } }, "required": [ "WorkerStage" ], "type": "object" }, { "additionalProperties": false, "description": "Commit evidence-bearing claims for a staged result and then mark success.", "properties": { "WorkerPublish": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch" ], "type": "object" } }, "required": [ "WorkerPublish" ], "type": "object" }, { "additionalProperties": false, "description": "Release a failed compute attempt through server-owned retry/backoff policy.", "properties": { "WorkerFail": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason_code": { "type": "string" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch", "reason_code" ], "type": "object" } }, "required": [ "WorkerFail" ], "type": "object" }, { "additionalProperties": false, "description": "Confirm that a worker cooperatively stopped after a cancellation request.", "properties": { "WorkerCancel": { "properties": { "job_id": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "worker_instance": { "type": "string" } }, "required": [ "job_id", "worker_instance", "lease_epoch" ], "type": "object" } }, "required": [ "WorkerCancel" ], "type": "object" } ] }, "ResDef_Query_JobReproducibilityManifest": { "description": "Reproducibility manifest bound server-side to the leased job lineage.", "properties": { "algorithm_ref": { "type": "string" }, "environment_version": { "type": "string" }, "implementation_version": { "type": "string" }, "input_content_digest": { "type": "string" }, "input_dataset_ref": { "type": "string" }, "input_snapshot_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "params_digest": { "type": "string" }, "policy_fingerprint": { "type": "string" } }, "required": [ "input_dataset_ref", "input_content_digest", "input_snapshot_version", "algorithm_ref", "params_digest", "implementation_version", "environment_version", "policy_fingerprint" ], "type": "object" }, "ResDef_Query_JobResult": { "description": "KnowledgeBatch-shaped result currency accepted by [`JobOp::WorkerStage`].", "properties": { "calibration": { "default": null, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "double", "type": "number" }, { "format": "double", "type": "number" } ], "type": [ "array", "null" ] }, "content_digest": { "type": "string" }, "counterexample_refs": { "default": [], "items": { "type": "string" }, "type": "array" }, "dataset_ref": { "type": "string" }, "evidence_refs": { "default": [], "items": { "type": "string" }, "type": "array" }, "reproducibility": { "$ref": "#/components/schemas/ResDef_Query_JobReproducibilityManifest" }, "rows": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "schema": { "items": { "$ref": "#/components/schemas/ResDef_Query_JobResultColumn" }, "type": "array" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "uncertainty": { "default": null, "format": "double", "type": [ "number", "null" ] } }, "required": [ "schema_version", "dataset_ref", "content_digest", "schema", "rows", "reproducibility" ], "type": "object" }, "ResDef_Query_JobResultColumn": { "description": "Portable typed result column for remote analytics workers.", "properties": { "logical_type": { "type": "string" }, "name": { "type": "string" }, "nullable": { "type": "boolean" } }, "required": [ "name", "logical_type", "nullable" ], "type": "object" }, "ResDef_Query_JsonPathOp": { "description": "DOCUMENT/JSON \u2014 the test applied by [`Pred::JsonPath`] against the value(s) a\nJSONPath resolves to (CONCEPT:EG-KG.query.json-wire-roundtrip). PURE serde (a small tag + an optional\n`serde_json::Value` literal); the actual walk/containment lives in\n`eg_core::jsonpath` behind eg-plan's FILTER leg \u2014 this is the wire variant.", "oneOf": [ { "const": "Exists", "description": "The path resolves to at least one value (`jsonb_path_query` existence / `@?`).", "type": "string" }, { "additionalProperties": false, "description": "Some value at the path equals `value` (Postgres `->` / `->>` equality). A `->>`\ntext compare coerces a scalar to text, so a JSON-string `value` also matches a\nnumeric leaf whose canonical text is equal.", "properties": { "Eq": { "properties": { "value": true }, "required": [ "value" ], "type": "object" } }, "required": [ "Eq" ], "type": "object" }, { "additionalProperties": false, "description": "The value at the path CONTAINS `value` per Postgres `@>` JSON containment\n(object \u2287 object, array \u2287 array/scalar, scalar equality).", "properties": { "Contains": { "properties": { "value": true }, "required": [ "value" ], "type": "object" } }, "required": [ "Contains" ], "type": "object" } ] }, "ResDef_Query_JustificationNodeWire": { "description": "One node of an `EXPLAIN BELIEF` justification tree \u2014 the wire projection of\n`eg_epistemic::ProofNode`. `rule` is the `Debug`-rendered `eg_epistemic::JustRule`\n(`\"Asserted\"`, `\"DerivedSupport\"`, `\"DerivedContradiction\"`, `\"BayesianUpdate\"`).", "properties": { "claim": { "type": "string" }, "confidence": { "format": "double", "type": "number" }, "premises": { "items": { "$ref": "#/components/schemas/ResDef_Query_JustificationNodeWire" }, "type": "array" }, "rule": { "type": "string" } }, "required": [ "claim", "rule", "confidence", "premises" ], "type": "object" }, "ResDef_Query_KgDelegateRequest": { "additionalProperties": false, "description": "A delegation admission request. The `context` value is a wire assertion;\nthe server compares it with the authenticated outer envelope before using\nany field for tenant, policy, or routing decisions.", "properties": { "actor_scope": { "type": "string" }, "capability_digest": { "type": "string" }, "catalog_digest": { "type": "string" }, "command_digest": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_RequestContext" }, "deadline_unix": { "format": "double", "type": [ "number", "null" ] }, "delegation_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "input_ref": { "type": "string" }, "kind": { "type": "string" }, "max_attempts": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_tenant_in_flight": { "description": "Zero requests the engine's bounded default. The native admission\nauthority still enforces its own hard ceiling.", "format": "uint64", "minimum": 0, "type": "integer" }, "model_digest": { "default": null, "description": "The model a single-agent delegation will run on.\n\n`Some` for an agent target and `None` for a graph, and both directions\nare enforced. A graph has no single model -- it has one per agent node --\nand its pinned `definition_digest` covers the shape digest, which pins\nevery one of them transitively, so a scalar here would either be a lie\nor a duplicate of something the shape digest covers better. Requiring it\nto be absent keeps the two cases from being conflated by a caller that\nfills in a plausible value.", "type": [ "string", "null" ] }, "policy_digest": { "type": "string" }, "priority": { "format": "int64", "type": "integer" }, "purpose": { "type": "string" }, "run_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_KgDelegateSchemaVersion" }, "target": { "$ref": "#/components/schemas/ResDef_Query_DelegationTarget", "description": "What to run: one agent, or one graph of them." }, "trace_id": { "type": "string" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "context", "delegation_id", "run_id", "trace_id", "target", "input_ref", "command_digest", "capability_digest", "catalog_digest", "policy_digest", "idempotency_key", "kind", "actor_scope", "purpose", "priority", "max_attempts", "max_tenant_in_flight" ], "type": "object" }, "ResDef_Query_KgDelegateSchemaVersion": { "oneOf": [ { "const": "2", "description": "Format identity, not a component name (RF-ADR-006). See\n[`KG_DELEGATE_VERSION`] for what changed.", "type": "string" } ] }, "ResDef_Query_KnowledgeResultFamily": { "description": "The seven result-producing families sharing the native batch currency.", "enum": [ "graph", "sql", "rdf", "vector", "time_series", "job", "cross_modal" ], "type": "string" }, "ResDef_Query_KnowledgeStreamBatch": { "description": "One bounded native Arrow batch.", "properties": { "cursor": { "$ref": "#/components/schemas/ResDef_Query_KnowledgeStreamCursor" }, "family": { "$ref": "#/components/schemas/ResDef_Query_KnowledgeResultFamily" }, "payload": { "description": "Arrow IPC stream bytes for `ArrowIpc`.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "projection": { "$ref": "#/components/schemas/ResDef_Query_KnowledgeStreamProjection" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "family", "projection", "cursor", "payload" ], "type": "object" }, "ResDef_Query_KnowledgeStreamCursor": { "description": "Authority-, placement-, query-, snapshot-, and schema-bound resume position.\n\nEvery reference is an opaque `eg::` value. The facade\nvalidates them by constructing `eg_modality::OpaqueRef`s before resuming.", "properties": { "access_policy_ref": { "type": "string" }, "batch_index": { "format": "uint64", "minimum": 0, "type": "integer" }, "batch_size": { "format": "uint32", "minimum": 0, "type": "integer" }, "derivation_ref": { "type": "string" }, "evidence_set_ref": { "type": "string" }, "exhausted": { "type": "boolean" }, "family": { "$ref": "#/components/schemas/ResDef_Query_KnowledgeResultFamily" }, "integrity_ref": { "description": "Keyed integrity reference over every other cursor field, including the\nposition. It is re-derived from verified request authority on resume.", "type": "string" }, "placement_ref": { "type": "string" }, "query_ref": { "type": "string" }, "row_offset": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "snapshot_ref": { "type": "string" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "family", "integrity_ref", "tenant_ref", "access_policy_ref", "placement_ref", "snapshot_ref", "query_ref", "derivation_ref", "evidence_set_ref", "batch_size", "row_offset", "batch_index", "exhausted" ], "type": "object" }, "ResDef_Query_KnowledgeStreamProjection": { "description": "Result encoding requested from the one native pull method.\n\n`ArrowIpc` is the sole engine-native result contract.", "enum": [ "arrow_ipc" ], "type": "string" }, "ResDef_Query_KnowledgeStreamQuery": { "description": "Typed query submitted to the shared result adapter.", "oneOf": [ { "additionalProperties": false, "properties": { "family": { "const": "graph", "type": "string" }, "label": { "default": "", "description": "Empty means every visible node.", "type": "string" }, "limit": { "default": 0, "description": "Total source-row cap; zero means no caller cap.", "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "family" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "sql", "type": "string" }, "params_msgpack": { "default": [], "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "query": { "type": "string" } }, "required": [ "family", "query" ], "type": "object" }, { "additionalProperties": false, "properties": { "base_iri": { "default": "", "type": "string" }, "family": { "const": "rdf", "type": "string" }, "query": { "type": "string" }, "type_convention": { "default": "", "type": "string" } }, "required": [ "family", "query" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "vector", "type": "string" }, "k": { "format": "uint", "minimum": 0, "type": "integer" }, "keywords": { "default": [], "items": { "type": "string" }, "type": "array" }, "query_embedding": { "default": [], "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "family", "k" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "time_series", "type": "string" }, "from": { "format": "int64", "type": "integer" }, "series_id": { "type": "string" }, "to": { "format": "int64", "type": "integer" } }, "required": [ "family", "series_id", "from", "to" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "job", "type": "string" }, "job_id": { "type": "string" } }, "required": [ "family", "job_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "family": { "const": "cross_modal", "type": "string" }, "text": { "description": "UQL text parsed into the same plan used by `UnifiedQuery`.", "type": "string" } }, "required": [ "family", "text" ], "type": "object" } ] }, "ResDef_Query_KnowledgeStreamRequest": { "description": "One pull from the shared served stream.", "properties": { "batch_size": { "description": "Clamped by the server to its safe bound.", "format": "uint32", "minimum": 0, "type": "integer" }, "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_KnowledgeStreamCursor" }, { "type": "null" } ] }, "projection": { "$ref": "#/components/schemas/ResDef_Query_KnowledgeStreamProjection", "default": "arrow_ipc" }, "query": { "$ref": "#/components/schemas/ResDef_Query_KnowledgeStreamQuery" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "query", "batch_size" ], "type": "object" }, "ResDef_Query_LabelRegime": { "description": "What kind of labels the training records carry.", "oneOf": [ { "additionalProperties": false, "description": "Every option's outcome is known, pinned by the gold set's digest.", "properties": { "gold_set_digest": { "type": "string" }, "regime": { "const": "full_label", "type": "string" } }, "required": [ "regime", "gold_set_digest" ], "type": "object" }, { "additionalProperties": false, "description": "Only the acted-on option's outcome is known.", "properties": { "regime": { "const": "bandit_label", "type": "string" } }, "required": [ "regime" ], "type": "object" } ] }, "ResDef_Query_LabelSource": { "description": "Who produced a full-label acceptability set.", "oneOf": [ { "enum": [ "human" ], "type": "string" }, { "const": "synthetic_construction", "description": "Ground truth by construction (the synthetic suite).", "type": "string" }, { "const": "llm_resolved", "description": "An LLM resolved an abstention. Never a label: a candidate for human\nlabelling only.", "type": "string" } ] }, "ResDef_Query_LabelledDataset": { "additionalProperties": false, "description": "A labelled dataset, pinned by digest in every job that reads it.", "properties": { "feature_names": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_32" }, "feature_schema_digest": { "description": "`sha256:` of the feature schema body the rows were computed under.", "type": "string" }, "items": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_LabelledItem_4096" }, "scale": { "$ref": "#/components/schemas/ResDef_Query_QuantScaleTag" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "synthetic": { "description": "Synthetic evidence is labelled as such, always.", "type": "boolean" } }, "required": [ "schema_version", "feature_schema_digest", "feature_names", "scale", "items", "synthetic" ], "type": "object" }, "ResDef_Query_LabelledItem": { "additionalProperties": false, "description": "One labelled decision: its candidates, their feature rows and the label.", "properties": { "audit_inclusion": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, { "type": "null" } ], "default": null, "description": "Known inclusion probability of an audit-sampled item; its weight is the\ninverse (EH-026)." }, "candidate_ids": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "class_key": { "description": "Calibration class (task class); Mondrian guarantees are per class.", "type": "string" }, "features": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_int64_2048", "description": "Row-major, `candidate_ids.len() x feature_names.len()`, on the\ndataset's scale." }, "item_id": { "type": "string" }, "label": { "$ref": "#/components/schemas/ResDef_Query_ItemLabel" }, "recorded_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "item_id", "recorded_at_ms", "class_key", "candidate_ids", "features", "label" ], "type": "object" }, "ResDef_Query_LagrangeDual": { "additionalProperties": false, "description": "Row multipliers `numerator / denominator`, entries strictly ordered by row.", "properties": { "denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "entries": { "items": { "$ref": "#/components/schemas/ResDef_Query_DualEntry" }, "type": "array" } }, "required": [ "denominator", "entries" ], "type": "object" }, "ResDef_Query_LakehouseVectorProjectionRef": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "namespace_id": { "type": "string" }, "projection_id": { "type": "string" }, "source_revision": { "type": "string" }, "table_id": { "type": "string" } }, "required": [ "catalog_id", "namespace_id", "table_id", "projection_id", "source_revision" ], "type": "object" }, "ResDef_Query_LangfuseObservationRef": { "additionalProperties": false, "description": "One Langfuse observation identity. EG records the opaque receipt and its\ndigest; the Langfuse client/export path remains outside the graph authority.", "properties": { "digest": { "type": "string" }, "observation_id": { "type": "string" } }, "required": [ "observation_id", "digest" ], "type": "object" }, "ResDef_Query_LeafProof": { "description": "How a leaf of the search tree is closed.", "oneOf": [ { "additionalProperties": false, "description": "`L(dual, path)` is a lower bound on every feasible completion.", "properties": { "bound": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Query_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "bound" ], "type": "object" }, { "additionalProperties": false, "description": "`L(dual, path)` with a zero objective is positive: no feasible completion.", "properties": { "infeasible": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Query_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "infeasible" ], "type": "object" } ] }, "ResDef_Query_LeasePriority": { "description": "The same four priority tiers `resource_priority.py::PriorityClass` defines,\nvendored here (not imported \u2014 this crate has no Python interop and must not\ndepend on AU) so a `CapacityLease` carries the identical vocabulary the AU\nscheduler already enforces at the LLM gate. `#[derive(Ord)]` on a fieldless\nenum compares by DECLARATION ORDER, so listing `Interactive` first and\n`BackgroundIngestion` last gives `Interactive < Orchestration < Hydration <\nBackgroundIngestion`, matching `core/cognitive_scheduler.py::SchedulerPriority`'s\n\"lower value = higher priority\" convention. `Orchestration`/`Hydration` are\nNOT equal-priority under this `Ord` (AU's equal LLM-gate WEIGHT for the two\nis a separate lookup table, `_PRIORITY_WEIGHTS`, not an enum-ordinal fact \u2014\nsee `resource_priority.py`); only `may_spend_reserved_floor` below is a\nhard cell-admission rule.", "enum": [ "interactive", "orchestration", "hydration", "background_ingestion" ], "type": "string" }, "ResDef_Query_LevelValue": { "additionalProperties": false, "description": "Value of one objective level under an assignment.", "properties": { "known": { "$ref": "#/components/schemas/ResDef_Query_Scalar", "description": "Sum of the known coefficients of the selected variables." }, "unknown_selected": { "description": "How many selected variables have an unknown coefficient at this level.", "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "known", "unknown_selected" ], "type": "object" }, "ResDef_Query_LibraryCandidateScope": { "additionalProperties": false, "description": "Which slice of the agent library the candidates come from.", "properties": { "classification_under": { "default": null, "description": "Restrict to components classified under this ontology term.", "type": [ "string", "null" ] }, "kinds": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_AgentComponentKind_16" } }, "required": [ "kinds" ], "type": "object" }, "ResDef_Query_LineageRecord": { "properties": { "lineage_id": { "type": "string" }, "object_id": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ResDef_Query_MaterialOperation" }, "parent_content_digests": { "items": { "type": "string" }, "type": "array" }, "source_artifact_digest": { "type": "string" }, "transform_name": { "type": "string" }, "transform_version": { "type": "string" } }, "required": [ "lineage_id", "operation", "object_id", "source_artifact_digest", "transform_name", "transform_version", "parent_content_digests" ], "type": "object" }, "ResDef_Query_LinearExplanation": { "additionalProperties": false, "description": "The exact per-feature logit contributions of one option under a linear\nhead: `weight x standardised value`, in schema order. Not an explanation of\nthe calibrated probability or of the softmax.", "properties": { "contributions": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_QuantisedValue_32" }, "option_id": { "type": "string" } }, "required": [ "option_id", "contributions" ], "type": "object" }, "ResDef_Query_Linkage": { "description": "Hierarchical agglomerative linkage criterion (CONCEPT:EG-KG.mining.hierarchical-linkage).", "enum": [ "single", "complete", "average" ], "type": "string" }, "ResDef_Query_LogicalName": { "description": "Validated graph or native-resource name with no filesystem semantics.", "type": "string" }, "ResDef_Query_MaintenanceEnvelope": { "additionalProperties": false, "description": "An owner-maintenance write: compaction, retention, index initialization, a\ncontent-addressed definition insert.\n\nIt is a full mutation -- ledgered, fenced, class-rowed and version-bumping --\nbut it has no caller, so it owns no [`OperationReplayIdentity`], can never\nconsume an attempt nonce, and claims first-wins on `maintenance_key` alone.\n`kind` and `subject` are mandatory so the ledger row NAMES what it wrote\nrather than recording that something was written.", "properties": { "kind": { "description": "What kind of maintenance this is: `index-rebuild`, `series-evict`, ...", "type": "string" }, "maintenance_key": { "description": "`digest(kind, subject, scope, version)` -- the first-wins claim key.", "type": "string" }, "serving_principal": { "type": "string" }, "subject": { "description": "The exact subject the ledger row must name.", "type": "string" } }, "required": [ "serving_principal", "kind", "subject", "maintenance_key" ], "type": "object" }, "ResDef_Query_MaterialOperation": { "enum": [ "upsert", "delete" ], "type": "string" }, "ResDef_Query_MaterializationStatusResult": { "description": "Materialized result of a `Method::MaterializationStatus` run (Seam 3). `status`\nis one of `\"Fresh\"`/`\"Stale\"`/`\"Retracted\"`, or `None` when `id` was never\nregistered (or a build without `epistemic-tms` never populates the index).\nReturned via `ResultPayload::raw`.", "properties": { "source_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "status": { "type": [ "string", "null" ] } }, "required": [ "source_graph_version" ], "type": "object" }, "ResDef_Query_McpCatalogSnapshotBinding": { "additionalProperties": false, "description": "Exact identity of the served MCP catalog snapshot this pack came from.\n\nThe pack digest binds this whole value. Consequently a stored resource can\nnever be mistaken for one observed under a different configuration,\nconnection or authorization scope even when its own body is byte-identical.", "properties": { "authorization_scope_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "catalog_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "child_connection_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "configuration_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "snapshot_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" } }, "required": [ "configuration_revision", "catalog_generation", "snapshot_digest", "child_connection_generation", "authorization_scope_digest" ], "type": "object" }, "ResDef_Query_Method": { "description": "All operations supported by the service.", "oneOf": [ { "additionalProperties": false, "properties": { "method": { "const": "AddNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "node_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Create a node only when `node_id` is absent, returning `Bool(true)` only\nfor the inserting writer. The membership test and insert are one durable\natomic operation; an existing node is never overwritten.", "properties": { "method": { "const": "CreateNodeIfAbsent", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "node_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "RemoveNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "HasNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetNodes", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Labeled + keyset-bounded node fetch: return at most `limit` nodes whose\n`type`/`label`/`labels` matches `label`, ordered by node id. `after` is an\nexclusive node-id cursor (`None` starts at the first id); callers advance\nit to the last id returned. `limit == 0` means no cap. Unlike\n`GetNodes` (which materializes the WHOLE graph), this bounds the wire\npayload to `limit`, so a `MATCH (n:Label) \u2026 LIMIT k` no longer pulls every\nnode's properties off the engine. (CONCEPT:EG-KG.txn.per-graph-write-isolation)\n\nAn empty `label` (CONCEPT:EG-KG.query.unlabeled-scan-limit-pushdown) means \"no label filter\" \u2014 a bounded scan\nof the whole node store, still honouring `limit`. Use this for an\nunlabeled `MATCH (n) \u2026 LIMIT k`: it stays bounded instead of falling back\nto `GetNodes`, which trips the `RESULT_TOO_LARGE` overload guard even when\nthe caller only wanted `k` rows.", "properties": { "method": { "const": "GetNodesByLabel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "after": { "default": null, "type": [ "string", "null" ] }, "label": { "type": "string" }, "limit": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "label", "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetNodeProperties", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomic compare-and-set on a node's property blob (CONCEPT:EG-KG.compute.backend backend-\nagnostic atomic claim). `conditions_msgpack`/`updates_msgpack` are\nMessagePack-encoded JSON objects (field\u2192value maps, same encoding as\n`properties_msgpack`). Under the topology write guard: if every condition\nmatches the node's current value (a MISSING field reads as `null`), the\nupdates are merged in and `true` is returned; otherwise (node absent, any\ncondition fails, or decode fails) the node is left untouched and `false`\nis returned. One in-engine CAS suffices for all backends (the engine is\nthe authoritative store; mirrors follow).", "properties": { "method": { "const": "CompareAndSetNodeFields", "type": "string" }, "params": { "additionalProperties": false, "properties": { "conditions_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "node_id": { "type": "string" }, "updates_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "node_id", "conditions_msgpack", "updates_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically claim the oldest pending node of `label` (CONCEPT:EG-KG.compute.atomically-claim-oldest-pending \u2014\nnative task queue). Under the topology write guard: among `label`'s nodes\nwhose `status == \"pending\"`, pick the smallest `seq`, merge\n`updates_msgpack` (the claim marker \u2014 computed CLIENT-side, carrying NO\nserver clock so WAL/Raft replay stays deterministic), and return\n`Raw(Option<(node_id, properties)>)` (nil \u21d2 nothing claimable). One\nin-engine resolve+CAS; deterministic over identical state, so a committed\nRaft entry / replayed WAL record reproduces the same claim.", "properties": { "method": { "const": "ClaimNext", "type": "string" }, "params": { "additionalProperties": false, "properties": { "label": { "type": "string" }, "updates_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "label", "updates_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Declare (idempotently upsert) an exchange. `kind` is `direct`/`topic`/`fanout`.", "properties": { "method": { "const": "DeclareExchange", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" }, "kind": { "type": "string" } }, "required": [ "exchange", "kind" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Delete an exchange and all of its bindings (queues/messages untouched).", "properties": { "method": { "const": "DeleteExchange", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" } }, "required": [ "exchange" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Bind `queue` to `exchange` under `routing_key` (idempotent).", "properties": { "method": { "const": "BindQueue", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" }, "queue": { "type": "string" }, "routing_key": { "type": "string" } }, "required": [ "exchange", "queue", "routing_key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Remove a specific `exchange`/`queue`/`routing_key` binding.", "properties": { "method": { "const": "UnbindQueue", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" }, "queue": { "type": "string" }, "routing_key": { "type": "string" } }, "required": [ "exchange", "queue", "routing_key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Publish `payload` to `exchange` with `routing_key`; the engine routes it to all\nmatched queues atomically. Returns the delivered-queue count (`Count`).", "properties": { "method": { "const": "Publish", "type": "string" }, "params": { "additionalProperties": false, "properties": { "exchange": { "type": "string" }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "routing_key": { "type": "string" } }, "required": [ "exchange", "routing_key", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Set (idempotently upsert) a queue's policy node (CONCEPT:EG-KG.compute.dead-letter-queues DLQ /\nEG-277 TTL / EG-278 priority). All fields optional \u2014 an all-`None` policy is a\nno-op that keeps the queue behaving exactly as EG-275. Returns `String(\"ok\")`.", "properties": { "method": { "const": "DeclareQueue", "type": "string" }, "params": { "additionalProperties": false, "properties": { "dl_exchange": { "description": "EG-276: exchange to republish dead-lettered messages to (`None` \u21d2 drop).", "type": [ "string", "null" ] }, "dl_routing_key": { "description": "EG-276: routing key for dead-lettered messages (`None` \u21d2 reuse original).", "type": [ "string", "null" ] }, "max_delivery_count": { "description": "EG-276: max delivery attempts before a message is dead-lettered.", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "max_priority": { "description": "EG-278: max priority band the queue honors (advisory ceiling).", "format": "uint8", "maximum": 255, "minimum": 0, "type": [ "integer", "null" ] }, "message_ttl_ms": { "description": "EG-277: default per-message TTL in ms applied when a publish omits one.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "queue": { "type": "string" }, "queue_expiry_ms": { "description": "EG-277: queue-expiry hint in ms (unused-queue teardown; advisory).", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "queue" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Policy-carrying publish (CONCEPT:EG-KG.compute.message-ttl-expiry/278/279). Superset of [`Publish`]:\nstamps per-message `priority` (EG-278), and \u2014 resolving relative intents\nagainst the EXPLICIT `now_ms` \u2014 a `deliver_at` eta (EG-279 delay) and an\n`expires_at` deadline (EG-277 TTL). With `priority == 0` and all options\n`None`, produces a message node identical to a plain [`Publish`]. Returns the\ndelivered-queue count (`Count`).", "properties": { "method": { "const": "PublishEx", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delay_ms": { "default": null, "description": "EG-279: hold the message non-claimable for this many ms from `now_ms`.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "exchange": { "type": "string" }, "now_ms": { "default": null, "description": "Caller clock (ms since epoch) used to resolve `delay_ms`/`ttl_ms` to\nabsolute etas \u2014 explicit so WAL replay is deterministic.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "priority": { "default": 0, "description": "EG-278: priority band; higher is delivered first (default 0).", "format": "int64", "type": "integer" }, "routing_key": { "type": "string" }, "ttl_ms": { "default": null, "description": "EG-277: per-message TTL in ms from `now_ms` (falls back to queue TTL).", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "exchange", "routing_key", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Consume one message from `queue` for a named consumer-group member\n(CONCEPT:EG-KG.compute.groups-qos-prefetch-honoring groups + QoS/prefetch, honoring EG-277 TTL / EG-278 priority /\nEG-279 delay). Claims the highest-priority, oldest, DUE, non-expired message,\nenforcing per-consumer `prefetch` (0 \u21d2 unlimited) and taking a visibility lease\nof `lease_ms` (0 \u21d2 no lease). Lazily dead-letters any expired messages it steps\nover. Returns `Raw(Option<(node_id, properties)>)` \u2014 nil \u21d2 nothing deliverable.", "properties": { "method": { "const": "BrokerConsume", "type": "string" }, "params": { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "group": { "type": "string" }, "lease_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "prefetch": { "format": "uint32", "minimum": 0, "type": "integer" }, "queue": { "type": "string" } }, "required": [ "queue", "group", "consumer", "now_ms", "lease_ms", "prefetch" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Acknowledge (remove) a claimed message, freeing the consumer's in-flight slot\n(CONCEPT:EG-KG.compute.groups-qos-prefetch-honoring). Returns `Bool(true)` if the message existed.", "properties": { "method": { "const": "BrokerAck", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "queue": { "type": "string" } }, "required": [ "queue", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Reject a claimed message (CONCEPT:EG-KG.compute.dead-letter-queues). If `requeue` and the delivery count\nis under the queue's `max_delivery_count`, the message returns to claimable;\notherwise it is dead-lettered to the queue's DL target (with `x-death` metadata)\nor dropped. Returns `String` outcome (`requeued`/`dead-lettered`/`dropped`/\n`absent`).", "properties": { "method": { "const": "BrokerReject", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "queue": { "type": "string" }, "requeue": { "type": "boolean" } }, "required": [ "queue", "node_id", "requeue", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically select and lease the next runnable `WorkItem` node. Selection is\ntenant/resource/fairness scoped, priority ascending, then deadline/creation\nordered. A negative result is authoritative and must not trigger another\nclaim path.", "properties": { "method": { "const": "ClaimWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_ClaimWorkItemRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically acquire one bounded multi-dimensional capacity lease set.\nThe native engine owns the cell epoch, fence, expiry, and idempotency\nrows; the request's owner digest is only an authenticated assertion.", "properties": { "method": { "const": "AcquireCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_CapacityAcquireRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Renew every named capacity lease in one all-or-nothing transaction.", "properties": { "method": { "const": "RenewCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_CapacityLeaseMutationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Release every named capacity lease in one all-or-nothing transaction.", "properties": { "method": { "const": "ReleaseCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_CapacityLeaseMutationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Reclaim a bounded page of expired capacity leases.", "properties": { "method": { "const": "ReclaimExpiredCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_CapacityReclaimRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Return bounded native cells/leases for reconciliation and status.", "properties": { "method": { "const": "ReconcileCapacity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_CapacityStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Exact bounded native capacity read.", "properties": { "method": { "const": "CapacityStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_CapacityStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Controller/admin CAS for a capacity cell epoch and resource dimension.", "properties": { "method": { "const": "UpdateCapacityCell", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_CapacityCellUpdateRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Idempotent WorkItem admission and command-log append.", "properties": { "method": { "const": "SubmitWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_SubmitWorkItemRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Publish, retire, inspect, or reconcile one durable EG Agent Library\ndefinition through the authenticated ControlPlane owner.", "properties": { "method": { "const": "AgentLibrary", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Publish, retire, or inspect one durable agent GRAPH -- a composition of\nAgent Library entries -- through the same authenticated ControlPlane\nowner (RF-ADR-008). `AgentLibrary` records what one agent IS; this\nrecords how several of them are composed to do a task.", "properties": { "method": { "const": "AgentGraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Publish, retire, inspect, or SEARCH one durable agent component --\nlayer 1 of the hierarchy (RF-ADR-008): the model profiles, prompts,\ntools, MCP servers/prompts/resources, skills, schemas and predicates\nagents are assembled from. `Search` is the capability query this layer\nexists for: \"what does an agent trying to do XYZ need?\"", "properties": { "method": { "const": "AgentComponent", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Publish, retire, inspect or INSTANTIATE one durable agent template --\nRF-ADR-008 item C: a published agent plus declared axes of variation.\n`Instantiate` is the operation this layer exists for; it binds\nparameters and returns an ordinary `AgentLibraryEntryDraft`, so an\ninstance is admitted and delegated with no template-aware branch\nanywhere downstream.\n\nNot boxed at this level, for the same reason the three layers beside it\nare not: the only oversized request is the publish draft, and\n`AgentTemplateOp::Publish` already boxes it, so this variant is no\nlarger than `AgentComponent` next to it (asserted by\n`the_publish_request_is_boxed_so_a_template_op_stays_small`).", "properties": { "method": { "const": "AgentTemplate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_AgentTemplateOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Drive one durable semantic binding and its S1-S6 tiered ingestion\nqueue (RF-019). This is the surface an external connector uses to make\nsomething searchable: admit a binding, feed authoritative SQL source\nrows into S1, then subscribe a worker, claim stage leases for its queue\nclass, and complete each stage against its predecessor proof.\n\nBoxed, unlike the four agent layers beside it: `SemanticIndexOp`'s\nstage-completion variants carry a lease, a transition, an artifact and a\nsuccessor intent together, which is far larger than any agent op and\nwould otherwise set the size of EVERY `Method`. `Box` is transparent to\nserde, so the wire form is unchanged.\n\nDeclared unconditionally, like the `semantic_index` DTO module it is\nbuilt from: the wire contract is one contract in every build. The\nengine-side durable tier it needs is what carries the `ann-redb` gate,\nso the dispatch arm refuses by name in a build without it -- exactly\nhow the four agent layers refuse in a build without `redb`.", "properties": { "method": { "const": "SemanticIndex", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_SemanticIndexOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Authenticate and lower an Agent Library delegation through the native\nWorkItem admission command log. The retained library entry is resolved\nby the library owner at the handler boundary.", "properties": { "method": { "const": "KgDelegate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_KgDelegateRequest", "description": "Boxed: a pinned delegation request carries the whole Agent Library\nentry reference and would otherwise set the size of EVERY `Method`.\n`Box` is transparent to serde, so the wire form is unchanged." } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Bounded all-or-nothing WorkItem admission batch.", "properties": { "method": { "const": "SubmitWorkItems", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_SubmitWorkItemsRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Mint an opaque native capability for the caller's currently-live\nWorkItem lease. All authority bindings are derived in the engine from\nthe verified request context and the authoritative WorkItem row.", "properties": { "method": { "const": "MintWorkItemClaimCapability", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_WorkItemClaimCapabilityMintRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Verify an opaque native WorkItem capability against the current live\nlease before any private payload/body lookup.", "properties": { "method": { "const": "VerifyWorkItemClaimCapability", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_WorkItemClaimCapabilityVerifyRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Renew an existing WorkItem lease. Both epoch and fencing token must match\nthe durable row, preventing a superseded worker from extending ownership.", "properties": { "method": { "const": "RenewWorkItemLease", "type": "string" }, "params": { "additionalProperties": false, "properties": { "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant": { "type": "string" }, "work_item_id": { "type": "string" }, "worker_id": { "type": "string" } }, "required": [ "tenant", "work_item_id", "worker_id", "lease_epoch", "fencing_token", "now_ms", "lease_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Publish a WorkItem terminal/retry result through the same authoritative\ntransaction as its state transition and mutation outbox. Result bodies are\nreferenced, never embedded, so the durable control plane stores no PII.", "properties": { "method": { "const": "CommitWorkItemResult", "type": "string" }, "params": { "additionalProperties": false, "properties": { "error_ref": { "default": null, "type": [ "string", "null" ] }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "outcome": { "type": "string" }, "outcome_extension": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_TerminalOutcomeExtension" }, { "type": "null" } ], "default": null, "description": "Optional RF-020/GOC-20 terminal receipts. When present, the\nmutation compiler lowers the bound receipt nodes to AddNode\noperations and one run-event outbox intent in this same batch.\n\nBoxed because it dominates the size of this variant and, through it,\nof EVERY `Method`. `Option>` and `Option` serialize\nidentically, so the wire form -- and the frozen contract -- are\nunchanged; only the in-memory layout moves." }, "result_ref": { "default": null, "type": [ "string", "null" ] }, "retryable": { "default": false, "type": "boolean" }, "tenant": { "type": "string" }, "work_item_id": { "type": "string" }, "worker_id": { "type": "string" } }, "required": [ "tenant", "work_item_id", "worker_id", "lease_epoch", "fencing_token", "idempotency_key", "outcome", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Cancel a pending WorkItem without first manufacturing a worker lease.\nActive, unexpired leases are never stolen: their current owner must use\n`CommitWorkItemResult` with the matching epoch/fencing token instead.", "properties": { "method": { "const": "CancelWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "idempotency_key": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason_ref": { "default": null, "description": "Opaque reference to a redacted cancellation reason. The engine never\npersists a caller-supplied reason body in the control-plane node.", "type": [ "string", "null" ] }, "tenant": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "tenant", "work_item_id", "idempotency_key", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Release a leased WorkItem back to `ready` at an explicit retry time\nwithout consuming an execution attempt. This is the native transition\nfor self-polling barriers and other cooperative deferrals.", "properties": { "method": { "const": "DeferWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "next_retry_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason_ref": { "default": null, "description": "Opaque reference only; no free-form reason body is retained.", "type": [ "string", "null" ] }, "tenant": { "type": "string" }, "work_item_id": { "type": "string" }, "worker_id": { "type": "string" } }, "required": [ "tenant", "work_item_id", "worker_id", "lease_epoch", "fencing_token", "idempotency_key", "next_retry_at_ms", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomic compare-and-set on one WorkItem's non-authority SCHEDULING\nMETADATA (`checkpoint_id` / `metadata` / `prio_bucket`) \u2014 the native\nreplacement for a generic `CompareAndSetNodeFields` against a\nWorkItem row, which `work_item_capability::validate_generic_method`\n(RMDD-29) unconditionally refuses once the row is claimed (BUG-111).\nRuns inside the SAME durable WorkItem transaction as `ClaimWorkItem`/\n`RenewWorkItemLease`, never a side path. Cannot touch `status`/\n`lease_owner`/`lease_epoch`/`fencing_token`/`tenant` \u2014 the request\ncarries no such field \u2014 so it can never manufacture or extend native\nlease authority.", "properties": { "method": { "const": "CasWorkItemMetadata", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_CasWorkItemMetadataRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically reserve the immutable shared-host resources for the exact\nWorkItem attempt/fence. The engine re-reads the WorkItem admission\nextension and host records; request fields are assertions, never a\ncaller-owned reservation ledger.", "properties": { "method": { "const": "ReserveWorkItemResources", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_ResourceReservationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically release the exact current/terminal WorkItem reservation while\nretaining its lifecycle tombstone for exact idempotent replay.", "properties": { "method": { "const": "ReleaseWorkItemResources", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_ResourceReservationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically reclaim an expired or superseded reservation. A stale worker\ncannot use this operation to release a newer attempt's capacity.", "properties": { "method": { "const": "ReclaimWorkItemResources", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_ResourceReservationRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Exact bounded read of a native reservation or retained lifecycle tombstone.", "properties": { "method": { "const": "QueryWorkItemReservation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_ResourceReservationStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Bounded native reservation reconciliation/status read. No local mirror\nis sufficient to answer this operation.", "properties": { "method": { "const": "ResourceReservationStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_ResourceReservationStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Monotonic host capacity/heartbeat/policy update. Held accounting remains\nnative and cannot be overwritten by telemetry.", "properties": { "method": { "const": "UpdateResourceHost", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_ResourceHostUpdateRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically allocate the typed development-lane hold for the exact\n`lane.lifecycle` WorkItem attempt/fence. Branch and managed-worktree\nuniqueness plus every configured quota scope are charged together.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "ReserveDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneReserveRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Renew one existing lane hold in place. This never appends a WorkItem or\nhistory row and requires the current WorkItem lease/fence.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "RenewDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneRenewRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Replace the monotonic observed retained footprint on one exact hold.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "ObserveDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneObserveRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Release active-count charge after the exact lifecycle WorkItem reaches a\nterminal state while retaining disk/exclusivity until cleanup.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "FinishDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneFinishRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Release retained disk and identity indexes after a distinct current\n`lane.cleanup` WorkItem proves the guarded filesystem effect complete.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "CleanupDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneCleanupCompleteRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Exact authenticated read of one lane hold or tombstone.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "QueryDevelopmentLane", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneQueryRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Bounded authenticated status page with maintained native counters.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "DevelopmentLaneStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneStatusRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Controller/admin-only monotonic quota-policy update.\n`request.now_ms` is overwritten from the authoritative engine clock.", "properties": { "method": { "const": "UpdateDevelopmentLaneQuota", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DevelopmentLaneQuotaUpdateRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Reaper sweep (CONCEPT:EG-KG.compute.message-ttl-expiry): dead-letter/drop messages whose `expires_at`\nhas passed and return messages whose visibility lease has expired to claimable,\nacross every known queue. Called periodically by the scheduler with the current\nclock. Returns `Count` of messages acted on.", "properties": { "method": { "const": "SweepExpired", "type": "string" }, "params": { "additionalProperties": false, "properties": { "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Declare (idempotently upsert) a stream's retention policy (CONCEPT:EG-KG.compute.replayable-append-log).\nBoth bounds optional \u2014 an all-`None` policy is an unbounded append log that a\ntrim never touches. Also ensures the offset counter so the stream is publishable.\nReturns `String(\"ok\")`.", "properties": { "method": { "const": "StreamDeclare", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_age_ms": { "description": "Drop messages older than this many ms (`now_ms - ts`) on trim.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "max_messages": { "description": "Keep at most this many newest messages (older dropped on trim).", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "stream": { "type": "string" } }, "required": [ "stream" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Append `payload` to `stream`, returning its assigned monotonic offset (`Count`)\n(CONCEPT:EG-KG.compute.replayable-append-log). The message is RETAINED (read by offset), never auto-consumed.", "properties": { "method": { "const": "StreamPublish", "type": "string" }, "params": { "additionalProperties": false, "properties": { "now_ms": { "description": "Caller clock (ms) stamped as the message `ts` for age-based retention.", "format": "uint64", "minimum": 0, "type": "integer" }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "stream": { "type": "string" } }, "required": [ "stream", "payload", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read up to `max` retained messages from `stream` starting at `from_offset`,\nWITHOUT deleting (CONCEPT:EG-KG.compute.replayable-append-log \u2014 replay). `from_offset < 0` \u21d2 from the current\nend (\"only new\"); `0` \u21d2 earliest; otherwise that explicit offset. `max == 0` \u21d2\nuncapped. Returns `Raw(Vec<(offset, payload)>)` ascending by offset. Read-only.", "properties": { "method": { "const": "StreamRead", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from_offset": { "format": "int64", "type": "integer" }, "max": { "format": "uint64", "minimum": 0, "type": "integer" }, "stream": { "type": "string" } }, "required": [ "stream", "from_offset", "max" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Trim `stream` per its declared retention (CONCEPT:EG-KG.compute.replayable-append-log): drop messages beyond\n`max_messages` (oldest first) and/or older than `max_age_ms`. Returns `Count`\nof messages removed. An undeclared / unbounded stream trims nothing.", "properties": { "method": { "const": "StreamTrim", "type": "string" }, "params": { "additionalProperties": false, "properties": { "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "stream": { "type": "string" } }, "required": [ "stream", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Commit a consumer-group's read `offset` on `stream` so it can resume\n(CONCEPT:EG-KG.compute.replayable-append-log). Idempotent upsert; returns `String(\"ok\")`.", "properties": { "method": { "const": "StreamCommitOffset", "type": "string" }, "params": { "additionalProperties": false, "properties": { "group": { "type": "string" }, "offset": { "format": "int64", "type": "integer" }, "stream": { "type": "string" } }, "required": [ "stream", "group", "offset" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read a consumer-group's committed offset on `stream` (CONCEPT:EG-KG.compute.replayable-append-log). Returns\n`Raw(Option)` \u2014 nil \u21d2 the group has never committed. Read-only.", "properties": { "method": { "const": "StreamCommittedOffset", "type": "string" }, "params": { "additionalProperties": false, "properties": { "group": { "type": "string" }, "stream": { "type": "string" } }, "required": [ "stream", "group" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Publish with a publisher confirm (CONCEPT:EG-KG.compute.publisher-confirms-consumer-qos) \u2014 a superset of [`PublishEx`]\nthat also allocates a monotonic delivery-tag. Returns `Raw(ConfirmToken)` with\n`confirmed = true` once durably enqueued (exchange exists) or a nack on an\nunknown exchange. The tag increments on every call (confirms and nacks alike).", "properties": { "method": { "const": "PublishConfirmed", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delay_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "exchange": { "type": "string" }, "now_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "priority": { "default": 0, "format": "int64", "type": "integer" }, "routing_key": { "type": "string" }, "ttl_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "exchange", "routing_key", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Publish with an OPTIONAL `(producer_id, seq)` idempotency stamp for\neffectively-once delivery (CONCEPT:EG-KG.ingest.broker-reject-publish) \u2014 a superset of [`PublishConfirmed`].\nWith `producer_id == None` this is the plain at-least-once path (byte-identical\nto [`PublishEx`]). With `producer_id == Some`, the broker dedups against that\nproducer's durable monotonic high-water mark: a `seq` at/under the mark is a\nDUPLICATE (dropped but still confirmed), a `seq` above it advances the mark and\nthe message is enqueued. Returns `Raw(IdempotentPublish)`\n(`confirmed`/`duplicate`/`delivered`). Deterministic: the dedup + mark bump\nderive purely from graph state + explicit args, so WAL/Raft replay reproduces\nbyte-identical state.", "properties": { "method": { "const": "PublishIdempotent", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delay_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "exchange": { "type": "string" }, "now_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "priority": { "default": 0, "format": "int64", "type": "integer" }, "producer_id": { "default": null, "description": "Stable publisher identity; `None`/empty \u21d2 at-least-once (no dedup).", "type": [ "string", "null" ] }, "routing_key": { "type": "string" }, "seq": { "default": 0, "description": "Per-producer monotonic sequence number (dedup key).", "format": "int64", "type": "integer" }, "ttl_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "exchange", "routing_key", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Acknowledge (remove) a claimed message by its positive `delivery_tag`\n(CONCEPT:EG-KG.compute.publisher-confirms-consumer-qos). The caller must name the claiming `consumer`; the\nstatus, current tag, and owner are fenced atomically. Returns `Bool(false)`\nfor an absent, stale, or foreign-owned generation.", "properties": { "method": { "const": "BrokerAckTag", "type": "string" }, "params": { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "delivery_tag": { "format": "int64", "type": "integer" } }, "required": [ "delivery_tag", "consumer" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Nack a claimed message by its positive `delivery_tag` (CONCEPT:EG-KG.compute.publisher-confirms-consumer-qos). The caller\nmust name the claiming `consumer`; status, current tag, and owner are fenced\natomically. With `requeue` the message returns to claimable (at-least-once\nredelivery) unless its delivery budget is exhausted. Returns `String` outcome\n(`requeued`/`dead-lettered`/`dropped`/`absent`).", "properties": { "method": { "const": "BrokerNackTag", "type": "string" }, "params": { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "delivery_tag": { "format": "int64", "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "requeue": { "type": "boolean" } }, "required": [ "delivery_tag", "consumer", "requeue", "now_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Extend a still-live claimed delivery lease for its current owner. The\nstatus, tag, owner, and unexpired lease are fenced atomically. The requested\ndeadline must advance the current deadline. `now_ms` is explicit so durable\nreplay is deterministic.", "properties": { "method": { "const": "BrokerRenewTag", "type": "string" }, "params": { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "delivery_tag": { "format": "int64", "type": "integer" }, "lease_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "delivery_tag", "consumer", "now_ms", "lease_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-220 \u2014 create (or UPSERT) a hierarchical summary node at\nabstraction `level`, linked to each of `child_ids` via a `SUMMARIZES`\nprovenance edge. `props_msgpack` is a MessagePack-encoded JSON object (the\nLLM summary text + any caller fields; an `id` string is honoured). Durable +\ndeterministic (the id derives from `(level, sorted children)` with no clock),\nso WAL replay upserts the identical node. Returns the summary node id\n(`String`).", "properties": { "method": { "const": "CreateSummaryNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "child_ids": { "items": { "type": "string" }, "type": "array" }, "level": { "format": "uint32", "minimum": 0, "type": "integer" }, "props_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "level", "child_ids", "props_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-221 \u2014 consolidate a cluster of `episodic_ids` into ONE\nsemantic node (LOCALIZED maintenance \u2014 nothing outside the cluster is\ntouched). `semantic_props_msgpack` is a MessagePack-encoded JSON object. The\nsemantic id derives deterministically from the sorted cluster, so WAL replay\nreproduces it. Returns the semantic node id (`String`).", "properties": { "method": { "const": "Consolidate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "episodic_ids": { "items": { "type": "string" }, "type": "array" }, "semantic_props_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "episodic_ids", "semantic_props_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 reinforce a memory node: bump access/recency +\nimportance as of the EXPLICIT `now_ms` (no server clock \u21d2 deterministic\nreplay). Returns `Bool` (whether the node existed).", "properties": { "method": { "const": "Reinforce", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "weight": { "format": "double", "type": "number" } }, "required": [ "node_id", "now_ms", "weight" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 Ebbinghaus-decay a single memory node's importance to\nthe EXPLICIT `now_ms` given `half_life_ms`. Deterministic (caller clock).\nReturns `Bool` (whether it decayed/stamped the node).", "properties": { "method": { "const": "DecayNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "half_life_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "node_id": { "type": "string" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_id", "now_ms", "half_life_ms" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 batch-decay a caller-supplied working set of memory\n`ids` to the EXPLICIT `now_ms` (localized \u2014 no global scan). Returns `Count`\n(nodes decayed).", "properties": { "method": { "const": "DecayMemories", "type": "string" }, "params": { "additionalProperties": false, "properties": { "half_life_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "ids": { "items": { "type": "string" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "now_ms", "half_life_ms", "ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 prune the sub-`threshold`-importance members of the\nworking set `ids`. `delete == false` marks `forgotten` (provenance-preserving);\n`true` hard-removes. Deterministic (no clock). Returns the pruned ids (`Ids`,\nsorted).", "properties": { "method": { "const": "EvictBelow", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delete": { "type": "boolean" }, "ids": { "items": { "type": "string" }, "type": "array" }, "threshold": { "format": "double", "type": "number" } }, "required": [ "ids", "threshold", "delete" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-222 \u2014 decay-THEN-evict the working set `ids` in ONE atomic\npass as of the EXPLICIT `now_ms` (the primitive the AU maintenance loop\nschedules). Deterministic (caller clock). Returns `Raw((decayed_count,\npruned_ids))`.", "properties": { "method": { "const": "Maintain", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delete": { "type": "boolean" }, "evict_threshold": { "format": "double", "type": "number" }, "half_life_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "ids": { "items": { "type": "string" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "ids", "now_ms", "half_life_ms", "evict_threshold", "delete" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-220 \u2014 the direct children of summary node `node_id` (targets\nof its `SUMMARIZES` edges), sorted + deduped. Read-only. Returns `Ids`.", "properties": { "method": { "const": "SummaryChildren", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-220 \u2014 all summary node ids at abstraction `level`, sorted +\ndeduped. Read-only. Returns `Ids`.", "properties": { "method": { "const": "SummariesAtLevel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "level": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "level" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 create a `:SceneObject` with LOCAL `pose_msgpack` (a\nMessagePack-encoded `{translation,rotation,scale}` JSON), optionally parented\nunder `parent` via a `CHILD_OF`/`HAS_CHILD` link. The id derives\ndeterministically from `(live node count, parent, pose)`, so WAL replay\nreproduces it. Returns the new object's id (`String`).", "properties": { "method": { "const": "AddSceneObject", "type": "string" }, "params": { "additionalProperties": false, "properties": { "parent": { "type": [ "string", "null" ] }, "pose_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "pose_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 overwrite scene object `node_id`'s LOCAL pose with\n`pose_msgpack`. Deterministic. Returns `Bool` (whether the node existed).", "properties": { "method": { "const": "SetPose", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" }, "pose_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "node_id", "pose_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 re-parent scene object `node_id` under `new_parent`\n(`None` \u21d2 detach to a root). Deterministic. Returns `Bool` (whether it acted).", "properties": { "method": { "const": "Reparent", "type": "string" }, "params": { "additionalProperties": false, "properties": { "new_parent": { "type": [ "string", "null" ] }, "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 the WORLD pose of scene object `node_id` (its local\npose composed up the `CHILD_OF` chain). Read-only. Returns `Json` \u2014 the\n`{translation,rotation,scale}` object, or `null` if the node is absent / has\nno pose.", "properties": { "method": { "const": "WorldTransform", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-087 \u2014 the direct transform children of scene object\n`node_id` (targets of its `HAS_CHILD` edges), sorted + deduped. Read-only.\nReturns `Ids`.", "properties": { "method": { "const": "SceneChildren", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-099 \u2014 START (or UPSERT) a `:Trajectory` (episode).\n`props_msgpack` is a MessagePack-encoded JSON object (an `id` string is\nhonoured). The id derives deterministically from `(live node count, props)`,\nmonotonic under replay, so WAL replay reproduces it. Returns the trajectory id\n(`String`).", "properties": { "method": { "const": "StartTrajectory", "type": "string" }, "params": { "additionalProperties": false, "properties": { "props_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "props_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-099 \u2014 APPEND a `:Step{action,reward,t,\u2026}` to trajectory\n`traj_id`. `action_msgpack` is a MessagePack-encoded JSON action (a string or\nstructured object); `reward`/`t` are caller-supplied (no clock/RNG \u21d2\ndeterministic). The step id derives from `(traj_id, step ordinal)`, so WAL\nreplay reproduces the identical chain. Returns `Raw(Option)` \u2014 the new\nstep id, or nil if the trajectory is absent.", "properties": { "method": { "const": "AppendStep", "type": "string" }, "params": { "additionalProperties": false, "properties": { "action_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "next_state_ref": { "default": null, "type": [ "string", "null" ] }, "reward": { "format": "double", "type": "number" }, "state_ref": { "default": null, "type": [ "string", "null" ] }, "t": { "format": "uint64", "minimum": 0, "type": "integer" }, "traj_id": { "type": "string" } }, "required": [ "traj_id", "action_msgpack", "reward", "t" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-099 \u2014 the DISCOUNTED return `\u03a3 gamma^t \u00b7 reward` over\ntrajectory `traj_id`'s ordered steps. Read-only, deterministic (`gamma`\ncaller-supplied). Returns `Float` (`0.0` for an absent/empty trajectory).", "properties": { "method": { "const": "DiscountedReturn", "type": "string" }, "params": { "additionalProperties": false, "properties": { "gamma": { "format": "double", "type": "number" }, "traj_id": { "type": "string" } }, "required": [ "traj_id", "gamma" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.memory.eg-batch-decay-caller/EG-099 \u2014 the trajectory in `traj_ids` with the HIGHEST\ndiscounted return (prioritized replay / policy selection); ties broken by the\nsmaller id. Read-only. Returns `Raw(Option)` \u2014 nil for empty input.", "properties": { "method": { "const": "BestTrajectory", "type": "string" }, "params": { "additionalProperties": false, "properties": { "gamma": { "format": "double", "type": "number" }, "traj_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "traj_ids", "gamma" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Batch property read: fetch properties for many nodes in ONE round-trip\ninstead of N `GetNodeProperties` calls. Returns a `Raw` list of\n`[node_id, properties_msgpack | nil]` in input order (nil \u21d2 absent), so the\ncaller learns which ids were missing. Bounded by `MAX_BATCH_IDS`.", "properties": { "method": { "const": "GetNodePropertiesBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Batch existence check: `Raw` list of bools in input order.", "properties": { "method": { "const": "HasNodesBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "NodeCount", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "NodeIds", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "AddEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "RemoveEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Non-destructively CLOSE a contradicted edge's temporal windows (KG-2.251):\nsets `valid_until = invalid_at` and `tx_to = tx_now` on the matching edge\ninstead of deleting it, so an `AS OF` before `invalid_at` still sees the fact.\nA durable mutation (WAL-replayed deterministically from its explicit args).", "properties": { "method": { "const": "InvalidateEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "invalid_at": { "format": "uint64", "minimum": 0, "type": "integer" }, "relationship": { "type": "string" }, "source_id": { "type": "string" }, "target_id": { "type": "string" }, "tx_now": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source_id", "target_id", "relationship", "invalid_at", "tx_now" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically supersede a prior edge with a new one (KG-2.251): close the prior\nedge's validity window and insert `properties_msgpack` as the new edge under\none write guard. Non-destructive \u2014 the prior edge survives for history.", "properties": { "method": { "const": "SupersedeEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "prior_relationship": { "type": "string" }, "prior_source": { "type": "string" }, "prior_target": { "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "source_id": { "type": "string" }, "target_id": { "type": "string" }, "tx_now": { "format": "uint64", "minimum": 0, "type": "integer" }, "valid_at": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "source_id", "target_id", "properties_msgpack", "prior_source", "prior_target", "prior_relationship", "valid_at", "tx_now" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "HasEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetEdges", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Keyset-bounded edge fetch \u2014 the edge sibling of `GetNodesByLabel`. Return\nat most `limit` edges ordered by `(source, target, ordinal)`; `ordinal`\ndistinguishes parallel edges stored under the same `(source, target)`\npair (CONCEPT:EG-KG.ingest.resets-socket-so-assimilation). `after` is an exclusive `(source, target,\nordinal)` cursor (`None` starts at the first edge); callers advance it to\nthe last row returned. `limit == 0` means no cap. Unlike `GetEdges`\n(which materializes the WHOLE graph), this bounds the wire payload to\n`limit`, so a full edge walk no longer trips the `RESULT_TOO_LARGE`\noverload guard. Returns a `Raw`-encoded `Vec<(String, String, u32,\nVec)>` (source, target, ordinal, properties_msgpack).", "properties": { "method": { "const": "GetEdgesPage", "type": "string" }, "params": { "additionalProperties": false, "properties": { "after": { "default": null, "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "uint32", "minimum": 0, "type": "integer" } ], "type": [ "array", "null" ] }, "limit": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ClearGraph", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetEdgeProperties", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Batch edge property read: `Raw` list of `properties_msgpack | nil` in input\norder (nil \u21d2 no such edge). Bounded by `MAX_BATCH_IDS`.", "properties": { "method": { "const": "GetEdgePropertiesBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "edges": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" } }, "required": [ "edges" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "EdgeCount", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "InDegree", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "OutDegree", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetPredecessors", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetSuccessors", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetNeighbors", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Batch neighbor read: fetch neighbor ids for many nodes in ONE round-trip\ninstead of N `GetNeighbors` calls (D-DPF-1 \u2014 the N+1 this closes). Returns\na `Raw` list of `[node_id, Vec]` in input order; a missing/absent\nnode yields an empty neighbor list rather than failing the whole batch, so\none bad id in a large discover-then-hydrate batch cannot sink the rest.\nBounded by `MAX_BATCH_IDS`.", "properties": { "method": { "const": "GetNeighborsBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "First-found node properties across `graphs` (in order); `Null` if absent\nin every graph.", "properties": { "method": { "const": "UnionGetNodeProperties", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graphs": { "items": { "type": "string" }, "type": "array" }, "node_id": { "type": "string" } }, "required": [ "graphs", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Label scan unioned + deduped by node id across `graphs` (limit 0 \u21d2 no cap).", "properties": { "method": { "const": "UnionGetNodesByLabel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graphs": { "items": { "type": "string" }, "type": "array" }, "label": { "type": "string" }, "limit": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "graphs", "label", "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Neighbour ids unioned + deduped across every graph that contains the anchor.", "properties": { "method": { "const": "UnionGetNeighbors", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graphs": { "items": { "type": "string" }, "type": "array" }, "node_id": { "type": "string" } }, "required": [ "graphs", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TopologicalSort", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FindCycle", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetShortestPath", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source_id": { "type": "string" }, "target_id": { "type": "string" } }, "required": [ "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetBlastRadius", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_depth": { "format": "uint", "minimum": 0, "type": "integer" }, "node_id": { "type": "string" } }, "required": [ "node_id", "max_depth" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DegreeCentrality", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DegreeCentralityAll", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "BetweennessCentrality", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "PageRank", "type": "string" }, "params": { "additionalProperties": false, "properties": { "damping": { "format": "double", "type": "number" }, "iterations": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "damping", "iterations" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "PersonalizedPageRank", "type": "string" }, "params": { "additionalProperties": false, "properties": { "damping": { "format": "double", "type": "number" }, "iterations": { "format": "uint", "minimum": 0, "type": "integer" }, "seed_nodes": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" } }, "required": [ "seed_nodes", "damping", "iterations" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ConnectedComponents", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "StronglyConnectedComponents", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "MinimumSpanningTree", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "CommunityDetection", "type": "string" }, "params": { "additionalProperties": false, "properties": { "resolution": { "format": "double", "type": "number" } }, "required": [ "resolution" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Stateless community detection over a call graph passed inline \u2014 NO tenant\nload, NO persistence. The ingest path previously bulk-loaded ~160k edges\ninto a throwaway tenant just to run this, then deleted the tenant; passing\nthe edges directly removes that whole round-trip + the tenant sprawl.\n\nEH-314: `edges` carries an explicit per-edge WEIGHT \u2014 the resolver\nconfidence a caller already computes (0.95 scoped down to 0.60 unique,\nEH-284) \u2014 and `quality` selects Modularity vs CPM (EH-283). This\nstateless path is the one actually taken in production, unlike its\npersisted-topology sibling `CommunityDetection` (which derives weight\nfrom `edge_properties` via `algorithms::community::resolver_confidence_weight`),\nso it needed its own weight/quality slot to make EH-283/EH-284 reachable\nat all. A caller sending `1.0` for every edge and omitting `quality`\ngets the byte-identical pre-EH-314 result: uniform-weight Modularity\nLeiden over the same topology.", "properties": { "method": { "const": "CommunityDetectEphemeral", "type": "string" }, "params": { "additionalProperties": false, "properties": { "edges": { "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" }, "node_ids": { "items": { "type": "string" }, "type": "array" }, "quality": { "$ref": "#/components/schemas/ResDef_Query_CommunityQualityFunction", "default": "modularity" }, "resolution": { "format": "double", "type": "number" } }, "required": [ "node_ids", "edges", "resolution" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GraphColoring", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ComputeSimilarityEdges", "type": "string" }, "params": { "additionalProperties": false, "properties": { "threshold": { "format": "double", "type": "number" } }, "required": [ "threshold" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Native entity-resolution candidate generator (CONCEPT:AU-KG.compute.when-exposes-native) \u2014 composes\nembedding similarity + clustering into one server-side READ op that returns\nmerge proposals (same_as / extends). Never mutates; the client applies via\n`BatchUpdate`. The escalation tier for the agent-utilities dedup ladder.", "properties": { "method": { "const": "ResolveCandidates", "type": "string" }, "params": { "additionalProperties": false, "properties": { "merge_threshold": { "format": "double", "type": "number" }, "node_type": { "default": null, "type": [ "string", "null" ] }, "sim_threshold": { "format": "double", "type": "number" } }, "required": [ "sim_threshold", "merge_threshold" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "(Re)compute the hierarchy for the request's graph and persist it,\nreplacing any previously cached hierarchy for the same graph.\n`ClusterHierarchyClusters`/`ClusterHierarchyExpand` serve the cached\nresult until this is called again \u2014 \"refreshable\", not\nrecomputed-per-request.", "properties": { "method": { "const": "ClusterHierarchyRefresh", "type": "string" }, "params": { "additionalProperties": false, "properties": { "label": { "default": null, "description": "Optional: restrict the clustered projection to nodes of this one\ntype \u2014 mirrors `MineCommunity::label`.", "type": [ "string", "null" ] }, "resolution": { "default": 1.0, "description": "Leiden resolution \u03b3 (higher \u21d2 more, smaller clusters).", "format": "double", "type": "number" }, "seed": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "`GET clusters(graph, level, parent_cluster_id?)` \u2014 one level of the\ncached hierarchy, optionally restricted to one parent's children.\n`level` 1 is the finest computed level; `parent_cluster_id` unset\nreturns every cluster at `level`. Errors if no hierarchy is cached yet\n(call `ClusterHierarchyRefresh` first).", "properties": { "method": { "const": "ClusterHierarchyClusters", "type": "string" }, "params": { "additionalProperties": false, "properties": { "level": { "format": "uint", "minimum": 0, "type": "integer" }, "parent_cluster_id": { "default": null, "type": [ "string", "null" ] } }, "required": [ "level" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "`GET expand(graph, cluster_id)` \u2014 a level-1 cluster's individual member\nnodes/edges (read live off the current graph, keyed by the cached\nmembership) plus its child clusters (empty for a level-1 cluster, since\nlevel 1 is the finest computed level).", "properties": { "method": { "const": "ClusterHierarchyExpand", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cluster_id": { "type": "string" } }, "required": [ "cluster_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "PruneByLifecycle", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_age_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "min_score": { "format": "double", "type": "number" } }, "required": [ "max_age_secs", "min_score" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetContextView", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "max_tokens": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "agent_id", "max_tokens" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "BatchUpdate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "operations_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "operations_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Batched CROSS-GRAPH write (CONCEPT:EG-KG.storage.multi-graph-batch-write). One\nround-trip carries a `BatchUpdate`-shaped op list for MANY named graphs; the\nserver applies each graph's sub-batch through the normal per-graph write\npath CONCURRENTLY, so N distinct graphs commit across N of the K redb shard\nwriters in parallel instead of the client serializing N round-trips that\neach re-acquire one lock. `batches_msgpack` decodes to\n`Vec<(graph_name, operations_msgpack)>` \u2014 each inner blob is exactly a\n`BatchUpdate.operations_msgpack`, so it REUSES the existing batch primitive\n(no new per-op op). Carries its graphs in the METHOD (like `NlQuery`), so it\nis routed BEFORE the single-`graph` graph-op path in dispatch. The reply is\n`{ \"results\": { graph: }, \"errors\": { graph: msg } }`.", "properties": { "method": { "const": "MultiGraphBatchUpdate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "batches_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "batches_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "Metrics", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "EvictLRU", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_nodes": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "max_nodes" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DecaySweep", "type": "string" }, "params": { "additionalProperties": false, "properties": { "floor": { "format": "double", "type": "number" }, "half_life_secs": { "format": "double", "type": "number" }, "prune": { "type": "boolean" } }, "required": [ "half_life_secs", "floor", "prune" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TouchNodes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ToMsgpack", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FromMsgpack", "type": "string" }, "params": { "additionalProperties": false, "properties": { "msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetLedger", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ClearLedger", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ApplyLedger", "type": "string" }, "params": { "additionalProperties": false, "properties": { "transactions": { "items": { "type": "string" }, "type": "array" } }, "required": [ "transactions" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "AuditVerify", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Produce + server-side-verify a Merkle inclusion proof for one node against\na prior provenance anchor (CONCEPT:EG-KG.sharding.row-level-security, feature `security`) \u2014 the\nextension that lets [`AuditVerify`](Method::AuditVerify)'s tamper-evidence\nreach the ANCHORED NODES' CONTENT, not just the ordering of mutations. A\nperiodic engine job Merkle-hashes the target graph's `:ToolCall`/\n`:RunTrace` provenance-node window and folds the root into this SAME\nhash chain as one more entry (`audit::provenance_anchor_line`); this\nmethod re-hashes `node_id`'s CURRENT durable content and walks the\nanchor-time sibling path up to that chain-protected root \u2014 a mismatch\n(`MerkleInclusionReport.verified == false`) proves the node's durable\nbytes changed after anchoring, whether by raw tampering or an ordinary\nlater overwrite. `anchor_seq` selects a specific anchor by its\naudit-chain seq; `None` uses the target graph's most recent anchor.\nErrors when the graph has no anchor yet or `anchor_seq` names an entry\nthat is not one; `included == false` (not an error) means `node_id`\nsimply was not part of that anchor's window. Returns\n`Raw(MerkleInclusionReport)`.", "properties": { "method": { "const": "AuditProveInclusion", "type": "string" }, "params": { "additionalProperties": false, "properties": { "anchor_seq": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetSubgraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "Fork", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DiffAgainst", "type": "string" }, "params": { "additionalProperties": false, "properties": { "other_graph": { "type": "string" } }, "required": [ "other_graph" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "CompactNodesByType", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_type": { "type": "string" }, "threshold": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "node_type", "threshold" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "RunDatalogReasoning", "type": "string" }, "params": { "additionalProperties": false, "properties": { "domain_rules": { "default": [], "description": "(property, domain_type) \u2014 subjects of `property` are inferred to be `domain_type`.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "inverse_properties": { "default": [], "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "property_chains": { "default": [], "description": "(predicate_a, predicate_b, inferred_predicate) \u2014 chain composition.", "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "range_rules": { "default": [], "description": "(property, range_type) \u2014 objects of `property` are inferred to be `range_type`.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "subclass_relations": { "default": [], "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "subproperty_relations": { "default": [], "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "symmetric_properties": { "default": [], "items": { "type": "string" }, "type": "array" }, "transitive_properties": { "default": [], "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically materialize one externally sourced object and all of its\ngovernance/provenance state. The embedded MutationBatch is the graph-row\nmutation authority; blob/feature/evidence/policy/lineage, content version,\ntyped cursor, durable status, and outbox share its commit point.", "properties": { "method": { "const": "ApplyChangeEnvelope", "type": "string" }, "params": { "additionalProperties": false, "properties": { "envelope": { "$ref": "#/components/schemas/ResDef_Query_ChangeEnvelope" } }, "required": [ "envelope" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomically materialize a BATCH of externally sourced objects. Envelopes are\ngrouped by their `mutation.graph` and each graph's envelopes land in ONE\ncoalesced redb transaction (the atomic graph-batch); envelopes spanning\ngraphs split into independent per-graph sub-batches. Within a graph-batch the\ncommit is all-or-nothing \u2014 a single failing envelope aborts that graph's\ntransaction and every envelope in the graph reports the batch outcome. Across\ngraphs the sub-batches are independent (partial success). Per-envelope results\n(applied / idempotent-skip / conflict) are returned in request order. Same\npolicy class as `ApplyChangeEnvelope`. Bounded by `MAX_ENVELOPES_PER_BATCH`.", "properties": { "method": { "const": "ApplyChangeEnvelopes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "envelopes": { "items": { "$ref": "#/components/schemas/ResDef_Query_ChangeEnvelope" }, "type": "array" } }, "required": [ "envelopes" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read a committed envelope by stable identity for retry reconciliation.", "properties": { "method": { "const": "GetChangeEnvelope", "type": "string" }, "params": { "additionalProperties": false, "properties": { "envelope_id": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "envelope_id", "tenant" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read the current typed content version for an object in this graph/tenant.", "properties": { "method": { "const": "GetContentVersion", "type": "string" }, "params": { "additionalProperties": false, "properties": { "object_id": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "object_id", "tenant" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read the current typed source cursor. Cursors are partition scoped and are\nnever compared as strings.", "properties": { "method": { "const": "GetChangeCursor", "type": "string" }, "params": { "additionalProperties": false, "properties": { "partition": { "default": "", "type": "string" }, "source": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "source", "tenant" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ServedModality", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "CreateGraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph_name": { "type": "string" }, "graph_type": { "$ref": "#/components/schemas/ResDef_Query_GraphType" } }, "required": [ "graph_name", "graph_type" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DeleteGraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph_name": { "type": "string" } }, "required": [ "graph_name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ListGraphs", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Online-move `graph`'s durable rows to shard `to_shard` while the engine RUNS,\nthen flip the catalog route (CONCEPT:EG-KG.backend.catalog-shard-resolve). Returns a `ReshardReport` JSON.", "properties": { "method": { "const": "Reshard", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "to_shard": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "to_shard" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Populate / assign an explicit catalog placement for `graph` (CONCEPT:EG-KG.sharding.empty-catalog-routing).\nFlips the ROUTE only \u2014 to MOVE the rows too use `Reshard`. Returns `Bool`.", "properties": { "method": { "const": "CatalogAssign", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "node": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "shard": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "shard" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Re-place `graph` onto `shard`, preserving its node placement (CONCEPT:EG-KG.sharding.empty-catalog-routing).", "properties": { "method": { "const": "CatalogReassign", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "shard": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "shard" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Drop `graph`'s explicit placement \u2014 it reverts to EG-026 FNV-1a routing.", "properties": { "method": { "const": "CatalogRemove", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" } }, "required": [ "graph" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "List every explicit catalog placement `{graph, shard, node}` (JSON).", "properties": { "method": { "const": "CatalogList", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Compute (do NOT execute) a rebalance plan over live per-shard/per-graph load\n(CONCEPT:EG-KG.sharding.even-load-rebalance). Returns the ordered `{graph, from_shard, to_shard}` moves +\nthe per-shard load it planned against, as JSON.", "properties": { "method": { "const": "RebalancePlan", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_moves": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "tolerance": { "format": "double", "type": [ "number", "null" ] } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Compute a rebalance plan AND execute it move-by-move via online resharding\n(CONCEPT:EG-KG.backend.r3-plan-execution, R3 plan execution). Each move is one online `Reshard` \u2014 online,\none graph at a time, other graphs unaffected. Returns the executed moves' reports.", "properties": { "method": { "const": "RebalanceExecute", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_moves": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] }, "tolerance": { "format": "double", "type": [ "number", "null" ] } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Attach `node_id` (reachable at `addr`) to `group` as a NON-VOTING\nLEARNER (CONCEPT:EG-KG.storage.kg-kg-2). Starts replication immediately and BLOCKS\nuntil the learner's log is caught up, but does NOT change the voter\nset \u2014 quorum size and fault tolerance are unaffected. The safe,\nalways-available first step before optionally promoting the node with\n`RaftChangeMembership`. `group` defaults to the single-group\ndeployment's `raft::DEFAULT_GROUP` (0) when omitted. Returns `Bool` on\nsuccess.", "properties": { "method": { "const": "RaftAddLearner", "type": "string" }, "params": { "additionalProperties": false, "properties": { "addr": { "type": "string" }, "group": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "node_id": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_id", "addr" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Set `group`'s VOTER set to exactly `voters` (CONCEPT:EG-KG.storage.kg-kg-2) \u2014 openraft\n`change_membership`. The usual way to PROMOTE one or more learners\nadded via `RaftAddLearner`: pass the full desired voter set (existing\nvoters plus the learner(s) being promoted). Refuses to produce an\nempty voter set. `group` defaults to `raft::DEFAULT_GROUP` (0) when\nomitted. Returns `Bool` on success.", "properties": { "method": { "const": "RaftChangeMembership", "type": "string" }, "params": { "additionalProperties": false, "properties": { "group": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "voters": { "items": { "format": "uint64", "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "voters" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read the current cluster topology (CONCEPT:EG-KG.sharding.cluster-topology): every known Raft\ngroup's members, each with its role (`leader`/`follower`/`learner`),\nhealth and client-reachable endpoint. The response is an authenticated,\nbounded discovery snapshot carrying a stable `cluster_id`, monotonic\n`membership_epoch`/`placement_epoch`, immutable member identities and\ncertificate-rotation metadata. Gated `cluster:topology-read` -- NOT\n`admin:cluster-read` -- so an ordinary service role (not just a cluster\noperator) can discover where to reconnect after a failover. Always declared;\na non-raft build or a raft build with no live `MultiRaft` answers a\nwell-formed empty topology rather than an error. The Python client rejects\nunsigned, wrong-cluster, stale, or differently bound snapshots.", "properties": { "method": { "const": "ClusterMembers", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Push-register (or renew, idempotently) this server's fleet identity\n(CONCEPT:EG-KG.sharding.server-registry) as a `:Server` node in\n`__commons__`. `name` becomes the node id `srv:` (must match\n`^[A-Za-z0-9_.-]{1,128}$`, the same bound au's config-sync ingestion\nenforces); `url` is a bounded opaque endpoint reference (never a raw\ncredentialed URL \u2014 callers pass the same kind of privacy-safe reference\nau's `persistence_reference` produces); `resources_json` is an optional,\nsize-bounded opaque JSON object (non-sensitive metadata, mirrors au's\n`_mcp_persistence_resources`); `ttl_secs` is the caller's requested lease\nduration (bounded server-side). The SERVER computes the absolute\n`lease_expires_at_ms`/`last_heartbeat_ms` from its own clock \u2014 it never\ntrusts a caller-supplied timestamp. Re-calling with the SAME `name`\nrenews the lease (a heartbeat is just a repeat `RegisterServer` call) and\nrefreshes every other field, exactly like the internal topology self-report\nsemantics; `registered_at_ms` is preserved from the prior row if one\nexists. A periodic engine sweep expires (removes) a `:Server` node whose\nlease has lapsed, emitting a CDC `RemoveNode` event. Returns `Bool` on\nsuccess.\n\n`transport` and `desired` are the operator's typed registration claim\n(how the server is reached, and whether it should be used). Both default\nfor a caller that predates them: `unspecified` and `enabled`.", "properties": { "method": { "const": "RegisterServer", "type": "string" }, "params": { "additionalProperties": false, "properties": { "desired": { "$ref": "#/components/schemas/ResDef_Query_ServerDesiredState", "default": "enabled" }, "name": { "type": "string" }, "resources_json": { "default": "", "type": "string" }, "transport": { "$ref": "#/components/schemas/ResDef_Query_ServerTransport", "default": "unspecified" }, "ttl_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "url": { "type": "string" } }, "required": [ "name", "url", "ttl_secs" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "List the live fleet server registry from the engine-owned `__commons__`\ngraph. The request graph is never an authority input: the server forces\n`__commons__`, applies the verified caller's graph ACL and row-level\nprojection, and returns a keyset page sorted by UTF-8 server name. A\ncontinuation cursor is fenced by both the graph revision and a canonical\ndigest of the complete live typed snapshot; a changed/expired row makes\nthe cursor stale and requires a restart. In the single-node/full runtime\nthis is an authoritative local committed read. A clustered deployment\nmust not describe it as cluster-linearizable until a cluster read barrier\nis added to this route.", "properties": { "method": { "const": "ListRegisteredServers", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_RegisteredServerListRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "The fleet catalog (EH-345): the server registry's discovery\nobservations and operator overrides, plus ONE read projection that joins\nthem with the `AgentComponent` records connector packs publish. Not a\nsecond catalog: tools, prompts, resources and skills stay\n`AgentComponent`s and servers stay `:Server` rows; this op family records\nwhich principal observed which connector, and reads the join. Writes\nself-translate into `CreateNodeIfAbsent`/`CompareAndSetNodeFields`\nagainst `__commons__`; reads never take a request graph. Tenant and\nprincipal come only from the verified request context.", "properties": { "method": { "const": "FleetCatalog", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_FleetCatalogOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Resolve `(tenant, sub_key)`'s current placement (CONCEPT:EG-KG.sharding.placement-route-rpc). `client_epoch`\nis the caller's last-known routing epoch for this partition (`0` if never\nresolved). Returns the schema-generated `PlacementRoute`. A placed route\nalways has a non-zero epoch; an authoritative unplaced route uses epoch zero.", "properties": { "method": { "const": "PlacementRoute", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_PlacementRouteRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Drive the placement-catalog admin API (CONCEPT:EG-KG.sharding.placement-catalog-admin-rpc):\n[`PlacementAdminOp::Assign`] (the placement DECISION leg), [`PlacementAdminOp::Move`]\n(the full PLAN \u2192 EXECUTE \u2192 CATALOG-UPDATE leg \u2014 snapshot \u2192 per-graph\ndurability-barrier catch-up \u2192 fenced cutover, reusing the already-proven\n`TenantManager::move_partition` state machine, crash-safe via its durable move\njournal), or [`PlacementAdminOp::AbortMove`] (roll back before the cutover\nfence). Raft/cluster only; a non-clustered build returns a typed \"not available\"\nerror. Returns operation-specific JSON \u2014 see [`PlacementAdminOp`].", "properties": { "method": { "const": "PlacementAdmin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_PlacementAdminOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Take an ONLINE consistent backup under the operator-provisioned\n`EPISTEMIC_GRAPH_BACKUP_ROOT`. `destination` is a bounded logical bundle name,\nnever a host path. The RPC is disabled when no private root is configured.", "properties": { "method": { "const": "Backup", "type": "string" }, "params": { "additionalProperties": false, "properties": { "destination": { "type": "string" }, "label": { "type": [ "string", "null" ] } }, "required": [ "destination" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Restore the logical bundle name `source` from the operator-provisioned backup\nroot (CONCEPT:EG-KG.sharding.reshard-on-restore). The engine holds an\nexclusive lock on its live store, so this stages the rebuilt copy in an\nengine-owned sibling directory and returns only an opaque stage reference for\nthe operator to correlate after stopping the engine;\nan in-place restore uses the offline `restore` CLI. Returns a `RestoreReport` JSON.", "properties": { "method": { "const": "Restore", "type": "string" }, "params": { "additionalProperties": false, "properties": { "source": { "type": "string" }, "target_shards": { "description": "Required current target layout. Setting this to a different value from the\nbundle proves restore-time migration rather than silently preserving K.", "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "source", "target_shards" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "CreateChannel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "channel_type": { "$ref": "#/components/schemas/ResDef_Query_ChannelType" }, "creator": { "type": "string" }, "initial_members": { "items": { "type": "string" }, "type": "array" } }, "required": [ "channel_id", "channel_type", "creator", "initial_members" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "JoinChannel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "channel_id": { "type": "string" } }, "required": [ "channel_id", "agent_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "LeaveChannel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "channel_id": { "type": "string" } }, "required": [ "channel_id", "agent_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "CloseChannel", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "summary_embedding": { "description": "Optional embedding of the conversation summary.", "items": { "format": "float", "type": "number" }, "type": [ "array", "null" ] }, "topic_metadata": { "description": "Optional topic/metadata for the KG imprint.", "type": [ "string", "null" ] } }, "required": [ "channel_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "SendMessage", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "payload": { "type": "string" }, "sender": { "type": "string" } }, "required": [ "channel_id", "sender", "payload" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetChannelMessages", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "limit": { "format": "uint", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "channel_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ListChannels", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GetChannelMembers", "type": "string" }, "params": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" } }, "required": [ "channel_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "Ping", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "Health", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "Shutdown", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Cooperatively cancel an IN-FLIGHT request by its `target_req_id` (CONCEPT:EG-KG.query.streaming-spillable-collect,\nL36) \u2014 trips the `CancellationToken` the request-scoped registry (`server::request_cancel`)\nregistered for it, if one is still live. A REAL `Method::Sql` read currently threads a\nregistered token down to `collect_streaming`, which observes it at the next batch\nboundary and stops the stream short (chunk-granular, never mid-batch). Returns\n`ResultPayload::Bool(true)` iff a live cancellable request was found and cancelled,\n`false` when the request already finished, was never cancellable, or never existed \u2014\nnever an error (cancelling a request that already completed is a harmless no-op).", "properties": { "method": { "const": "CancelRequest", "type": "string" }, "params": { "additionalProperties": false, "properties": { "target_req_id": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "target_req_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Return one bounded, ACL-filtered ResourceStats page. `cursor` is an opaque\nexclusive graph-name key from the previous response's `next_cursor`; `limit`\nmust be between one and the server's finite maximum; `summary` suppresses all\nper-graph/per-tenant arrays while retaining aggregate counters. The body is\nthe only current resource-statistics request shape.", "properties": { "method": { "const": "ResourceStatsPage", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "default": null, "type": [ "string", "null" ] }, "limit": { "default": 128, "format": "uint", "minimum": 0, "type": "integer" }, "summary": { "default": false, "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "Reconcile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph_name": { "type": "string" }, "msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "graph_name", "msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ApplyMutation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "event_type": { "type": "string" }, "query": { "type": "string" } }, "required": [ "event_type", "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "VF2 subgraph isomorphism match of `pattern_graph_name` against this graph\n(CONCEPT:EG-KG.mining.gspan-frequent-subgraph). The backtracking search is NP-hard with no bound\notherwise, so it stops early once it collects `max_results` matches or spends\n`max_steps` candidate-pair attempts (whichever first). `0` for either \u21d2 the\nengine's conservative built-in default (`eg_core::graph::DEFAULT_VF2_MAX_RESULTS`/\n`DEFAULT_VF2_MAX_STEPS`) \u2014 a caller wanting more must ask for it explicitly.\nReturns a `Raw`-encoded [`Vf2MatchResult`].", "properties": { "method": { "const": "Vf2SubgraphMatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_results": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "max_steps": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "pattern_graph_name": { "type": "string" } }, "required": [ "pattern_graph_name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ParseFile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "file_path": { "type": "string" }, "source": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "file_path", "source" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Batched parse: one round-trip for N files (CONCEPT:EG-KG.memory.forgetting-curve-decay). The blob is\na MessagePack-encoded `Vec<(file_path, source_bytes)>`; the response is an\nordered `Vec`, one per input file. Mirrors `BatchUpdate`.", "properties": { "method": { "const": "ParseFiles", "type": "string" }, "params": { "additionalProperties": false, "properties": { "files_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "files_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Parse a batch AND resolve cross-file call/import edges in one round-trip\n(CONCEPT:EG-KG.compute.turn-each-project). The blob is the same MessagePack `Vec<(file_path,\nsource_bytes)>` as `ParseFiles`, but the batch is treated as one\nresolution scope (a repository, or a delta set): the response is a SINGLE\nresolved `IndexResult` whose `calls`/`depends_on` edges point at real node\nids, not bare names. Its ordered `file_outcomes` preserve success,\nunsupported, and error dispositions plus content/parser-capability\ndigests for every submitted file. Use this (not `ParseFiles`) to ingest a\nrepo's symbol graph; use `ParseFiles` only when per-file raw results are\nwanted.", "properties": { "method": { "const": "IndexRepository", "type": "string" }, "params": { "additionalProperties": false, "properties": { "files_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "files_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Turn a captured desktop frame into durable session/frame/UIElement graph\nentities in one round-trip (CONCEPT:AU-KG.ontology.owl-screen-bridge). The blob is a MessagePack map\n`{session_id, frame_seq, prev_frame_id, prev_hash, png: bin, elements: [..]}`;\nthe response is a SINGLE `ScreenObservationResult` (nodes + edges), mirroring\n`IndexRepository`. The screenshot bytes never persist \u2014 only its dimensions +\ncontent hash do, for frame-diff.", "properties": { "method": { "const": "ObserveScreen", "type": "string" }, "params": { "additionalProperties": false, "properties": { "obs_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "obs_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "AddEmbedding", "type": "string" }, "params": { "additionalProperties": false, "properties": { "embedding": { "items": { "format": "float", "type": "number" }, "type": "array" }, "node_id": { "type": "string" } }, "required": [ "node_id", "embedding" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "SemanticSearch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "n_results": { "format": "uint", "minimum": 0, "type": "integer" }, "query_embedding": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "query_embedding", "n_results" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.retrieval.one-round-trip-discovery \u2014 one-round-trip hybrid discovery. Given the caller's\nde-duplicated `keywords` plus a `query_embedding`, dense-retrieve candidate\nnodes via the HNSW index (the same batch primitive as `SemanticSearch`),\nthen re-rank each by BOTH its semantic similarity AND lexical keyword\noverlap over its `name`/`description`/`type`, returning the top-`k` with\ntheir human-readable text as `[{id,name,description,type,score}, \u2026]`.\nComplements `SemanticSearch` (which returns bare `(id, score)`): Discover\nfolds the keyword signal in and hydrates the result text in one call, so a\nrouter/orchestrator gets a ready-to-read shortlist without an N+1 metadata\nfetch. An empty `query_embedding` (embedder/vLLM unavailable) degrades to a\nbounded keyword-only scan.", "properties": { "method": { "const": "Discover", "type": "string" }, "params": { "additionalProperties": false, "properties": { "k": { "format": "uint", "minimum": 0, "type": "integer" }, "keywords": { "items": { "type": "string" }, "type": "array" }, "query_embedding": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "keywords", "query_embedding", "k" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-ORCH.routing.lexical-capability-escalation \u2014 embedding-free lexical classification gate: which\ncapability-node terms (Tool/Skill/MCPServer names+synonyms) appear in the\nquery. The \"free\" tier between structural routing and `SemanticSearch`.", "properties": { "method": { "const": "MatchOntologyTerms", "type": "string" }, "params": { "additionalProperties": false, "properties": { "query": { "type": "string" } }, "required": [ "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "CONCEPT:EG-KG.compute.l2-normalize-batch-vectors \u2014 L2-normalize a batch of vectors IN-ENGINE via the `eg-numeric`\nkernel (compute-near-data over a resident vector set): returns each row's unit\nvector `v/\u2016v\u2016` (feature `numeric`).", "properties": { "method": { "const": "BatchL2Normalize", "type": "string" }, "params": { "additionalProperties": false, "properties": { "vectors": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "vectors" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceOptimizePortfolio", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "expected_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "max_weight": { "format": "double", "type": [ "number", "null" ] }, "min_weight": { "format": "double", "type": [ "number", "null" ] }, "risk_free_rate": { "format": "double", "type": "number" } }, "required": [ "expected_returns", "cov_matrix", "risk_free_rate" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceRiskParity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "cov_matrix" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceBlackLitterman", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "market_weights": { "items": { "format": "double", "type": "number" }, "type": "array" }, "pick_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "risk_aversion": { "format": "double", "type": "number" }, "tau": { "format": "double", "type": "number" }, "views": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "market_weights", "cov_matrix", "views", "pick_matrix", "tau", "risk_aversion" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceEfficientFrontier", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "expected_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "target_return": { "format": "double", "type": "number" } }, "required": [ "expected_returns", "cov_matrix", "target_return" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsLinearRegression", "type": "string" }, "params": { "additionalProperties": false, "properties": { "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "x", "y" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsKMeans", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "k": { "format": "uint", "minimum": 0, "type": "integer" }, "max_iter": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "data", "k", "max_iter" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsPca", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "n_components": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "data", "n_components" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsComputeStats", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "data" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsTrainTestSplit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "labels": { "items": { "format": "double", "type": "number" }, "type": "array" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" }, "shuffle": { "type": "boolean" }, "test_ratio": { "format": "double", "type": "number" } }, "required": [ "data", "labels", "test_ratio", "shuffle", "seed" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsFitEstimator", "type": "string" }, "params": { "additionalProperties": false, "properties": { "estimator": { "type": "string" }, "params": { "$ref": "#/components/schemas/ResDef_Query_EstimatorParams", "default": {} }, "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "estimator", "x", "y" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsPredictEstimator", "type": "string" }, "params": { "additionalProperties": false, "properties": { "model": { "$ref": "#/components/schemas/ResDef_Query_FittedModel" }, "x": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "model", "x" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsSoftmax", "type": "string" }, "params": { "additionalProperties": false, "properties": { "logits": { "items": { "format": "double", "type": "number" }, "type": "array" }, "temperature": { "format": "double", "type": "number" } }, "required": [ "logits", "temperature" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsLogSoftmax", "type": "string" }, "params": { "additionalProperties": false, "properties": { "logits": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "logits" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsCrossEntropy", "type": "string" }, "params": { "additionalProperties": false, "properties": { "labels": { "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" }, "logits": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "logits", "labels" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsDpoLoss", "type": "string" }, "params": { "additionalProperties": false, "properties": { "beta": { "format": "double", "type": "number" }, "policy_chosen": { "items": { "format": "double", "type": "number" }, "type": "array" }, "policy_rejected": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ref_chosen": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ref_rejected": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "policy_chosen", "policy_rejected", "ref_chosen", "ref_rejected", "beta" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsGrpoSurrogate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "advantage": { "items": { "format": "double", "type": "number" }, "type": "array" }, "clip_eps": { "format": "double", "type": "number" }, "logprob": { "items": { "format": "double", "type": "number" }, "type": "array" }, "old_logprob": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "logprob", "old_logprob", "advantage", "clip_eps" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsKlDivergence", "type": "string" }, "params": { "additionalProperties": false, "properties": { "logprob": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ref_logprob": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "logprob", "ref_logprob" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsAdamStep", "type": "string" }, "params": { "additionalProperties": false, "properties": { "beta1": { "format": "double", "type": "number" }, "beta2": { "format": "double", "type": "number" }, "eps": { "format": "double", "type": "number" }, "grads": { "items": { "format": "double", "type": "number" }, "type": "array" }, "lr": { "format": "double", "type": "number" }, "m": { "items": { "format": "double", "type": "number" }, "type": "array" }, "params": { "items": { "format": "double", "type": "number" }, "type": "array" }, "t": { "format": "uint64", "minimum": 0, "type": "integer" }, "v": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "params", "grads", "m", "v", "lr", "beta1", "beta2", "eps", "t" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "DsSgdStep", "type": "string" }, "params": { "additionalProperties": false, "properties": { "grads": { "items": { "format": "double", "type": "number" }, "type": "array" }, "lr": { "format": "double", "type": "number" }, "params": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "params", "grads", "lr" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceVar", "type": "string" }, "params": { "additionalProperties": false, "properties": { "confidence": { "format": "double", "type": "number" }, "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns", "confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceCvar", "type": "string" }, "params": { "additionalProperties": false, "properties": { "confidence": { "format": "double", "type": "number" }, "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns", "confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceMaxDrawdown", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceDrawdownSeries", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceDownsideDeviation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "target": { "format": "double", "type": "number" } }, "required": [ "returns", "target" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceRiskMetrics", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "risk_free_rate": { "format": "double", "type": "number" } }, "required": [ "returns", "risk_free_rate" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceMonteCarloVar", "type": "string" }, "params": { "additionalProperties": false, "properties": { "confidence": { "format": "double", "type": "number" }, "mean": { "format": "double", "type": "number" }, "n_simulations": { "format": "uint", "minimum": 0, "type": "integer" }, "std_dev": { "format": "double", "type": "number" } }, "required": [ "mean", "std_dev", "n_simulations", "confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceStressTest", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cov_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "expected_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "shock_factors": { "items": { "format": "double", "type": "number" }, "type": "array" }, "weights": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "weights", "expected_returns", "cov_matrix", "shock_factors" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceDetectRegimes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_iter": { "format": "uint", "minimum": 0, "type": "integer" }, "n_states": { "format": "uint", "minimum": 0, "type": "integer" }, "observations": { "items": { "format": "double", "type": "number" }, "type": "array" }, "tol": { "format": "double", "type": "number" } }, "required": [ "observations", "n_states", "max_iter", "tol" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceRollingZscore", "type": "string" }, "params": { "additionalProperties": false, "properties": { "values": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "values", "window" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceEwma", "type": "string" }, "params": { "additionalProperties": false, "properties": { "span": { "format": "uint", "minimum": 0, "type": "integer" }, "values": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "values", "span" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceSignalDecay", "type": "string" }, "params": { "additionalProperties": false, "properties": { "half_life": { "format": "double", "type": "number" }, "signal": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "signal", "half_life" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceCombineAlphas", "type": "string" }, "params": { "additionalProperties": false, "properties": { "signals": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "weights": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "signals", "weights" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceCrossSectionalRank", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cross_section": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "cross_section" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceMomentum", "type": "string" }, "params": { "additionalProperties": false, "properties": { "lookback": { "format": "uint", "minimum": 0, "type": "integer" }, "prices": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "prices", "lookback" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceMeanReversion", "type": "string" }, "params": { "additionalProperties": false, "properties": { "values": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "values", "window" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceInformationCoefficient", "type": "string" }, "params": { "additionalProperties": false, "properties": { "forward_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "signal": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "signal", "forward_returns" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceTwap", "type": "string" }, "params": { "additionalProperties": false, "properties": { "interval_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "n_slices": { "format": "uint", "minimum": 0, "type": "integer" }, "start_time": { "format": "uint64", "minimum": 0, "type": "integer" }, "total_quantity": { "format": "double", "type": "number" } }, "required": [ "total_quantity", "n_slices", "start_time", "interval_secs" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceVwap", "type": "string" }, "params": { "additionalProperties": false, "properties": { "interval_secs": { "format": "uint64", "minimum": 0, "type": "integer" }, "start_time": { "format": "uint64", "minimum": 0, "type": "integer" }, "total_quantity": { "format": "double", "type": "number" }, "volume_profile": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "total_quantity", "volume_profile", "start_time", "interval_secs" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceMarketImpact", "type": "string" }, "params": { "additionalProperties": false, "properties": { "average_daily_volume": { "format": "double", "type": "number" }, "daily_volatility": { "format": "double", "type": "number" }, "impact_coefficient": { "format": "double", "type": "number" }, "order_quantity": { "format": "double", "type": "number" } }, "required": [ "daily_volatility", "order_quantity", "average_daily_volume", "impact_coefficient" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinancePairsTrading", "type": "string" }, "params": { "additionalProperties": false, "properties": { "lookback": { "format": "uint", "minimum": 0, "type": "integer" }, "prices_a": { "items": { "format": "double", "type": "number" }, "type": "array" }, "prices_b": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "prices_a", "prices_b", "lookback" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceMatchOrders", "type": "string" }, "params": { "additionalProperties": false, "properties": { "orders": { "items": { "$ref": "#/components/schemas/ResDef_Query_Order" }, "type": "array" } }, "required": [ "orders" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceAvellanedaStoikov", "type": "string" }, "params": { "additionalProperties": false, "properties": { "gamma": { "format": "double", "type": "number" }, "inventory": { "format": "double", "type": "number" }, "kappa": { "format": "double", "type": "number" }, "mid": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" }, "tau": { "format": "double", "type": "number" } }, "required": [ "mid", "inventory", "sigma", "gamma", "kappa", "tau" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceGltQuotes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "a": { "format": "double", "type": "number" }, "gamma": { "format": "double", "type": "number" }, "inventory": { "format": "double", "type": "number" }, "kappa": { "format": "double", "type": "number" }, "mid": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" } }, "required": [ "mid", "inventory", "sigma", "gamma", "kappa", "a" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceLogitQuotes", "type": "string" }, "params": { "additionalProperties": false, "properties": { "boundary_m": { "format": "double", "type": "number" }, "gamma": { "format": "double", "type": "number" }, "inventory": { "format": "double", "type": "number" }, "kappa": { "format": "double", "type": "number" }, "p_mid": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" }, "tau": { "format": "double", "type": "number" } }, "required": [ "p_mid", "inventory", "sigma", "gamma", "kappa", "tau", "boundary_m" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceGlostenMilgromSpread", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "p": { "format": "double", "type": "number" } }, "required": [ "alpha", "p" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceExpectedPnlRate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "a": { "format": "double", "type": "number" }, "alpha": { "format": "double", "type": "number" }, "delta": { "format": "double", "type": "number" }, "kappa": { "format": "double", "type": "number" }, "p": { "format": "double", "type": "number" }, "v_h": { "format": "double", "type": "number" }, "v_l": { "format": "double", "type": "number" } }, "required": [ "delta", "a", "kappa", "alpha", "p", "v_h", "v_l" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceBreakevenAlpha", "type": "string" }, "params": { "additionalProperties": false, "properties": { "delta": { "format": "double", "type": "number" }, "p": { "format": "double", "type": "number" }, "v_h": { "format": "double", "type": "number" }, "v_l": { "format": "double", "type": "number" } }, "required": [ "delta", "p", "v_h", "v_l" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceOfiSeries", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ask_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ask_sz": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_sz": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ts": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window_secs": { "format": "double", "type": "number" } }, "required": [ "ts", "bid_px", "bid_sz", "ask_px", "ask_sz", "window_secs" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceMicropriceSeries", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ask_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ask_sz": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_sz": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "bid_px", "bid_sz", "ask_px", "ask_sz" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceVpinPm", "type": "string" }, "params": { "additionalProperties": false, "properties": { "buy_vol": { "items": { "format": "double", "type": "number" }, "type": "array" }, "p_mean": { "items": { "format": "double", "type": "number" }, "type": "array" }, "sell_vol": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "buy_vol", "sell_vol", "p_mean" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceHawkesMle", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_iter": { "format": "uint", "minimum": 0, "type": "integer" }, "t_horizon": { "format": "double", "type": "number" }, "times": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "times", "t_horizon", "max_iter" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceHardimanBouchaud", "type": "string" }, "params": { "additionalProperties": false, "properties": { "n_windows": { "format": "uint", "minimum": 0, "type": "integer" }, "t_horizon": { "format": "double", "type": "number" }, "times": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "times", "t_horizon", "n_windows" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceKyleLambda", "type": "string" }, "params": { "additionalProperties": false, "properties": { "price_changes": { "items": { "format": "double", "type": "number" }, "type": "array" }, "signed_order_flow": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "price_changes", "signed_order_flow" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceSurveillanceRisk", "type": "string" }, "params": { "additionalProperties": false, "properties": { "baseline_sigma": { "format": "double", "type": "number" }, "buy_vol": { "items": { "format": "double", "type": "number" }, "type": "array" }, "p_mean": { "items": { "format": "double", "type": "number" }, "type": "array" }, "price_changes": { "items": { "format": "double", "type": "number" }, "type": "array" }, "sell_vol": { "items": { "format": "double", "type": "number" }, "type": "array" }, "signed_flow": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "buy_vol", "sell_vol", "p_mean", "signed_flow", "price_changes", "baseline_sigma" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceKellyFraction", "type": "string" }, "params": { "additionalProperties": false, "properties": { "c": { "format": "double", "type": "number" }, "fraction": { "format": "double", "type": "number" }, "q": { "format": "double", "type": "number" } }, "required": [ "q", "c", "fraction" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceBayesianKelly", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "c": { "format": "double", "type": "number" }, "n_quadrature": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "alpha", "beta", "c", "n_quadrature" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinancePosteriorCredibleInterval", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "level": { "format": "double", "type": "number" } }, "required": [ "alpha", "beta", "level" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinancePurgedCpcv", "type": "string" }, "params": { "additionalProperties": false, "properties": { "embargo": { "format": "uint", "minimum": 0, "type": "integer" }, "n_groups": { "format": "uint", "minimum": 0, "type": "integer" }, "n_samples": { "format": "uint", "minimum": 0, "type": "integer" }, "n_test_groups": { "format": "uint", "minimum": 0, "type": "integer" }, "purge_window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "n_samples", "n_groups", "n_test_groups", "purge_window", "embargo" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceDeflatedSharpe", "type": "string" }, "params": { "additionalProperties": false, "properties": { "n_trials": { "format": "uint", "minimum": 0, "type": "integer" }, "observed_sr": { "format": "double", "type": "number" }, "sr_returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "observed_sr", "n_trials", "sr_returns" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceProbabilityBacktestOverfit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "insample": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "oos": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "insample", "oos" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceDieboldMariano", "type": "string" }, "params": { "additionalProperties": false, "properties": { "h": { "format": "uint", "minimum": 0, "type": "integer" }, "losses_a": { "items": { "format": "double", "type": "number" }, "type": "array" }, "losses_b": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "losses_a", "losses_b", "h" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceForensicReport", "type": "string" }, "params": { "additionalProperties": false, "properties": { "prior_year": { "$ref": "#/components/schemas/ResDef_Query_YearData" }, "this_year": { "$ref": "#/components/schemas/ResDef_Query_YearData" } }, "required": [ "this_year", "prior_year" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceKalmanFilter1d", "type": "string" }, "params": { "additionalProperties": false, "properties": { "f": { "format": "double", "type": "number" }, "h": { "format": "double", "type": "number" }, "observations": { "items": { "format": "double", "type": "number" }, "type": "array" }, "p0": { "format": "double", "type": "number" }, "q": { "format": "double", "type": "number" }, "r": { "format": "double", "type": "number" }, "x0": { "format": "double", "type": "number" } }, "required": [ "observations", "f", "q", "h", "r", "x0", "p0" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceKalmanBeta", "type": "string" }, "params": { "additionalProperties": false, "properties": { "asset_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "beta0": { "format": "double", "type": "number" }, "market_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "p0": { "format": "double", "type": "number" }, "q": { "format": "double", "type": "number" }, "r": { "format": "double", "type": "number" } }, "required": [ "market_returns", "asset_returns", "q", "r", "beta0", "p0" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceKalmanVolatility", "type": "string" }, "params": { "additionalProperties": false, "properties": { "annualization": { "format": "double", "type": "number" }, "log_var0": { "format": "double", "type": [ "number", "null" ] }, "p0": { "format": "double", "type": "number" }, "q": { "format": "double", "type": "number" }, "r": { "format": "double", "type": "number" }, "returns": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "returns", "q", "r", "p0", "annualization" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceAdfTest", "type": "string" }, "params": { "additionalProperties": false, "properties": { "max_lag": { "format": "uint", "minimum": 0, "type": "integer" }, "series": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "series", "max_lag" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceOuCalibrate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "dt": { "format": "double", "type": "number" }, "spread": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "spread", "dt" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceOuOptimalThresholds", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cost": { "format": "double", "type": "number" }, "mu": { "format": "double", "type": "number" }, "sigma": { "format": "double", "type": "number" }, "sigma_eq": { "format": "double", "type": "number" }, "theta": { "format": "double", "type": "number" } }, "required": [ "theta", "mu", "sigma", "sigma_eq", "cost" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceMarkovTransitionMatrix", "type": "string" }, "params": { "additionalProperties": false, "properties": { "n_states": { "format": "uint", "minimum": 0, "type": "integer" }, "states": { "items": { "format": "uint", "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "states", "n_states" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceOrderBookImbalance", "type": "string" }, "params": { "additionalProperties": false, "properties": { "v_ask": { "items": { "format": "double", "type": "number" }, "type": "array" }, "v_bid": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "v_bid", "v_ask" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceQueueImbalance", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ask_q": { "items": { "format": "double", "type": "number" }, "type": "array" }, "ask_rate": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_q": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_rate": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "bid_q", "ask_q", "bid_rate", "ask_rate" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceRealizedVolTick", "type": "string" }, "params": { "additionalProperties": false, "properties": { "mid": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "mid", "window" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceSpreadReversion", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ask_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "bid_px": { "items": { "format": "double", "type": "number" }, "type": "array" }, "window": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "bid_px", "ask_px", "window" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceInformationRatio", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ic": { "format": "double", "type": "number" }, "n_independent": { "format": "double", "type": "number" } }, "required": [ "ic", "n_independent" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceEffectiveIndependentN", "type": "string" }, "params": { "additionalProperties": false, "properties": { "returns_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "returns_matrix" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceAlphaCombinationEngine", "type": "string" }, "params": { "additionalProperties": false, "properties": { "lookback": { "format": "uint", "minimum": 0, "type": "integer" }, "returns_matrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "returns_matrix", "lookback" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceBrierScore", "type": "string" }, "params": { "additionalProperties": false, "properties": { "forecasts": { "items": { "format": "double", "type": "number" }, "type": "array" }, "outcomes": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "forecasts", "outcomes" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceConvergenceGate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "min_agree": { "format": "uint", "minimum": 0, "type": "integer" }, "strengths": { "items": { "format": "double", "type": "number" }, "type": "array" }, "strong_threshold": { "format": "double", "type": "number" } }, "required": [ "strengths", "strong_threshold", "min_agree" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceEmpiricalKelly", "type": "string" }, "params": { "additionalProperties": false, "properties": { "b": { "format": "double", "type": "number" }, "historical_returns": { "items": { "format": "double", "type": "number" }, "type": "array" }, "n_simulations": { "format": "uint", "minimum": 0, "type": "integer" }, "p": { "format": "double", "type": "number" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "p", "b", "historical_returns", "n_simulations", "seed" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceSabrImpliedVol", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "f": { "format": "double", "type": "number" }, "k": { "format": "double", "type": "number" }, "nu": { "format": "double", "type": "number" }, "rho": { "format": "double", "type": "number" }, "t": { "format": "double", "type": "number" } }, "required": [ "f", "k", "t", "alpha", "beta", "rho", "nu" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceSabrSmile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "alpha": { "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number" }, "f": { "format": "double", "type": "number" }, "nu": { "format": "double", "type": "number" }, "rho": { "format": "double", "type": "number" }, "strikes": { "items": { "format": "double", "type": "number" }, "type": "array" }, "t": { "format": "double", "type": "number" } }, "required": [ "f", "strikes", "t", "alpha", "beta", "rho", "nu" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "FinanceSabrCalibrate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "beta": { "format": "double", "type": "number" }, "f": { "format": "double", "type": "number" }, "market_vols": { "items": { "format": "double", "type": "number" }, "type": "array" }, "strikes": { "items": { "format": "double", "type": "number" }, "type": "array" }, "t": { "format": "double", "type": "number" } }, "required": [ "f", "t", "strikes", "market_vols", "beta" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "RegisterIdentity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "role": { "$ref": "#/components/schemas/ResDef_Query_AgentRole" }, "roles": { "description": "RBAC role names this agent holds (CONCEPT:EG-KG.compute.feature).", "items": { "type": "string" }, "type": "array" }, "signature": { "type": "string" }, "teams": { "items": { "type": "string" }, "type": "array" } }, "required": [ "agent_id", "role", "teams", "signature", "roles" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read back one principal's currently-registered identity (CONCEPT:EG-KG.compute.feature).\n`RegisterIdentity` REPLACES an agent's whole role set on every call -- there is no\nmerge -- so a caller that wants to ADD a role without silently dropping one already\ngranted by a prior admission pass must read the current set back first; this closes\nthat gap. The handler returns `Option` (`eg_types::acl::AgentIdentity`):\n`None` means \"no identity registered for `agent_id`\" (unknown), which callers MUST\nkeep distinct from `Some(identity)` carrying an empty `roles` Vec (registered,\nCONFIRMED to hold no roles) -- conflating the two would reintroduce the exact\nblind-upsert ambiguity this RPC exists to eliminate. Gated `security:admin`, the same\nscope `RegisterIdentity` already requires, so this grants no new privilege to anyone\nwho could not already call `RegisterIdentity`.", "properties": { "method": { "const": "GetIdentity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" } }, "required": [ "agent_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Administer the RBAC role/grant policy (CONCEPT:EG-KG.compute.feature). Unconditional in the\nenum; the handler is gated behind the `security` feature (a non-security build\nfalls to the dispatch \"not available in this build\" catch-all, like EG-090's\nbackup/restore on a non-redb build).", "properties": { "method": { "const": "RbacAdmin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_RbacAdminOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "ApplyMultisigMutation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "mutation_type": { "type": "string" }, "query": { "type": "string" }, "signatures": { "items": { "type": "string" }, "type": "array" }, "threshold": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "signatures", "threshold", "mutation_type", "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "The durable analytics-job plane (CONCEPT:INT-P2-1): async caller control\nplus verified remote-worker claim/renew/checkpoint/stage/publish/cancel over\na coordinator-owned `AnalyticsJob` state machine (`eg-jobs`),\nwhose eventual success commits a provenance'd `:Claim`/`:Evidence` pair (the\nSAME typed-node convention `eg-epistemic` reads). ONE variant wrapping an\ninternal op enum \u2014 mirrors `RbacAdmin { op }` above \u2014 so the whole\nfull surface costs exactly one `Method` arm. Gated `jobs`; the handler\n(`src/server/handlers/jobs.rs`)\nself-routes in `dispatch.rs` before the per-graph chain (jobs are keyed by\n`job_id` in their own `jobs.redb`, not a graph \u2014 like `TsAppend`/`Kv*`).", "properties": { "method": { "const": "AnalyticsJob", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_JobOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "The native finite-state-machine / statechart engine (CONCEPT:INT-P2-2):\ndefine/instantiate/send_event/get_state/list over a durable, rehydratable\n`MachineInstance` `(state, context)` record in `statecharts.redb` (`eg-statechart`).\nONE variant wrapping an internal op enum \u2014 mirrors `AnalyticsJob { op }` above \u2014\nso the whole engine surface costs exactly one `Method` arm. Gated `statechart`;\nthe handler (`src/server/handlers/statechart.rs`) self-routes in `dispatch.rs`\nbefore the per-graph chain (instances are keyed by `instance_id` in their own\n`statecharts.redb`, not a graph \u2014 like `AnalyticsJob`/`TsAppend`/`Kv*`).", "properties": { "method": { "const": "Statechart", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_StatechartOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "The agent-facing quantum control-plane surface (Q8, CONCEPT:EG-KG.compute.quantum-agent-api):\n`quantum_rank`/`optimize_with_qaoa`/`quantum_expectation` over a registered\n`eg_quantum_core::backend::QuantumBackend` (today: `eg-quantum-sim`'s\n`sv-cpu`/`stabilizer`). ONE variant wrapping an internal op enum \u2014 mirrors\n`AnalyticsJob { op }`/`Statechart { op }` above \u2014 so the whole surface costs\nexactly one `Method` arm. Gated `quantum`; the handler\n(`src/server/handlers/quantum.rs`) self-routes in `dispatch.rs` before the\nper-graph chain (a quantum run reads no persisted graph state and writes\nnothing durable \u2014 every result is returned to the caller as a proposal,\nnever committed \u2014 like `AnalyticsJob`/`Statechart`/`TsAppend`/`Kv*`).", "properties": { "method": { "const": "Quantum", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_QuantumOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Native ASR provider surface (GOC-33, `OWNER-VOICE-ASR`): a direct,\nnon-durable batch-file transcription call over the whisper-rs/\nwhisper.cpp provider in `eg-asr-whisper` \u2014 the wire surface\n`audio-transcriber`'s pluggable `TranscriptionProvider` seam reaches\nover the existing `epistemic_graph.client` transport (no second\ntransport). ONE variant wrapping an internal op enum, mirroring\n`Quantum { op }`/`Statechart { op }` above. Gated `asr-native`; the\nhandler (`src/server/handlers/asr.rs`) self-routes in `dispatch.rs`\nbefore the per-graph chain (a transcription reads no persisted graph\nstate and commits no durable `asr.result.v1` \u2014 see\n`crates/eg-audio/src/asr.rs`'s module doc for that authority\nboundary, owned by future worker/AU-orchestration work).", "properties": { "method": { "const": "Asr", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_AsrOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Native visualization render surface (D-VZ-1 lanes V4 \"engine integration\" /\nV6 \"graph-native marks\"): resolve a caller-provided `eg_viz_core::ViewSpec`\nagainst a dataset (caller-supplied inline columns, or deterministic\nengine-side synthetic data) and render it to static PNG/SVG/PDF bytes, or\nfetch the mark x surface capability matrix. ONE variant wrapping an\ninternal op enum \u2014 mirrors `AnalyticsJob { op }`/`Statechart { op }` above\n\u2014 so the whole render surface costs exactly one `Method` arm. Gated `viz`;\nthe handler (`src/server/handlers/viz.rs`, facade feature\n`viz-static-export`) self-routes in `dispatch.rs` before the per-graph\nchain \u2014 a render is NOT graph-scoped (it resolves a FRESH per-request\n`ColumnStore`, never a live graph read), exactly like `AnalyticsJob`/\n`Statechart` above. V4-LITE, not full V4: no tile cache, no provenance\ninherited from a durable job, no view over a resident `GraphCore` \u2014 see\n`crate::viz`'s module doc.", "properties": { "method": { "const": "Viz", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_VizOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "Sql", "type": "string" }, "params": { "additionalProperties": false, "properties": { "params_msgpack": { "default": [], "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "query": { "type": "string" } }, "required": [ "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "CypherQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "mode": { "$ref": "#/components/schemas/ResDef_Query_CypherMode", "description": "Exact requested execution authority; no implicit or inferred mode." }, "query": { "type": "string" } }, "required": [ "query", "mode" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GraphQl", "type": "string" }, "params": { "additionalProperties": false, "properties": { "query": { "type": "string" }, "variables": { "description": "Optional GraphQL `$variables` \u2014 a JSON object bound at execution\n(CONCEPT:EG-KG.query.fragments-variables-directives variables, wired through the wire path as an EG-064\nfollow-up). The handler binds these via `execute_with_variables`\n(`@skip`/`@include` + `$var` args). `None` is encoded explicitly and means\nan empty binding." } }, "required": [ "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Pull one bounded Arrow `KnowledgeBatch` from any served query family.\n`cursor=None` opens a snapshot; passing the returned cursor resumes only\nwhen authority, graph snapshot, query, schema and batch size still match.\nThis is the sole native result contract and returns bounded Arrow IPC.", "properties": { "method": { "const": "KnowledgeStream", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_KnowledgeStreamRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "UnifiedQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ResDef_Query_Plan" } }, "required": [ "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "UnifiedQueryText", "type": "string" }, "params": { "additionalProperties": false, "properties": { "text": { "type": "string" } }, "required": [ "text" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "`EXPLAIN PLAN` \u2014 serialize `plan` as a [`crate::wire::Plan`]::PlanDag conversion\n(a linear plan is a degenerate chain, CONCEPT:EG-KG.query.plan-dag) both BEFORE and\nAFTER the DAG-aware cost optimizer (`eg_plan::optimizer::optimize_dag`), plus the\nactive rule set (`eg_plan::cost_opt_rule_names()`) \u2014 the optimizer rewrite trace.\nReturns an `ExplainPlanResult` via `ResultPayload::raw`. Gated `query` (same as\n`UnifiedQuery`).", "properties": { "method": { "const": "ExplainPlan", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ResDef_Query_Plan" } }, "required": [ "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "`EXPLAIN PROVENANCE` \u2014 run `plan` and, for each result row, resolve its\nEVIDENCE-FOR provenance (the SAME belief-substrate `EvidenceFor` resolution E2's\n`Op::EvidenceFor` op runs) over the `KnowledgeSet` (E3) row shape. With the\n`epistemic` feature OFF (or absent at runtime) every row's provenance is empty and\n`resolved` is `false` \u2014 the documented \"no epistemic resolution ran\" behavior E3's\n`KnowledgeSet` already carries (CONCEPT:EG-KG.query.knowledge-set). Returns an\nschema-generated `EvidenceBundle` via `ResultPayload::raw`. Gated `query`.", "properties": { "method": { "const": "ExplainProvenance", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ResDef_Query_Plan" } }, "required": [ "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "`EXPLAIN PROVENANCE BY IDS` (CONCEPT:EG-KB-CURRENCY) \u2014 the ID-seeded sibling of\n`ExplainProvenance`: skip the `Plan`/`Op` algebra entirely and resolve the SAME\nprotocol evidence claims directly for `ids` \u2014 the\nshape a caller that already has a set of node ids from ANY other read path\n(a Cypher `MATCH`, a SQL `SELECT`, a prior `UnifiedQuery`) needs to \"currency-\nupgrade\" a plain id list into calibrated, cited, time-versioned rows without\nhand-building an `Op` plan first. `ids` is deduplicated, first-occurrence order\npreserved (mirrors `RowSet::from_ids`); an id absent from the graph is silently\nskipped (never fabricated). Returns an `EvidenceBundle` via\n`ResultPayload::raw`, byte-identical in shape to `ExplainProvenance`'s. Gated\n`query` (same as `ExplainProvenance`).", "properties": { "method": { "const": "ExplainProvenanceByIds", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "`EXPLAIN POLICY` \u2014 run `plan` against BOTH the caller's RLS-filtered snapshot and\nthe UNFILTERED snapshot (reusing the SAME `eg_core::isolation::IsolationLayer`\n`filter_view` every read path already applies), reporting which result rows the\npolicy DENIED. With the `security` feature off (or no caller/RLS configured), no\nfiltering applies and `policy_denied_ids` is always empty. Returns an\n`ExplainPolicyResult` via `ResultPayload::raw`. Gated `query`.", "properties": { "method": { "const": "ExplainPolicy", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ResDef_Query_Plan" } }, "required": [ "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "`EXPLAIN BELIEF ` \u2014 the FULL, un-flattened E1 justification tree\n(`eg_epistemic::JustificationGraph`, via `eg_plan::explain_belief_tree`) rooted at\n`node_id` \u2014 the standalone verbatim-tree surface E2's plan-`Op::ExplainBelief`\n(a flat `RowSet` projection) documents as a follow-up, mirroring\n`Method::OwlExplain`'s `ProofNodeWire`. Returns an `ExplainBeliefResult` via\n`ResultPayload::raw`. Gated `epistemic` (which implies `query`).\n\n`disclosure_level` (EPI-P3-4, L51) is `None` by default \u2014 the DEFAULT PATH IS\nUNCHANGED: the handler runs the classic un-redacted `explain_belief` and returns\n`ExplainBeliefResult` exactly as before this field existed. When `Some(_)`, the\ncaller opts INTO the policy-aware, RLS-redacted proof\n(`eg_epistemic::redact::explain_belief_redacted`, feature `epistemic-redaction`\non the facade, which pulls `eg-core/security`) \u2014 the handler then returns an\n`ExplainBeliefRedactedResult` INSTEAD of `ExplainBeliefResult` in the SAME\n`ResultPayload::raw` slot (the caller who set this field knows to decode the\nother type). The requested level is a CAP, never a grant: a caller may ask for a\nSTRICTER view than their own RLS access earns (e.g. always request\n`ExistenceOnly` for a privacy-conscious display) but can never loosen what\n`explain_belief_redacted` computes from their actual access \u2014 see\n`eg_epistemic::redact` module docs. If `epistemic-redaction` is OFF at build\ntime, a request naming `Some(_)` gets an explicit error response (never a silent\nfall-back to the un-redacted tree \u2014 that would leak exactly what redaction\nexists to hide).", "properties": { "method": { "const": "ExplainBelief", "type": "string" }, "params": { "additionalProperties": false, "properties": { "disclosure_level": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_DisclosureLevelWire" }, { "type": "null" } ] }, "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "The Phase-3 acceptance capstone (EPI-P3-5, L53): \"what do we believe, why, on\nexactly which evidence, under whose authority, at what time, with what\nuncertainty, and what would invalidate it\" \u2014 for `node_id`, in ONE typed call\n(`eg_epistemic::epistemic_status`, feature `epistemic-tms`). Composes belief\n(`is_believed`/confidence), the proof tree (`why`), the diagnostic (`why_not`,\npopulated iff not believed), the counterfactual (`what_evidence_would_change_this`),\nand this claim's own bitemporal window \u2014 every sibling facet\n`eg_epistemic::query` exposes for ONE claim, so those are not separately wired\nas their own `Method`s (a caller wanting just one gets it off this result).\nReturns an `EpistemicStatusResult` via `ResultPayload::raw`. Gated `epistemic`\nat the wire level; the HANDLER additionally requires `epistemic-tms` \u2014 a build\nwith `epistemic` but not `epistemic-tms` falls to the graph_ops \"not available\nin this build\" catch-all (same convention as every other feature-gated arm).", "properties": { "method": { "const": "EpistemicStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "**what_changed**(tx_from, tx_to) (EPI-P3-5, L53): between two transaction times,\nwhich beliefs changed and why (`eg_epistemic::what_changed`, feature\n`epistemic-tms`) \u2014 the one acceptance-query facet that is NOT a sub-field of\n`EpistemicStatus` (it is a whole-graph temporal DIFF, not a single claim's\nstatus), so it gets its own `Method`. Returns a `WhatChangedResult` via\n`ResultPayload::raw`. Same build-tier fallback convention as `EpistemicStatus`.", "properties": { "method": { "const": "WhatChanged", "type": "string" }, "params": { "additionalProperties": false, "properties": { "tx_from": { "format": "uint64", "minimum": 0, "type": "integer" }, "tx_to": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "tx_from", "tx_to" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Fenced recompute/writeback for one stale materialization. The expected source\ngraph version must exactly match the durable reasoning projection watermark.\nReplicated serving commits an opaque recompute intent with the authoritative\ngraph version fence, then the durable outbox worker resolves provenance from\nthe graph post-image and fsyncs the side projection before acknowledging it.\nA late recompute fails with `STALE_RECOMPUTE_FENCE` rather than overwriting a\nnewer invalidation.", "properties": { "method": { "const": "RecomputeMaterialization", "type": "string" }, "params": { "additionalProperties": false, "properties": { "derived_id": { "type": "string" }, "expected_source_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "derived_id", "expected_source_graph_version" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Seam 3 \u2014 query the CURRENT status (`\"Fresh\"`/`\"Stale\"`/`\"Retracted\"`, or\nabsent if never registered) of a materialization tracked on the SAME\nper-graph durable incremental reasoning projection. Read-only \u2014 does not\nitself recompute anything. Returns a\n`MaterializationStatusResult` via `ResultPayload::raw`. Same build-tier\nfallback convention as `RecomputeMaterialization`.", "properties": { "method": { "const": "MaterializationStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "id": { "type": "string" } }, "required": [ "id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Seam 3 follow-up (SURPASS gap-closure: \"give staleness a consumer\") \u2014 the bulk\ncounterpart of [`Method::MaterializationStatus`]: every opaque materialization\nreference CURRENTLY `Stale` in this graph's durable projection.\nSame build-tier fallback convention as `MaterializationStatus`.", "properties": { "method": { "const": "StaleMaterializations", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "EPI-P3-7 (gap-fill) \u2014 standalone paraconsistent conflict resolution: run Dung\nabstract-argumentation semantics (`eg_epistemic::tms`, feature `epistemic-tms`)\nover a `BeliefGraph` built from the caller's `GraphView`, and report \u2014 for each\nof `node_ids` \u2014 whether it SURVIVES, is DEFEATED, or stays UNDECIDED under\n`semantics` (`\"grounded\"` (default) | `\"preferred\"` | `\"stable\"`). This is the\nSAME grounded/preferred/stable extension machinery `Method::EpistemicStatus`\nalready composes internally (via `is_skeptically_accepted`) for a single claim's\nacceptance \u2014 reachable here as a standalone, multi-claim, semantics-selectable\nop instead of only inside that capstone. Returns a `ResolveConflictResult`\n(surviving/defeated/undecided id lists + the raw extension set(s) the verdict\nwas computed from) via `ResultPayload::raw`. Gated `epistemic` at the wire\nlevel; the HANDLER additionally requires `epistemic-tms` \u2014 a build with\n`epistemic` but not `epistemic-tms` falls to the graph_ops \"not available in\nthis build\" catch-all (same convention as `EpistemicStatus`/`WhatChanged`).", "properties": { "method": { "const": "ResolveConflict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_ids": { "items": { "type": "string" }, "type": "array" }, "semantics": { "default": "grounded", "type": "string" } }, "required": [ "node_ids" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "X-1 (CONCEPT:EG-X1) \u2014 resolve `node_id`'s cited multimodal evidence: build a\n`BeliefGraph` off the caller's `GraphView` and walk the SAME support/\ncontradiction/attack topology `ExplainBelief` walks, returning every\ntransitively-reachable node that carries one complete governed `EvidenceLocus`\n(page region, audio/video interval, row version, code range, trace span, \u2026).\nThe locus itself carries the opaque subject, policy, and derivation references\n(`eg_epistemic::evidence_citations`, feature `evidence-graph`) \u2014 \"here is\nexactly where in the source this claim's evidence came from.\" Returns an\n`ExplainEvidenceResult` via `ResultPayload::raw`. Gated `epistemic` at the wire\nlevel (implies `query`); the HANDLER additionally requires `evidence-graph` \u2014\na build with `epistemic` but not `evidence-graph` falls to the graph_ops \"not\navailable in this build\" catch-all (same convention as `EpistemicStatus`/\n`epistemic-tms`).", "properties": { "method": { "const": "ExplainEvidence", "type": "string" }, "params": { "additionalProperties": false, "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "EPI-P3-3 \u2014 a request-carried linear-Gaussian structural causal model query:\n`variables` defines the DAG's `StructuralEquation`s in topological\n(parents-before-children) order \u2014 the SAME invariant\n`eg_epistemic::CausalGraph::add_variable` enforces at construction. `mode`\n(EPI-P3-6) selects which of `eg_epistemic::CausalGraph`'s two\nnon-counterfactual queries `do_values` feeds:\n\n* `CausalQueryModeWire::Intervene` \u2014 a **do-calculus intervention**\n `P(\u00b7 | do(X\u2081=x\u2081, X\u2082=x\u2082, \u2026))`:\n `do_values` fixes the named variables via graph surgery\n (`CausalGraph::intervene`) \u2014 incoming edges are CUT, not conditioned on.\n* `CausalQueryModeWire::Observe` \u2014 the **observational** query\n `P(\u00b7 | X\u2081=x\u2081, X\u2082=x\u2082, \u2026)`: ordinary multivariate-Gaussian conditioning on\n the UNMUTILATED joint (`CausalGraph::observe`). Unlike `Intervene`,\n evidence propagates BACKWARD to ancestors too (e.g. a confounder) \u2014 the\n mechanism a naive \"condition on the evidence\" read of a causal question\n gets wrong, and exactly what distinguishes \"seeing X=x\" from \"doing X=x\".\n\nEither way, returns a calibrated `CausalEstimateResult` (mean/variance/\ncredible-interval per variable, in `variables` order) via\n`ResultPayload::raw`. A pure function over request-carried inputs \u2014 no graph\nsnapshot is read. Gated `epistemic` at the wire level; the HANDLER\nadditionally requires `epistemic-causal` \u2014 same build-tier fallback\nconvention as `ExplainEvidence`.\n\nThe crate's Pearl point-counterfactual (`CausalGraph::counterfactual`) is a\ndistinct, DETERMINISTIC (not distributional) query with its own request\nshape \u2014 see `CausalCounterfactual` below, not this variant.", "properties": { "method": { "const": "CausalEstimate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "do_values": { "additionalProperties": { "format": "double", "type": "number" }, "type": "object" }, "mode": { "$ref": "#/components/schemas/ResDef_Query_CausalQueryModeWire" }, "variables": { "items": { "$ref": "#/components/schemas/ResDef_Query_StructuralEquationWire" }, "type": "array" } }, "required": [ "variables", "do_values", "mode" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "EPI-P3-6 \u2014 Pearl's point-**counterfactual** recipe\n(`eg_epistemic::CausalGraph::counterfactual`, feature `epistemic-causal`):\n\"given that unit `actual` (a FULLY-observed assignment of every variable in\n`variables`) really happened, what would its variables have been had\n`do_values` held instead?\" \u2014 the three-step abduction/action/prediction\nrecipe (Pearl, *Causality*, ch. 7), replaying the SAME inferred exogenous\nnoise forward through the (surgered) structural equations.\n\nDETERMINISTIC given `actual` \u2014 not a calibrated distribution like\n`CausalEstimate` \u2014 so it returns a `CausalCounterfactualResult` (one POINT\nvalue per variable, in `variables` order) via `ResultPayload::raw` instead\nof a `CausalEstimateResult`. A pure function over request-carried inputs \u2014\nno graph snapshot is read. Gated `epistemic` at the wire level; the HANDLER\nadditionally requires `epistemic-causal` \u2014 same build-tier fallback\nconvention as `CausalEstimate`.", "properties": { "method": { "const": "CausalCounterfactual", "type": "string" }, "params": { "additionalProperties": false, "properties": { "actual": { "additionalProperties": { "format": "double", "type": "number" }, "type": "object" }, "do_values": { "additionalProperties": { "format": "double", "type": "number" }, "type": "object" }, "variables": { "items": { "$ref": "#/components/schemas/ResDef_Query_StructuralEquationWire" }, "type": "array" } }, "required": [ "variables", "actual", "do_values" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "EPI-P3-3 \u2014 provenance-aware retrieval ranking: order request-carried\n`candidates` by a weighted blend of similarity AND evidence quality/\nprovenance (source reliability, corroboration, calibration precision,\nfreshness) rather than similarity alone (`eg_epistemic::rank`, feature\n`epistemic-causal`). A pure function over request-carried inputs \u2014 no graph\nsnapshot is read. Returns a `RankByProvenanceResult` via `ResultPayload::raw`.\nSame build-tier fallback convention as `ExplainEvidence`/`CausalEstimate`.", "properties": { "method": { "const": "RankByProvenance", "type": "string" }, "params": { "additionalProperties": false, "properties": { "candidates": { "items": { "$ref": "#/components/schemas/ResDef_Query_RetrievalCandidateWire" }, "type": "array" }, "weights": { "$ref": "#/components/schemas/ResDef_Query_RankWeightsWire", "default": { "evidence_quality": 0.5, "similarity": 0.5 } } }, "required": [ "candidates" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Natural-language \u2192 executable query \u2192 rows. `text` is the NL request, `graph`\nthe target graph (the `/nl` HTTP facade path has no request envelope, so the\ngraph rides the method; over the wire an empty `graph` falls back to the request\nenvelope's graph). The handler resolves a configured/injected `NlPlanner`, turns\nthe NL into a UQL query string, and runs it through the IDENTICAL deterministic\n`UnifiedQueryText` pipeline (`eg_plan::uql::parse` \u2192 the fused executor) \u2014 NO new\nexecution path, and no LLM in the engine core. Result via `ResultPayload::raw` \u2014\nthe SAME `[id, score|nil]` rows as `UnifiedQuery`.\n\nUNCONDITIONAL in the enum (like `RbacAdmin`); the HANDLER is gated behind the\nfacade `nl-query` feature. A build WITHOUT `nl-query` falls to the dispatch \"not\navailable in this build\" catch-all \u2014 so the wire stays compatible while the NL\nsurface is a build-tier choice.", "properties": { "method": { "const": "NlQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "default": "", "type": "string" }, "text": { "type": "string" } }, "required": [ "text" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Register (or replace) a foreign RowSet source under `name`. `source` is the\n[`crate::wire::ForeignSourceSpec`] (a remote engine or an HTTP/JSON API). A\nlater `ForeignScan` can name this registered source by id (the registry-backed\nform) instead of inlining the whole spec. Returns the name on success.", "properties": { "method": { "const": "RegisterForeignSource", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "source": { "$ref": "#/components/schemas/ResDef_Query_ForeignSourceSpec" } }, "required": [ "name", "source" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Register (compile + cache) a WASM UDF under `id`. `wasm` is the module bytes\n(the `.wasm` binary). The module must export `memory`/`alloc`/`udf` and import\nNOTHING (the empty linker rejects any host import). Replaces a prior UDF of the\nsame id. Returns the id on success.", "properties": { "method": { "const": "RegisterUdf", "type": "string" }, "params": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "wasm": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "id", "wasm" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Run a registered WASM UDF `id` over an opaque `input` payload, returning the\nUDF's output bytes (`ResultPayload::Raw`). Sandboxed + fuel-limited: an\ninfinite-loop UDF is KILLED (a trap error), never a hang. The bytes are opaque\nto the engine \u2014 the caller serializes/deserializes its own row payload.", "properties": { "method": { "const": "RunUdf", "type": "string" }, "params": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "input": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "id", "input" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Run a distributed graph algorithm across `graphs` (each a shard/partition),\nwith `algo` selecting PageRank / ConnectedComponents / Bfs. Result is\n`ResultPayload::Raw` \u2014 `[id, score]` rows for PageRank, `[id, label]` for CC/BFS.", "properties": { "method": { "const": "DistributedCompute", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algo": { "$ref": "#/components/schemas/ResDef_Query_DistAlgo" }, "graphs": { "items": { "type": "string" }, "type": "array" } }, "required": [ "graphs", "algo" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Create (or replace) a named, incrementally-maintained MATERIALIZED VIEW of a\ndistributed-compute result over `graphs`. The view is computed once, persisted,\nand refreshed incrementally on a delta (CONCEPT:EG-KG.storage.feature). Returns the row count.", "properties": { "method": { "const": "CreateMatView", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algo": { "$ref": "#/components/schemas/ResDef_Query_DistAlgo" }, "graphs": { "items": { "type": "string" }, "type": "array" }, "name": { "type": "string" } }, "required": [ "name", "graphs", "algo" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read a materialized view's current rows by name (`ResultPayload::Raw`).", "properties": { "method": { "const": "GetMatView", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Incrementally refresh a materialized view after the underlying graphs changed \u2014\nrecomputes only the affected vertices on the delta. Returns the row count.", "properties": { "method": { "const": "RefreshMatView", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Define (or replace) a plan-backed materialized view `name` over `graph`, whose\ndefinition is the cross-modal `plan`. Executes the plan once, caches the result,\nand persists the definition durably. Returns the row count of the first\nmaterialization.", "properties": { "method": { "const": "PlanMatViewDefine", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "name": { "type": "string" }, "plan": { "$ref": "#/components/schemas/ResDef_Query_Plan" } }, "required": [ "name", "graph", "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read a plan-backed materialized view's current rows by name\n(`ResultPayload::Raw`, `[id, score|nil]`). Serves the cached result when fresh;\nrecomputes (and re-caches) when a write to the underlying graph \u2014 or an explicit\nCDC change signal \u2014 retired it.", "properties": { "method": { "const": "PlanMatViewGet", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Force a re-materialization of a plan-backed matview NOW (bypassing the freshness\ncheck), re-executing its stored plan and re-caching. Returns the fresh row count.", "properties": { "method": { "const": "PlanMatViewRefresh", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Drop a plan-backed matview: remove its definition from RAM + the durable tier and\ninvalidate its cached result. Returns `Bool(true)` if it existed.", "properties": { "method": { "const": "PlanMatViewDrop", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "BeginTxn", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "description": "Optional explicit target graph. An explicit `None` selects the request\nenvelope's `graph`.", "type": [ "string", "null" ] }, "isolation": { "description": "Reserved isolation hint; only snapshot isolation is implemented.", "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TxnAddNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "description": "Optional target graph for THIS staged op (CONCEPT:EG-KG.txn.routes-cross-shard-txn \u2014 multi-graph\ntxn). An explicit `None` selects the txn's default graph.\nA staged op naming a graph that resolves to a DIFFERENT Raft group makes\nthe txn CROSS-SHARD, routed through 2PC at commit.", "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TxnRemoveNode", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TxnAddEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "source_id": { "type": "string" }, "target_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "source_id", "target_id", "properties_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TxnRemoveEdge", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "source_id": { "type": "string" }, "target_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "source_id", "target_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TxnCas", "type": "string" }, "params": { "additionalProperties": false, "properties": { "conditions_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "graph": { "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "txn_id": { "type": "string" }, "updates_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "txn_id", "node_id", "conditions_msgpack", "updates_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Stage a VECTOR upsert into a txn (CONCEPT:EG-KG.txn.reader-never-sees-node \u2014 cross-modal ACID). The\nembedding lands atomically WITH the txn's graph/property/blob-ref writes in ONE\nredb `WriteTransaction` at commit \u2014 never a node without its vector.", "properties": { "method": { "const": "TxnAddEmbedding", "type": "string" }, "params": { "additionalProperties": false, "properties": { "embedding": { "items": { "format": "float", "type": "number" }, "type": "array" }, "graph": { "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id", "embedding" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Stage a BLOB REFERENCE into a txn (CONCEPT:EG-KG.txn.reader-never-sees-node \u2014 cross-modal ACID). Records\na durable graph-side link (`__blob__` node property) to an already-stored,\ncontent-addressed blob; lands atomically with the node/vector/property at commit.", "properties": { "method": { "const": "TxnBlobRef", "type": "string" }, "params": { "additionalProperties": false, "properties": { "digest": { "type": "string" }, "graph": { "type": [ "string", "null" ] }, "node_id": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id", "digest" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Stage a TIME-SERIES measurement batch into a txn (CONCEPT:EG-KG.backend.cross-modal-atomic-commit \u2014 extended\ncross-modal staging). The points land atomically WITH the txn's graph/property/\nvector/blob writes in ONE redb `WriteTransaction` at commit \u2014 never a node\nwithout its measurements. `points` is the SAME MessagePack `Vec<(i64 ts, Vec\nvalues)>` blob `TsAppend` carries (kept opaque here so the protocol enum stays\nfree of any eg-tsdb type). Ungated in the enum like the `Ts*` family; the\nstaging/commit handler is `tsdb`-gated at the facade, so a slim build reaches the\ndispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnAddMeasurement", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "points": { "description": "MessagePack `Vec<(i64, Vec)>` \u2014 the batch of points (one round-trip).", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "series": { "description": "Target series id the points belong to.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "series", "points" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Stage OWL AXIOMS (Turtle) into a txn (CONCEPT:EG-KG.txn.extended-cross-modal \u2014 extended cross-modal\nstaging). At commit the `turtle` axioms lower to graph node/edge writes in the\nSAME atomic `WriteTransaction` so the OWL reasoner sees them consistently with the\ntxn's other staged modalities. Gated `owl` (mirrors `OwlReason`); a build without\nit drops the variant \u2192 the dispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnAxiom", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "turtle": { "description": "OWL axioms as Turtle to stage into the txn.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "turtle" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Stage a SPARQL CONSTRUCT into a txn (CONCEPT:EG-KG.query.extended-cross-modal \u2014 extended cross-modal\nstaging). At commit the `sparql` CONSTRUCT's produced triples lower to graph\nnode/edge writes in the SAME atomic `WriteTransaction`. Gated `sparql` (mirrors\n`Sparql`); a build without it drops the variant \u2192 the dispatch \"not available in\nthis build\" catch-all.", "properties": { "method": { "const": "TxnConstruct", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "sparql": { "description": "SPARQL CONSTRUCT query whose triples are staged into the txn.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "sparql" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Stage a PLANNER WRITEBACK into a txn (CONCEPT:EG-KG.query.plan-dag, D7 \u2014 the\nplanner-writeback ACID seam). `plan` (the SAME `wire::Plan` AST `UnifiedQuery`\ncarries) runs READ-ONLY against the txn's committed snapshot; each id in its\nresult `RowSet` becomes an `AddEdge { source_id: anchor_id, target_id: id,\nrelationship }` \u2014 e.g. materializing a `Reason`/`Traverse`-inferred edge set \u2014\nstaged (via `GraphTxnState::stage_plan_writeback`, copying the `TxnAxiom`/\n`TxnConstruct` shape verbatim) into the SAME atomic `WriteTransaction` as the\ntxn's other modalities. Gated `query` (mirrors `UnifiedQuery`); a build without\nit drops the variant \u2192 the dispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnPlanWriteback", "type": "string" }, "params": { "additionalProperties": false, "properties": { "anchor_id": { "description": "The edge SOURCE every materialized edge is anchored to.", "type": "string" }, "graph": { "type": [ "string", "null" ] }, "plan": { "$ref": "#/components/schemas/ResDef_Query_Plan", "description": "The plan whose result `RowSet` is materialized as edges." }, "relationship": { "description": "The `relationship` property every materialized edge carries.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "plan", "anchor_id", "relationship" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Stage a MATERIALIZE-BELIEF op into a txn (CONCEPT:EG-KG.epistemic.epistemic-substrate,\nD5 \u2014 the explicit, AUDITED \"materialize belief\" op the `eg_epistemic` crate docs\ncall for: `BeliefState.confidence` is derived and \"NEVER written back onto\n`NodeData.confidence` \u2026 unless a caller runs an explicit, logged materialize\nbelief op\"). Computes the propagated belief for `node_id` (via\n`eg_epistemic::propagate_confidence` over the graph's SUPPORTS/CONTRADICTS/\nATTACKS evidence topology, read from the txn's COMMITTED snapshot \u2014 the SAME\n\"evaluate now\" shape `TxnPlanWriteback`/`TxnConstruct` use) and stages ONE\nunconditional `CompareAndSetNodeFields` that writes it onto that node's\n`NodeData.confidence` \u2014 landing atomically with the txn's other staged\nmodalities at commit (`GraphTxnState::stage_plan_writeback`, reused verbatim \u2014\nsame OCC read-set capture + cross-modal commit shape as `TxnAxiom`/\n`TxnConstruct`/`TxnPlanWriteback`). The write rides the ALREADY-audited\n`CompareAndSetNodeFields` path (the tamper-evident hash chain, CONCEPT:\nEG-KG.sharding.row-level-security, plus the unconditional in-memory ledger) \u2014\nnever silent, no new audit mechanism. OPT-IN: this is the ONLY path that ever\nwrites a derived belief back onto stored confidence; nothing else in the engine\ndoes so implicitly. Gated `epistemic`; a build without it drops the variant \u2192\nthe dispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnMaterializeBelief", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "node_id": { "description": "The node whose propagated belief is computed and written back.", "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "node_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Run a UNIFIED cross-modal query INSIDE a txn with read-your-own-writes\n(CONCEPT:EG-KG.query.txn-cross-modal-ryow \u2014 in-txn cross-modal RYOW). Executes the SAME `wire::Plan` AST as\n`UnifiedQuery`, but over a snapshot OVERLAID with the txn's staged (uncommitted)\nwrite-set, so a staged node/edge/embedding is visible to THIS txn before commit\nand invisible off-txn until commit. Read-only w.r.t. the committed store. Gated\n`query` (the plan AST + DataFusion filter leg); a slim build drops the variant \u2192\nthe dispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "TxnUnifiedQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/ResDef_Query_Plan" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "plan" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "In-txn unified query, TEXT surface \u2014 UQL (CONCEPT:EG-KG.query.txn-cross-modal-ryow). The human/agent-\nwritable counterpart of `TxnUnifiedQuery`: a UQL `text` string PARSED into the\nSAME `wire::Plan` AST and run through the IDENTICAL overlaid in-txn executor. Same\n`query`-gating + read-your-own-writes semantics as `TxnUnifiedQuery`.", "properties": { "method": { "const": "TxnUnifiedQueryText", "type": "string" }, "params": { "additionalProperties": false, "properties": { "text": { "type": "string" }, "txn_id": { "type": "string" } }, "required": [ "txn_id", "text" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Commit the staged transaction (see the section doc above for the OCC\nserialization/apply contract). `idempotency_key` (B-9, 2026-08-13,\noptional) is a CALLER-chosen dedup key, extending the SAME\n`(tenant, graph, idempotency_key)`-scoped durable dedup mechanism\n`ApplyChangeEnvelope` uses (`change_envelope.rs`'s\n`idempotency_key`/`applied` vs `idempotent_skip` vocabulary) onto the\ntxn commit's own durable receipt, rather than a second mechanism.\nWithout it, retry-safety depends entirely on the caller still holding\nthe exact server-issued `txn_id` (already durable via the receipt) --\nprovably safe for \"commit succeeded, response lost, retry with the SAME\ntxn_id\", but NOT for \"I lost track of txn_id and had to re-`BeginTxn`\nand re-stage\" (a fresh `txn_id` looks like a brand-new transaction).\nWITH a caller key, a retry that re-stages under a fresh `txn_id` still\nlands on the SAME durable receipt and replay-skips.\n\nReturns `Bool` when `idempotency_key` is omitted (UNCHANGED wire shape).\nReturns a `Json` `{\"committed\": bool, \"replayed\": bool}` when a key is\nsupplied, so the caller can tell \"applied just now\" from \"already\napplied \u2014 this is the cached result\" (mirrors `ApplyChangeEnvelope`'s\n`applied`/`idempotent_skip` status).", "properties": { "method": { "const": "Commit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "idempotency_key": { "type": [ "string", "null" ] }, "txn_id": { "type": "string" } }, "required": [ "txn_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "Rollback", "type": "string" }, "params": { "additionalProperties": false, "properties": { "txn_id": { "type": "string" } }, "required": [ "txn_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TsAppend", "type": "string" }, "params": { "additionalProperties": false, "properties": { "bucket_ns": { "description": "Bucket/time-partition width in nanoseconds (series-creation parameter).", "format": "uint64", "minimum": 0, "type": "integer" }, "field_names": { "default": [], "description": "Optional field names (series-creation metadata).", "items": { "type": "string" }, "type": "array" }, "n_fields": { "description": "Field count per point (1 for a scalar series, N for OHLCV\u2026). Used only\nwhen the series is NEW; an existing series' stored schema wins.", "format": "uint", "minimum": 0, "type": "integer" }, "points_msgpack": { "description": "MessagePack `Vec<(i64, Vec)>` \u2014 the batch of points (one round-trip).", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "series_id": { "type": "string" } }, "required": [ "series_id", "n_fields", "bucket_ns", "points_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TsRange", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from": { "description": "Inclusive lower / exclusive upper ts bound (ns).", "format": "int64", "type": "integer" }, "series_id": { "type": "string" }, "to": { "format": "int64", "type": "integer" } }, "required": [ "series_id", "from", "to" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TsAsofJoin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "left_ts_msgpack": { "description": "MessagePack `Vec` \u2014 the left event timestamps (ns).", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "series_id": { "description": "The \"right\" series each left event is joined to by nearest-prior ts.", "type": "string" }, "tolerance": { "default": 0, "description": "Optional tolerance (ns); a match older than this is dropped (`None` =\nunbounded). `-1` encodes `None` over the wire.", "format": "int64", "type": "integer" } }, "required": [ "series_id", "left_ts_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TsWindow", "type": "string" }, "params": { "additionalProperties": false, "properties": { "agg": { "description": "Aggregate function: one of first/last/min/max/mean/sum/count.", "type": "string" }, "from": { "format": "int64", "type": "integer" }, "series_id": { "type": "string" }, "to": { "format": "int64", "type": "integer" }, "width": { "description": "Window width (ns) for the bucketed aggregate.", "format": "int64", "type": "integer" } }, "required": [ "series_id", "from", "to", "width", "agg" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "TsGapFill", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from": { "format": "int64", "type": "integer" }, "series_id": { "type": "string" }, "step": { "description": "Grid step (ns) for the LOCF densification.", "format": "int64", "type": "integer" }, "to": { "format": "int64", "type": "integer" } }, "required": [ "series_id", "from", "to", "step" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Retention: drop every point of `series_id` strictly older than `cutoff` (ns).\nA whole-series-empty legal hold blocks this (`SeriesStore::evict_before`) --\nheld data survives a retention sweep, provably. Returns the number of WHOLE\nchunk buckets removed (`ResultPayload::Count`); a straddling bucket is\ntrimmed in place rather than counted as removed. This is the SECOND durable\nwrite in the `Ts*` family (alongside `TsAppend`) -- routed through the same\n`MutationBatch`-compiled path so retention is commit-before-ack durable, not\na best-effort background trim.", "properties": { "method": { "const": "TsEvict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cutoff": { "format": "int64", "type": "integer" }, "series_id": { "type": "string" } }, "required": [ "series_id", "cutoff" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Retention: drop `series_id` ENTIRELY -- every chunk plus its meta row -- in\none durable write. Same legal-hold boundary as `TsEvict`. Returns the number\nof chunks removed (`ResultPayload::Count`; `0` for an unknown or held\nseries). Unlike `TsEvict`, a subsequently re-appended series with the same\nid starts fresh (no stale count/span carried over).", "properties": { "method": { "const": "TsDeleteSeries", "type": "string" }, "params": { "additionalProperties": false, "properties": { "series_id": { "type": "string" } }, "required": [ "series_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Enumerate every series id under the CALLER's own tenant+graph scope (never\ncross-tenant/cross-graph -- mirrors every other `Ts*` method's `scoped_key`\nderivation). Returns the caller-facing series ids as `ResultPayload::raw`\n(`Vec`), decoded server-side from the store's internally-encoded\n`SeriesKey`s and filtered to this scope -- the encoded key itself never\ncrosses the wire. This is what makes `TsEvict`/`TsDeleteSeries` reachable\nfor a multi-series retention sweep: without an enumeration primitive a\ncaller has no way to discover which series exist to retain/evict at all.", "properties": { "method": { "const": "TsListSeries", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Open an upload cursor; server allocates a cursor id and an empty accumulator.\n`chunk_size` is the fixed split size the client will use (records it on the\nmanifest for range-read math later); 0 \u21d2 the engine default.", "properties": { "method": { "const": "BlobBegin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "chunk_size": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Push one chunk into an open upload cursor. Hashed + stored on arrival; only\nthe digest is appended to the cursor (bounded memory).", "properties": { "method": { "const": "BlobChunkPut", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "format": "uint64", "minimum": 0, "type": "integer" }, "data": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "cursor", "data" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Finalize an upload cursor \u2192 assemble + store the manifest content-addressed,\nreturn the blob digest. Drops the cursor.", "properties": { "method": { "const": "BlobCommit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cursor" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Open a fetch cursor for a stored blob digest; returns `(cursor, n_chunks)`.", "properties": { "method": { "const": "BlobFetchBegin", "type": "string" }, "params": { "additionalProperties": false, "properties": { "digest": { "type": "string" } }, "required": [ "digest" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Pull chunk `idx` of an open fetch cursor (one chunk per frame).", "properties": { "method": { "const": "BlobChunkGet", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "format": "uint64", "minimum": 0, "type": "integer" }, "idx": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "cursor", "idx" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Close a fetch cursor (client done streaming down). Idempotent.", "properties": { "method": { "const": "BlobFetchEnd", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cursor" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Increment a blob's refcount \u2014 a `:Media` node now references it. Returns the\nnew count. (The graph link itself, `:Media-[:HAS_BLOB]->:Blob`, is created by\nthe caller via the normal node/edge methods; this maintains the GC refcount.)", "properties": { "method": { "const": "BlobRef", "type": "string" }, "params": { "additionalProperties": false, "properties": { "digest": { "type": "string" } }, "required": [ "digest" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Decrement a blob's refcount \u2014 a `:Media` reference was removed. Returns the\nnew count; a blob at 0 is eligible for the next `BlobGc`.", "properties": { "method": { "const": "BlobUnref", "type": "string" }, "params": { "additionalProperties": false, "properties": { "digest": { "type": "string" } }, "required": [ "digest" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Run the refcount mark-and-sweep GC: reclaim every zero-ref blob's manifest +\nthe chunks no surviving blob still lists. Returns `(blobs, chunks)` reclaimed.", "properties": { "method": { "const": "BlobGc", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Fetch the value bytes at `(namespace, key)`; result is the bytes or null.", "properties": { "method": { "const": "KvGet", "type": "string" }, "params": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "namespace": { "type": "string" } }, "required": [ "namespace", "key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Store `value` at `(namespace, key)` (overwrite). Durable commit-before-ack.\n`value` is a MessagePack `bin` (serde_bytes) \u2014 opaque bytes, stored verbatim.", "properties": { "method": { "const": "KvPut", "type": "string" }, "params": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "namespace": { "type": "string" }, "value": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "namespace", "key", "value" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Delete `(namespace, key)`; returns whether the key existed.", "properties": { "method": { "const": "KvDelete", "type": "string" }, "params": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "namespace": { "type": "string" } }, "required": [ "namespace", "key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Ordered `(key, value)` pairs in `namespace` whose key starts with `prefix`\n(empty prefix \u21d2 the whole namespace). `limit == 0` \u21d2 no cap.", "properties": { "method": { "const": "KvScan", "type": "string" }, "params": { "additionalProperties": false, "properties": { "limit": { "format": "uint", "minimum": 0, "type": "integer" }, "namespace": { "type": "string" }, "prefix": { "type": "string" } }, "required": [ "namespace", "prefix", "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomic compare-and-swap: set `(namespace, key)` to `new` (`None` \u21d2 delete) iff\nthe current value equals `expected` (both absent \u21d2 the key must not exist).\nReturns whether the swap happened. `expected`/`new` are MessagePack `bin`.", "properties": { "method": { "const": "KvCas", "type": "string" }, "params": { "additionalProperties": false, "properties": { "expected": { "default": null, "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "key": { "type": "string" }, "namespace": { "type": "string" }, "new": { "default": null, "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "namespace", "key" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Typed SQL source batch. One native SQL-catalog MutationBatch commits the\nrows, provider cursor, exact source epoch, terminal result and dirty outbox\natomically. Its authority is process-local: clustered mode refuses it.", "properties": { "method": { "const": "SqlSourceBatch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "batch": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceBatchRequest" } }, "required": [ "batch" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Import every user table (+ its rows) from logical `.db` filename `path`\ninto the engine's user-table store (CONCEPT:EG-KG.query.eg-feature). A table that already exists\nis REPLACED (drop-then-recreate) so the import mirrors the file. Returns a `Json`\nreport `{\"source\":\"sqlite\", \"imported_tables\":[{\"table\",\"rows\"},\u2026]}`.", "properties": { "method": { "const": "ImportSqliteFile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "path": { "type": "string" } }, "required": [ "path" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Export user tables OUT to a fresh, valid `sqlite3` `.db` logical filename `path` that the\n`sqlite3` CLI can open (CONCEPT:EG-KG.query.full-protocol). `tables` empty \u21d2 every user table; else\nexactly the named tables (each must exist). Publication is private and atomic.\nReturns aggregate table counts without a host path.", "properties": { "method": { "const": "ExportSqliteFile", "type": "string" }, "params": { "additionalProperties": false, "properties": { "path": { "type": "string" }, "tables": { "default": [], "items": { "type": "string" }, "type": "array" } }, "required": [ "path" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Parse `turtle` OR `ntriples` (exactly one non-empty) and store the triples\ninto the request's graph (CONCEPT:EG-KG.ontology.kg-native-rdf-sparql). Returns a `Raw` `LoadReport`\n(`{triples, multivalue}`). Gated `rdf`; a build without it\ndrops the variant \u2192 the dispatch not-built catch-all.", "properties": { "method": { "const": "AddTriples", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ntriples": { "default": "", "description": "N-Triples document (empty \u21d2 use `turtle`).", "type": "string" }, "turtle": { "default": "", "description": "Turtle document (empty \u21d2 use `ntriples`).", "type": "string" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Serialize the request's graph back OUT to RDF as N-Triples (CONCEPT:EG-KG.ontology.kg-native-rdf-sparql).\nReturns a `Raw` `String` (the canonical, order-independent form) \u2014 the\ndatatype/lang-faithful inverse of `AddTriples`. Read-only.", "properties": { "method": { "const": "GetRdf", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Physically RETRACT triples from the request's graph (CONCEPT:EG-KG.query.named-graph-support) \u2014 the\ninverse of `AddTriples`. Parses `turtle` OR `ntriples` (exactly one non-empty)\nand surgically removes each triple (a literal triple drops the property cell; a\nresource triple removes the one matching typed edge). DURABLE (WAL-replayed by\nre-parsing + re-removing). This is the reusable retract op the ontology UNLOAD\npath + SPARQL `DELETE DATA` build on. Returns a `Raw` count. Gated `rdf`.", "properties": { "method": { "const": "RemoveTriples", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ntriples": { "default": "", "description": "N-Triples document (empty \u21d2 use `turtle`).", "type": "string" }, "turtle": { "default": "", "description": "Turtle document (empty \u21d2 use `ntriples`).", "type": "string" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "DROP the request's named graph (CONCEPT:EG-KG.query.named-graph-support): physically clear ALL of its RDF\ncontent \u2014 the property-graph nodes/edges AND the lossless multi-valued-literal\nquad-store rows for this graph. DURABLE (WAL-replayed as a clear). The SPARQL\n`DROP/CLEAR GRAPH` op + ontology lifecycle teardown route here. Returns a `Raw`\n`\"ok\"`. Gated `rdf`. (Distinct from `DeleteGraph`, which evicts the registry\nentry; this empties the graph's RDF while keeping the graph addressable.)", "properties": { "method": { "const": "DropNamedGraph", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Evaluate a SPARQL 1.1 SELECT over the request's graph (CONCEPT:EG-KG.ontology.concept-11).\nReturns a `Raw` [`SparqlResult`] (`{vars, rows}`; each row a cell list aligned\nto `vars`, an unbound cell is `nil`). Read-only. Gated `sparql`.\n\n`base_iri` + `type_convention` carry an OPTIONAL LPG\u2192RDF projection vocabulary\n(CONCEPT:EG-KG.ontology.lpg-rdf-projection-vocabulary). Both default to empty \u21d2 the IDENTITY projection (node-type\nand property keys emitted verbatim, no `rdf:type` synthesis), which preserves\nthe prior behavior for every existing caller. A caller (e.g. agent-utilities)\nthat sets `base_iri = \"http://agent-utilities.dev/ontology#\"` +\n`type_convention = \"camel\"` makes the engine project the LIVE property graph\ninto that vocabulary \u2014 ` rdf:type ` and\n` ` \u2014 so a by-class query (`?s a au:Agent`) resolves\nnatively. The engine itself hardcodes NO ontology URL; the vocabulary is the\ncaller's.", "properties": { "method": { "const": "Sparql", "type": "string" }, "params": { "additionalProperties": false, "properties": { "base_iri": { "default": "", "description": "Projection base namespace IRI. Empty \u21d2 identity projection.", "type": "string" }, "query": { "type": "string" }, "type_convention": { "default": "", "description": "`rdf:type` object naming: `\"camel\"` \u21d2 CamelCase the type local name under\n`base_iri`; empty / `\"raw\"` \u21d2 verbatim. Only meaningful with `base_iri`.", "type": "string" } }, "required": [ "query" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "OBDA / R2RML VIRTUAL GRAPH query (CONCEPT:EG-KG.query.r2rml-virtual-graph /\nCONCEPT:EG-KG.query.obda-query-rewrite) \u2014 Ontology-Based Data Access: run a SPARQL query\nagainst a set of foreign tabular sources exposed as RDF via an R2RML-style\nmapping, WITHOUT ever materializing the whole dataset. `tables` names the\nengine's OWN SQL user tables (the `eg_query::TableStore` behind `query`, the same\nstore `Method::Sql` DDL/DML and `ImportSqliteFile` write) to register as foreign\nsources under their own table name (a [`TriplesMap::logical_source`] target);\n`mapping` is either a standard R2RML Turtle document (`@prefix rr: \u2026`) or the\ncompact EG-101 textual form (`SOURCE`/`SUBJECT`/`CLASS`/`COLUMN`/`REF`/`CONST`\ndirectives) \u2014 auto-detected. The query rewrites to a projection-pushed scan of\nonly the query-relevant table columns (see `eg_rdf::obda`), materializes ONLY\nthose triples into a transient view, and evaluates the SAME SPARQL engine over\nit \u2014 so this is a REAL query-rewrite OBDA path, not a full ETL/materialize step.\nReturns a `Raw` [`SparqlResult`]. Read-only (never writes the user table OR the\nrequest's graph). Gated `obda` (implies `sparql` + `query`).", "properties": { "method": { "const": "SparqlVirtual", "type": "string" }, "params": { "additionalProperties": false, "properties": { "external_sources": { "default": [], "description": "LIVE external relational sources (Postgres/MySQL) registered as foreign OBDA\nsources IN ADDITION to `tables` (CONCEPT:EG-KG.query.obda-predicate-pushdown,\nW4.11). Each binds a `logical_source` name to an external DB table; the query's\ncolumn projection AND its row-level `FILTER`s are pushed into a real\n`SELECT \u2026 WHERE \u2026`. Needs a `federation-sql` server build for the live path.\nEmpty \u21d2 engine-own-tables-only (the prior behavior).", "items": { "$ref": "#/components/schemas/ResDef_Query_ObdaExternalSource" }, "type": "array" }, "mapping": { "description": "An R2RML Turtle document OR the compact EG-101 textual mapping form.", "type": "string" }, "query": { "description": "The SPARQL query to run against the virtual graph.", "type": "string" }, "tables": { "description": "The user-table names the mapping's `TriplesMap`s reference as\n`logical_source`s \u2014 each is registered as a foreign source under its own\nname before the mapping is parsed and the query is run.", "items": { "type": "string" }, "type": "array" } }, "required": [ "query", "mapping", "tables" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Run the native OWL 2 (EL\u207a + RL) reasoner over the request's graph and\nmaterialize entailments (CONCEPT:EG-KG.ontology.incremental-materialization). Classifies the OWL axioms already\nin the graph (the TBox loaded via `AddTriples`) plus any extra `ontology`\nTurtle, then returns a `Raw` [`OwlReasonResult`]: the derived named-class\nsubsumptions, the inferred instance\u2192class memberships (incl. ones reached only\nthrough existential restrictions / role chains), and a consistency verdict. The\n`Op::Reason` plan op reuses the SAME classifier as a RowSet source. Read-only\n(it does not mutate the graph). Gated `owl`.", "properties": { "method": { "const": "OwlReason", "type": "string" }, "params": { "additionalProperties": false, "properties": { "class_base": { "default": "", "description": "The absolute namespace a bare string node `type` (e.g. `\"Agent\"`) is\nbridged into before classification (`eg_rdf::owl::bridge_type_to_class`) \u2014\nindependent of `target_class`, which ONLY controls filtering (BUG-281: the\ntwo used to be conflated, so an empty `target_class` \u2014 its own documented\n\"all classes\" case \u2014 could never supply a namespace, and a caller wanting\n\"reason over everything\" always hit `OwlReason requires an absolute target\nclass`). Empty \u21d2 fall back to `target_class`'s own namespace when\n`target_class` is absolute (the pre-existing convenience for a caller that\nonly ever set one field); a class bridge for a bare string `type` is only\npossible once SOME absolute namespace is available from either field.", "type": "string" }, "min_confidence": { "description": "Confidence threshold \u03c4 in `[0,1]` (CONCEPT:EG-KG.ontology.concept-13). The result carries a\nper-entailment confidence (axioms/facts may be uncertain; the closure\npropagates it \u2014 `eg:confidence` annotations \u00d7 the per-node confidence \u00d7\nEbbinghaus decay). Only entailments with `confidence \u2265 min_confidence` are\nreturned. `0.0` keeps everything (and a HARD ontology yields all `1.0`).", "format": "double", "type": "number" }, "ontology": { "default": "", "description": "Extra OWL axioms as Turtle (empty \u21d2 reason over the graph's own axioms).", "type": "string" }, "target_class": { "default": "", "description": "When set, restrict the returned instance memberships to this class (its\ninferred members) \u2014 the materialize-one-class shape. Empty \u21d2 all classes.", "type": "string" } }, "required": [ "min_confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "DISTRIBUTED confidence-weighted OWL reasoning over the UNION of `graphs`\n(CONCEPT:EG-KG.ontology.concept-13): gathers each graph/shard's TBox axioms + decayed-confidence\ntype facts, runs ONE weighted EL\u207a/RL closure over the union (the cross-shard\nunion-read seam \u2014 KG-2.171), and returns the SAME [`OwlReasonResult`] a\nsingle-graph `OwlReason` would over the same axioms in one graph. The single-\nshard fast path stays `OwlReason`. Read-only. Gated `owl`.", "properties": { "method": { "const": "OwlReasonDistributed", "type": "string" }, "params": { "additionalProperties": false, "properties": { "class_base": { "default": "", "description": "See `OwlReason::class_base` (BUG-281) \u2014 independent of `target_class`.", "type": "string" }, "graphs": { "description": "The graphs (shards) whose axioms + facts to union and reason over.", "items": { "type": "string" }, "type": "array" }, "min_confidence": { "description": "Confidence threshold \u03c4 in `[0,1]` (see `OwlReason::min_confidence`).", "format": "double", "type": "number" }, "ontology": { "default": "", "description": "Extra OWL axioms as Turtle (a shared TBox over the sharded ABox; empty \u21d2\nonly the axioms already present across the graphs).", "type": "string" }, "target_class": { "default": "", "description": "Restrict instance memberships to this class (empty \u21d2 all classes).", "type": "string" } }, "required": [ "graphs", "min_confidence" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "OWL proof-tree EXPLANATION (CONCEPT:EG-KG.ontology.owl-proof-tree-explanation) \u2014 Stardog's flagship\n\"explanation\" feature, native here. Classifies the request's graph (its own TBox\naxioms, loaded via `AddTriples`, plus any extra `ontology` Turtle) with confidence\npropagation, then reconstructs the FULL recursive proof tree for the ONE named-class\nsubsumption `sub \u2291 sup` \u2014 WHICH axiom(s) + WHICH premise subsumption(s) derived it,\nrecursively down to the asserted/reflexive leaves \u2014 via\n[`crate`]-independent reconstruction of `eg_rdf::owl::Classification::explain`'s\njustification DAG (CONCEPT:EG-KG.ontology.justification-tracking). Returns a `Raw`\n[`OwlExplainResult`]. Read-only (does not mutate the graph). Gated `owl`.", "properties": { "method": { "const": "OwlExplain", "type": "string" }, "params": { "additionalProperties": false, "properties": { "ontology": { "default": "", "description": "Extra OWL axioms as Turtle (empty \u21d2 reason over the graph's own axioms).", "type": "string" }, "sub": { "description": "The SUBCLASS side of the subsumption to explain (a class IRI, `<...>` or bare \u2014\ncanonicalized the same way `target_class` is elsewhere).", "type": "string" }, "sup": { "description": "The SUPERCLASS side of the subsumption to explain.", "type": "string" } }, "required": [ "sub", "sup" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "RunRules", "type": "string" }, "params": { "additionalProperties": false, "properties": { "derived_only": { "default": false, "description": "When true, return only the DERIVED facts (omit the asserted base).", "type": "boolean" }, "min_confidence": { "default": 0.0, "description": "Drop facts whose confidence is below this threshold.", "format": "double", "type": "number" }, "ontology_ttl": { "default": "", "description": "Optional Turtle carrying extra TBox axioms AND/OR ABox facts (empty \u21d2 reason\nover the graph's own folded axioms/facts only).", "type": "string" }, "query_predicate": { "default": null, "description": "When set, restrict the returned facts to this predicate (IRI or bare name).", "type": [ "string", "null" ] }, "rules": { "default": [], "description": "User rule strings (SWRL-ish / Datalog syntax).", "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Validate `data_graph` against SHACL constraints (CONCEPT:EG-KG.ontology.concept-6).\nOmitted or empty `shapes` selects the request graph's composed\nGraphSchema shapes (immutable core plus its attached dynamic sources).\nA non-empty document remains an explicit, ad-hoc shapes graph.\nAn EMPTY `data_graph` validates against the LIVE RDF of the request's graph (the\nsame triples `GetRdf` would export). Returns a `Json` `sh:ValidationReport`.\nRead-only. Handler gated `shacl` (implies `rdf`).", "properties": { "method": { "const": "ShaclValidate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data_graph": { "default": "", "description": "The data graph as a Turtle document; empty \u21d2 use the request's live graph.", "type": "string" }, "shapes": { "default": null, "description": "An explicit shapes graph as Turtle. Omitted/empty uses the request\ngraph's composed GraphSchema authority.", "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "X5-enforce (CONCEPT:EG-KG.ontology.rdf-update-guard) \u2014 (re)register a graph's\nSHACL shapes as WRITE-TIME closed-world integrity constraints (ICV, reusing\n`eg-shacl`'s existing `IcvPolicyRegistry`/`WriteGuard` verbatim \u2014 no new\nvalidator). The required `mode` value is `\"enforce\"`: a violating change ABORTS the\n`AddTriples`/`RemoveTriples`/`ApplyMutation` commit with the introduced\nviolations, each carrying its SPARQL witness). `graph` names the target graph;\n`None` sets the DEFAULT-graph policy. `shapes` is the SHACL shapes Turtle\ndocument \u2014 e.g. the SHACL a connector-manifest compiler emits alongside its\nRLS/ABAC policy output (agent-utilities side) and must be non-empty. Like `ShaclValidate`,\nthis variant is UNCONDITIONAL in the enum; the HANDLER is gated `shacl` \u2014 a\nbuild without it drops the handler arm and the request falls through to the\ndispatch \"not available in this build\" catch-all.", "properties": { "method": { "const": "IcvConfigure", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": [ "string", "null" ] }, "mode": { "type": "string" }, "shapes": { "type": "string" } }, "required": [ "mode", "shapes" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Validate `data_graph` against a **ShExJ** `schema` for a `shape_map` (a list of\n`[node_iri, shape_label]` pairs; `\"START\"` selects the schema's start shape)\n(CONCEPT:EG-KG.compute.concept-2). `data_graph` is an RDF Turtle document; an EMPTY `data_graph`\nvalidates against the LIVE RDF of the request's graph (the same triples `GetRdf`\nwould export). Returns a `Json` `ShexReport`. Read-only. Handler gated `shex`\n(implies `rdf`).", "properties": { "method": { "const": "ShexValidate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "data_graph": { "default": "", "description": "The data graph as a Turtle document; empty \u21d2 use the request's live graph.", "type": "string" }, "schema": { "description": "The ShEx schema as a ShExJ (JSON abstract-syntax) document.", "type": "string" }, "shape_map": { "default": [], "description": "The shape map: `[node_iri, shape_label]` pairs. `shape_label` may be `\"START\"`.", "items": { "items": { "type": "string" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": "array" } }, "required": [ "schema" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read the ordered change feed for `graph` from cursor `from_seq` (inclusive),\nup to `limit` events (CONCEPT:EG-KG.query.streaming-cdc-subscriptions). Returns a `Raw`\n`CdcReadResult` (B-8, 2026-08-13: `{events, gap, watermark, head_seq, epoch}` \u2014\nwas a bare `Vec`, which made a genuinely-caught-up cursor\nindistinguishable from one that silently fell off the ring; see\n`CdcReadResult`'s doc). The consumer re-reads from `last.seq + 1` to skip what\nit has seen, and MUST check `gap` before treating an empty `events` as \"caught\nup\" \u2014 `gap: true` means it is not. `limit` 0 \u21d2 a default cap.", "properties": { "method": { "const": "CdcRead", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from_seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "limit": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_seq" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Register a continuous query (CONCEPT:EG-KG.query.streaming-cdc-subscriptions): a named, incrementally-\nmaintained aggregate/filter view over a graph's CDC feed. `spec_msgpack` is a\nMessagePack `ContinuousQuerySpec`. Returns a `String` (the name). Re-registering\nthe same name replaces it (and re-seeds from the current graph state).", "properties": { "method": { "const": "RegisterContinuousQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "spec_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "name", "spec_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Read the current incrementally-maintained result of a continuous query. Returns\na `Raw` `ContinuousQueryResult`.", "properties": { "method": { "const": "ReadContinuousQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Drop a continuous query. Returns `Bool` (true if it existed).", "properties": { "method": { "const": "DropContinuousQuery", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "LISTEN/NOTIFY-style long-poll subscription (CONCEPT:EG-KG.query.wire-codec): return the\nmatching CDC changes for `graph` since `from_seq`, blocking up to `timeout_ms`\nfor the FIRST one if none are pending yet (then returns what arrived). `label`\n(empty \u21d2 all) filters by node/edge label. Returns a `Raw` `WatchBatch`\n(`{events, next_seq, gap, watermark, head_seq, epoch}` \u2014 B-8, 2026-08-13: tails\nthe identical ephemeral ring `CdcRead` does, so it carries the same gap\nsignalling; see `CdcReadResult`'s doc); the client passes `next_seq` back to\nresume, and MUST check `gap` before treating an empty `events` as \"caught up\".\nTransport-compatible: one Request \u2192 one Response, cursor-driven.", "properties": { "method": { "const": "Watch", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from_seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "label": { "default": "", "type": "string" }, "timeout_ms": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_seq" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Register a trigger/reaction (CONCEPT:EG-KG.query.wire-codec): when a CDC change in `graph`\nmatches `label` (empty \u21d2 any) + `op` (\"add\"|\"remove\"|\"update\"|\"any\"), record a\nfiring carrying `action_msgpack` (an opaque reaction payload). Returns the name.", "properties": { "method": { "const": "RegisterTrigger", "type": "string" }, "params": { "additionalProperties": false, "properties": { "action_msgpack": { "default": [], "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "graph": { "type": "string" }, "label": { "default": "", "type": "string" }, "name": { "type": "string" }, "op": { "type": "string" } }, "required": [ "name", "graph", "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Drop a trigger. Returns `Bool`.", "properties": { "method": { "const": "DropTrigger", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "List the triggers registered on `graph`. Returns a `Raw` `Vec`.", "properties": { "method": { "const": "ListTriggers", "type": "string" }, "params": { "additionalProperties": false, "properties": { "graph": { "type": "string" } }, "required": [ "graph" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Poll the fired-trigger log for `graph` from cursor `from_seq` (CONCEPT:EG-KG.query.wire-codec):\nthe reactions that fired since the cursor. Returns a `Raw` `FiredTriggersResult`\n(B-8 follow-up, 2026-08-13: `{fired, gap, watermark, head_seq, epoch}` \u2014 the\nfired-trigger log is a second bounded ring with the identical ephemerality as\nthe CDC ring `CdcRead` reads; see `CdcReadResult`'s doc); the consumer\ndispatches each action then resumes from `last.fire_seq + 1`, and MUST check\n`gap` before treating an empty `fired` as \"caught up\".", "properties": { "method": { "const": "FiredTriggers", "type": "string" }, "params": { "additionalProperties": false, "properties": { "from_seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "limit": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "graph", "from_seq" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Register a live CEP standing query (CONCEPT:EG-KG.query.protocol-types). `pattern_msgpack` is a\nMessagePack `CepPatternSpec` (the same pattern algebra `Op::Cep` carries); `buffer`\n(0 \u21d2 a default) bounds how many unconsumed matches are retained for a lagging\npoller before the oldest are dropped. Returns a `Count` \u2014 the subscription id to\npass to `CepPoll` / `CepUnsubscribe`.", "properties": { "method": { "const": "CepSubscribe", "type": "string" }, "params": { "additionalProperties": false, "properties": { "buffer": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "pattern_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "pattern_msgpack" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Poll a CEP subscription for the matches pushed since the last poll\n(CONCEPT:EG-KG.query.protocol-types), blocking up to `timeout_ms` for the FIRST one if none are ready\n(then returns whatever arrived). Returns a `Raw` `Vec`; an empty\nvec means \"nothing yet\" (re-poll to keep tailing). A dropped subscription (unknown\n`sub_id`) is an error.", "properties": { "method": { "const": "CepPoll", "type": "string" }, "params": { "additionalProperties": false, "properties": { "sub_id": { "format": "uint64", "minimum": 0, "type": "integer" }, "timeout_ms": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sub_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Drop a CEP standing query + its subscriber (CONCEPT:EG-KG.query.protocol-types). Returns `Bool` (true\nif it existed).", "properties": { "method": { "const": "CepUnsubscribe", "type": "string" }, "params": { "additionalProperties": false, "properties": { "sub_id": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sub_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "MineAssociate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_MineAlgorithm", "default": "fpgrowth", "description": "Which frequent-itemset engine to run (all agree; FP-Growth default)." }, "as_claim": { "description": "ADDITIONALLY materialize a first-class epistemic object per rule (E6,\nCONCEPT:EG-KG.epistemic.epistemic-substrate): a `:Claim` (confidence seeded\nfrom the rule's quality score, normalized to `[0,1]`) plus a provenance\n`:Evidence` node, both `SUPPORTS`-linked to the claim so the `eg_epistemic`\nbelief layer can propagate confidence over the mined finding. Requires\n`writeback` (the `:AssociationRule` node is the claim's evidence anchor).\nGated `all(mining, epistemic)`; unset \u21d2 write-back is byte-identical.", "type": "boolean" }, "min_confidence": { "default": 0.5, "description": "Minimum rule confidence (0.0\u20131.0) to emit.", "format": "double", "type": "number" }, "min_support": { "default": 0.1, "description": "Minimum fractional support (0.0\u20131.0) an itemset must meet.", "format": "double", "type": "number" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_TransactionSource" }, { "type": "null" } ], "description": "Graph-derived transaction source (compute-near-data). Used when\n`transactions` is empty." }, "transactions": { "description": "Explicit transactions \u2014 each a set of item labels. Empty \u21d2 use `source`.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize each rule as a typed `:AssociationRule` node linked to its\nitem nodes (the discovery flywheel). Makes this a graph write.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Clustering (CONCEPT:EG-KG.mining.dbscan-density \u2014 completing the family beyond\nk-Means/spectral). Partitions a feature matrix into clusters via DBSCAN,\nhierarchical agglomerative, GMM (EM), or k-medoids (PAM). Rows come from\nEITHER explicit `features` OR a graph-derived `source` (the embeddings of a\nnode label \u2014 the cross-modal \"cluster the vectors of these nodes\" hook).\nReturns rows `{cluster_id, members, centroid, score}` (+ GMM\n`responsibilities`). With `writeback=true` it materializes each cluster as a\ntyped `:Cluster` node linked to its member nodes \u2014 a graph MUTATION, so it\nclassifies as a write and WAL-replays by re-clustering deterministically.\nGated `mining`; a build without it drops the variant.", "properties": { "method": { "const": "MineCluster", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_ClusterAlgorithm", "default": "dbscan", "description": "Which clustering engine to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per cluster (E6) \u2014\nsee [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\ncluster's compactness score. Requires `writeback`.", "type": "boolean" }, "eps": { "default": 0.5, "description": "DBSCAN neighborhood radius.", "format": "double", "type": "number" }, "features": { "default": [], "description": "Explicit feature matrix \u2014 each row a point. Empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "k": { "default": 3, "description": "Target cluster count for hierarchical / GMM / k-medoids.", "format": "uint", "minimum": 0, "type": "integer" }, "linkage": { "$ref": "#/components/schemas/ResDef_Query_Linkage", "default": "average", "description": "Hierarchical linkage: `single` \u00b7 `complete` \u00b7 `average` (default)." }, "max_iter": { "default": 100, "description": "EM / PAM iteration cap (GMM, k-medoids).", "format": "uint", "minimum": 0, "type": "integer" }, "min_pts": { "default": 5, "description": "DBSCAN minimum points (incl. self) for a core point.", "format": "uint", "minimum": 0, "type": "integer" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source): an\nupstream cross-modal RETRIEVAL plan (`Op::Scan|Filter|Traverse|Rank|\u2026`),\nexecuted FIRST over the resident graph/vector/SQL/time modalities; the\nresulting RowSet ids are then resolved to their stored embeddings (the\nSAME lookup `VectorSource` uses) to build this op's feature rows \u2014 so\n`retrieve \u2192 cluster \u2192 writeback` is ONE plan, ONE round-trip\n(compute-near-data, no client marshalling between retrieve and mine).\nTakes precedence over `source` when present; ignored when `features`\nis non-empty. Gated additionally on `query` (the plan algebra lives\nbehind that feature) \u2014 a `mining`-only build without `query` drops\nthis field." }, "seed": { "default": 0, "description": "Seed for GMM's k-means++ init (deterministic).", "format": "uint64", "minimum": 0, "type": "integer" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `features` is empty." }, "writeback": { "default": false, "description": "Materialize each cluster as a typed `:Cluster` node linked to members.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Anomaly / outlier detection (CONCEPT:EG-KG.mining.isolation-forest). Scores\nevery feature row for how anomalous it is via z-score/MAD, Isolation Forest,\nLOF, or One-Class SVM, and flags rows over `threshold` (per-algorithm default\nwhen unset). Rows come from EITHER explicit `features`, a 1-D `values` series\n(each value \u2192 one row \u2014 the tsdb RCA hook), OR a graph-derived `source` (node\nembeddings). Returns rows `{id, anomaly_score, is_anomaly}`. With\n`writeback=true` it materializes each flagged row as a typed `:Anomaly` node\nlinked to its source node \u2014 a graph MUTATION (write, WAL-replayed\ndeterministically). Gated `mining`.", "properties": { "method": { "const": "MineAnomaly", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_AnomalyAlgorithm", "default": "zscore", "description": "Which detector to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per flagged anomaly\n(E6) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from\nthe row's anomaly score. Requires `writeback`.", "type": "boolean" }, "features": { "default": [], "description": "Explicit feature matrix \u2014 each row a point. Empty \u21d2 use `values`/`source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "gamma": { "default": 0.0, "description": "One-Class SVM RBF gamma; `\u2264 0` \u21d2 the `1/n_features` default.", "format": "double", "type": "number" }, "k": { "default": 20, "description": "LOF neighbor count.", "format": "uint", "minimum": 0, "type": "integer" }, "kernel": { "$ref": "#/components/schemas/ResDef_Query_SvmKernel", "default": "rbf", "description": "One-Class SVM kernel: `rbf` (default) \u00b7 `linear`." }, "n_trees": { "default": 100, "description": "Isolation Forest tree count.", "format": "uint", "minimum": 0, "type": "integer" }, "nu": { "default": 0.1, "description": "One-Class SVM \u03bd \u2208 (0,1] (upper bound on the outlier fraction).", "format": "double", "type": "number" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source) \u2014 see\n`MineCluster::plan`. Takes precedence over `source`; ignored when\n`features`/`values` is non-empty." }, "sample_size": { "default": 256, "description": "Isolation Forest subsample size.", "format": "uint", "minimum": 0, "type": "integer" }, "seed": { "default": 0, "description": "Seed for Isolation Forest (deterministic).", "format": "uint64", "minimum": 0, "type": "integer" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `features` and\n`values` are both empty." }, "threshold": { "default": null, "description": "Flag threshold (higher score = more anomalous). Unset \u21d2 per-algorithm default.", "format": "double", "type": [ "number", "null" ] }, "values": { "default": [], "description": "1-D series convenience \u2014 each scalar becomes a one-element row (e.g. a\ntsdb window for root-cause analysis). Used when `features` is empty.", "items": { "format": "double", "type": "number" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize each flagged row as a typed `:Anomaly` node linked to its source.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Classification \u2014 FIT (CONCEPT:EG-KG.mining.naive-bayes). PREDICTIVE: fit a\nclassifier over labeled feature rows and return a serializable model blob\n(`FittedClassifier`), mirroring `DsFitEstimator`. Completes the classifier\nfamily beyond the datascience tree/forest/boosting estimators with Naive Bayes\n(Gaussian/Multinomial), k-NN, one-vs-rest logistic regression, and linear SVC.\nRows come from EITHER explicit `x` OR a graph-derived `source` (node embeddings\nwith OWL/ontology feature vectors \u2014 \"classify nodes using their embeddings\").\nRead-only (no graph mutation). Gated `mining`.", "properties": { "method": { "const": "MineClassifyFit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_ClassifyAlgorithm", "default": "gaussiannb", "description": "Which classifier to fit." }, "alpha": { "default": 1.0, "description": "Multinomial NB Laplace smoothing.", "format": "double", "type": "number" }, "c": { "default": 1.0, "description": "Linear-SVC inverse-regularization C.", "format": "double", "type": "number" }, "epochs": { "default": 300, "description": "Logistic / SVC gradient-descent epochs.", "format": "uint", "minimum": 0, "type": "integer" }, "k": { "default": 5, "description": "k-NN neighbor count.", "format": "uint", "minimum": 0, "type": "integer" }, "l2": { "default": 0.0, "description": "Logistic L2 regularization strength.", "format": "double", "type": "number" }, "lr": { "default": 0.1, "description": "Logistic / SVC learning rate.", "format": "double", "type": "number" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source) \u2014 see\n`MineCluster::plan`. Takes precedence over `source`; ignored when `x`\nis non-empty. NOTE: `y` labels must still align by position with the\nplan's resulting row order." }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `x` is empty." }, "x": { "default": [], "description": "Explicit feature matrix \u2014 each row a sample. Empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "default": [], "description": "Integer class labels, one per row (required).", "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Classification \u2014 PREDICT (CONCEPT:EG-KG.mining.naive-bayes). Takes a fitted\n`model` blob back plus a feature matrix and returns per-row `{labels, proba}`,\nmirroring `DsPredictEstimator`. Rows come from EITHER explicit `x` OR a\ngraph-derived `source` (node embeddings). With `writeback=true` it materializes\neach prediction as a typed `:Classification` node linked to its source node \u2014 a\ngraph MUTATION (write, WAL-replayed deterministically). Gated `mining`.", "properties": { "method": { "const": "MineClassifyPredict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per prediction (D3,\nmirroring E6) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence is\nseeded from the prediction's OWN max class probability (`out.proba[i]`'s\nargmax), already `[0,1]` by construction (a probability simplex row).\nRequires `writeback`.", "type": "boolean" }, "model": { "$ref": "#/components/schemas/ResDef_Query_FittedClassifier", "description": "The fitted model blob from `MineClassifyFit`." }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source) \u2014 see\n`MineCluster::plan`. Takes precedence over `source`; ignored when `x`\nis non-empty." }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `x` is empty." }, "writeback": { "default": false, "description": "Materialize each prediction as a typed `:Classification` node linked to its\nsource node.", "type": "boolean" }, "x": { "default": [], "description": "Explicit feature matrix \u2014 each row a sample. Empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "model" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Dimensionality reduction (CONCEPT:EG-KG.mining.truncated-svd). DESCRIPTIVE:\ntransform a feature matrix into low-D `coords` via truncated SVD, LDA\n(supervised \u2014 needs `labels`), UMAP, or t-SNE. Rows come from EITHER explicit\n`x` OR a graph-derived `source` (node embeddings \u2014 \"reduce these node vectors\nfor the graphviz\"). Returns rows `{id, coords}`. With `writeback=true` it\nmaterializes each row's reduced vector as a typed `:Embedding2D` node linked to\nits source node \u2014 a graph MUTATION (write, WAL-replayed deterministically).\nGated `mining`.", "properties": { "method": { "const": "MineReduce", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_ReduceAlgorithm", "default": "svd", "description": "Which reduction engine to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) \u2014 D3, mirroring E6 \u2014 but\nONLY for `svd` (`ReduceAlgorithm::Svd`), the one engine with a principled\n`[0,1]` quality score: the retained EXPLAINED-VARIANCE RATIO\n(`\u03a3 retained singular_values\u00b2 / \u03a3 ALL row sum-of-squares`, i.e. how much of\nthe rows' total variance the kept components capture). `lda`/`umap`/`tsne`\nhave no such score (LDA's discriminant eigenvalues aren't returned;\nUMAP/t-SNE are approximate neighborhood LAYOUTS with no reconstruction-error\nanalogue) \u2014 for those, `as_claim=true` is a documented no-op (no claim is\nwritten; see [`Method::MineAssociate::as_claim`] for the general shape).\nRequires `writeback`.", "type": "boolean" }, "epochs": { "default": 300, "description": "UMAP / t-SNE optimization epochs.", "format": "uint", "minimum": 0, "type": "integer" }, "labels": { "default": [], "description": "Class labels, one per row \u2014 REQUIRED for LDA (ignored otherwise).", "items": { "format": "int64", "type": "integer" }, "type": "array" }, "lr": { "default": 100.0, "description": "t-SNE learning rate.", "format": "double", "type": "number" }, "min_dist": { "default": 0.1, "description": "UMAP minimum embedded distance.", "format": "double", "type": "number" }, "n_components": { "default": 2, "description": "Target dimensionality of the embedding.", "format": "uint", "minimum": 0, "type": "integer" }, "n_neighbors": { "default": 15, "description": "UMAP neighbor count.", "format": "uint", "minimum": 0, "type": "integer" }, "perplexity": { "default": 30.0, "description": "t-SNE perplexity.", "format": "double", "type": "number" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Plan" }, { "type": "null" } ], "default": null, "description": "Fused retrieve\u2192mine plan (CONCEPT:EG-KG.mining.fused-plan-source) \u2014 see\n`MineCluster::plan`. Takes precedence over `source`; ignored when `x`\nis non-empty." }, "seed": { "default": 0, "description": "Seed for UMAP / t-SNE (deterministic layout).", "format": "uint64", "minimum": 0, "type": "integer" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings). Used when `x` is empty." }, "writeback": { "default": false, "description": "Materialize each row's reduced vector as a typed `:Embedding2D` node.", "type": "boolean" }, "x": { "default": [], "description": "Explicit feature matrix \u2014 each row a point. Empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GraphLearnFit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "params": { "$ref": "#/components/schemas/ResDef_Query_GraphLearnParams", "default": { "alpha": 0.5, "basis": "chebyshev", "degree": 4, "epochs": 200, "hidden": 0, "lr": 0.05, "neg_ratio": 1.0, "seed": 42 }, "description": "Training + architecture knobs (all defaulted)." }, "source": { "$ref": "#/components/schemas/ResDef_Query_GraphSource", "description": "The graph-derived subgraph to learn over (node label + relation/direction)." }, "writeback": { "default": false, "description": "Materialize the learned per-feature `:EdgeFunction` nodes (a graph write).", "type": "boolean" } }, "required": [ "source" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "GraphLearnPredict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "candidate_pairs": { "default": [], "description": "Explicit candidate pairs `(src, dst)` to score. Empty \u21d2 score the top-k\nhighest-probability MISSING links across the subgraph.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "model": { "description": "A fitted `KanLinkModel` blob (as returned by `GraphLearnFit`)." }, "source": { "$ref": "#/components/schemas/ResDef_Query_GraphSource", "description": "The subgraph providing the structural features (usually the same source)." }, "top_k": { "default": 50, "description": "Cap on returned predictions (0 \u21d2 uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "writeback": { "default": false, "description": "Materialize each scored pair as a typed `:PredictedEdge` node (a graph write).", "type": "boolean" } }, "required": [ "model", "source" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelineTrain", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "Pipeline name \u2014 versioned `:Model` artifacts are keyed by it (`v1`, `v2`\u2026).", "type": "string" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_GraphSource" }, { "type": "null" } ], "default": null, "description": "The graph-derived node source the feature steps read. Empty \u21d2 `x` explicit." }, "spec": { "$ref": "#/components/schemas/ResDef_Query_PipelineSpec", "description": "The composable pipeline recipe (features \u2192 split \u2192 model)." }, "writeback": { "default": true, "description": "Persist the fitted model as a versioned `:Model` node (a graph write).\n`false` \u21d2 dry-run: fit + report metrics without materializing an artifact.", "type": "boolean" }, "x": { "default": [], "description": "Explicit feature matrix \u2014 each row a sample. Empty \u21d2 built from `source`\nvia the spec's feature steps.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "default": [], "description": "Explicit integer labels aligned to the rows / source node order. Empty \u21d2\nread from each node's `spec.label_property` (node classification).", "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "required": [ "name", "spec" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelineEvaluate", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "The pipeline whose stored model to score.", "type": "string" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_GraphSource" }, { "type": "null" } ], "default": null, "description": "Node source to build the evaluation features from (via the model's stored\nfeature recipe). Empty \u21d2 use explicit `x`." }, "version": { "default": 0, "description": "Model version to evaluate; `0` \u21d2 the currently-served version.", "format": "uint64", "minimum": 0, "type": "integer" }, "x": { "default": [], "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "y": { "default": [], "description": "Ground-truth integer labels; empty \u21d2 read the model's `label_property`.", "items": { "format": "int64", "type": "integer" }, "type": "array" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelineServe", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "The pipeline whose version to deploy.", "type": "string" }, "version": { "description": "The `:Model` version to mark served (predict-by-name then resolves it).", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "name", "version" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelinePredict", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "The pipeline to predict with.", "type": "string" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_GraphSource" }, { "type": "null" } ], "default": null, "description": "Node source to predict over (rebuilds features via the model's recipe).\nEmpty \u21d2 use explicit `x`." }, "version": { "default": 0, "description": "Model version; `0` \u21d2 the currently-served version.", "format": "uint64", "minimum": 0, "type": "integer" }, "writeback": { "default": false, "description": "Materialize each prediction as a typed `:Prediction` node linked to its\nsource node (a graph write).", "type": "boolean" }, "x": { "default": [], "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" } }, "required": [ "name" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "properties": { "method": { "const": "MiningPipelineCompare", "type": "string" }, "params": { "additionalProperties": false, "properties": { "name": { "description": "The pipeline whose two versions to compare.", "type": "string" }, "version_a": { "description": "The two `:Model` versions to diff (held-out metrics).", "format": "uint64", "minimum": 0, "type": "integer" }, "version_b": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "name", "version_a", "version_b" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Sequential-pattern mining (CONCEPT:EG-KG.mining.prefixspan \u2014 Phase 4).\nFinds frequent ORDERED subsequences (PrefixSpan or GSP; both agree) over\nEITHER explicit `sequences` (each a time-ordered list of item labels \u2014 an\nitem may repeat) OR a graph-derived `source` that turns each node's\nordered neighbor list (following resident edge insertion order) into one\nsequence \u2014 the \"what reliably follows what\" hook (evolution/commit\ntimelines, event streams). Returns rows `{items, support, count}`. With\n`writeback=true` it materializes each pattern as a typed\n`:SequentialPattern` node linked to any item that is a resident node \u2014 a\ngraph MUTATION, WAL-replayed by re-mining deterministically. Gated\n`mining`.", "properties": { "method": { "const": "MineSequence", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_MineSeqAlgorithm", "default": "prefixspan", "description": "Which sequential-pattern engine to run (both agree; PrefixSpan default)." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per pattern (E6) \u2014\nsee [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\npattern's support. Requires `writeback`.", "type": "boolean" }, "min_support": { "default": 0.1, "description": "Minimum fractional support (0.0\u20131.0) a pattern must meet.", "format": "double", "type": "number" }, "sequences": { "default": [], "description": "Explicit ordered sequences \u2014 each a time-ordered list of item labels.\nEmpty \u21d2 use `source`.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SequenceSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived sequence source (compute-near-data). Used when\n`sequences` is empty." }, "writeback": { "default": false, "description": "Materialize each pattern as a typed `:SequentialPattern` node linked to\nits resident item nodes.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Classical time-series forecasting (CONCEPT:EG-KG.mining.arima \u2014 Phase 4).\nForecasts `horizon` future points (with an approximate confidence band)\nfrom a 1-D `values` series \u2014 a tsdb window handed in by the caller,\nmirroring `MineAnomaly`'s client-supplied `values` cut (the native\nin-handler TsScan source is the same documented follow-up). `algorithm`\nselects ARIMA(p,d,q) (Hannan-Rissanen), additive Holt-Winters/ETS\n(degrades to Holt linear-trend when `period` is 0), or a classical STL-\nstyle decomposition + trend/seasonal extrapolation. With\n`writeback=true` it materializes the forecast as a typed `:Forecast`\nnode \u2014 linked to a resident node named `series_id` when one exists \u2014 a\ngraph MUTATION, WAL-replayed by re-forecasting deterministically. Gated\n`mining`.", "properties": { "method": { "const": "MineForecast", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_ForecastAlgorithm", "default": "arima", "description": "Which forecasting engine to run." }, "alpha": { "default": 0.3, "description": "Holt-Winters level smoothing.", "format": "double", "type": "number" }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the forecast (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\nforecast's `confidence` band level. Requires `writeback`.", "type": "boolean" }, "beta": { "default": 0.1, "description": "Holt-Winters trend smoothing.", "format": "double", "type": "number" }, "confidence": { "default": 0.95, "description": "Two-sided confidence level for the forecast band (e.g. `0.95`).", "format": "double", "type": "number" }, "d": { "default": 1, "description": "ARIMA differencing order.", "format": "uint", "minimum": 0, "type": "integer" }, "gamma": { "default": 0.1, "description": "Holt-Winters seasonal smoothing.", "format": "double", "type": "number" }, "horizon": { "default": 10, "description": "Steps to forecast beyond the series.", "format": "uint", "minimum": 0, "type": "integer" }, "p": { "default": 1, "description": "ARIMA autoregressive order.", "format": "uint", "minimum": 0, "type": "integer" }, "period": { "default": 0, "description": "Seasonal period for Holt-Winters / STL (`0` \u21d2 non-seasonal Holt\nlinear-trend fallback for Holt-Winters; trend-only for STL).", "format": "uint", "minimum": 0, "type": "integer" }, "q": { "default": 0, "description": "ARIMA moving-average order.", "format": "uint", "minimum": 0, "type": "integer" }, "series_id": { "default": "", "description": "Optional identity for the write-back `:Forecast` node; when it names\na resident node, the forecast is linked `FORECAST_OF` \u2192 that node.\nEmpty \u21d2 the node id is derived from the input `values` + `algorithm`.", "type": "string" }, "values": { "default": [], "description": "The 1-D series to forecast (required \u2014 a tsdb window handed in by\nthe caller).", "items": { "format": "double", "type": "number" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize the forecast as a typed `:Forecast` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Text mining (CONCEPT:EG-KG.mining.tfidf \u2014 Phase 4). `tfidf` returns each\ndocument's term weights (descriptive, read-only); `lda`/`nmf` fit a\n`k`-topic model over the corpus. Documents come from EITHER explicit\n`docs` (each a pre-tokenized `Vec` \u2014 use `tokenize`-equivalent\nclient-side, or pass raw words) OR a graph-derived `source` that\ntokenizes a text property off a node label (compute-near-data \u2014 no\nTantivy/eg-text dependency). With `writeback=true` (`lda`/`nmf` only)\neach topic is materialized as a typed `:Topic` node, linked to any\nsource document that is a resident node \u2014 a graph MUTATION,\nWAL-replayed by re-mining deterministically. Gated `mining`.", "properties": { "method": { "const": "MineText", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_TextAlgorithm", "default": "tfidf", "description": "Which text-mining engine to run." }, "alpha": { "default": 0.1, "description": "LDA symmetric doc-topic Dirichlet prior.", "format": "double", "type": "number" }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per topic (D3, mirroring\nE6) \u2014 `lda`/`nmf` only, a no-op for `tfidf` (which has no topics, mirroring\n`writeback`). Quality = the topic's mean doc-membership strength among the\ndocuments DOMINANTLY assigned to it (`mean(doc_topics[d][t])` over docs `d`\nwhose argmax topic is `t`) \u2014 a topic-coherence proxy: both LDA's Dirichlet\nposterior and NMF's row-normalized `W` are already `[0,1]` distributions that\nsum to 1 across topics (see `eg_compute::mining::text` module docs), so this\nis a principled, already-bounded score requiring no extra normalization.\nRequires `writeback`.", "type": "boolean" }, "beta": { "default": 0.01, "description": "LDA symmetric topic-term Dirichlet prior.", "format": "double", "type": "number" }, "docs": { "default": [], "description": "Explicit pre-tokenized documents. Empty \u21d2 use `source`.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "iterations": { "default": 200, "description": "Gibbs sweeps (`lda`) / multiplicative-update iterations (`nmf`).", "format": "uint", "minimum": 0, "type": "integer" }, "k": { "default": 3, "description": "Topic count for `lda`/`nmf`.", "format": "uint", "minimum": 0, "type": "integer" }, "seed": { "default": 0, "description": "Seed for LDA's Gibbs sampler / NMF's initial factors (deterministic).", "format": "uint64", "minimum": 0, "type": "integer" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_TextSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived text source (compute-near-data). Used when `docs` is\nempty." }, "top_n": { "default": 10, "description": "How many terms to keep per document/topic row.", "format": "uint", "minimum": 0, "type": "integer" }, "writeback": { "default": false, "description": "Materialize each topic as a typed `:Topic` node (`lda`/`nmf` only \u2014\na no-op for `tfidf`, which has no topics to write back).", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Frequent subgraph mining + motif counting (CONCEPT:EG-KG.mining.gspan-frequent-subgraph\n\u2014 Phase 4, the graph-native differentiator). UNLIKE every other mining\nop in this family, this one mines the RESIDENT GRAPH's own topology\ndirectly \u2014 no rows/vectors handed in. `gspan` finds frequent connected\nsubgraph PATTERNS (level-wise growth up to `max_edges` edges,\ncanonicalized + exactly re-counted); `motif` censuses small\nlabel-agnostic topological motifs (wedges, triangles, directed\n3-cycles). `label`, when given, restricts the scanned host graph to\nnodes of that one type (both edge endpoints must match) \u2014 `None` scans\nthe whole resident graph heterogeneously. With `writeback=true`\n(`gspan` only) each frequent pattern is materialized as a typed\n`:FrequentSubgraph` node, linked to every host node appearing in any of\nits embeddings \u2014 a graph MUTATION, WAL-replayed by re-mining\ndeterministically. Gated `mining`.", "properties": { "method": { "const": "MineSubgraph", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_SubgraphAlgorithm", "default": "gspan", "description": "Which algorithm to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per frequent pattern\n(E6, `gspan` only) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence\nis seeded from the pattern's support. Requires `writeback`.", "type": "boolean" }, "label": { "default": null, "description": "Optional: restrict the host graph to nodes of this one type.\n`None` \u21d2 the whole resident graph (heterogeneous).", "type": [ "string", "null" ] }, "max_edges": { "default": 3, "description": "Pattern-size growth cap (tractability). Ignored by `motif`.", "format": "uint", "minimum": 0, "type": "integer" }, "min_support": { "default": 0.1, "description": "Minimum fractional support (0.0\u20131.0, of the host's total edge\ncount) a pattern's embedding count must meet. Ignored by `motif`.", "format": "double", "type": "number" }, "writeback": { "default": false, "description": "Materialize each frequent pattern as a typed `:FrequentSubgraph`\nnode (`gspan` only \u2014 a no-op for `motif`, which has no patterns).", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Entity resolution + record linkage (CONCEPT:EG-KG.mining.entity-resolution).\nDISTINCT from the existing always-on `ResolveCandidates` op (all-pairs\ncosine + union-find dedup-ladder proposals, no epistemic writeback): this\nmining family instead supports BOTH Jaccard record linkage over token\nattributes (`records`, blocked by an explicit `block_keys`) AND cosine\nentity resolution over embeddings (`vectors`/`source`, blocked by a grid\nbucket), and materializes each match as a typed `:EntityMatch` node \u2014 a\ngraph MUTATION, WAL-replayed by re-resolving deterministically. Gated `mining`.", "properties": { "method": { "const": "MineEntityResolve", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per match (E6) \u2014\nsee [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\nmatch's OWN similarity. Requires `writeback`.", "type": "boolean" }, "block_keys": { "default": [], "description": "Blocking key per record, same length as `records`. All-empty-string\n(or shorter than `records`) \u21d2 one global block (no blocking).", "items": { "type": "string" }, "type": "array" }, "bucket_precision": { "default": 1, "description": "Grid-bucket rounding precision for the `vectors`/`source` blocking path.", "format": "int32", "type": "integer" }, "ids": { "default": [], "description": "Optional external ids parallel to `records`/`vectors` (the explicit\npaths only \u2014 `source` supplies its own resident node ids). Shorter\nthan the input \u21d2 missing entries fall back to their index.", "items": { "type": "string" }, "type": "array" }, "records": { "default": [], "description": "Token-attribute records (Jaccard record linkage). Empty \u21d2 use\n`vectors`/`source`.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_VectorSource" }, { "type": "null" } ], "default": null, "description": "Graph-derived vector source (node embeddings) \u2014 used when `records`\nand `vectors` are both empty." }, "threshold": { "default": 0.5, "description": "Minimum similarity (Jaccard or Cosine, `[0,1]`) to emit a match.", "format": "double", "type": "number" }, "vectors": { "default": [], "description": "Explicit embedding rows (cosine entity resolution). Used when\n`records` is empty; empty \u21d2 use `source`.", "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize each match as a typed `:EntityMatch` node linked to both\nmembers (when they are resident node ids).", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Causal impact estimation (CONCEPT:EG-KG.mining.causal-impact): interrupted\ntime series (a single `series`) or difference-in-differences (`series` +\nnon-empty `control`), split at `intervention_index`. Mirrors\n`MineForecast`'s \"caller hands in the tsdb window\" convention \u2014 no direct\ntsdb coupling. With `writeback=true` materializes a typed `:CausalEffect`\nnode \u2014 a graph MUTATION, WAL-replayed by re-estimating deterministically.\nGated `mining`.", "properties": { "method": { "const": "MineCausalImpact", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the estimate\n(E6) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded\nfrom the estimate's own significance (`1 - two_sided_p`). Requires\n`writeback`.", "type": "boolean" }, "control": { "default": [], "description": "The control series for difference-in-differences. Empty \u21d2 plain\ninterrupted-time-series (no control).", "items": { "format": "double", "type": "number" }, "type": "array" }, "intervention_index": { "default": 0, "description": "Index of the FIRST post-intervention observation (in BOTH series for DiD).", "format": "uint", "minimum": 0, "type": "integer" }, "series": { "default": [], "description": "The (treatment, for DiD) series to analyze \u2014 required.", "items": { "format": "double", "type": "number" }, "type": "array" }, "series_id": { "default": "", "description": "Optional identity for the write-back `:CausalEffect` node. Empty \u21d2\nderived from the input series + algorithm.", "type": "string" }, "writeback": { "default": false, "description": "Materialize the estimate as a typed `:CausalEffect` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Process mining (CONCEPT:EG-KG.mining.process-mining): directly-follows\ngraph + alpha-miner-lite footprint (causal / parallel / choice relations,\nstart/end activity sets) over ordered event `traces`. With\n`writeback=true` materializes the footprint as a typed `:ProcessModel`\nnode \u2014 a graph MUTATION, WAL-replayed by re-mining deterministically.\nGated `mining`.", "properties": { "method": { "const": "MineProcess", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the model (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from\nthe fraction of observed activity pairs classified `causal`/`parallel`\n(vs. `choice`) \u2014 a log-coverage proxy, already `[0,1]`. Requires `writeback`.", "type": "boolean" }, "process_id": { "default": "", "description": "Optional identity for the write-back `:ProcessModel` node. Empty \u21d2\nderived from the mined footprint's own shape.", "type": "string" }, "traces": { "default": [], "description": "Ordered activity-label traces \u2014 each a time-ordered event sequence\n(an activity may repeat within a trace). Required.", "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize the footprint as a typed `:ProcessModel` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Root-cause propagation (CONCEPT:EG-KG.mining.root-cause): given a directed\nweighted dependency graph (`edges`, `cause -> effect`) and a per-node\nanomaly `scores` vector (the existing `anomaly` family's own output, or\nany other score), find the most-likely upstream root cause of one\n`symptom` node. With `writeback=true` materializes the top candidate as a\ntyped `:RootCause` node linked to the symptom \u2014 a graph MUTATION,\nWAL-replayed by re-searching deterministically. Gated `mining`.", "properties": { "method": { "const": "MineRootCause", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the top\ncandidate (E6) \u2014 see [`Method::MineAssociate::as_claim`]. Confidence\nmirrors `anomaly`'s `score / (1 + score)` mapping over the candidate's\nOWN raw responsibility score (normalizing against the candidate list\nwould be trivially `1.0` for the top candidate). Requires `writeback`.", "type": "boolean" }, "decay": { "default": 0.85, "description": "Per-hop score decay `(0,1]` (mirrors PageRank's damping factor).", "format": "double", "type": "number" }, "edges": { "default": [], "description": "Dependency edges `(cause_id, effect_id, weight)`; `weight` clamped to `[0,1]`.", "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" }, "max_hops": { "default": 5, "description": "Search depth cap.", "format": "uint", "minimum": 0, "type": "integer" }, "nodes": { "default": [], "description": "Node ids, index-aligned with `scores` and referenced by `edges`.", "items": { "type": "string" }, "type": "array" }, "scores": { "default": [], "description": "Anomaly score per node, index-aligned with `nodes` (negative clamps to `0.0`).", "items": { "format": "double", "type": "number" }, "type": "array" }, "symptom": { "default": "", "description": "The already-flagged anomalous node whose root cause to find (required).", "type": "string" }, "writeback": { "default": false, "description": "Materialize the top candidate as a typed `:RootCause` node linked to the symptom.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Seeded risk propagation (CONCEPT:EG-KG.mining.risk-propagation): personalized\nPageRank over a directed weighted graph (`edges`), restarting to a `seed`\nrisk distribution instead of teleporting uniformly. With `writeback=true`\nmaterializes each node's propagated score as a typed `:RiskScore` node \u2014 a\ngraph MUTATION, WAL-replayed by re-propagating deterministically. Gated `mining`.", "properties": { "method": { "const": "MineRiskPropagation", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per scored node (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from the\nnode's own propagated share (already `[0,1]`, mass-conserving). Requires `writeback`.", "type": "boolean" }, "damping": { "default": 0.85, "description": "Damping factor (probability of following an edge vs. restarting to `seed`).", "format": "double", "type": "number" }, "edges": { "default": [], "description": "Weighted directed edges `(from_id, to_id, weight)`; `weight` clamped `>= 0`.", "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" }, "max_iterations": { "default": 100, "description": "Hard iteration cap.", "format": "uint", "minimum": 0, "type": "integer" }, "nodes": { "default": [], "description": "Node ids, index-aligned with `seed` and referenced by `edges`.", "items": { "type": "string" }, "type": "array" }, "seed": { "default": [], "description": "Seed risk per node, index-aligned with `nodes` (any non-negative\nscale \u2014 normalized internally; all-zero \u21d2 all-zero result).", "items": { "format": "double", "type": "number" }, "type": "array" }, "tolerance": { "default": 1e-09, "description": "L1 convergence tolerance.", "format": "double", "type": "number" }, "writeback": { "default": false, "description": "Materialize each node's propagated score as a typed `:RiskScore` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Ontology-gap detection (CONCEPT:EG-KG.mining.ontology-gap): scans the\nresident graph's own node-`type`/edge-`relationship` class shape (GRAPH-NATIVE \u2014\nno `rdf`/OWL-reasoner dependency) for completeness gaps: no declared\nproperties, an unresolved `subClassOf` parent (an orphan subclass), or a\nfully disconnected class. With `writeback=true` materializes each gap as a\ntyped `:OntologyGap` node linked to its class \u2014 a graph MUTATION,\nWAL-replayed by re-scanning deterministically. Gated `mining`.", "properties": { "method": { "const": "MineOntologyGap", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per gap (E6) \u2014 see\n[`Method::MineAssociate::as_claim`]. Confidence is seeded from the\ngap kind's fixed documented severity (`eg_compute::mining::ontology_gap::GapKind::severity`).\nRequires `writeback`.", "type": "boolean" }, "label": { "default": null, "description": "Optional: restrict the scan to class nodes of this one type\n(`None` \u21d2 every node whose `type`/`node_type` is `Class` or `OwlClass`).", "type": [ "string", "null" ] }, "writeback": { "default": false, "description": "Materialize each gap as a typed `:OntologyGap` node linked to its class.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Retrieval-quality evaluation (CONCEPT:EG-KG.mining.retrieval-quality):\nprecision@k / recall@k / MRR over stored retrieval `traces`. With\n`writeback=true` materializes the aggregate report as a typed\n`:RetrievalQuality` node \u2014 a graph MUTATION, WAL-replayed by\nre-evaluating deterministically. Gated `mining`.", "properties": { "method": { "const": "MineRetrievalQuality", "type": "string" }, "params": { "additionalProperties": false, "properties": { "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) for the report (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from\nthe report's own F1 (harmonic mean of precision@k/recall@k, already\n`[0,1]`). Requires `writeback`.", "type": "boolean" }, "k": { "default": 0, "description": "Precision/recall/MRR cutoff. `0` \u21d2 use each trace's full retrieved list.", "format": "uint", "minimum": 0, "type": "integer" }, "query_id": { "default": "", "description": "Optional identity for the write-back `:RetrievalQuality` node. Empty \u21d2\nderived from the input traces.", "type": "string" }, "traces": { "default": [], "description": "Retrieval traces to evaluate \u2014 required.", "items": { "$ref": "#/components/schemas/ResDef_Query_RetrievalTraceSpec" }, "type": "array" }, "writeback": { "default": false, "description": "Materialize the aggregate report as a typed `:RetrievalQuality` node.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Community detection as a mining family (CONCEPT:EG-KG.mining.community-writeback):\nwraps the EXISTING GDS Louvain / label-propagation kernels\n(`eg_compute::graph_algos`, already exposed on the Cypher `CALL gds.*`\nsurface) \u2014 adds NO new algorithm, only the epistemic writeback. Runs over\nthe resident graph (optionally restricted to one node `label`, like\n`MineSubgraph`). With `writeback=true` materializes each community as a\ntyped `:Community` node linked to its members \u2014 a graph MUTATION,\nWAL-replayed by re-detecting deterministically. Gated `mining`.", "properties": { "method": { "const": "MineCommunity", "type": "string" }, "params": { "additionalProperties": false, "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_CommunityAlgorithm", "default": "louvain", "description": "Which existing GDS kernel to run." }, "as_claim": { "default": false, "description": "ADDITIONALLY materialize a `:Claim` (+ `:Evidence`) per community (E6)\n\u2014 see [`Method::MineAssociate::as_claim`]. Confidence is seeded from\nthe community's own internal-edge density (already `[0,1]`). Requires `writeback`.", "type": "boolean" }, "label": { "default": null, "description": "Optional: restrict the projected graph to nodes of this one type.", "type": [ "string", "null" ] }, "max_iterations": { "default": 100, "description": "Iteration/sweep cap.", "format": "uint", "minimum": 0, "type": "integer" }, "resolution": { "default": 1.0, "description": "Louvain modularity resolution (ignored by label-propagation).", "format": "double", "type": "number" }, "seed": { "default": 0, "description": "Seed for Louvain's deterministic shuffle (ignored by label-propagation).", "format": "uint64", "minimum": 0, "type": "integer" }, "weighted": { "default": true, "description": "Weight neighbor votes by edge weight (label-propagation only; ignored by Louvain).", "type": "boolean" }, "writeback": { "default": false, "description": "Materialize each community as a typed `:Community` node linked to its members.", "type": "boolean" } }, "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Typed task/capability requirements -> a validated `AgentGraph` draft\nwith coverage derivations and a verifiable certificate, or a typed\nabstention. Reads one tenant-bound agent-library snapshot; commits\nnothing. Boxed like `SemanticIndex`/`KgDelegate` so one request cannot\nset the size of every `Method`.", "properties": { "method": { "const": "AgentAssemble", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_AssemblyRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Snapshot-checked commit of one assembly `DecisionRecord` as a\n`DecisionRecord` component. Re-derives the record and compares the\ncatalog digest before writing, so a stale decision is refused rather\nthan stored.", "properties": { "method": { "const": "DecisionCommit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DecisionCommitRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Statistical decision over library or RLS-filtered graph candidates.\nEVALUATE-ONLY: it answers records and commits none of them.", "properties": { "method": { "const": "Decide", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_DecideRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Admin job: fit a decision head into a Blob CAS draft artifact.", "properties": { "method": { "const": "DecisionFit", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_DecisionFitOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Admin job: off-policy and calibration evaluation producing the\npromotion receipt a head must carry before it may be published.", "properties": { "method": { "const": "DecisionEval", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_DecisionEvalOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "General bounded 0-1 integer programme with an independently verifiable\ncertificate. Pure compute: no store, no clock, no float.", "properties": { "method": { "const": "Solve", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_SolveRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Atomic connector MCP pack import and its admin surface.", "properties": { "method": { "const": "ConnectorPack", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_ConnectorPackOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "RF-ADR-009 native ingestion authority. Resolves the exact Connector\nManifest mapping under the verified tenant, admits raw records to CAS,\nmaps them and atomically commits graph material, provenance and cursor.", "properties": { "method": { "const": "SourceIngest", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_SourceIngestionRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Latest authoritative SourceIngest checkpoint for restart/failover CAS\nrecovery. Tenant and graph are taken only from verified request context.", "properties": { "method": { "const": "SourceIngestStatus", "type": "string" }, "params": { "additionalProperties": false, "properties": { "connector": { "type": "string" }, "stream": { "type": "string" } }, "required": [ "connector", "stream" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "EG-owned D18 source change sets and append-only write-back receipts.\nThe engine records governed observations; it never calls a vendor API.", "properties": { "method": { "const": "WriteBack", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_WriteBackOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Attach, replace or detach one keyed schema source on the request graph.", "properties": { "method": { "const": "GraphSchema", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_GraphSchemaOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "List the request graph's schema sources and its composed digest.", "properties": { "method": { "const": "GraphSchemaList", "type": "string" } }, "required": [ "method" ], "type": "object" }, { "additionalProperties": false, "description": "Operator view and in-order re-delivery of one owner's mutation outbox.", "properties": { "method": { "const": "MutationOutbox", "type": "string" }, "params": { "additionalProperties": false, "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxOp" } }, "required": [ "op" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "The caller's view of one native WorkItem row, or `null` when no row with\nthis id is visible to `tenant`. `tenant` must equal the verified request\ntenant (`ACCESS_DENIED` otherwise); lease owner, epoch and fencing token\nare never returned. See [`crate::work_item_read`].", "properties": { "method": { "const": "GetWorkItem", "type": "string" }, "params": { "additionalProperties": false, "properties": { "tenant": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "tenant", "work_item_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "One bounded page of `tenant`'s WorkItems, optionally of one `kind`.\nPages by the limit / scan / byte bounds of `AgentComponent.Search`; an\nempty page may still carry `next_cursor`. The cursor is opaque and\nbound to the tenant it was minted for.", "properties": { "method": { "const": "ListWorkItems", "type": "string" }, "params": { "additionalProperties": false, "properties": { "cursor": { "default": null, "type": [ "string", "null" ] }, "kind": { "default": null, "type": [ "string", "null" ] }, "limit": { "format": "uint32", "minimum": 0, "type": "integer" }, "metadata_match": { "additionalProperties": true, "default": null, "description": "Keep only items whose top-level `metadata` holds every one of these\nkey/value pairs exactly (at most 8 keys) -- e.g. a correlation id or\nan event subject (graph-os EG-5). Filters within the same bounded\nscan, so it never widens a page's cost.", "type": [ "object", "null" ] }, "tenant": { "type": "string" } }, "required": [ "tenant", "limit" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "A terminal WorkItem of `tenant` and the provenance (RunTrace /\nToolCall refs and the verified OutcomeEvaluation receipt) its native\n`CommitWorkItemResult { outcome_extension }` bound, or `null` when the\nitem is not visible or carries no committed outcome (graph-os EG-3).", "properties": { "method": { "const": "GetWorkItemOutcome", "type": "string" }, "params": { "additionalProperties": false, "properties": { "tenant": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "tenant", "work_item_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Issue one active control lease: an immutable, time-boxed grant record.\nA row already holding the id answers `collision` and is left untouched.\n`request.tenant` must equal the verified request tenant. See\n[`crate::control_lease`].", "properties": { "method": { "const": "IssueControlLease", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_IssueControlLeaseRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "Move one control lease along a legal edge (`active -> consumed |\nrevoked | expired`, `consumed -> revoked | expired`), compare-and-set\non the revision the caller read. A lease never returns to `active`.", "properties": { "method": { "const": "TransitionControlLease", "type": "string" }, "params": { "additionalProperties": false, "properties": { "request": { "$ref": "#/components/schemas/ResDef_Query_TransitionControlLeaseRequest" } }, "required": [ "request" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" }, { "additionalProperties": false, "description": "The caller's view of one control lease, or `null` when no lease with\nthis id is visible to `tenant` (which must equal the verified tenant).", "properties": { "method": { "const": "GetControlLease", "type": "string" }, "params": { "additionalProperties": false, "properties": { "lease_id": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "tenant", "lease_id" ], "type": "object" } }, "required": [ "method", "params" ], "type": "object" } ] }, "ResDef_Query_MineAlgorithm": { "description": "Which frequent-itemset engine `MineAssociate` runs (CONCEPT:EG-KG.mining.frequent-itemset-mining).\nAll three are exact and agree on the frequent-itemset set for a given support;\nthey differ only in traversal strategy. FP-Growth is the default (no candidate\ngeneration \u2192 fastest on dense baskets).", "enum": [ "fpgrowth", "apriori", "eclat" ], "type": "string" }, "ResDef_Query_MineSeqAlgorithm": { "description": "Which sequential-pattern engine `MineSequence` runs (CONCEPT:EG-KG.mining.prefixspan\n\u2014 Phase 4). Both are exact and agree on the frequent-pattern set for a given\nsupport. PrefixSpan is the default (projection-based, no candidate generation).", "enum": [ "prefixspan", "gsp" ], "type": "string" }, "ResDef_Query_MinimalFlipSetWire": { "description": "Wire mirror of `eg_epistemic::query::MinimalFlipSet` \u2014 \"what would invalidate it\".", "properties": { "believed_after": { "type": "boolean" }, "believed_now": { "type": "boolean" }, "claim": { "type": "string" }, "evidence_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "claim", "believed_now", "evidence_ids", "believed_after" ], "type": "object" }, "ResDef_Query_ModalityFacts": { "additionalProperties": false, "description": "Which modalities a component consumes and produces.\n\nNative `eg:modality/*` IRIs, sorted and unique, so two components that\nspeak the same modalities digest identically whatever order they declared\nthem in.", "properties": { "input": { "default": [], "items": { "type": "string" }, "type": "array" }, "output": { "default": [], "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "ResDef_Query_ModelSpec": { "description": "The model family + its algorithm + free-form hyperparameters. `family` is\n`classify` (node classification), `estimator`/`regress` (regression), or\n`graphlearn`/`kan` (link prediction \u2014 the KAN one-off, now a pipeline family).\n`algorithm` selects within the family (e.g. classify \u2192 `logistic`; estimator \u2192\n`ridge`). `params` carries family-specific knobs the handler reads with defaults.", "properties": { "algorithm": { "default": "", "type": "string" }, "family": { "default": "classify", "type": "string" }, "params": { "default": {} } }, "type": "object" }, "ResDef_Query_MultimodalAssetRef": { "additionalProperties": false, "properties": { "asset_id": { "type": "string" }, "asset_revision": { "type": "string" }, "content_digest": { "type": "string" }, "media_kind": { "type": "string" } }, "required": [ "asset_id", "media_kind", "asset_revision", "content_digest" ], "type": "object" }, "ResDef_Query_MutationBatch": { "additionalProperties": false, "description": "Universal, deterministic durable mutation unit.", "properties": { "authoritative_state": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_MutationStateDescriptor" }, { "type": "null" } ], "description": "Present when operations are represented by a complete staged graph image." }, "batch_id": { "description": "Stable identity for status lookup and outbox correlation.", "type": "string" }, "created_at_ms": { "description": "Creation time supplied by the request boundary.", "format": "uint64", "minimum": 0, "type": "integer" }, "envelope": { "$ref": "#/components/schemas/ResDef_Query_MutationEnvelope", "description": "The admission header this batch is admitted under: verified caller\nauthority for an operation, the store's own declaration for maintenance." }, "fencing_token": { "description": "Lease/worker fencing epoch for work-driven writes.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "identity": { "$ref": "#/components/schemas/ResDef_Query_MutationScopeIdentity", "description": "Exact tenant, typed logical owner, lifecycle generation, and digest." }, "operations": { "items": { "$ref": "#/components/schemas/ResDef_Query_MutationOperation" }, "type": "array" }, "outbox": { "items": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxIntent" }, "type": "array" }, "placement_epoch": { "description": "Catalog epoch used to resolve a placed owner.", "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "version_expectation": { "$ref": "#/components/schemas/ResDef_Query_VersionExpectation" } }, "required": [ "schema_version", "batch_id", "envelope", "identity", "placement_epoch", "version_expectation", "operations", "outbox", "created_at_ms" ], "type": "object" }, "ResDef_Query_MutationCapability": { "description": "Admission capabilities that materially change persistence semantics.", "oneOf": [ { "const": "unversioned_system_mutation", "description": "Reserved for authenticated first-boot/system-recovery operations.", "type": "string" } ] }, "ResDef_Query_MutationEnvelope": { "description": "The admission header of one durable batch.", "oneOf": [ { "additionalProperties": false, "description": "A caller operation: verified authority, one stable operation identity and\none attempt nonce identity.", "properties": { "operation": { "$ref": "#/components/schemas/ResDef_Query_OperationEnvelope" } }, "required": [ "operation" ], "type": "object" }, { "additionalProperties": false, "description": "An owner-maintenance write: no caller, therefore no operation identity and\nno attempt nonce (RF-RULING-005).", "properties": { "maintenance": { "$ref": "#/components/schemas/ResDef_Query_MaintenanceEnvelope" } }, "required": [ "maintenance" ], "type": "object" } ] }, "ResDef_Query_MutationOperation": { "additionalProperties": false, "description": "One ordered engine operation in a [`MutationBatch`].", "properties": { "domain": { "$ref": "#/components/schemas/ResDef_Query_DurabilityDomain", "description": "Required authoritative domain." }, "method": { "$ref": "#/components/schemas/ResDef_Query_Method" }, "ordinal": { "format": "uint32", "minimum": 0, "type": "integer" }, "surface": { "$ref": "#/components/schemas/ResDef_Query_MutationSurface" } }, "required": [ "ordinal", "surface", "domain", "method" ], "type": "object" }, "ResDef_Query_MutationOutboxIntent": { "additionalProperties": false, "description": "A projection/index/CDC/audit/lineage notification to publish after commit.", "properties": { "headers": { "additionalProperties": { "type": "string" }, "type": "object" }, "key": { "type": "string" }, "payload": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "topic": { "type": "string" } }, "required": [ "topic", "key", "payload", "headers" ], "type": "object" }, "ResDef_Query_MutationOutboxLease": { "additionalProperties": false, "description": "Durable lease over an outbox row.", "properties": { "attempt": { "format": "uint32", "minimum": 0, "type": "integer" }, "consumer": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "lease_until_ms": { "description": "EXCLUSIVE upper bound, mirroring `eg_transaction::outbox::rows::\nOutboxDelivery::lease_until_ms` (the durable row this lease is\nissued over): valid while `now_ms < lease_until_ms`, expired once\n`now_ms >= lease_until_ms`. `now_ms == lease_until_ms` is already\nexpired, not still valid.", "format": "uint64", "minimum": 0, "type": "integer" }, "record": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxRecord" } }, "required": [ "record", "consumer", "lease_epoch", "lease_until_ms", "attempt" ], "type": "object" }, "ResDef_Query_MutationOutboxOp": { "description": "Every mutation-outbox operation.", "oneOf": [ { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "op": { "const": "status", "type": "string" }, "target": { "$ref": "#/components/schemas/ResDef_Query_OutboxTarget" } }, "required": [ "op", "target", "consumer" ], "type": "object" }, { "additionalProperties": false, "properties": { "after": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_OutboxPositionView" }, { "type": "null" } ], "default": null }, "consumer": { "type": "string" }, "limit": { "description": "At most [`MAX_OUTBOX_DEAD_LETTER_PAGE`].", "format": "uint32", "minimum": 0, "type": "integer" }, "op": { "const": "dead_letters", "type": "string" }, "target": { "$ref": "#/components/schemas/ResDef_Query_OutboxTarget" } }, "required": [ "op", "target", "consumer", "limit" ], "type": "object" }, { "additionalProperties": false, "properties": { "consumer": { "type": "string" }, "op": { "const": "rewind", "type": "string" }, "target": { "$ref": "#/components/schemas/ResDef_Query_OutboxTarget" }, "to": { "$ref": "#/components/schemas/ResDef_Query_RewindTarget" } }, "required": [ "op", "target", "consumer", "to" ], "type": "object" } ] }, "ResDef_Query_MutationOutboxRecord": { "additionalProperties": false, "description": "One durable outbox row.", "properties": { "batch_id": { "type": "string" }, "commit_sequence": { "default": null, "description": "The scope version after the batch committed. Legacy rows may omit\nthis field and are rejected when their original order is unverifiable.", "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "committed_version": { "$ref": "#/components/schemas/ResDef_Query_CommittedVersion" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "identity": { "$ref": "#/components/schemas/ResDef_Query_MutationScopeIdentity" }, "intent": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxIntent" }, "ordinal": { "format": "uint32", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "batch_id", "ordinal", "identity", "committed_version", "intent", "created_at_ms" ], "type": "object" }, "ResDef_Query_MutationScope": { "description": "Typed logical owner of a durable mutation.", "oneOf": [ { "additionalProperties": false, "properties": { "graph": { "$ref": "#/components/schemas/ResDef_Query_LogicalName" }, "kind": { "const": "graph", "type": "string" } }, "required": [ "kind", "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "domain": { "$ref": "#/components/schemas/ResDef_Query_DurabilityDomain" }, "kind": { "const": "native", "type": "string" }, "resource": { "$ref": "#/components/schemas/ResDef_Query_LogicalName" } }, "required": [ "kind", "domain", "resource" ], "type": "object" } ] }, "ResDef_Query_MutationScopeDigest": { "description": "Canonical SHA-256 identity digest persisted with every authority-bearing row.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "maxItems": 32, "minItems": 32, "type": "array" }, "ResDef_Query_MutationScopeIdentity": { "additionalProperties": false, "description": "Tenant + typed logical owner + exact lifecycle generation.", "properties": { "identity_digest": { "$ref": "#/components/schemas/ResDef_Query_MutationScopeDigest" }, "incarnation_id": { "$ref": "#/components/schemas/ResDef_Query_IncarnationId" }, "scope": { "$ref": "#/components/schemas/ResDef_Query_MutationScope" }, "tenant": { "$ref": "#/components/schemas/ResDef_Query_ScopeTenantId" } }, "required": [ "tenant", "scope", "incarnation_id", "identity_digest" ], "type": "object" }, "ResDef_Query_MutationStateDescriptor": { "additionalProperties": false, "description": "Digest/version descriptor for authenticated authoritative graph material.", "properties": { "algorithm": { "type": "string" }, "digest": { "type": "string" }, "source_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "target_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "algorithm", "digest", "source_graph_version", "target_graph_version" ], "type": "object" }, "ResDef_Query_MutationSurface": { "description": "Origin surface for an operation. The durable semantics never depend on this\nvalue; it exists for policy/audit/projection consumers.", "enum": [ "graph", "transaction", "query", "rdf", "lifecycle", "job", "broker", "other" ], "type": "string" }, "ResDef_Query_NativeControlSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_NativeOutboxStore": { "description": "Which native owner's outbox this is.\n\nClosed, and closed on purpose: an outbox nobody named is an outbox nobody\nmonitors, so a new durable owner has to be added here to be operable.", "enum": [ "agent_library", "semantic_index", "jobs", "sql_catalog" ], "type": "string" }, "ResDef_Query_NlBinding": { "additionalProperties": false, "description": "A routed utterance: the template chosen and the typed slot values.", "properties": { "params": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_TypedParam_16" }, "source": { "$ref": "#/components/schemas/ResDef_Query_NlChoiceSource" }, "target": { "$ref": "#/components/schemas/ResDef_Query_NlTarget" }, "template": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "unfilled": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_16", "default": [], "description": "Required slots the utterance did not fill." } }, "required": [ "template", "target", "params", "source" ], "type": "object" }, "ResDef_Query_NlChoiceSource": { "description": "Who produced a template choice.", "oneOf": [ { "additionalProperties": false, "description": "The engine's own routing decision.", "properties": { "by": { "const": "engine", "type": "string" } }, "required": [ "by" ], "type": "object" }, { "additionalProperties": false, "description": "An LLM planner's proposal after the engine abstained: a claim.", "properties": { "by": { "const": "llm_proposal", "type": "string" }, "producer": { "type": "string" }, "prompt_digest": { "type": "string" } }, "required": [ "by", "producer", "prompt_digest" ], "type": "object" } ] }, "ResDef_Query_NlTarget": { "description": "Which request a template fills.", "oneOf": [ { "additionalProperties": false, "description": "A statistical decision question.", "properties": { "question": { "$ref": "#/components/schemas/ResDef_Query_StatisticalQuestion" }, "target": { "const": "decide", "type": "string" } }, "required": [ "target", "question" ], "type": "object" }, { "additionalProperties": false, "description": "An agent assembly.", "properties": { "target": { "const": "agent_assemble", "type": "string" } }, "required": [ "target" ], "type": "object" }, { "additionalProperties": false, "description": "A named, operator-published query.", "properties": { "query_id": { "type": "string" }, "target": { "const": "named_query", "type": "string" } }, "required": [ "target", "query_id" ], "type": "object" } ] }, "ResDef_Query_Nonce": { "description": "32 bytes of attempt nonce as lowercase hexadecimal", "maxLength": 64, "minLength": 64, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "ResDef_Query_ObdaExternalSource": { "description": "CONCEPT:EG-KG.query.obda-predicate-pushdown \u2014 a LIVE EXTERNAL relational source registered\nfor an OBDA virtual graph (W4.11): a `TriplesMap::logical_source` NAME bound to a `table`\nin an external Postgres/MySQL database reachable at `dsn`. On a [`Method::SparqlVirtual`]\nquery the engine exposes it as a virtual RDF graph and pushes BOTH the query's column\nprojection AND its row-level `FILTER`s down into a real `SELECT \u2026 WHERE \u2026` against the\ndatabase \u2014 the whole table is never scanned. The live SQL path needs a server built with\n`federation-sql` (reusing its SSRF-validated, read-only, timeout+row-bounded connector); a\nbuild without it returns a clean \"rebuild with federation-sql\" error. Distinct from\n`tables` (the engine's OWN user tables).", "properties": { "dsn": { "description": "The external database DSN (`postgres://\u2026` / `mysql://\u2026`), SSRF-validated server-side.", "type": "string" }, "name": { "description": "The foreign-source NAME the mapping's `TriplesMap`(s) reference as `logical_source`.", "type": "string" }, "table": { "description": "The table (or view) name in the external database to expose as the virtual source.", "type": "string" } }, "required": [ "name", "dsn", "table" ], "type": "object" }, "ResDef_Query_ObjectiveLevelKind": { "description": "One level of the objective, named rather than positional so a record says\nwhich quantity a budget was exhausted on.", "oneOf": [ { "const": "uncovered", "description": "How many required capabilities stay uncovered.", "type": "string" }, { "const": "components", "description": "How many components the assembly selects.", "type": "string" }, { "const": "declared_cost", "description": "Declared cost of the selection, in the budget's currency.", "type": "string" }, { "const": "declared_p95_latency", "description": "Declared p95 latency of the selection.", "type": "string" } ] }, "ResDef_Query_ObjectiveLevelSpec": { "additionalProperties": false, "description": "One level of the lexicographic objective (minimised).", "properties": { "label": { "type": "string" }, "terms": { "items": { "$ref": "#/components/schemas/ResDef_Query_ObjectiveTerm" }, "type": "array" } }, "required": [ "label", "terms" ], "type": "object" }, "ResDef_Query_ObjectiveOrder": { "description": "How the objective levels combine.", "oneOf": [ { "additionalProperties": false, "description": "Strict priority: any change in an earlier level outweighs every\npossible change in all later ones together.", "properties": { "levels": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_ObjectiveLevelKind_8" }, "order": { "const": "lexicographic", "type": "string" } }, "required": [ "order", "levels" ], "type": "object" }, { "additionalProperties": false, "description": "One weighted sum.", "properties": { "order": { "const": "weighted", "type": "string" }, "weights": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_WeightedLevel_8" } }, "required": [ "order", "weights" ], "type": "object" } ] }, "ResDef_Query_ObjectiveTerm": { "additionalProperties": false, "description": "One term of an objective level.", "properties": { "coefficient": { "$ref": "#/components/schemas/ResDef_Query_Coefficient" }, "var": { "$ref": "#/components/schemas/ResDef_Query_VarId" } }, "required": [ "var", "coefficient" ], "type": "object" }, "ResDef_Query_ObjectiveValue": { "additionalProperties": false, "description": "Every level's value plus the exact scalarised objective.", "properties": { "levels": { "items": { "$ref": "#/components/schemas/ResDef_Query_LevelValue" }, "type": "array" }, "scalar": { "$ref": "#/components/schemas/ResDef_Query_Scalar" } }, "required": [ "levels", "scalar" ], "type": "object" }, "ResDef_Query_ObservationRef": { "additionalProperties": false, "description": "A pointer to a recorded evaluation, for a fact that was MEASURED rather\nthan declared.", "properties": { "digest": { "type": "string" }, "evaluation_id": { "type": "string" } }, "required": [ "evaluation_id", "digest" ], "type": "object" }, "ResDef_Query_Op": { "description": "One cross-modal operator. A [`Plan`] is an ordered list of these \u2014 a pipeline\nwhere each op `(RowSet) -> RowSet`. This increment binds SQL + graph + vector\n(`Scan | Filter | Traverse | Rank | Limit`); reasoning/blob ops are later\nincrements. The algorithm lives in `eg-plan`; this is the wire DTO.", "oneOf": [ { "additionalProperties": false, "description": "SOURCE \u2014 seed from all nodes carrying `label` (`type == label`).", "properties": { "Scan": { "properties": { "label": { "type": "string" } }, "required": [ "label" ], "type": "object" } }, "required": [ "Scan" ], "type": "object" }, { "additionalProperties": false, "description": "FILTER (relational) \u2014 keep rows matching ALL `preds`, via real DataFusion.", "properties": { "Filter": { "properties": { "preds": { "items": { "$ref": "#/components/schemas/ResDef_Query_Pred" }, "type": "array" } }, "required": [ "preds" ], "type": "object" } }, "required": [ "Filter" ], "type": "object" }, { "additionalProperties": false, "description": "TRAVERSE (graph) \u2014 follow `rel` edges `min..=max` hops (petgraph BFS).", "properties": { "Traverse": { "properties": { "max": { "format": "uint", "minimum": 0, "type": "integer" }, "min": { "format": "uint", "minimum": 0, "type": "integer" }, "rel": { "type": "string" } }, "required": [ "rel", "min", "max" ], "type": "object" } }, "required": [ "Traverse" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (vector) \u2014 re-order by cosine similarity to `query` (SemanticStore kNN).", "properties": { "Rank": { "properties": { "query": { "items": { "format": "float", "type": "number" }, "type": "array" } }, "required": [ "query" ], "type": "object" } }, "required": [ "Rank" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (vector-from-TEXT, CONCEPT:EG-KG.compute.no-embedder-bound-op) \u2014 like `Rank`, but the query vector is\nRESOLVED at exec time from the natural-language `text` by the server-side embedder\nbound on the `PlanCtx` (`eg_plan::PlanCtx::with_embedder`). This closes the UQL\n`RANK BY ~ \"text\"` NL\u2192vector seam: the front-end no longer needs the caller to\npre-embed and pass a literal vector. With NO embedder bound the op is a clean typed\nERROR (never a panic) \u2014 the documented unbound behavior. Base `query` (the\n`TextEmbedder` trait is dep-free; the kNN reuses the SAME `SemanticStore` path as\n`Rank`, so a build without an embedder is byte-for-byte unchanged).", "properties": { "RankEmbed": { "properties": { "text": { "type": "string" } }, "required": [ "text" ], "type": "object" } }, "required": [ "RankEmbed" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (graph distance, CONCEPT:EG-KG.query.uql-parser-ops) \u2014 re-order the candidate set by inverse\nshortest-path hop distance from `center` over the graph topology, score\n`1/(1+hops)` (unreachable \u2192 0). A graph-NATIVE reranker (Graphiti's\n`node_distance`): proximity to a focal node, fused alongside vector/BM25. Reuses\nthe same BFS the `Traverse` leg uses; dep-free, so it ships under base `query`.", "properties": { "RankNodeDistance": { "properties": { "center": { "type": "string" } }, "required": [ "center" ], "type": "object" } }, "required": [ "RankNodeDistance" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (provenance salience, CONCEPT:EG-KG.query.uql-parser-ops) \u2014 re-order the candidate set by how\nmany edges MENTION each node (incoming-edge count), score normalized to the max\nin the set. Graphiti's `episode_mentions` salience: a node many episodes point at\nranks higher. Topology-only, dep-free, base `query`.", "properties": { "RankMentions": { "type": "object" } }, "required": [ "RankMentions" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (MMR diversity, CONCEPT:AU-KG.retrieval.mmr-diversification) \u2014 re-order the candidate set by Maximal\nMarginal Relevance: greedily pick the next item maximizing\n`lambda*rel - (1-lambda)*max_sim_to_already_picked`, where rel is the item's\nincoming relevance score (from a prior `Rank`) and sim is cosine over stored\nembeddings. Reduces near-duplicate redundancy in the top-k \u2014 the diversity\nreranker Graphiti does NOT have. `k` caps how many to re-rank (0 \u21d2 all). Reads\n`ctx.semantic` (always present), so base `query`.", "properties": { "RankMmr": { "properties": { "k": { "format": "uint", "minimum": 0, "type": "integer" }, "lambda": { "format": "float", "type": "number" } }, "required": [ "lambda", "k" ], "type": "object" } }, "required": [ "RankMmr" ], "type": "object" }, { "additionalProperties": false, "description": "RANK (lexical, BM25) \u2014 re-order the candidate set by BM25 relevance to the\nnatural-language `query` string over the text index (CONCEPT:AU-KG.query.text-spatial-time). A\nsibling of the vector `Rank`: it produces a score-per-id over the SAME RowSet\ncurrency, so the closed algebra is unchanged. Gated by `text` (the Tantivy\nindex lives in eg-text behind its own gate; this is just the wire variant).", "properties": { "RankText": { "properties": { "query": { "type": "string" } }, "required": [ "query" ], "type": "object" } }, "required": [ "RankText" ], "type": "object" }, { "additionalProperties": false, "description": "FUSE (hybrid) \u2014 reciprocal-rank-fusion of N SUB-PLAN `branches` over the SAME\nseed into ONE ranked RowSet (CONCEPT:AU-KG.query.text-spatial-time / KG-2.253). The modern hybrid-\nretrieval pattern, generalized past two legs: fuse the RANKS (not the\nincomparable BM25/cosine/distance scores) so a doc strong across MORE branches\nout-ranks one strong in only one. The canonical tri-modal hybrid is\n`branches = [[Rank{vec}], [RankText{q}], [RankNodeDistance{c}]]`. `k` is the RRF\ndamping constant (use `eg_text::RRF_K` = 60 by convention; `0.0` \u21d2 that default).", "properties": { "FuseRrf": { "properties": { "branches": { "items": { "items": { "$ref": "#/components/schemas/ResDef_Query_Op" }, "type": "array" }, "type": "array" }, "k": { "format": "float", "type": "number" } }, "required": [ "branches", "k" ], "type": "object" } }, "required": [ "FuseRrf" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (semantic, OWL) \u2014 seed the RowSet with every individual the native OWL 2\nreasoner INFERS to be a member of `target_class` (CONCEPT:EG-KG.ontology.incremental-materialization/220). The\nreasoner classifies the graph's TBox (the OWL axioms loaded as RDF) and returns\nthe instances of `target_class` \u2014 INCLUDING ones reached through existential\nrestrictions / role chains for which the property-graph stored NO explicit type\nedge. `ontology` (Turtle) carries the axioms; an empty string \u21d2 use the axioms\nalready in the graph. The result then flows \u2014 like any RowSet \u2014 into a graph\n`Traverse`, a vector `Rank`, a SQL `Filter`, or a `Limit`. Gated by `owl`.", "properties": { "Reason": { "properties": { "ontology": { "default": "", "description": "OWL axioms as a Turtle document. Empty \u21d2 classify the axioms already loaded\ninto the request's graph.", "type": "string" }, "target_class": { "description": "The named class whose (inferred) members seed the RowSet (canonical ``\nor a bare IRI string \u2014 both are accepted).", "type": "string" } }, "required": [ "target_class" ], "type": "object" } }, "required": [ "Reason" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (semantic, SPARQL) \u2014 seed the RowSet with the node bindings of `var` in\nthe result of the SPARQL `query` (a basic graph pattern, CONCEPT:EG-KG.ontology.concept-12),\nevaluated over the request's graph. A SPARQL-selected candidate set as a normal\nRowSet source: it then flows into the SAME graph/vector/SQL/time ops as any\nother op. Gated by `owl` (which implies `sparql`).", "properties": { "SparqlBgp": { "properties": { "query": { "description": "A SPARQL 1.1 SELECT (the basic-graph-pattern surface eg-rdf evaluates).", "type": "string" }, "var": { "description": "The projected variable whose (resource) bindings become the RowSet ids.", "type": "string" } }, "required": [ "query", "var" ], "type": "object" } }, "required": [ "SparqlBgp" ], "type": "object" }, { "additionalProperties": false, "description": "UDF (WASM) \u2014 transform the current `RowSet` through a registered, SANDBOXED\nWebAssembly user function (CONCEPT:EG-KG.query.rowset-execution). The executor serializes the input\nrows (ids + scores) to bytes, runs the wasm module `id` under fuel + memory\nlimits with NO host capabilities, and deserializes the returned rows back into\nthe pipeline. A pure `RowSet -> RowSet` op like every other, so a UDF composes\nwith Scan/Filter/Traverse/Rank/Limit. Gated by `wasm-udf` (the wasmtime runtime\nlives in eg-wasm behind its own gate; this is just the wire variant).", "properties": { "Udf": { "properties": { "id": { "type": "string" } }, "required": [ "id" ], "type": "object" } }, "required": [ "Udf" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (federation) \u2014 read rows from an EXTERNAL source and seed the RowSet\n(CONCEPT:EG-KG.query.query-federation, Lane P). `source` is either a REMOTE epistemic-graph engine\n(queried over the same transport) or a generic HTTP/JSON API \u2014 see\n[`ForeignSourceSpec`]. The resulting RowSet then flows \u2014 like any other source\nop \u2014 into a downstream `Filter`/`Traverse`/`Rank`/`Limit`, so a federated query\nJOINS a foreign source with the LOCAL graph in ONE plan. A `ForeignScan` placed\nAFTER a local source op replaces the input (it is a source, not a transform),\nexactly like `Scan`/`Reason`/`SparqlBgp`. Gated by `federation` (the HTTP client\nis rustls/pure-Rust and kept OUT of the Pi tier \u2014 the Pi contract).\n\n`ForeignScan` is the RESOLVED federation EXECUTOR (it carries a fully-specified\n[`ForeignSourceSpec`] and actually fetches+joins). The UQL `FOREIGN \"\"`\nclause (CONCEPT:EG-KG.query.sparql-completeness) instead lowers to the lighter [`Op::Foreign`] name\nMARKER below \u2014 the parser only has a name, and resolving that name to a concrete\n`ForeignSourceSpec` goes through the server-side `foreign_sources` map, which the\nserved query handler turns into eg-plan's own `ForeignSourceRegistry` and binds\nonto the `PlanCtx` (CONCEPT:EG-KG.query.closure-backed-source). The two are\ncomplementary: `Foreign`\nis the named-reference surface, `ForeignScan` is the resolved executor a\nserver/planner constructs.", "properties": { "ForeignScan": { "properties": { "join": { "default": false, "description": "When this `ForeignScan` is NOT the first op, intersect its rows with the\ncurrent candidate set (a foreign\u2229local JOIN keyed on id) instead of\nreplacing the input. The default (false) makes it a pure source. The\npreceding rows' ORDER is preserved on an intersect.", "type": "boolean" }, "source": { "$ref": "#/components/schemas/ResDef_Query_ForeignSourceSpec" } }, "required": [ "source" ], "type": "object" } }, "required": [ "ForeignScan" ], "type": "object" }, { "additionalProperties": false, "description": "TIME (`AS OF [TX] @`, CONCEPT:EG-KG.query.sparql-completeness / KG-2.250) \u2014 pin the RowSet to a\npoint-in-time `ts` (unix seconds) and DROP rows not live at that instant. A\nRowSet-narrowing temporal filter executed in `eg-plan` (dep-free blob scan, no\nDataFusion \u2014 Pi-safe). `axis` selects the timeline: `Valid` = \"what was TRUE at\nts\" (`valid_from`/`valid_until`); `Transaction` = \"what we BELIEVED at ts\"\n(`tx_from`/`tx_to`). The axis is explicit in the current plan contract.", "properties": { "AsOf": { "properties": { "axis": { "$ref": "#/components/schemas/ResDef_Query_TimeAxis" }, "ts": { "format": "double", "type": "number" } }, "required": [ "ts", "axis" ], "type": "object" } }, "required": [ "AsOf" ], "type": "object" }, { "additionalProperties": false, "description": "TIME (`WINDOW `, CONCEPT:EG-KG.query.sparql-completeness) \u2014 declare a trailing time window of\n`secs` seconds for the windowed time-series aggregate. A RowSet-preserving\nCONTEXT op paired with `AsOf`; passes the rows through unchanged today (the\nwindowed aggregate is the eg-tsdb seam) but lets the `WINDOW ` UQL clause\nlower to ONE plan AST. Always available under `query`.\n\nAs of CONCEPT:EG-KG.compute.tsscan-series-window-60s the executor no longer merely passes the rows through: an\n`Op::Window` over a RowSet of `(ts, value)` rows (e.g. from `Op::TsScan`, or any\nscored row) now emits a REAL tumbling windowed aggregate (MEAN, via eg-tsdb's\n`time_bucket`) \u2014 one row per non-empty bucket (`id` = the aligned bucket start,\n`score` = the aggregate) \u2014 composing downstream into `Rank`/`Limit`. Under a\nnon-`timeseries` build the op keeps its RowSet-preserving passthrough behavior.", "properties": { "Window": { "properties": { "secs": { "format": "double", "type": "number" } }, "required": [ "secs" ], "type": "object" } }, "required": [ "Window" ], "type": "object" }, { "additionalProperties": false, "description": "TIME (`WINDOW `, CONCEPT:EG-KG.compute.trailing-aggregate-selector-lowers) \u2014 the SELECTABLE-aggregate form of\n`Op::Window`: a real tumbling windowed aggregate over `(ts, value)` rows whose\naggregate function `agg` (one of `mean`/`avg`, `sum`, `min`, `max`, `count`,\n`first`, `last`; unknown \u21d2 `mean`) is resolved to an `eg_tsdb::query::Agg`. Emits\none row per non-empty bucket (`id` = aligned bucket start, `score` = the aggregate),\ncomposing downstream exactly like `Window`. Base `query` (the eg-tsdb aggregate is\nonly wired under `timeseries`; a non-`timeseries` build passes the rows through, as\n`Window` does).", "properties": { "WindowAgg": { "properties": { "agg": { "type": "string" }, "secs": { "format": "double", "type": "number" } }, "required": [ "secs", "agg" ], "type": "object" } }, "required": [ "WindowAgg" ], "type": "object" }, { "additionalProperties": false, "description": "FEDERATION (`FOREIGN \"\"`, CONCEPT:EG-KG.query.sparql-completeness) \u2014 replace the seed with rows from\nthe registered foreign source `name`. The plan fails when no registry/source is\nbound; foreign intent is never ignored. Always available under `query`, while\nexecution requires the `federation` feature. The inline-spec counterpart is the\n`federation`-gated [`Op::ForeignScan`] above.", "properties": { "Foreign": { "properties": { "name": { "type": "string" } }, "required": [ "name" ], "type": "object" } }, "required": [ "Foreign" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (spatial, CONCEPT:EG-KG.ontology.singles-concept) \u2014 seed the RowSet with every node in the spatial\n`layer` (a node label / `type`) whose geometry's bounding box intersects `bbox`\n(`[minx, miny, maxx, maxy]`). The executor builds eg-geo's packed Hilbert R-tree\nover the layer's geometries and runs `query_bbox`, so the returned candidate set\nthen flows \u2014 like any source op \u2014 into a downstream spatial `Filter`\n(`SpatialWithin`/`SpatialDWithin`) / `Traverse` / `Rank` / `Limit`, composing a\nspatial filter with graph + vector in ONE plan. Gated by `geo` (the geometry model\n+ R-tree live in eg-geo behind eg-plan's own `geo` gate; this is the wire variant).", "properties": { "SpatialScan": { "properties": { "bbox": { "items": { "format": "double", "type": "number" }, "maxItems": 4, "minItems": 4, "type": "array" }, "layer": { "type": "string" } }, "required": [ "layer", "bbox" ], "type": "object" } }, "required": [ "SpatialScan" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (spatial CRS, CONCEPT:EG-KG.domains.coordinate-reference-system) \u2014 reproject each row's stored geometry into\nthe target CRS `to_epsg`. The SOURCE CRS is the row geometry's EWKT `SRID=\u2026;` tag\nwhen present, else the explicit `from_epsg` override. Rows with no/invalid geometry,\nno resolvable source CRS, or an unsupported EPSG code are DROPPED (order-preserving,\nexactly as the tensor/spatial legs narrow their input) \u2014 the derived geometry\nvalidates the transform per row. The pure-Rust reprojection math (WGS84 / Web-Mercator\n/ UTM, NO PROJ C dep) lives in eg-geo behind eg-plan's `geo` gate; this is the\nCRS-carrying wire variant. Gated by `geo`.", "properties": { "Reproject": { "properties": { "from_epsg": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "to_epsg": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "to_epsg" ], "type": "object" } }, "required": [ "Reproject" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (constructive geometry, CONCEPT:EG-KG.ontology.concept-9) \u2014 apply the constructive op `kind`\n(buffer / convex-hull / simplify / centroid / union / intersection / difference) to\neach row's stored geometry, producing a DERIVED geometry per row. Rows whose geometry\nis missing/invalid or where the op yields nothing (e.g. an empty intersection) are\nDROPPED \u2014 order- and score-preserving, exactly as the tensor `TensorOp` leg. The\npure-Rust algebra lives in eg-geo behind eg-plan's `geo` gate; this is the wire\nvariant. Gated by `geo`.", "properties": { "SpatialOp": { "properties": { "kind": { "$ref": "#/components/schemas/ResDef_Query_SpatialOpKind" } }, "required": [ "kind" ], "type": "object" } }, "required": [ "SpatialOp" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (tensor, CONCEPT:EG-KG.storage.content-addressed-dedup) \u2014 seed the RowSet with every node in the `layer`\n(a node label / `type`) that carries a stored tensor (a dense N-D array in the\nconventional `tensor` node property). The returned candidate set then flows \u2014\nlike any source op \u2014 into a downstream `TensorOp` (slice/reduce/elementwise) /\n`Traverse` / `Rank` / `Limit`, composing an array modality with graph + vector in\nONE plan. Gated by `tensor` (the N-D array model + ops live in eg-tensor behind\neg-plan's own `tensor` gate; this is the wire variant). The persisted tensors are\ncontent-addressed in the blob CAS per the concept row (`ChunkStore` + EG-071).", "properties": { "TensorScan": { "properties": { "layer": { "type": "string" } }, "required": [ "layer" ], "type": "object" } }, "required": [ "TensorScan" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (tensor, CONCEPT:EG-KG.storage.content-addressed-dedup) \u2014 apply the eg-tensor op `kind`\n(slice/reduce/elementwise) to each row's stored tensor. Rows whose tensor is\nmissing/invalid or where the op fails are dropped (order-preserving), exactly as\nthe spatial `Filter` leg drops rows with no geometry. Gated by `tensor`; the\nN-D array math lives in eg-tensor behind eg-plan's `tensor` gate.", "properties": { "TensorOp": { "properties": { "kind": { "$ref": "#/components/schemas/ResDef_Query_TensorOpKind" } }, "required": [ "kind" ], "type": "object" } }, "required": [ "TensorOp" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (stream, CONCEPT:EG-KG.query.pipelined-execution) \u2014 run the bounded NFA CEP engine (eg-stream)\nover the input RowSet interpreted as a time-ordered event stream: each row's node\nblob carries `ts`/`key`/`attrs`, and the op keeps the rows that participate in a\ndetected match (order-preserving, exactly as the spatial/tensor legs narrow their\ninput). `pattern` carries the pattern tree (sequence/within/absence) + the\nsliding/tumbling `window`. Gated by `stream` (the NFA lives in eg-stream behind\neg-plan's own `stream` gate; this is the wire variant). EG-067 `Op::Window` is the\nwindowing primitive; a live standing CEP query fed by the EG-064 CDC\n`ChangeNotifier` bus is a documented follow-up \u2014 the batch `Op::Cep` over a RowSet\nis what lands.", "properties": { "Cep": { "properties": { "pattern": { "$ref": "#/components/schemas/ResDef_Query_CepPatternSpec" } }, "required": [ "pattern" ], "type": "object" } }, "required": [ "Cep" ], "type": "object" }, { "additionalProperties": false, "description": "FUSE (multimodal sensor fusion, CONCEPT:EG-KG.query.multi-rate-sensor-stream) \u2014 time-align N heterogeneous sensor\n`streams` to ONE common clock and emit fused multi-channel rows. Each named stream is\na node layer (label / `type`) whose nodes carry a `valid_from` event time and either a\nscalar `value` OR an opaque tensor-blob reference (an EG-085 camera/LiDAR frame). The\nexecutor resolves the streams off the snapshot, calls eg-tsdb's `sensor_fuse` \u2014 which\nreuses the eg-tsdb ASOF backward-join to carry each stream's latest sample at-or-before\neach reference instant, within `tolerance_ns` \u2014 and emits one fused row per instant\n(id = the aligned ts, score = the count of present, non-gap channels) so a downstream\n`Limit`/`Rank` composes over the fused series. `tolerance_ns` is the max staleness (ns)\na channel may carry forward; `0` \u21d2 exact-instant matches only. Gated behind\n`timeseries`; the variant only exists when eg-types/timeseries is on (pulled by\neg-plan/timeseries), so a non-timeseries build has neither the variant nor its executor\narm (the tensor/stream gating precedent). Composes EG-085 + EG-088 + eg-tsdb ASOF\n(EG-067); the alignment math lives in eg-tsdb behind eg-plan's `timeseries` gate \u2014 this\nis the pure-serde wire variant.", "properties": { "SensorFuse": { "properties": { "streams": { "items": { "type": "string" }, "type": "array" }, "tolerance_ns": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "streams", "tolerance_ns" ], "type": "object" } }, "required": [ "SensorFuse" ], "type": "object" }, { "additionalProperties": false, "description": "FUSE (multimodal sensor fusion on a DECLARED clock, CONCEPT:EG-KG.query.multi-rate-sensor-stream) \u2014\nthe fixed-grid / tumbling-window sibling of `Op::SensorFuse`. Where `SensorFuse` fuses\nonto the UNION clock of the samples (data-driven instants, ASOF/tolerance only), this\nop resamples every stream onto the time base the caller DECLARES in `clock`\n([`FuseClock::Uniform`] grid or [`FuseClock::Tumbling`] EG-067 windows), each stream\nunder its OWN [`FuseInterp`] mode (`Nearest` / `Linear` / `AsofHold`) \u2014 so the output\ninstants, and the values at them, are independent of when the sensors happened to fire.\nThat is a different semantics, not a different spelling: a `Linear` channel yields a\ngenuinely INTERPOLATED reading at a grid instant no sample sits on, which ASOF cannot\nproduce.\n\nA SOURCE op: it resolves its streams off the snapshot and REPLACES the input, exactly\nlike `SensorFuse` / `TensorScan` / `SpatialScan`. The executor stacks the aligned\nchannels into a `[timesteps \u00d7 channels]` eg-tensor frame + validity mask\n(`eg_tensor::fusion`) and projects ONE row per clock instant: `id` = the instant (or\nwindow start), `score` = the PRIMARY channel's (stream 0) fused reading \u2014 the\n`Op::TsScan` \"field 0\" projection lifted onto the fused frame \u2014 or `None` where that\nchannel gapped. An instant at which EVERY channel is a gap emits NO row, so the\nvalidity mask is what decides emission.\n\n`tolerance_ns` bounds per-channel staleness (`None` = unbounded): a `Nearest`/\n`AsofHold` match farther away than it, or a `Linear` bracket wider than it, is a GAP.\n\nGated behind `timeseries` (the SensorFuse gating precedent); the alignment math lives\nin `eg_tsdb::fusion` and the tensor stacking in `eg_tensor::fusion`, both behind\neg-plan's `timeseries` gate \u2014 this is the pure-serde wire variant.", "properties": { "SensorAlign": { "properties": { "clock": { "$ref": "#/components/schemas/ResDef_Query_FuseClock" }, "streams": { "items": { "$ref": "#/components/schemas/ResDef_Query_FuseStream" }, "type": "array" }, "tolerance_ns": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "streams", "clock" ], "type": "object" } }, "required": [ "SensorAlign" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE (time-series, CONCEPT:EG-KG.query.native-time-series) \u2014 seed the RowSet from native TSDB series.\nScans each series in `series` for points in the `[from, to)` timestamp window and\nemits them as rows so a downstream `Rank`/`Limit`/`Filter` composes the tsdb leg\nwith the graph/vector/relational legs in ONE plan (tsdb-in-plan fusion). Bounds\nare `f64` seconds (uniform with the other numeric plan ops); the executor lowers\nthem to the eg-tsdb `SeriesStore` ns range internally. Gated behind `timeseries`;\nthe variant only exists when eg-types/timeseries is on (pulled by\neg-plan/timeseries), so a non-timeseries build has neither the variant nor its\nexecutor arm (the `SensorFuse` gating precedent). The scan implementation lives in\neg-plan behind its `timeseries` gate; this is the pure-serde wire variant.", "properties": { "TsScan": { "properties": { "from": { "format": "double", "type": "number" }, "series": { "items": { "type": "string" }, "type": "array" }, "to": { "format": "double", "type": "number" } }, "required": [ "series", "from", "to" ], "type": "object" } }, "required": [ "TsScan" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (probabilistic, CONCEPT:EG-KG.compute.uncertainty-values) \u2014 run the probabilistic query `query`\nagainst each row's stored `Distribution` VALUE (the conventional `distribution`\nnode property, the tagged serde form of `eg_types::Distribution`) and SCORE the\nrow with the closed-form result \u2014 expectation / marginal probability / conditional\nposterior mean / deterministic seeded sample \u2014 re-ordering the RowSet by that score\nDESCENDING, exactly as `Rank` produces a scored order a downstream `Limit` respects.\nRows whose `distribution` is missing/invalid, or where the query does not apply\n(e.g. a `Conditional` with an unsupported conjugate pair), are DROPPED \u2014 mirroring\nhow the tensor/spatial legs narrow their input. Gated by `probabilistic` (the\ndistribution + Bayesian math lives in eg-types/eg-compute behind eg-plan's own\n`probabilistic` gate; this is the pure-serde wire variant \u2014 no RNG-from-clock, so a\nseeded `Sample` is reproducible). Mirrors the `tensor`/`stream` gating precedent.", "properties": { "Probabilistic": { "properties": { "query": { "$ref": "#/components/schemas/ResDef_Query_ProbQuery" } }, "required": [ "query" ], "type": "object" } }, "required": [ "Probabilistic" ], "type": "object" }, { "additionalProperties": false, "description": "SOURCE/FILTER (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 the evidence\nFOR `claim_id`: nodes linked to it by an INCOMING `SUPPORTS`/`SUPPORTS_BELIEF`/\n`HAS_EVIDENCE`/`CORROBORATES` edge (classified by `eg_epistemic::classify_relationship`).\nAs a SOURCE (empty input) it seeds the RowSet with the supporting ids; mid-pipeline it\nnarrows the candidate set to the ones that ALSO support `claim_id` \u2014 the same\nseed-or-filter shape as `Op::AsOf`. Gated by `epistemic` (the belief-substrate model\nlives in eg-epistemic behind eg-plan's own `epistemic` gate; this is the wire variant).", "properties": { "EvidenceFor": { "properties": { "claim_id": { "type": "string" } }, "required": [ "claim_id" ], "type": "object" } }, "required": [ "EvidenceFor" ], "type": "object" }, { "additionalProperties": false, "description": "FILTER/SOURCE (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 evidence\nAGAINST `node_id`: nodes linked to it by an INCOMING `CONTRADICTS`/`CONTRADICTS_BELIEF`/\n`REFUTES` OR `ATTACKS`/`DEFEATS`/`UNDERCUTS` edge (an attack is a stronger contradiction,\nso both count). Same seed-or-filter shape as `EvidenceFor`. Gated by `epistemic`.", "properties": { "Contradicts": { "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "Contradicts" ], "type": "object" }, { "additionalProperties": false, "description": "FILTER/SOURCE (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 the claims\n`node_id` itself supports: nodes reached by an OUTGOING `SUPPORTS`/`SUPPORTS_BELIEF`/\n`HAS_EVIDENCE`/`CORROBORATES` edge FROM `node_id` \u2014 the mirror direction of\n`EvidenceFor`. Same seed-or-filter shape. Gated by `epistemic`.", "properties": { "SupportedBy": { "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "SupportedBy" ], "type": "object" }, { "additionalProperties": false, "description": "TIME+TRANSFORM (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 pin the\ncandidate set to what the engine BELIEVED at transaction-time `ts` (composes the\nexisting `Op::AsOf { ts, axis: Transaction }` bi-temporal filter) and then RE-SCORE\neach surviving row by its propagated belief confidence at that instant\n(`eg_epistemic::propagate_confidence`). The UQL sibling `VALID AS OF ` is a pure\nALIAS for `Op::AsOf { axis: Valid }` (no belief propagation) \u2014 this op is the one that\nactually walks the support/contradiction/attack graph. Gated by `epistemic`.", "properties": { "BeliefAsOf": { "properties": { "ts": { "format": "double", "type": "number" } }, "required": [ "ts" ], "type": "object" } }, "required": [ "BeliefAsOf" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 re-weight every\nrow currently in the RowSet by the propagated reliability (belief confidence) of the\nnamed `source_id` node, via `eg_epistemic::propagate_confidence`. Represents \"discount\nthis candidate set by how much I trust source X\" \u2014 a uniform scalar multiplier over\nexisting scores (unscored rows are treated as score `1.0`). Gated by `epistemic`.", "properties": { "SourceReliability": { "properties": { "source_id": { "type": "string" } }, "required": [ "source_id" ], "type": "object" } }, "required": [ "SourceReliability" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 re-score EACH\nrow in the current RowSet by ITS OWN propagated belief confidence\n(`eg_epistemic::propagate_confidence` walking that row's own support/contradiction/\nattack neighbourhood), re-ordering descending \u2014 the `CONFIDENCE` UQL keyword with no\nargument. Mirrors `Op::Probabilistic`'s \"score-then-rank\" shape but over the belief\ngraph instead of a stored `Distribution`. Gated by `epistemic`.", "properties": { "ConfidenceOp": { "type": "object" } }, "required": [ "ConfidenceOp" ], "type": "object" }, { "additionalProperties": false, "description": "TRANSFORM (epistemic, CONCEPT:EG-KG.epistemic.epistemic-substrate, E2) \u2014 the answer to\n`EXPLAIN BELIEF `: build the recursive justification tree\n(`eg_epistemic::explain_belief`) rooted at `node_id`, flatten it (pre-order, deduped) to\n`(claim_id, confidence)` pairs, and either SEED the RowSet with them (empty input) or\nnarrow+re-score the current candidate set to the ones that appear in the tree (mirrors\nthe `EvidenceFor`/`Contradicts` seed-or-filter shape). The FULL nested proof tree\n(rule names, premise structure) is NOT representable in the flat `RowSet` currency \u2014\nthis plan-Op surface is the queryable (composes-with-`Traverse`/`Rank`/`Limit`)\nprojection of it; a standalone `Method::ExplainBelief` returning the tree verbatim\n(mirroring `Method::OwlExplain`'s `ProofNodeWire`) is a documented follow-up, not\nbuilt here (E2 scope is the wire+UQL plan surface). Gated by `epistemic`.", "properties": { "ExplainBelief": { "properties": { "node_id": { "type": "string" } }, "required": [ "node_id" ], "type": "object" } }, "required": [ "ExplainBelief" ], "type": "object" }, { "additionalProperties": false, "description": "LIMIT \u2014 top-k, respecting the current order.", "properties": { "Limit": { "properties": { "k": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "k" ], "type": "object" } }, "required": [ "Limit" ], "type": "object" } ] }, "ResDef_Query_OpeEstimatorKind": { "description": "Which off-policy estimator an evaluation runs.", "enum": [ "ips", "clipped_ips", "snips", "switch", "doubly_robust" ], "type": "string" }, "ResDef_Query_OperationEnvelope": { "additionalProperties": false, "description": "The verified authority one caller operation was admitted under.", "properties": { "authority": { "$ref": "#/components/schemas/ResDef_Query_AuthorityContext", "description": "The complete attempt-specific authority: nonce, request/trace id, issue\nand expiry, catalog digest, actor, audience, tenant, authority scope,\npurpose, policy revision/epoch/digest and the caller's idempotency key." }, "canonical_payload_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256", "description": "A digest over the operation CONTENT alone -- scope, operations, outbox\nintents and any authoritative-state digest. It deliberately excludes the\nOCC expectation, the route (placement epoch / fencing token), the batch\nid, timestamps and the request/trace ids, because a second attempt of the\nsame operation legitimately re-observes all of them." }, "method": { "description": "The one method this operation is. For a multi-operation batch it is the\nreserved batch descriptor id and every member's method is folded into\n`canonical_payload_digest` instead.", "type": "string" }, "method_schema_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "method_schema_id": { "type": "string" }, "serving_principal": { "description": "The principal the COMMITTING LEDGER requires -- for every domain, the\nstore's serving principal (RF-RULING-004 application note). Caller\nattribution is the outbox `actor` header and lives nowhere else.", "type": "string" }, "verified_capabilities": { "description": "Capabilities verified at the authenticated admission boundary. Attempt\nfacts, not identity: they gate `VersionExpectation::Unversioned` and are\ndeliberately outside `OperationReplayIdentity`.", "items": { "$ref": "#/components/schemas/ResDef_Query_MutationCapability" }, "type": "array", "uniqueItems": true } }, "required": [ "authority", "method", "method_schema_id", "method_schema_digest", "canonical_payload_digest", "serving_principal", "verified_capabilities" ], "type": "object" }, "ResDef_Query_OptimiserSpec": { "additionalProperties": false, "description": "Deterministic optimiser limits. The seed is part of the request, so a fit\nis reproducible from its record.", "properties": { "max_iterations": { "format": "uint32", "minimum": 0, "type": "integer" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" }, "tolerance": { "$ref": "#/components/schemas/ResDef_Query_QuantisedValue" } }, "required": [ "max_iterations", "tolerance", "seed" ], "type": "object" }, "ResDef_Query_Order": { "description": "A single order in the book (matched by `eg-compute::finance::exchange`).", "properties": { "id": { "type": "string" }, "price": { "format": "double", "type": "number" }, "quantity": { "format": "double", "type": "number" }, "side": { "type": "string" }, "timestamp": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "id", "side", "price", "quantity", "timestamp" ], "type": "object" }, "ResDef_Query_OutboxPositionView": { "additionalProperties": false, "description": "One position in an outbox, exactly as the kernel orders rows.", "properties": { "batch_id": { "type": "string" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "ordinal": { "format": "uint32", "minimum": 0, "type": "integer" }, "sequence": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sequence", "created_at_ms", "batch_id", "ordinal" ], "type": "object" }, "ResDef_Query_OutboxTarget": { "description": "Which outbox an operation names.", "oneOf": [ { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "target": { "const": "graph", "type": "string" } }, "required": [ "target", "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "store": { "$ref": "#/components/schemas/ResDef_Query_NativeOutboxStore" }, "target": { "const": "native_store", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "target", "store", "tenant_id" ], "type": "object" } ] }, "ResDef_Query_OutcomeArtifactRef": { "additionalProperties": false, "description": "One immutable, content-addressed artifact reference a\n[`CommitOutcomeBundle`] carries. The bundle never embeds artifact bytes \u2014\nonly a bounded reference/digest pair, mirroring\n[`crate::commit_descriptor::CommitDescriptor`]'s \"digests cover canonical\nencoded participant bytes, never mutable pointers or raw content\" rule.", "properties": { "artifact_ref": { "description": "Opaque CAS/artifact reference (never a raw filesystem path or URL).", "type": "string" }, "classification": { "description": "GOC-16 classification label carried alongside the reference so a\nprojection can enforce policy without a second lookup.", "type": "string" }, "digest": { "description": "sha256 digest of the artifact's canonical encoded bytes.", "type": "string" }, "kind": { "description": "Caller-defined artifact kind (e.g. `\"document\"`, `\"table\"`, `\"log\"`).", "type": "string" }, "size_bytes": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "artifact_ref", "digest", "kind", "size_bytes", "classification" ], "type": "object" }, "ResDef_Query_OutcomeCompleteness": { "description": "Terminal completeness state of a committed [`CommitOutcomeBundle`]\n(lane doc \"Authority and invariants\" + the decision record's \"Completeness\nsemantics\"). Distinct from [`crate::commit_descriptor::CommitStatus`]:\nthat enum describes the CROSS-DOMAIN COMMIT's own prepare/publish\nlifecycle; this one describes whether the WorkItem's REQUIRED provenance\nspecifically landed once the commit itself succeeded.", "oneOf": [ { "const": "complete", "description": "The authoritative outcome AND every required provenance node/edge\n(RunTrace, OutcomeEvaluation, and the full ToolCall set when the run\nmade tool calls) are durably committed. Never claimed on the strength\nof the outcome commit alone.", "type": "string" }, { "const": "degraded", "description": "The authoritative outcome committed, but one or more required\nprovenance components did not. Always carries a non-empty\n`missing_refs` naming which ones.", "type": "string" }, { "const": "reconciling", "description": "A `Degraded` outcome a reconciler has claimed and is actively\nrepairing. Repair is idempotent and MUST NOT alter `result_digest`.", "type": "string" } ] }, "ResDef_Query_OutcomeEvaluation": { "additionalProperties": false, "description": "The independent evaluation behind a bandit label.", "properties": { "class": { "$ref": "#/components/schemas/ResDef_Query_EvidenceClass" }, "evaluation_id": { "type": "string" }, "fidelity": { "$ref": "#/components/schemas/ResDef_Query_OutcomeFidelity" }, "lease_holder": { "description": "The lease holder that ran it; likewise excluded as a producer.", "type": "string" }, "producer": { "type": "string" }, "selected_agent": { "description": "The agent the decision selected; a label it produced itself is a\nself-report.", "type": "string" }, "success": { "default": null, "description": "`None` is a censored run: neither a success nor a failure.", "type": [ "boolean", "null" ] } }, "required": [ "evaluation_id", "class", "producer", "selected_agent", "lease_holder", "fidelity" ], "type": "object" }, "ResDef_Query_OutcomeFidelity": { "description": "How completely the evaluated run was traced, plus the censored states.", "enum": [ "full_step", "tool_calls", "final_output", "trace_incomplete", "outcome_uncertain", "cancelled" ], "type": "string" }, "ResDef_Query_PackAnnotations": { "additionalProperties": false, "description": "Everything one entry declares beyond its bytes.", "properties": { "contract_version": { "default": null, "type": [ "string", "null" ] }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_DeclaredCost" }, { "type": "null" } ], "default": null }, "destructive_hint": { "default": null, "type": [ "boolean", "null" ] }, "idempotent_hint": { "default": null, "type": [ "boolean", "null" ] }, "latency_declared": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_DeclaredLatency" }, { "type": "null" } ], "default": null }, "modalities_in": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64", "default": [] }, "modalities_out": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64", "default": [] }, "model": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_PackModelFacts" }, { "type": "null" } ], "default": null }, "open_world_hint": { "default": null, "type": [ "boolean", "null" ] }, "provides": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64", "default": [] }, "read_only_hint": { "default": null, "type": [ "boolean", "null" ] }, "required_scopes": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64", "default": [] }, "requires_capabilities": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64", "default": [] }, "sdk_contract_pin": { "default": null, "description": "The SDK contract the publisher pinned. Stored as a claim ATTRIBUTE\nrather than a typed fact: the engine cannot recompute the SDK's own\nnormalization, so it can record the string and must not pretend to have\nchecked it.", "type": [ "string", "null" ] } }, "type": "object" }, "ResDef_Query_PackArchiveRef": { "additionalProperties": false, "description": "Where the archive lives and what it must hash to.", "properties": { "blob_digest": { "description": "The engine blob reference the archive was uploaded under.", "type": "string" }, "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "sha256": { "$ref": "#/components/schemas/ResDef_Query_Digest256" } }, "required": [ "blob_digest", "length", "sha256" ], "type": "object" }, "ResDef_Query_PackEntry": { "additionalProperties": false, "description": "One published entry of a pack.", "properties": { "annotations": { "$ref": "#/components/schemas/ResDef_Query_PackAnnotations", "default": { "contract_version": null, "cost": null, "destructive_hint": null, "idempotent_hint": null, "latency_declared": null, "modalities_in": [], "modalities_out": [], "model": null, "open_world_hint": null, "provides": [], "read_only_hint": null, "required_scopes": [], "requires_capabilities": [], "sdk_contract_pin": null } }, "body": { "$ref": "#/components/schemas/ResDef_Query_PackSection" }, "input_schema": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_PackSection" }, { "type": "null" } ], "default": null }, "kind": { "$ref": "#/components/schemas/ResDef_Query_PackEntryKind" }, "media_type": { "type": "string" }, "name": { "type": "string" }, "output_schema": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_PackSection" }, { "type": "null" } ], "default": null }, "references": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_PackRef_64", "default": [] }, "uri": { "type": "string" } }, "required": [ "kind", "uri", "name", "media_type", "body" ], "type": "object" }, "ResDef_Query_PackEntryKind": { "description": "What one pack entry is.", "enum": [ "mcp_server", "tool", "skill", "prompt", "resource", "resource_template", "ontology", "shapes", "model_profile", "a2a_card", "manifest" ], "type": "string" }, "ResDef_Query_PackHeadRef": { "additionalProperties": false, "description": "The head a caller believes is current, for a compare-and-set import.", "properties": { "binding_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "pack_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" } }, "required": [ "binding_revision", "pack_digest" ], "type": "object" }, "ResDef_Query_PackModelFacts": { "additionalProperties": false, "description": "A model profile a pack publishes.\n\nThe three `supports_*` flags are tri-state here and `bool` on the component\nfacts, because absent is not false: a pack that leaves one out has said\nnothing, and importing that as `false` would silently make the model\nineligible. An entry with any of them absent is refused `INVALID_FACTS`\nrather than imported with an invented answer.", "properties": { "context_window_tokens": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_output_tokens": { "format": "uint64", "minimum": 0, "type": "integer" }, "model_identity": { "type": "string" }, "provider": { "type": "string" }, "supports_structured_output": { "default": null, "type": [ "boolean", "null" ] }, "supports_tools": { "default": null, "type": [ "boolean", "null" ] }, "supports_vision": { "default": null, "type": [ "boolean", "null" ] } }, "required": [ "provider", "model_identity", "context_window_tokens", "max_output_tokens" ], "type": "object" }, "ResDef_Query_PackProducer": { "additionalProperties": false, "description": "The tool that produced this pack.", "properties": { "name": { "type": "string" }, "version": { "type": "string" } }, "required": [ "name", "version" ], "type": "object" }, "ResDef_Query_PackRef": { "additionalProperties": false, "description": "A reference from one entry to another, by URI and kind.", "properties": { "kind": { "$ref": "#/components/schemas/ResDef_Query_PackEntryKind" }, "uri": { "type": "string" } }, "required": [ "uri", "kind" ], "type": "object" }, "ResDef_Query_PackSection": { "additionalProperties": false, "description": "One byte range of the archive, pinned by its own digest.", "properties": { "length": { "format": "uint64", "minimum": 0, "type": "integer" }, "offset": { "format": "uint64", "minimum": 0, "type": "integer" }, "sha256": { "$ref": "#/components/schemas/ResDef_Query_Digest256" } }, "required": [ "offset", "length", "sha256" ], "type": "object" }, "ResDef_Query_PipelineSpec": { "description": "The full composable pipeline recipe: ordered feature steps \u2192 split \u2192 model. Stored\n(minus the split) inside the `:Model` artifact so eval/predict rebuild features\nIDENTICALLY from the same recipe without the caller re-specifying it.", "properties": { "features": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_FeatureStep" }, "type": "array" }, "label_property": { "default": "", "description": "Node property holding the integer class label (node classification). Empty \u21d2\nlabels must be passed explicitly as `y`. Ignored by the `graphlearn` family\n(its labels are the observed edges).", "type": "string" }, "model": { "$ref": "#/components/schemas/ResDef_Query_ModelSpec" }, "split": { "$ref": "#/components/schemas/ResDef_Query_SplitSpec", "default": { "seed": 42, "shuffle": true, "test_ratio": 0.25 } } }, "required": [ "model" ], "type": "object" }, "ResDef_Query_PlacementAdminOp": { "description": "One operation on the placement-catalog admin surface (CONCEPT:EG-KG.sharding.placement-catalog-admin-rpc,\nDIST-P2-5). Nested under `Method::PlacementAdmin { op }` \u2014 mirrors\n[`crate::modality::ServedModalityOp`]'s \"one Method variant, many operations\" shape.", "oneOf": [ { "additionalProperties": false, "description": "Assign the WHOLE keyspace of `tenant` to `group` (the placement DECISION leg).\nCollapses any prior split. Returns `{\"epoch\": u64}` \u2014 the new routing epoch\nevery subsequent `PlacementRoute`/read observes immediately.", "properties": { "group": { "format": "uint64", "minimum": 0, "type": "integer" }, "operation": { "const": "assign", "type": "string" }, "tenant": { "type": "string" } }, "required": [ "operation", "tenant", "group" ], "type": "object" }, { "additionalProperties": false, "description": "Online-move `tenant`'s partition `[range_start, range_end]` to `target`.\nReturns a `PlacementMoveReport` JSON: `{tenant, range, target, epoch,\ngraphs: [{graph, from_group, to_group, nodes_transferred}]}`.", "properties": { "operation": { "const": "move", "type": "string" }, "range_end": { "format": "uint64", "minimum": 0, "type": "integer" }, "range_start": { "format": "uint64", "minimum": 0, "type": "integer" }, "target": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant": { "type": "string" } }, "required": [ "operation", "tenant", "range_start", "range_end", "target" ], "type": "object" }, { "additionalProperties": false, "description": "Abort an in-flight online move identified by `move_id` before its cutover\nfence. A move already past its epoch fence is rejected (roll-forward only,\nmatching `TenantManager::abort_move`'s in-process contract). Returns `Bool`.", "properties": { "move_id": { "type": "string" }, "operation": { "const": "abort_move", "type": "string" } }, "required": [ "operation", "move_id" ], "type": "object" } ] }, "ResDef_Query_PlacementRouteRequest": { "additionalProperties": false, "properties": { "client_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "partition_ref": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_PlacementRouteRequestSchemaVersion" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "partition_ref", "client_epoch" ], "type": "object" }, "ResDef_Query_PlacementRouteRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_Plan": { "description": "A logical plan: an ordered list of [`Op`]s over one `RowSet`. The serializable\nwire payload of `Method::UnifiedQuery` (CONCEPT:AU-KG.compute.vector).", "properties": { "ops": { "items": { "$ref": "#/components/schemas/ResDef_Query_Op" }, "type": "array" } }, "required": [ "ops" ], "type": "object" }, "ResDef_Query_PolicyRecord": { "description": "Policy rows carry an opaque subject-set digest, never raw principals.", "properties": { "classification": { "type": "string" }, "legal_hold": { "default": false, "type": "boolean" }, "object_id": { "type": "string" }, "operation": { "$ref": "#/components/schemas/ResDef_Query_MaterialOperation" }, "policy_id": { "type": "string" }, "policy_version": { "type": "string" }, "retention_policy": { "default": "", "type": "string" }, "subject_set_digest": { "type": "string" }, "tenant": { "type": "string" } }, "required": [ "policy_id", "operation", "object_id", "tenant", "classification", "policy_version", "subject_set_digest" ], "type": "object" }, "ResDef_Query_Pred": { "description": "A simple equality / range predicate over a node property, compiled to a SQL\n`WHERE` fragment and evaluated by the DataFusion FILTER leg in `eg-plan`.", "oneOf": [ { "additionalProperties": false, "description": "`prop == value` (string compare on the JSON-stringified value).", "properties": { "Eq": { "properties": { "prop": { "type": "string" }, "value": { "type": "string" } }, "required": [ "prop", "value" ], "type": "object" } }, "required": [ "Eq" ], "type": "object" }, { "additionalProperties": false, "description": "`prop > n` (numeric).", "properties": { "GtNum": { "properties": { "n": { "format": "double", "type": "number" }, "prop": { "type": "string" } }, "required": [ "prop", "n" ], "type": "object" } }, "required": [ "GtNum" ], "type": "object" }, { "additionalProperties": false, "description": "`prop < n` (numeric).", "properties": { "LtNum": { "properties": { "n": { "format": "double", "type": "number" }, "prop": { "type": "string" } }, "required": [ "prop", "n" ], "type": "object" } }, "required": [ "LtNum" ], "type": "object" }, { "additionalProperties": false, "description": "DOCUMENT/JSON \u2014 keep rows whose node property document satisfies a deep\nJSONPath predicate (CONCEPT:EG-KG.query.json-wire-roundtrip). `path` is a JSONPath (`$.a.b`, `$.a[0]`,\n`$.a[*]`, wildcard) evaluated against the row's decoded JSON; `op` is the\nexistence / equality / `@>`-containment test. This is the lowered form of the\nPostgres JSON operators (`->`, `->>`, `@>`, `jsonb_path_query`) and a Mongo-style\n`$match` \u2014 see `eg_query::sql::classify`. Like the spatial preds it is NOT lowered\nto SQL (DataFusion has no JSONPath): `eg-plan`'s FILTER leg splits it out and\napplies it per-row against the stored JSON, and the planner can consult eg-core's\ninverted path-index for candidate selectivity. PURE serde here (a string, a small\nenum, and a `serde_json::Value` literal \u2014 exactly as `CepAttrPredSpec` carries),\nso it is present whenever `query` is on and adds NO dependency.", "properties": { "JsonPath": { "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_JsonPathOp" }, "path": { "type": "string" } }, "required": [ "path", "op" ], "type": "object" } }, "required": [ "JsonPath" ], "type": "object" }, { "additionalProperties": false, "description": "SPATIAL \u2014 keep rows whose geometry (in node property `column`, stored as WKT)\nis spatially WITHIN the query geometry `wkt` (CONCEPT:EG-KG.ontology.singles-concept). Evaluated by\neg-geo's planar `within` in eg-plan (behind the `geo` feature) \u2014 NOT lowered to\nSQL (DataFusion has no spatial), so the FILTER leg splits spatial preds out and\napplies them per-row against the stored geometry. Gated by `geo` (implies\n`query`); pure serde here (only two strings).", "properties": { "SpatialWithin": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialWithin" ], "type": "object" }, { "additionalProperties": false, "description": "SPATIAL \u2014 keep rows whose geometry (node property `column`, WKT) lies within\nplanar `distance` of the query geometry `wkt` \u2014 an `ST_DWithin` (CONCEPT:EG-KG.ontology.singles-concept).\nEvaluated by eg-geo's planar `distance` in eg-plan. Gated by `geo`.", "properties": { "SpatialDWithin": { "properties": { "column": { "type": "string" }, "distance": { "format": "double", "type": "number" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt", "distance" ], "type": "object" } }, "required": [ "SpatialDWithin" ], "type": "object" }, { "additionalProperties": false, "description": "SPATIAL (DE-9IM, CONCEPT:EG-KG.ontology.de-9im-relations) \u2014 keep rows whose geometry (node property `column`,\nWKT) is topologically related to the query geometry `wkt` per the named DE-9IM\nrelation. Each mirrors [`Pred::SpatialWithin`] (two strings) and is evaluated per-row\nby eg-geo's `predicates` in eg-plan \u2014 NOT lowered to SQL. Gated by `geo`.\n\n`SpatialContains` = the row geometry CONTAINS the query geometry; `SpatialCovers`\nits boundary-inclusive superset; `SpatialTouches` boundary-only contact;\n`SpatialCrosses` interiors meeting in lower dimension; `SpatialOverlaps` same-dim\npartial overlap; `SpatialEquals` geometric equality; `SpatialDisjoint` no shared\npoint.", "properties": { "SpatialContains": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialContains" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialCovers": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialCovers" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialTouches": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialTouches" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialCrosses": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialCrosses" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialOverlaps": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialOverlaps" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialEquals": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialEquals" ], "type": "object" }, { "additionalProperties": false, "properties": { "SpatialDisjoint": { "properties": { "column": { "type": "string" }, "wkt": { "type": "string" } }, "required": [ "column", "wkt" ], "type": "object" } }, "required": [ "SpatialDisjoint" ], "type": "object" } ] }, "ResDef_Query_PremiseClass": { "description": "How strong one premise is.", "oneOf": [ { "const": "definition", "description": "True by the definition of the vocabulary.", "type": "string" }, { "const": "claim", "description": "Asserted by a producer that is not the engine.", "type": "string" }, { "const": "observation", "description": "Measured by a recorded evaluation.", "type": "string" }, { "const": "proof", "description": "Derived by a checkable rule from other premises.", "type": "string" } ] }, "ResDef_Query_PremiseProvenance": { "description": "Where a premise came from.", "oneOf": [ { "additionalProperties": false, "description": "The engine's own ontology, at the digest named.", "properties": { "ontology_digest": { "type": "string" }, "provenance": { "const": "native_ontology", "type": "string" } }, "required": [ "provenance", "ontology_digest" ], "type": "object" }, { "additionalProperties": false, "description": "The decision policy in force.", "properties": { "policy_digest": { "type": "string" }, "provenance": { "const": "policy", "type": "string" } }, "required": [ "provenance", "policy_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A component publisher's declaration at an exact revision.", "properties": { "component_id": { "type": "string" }, "definition_digest": { "type": "string" }, "provenance": { "const": "publisher", "type": "string" } }, "required": [ "provenance", "component_id", "definition_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A connector pack entry at an exact binding revision.", "properties": { "binding_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "connector": { "type": "string" }, "entry_digest": { "type": "string" }, "pack_digest": { "type": "string" }, "provenance": { "const": "connector_pack", "type": "string" } }, "required": [ "provenance", "connector", "binding_revision", "pack_digest", "entry_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A free-text-to-task mapping asserted by a producer.", "properties": { "producer": { "type": "string" }, "provenance": { "const": "claimed_mapping", "type": "string" }, "text_digest": { "type": "string" } }, "required": [ "provenance", "text_digest", "producer" ], "type": "object" }, { "additionalProperties": false, "description": "A recorded evaluation.", "properties": { "evaluation_id": { "type": "string" }, "provenance": { "const": "observation", "type": "string" } }, "required": [ "provenance", "evaluation_id" ], "type": "object" }, { "additionalProperties": false, "description": "The request itself: a requirement the caller stated in `field`.", "properties": { "field": { "type": "string" }, "provenance": { "const": "request", "type": "string" } }, "required": [ "provenance", "field" ], "type": "object" } ] }, "ResDef_Query_PremiseRef": { "additionalProperties": false, "description": "One fact the decision used.", "properties": { "class": { "$ref": "#/components/schemas/ResDef_Query_PremiseClass" }, "fact": { "type": "string" }, "provenance": { "$ref": "#/components/schemas/ResDef_Query_PremiseProvenance" }, "subject": { "type": "string" } }, "required": [ "subject", "fact", "class", "provenance" ], "type": "object" }, "ResDef_Query_PriceSource": { "description": "Who says what this costs.", "oneOf": [ { "additionalProperties": false, "description": "The model or tool publisher's own list price.", "properties": { "source": { "const": "publisher", "type": "string" } }, "required": [ "source" ], "type": "object" }, { "additionalProperties": false, "description": "A connector pack entry, pinned by the entry's digest.", "properties": { "connector": { "type": "string" }, "entry_digest": { "type": "string" }, "source": { "const": "connector_pack", "type": "string" } }, "required": [ "source", "connector", "entry_digest" ], "type": "object" }, { "additionalProperties": false, "description": "An operator override, with the reference that justifies it.", "properties": { "reference": { "type": "string" }, "source": { "const": "operator", "type": "string" } }, "required": [ "source", "reference" ], "type": "object" } ] }, "ResDef_Query_PrivacyAttestation": { "properties": { "policy_version": { "type": "string" }, "sanitized_payload_digest": { "type": "string" }, "sanitizer_version": { "type": "string" } }, "required": [ "policy_version", "sanitizer_version", "sanitized_payload_digest" ], "type": "object" }, "ResDef_Query_ProbEvidenceSpec": { "description": "PROBABILISTIC \u2014 the evidence for a conjugate Bayesian update carried by\n[`ProbQuery::Conditional`] (CONCEPT:EG-KG.compute.uncertainty-values). Mirrors `eg_compute::probabilistic::Evidence`,\nbut defined HERE (pure serde, no eg-compute dep) so the wire stays Pi-safe; the executor\nmaps it to eg-compute's enum behind eg-plan's `probabilistic` gate. `Bernoulli` counts\nare the sufficient statistic for a Beta prior; `Gaussian` observations (with a KNOWN\nlikelihood variance) for a Gaussian prior over the unknown mean.", "oneOf": [ { "properties": { "failures": { "format": "double", "type": "number" }, "kind": { "const": "bernoulli", "type": "string" }, "successes": { "format": "double", "type": "number" } }, "required": [ "kind", "successes", "failures" ], "type": "object" }, { "properties": { "kind": { "const": "gaussian", "type": "string" }, "known_variance": { "format": "double", "type": "number" }, "observations": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "kind", "observations", "known_variance" ], "type": "object" } ] }, "ResDef_Query_ProbQuery": { "description": "PROBABILISTIC \u2014 the probabilistic query carried by `Op::Probabilistic` (CONCEPT:EG-KG.compute.uncertainty-values):\none closed-form question asked of each row's stored `Distribution` VALUE.\n* `Expectation` \u2014 the mean `E[X]`.\n* `Marginal { at, label }` \u2014 the marginal probability: the density `pdf(at)` for the\n continuous variants, or the mass `pmf(label)` when `label` is set (a `Categorical`).\n* `Conditional { evidence }` \u2014 the posterior MEAN after a conjugate Bayesian update\n with `evidence` (the \"conditional\" query).\n* `Sample { seed }` \u2014 one DETERMINISTIC seeded draw (same seed \u21d2 same value; no\n RNG-from-clock, so a plan is reproducible).\n\nPURE serde \u2014 the distribution math lives in eg-types (`Distribution`) + eg-compute\n(`bayesian_update`) behind eg-plan's `probabilistic` gate; this is the wire variant.", "oneOf": [ { "properties": { "kind": { "const": "expectation", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "at": { "default": 0.0, "format": "double", "type": "number" }, "kind": { "const": "marginal", "type": "string" }, "label": { "default": null, "type": [ "string", "null" ] } }, "required": [ "kind" ], "type": "object" }, { "properties": { "evidence": { "$ref": "#/components/schemas/ResDef_Query_ProbEvidenceSpec" }, "kind": { "const": "conditional", "type": "string" } }, "required": [ "kind", "evidence" ], "type": "object" }, { "properties": { "kind": { "const": "sample", "type": "string" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "seed" ], "type": "object" } ] }, "ResDef_Query_PromptMode": { "description": "How a prompt's text is resolved.", "oneOf": [ { "const": "static", "description": "Fixed at publish time; `content_digest` pins the text itself.", "type": "string" }, { "const": "dynamic", "description": "Produced per run; `content_digest` can only pin the FUNCTION, so the\ntext the model saw must be bound again at resolution.", "type": "string" } ] }, "ResDef_Query_ProofNode": { "description": "One pre-order node of the search-tree proof.", "oneOf": [ { "additionalProperties": false, "properties": { "branch": { "additionalProperties": false, "properties": { "first": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ResDef_Query_VarId" } }, "required": [ "var", "first" ], "type": "object" } }, "required": [ "branch" ], "type": "object" }, { "additionalProperties": false, "properties": { "forced": { "additionalProperties": false, "properties": { "row": { "$ref": "#/components/schemas/ResDef_Query_RowId" }, "value": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ResDef_Query_VarId" } }, "required": [ "var", "value", "row" ], "type": "object" } }, "required": [ "forced" ], "type": "object" }, { "additionalProperties": false, "properties": { "leaf": { "additionalProperties": false, "properties": { "proof": { "$ref": "#/components/schemas/ResDef_Query_LeafProof" } }, "required": [ "proof" ], "type": "object" } }, "required": [ "leaf" ], "type": "object" } ] }, "ResDef_Query_PropensitySource": { "description": "Where a logged propensity came from.", "oneOf": [ { "const": "executed_policy", "description": "The executed policy's exact probability.", "type": "string" }, { "const": "head_mass", "description": "A head's score copied in as if it were a propensity. Never admissible.", "type": "string" } ] }, "ResDef_Query_QuantScaleTag": { "description": "The fixed-point scale a [`QuantisedValue`] is read on. Mirrors\n`eg_numeric`'s `QuantScale`.", "oneOf": [ { "const": "pico", "description": "`value / 10^12`.", "type": "string" }, { "const": "q32", "description": "`value / 2^32`.", "type": "string" } ] }, "ResDef_Query_QuantisedValue": { "additionalProperties": false, "description": "An exact fixed-point number: `value` read on `scale`.", "properties": { "scale": { "$ref": "#/components/schemas/ResDef_Query_QuantScaleTag" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "scale", "value" ], "type": "object" }, "ResDef_Query_QuantumOp": { "description": "The agent-facing quantum control-plane operation (Q8). Nested under\n`Method::Quantum { op }` \u2014 mirrors `acl::RbacAdminOp`/`jobs::JobOp`'s \"one Method\nvariant, many operations\" shape.", "oneOf": [ { "additionalProperties": false, "description": "Rank candidate items by a caller-supplied weight signal through a\ndeterministic amplitude-encoding + interference circuit. The agent NEVER\nsees qubits: it supplies `(id, weight)` pairs and a shot budget and gets\nback an ordering plus the full Q0 metadata. ALWAYS a proposal \u2014 see the\nmodule doc's exactness section.", "properties": { "backend_id": { "default": null, "description": "R5 escape hatch. Always honoured (if the named backend is registered),\nalways audited (Q9). `None` lets the planner choose (R0-R4) \u2014 the\ndefault agent experience, and the only path that needs no hardware\nquota check.", "type": [ "string", "null" ] }, "candidates": { "description": "One qubit per candidate (bounded server-side \u2014 see the facade's\n`MAX_RANK_CANDIDATES`; an oversized request is rejected outright, never\nsilently truncated).", "items": { "$ref": "#/components/schemas/ResDef_Query_QuantumRankCandidate" }, "type": "array" }, "operation": { "const": "rank", "type": "string" }, "seed": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "operation", "candidates" ], "type": "object" }, { "additionalProperties": false, "description": "Run ONE fixed-parameter QAOA layer set over a caller-supplied Max-Cut\ninstance (candidate node ids + weighted edges) and return a sampled cut\nassignment. NOT a variational optimizer loop \u2014 no classical outer loop, one\nevaluation at a canonical fixed angle schedule. ALWAYS a proposal.", "properties": { "backend_id": { "default": null, "type": [ "string", "null" ] }, "edges": { "items": { "$ref": "#/components/schemas/ResDef_Query_QuantumQaoaEdge" }, "type": "array" }, "nodes": { "items": { "type": "string" }, "type": "array" }, "operation": { "const": "optimize_qaoa", "type": "string" }, "p_layers": { "default": 1, "format": "uint32", "minimum": 0, "type": "integer" }, "seed": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "operation", "nodes", "edges" ], "type": "object" }, { "additionalProperties": false, "description": "Compute a sampled Pauli-Z-string expectation value over a caller-supplied\n`QuantumProgram` (native IR, JSON-encoded exactly like\n`eg_quantum_core::ir::QuantumProgram`'s own serde round-trip \u2014\n`eg-quantum-core`'s `qasm` module or the IR's own JSON shape both produce\nsomething this field accepts directly). `observable_qubits` names the\nZ-observable's support; every qubit in it MUST already be measured into a\nclassical bit by `program` (the facade validates this and rejects\notherwise \u2014 it never silently appends measurements to a caller's circuit).\nRestricted to Pauli-Z strings in Q8 v0 \u2014 X/Y support (via basis-rotation\ngates prepended before measurement) is a straightforward follow-up, not\nattempted here to keep the exactness/observability wiring the focus of this\nlane.", "properties": { "backend_id": { "default": null, "type": [ "string", "null" ] }, "observable_qubits": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "type": "array" }, "operation": { "const": "expectation", "type": "string" }, "program": true, "seed": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "shots": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "operation", "program", "observable_qubits" ], "type": "object" } ] }, "ResDef_Query_QuantumQaoaEdge": { "description": "One weighted edge of the Max-Cut instance [`QuantumOp::OptimizeQaoa`] builds its\ncost Hamiltonian from. `source`/`target` reference `nodes` by value, not index \u2014\nstable across a caller re-ordering `nodes`.", "properties": { "source": { "type": "string" }, "target": { "type": "string" }, "weight": { "default": 1.0, "format": "double", "type": "number" } }, "required": [ "source", "target" ], "type": "object" }, "ResDef_Query_QuantumRankCandidate": { "description": "One candidate item for [`QuantumOp::Rank`], with the classical weight/score\nsignal the ranking circuit is built from.", "properties": { "id": { "type": "string" }, "weight": { "format": "double", "type": "number" } }, "required": [ "id", "weight" ], "type": "object" }, "ResDef_Query_QuestionKind": { "description": "What class of question this is. The kind selects the executor; it never\nselects the guarantee.", "enum": [ "route", "rank", "classify", "resolve_entity", "schema_mapping", "template_choice", "retrieval_plan", "ingestion_lane", "enrichment_schedule" ], "type": "string" }, "ResDef_Query_QuestionSafety": { "description": "What is at stake. Exploration is permitted only for\n[`QuestionSafety::Ordinary`]; everything else must be decided on evidence\nalready in hand or abstained.", "enum": [ "ordinary", "security", "policy", "write_back", "irreversible" ], "type": "string" }, "ResDef_Query_RankByProvenanceResult": { "description": "Materialized result of a `Method::RankByProvenance` run, highest score first.\nReturned via `ResultPayload::raw`.", "properties": { "ranked": { "items": { "$ref": "#/components/schemas/ResDef_Query_RankedResultWire" }, "type": "array" } }, "required": [ "ranked" ], "type": "object" }, "ResDef_Query_RankWeightsWire": { "description": "Wire mirror of `eg_epistemic::RankWeights` (EPI-P3-3) \u2014 weights combining\nsimilarity with the evidence-quality/provenance signal for `RankByProvenance`.\nDefaults to `{ similarity: 0.5, evidence_quality: 0.5 }`, the SAME\nequal-weighting default `eg_epistemic::RankWeights::default()` uses.", "properties": { "evidence_quality": { "format": "double", "type": "number" }, "similarity": { "format": "double", "type": "number" } }, "required": [ "similarity", "evidence_quality" ], "type": "object" }, "ResDef_Query_RankedResultWire": { "description": "Wire mirror of `eg_epistemic::RankedResult` (EPI-P3-3) \u2014 one ranked candidate:\nthe final blended score plus its components, kept separate for explainability.", "properties": { "evidence_quality": { "format": "double", "type": "number" }, "id": { "type": "string" }, "score": { "format": "double", "type": "number" }, "similarity": { "format": "double", "type": "number" } }, "required": [ "id", "score", "similarity", "evidence_quality" ], "type": "object" }, "ResDef_Query_RbacAction": { "description": "An action a grant permits or denies over a resource (CONCEPT:EG-KG.compute.feature).", "enum": [ "Read", "Write", "Admin" ], "type": "string" }, "ResDef_Query_RbacAdminOp": { "description": "A single administrative mutation of the RBAC policy (CONCEPT:EG-KG.compute.feature), carried by\n`Method::RbacAdmin`. Unconditional so it sits below the `isolation` layer.", "oneOf": [ { "additionalProperties": false, "properties": { "AddRole": { "$ref": "#/components/schemas/ResDef_Query_Role" } }, "required": [ "AddRole" ], "type": "object" }, { "additionalProperties": false, "properties": { "RemoveRole": { "type": "string" } }, "required": [ "RemoveRole" ], "type": "object" }, { "additionalProperties": false, "properties": { "AddGrant": { "$ref": "#/components/schemas/ResDef_Query_Grant" } }, "required": [ "AddGrant" ], "type": "object" }, { "additionalProperties": false, "properties": { "RemoveGrant": { "$ref": "#/components/schemas/ResDef_Query_Grant" } }, "required": [ "RemoveGrant" ], "type": "object" }, { "const": "List", "description": "Read-only: list the current roles + grants.", "type": "string" } ] }, "ResDef_Query_ReceiptNode": { "additionalProperties": false, "description": "A graph node that is co-committed with one terminal result.\n\nThe `properties_msgpack` bytes are the same bounded `AddNode` payload the\nexisting native B9 applier accepts. The digest is checked against those\nbytes, while every identity/fence/outbox field is checked against the\nenclosing [`CommitOutcomeBundle`]. Consequently a schema-valid node from\nanother WorkItem or lease cannot be smuggled into the batch.", "properties": { "delegation_id": { "type": "string" }, "fence_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_ReceiptNodeKind" }, "node_id": { "type": "string" }, "outbox_id": { "type": "string" }, "payload_digest": { "description": "SHA-256 of the canonical `properties_msgpack` bytes.", "type": "string" }, "payload_ref": { "description": "Opaque CAS/ref-store identity for the redacted node payload.", "type": "string" }, "properties_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "result_ref": { "type": [ "string", "null" ] }, "run_id": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "node_id", "kind", "delegation_id", "work_item_id", "run_id", "fence_token", "outbox_id", "payload_ref", "payload_digest", "properties_msgpack" ], "type": "object" }, "ResDef_Query_ReceiptNodeKind": { "description": "Receipt node kinds that may ride alongside a terminal WorkItem result.\nEvery node uses the existing graph node payload shape; this type only binds\nits identity and bounded property bytes to the terminal commit.", "enum": [ "run_trace", "tool_call", "outcome_evaluation" ], "type": "string" }, "ResDef_Query_RecomputeMaterializationResult": { "description": "Materialized result of a fenced `Method::RecomputeMaterialization` writeback.\nAll identifiers are domain-separated opaque projection references.", "properties": { "depends_on": { "items": { "type": "string" }, "type": "array" }, "fence_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "generating_activity": { "type": [ "string", "null" ] }, "id": { "type": "string" }, "projection_pending": { "description": "`true` when the authoritative recompute intent is committed but its local\ndurable projection image has not yet been acknowledged by the outbox worker.", "type": "boolean" }, "source_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "status": { "type": "string" } }, "required": [ "id", "depends_on", "status", "source_graph_version", "fence_epoch", "projection_pending" ], "type": "object" }, "ResDef_Query_ReconciliationObservation": { "additionalProperties": false, "properties": { "change_set_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "change_set_id": { "type": "string" }, "connector_observation_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "effect_status": { "$ref": "#/components/schemas/ResDef_Query_WriteBackEffectStatus" }, "evidence_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "idempotency_key": { "type": "string" }, "observed_source_version": { "type": "string" }, "provenance_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "retry_allowed": { "type": "boolean" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "change_set_id", "change_set_digest", "idempotency_key", "observed_source_version", "effect_status", "retry_allowed", "evidence_digest", "connector_observation_digest", "provenance_digest" ], "type": "object" }, "ResDef_Query_RecordWindow": { "additionalProperties": false, "description": "The closed record window a job reads.", "properties": { "from_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "to_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "from_ms", "to_ms" ], "type": "object" }, "ResDef_Query_RedactedJustificationNodeWire": { "description": "Wire mirror of `eg_epistemic::redact::RedactedProofNode` \u2014 structurally parallel to\n[`JustificationNodeWire`], except `claim` is `None` (with `redaction_label` set)\nwhen the requesting actor's RLS access does not extend to that proof-tree node.", "properties": { "claim": { "type": [ "string", "null" ] }, "confidence": { "format": "double", "type": "number" }, "premises": { "items": { "$ref": "#/components/schemas/ResDef_Query_RedactedJustificationNodeWire" }, "type": "array" }, "redaction_label": { "type": [ "string", "null" ] }, "rule": { "type": "string" } }, "required": [ "rule", "confidence", "premises" ], "type": "object" }, "ResDef_Query_ReduceAlgorithm": { "description": "Which reduction engine `MineReduce` runs (CONCEPT:EG-KG.mining.truncated-svd).", "oneOf": [ { "const": "svd", "description": "Truncated SVD (default) \u2014 unsupervised linear projection.", "type": "string" }, { "const": "lda", "description": "Fisher LDA \u2014 supervised (needs labels).", "type": "string" }, { "const": "umap", "description": "UMAP layout.", "type": "string" }, { "const": "tsne", "description": "t-SNE embedding.", "type": "string" } ] }, "ResDef_Query_RegisteredServerCursor": { "additionalProperties": false, "description": "Stable continuation over one complete live registry snapshot.", "properties": { "after_name": { "description": "Exclusive server-name lower bound for the next page.", "type": "string" }, "registry_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256", "description": "Canonical digest of every live, visible typed server in that image." }, "registry_revision": { "description": "`GraphCore::version()` of the `__commons__` image that produced the page.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "after_name", "registry_revision", "registry_digest" ], "type": "object" }, "ResDef_Query_RegisteredServerListRequest": { "additionalProperties": false, "description": "Request for a bounded page of registered servers.", "properties": { "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_RegisteredServerCursor" }, { "type": "null" } ], "default": null }, "limit": { "default": null, "description": "`None` selects the maximum/default page size of 256.", "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "ResDef_Query_Relation": { "description": "Relation of a linear row's left-hand side to its right-hand side.", "oneOf": [ { "const": "less_equal", "description": "`\u03a3 a\u00b7x \u2264 rhs`.", "type": "string" }, { "const": "greater_equal", "description": "`\u03a3 a\u00b7x \u2265 rhs`.", "type": "string" }, { "const": "equal", "description": "`\u03a3 a\u00b7x = rhs`.", "type": "string" } ] }, "ResDef_Query_RequestContext": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "audience": { "type": "string" }, "authentication_method": { "$ref": "#/components/schemas/ResDef_Query_RequestContextAuthenticationMethod" }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "type": "string" }, "issued_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "placement_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "policy_version": { "type": "string" }, "request_id": { "type": "string" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_RequestContextSchemaVersion" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "subject_id": { "type": "string" }, "tenant_id": { "type": "string" }, "trace_id": { "type": "string" } }, "required": [ "schema_version", "request_id", "subject_id", "tenant_id", "agent_id", "scopes", "audience", "authentication_method", "policy_version", "graph", "trace_id", "issued_at_ms", "expires_at_ms" ], "type": "object" }, "ResDef_Query_RequestContextAuthenticationMethod": { "enum": [ "workload_identity", "oidc", "mutual_tls", "local_process" ], "type": "string" }, "ResDef_Query_RequestContextClaims": { "additionalProperties": false, "description": "Identity and policy claims carried by a verified request-context envelope.\n\nThis is the wire representation only. Callers must not treat a deserialized\nvalue as trusted until the server has verified the envelope MAC, deployment\naudience/tenant/policy version, request binding, and delegation chain. The\nserver exposes a separate, non-constructible `VerifiedRequestContext` wrapper\nafter those checks succeed.", "properties": { "agent_id": { "description": "Effective agent identity used for ACL/RBAC decisions.", "type": "string" }, "audience": { "description": "Intended service audience.", "type": "string" }, "delegation": { "description": "Ordered delegation path from `principal` to `agent_id` (inclusive).\nEmpty means no delegation and therefore requires principal == agent_id.", "items": { "type": "string" }, "type": "array" }, "node": { "description": "Target node id this envelope was minted for (ADR-3 / W1.9 node-bound\nenvelopes \u2014 ``reports/wave1/ADR-scale-trio.md``). `None` for a client\nthat predates node binding, or one that has not yet learned a target\nnode id; a single-node deployment never needs to set this. When\n`Some(id)`, the server exact-matches it against the receiving node's\nown identity before dispatch (`server::auth::validate_context_claims`)\n\u2014 a mismatch means the envelope was captured and replayed against a\ndifferent cluster member. `#[serde(default)]` so an envelope minted by\na client that has never heard of this claim deserializes exactly as\nbefore (absent, not a hard error).", "type": [ "string", "null" ] }, "policy_version": { "description": "Exact policy bundle/version under which the context was issued.", "type": "string" }, "principal": { "description": "Authenticated subject that originated the request.", "type": "string" }, "priority": { "description": "Advisory QoS admission-priority class this request declares (W2.4 \u2014\nengine-native QoS lanes). One of the agent-utilities `PriorityClass`\nwire values `\"interactive\"` / `\"orchestration\"` / `\"hydration\"` /\n`\"background_ingestion\"`; any other or absent value is treated as the\norchestration default (high, never starved \u2014 matching au's\nuntagged-context semantics). Mapped to a [`crate`]-independent admission\nclass by the server's QoS scheduler (`server::qos::QosClass`).\n\nIt is **MAC-covered** (appended to `build_envelope_v2_bytes` as a\ndistinct tag-`2` optional trailer, after the tag-`1` node trailer) so a\nnoisy principal cannot forge a higher class to defeat the admission\nordering \u2014 the priority is bound to the signed envelope exactly like\nevery other claim. `#[serde(default)]` + presence-gated encoding keep an\nenvelope minted by a client that predates this claim byte-for-byte\nidentical to before (absent, not a hard error) \u2014 fully additive.", "type": [ "string", "null" ] }, "roles": { "description": "Identity-provider roles asserted for policy evaluation/audit.", "items": { "type": "string" }, "type": "array" }, "scopes": { "description": "Fine-grained capabilities asserted for policy evaluation/audit.", "items": { "type": "string" }, "type": "array" }, "tenant": { "description": "Tenant security boundary selected by the deployment.", "type": "string" } }, "required": [ "principal", "tenant", "audience", "agent_id", "roles", "scopes", "policy_version", "delegation" ], "type": "object" }, "ResDef_Query_RequestContextSchemaVersion": { "enum": [ "2" ], "type": "string" }, "ResDef_Query_ResolutionKind": { "description": "How the conclusion was reached.", "enum": [ "constraint", "entailment", "optimization", "statistical", "abstention" ], "type": "string" }, "ResDef_Query_ResolveConflictResult": { "description": "Materialized result of a `Method::ResolveConflict` run (EPI-P3-7). `semantics`\nechoes the request. Every id in the request's `node_ids` appears in EXACTLY ONE\nof `surviving`/`defeated`/`undecided`:\n\n* `grounded`: `surviving` = the unique grounded extension's members (IN);\n `defeated` = attacked by an IN argument (OUT); `undecided` = neither (caught in\n an unresolved/paraconsistent conflict, e.g. an odd attack cycle).\n* `preferred`/`stable`: `surviving` = in EVERY computed extension (unanimous\n across every admissible \"side\"); `defeated` = in NO extension (never\n credulously acceptable); `undecided` = in SOME but not all (contested), or\n every requested id when NO extension exists at all (a legitimate `stable`\n result, or the crate's own NP-hardness cap firing on a large graph \u2014 see\n `eg_epistemic::tms` module docs; never a fabricated verdict either way).\n\n`extension_sets` is the raw extension(s) the verdict was computed from, over the\nWHOLE graph (not filtered to `node_ids`): exactly one entry for `grounded`,\nzero-or-more for `preferred`/`stable`. Returned via `ResultPayload::raw`.", "properties": { "defeated": { "items": { "type": "string" }, "type": "array" }, "extension_sets": { "items": { "items": { "type": "string" }, "type": "array" }, "type": "array" }, "semantics": { "type": "string" }, "surviving": { "items": { "type": "string" }, "type": "array" }, "undecided": { "items": { "type": "string" }, "type": "array" } }, "required": [ "semantics", "surviving", "defeated", "undecided", "extension_sets" ], "type": "object" }, "ResDef_Query_ResolvedArtifactWire": { "description": "Wire mirror of `eg_alignment::ResolvedArtifact` (SURPASS gap-closure: \"unify the\ntwo evidence resolvers\", \"real crop/slice codecs\"). `kind` is `\"text\"` (a real\nexcerpt \u2014 currently `CharacterRange` by character range, `CodeSymbol` by line\nrange), `\"blob\"` (an address that is itself an intentionally opaque, versioned\npointer \u2014 e.g. `RowVersion`/`TraceSpan` \u2014 where the real CAS digest IS the exact\nresult), or `\"unresolved\"` (GOC-05 gate 3: an address that promises a region/\ninterval but has no registered decoder yet \u2014 the honest typed outcome instead of\nsilently reporting a raw digest as if it were that region; see `reason`).", "properties": { "blob_ref": { "description": "The real CAS digest, when `kind == \"blob\"`.", "type": [ "string", "null" ] }, "excerpt": { "description": "The resolved excerpt, when `kind == \"text\"`.", "type": [ "string", "null" ] }, "kind": { "description": "`\"text\"`, `\"blob\"`, or `\"unresolved\"`.", "type": "string" }, "note": { "description": "A human-readable note on what the `blob` reference represents, when\n`kind == \"blob\"`.", "type": [ "string", "null" ] }, "reason": { "default": null, "description": "The typed unresolved reason (`missing_rendition` / `codec_unavailable` /\n`policy_denied` / `corrupt_bytes` / `out_of_range`), when\n`kind == \"unresolved\"`.", "type": [ "string", "null" ] }, "subject_ref": { "type": "string" } }, "required": [ "kind", "subject_ref" ], "type": "object" }, "ResDef_Query_ResourceCapacity": { "additionalProperties": false, "properties": { "cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "process_slots": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cpu_weight", "memory_mib", "disk_mib", "process_slots" ], "type": "object" }, "ResDef_Query_ResourceHostUpdateRequest": { "additionalProperties": false, "properties": { "capacity": { "$ref": "#/components/schemas/ResDef_Query_ResourceCapacity" }, "disk_capacity_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_used_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "draining": { "type": "boolean" }, "heartbeat_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "heartbeat_ttl_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "labels": { "items": { "type": "string" }, "type": "array" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "observed": { "$ref": "#/components/schemas/ResDef_Query_ResourceCapacity" }, "quarantined": { "type": "boolean" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_ResourceHostUpdateRequestSchemaVersion" }, "target_alias": { "type": [ "string", "null" ] }, "target_kind": { "$ref": "#/components/schemas/ResDef_Query_ResourceHostUpdateRequestTargetKind" }, "tenant_ref": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "host_ref", "revision", "capacity", "observed", "heartbeat_at_ms", "heartbeat_ttl_ms", "now_ms", "draining", "quarantined", "labels", "target_kind", "disk_used_mib", "disk_capacity_mib" ], "type": "object" }, "ResDef_Query_ResourceHostUpdateRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_ResourceHostUpdateRequestTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ResDef_Query_ResourceRequirement": { "additionalProperties": false, "properties": { "cpu_weight": { "format": "uint64", "minimum": 0, "type": "integer" }, "disk_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "memory_mib": { "format": "uint64", "minimum": 0, "type": "integer" }, "process_slots": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "cpu_weight", "memory_mib", "disk_mib", "process_slots" ], "type": "object" }, "ResDef_Query_ResourceReservationRequest": { "additionalProperties": false, "properties": { "anti_affinity": { "items": { "type": "string" }, "type": "array" }, "attempt": { "format": "uint64", "minimum": 0, "type": "integer" }, "branch": { "type": "string" }, "branch_exclusive": { "type": "boolean" }, "concurrency_key": { "type": "string" }, "concurrency_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_high_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_low_watermark_mib": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "disk_policy_key": { "type": "string" }, "expected_host_revision": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "expected_lifecycle_revision": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "fairness_cost": { "format": "uint64", "minimum": 0, "type": "integer" }, "fairness_group": { "type": "string" }, "fence": { "type": "string" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "host_ref": { "type": "string" }, "idempotency_key": { "type": "string" }, "input_fingerprint": { "type": "string" }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": "string" }, "profile_name": { "type": "string" }, "profile_version": { "type": "string" }, "repository_exclusive": { "type": "boolean" }, "repository_id": { "type": "string" }, "required_labels": { "items": { "type": "string" }, "type": "array" }, "requirement": { "$ref": "#/components/schemas/ResDef_Query_ResourceRequirement" }, "reservation_id": { "type": "string" }, "reserved_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_ResourceReservationRequestSchemaVersion" }, "target_alias": { "type": [ "string", "null" ] }, "target_kind": { "$ref": "#/components/schemas/ResDef_Query_ResourceReservationRequestTargetKind" }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "tenant_ref", "work_item_id", "owner_id", "fence", "lease_epoch", "fencing_token", "attempt", "reservation_id", "input_fingerprint", "profile_name", "profile_version", "host_ref", "requirement", "target_kind", "repository_id", "branch", "concurrency_key", "repository_exclusive", "branch_exclusive", "required_labels", "anti_affinity", "fairness_group", "fairness_cost", "disk_policy_key", "reserved_at_ms", "expires_at_ms", "idempotency_key", "now_ms" ], "type": "object" }, "ResDef_Query_ResourceReservationRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_ResourceReservationRequestTargetKind": { "enum": [ "local", "inventory_alias" ], "type": "string" }, "ResDef_Query_ResourceReservationStatusRequest": { "additionalProperties": false, "properties": { "attempt": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "cursor": { "type": [ "string", "null" ] }, "fairness_group": { "type": [ "string", "null" ] }, "fence": { "type": [ "string", "null" ] }, "fencing_token": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "host_ref": { "type": [ "string", "null" ] }, "input_fingerprint": { "type": [ "string", "null" ] }, "lease_epoch": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "limit": { "format": "uint64", "minimum": 0, "type": "integer" }, "now_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "owner_id": { "type": [ "string", "null" ] }, "reservation_id": { "type": [ "string", "null" ] }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_ResourceReservationStatusRequestSchemaVersion" }, "tenant_ref": { "type": "string" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "tenant_ref", "limit", "now_ms" ], "type": "object" }, "ResDef_Query_ResourceReservationStatusRequestSchemaVersion": { "enum": [ "1" ], "type": "string" }, "ResDef_Query_ResourceSelector": { "description": "What a [`Grant`] applies to (CONCEPT:EG-KG.compute.feature). Ordered by [`specificity`] so the\nevaluator can implement \"most-specific-resource wins\": a named graph beats a\nlabel, which beats a glob pattern, which beats \"all\".\n\n[`specificity`]: ResourceSelector::specificity", "oneOf": [ { "const": "All", "description": "Every resource (least specific).", "type": "string" }, { "additionalProperties": false, "description": "A glob over the graph name \u2014 a single optional leading and/or trailing `*`\nwildcard (e.g. `agent:*`, `*:private`, `*log*`).", "properties": { "Pattern": { "type": "string" } }, "required": [ "Pattern" ], "type": "object" }, { "additionalProperties": false, "description": "A node label.", "properties": { "Label": { "type": "string" } }, "required": [ "Label" ], "type": "object" }, { "additionalProperties": false, "description": "One named graph (most specific).", "properties": { "Graph": { "type": "string" } }, "required": [ "Graph" ], "type": "object" } ] }, "ResDef_Query_RetrievalCandidateWire": { "description": "Wire mirror of `eg_epistemic::RetrievalCandidate` (EPI-P3-3) \u2014 one candidate in\na `Method::RankByProvenance` request, before ranking.", "properties": { "calibration": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_CalibrationWire" }, { "type": "null" } ], "description": "`None` for a candidate with no evidence-graph backing (ranks on\nsimilarity/reliability/freshness alone \u2014 an honest \"unknown\", never a\nfabricated middling score)." }, "freshness": { "format": "double", "type": "number" }, "id": { "type": "string" }, "similarity": { "format": "double", "type": "number" }, "source_reliability": { "format": "double", "type": "number" } }, "required": [ "id", "similarity", "source_reliability", "freshness" ], "type": "object" }, "ResDef_Query_RetrievalTraceSpec": { "description": "One stored retrieval trace for `MineRetrievalQuality` (CONCEPT:EG-KG.mining.retrieval-quality):\nwhat a query actually retrieved (ranked) vs. what was actually relevant.", "properties": { "relevant": { "description": "Ground-truth relevant ids for this query.", "items": { "type": "string" }, "type": "array" }, "retrieved": { "description": "Ranked ids the retrieval actually returned.", "items": { "type": "string" }, "type": "array" } }, "required": [ "retrieved", "relevant" ], "type": "object" }, "ResDef_Query_RewindTarget": { "description": "Where a rewind puts the consumer's cursor.", "oneOf": [ { "additionalProperties": false, "description": "Re-deliver everything the outbox still retains.", "properties": { "to": { "const": "start", "type": "string" } }, "required": [ "to" ], "type": "object" }, { "additionalProperties": false, "properties": { "position": { "$ref": "#/components/schemas/ResDef_Query_OutboxPositionView" }, "to": { "const": "at", "type": "string" } }, "required": [ "to", "position" ], "type": "object" } ] }, "ResDef_Query_RiskMethod": { "description": "Which controlled procedure produced the risk statement.", "enum": [ "learn_then_test", "conformal_risk_control" ], "type": "string" }, "ResDef_Query_RiskStatement": { "additionalProperties": false, "description": "The risk guarantee an acted-on decision carries.", "properties": { "delta": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire", "description": "Failure probability of that control." }, "epsilon": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire", "description": "Risk level the procedure controls." }, "method": { "$ref": "#/components/schemas/ResDef_Query_RiskMethod" }, "n_calibration": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "method", "epsilon", "delta", "n_calibration" ], "type": "object" }, "ResDef_Query_Role": { "description": "A durable RBAC role with an optional set of parent roles forming a hierarchy\n(CONCEPT:EG-KG.compute.feature). A role transitively inherits every grant of its parents.", "properties": { "name": { "type": "string" }, "parents": { "default": [], "items": { "type": "string" }, "type": "array" } }, "required": [ "name" ], "type": "object" }, "ResDef_Query_RowId": { "description": "Index of a constraint (its position in [`ModelSpec::constraints`]). Every\nconstraint lowers to exactly one linear row, so this is also the row index.", "format": "uint32", "minimum": 0, "type": "integer" }, "ResDef_Query_RunEvent": { "additionalProperties": false, "description": "One durable projection event a [`CommitOutcomeBundle`]'s commit (or a\nrepair pass) publishes. Streaming/AG-UI/SSE/WebSocket/terminal/MCP\nsurfaces are projections of a sequence of these, never a second event\nauthority (lane doc \"Cursor/streaming semantics\").", "properties": { "capability_digest": { "type": "string" }, "carrier_digest": { "description": "Digest of the GOC-15 carrier/session this event was emitted under.", "type": "string" }, "catalog_digest": { "type": "string" }, "completeness": { "$ref": "#/components/schemas/ResDef_Query_OutcomeCompleteness" }, "cursor_token": { "description": "Opaque, resume-safe cursor token a stream consumer persists and\nreplays from \u2014 tenant/actor scoped, never crossing runs or audiences.", "type": "string" }, "delegation_id": { "type": "string" }, "delegator_id": { "type": "string" }, "event_sequence": { "description": "Same numeric authority as [`CommitOutcomeBundle::event_sequence`] \u2014\nnever a timestamp or opaque string (the decision record's explicit\nrule for every GOC-21/22/23/25/29/31 consumer).", "format": "uint64", "minimum": 0, "type": "integer" }, "executor_lease_actor": { "type": "string" }, "fence_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "kind": { "description": "Caller-defined event kind (e.g. `\"tool_call\"`, `\"outcome\"`,\n`\"degraded\"`, `\"reconciled\"`).", "type": "string" }, "missing_refs": { "default": [], "items": { "type": "string" }, "type": "array" }, "model_digest": { "type": "string" }, "outbox_id": { "type": "string" }, "outcome": { "type": "string" }, "outcome_ref": { "type": [ "string", "null" ] }, "payload_digest": { "description": "sha256 digest of this event's canonical encoded payload \u2014 the event\ncarries a reference/digest, never raw prompt/tool-argument content\n(GOC-16 classification applies upstream, at bundle-commit time).", "type": "string" }, "policy_digest": { "type": "string" }, "result_ref": { "type": [ "string", "null" ] }, "run_id": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "selected_agent_id": { "type": "string" }, "timestamp_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "tool_call_ref": { "type": [ "string", "null" ] }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "delegation_id", "delegator_id", "selected_agent_id", "executor_lease_actor", "outcome", "work_item_id", "run_id", "fence_token", "outbox_id", "capability_digest", "catalog_digest", "policy_digest", "model_digest", "event_sequence", "completeness", "kind", "payload_digest", "timestamp_ms", "cursor_token", "carrier_digest" ], "type": "object" }, "ResDef_Query_Scalar": { "description": "An exact 128-bit signed integer (objective values, bounds, multipliers).", "type": "string" }, "ResDef_Query_ScopeTenantId": { "description": "Validated tenant security boundary. Bytes are retained exactly as supplied.", "type": "string" }, "ResDef_Query_ScoredOption": { "additionalProperties": false, "description": "One scored option of an advisory answer.", "properties": { "option_id": { "type": "string" }, "probability": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, { "type": "null" } ], "default": null, "description": "Present only when the score is calibrated into a probability." }, "score": { "$ref": "#/components/schemas/ResDef_Query_QuantisedValue" } }, "required": [ "option_id", "score" ], "type": "object" }, "ResDef_Query_SemanticActivationTarget": { "additionalProperties": false, "properties": { "ann_index_identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticAnnIndexIdentity" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "composite_policy_digest": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index_identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticLexicalIndexIdentity" }, "source_revision": { "type": "string" }, "target_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "tenant_id": { "type": "string" }, "vector_target_id": { "type": "string" } }, "required": [ "tenant_id", "binding_id", "binding_digest", "generation", "source_revision", "vector_target_id", "lexical_index_identity", "ann_index_identity", "composite_policy_digest", "target_digest" ], "type": "object" }, "ResDef_Query_SemanticActivePointer": { "additionalProperties": false, "properties": { "activated_at": { "type": "string" }, "activation_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "ann_index_identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticAnnIndexIdentity" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "composite_policy_digest": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index_identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticLexicalIndexIdentity" }, "source_revision": { "type": "string" }, "tenant_id": { "type": "string" }, "vector_target_id": { "type": "string" } }, "required": [ "tenant_id", "binding_id", "binding_digest", "generation", "source_revision", "vector_target_id", "lexical_index_identity", "ann_index_identity", "composite_policy_digest", "activation_receipt_digest", "activated_at" ], "type": "object" }, "ResDef_Query_SemanticAnnIndexIdentity": { "additionalProperties": false, "properties": { "ann_index_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "dimension": { "format": "uint32", "minimum": 0, "type": "integer" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "method": { "$ref": "#/components/schemas/ResDef_Query_SemanticAnnIndexMethod" }, "model_digest": { "type": "string" }, "parameters_digest": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "method", "parameters_digest", "generation", "source_revision", "model_digest", "dimension", "purpose_id", "policy_digest", "ann_index_digest" ], "type": "object" }, "ResDef_Query_SemanticAnnIndexManifest": { "additionalProperties": false, "properties": { "artifact_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticAnnIndexIdentity" }, "source_revision": { "type": "string" }, "vector_count": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "binding_id", "binding_digest", "generation", "source_revision", "identity", "artifact_digest", "vector_count", "completed_receipt_digest", "completed_at" ], "type": "object" }, "ResDef_Query_SemanticAnnIndexMethod": { "enum": [ "hnsw", "ivf_pq" ], "type": "string" }, "ResDef_Query_SemanticAnnIndexSpec": { "additionalProperties": false, "description": "Pre-binding ANN configuration. It intentionally has no binding or final\nindex digest; both are derived only after the binding digest exists.", "properties": { "method": { "$ref": "#/components/schemas/ResDef_Query_SemanticAnnIndexMethod" }, "parameters_digest": { "type": "string" } }, "required": [ "method", "parameters_digest" ], "type": "object" }, "ResDef_Query_SemanticAuthorizationReceipt": { "additionalProperties": false, "properties": { "actor_scope": { "type": "string" }, "authorization_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "authorized_at": { "type": "string" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "effective_actor_scope": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "policy_decision_digest": { "type": "string" }, "policy_identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticPolicyIdentity" }, "purpose_id": { "type": "string" }, "scope": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageScope" }, "source_revision": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "actor_scope", "effective_actor_scope", "purpose_id", "policy_identity", "policy_decision_digest", "binding_id", "binding_digest", "generation", "scope", "source_revision", "authorized_at", "authorization_receipt_digest" ], "type": "object" }, "ResDef_Query_SemanticBindingDraft": { "additionalProperties": false, "description": "Caller-supplied fields; state and final digests are constructor-owned.", "properties": { "actor_scope": { "description": "Originating principal scope from the authenticated carrier authority.", "type": "string" }, "ann_index": { "$ref": "#/components/schemas/ResDef_Query_SemanticAnnIndexSpec" }, "binding_id": { "type": "string" }, "created_at": { "type": "string" }, "dimension": { "format": "uint32", "minimum": 0, "type": "integer" }, "effective_actor_scope": { "description": "Opaque server-derived scope for the verified delegated agent, distinct\nfrom the originating principal and never inferred from approval.", "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index": { "$ref": "#/components/schemas/ResDef_Query_SemanticLexicalIndexSpec" }, "maintenance_policy_id": { "type": "string" }, "metric": { "$ref": "#/components/schemas/ResDef_Query_SemanticVectorMetric" }, "model": { "$ref": "#/components/schemas/ResDef_Query_SemanticModelIdentity" }, "policy": { "$ref": "#/components/schemas/ResDef_Query_SemanticPolicyComponents" }, "purpose_id": { "type": "string" }, "source_field_set_digest": { "type": "string" }, "source_revision": { "type": "string" }, "source_schema_digest": { "type": "string" }, "source_selector": { "$ref": "#/components/schemas/ResDef_Query_SemanticSourceSelector" }, "tenant_id": { "type": "string" } }, "required": [ "binding_id", "tenant_id", "actor_scope", "effective_actor_scope", "purpose_id", "policy", "source_selector", "source_schema_digest", "source_revision", "source_field_set_digest", "dimension", "metric", "model", "generation", "maintenance_policy_id", "lexical_index", "ann_index", "created_at" ], "type": "object" }, "ResDef_Query_SemanticBindingState": { "enum": [ "pending", "building", "live", "disabled", "failed", "dropping" ], "type": "string" }, "ResDef_Query_SemanticDeadLetter": { "additionalProperties": false, "properties": { "attempt": { "format": "uint32", "minimum": 0, "type": "integer" }, "error_code": { "type": "string" }, "failed_at": { "type": "string" }, "failure_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "intent": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageIntent" }, "reason": { "type": "string" } }, "required": [ "intent", "attempt", "error_code", "reason", "failure_digest", "failed_at" ], "type": "object" }, "ResDef_Query_SemanticDigest": { "description": "A SHA-256 semantic contract identity as `sha256:<64 lowercase hex>`", "maxLength": 71, "minLength": 71, "pattern": "^sha256:[0-9a-f]{64}$", "type": "string" }, "ResDef_Query_SemanticGenerationAggregate": { "additionalProperties": false, "properties": { "aggregate_artifact_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "aggregate_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "completed_entity_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "entity_set_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "expected_entity_count": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "expected_entity_count", "completed_entity_count", "entity_set_digest", "aggregate_receipt_digest", "aggregate_artifact_digest" ], "type": "object" }, "ResDef_Query_SemanticGenerationArtifact": { "description": "Closed generation-finalization artifact. This keeps the exact replay batch\nauthoritative for global lexical/ANN identities and the active pointer.", "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "const": "lexical_index_manifest", "type": "string" }, "manifest": { "$ref": "#/components/schemas/ResDef_Query_SemanticLexicalIndexManifest" } }, "required": [ "artifact", "manifest" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "ann_index_manifest", "type": "string" }, "manifest": { "$ref": "#/components/schemas/ResDef_Query_SemanticAnnIndexManifest" } }, "required": [ "artifact", "manifest" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "activation", "type": "string" }, "pointer": { "$ref": "#/components/schemas/ResDef_Query_SemanticActivePointer" }, "target": { "$ref": "#/components/schemas/ResDef_Query_SemanticActivationTarget" } }, "required": [ "artifact", "target", "pointer" ], "type": "object" } ] }, "ResDef_Query_SemanticGenerationCheckpoint": { "additionalProperties": false, "properties": { "aggregate": { "$ref": "#/components/schemas/ResDef_Query_SemanticGenerationAggregate" }, "artifact_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "completed_at": { "type": "string" }, "dependency": { "$ref": "#/components/schemas/ResDef_Query_SemanticGenerationDependency" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_revision": { "type": "string" }, "stage": { "$ref": "#/components/schemas/ResDef_Query_SemanticStage" } }, "required": [ "binding_id", "binding_digest", "generation", "source_revision", "stage", "aggregate", "dependency", "artifact_digest", "completed_at", "checkpoint_digest" ], "type": "object" }, "ResDef_Query_SemanticGenerationCheckpointUpdate": { "additionalProperties": false, "description": "One exact checkpoint compare-and-swap carried with an S3/S5 completion.\nThe owner store must load the expected predecessor, insert `member`,\nrecompute the complete sorted aggregate from authoritative entity rows,\nand compare it with `successor` in the same transaction.", "properties": { "expected_previous_checkpoint_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, { "type": "null" } ] }, "expected_previous_completed_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "member": { "$ref": "#/components/schemas/ResDef_Query_SemanticGenerationMember" }, "successor": { "$ref": "#/components/schemas/ResDef_Query_SemanticGenerationCheckpoint" } }, "required": [ "expected_previous_completed_count", "member", "successor" ], "type": "object" }, "ResDef_Query_SemanticGenerationDependency": { "oneOf": [ { "additionalProperties": false, "properties": { "dependency": { "const": "none", "type": "string" } }, "required": [ "dependency" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "dependency": { "const": "checkpoint", "type": "string" }, "stage": { "$ref": "#/components/schemas/ResDef_Query_SemanticStage" } }, "required": [ "dependency", "stage", "checkpoint_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "ann_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "dependency": { "const": "activation", "type": "string" }, "lexical_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" } }, "required": [ "dependency", "lexical_checkpoint_digest", "ann_checkpoint_digest" ], "type": "object" } ] }, "ResDef_Query_SemanticGenerationMember": { "additionalProperties": false, "properties": { "artifact_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "source_entity_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "source_entity_id", "source_revision", "receipt_digest", "artifact_digest" ], "type": "object" }, "ResDef_Query_SemanticGraphProjectionManifest": { "additionalProperties": false, "properties": { "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "manifest_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "projection_content_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "projection_entity_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "source_entity_id": { "type": "string" }, "source_manifest_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "generation", "source_entity_id", "source_revision", "source_manifest_digest", "projection_entity_digest", "projection_content_digest", "completed_receipt_digest", "completed_at", "manifest_digest" ], "type": "object" }, "ResDef_Query_SemanticIndexFilter": { "additionalProperties": false, "description": "Closed relational/identity filter. Raw predicates and SQL expressions have\nno representable field.", "properties": { "max_results": { "format": "uint32", "minimum": 0, "type": "integer" }, "required_source_revision": { "type": [ "string", "null" ] }, "source_entity_ids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "source_entity_ids", "max_results" ], "type": "object" }, "ResDef_Query_SemanticIndexOp": { "description": "Operations over one durable semantic binding and its S1-S6 stage queue.\n\nShaped like [`crate::agent_component::AgentComponentOp`] and its three\nsibling layers: one `Method` carrying a closed op enum, with the read/write\nclassification living on the op itself ([`Self::is_mutation`]) so the\ncapability policy and `server::access::requires_write` cannot drift apart\nabout which operations write.", "oneOf": [ { "additionalProperties": false, "description": "Mint and persist a binding, publishing its durable creation event.\n\nThe DRAFT is what travels, not a built `SemanticBinding`: the engine\ncalls `SemanticBinding::create`, so the binding digest is computed over\nwhat the engine validated rather than accepted from the caller.", "properties": { "binding_id": { "type": "string" }, "draft": { "$ref": "#/components/schemas/ResDef_Query_SemanticBindingDraft", "description": "Boxed: a binding draft carries roughly twenty governed fields and\nwould otherwise set the size of every `Method`." }, "idempotency_key": { "description": "The caller's stable retry identity. The per-attempt nonce is minted\nby the engine and is deliberately not representable here.", "type": "string" }, "op": { "const": "admit_binding", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "draft", "idempotency_key" ], "type": "object" }, { "additionalProperties": false, "description": "Replace a live generation with an operation-bound pending one. The old\nactive pointer remains the serving proof until S6 publishes.", "properties": { "binding_id": { "type": "string" }, "draft": { "$ref": "#/components/schemas/ResDef_Query_SemanticBindingDraft" }, "expected_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "op": { "const": "refresh_binding", "type": "string" }, "source_manifest": { "$ref": "#/components/schemas/ResDef_Query_SemanticSqlSourceManifestDraft" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "expected_generation", "draft", "source_manifest", "idempotency_key" ], "type": "object" }, { "additionalProperties": false, "description": "Move the durable binding state machine (e.g. `Pending` -> `Building`),\nfenced on the exact generation the caller believes is live.", "properties": { "binding_id": { "type": "string" }, "expected_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "next_state": { "$ref": "#/components/schemas/ResDef_Query_SemanticBindingState" }, "op": { "const": "transition_binding", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "expected_generation", "next_state", "idempotency_key" ], "type": "object" }, { "additionalProperties": false, "description": "Retire the binding at an exact generation.", "properties": { "binding_id": { "type": "string" }, "expected_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "type": "string" }, "op": { "const": "drop_binding", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "expected_generation", "idempotency_key" ], "type": "object" }, { "additionalProperties": false, "description": "One coarse wakeup whose source owner guarantees exactly one complete\nrow. Multi-row providers must use [`Self::AdmitSourcePage`].", "properties": { "binding_id": { "type": "string" }, "op": { "const": "admit_source_record", "type": "string" }, "record": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxRecord", "description": "The committed SQL mutation this wakeup names. Boxed for size." }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "record" ], "type": "object" }, { "additionalProperties": false, "description": "One bounded page of a multi-row wakeup, resumed by the previous page's\nopaque cursor.", "properties": { "binding_id": { "type": "string" }, "cursor": { "type": [ "string", "null" ] }, "op": { "const": "admit_source_page", "type": "string" }, "record": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxRecord" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "record" ], "type": "object" }, { "additionalProperties": false, "description": "A complete-snapshot reconciliation turn: page the authoritative source,\nthen emit absence tombstones once the complete-page proof holds. Bounded\nper turn by the service's own page/row/byte budgets, so a large source\nresumes rather than being refused.", "properties": { "binding_id": { "type": "string" }, "op": { "const": "admit_source_reconcile", "type": "string" }, "record": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxRecord" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "record" ], "type": "object" }, { "additionalProperties": false, "description": "Admit S1 after a refresh has advanced the durable binding head.", "properties": { "binding_id": { "type": "string" }, "draft": { "$ref": "#/components/schemas/ResDef_Query_SemanticBindingDraft" }, "op": { "const": "admit_source_replacement", "type": "string" }, "record": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxRecord" }, "source_manifest": { "$ref": "#/components/schemas/ResDef_Query_SemanticSqlSourceManifestDraft" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "draft", "source_manifest", "record" ], "type": "object" }, { "additionalProperties": false, "description": "Durably subscribe a named consumer to this binding's stage topic. A\nconsumer with no durable subscription claims nothing.", "properties": { "binding_id": { "type": "string" }, "consumer": { "type": "string" }, "op": { "const": "subscribe_stage_consumer", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "consumer" ], "type": "object" }, { "additionalProperties": false, "description": "Take a bounded set of stage leases for one queue class.", "properties": { "binding_id": { "type": "string" }, "consumer": { "type": "string" }, "lease_ms": { "description": "At most [`MAX_SEMANTIC_STAGE_LEASE_MS`].", "format": "uint64", "minimum": 0, "type": "integer" }, "limit": { "description": "At most [`MAX_SEMANTIC_STAGE_CLAIM_LIMIT`].", "format": "uint32", "minimum": 0, "type": "integer" }, "op": { "const": "claim_stage_leases", "type": "string" }, "queue_class": { "$ref": "#/components/schemas/ResDef_Query_SemanticQueueClass", "description": "The tier this worker serves. Rows whose stage belongs to another\nclass are released back unexecuted rather than handed to a worker\nthat cannot do them -- tier selection is the whole point of a\ntiered queue, so it has to be expressible on the wire." }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "consumer", "queue_class", "limit", "lease_ms" ], "type": "object" }, { "additionalProperties": false, "description": "Re-check a held lease and return the canonical intent it leases, without\ncommitting anything. A worker calls this before starting expensive work.", "properties": { "binding_id": { "type": "string" }, "consumer": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxLease" }, "op": { "const": "validate_stage_lease", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "consumer", "lease" ], "type": "object" }, { "additionalProperties": false, "description": "The bounded queue's per-consumer liveness, capacity and in-flight count.", "properties": { "binding_id": { "type": "string" }, "consumer": { "type": "string" }, "op": { "const": "stage_status", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "consumer" ], "type": "object" }, { "additionalProperties": false, "description": "Persist one terminal entity-scoped transition with its artifact, publish\nthe successor intent when the predecessor proof is complete, and\nacknowledge the exact lease -- one durable mutation.", "properties": { "artifact": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageArtifact" }, "binding_id": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxLease" }, "op": { "const": "complete_stage", "type": "string" }, "successor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SemanticStageIntent" }, { "type": "null" } ] }, "tenant_id": { "type": "string" }, "transition": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageTransition" } }, "required": [ "op", "tenant_id", "binding_id", "lease", "transition", "artifact" ], "type": "object" }, { "additionalProperties": false, "description": "Complete S3 or S5 and persist its canonical lexical/ANN manifest in the\nsame owner mutation as the transition, checkpoint, successor and lease\nacknowledgement.", "properties": { "artifact": { "$ref": "#/components/schemas/ResDef_Query_SemanticGenerationArtifact" }, "binding_id": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxLease" }, "op": { "const": "complete_generation_stage", "type": "string" }, "successor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SemanticStageIntent" }, { "type": "null" } ] }, "tenant_id": { "type": "string" }, "transition": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageTransition" } }, "required": [ "op", "tenant_id", "binding_id", "lease", "transition", "artifact" ], "type": "object" }, { "additionalProperties": false, "description": "Complete an S1 source transition. No source row travels: the engine\nre-reads the authoritative, ACL-checked SQL page itself and converts its\ndecision into the authorization receipt. A caller that could supply the\nrow could index text it is not allowed to read.", "properties": { "binding_id": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxLease" }, "op": { "const": "complete_sql_source_stage", "type": "string" }, "page_cursor": { "description": "The opaque page cursor the intent was claimed from, so the exact\nbounded page is re-read.", "type": [ "string", "null" ] }, "successor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SemanticStageIntent" }, { "type": "null" } ] }, "tenant_id": { "type": "string" }, "transition": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageTransition" } }, "required": [ "op", "tenant_id", "binding_id", "lease", "transition" ], "type": "object" }, { "additionalProperties": false, "description": "Resolve an S1 completion that may already have committed before a crash.\n`None` means it has not, and the caller may proceed through\n[`Self::CompleteSqlSourceStage`].", "properties": { "binding_id": { "type": "string" }, "expected_intent": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageIntent" }, "lease": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxLease" }, "op": { "const": "replay_completed_sql_source_stage", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "lease", "expected_intent" ], "type": "object" }, { "additionalProperties": false, "description": "Hand a lease back unexecuted. Without this a connector that cannot do\nthe work it claimed wedges the row until the lease lapses.", "properties": { "binding_id": { "type": "string" }, "lease": { "$ref": "#/components/schemas/ResDef_Query_MutationOutboxLease" }, "op": { "const": "release_stage_lease", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "lease" ], "type": "object" }, { "additionalProperties": false, "description": "The durable binding head of this owner.", "properties": { "binding_id": { "type": "string" }, "op": { "const": "binding", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id" ], "type": "object" }, { "additionalProperties": false, "description": "The one retained prior SQL source manifest a complete-page deletion\nproof needs. It never reconstructs deleted bytes.", "properties": { "binding_id": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "op": { "const": "sql_source_manifest", "type": "string" }, "source_entity_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "generation", "source_entity_id" ], "type": "object" }, { "additionalProperties": false, "description": "The bounded binding catalog. Paginated; see [`SemanticBindingPage`].", "properties": { "binding_id": { "type": "string" }, "cursor": { "type": [ "string", "null" ] }, "filter": { "$ref": "#/components/schemas/ResDef_Query_SemanticIndexFilter" }, "op": { "const": "list_bindings", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id", "filter" ], "type": "object" }, { "additionalProperties": false, "description": "The generation currently serving reads, if any.", "properties": { "binding_id": { "type": "string" }, "op": { "const": "live_generation", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "binding_id" ], "type": "object" } ] }, "ResDef_Query_SemanticLexicalIndexIdentity": { "additionalProperties": false, "properties": { "analyzer_config_digest": { "type": "string" }, "analyzer_id": { "type": "string" }, "analyzer_revision": { "type": "string" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "lexical_index_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "analyzer_id", "analyzer_revision", "analyzer_config_digest", "generation", "source_revision", "purpose_id", "policy_digest", "lexical_index_digest" ], "type": "object" }, "ResDef_Query_SemanticLexicalIndexManifest": { "additionalProperties": false, "properties": { "artifact_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticLexicalIndexIdentity" }, "row_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_revision": { "type": "string" } }, "required": [ "binding_id", "binding_digest", "generation", "source_revision", "identity", "artifact_digest", "row_count", "completed_receipt_digest", "completed_at" ], "type": "object" }, "ResDef_Query_SemanticLexicalIndexSpec": { "additionalProperties": false, "description": "Pre-binding lexical configuration. It intentionally has no binding or\nfinal index digest, breaking the otherwise circular binding identity.", "properties": { "analyzer_config_digest": { "type": "string" }, "analyzer_id": { "type": "string" }, "analyzer_revision": { "type": "string" } }, "required": [ "analyzer_id", "analyzer_revision", "analyzer_config_digest" ], "type": "object" }, "ResDef_Query_SemanticModelIdentity": { "additionalProperties": false, "properties": { "model_digest": { "type": "string" }, "model_id": { "type": "string" }, "model_revision": { "type": "string" }, "preprocess_digest": { "type": "string" } }, "required": [ "model_id", "model_revision", "preprocess_digest", "model_digest" ], "type": "object" }, "ResDef_Query_SemanticPolicyComponents": { "additionalProperties": false, "properties": { "rbac_policy_digest": { "type": "string" }, "rbac_policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "row_policy_digest": { "type": "string" }, "row_policy_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_acl_digest": { "type": "string" }, "source_acl_revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "rbac_policy_revision", "rbac_policy_digest", "row_policy_revision", "row_policy_digest", "source_acl_revision", "source_acl_digest" ], "type": "object" }, "ResDef_Query_SemanticPolicyIdentity": { "additionalProperties": false, "properties": { "components": { "$ref": "#/components/schemas/ResDef_Query_SemanticPolicyComponents" }, "effective_actor_scope": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "effective_actor_scope", "purpose_id", "components", "policy_digest" ], "type": "object" }, "ResDef_Query_SemanticQueueClass": { "enum": [ "fast", "medium", "slow_heavy" ], "type": "string" }, "ResDef_Query_SemanticSourceSelector": { "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "sql_column_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Query_SqlColumnRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "graph_text_property_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Query_GraphTextPropertyRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "canonical_text_asset", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Query_CanonicalTextAssetRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "agent_library_composite", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Query_AgentLibraryCompositeRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "multimodal_asset_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Query_MultimodalAssetRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "time_series_window_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Query_TimeSeriesWindowRef" } }, "required": [ "kind", "selector" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "lakehouse_vector_projection_ref", "type": "string" }, "selector": { "$ref": "#/components/schemas/ResDef_Query_LakehouseVectorProjectionRef" } }, "required": [ "kind", "selector" ], "type": "object" } ] }, "ResDef_Query_SemanticSqlSourceIdentity": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "column_id": { "type": "string" }, "record_identity_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest", "description": "Server-derived digest of the stable row identity. Raw predicates and\nprimary-key values are intentionally not transport fields." }, "schema_id": { "type": "string" }, "source_identity_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "table_id": { "type": "string" }, "tenant_scope": { "type": "string" } }, "required": [ "tenant_scope", "catalog_id", "schema_id", "table_id", "column_id", "record_identity_digest", "source_identity_digest" ], "type": "object" }, "ResDef_Query_SemanticSqlSourceManifest": { "additionalProperties": false, "properties": { "authorization_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "manifest_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "source_acl_digest": { "type": "string" }, "source_acl_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_content_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "source_entity_id": { "type": "string" }, "source_field_set_digest": { "type": "string" }, "source_identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticSqlSourceIdentity" }, "source_revision": { "type": "string" }, "source_schema_digest": { "type": "string" }, "source_schema_revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "binding_id", "binding_digest", "generation", "source_identity", "source_entity_id", "source_revision", "source_content_digest", "source_schema_revision", "source_schema_digest", "source_field_set_digest", "source_acl_revision", "source_acl_digest", "authorization_receipt_digest", "completed_receipt_digest", "completed_at", "manifest_digest" ], "type": "object" }, "ResDef_Query_SemanticSqlSourceManifestDraft": { "additionalProperties": false, "properties": { "authorization_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "completed_at": { "type": "string" }, "completed_receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_acl_digest": { "type": "string" }, "source_acl_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "source_content_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "source_field_set_digest": { "type": "string" }, "source_identity": { "$ref": "#/components/schemas/ResDef_Query_SemanticSqlSourceIdentity" }, "source_revision": { "type": "string" }, "source_schema_digest": { "type": "string" }, "source_schema_revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "binding_id", "binding_digest", "generation", "source_identity", "source_revision", "source_content_digest", "source_schema_revision", "source_schema_digest", "source_field_set_digest", "source_acl_revision", "source_acl_digest", "authorization_receipt_digest", "completed_receipt_digest", "completed_at" ], "type": "object" }, "ResDef_Query_SemanticStage": { "enum": [ "S1", "S2", "S3", "S4", "S5", "S6" ], "type": "string" }, "ResDef_Query_SemanticStageArtifact": { "description": "Closed entity-stage owner artifact carried inside the exact-replay mutation.\nGlobal index manifests and activation are committed only by\n[`SemanticIndexMutation::FinalizeGeneration`].", "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "const": "none", "type": "string" } }, "required": [ "artifact" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "sql_source_manifest", "type": "string" }, "authorization": { "$ref": "#/components/schemas/ResDef_Query_SemanticAuthorizationReceipt" }, "manifest": { "$ref": "#/components/schemas/ResDef_Query_SemanticSqlSourceManifest" } }, "required": [ "artifact", "manifest", "authorization" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "graph_projection_manifest", "type": "string" }, "manifest": { "$ref": "#/components/schemas/ResDef_Query_SemanticGraphProjectionManifest" } }, "required": [ "artifact", "manifest" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "vector", "type": "string" }, "vector": { "$ref": "#/components/schemas/ResDef_Query_SemanticVector" } }, "required": [ "artifact", "vector" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "const": "dead_letter", "type": "string" }, "dead_letter": { "$ref": "#/components/schemas/ResDef_Query_SemanticDeadLetter" } }, "required": [ "artifact", "dead_letter" ], "type": "object" } ] }, "ResDef_Query_SemanticStageIntent": { "additionalProperties": false, "properties": { "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "input_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "intent_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "predecessor": { "$ref": "#/components/schemas/ResDef_Query_SemanticStagePredecessor" }, "scope": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageScope" }, "source_revision": { "type": "string" }, "stage": { "$ref": "#/components/schemas/ResDef_Query_SemanticStage" } }, "required": [ "binding_id", "binding_digest", "generation", "scope", "source_revision", "stage", "predecessor", "input_digest", "intent_digest" ], "type": "object" }, "ResDef_Query_SemanticStageOutcome": { "enum": [ "completed", "idempotent_noop", "deferred_backpressured", "parked_awaiting_predecessor", "rejected_dead_letter" ], "type": "string" }, "ResDef_Query_SemanticStagePredecessor": { "oneOf": [ { "additionalProperties": false, "properties": { "proof": { "const": "none", "type": "string" } }, "required": [ "proof" ], "type": "object" }, { "additionalProperties": false, "properties": { "proof": { "const": "entity_receipt", "type": "string" }, "receipt_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "stage": { "$ref": "#/components/schemas/ResDef_Query_SemanticStage" } }, "required": [ "proof", "stage", "receipt_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "proof": { "const": "generation_checkpoint", "type": "string" }, "stage": { "$ref": "#/components/schemas/ResDef_Query_SemanticStage" } }, "required": [ "proof", "stage", "checkpoint_digest" ], "type": "object" }, { "additionalProperties": false, "properties": { "checkpoint": { "$ref": "#/components/schemas/ResDef_Query_SemanticGenerationCheckpoint" }, "proof": { "const": "generation_coverage", "type": "string" } }, "required": [ "proof", "checkpoint" ], "type": "object" }, { "additionalProperties": false, "properties": { "ann_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "lexical_checkpoint_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "proof": { "const": "activation", "type": "string" } }, "required": [ "proof", "lexical_checkpoint_digest", "ann_checkpoint_digest" ], "type": "object" } ] }, "ResDef_Query_SemanticStageReceipt": { "additionalProperties": false, "properties": { "completed_at": { "type": "string" }, "cursor": { "type": "string" }, "intent_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "outcome": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageOutcome" }, "output_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" } }, "required": [ "intent_digest", "output_digest", "cursor", "completed_at", "outcome" ], "type": "object" }, "ResDef_Query_SemanticStageScope": { "oneOf": [ { "additionalProperties": false, "properties": { "scope": { "const": "entity", "type": "string" }, "source_entity_id": { "type": "string" } }, "required": [ "scope", "source_entity_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "scope": { "const": "generation", "type": "string" } }, "required": [ "scope" ], "type": "object" } ] }, "ResDef_Query_SemanticStageTransition": { "additionalProperties": false, "properties": { "generation_checkpoint": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SemanticGenerationCheckpointUpdate" }, { "type": "null" } ] }, "intent": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageIntent" }, "receipt": { "$ref": "#/components/schemas/ResDef_Query_SemanticStageReceipt" } }, "required": [ "intent", "receipt" ], "type": "object" }, "ResDef_Query_SemanticVector": { "additionalProperties": false, "properties": { "binding_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" }, "binding_id": { "type": "string" }, "dimension": { "format": "uint32", "minimum": 0, "type": "integer" }, "generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "model_digest": { "type": "string" }, "policy_digest": { "type": "string" }, "preprocess_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "source_entity_id": { "type": "string" }, "source_revision": { "type": "string" }, "values": { "items": { "format": "float", "type": "number" }, "type": "array" }, "values_digest": { "$ref": "#/components/schemas/ResDef_Query_SemanticDigest" } }, "required": [ "binding_id", "binding_digest", "generation", "source_entity_id", "source_revision", "model_digest", "preprocess_digest", "dimension", "purpose_id", "policy_digest", "values", "values_digest" ], "type": "object" }, "ResDef_Query_SemanticVectorMetric": { "enum": [ "cosine", "dot_product", "euclidean" ], "type": "string" }, "ResDef_Query_SequenceSource": { "description": "A graph-derived sequence source for `MineSequence` (CONCEPT:EG-KG.mining.prefixspan\n\u2014 Phase 4). Each node carrying `node_label` becomes one ordered sequence: the\nlist of `item_field` values gathered from its neighbors in `direction`,\npreserving the RESIDENT EDGE INSERTION ORDER (the natural \"ordered edge\nsequence per node\" \u2014 edges accumulate in the order they were added, so this\nis compute-near-data over the bitemporal write history without a separate\ntsdb/event-log dependency), optionally filtered to a `relation`.", "properties": { "direction": { "default": "out", "description": "Edge direction to gather neighbors: `out` (successors, default \u2014 the\nnatural \"what happened after\" order), `in` (predecessors), or `any`.", "type": "string" }, "item_field": { "description": "Which value of each neighbor becomes an item: `label` (the neighbor's\ntype/label, default) or `prop:` (a neighbor property value). When\n`None`, the neighbor's node id is used verbatim.", "type": [ "string", "null" ] }, "limit": { "description": "Cap the number of sequence owners scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances each become one ordered sequence.", "type": "string" }, "relation": { "description": "Optional edge-relation filter: only follow edges whose `relationship`\nproperty equals this. `None` \u21d2 all edges.", "type": [ "string", "null" ] } }, "required": [ "node_label" ], "type": "object" }, "ResDef_Query_ServedModalityIngestItem": { "additionalProperties": false, "description": "One element of an atomic, bounded served-modality ingest stream. Every item uses\nthe enclosing operation's modality and is decoded before any durable state changes.", "properties": { "bundle_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "expected_version": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "idempotency_ref": { "type": "string" }, "source_bytes": { "description": "Ephemeral decoder input; excluded from receipts, snapshots, events, and indexes.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "target_occurrence_id": { "type": "string" } }, "required": [ "idempotency_ref", "target_occurrence_id", "bundle_msgpack", "source_bytes" ], "type": "object" }, "ResDef_Query_ServedModalityKind": { "enum": [ "document", "image", "audio", "video" ], "type": "string" }, "ResDef_Query_ServedModalityOp": { "description": "One operation on the graph-scoped governed modality runtime.\n\nQuery authority is intentionally absent from this DTO. The server derives tenant,\naccess-policy, purpose, and classification scope from the cryptographically\nverified request context, so a caller cannot widen its own RLS boundary.", "oneOf": [ { "additionalProperties": false, "description": "Return the opaque policy references derived for this verified request. This\nlets a producer construct a matching certified `ArtifactBundle` without any\ndeployment-specific identifiers or paths in configuration.", "properties": { "operation": { "const": "authority", "type": "string" } }, "required": [ "operation" ], "type": "object" }, { "additionalProperties": false, "description": "Decode the concrete native format, validate that it matches the certified\nbundle, and atomically create or update one occurrence.", "properties": { "bundle_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "expected_version": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "idempotency_ref": { "type": "string" }, "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "operation": { "const": "ingest", "type": "string" }, "source_bytes": { "description": "Ephemeral source bytes. The runtime derives only normalized metadata and a\ncontent address; these bytes are omitted from snapshots, audit, CDC, and\nMutationBatch status/outbox records.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "target_occurrence_id": { "type": "string" } }, "required": [ "operation", "modality", "idempotency_ref", "target_occurrence_id", "bundle_msgpack", "source_bytes" ], "type": "object" }, { "additionalProperties": false, "description": "Decode and apply two or more records as one atomic bounded stream. A decode,\nauthority, OCC, or resource failure rolls back every item and emits no event.", "properties": { "items": { "items": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityIngestItem" }, "type": "array" }, "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "operation": { "const": "ingest_stream", "type": "string" } }, "required": [ "operation", "modality", "items" ], "type": "object" }, { "additionalProperties": false, "properties": { "after_occurrence_id": { "default": null, "type": [ "string", "null" ] }, "include_cold": { "default": false, "type": "boolean" }, "limit": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "operation": { "const": "query", "type": "string" }, "segment_kind": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ServedSegmentKind" }, { "type": "null" } ], "default": null } }, "required": [ "operation", "modality" ], "type": "object" }, { "additionalProperties": false, "properties": { "after_occurrence_id": { "default": null, "type": [ "string", "null" ] }, "include_cold": { "default": false, "type": "boolean" }, "limit": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "operation": { "const": "native_query", "type": "string" }, "predicate": { "$ref": "#/components/schemas/ResDef_Query_ServedNativePredicate" } }, "required": [ "operation", "predicate" ], "type": "object" }, { "additionalProperties": false, "properties": { "expected_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_ref": { "type": "string" }, "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "occurrence_id": { "type": "string" }, "operation": { "const": "delete", "type": "string" } }, "required": [ "operation", "modality", "idempotency_ref", "occurrence_id", "expected_version" ], "type": "object" }, { "additionalProperties": false, "properties": { "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "occurrence_id": { "type": "string" }, "operation": { "const": "move_to_cold", "type": "string" } }, "required": [ "operation", "modality", "occurrence_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "occurrence_id": { "type": "string" }, "operation": { "const": "restore", "type": "string" } }, "required": [ "operation", "modality", "occurrence_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "after_sequence": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" }, "limit": { "default": 0, "format": "uint", "minimum": 0, "type": "integer" }, "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "operation": { "const": "events", "type": "string" } }, "required": [ "operation", "modality" ], "type": "object" }, { "additionalProperties": false, "description": "Return live, authority-partitioned storage/index/event counts. No identifier,\nsource byte, query text, path, or deployment field is included.", "properties": { "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "operation": { "const": "stats", "type": "string" } }, "required": [ "operation", "modality" ], "type": "object" }, { "additionalProperties": false, "description": "Physically collect authorized tombstoned records after retention has been\ndemonstrated. The durable idempotency/event ledger remains append-only.", "properties": { "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "operation": { "const": "collect_tombstones", "type": "string" }, "through_event_sequence": { "description": "Inclusive durable event fence. Tombstones newer than this checkpoint are\nretained, so collection cannot race an unobserved delete.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "operation", "modality", "through_event_sequence" ], "type": "object" }, { "additionalProperties": false, "description": "Return the concrete leaf component's TCK summary. This is deliberately not a\nrelease-readiness claim; G-14 derives that only from executable behavior plus\nsame-artifact performance evidence.", "properties": { "modality": { "$ref": "#/components/schemas/ResDef_Query_ServedModalityKind" }, "operation": { "const": "capabilities", "type": "string" } }, "required": [ "operation", "modality" ], "type": "object" } ] }, "ResDef_Query_ServedNativePredicate": { "description": "Native, index-backed query predicates. Document text is ephemeral request data;\nthe server converts it to an authority-keyed lexeme before index access and never\nincludes it in cursors, logs, receipts, or persisted state.", "oneOf": [ { "additionalProperties": false, "properties": { "page": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "predicate": { "const": "document_lexical", "type": "string" }, "term": { "type": "string" } }, "required": [ "predicate", "term" ], "type": "object" }, { "additionalProperties": false, "properties": { "height": { "format": "double", "type": "number" }, "predicate": { "const": "image_region", "type": "string" }, "width": { "format": "double", "type": "number" }, "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "predicate", "x", "y", "width", "height" ], "type": "object" }, { "additionalProperties": false, "properties": { "hash": { "format": "uint64", "minimum": 0, "type": "integer" }, "maximum_distance": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "predicate": { "const": "image_perceptual_hash", "type": "string" } }, "required": [ "predicate", "hash", "maximum_distance" ], "type": "object" }, { "additionalProperties": false, "properties": { "end_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "minimum_rms": { "format": "float", "type": "number" }, "predicate": { "const": "audio_window", "type": "string" }, "start_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "predicate", "start_ms", "end_ms", "minimum_rms" ], "type": "object" }, { "additionalProperties": false, "properties": { "end_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "keyframes_only": { "type": "boolean" }, "predicate": { "const": "video_window", "type": "string" }, "start_ms": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "predicate", "start_ms", "end_ms", "keyframes_only" ], "type": "object" } ] }, "ResDef_Query_ServedSegmentKind": { "enum": [ "page", "paragraph", "table", "row", "region", "audio_range", "video_shot", "frame_range", "time_window", "code_symbol", "trace_span" ], "type": "string" }, "ResDef_Query_ServerDesiredState": { "description": "The operator's DESIRED state for a registered server.\n\nDesired, not observed: whether the server answered its last probe is a\ndiscovery observation (`FleetCatalog.RecordDiscovery`), and the two are\nnever collapsed into one status.", "enum": [ "enabled", "disabled" ], "type": "string" }, "ResDef_Query_ServerTransport": { "description": "How a registered server is reached. Closed on purpose: a transport the\nengine cannot name is `Unspecified`, never a free-form string.", "oneOf": [ { "const": "unspecified", "description": "A registration that predates the typed field, or did not say.", "type": "string" }, { "const": "stdio", "description": "A local child process speaking MCP over stdio.", "type": "string" }, { "const": "streamable_http", "description": "MCP streamable HTTP.", "type": "string" }, { "const": "sse", "description": "MCP over server-sent events.", "type": "string" }, { "const": "http", "description": "Plain HTTP JSON-RPC.", "type": "string" } ] }, "ResDef_Query_Sha256Digest": { "description": "A SHA-256 digest, serialised as 64 lower-case hex characters.", "type": "string" }, "ResDef_Query_ShortlistProvenance": { "additionalProperties": false, "description": "How the shortlist the decision scored was produced.", "properties": { "ann_recall_mode": { "default": null, "description": "The approximate-nearest-neighbour recall mode, when one was used.", "type": [ "string", "null" ] }, "embedder_model_digest": { "default": null, "type": [ "string", "null" ] }, "now_ms": { "description": "The clock the shortlist's recency filters read, recorded so the\nshortlist can be reproduced.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "now_ms" ], "type": "object" }, "ResDef_Query_SkillType": { "description": "How a skill is run. The four values the agent ecosystem declares.", "enum": [ "skill", "workflow", "graph", "mcp_skill" ], "type": "string" }, "ResDef_Query_SlotAssignment": { "additionalProperties": false, "description": "One slot of the assembled graph and the component bound to it.", "properties": { "component": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "slot": { "type": "string" } }, "required": [ "slot", "component" ], "type": "object" }, "ResDef_Query_SolveModelSpec": { "additionalProperties": false, "description": "A complete 0-1 integer programme: binary variables, labelled constraints and\na lexicographic objective whose first level is the most significant.", "properties": { "constraints": { "items": { "$ref": "#/components/schemas/ResDef_Query_ConstraintSpec" }, "type": "array" }, "objective": { "items": { "$ref": "#/components/schemas/ResDef_Query_ObjectiveLevelSpec" }, "type": "array" }, "variables": { "items": { "type": "string" }, "type": "array" } }, "required": [ "variables", "constraints", "objective" ], "type": "object" }, "ResDef_Query_SolveRequest": { "additionalProperties": false, "description": "One bounded 0-1 integer programme to solve.", "properties": { "config": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SolverConfigSpec" }, { "type": "null" } ], "default": null, "description": "Absent means the engine's default budget, leaf limit and denominator." }, "model": { "$ref": "#/components/schemas/ResDef_Query_SolveModelSpec" } }, "required": [ "model" ], "type": "object" }, "ResDef_Query_SolveStatus": { "description": "The outcome class of a solve.", "oneOf": [ { "const": "optimal", "description": "The incumbent is optimal and the tree or root proof certifies it.", "type": "string" }, { "additionalProperties": false, "description": "The search completed; its tree exceeded the certificate limit, so the\nproof is a reproducible deterministic derivation, not a certificate.", "properties": { "optimal_by_deterministic_search": { "additionalProperties": false, "properties": { "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes_expanded" ], "type": "object" } }, "required": [ "optimal_by_deterministic_search" ], "type": "object" }, { "additionalProperties": false, "description": "The budget ran out with a certified gap no larger than the accepted gap.", "properties": { "feasible_with_gap": { "additionalProperties": false, "properties": { "gap": { "$ref": "#/components/schemas/ResDef_Query_Scalar" } }, "required": [ "gap" ], "type": "object" } }, "required": [ "feasible_with_gap" ], "type": "object" }, { "additionalProperties": false, "description": "No feasible assignment exists; `core` lists the rows the proof uses.", "properties": { "infeasible": { "additionalProperties": false, "properties": { "core": { "items": { "$ref": "#/components/schemas/ResDef_Query_RowId" }, "type": "array" } }, "required": [ "core" ], "type": "object" } }, "required": [ "infeasible" ], "type": "object" }, { "additionalProperties": false, "description": "The search completed without a feasible assignment and without a\ncertificate-sized tree.", "properties": { "infeasible_by_deterministic_search": { "additionalProperties": false, "properties": { "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes_expanded" ], "type": "object" } }, "required": [ "infeasible_by_deterministic_search" ], "type": "object" }, { "const": "budget_exhausted", "description": "The budget ran out with no incumbent or a gap above the accepted gap.", "type": "string" } ] }, "ResDef_Query_SolverBudget": { "additionalProperties": false, "description": "A caller's per-request solver budget. It may only TIGHTEN the policy; a\nrequest that tries to widen one is refused with `POLICY_LOOSENING`.", "properties": { "max_why_not_per_slot": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_why_not_per_slot" ], "type": "object" }, "ResDef_Query_SolverConfig": { "additionalProperties": false, "description": "Deterministic work limits and gap acceptance. No wall clock is read.", "properties": { "accepted_gap": { "$ref": "#/components/schemas/ResDef_Query_Scalar" }, "bound_denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_certificate_leaves": { "format": "uint32", "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_certificate_leaves", "bound_denominator", "accepted_gap" ], "type": "object" }, "ResDef_Query_SolverConfigSpec": { "additionalProperties": false, "description": "Wire form of a [`SolverConfig`].", "properties": { "accepted_gap": { "$ref": "#/components/schemas/ResDef_Query_Scalar" }, "bound_denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_certificate_leaves": { "format": "uint32", "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_certificate_leaves", "bound_denominator", "accepted_gap" ], "type": "object" }, "ResDef_Query_SolverIdentity": { "additionalProperties": false, "description": "The solver identity a record was decided under.", "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Query_Algorithm" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "algorithm", "node_budget" ], "type": "object" }, "ResDef_Query_SourceChangeSet": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "authorization": { "$ref": "#/components/schemas/ResDef_Query_WriteBackAuthorizationDecision" }, "base_source_version": { "type": "string" }, "change_set_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "change_set_id": { "type": "string" }, "connector_id": { "type": "string" }, "desired_patch": { "additionalProperties": true, "type": "object" }, "entity_id": { "type": "string" }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "field_provenance": { "additionalProperties": { "type": "string" }, "type": "object" }, "field_scope": { "items": { "type": "string" }, "type": "array" }, "idempotency_key": { "type": "string" }, "policy_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "purpose": { "type": "string" }, "reconciliation_procedure": { "type": "string" }, "required_capability": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "source_instance_id": { "type": "string" }, "source_of_truth_rule": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "change_set_id", "change_set_digest", "tenant_id", "actor", "purpose", "connector_id", "source_instance_id", "entity_id", "field_scope", "base_source_version", "desired_patch", "source_of_truth_rule", "field_provenance", "required_capability", "policy_digest", "authorization", "idempotency_key", "expires_at_ms", "reconciliation_procedure" ], "type": "object" }, "ResDef_Query_SourceCheckpoint": { "additionalProperties": false, "properties": { "content_hash": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, { "type": "null" } ], "description": "Provider-owned content identity for the returned page or snapshot.\nEG binds it into checkpoint CAS and replay; it never invents a value." }, "pending_watermark": { "type": [ "string", "null" ] }, "position": { "$ref": "#/components/schemas/ResDef_Query_SourceJson" }, "stream": { "type": "string" }, "watermark": { "type": [ "string", "null" ] } }, "required": [ "stream", "position" ], "type": "object" }, "ResDef_Query_SourceEntityRef": { "additionalProperties": false, "properties": { "record_id": { "type": "string" }, "stream": { "type": "string" } }, "required": [ "stream", "record_id" ], "type": "object" }, "ResDef_Query_SourceIngestionBatch": { "additionalProperties": false, "properties": { "authoritative_live_ids": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_SourceEntityRef_16384" }, { "type": "null" } ], "description": "Required only for `reconcile`. EG compares it with its prior durable\nlive-set marker and derives tombstones; callers never submit that diff." }, "connector": { "type": "string" }, "empty_authoritative_approval": { "description": "Required with an empty authoritative live set. The verified request must\nalso carry the dedicated empty-reconciliation capability.", "type": [ "string", "null" ] }, "expected_previous_checkpoint": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SourceCheckpoint" }, { "type": "null" } ], "description": "`None` is valid only when no cursor has ever committed for this source.\nOtherwise the authoritative transaction compares this exact digest with\nthe stored cursor and rejects stale/concurrent pages." }, "mode": { "$ref": "#/components/schemas/ResDef_Query_SourceIngestionMode" }, "provider_checkpoint": { "$ref": "#/components/schemas/ResDef_Query_SourceCheckpoint" }, "records": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_SourceRecord_1024" }, "relationships": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_SourceRelationship_4096", "default": [] }, "strict_schema": { "description": "Reject source payload/property keys not selected by their manifest map.", "type": "boolean" }, "withdrawals": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_SourceWithdrawal_1024", "default": [], "description": "Provider-declared tombstones are accepted only for `delta`." } }, "required": [ "connector", "mode", "strict_schema", "records", "provider_checkpoint" ], "type": "object" }, "ResDef_Query_SourceIngestionMode": { "enum": [ "full", "delta", "reconcile" ], "type": "string" }, "ResDef_Query_SourceIngestionRequest": { "$ref": "#/components/schemas/ResDef_Query_SourceIngestionBatch", "description": "A request whose structural invariants and byte bound were checked during\nconstruction/deserialization. Tenant, auth, mapping existence and the\npersisted cursor are deliberately server-side authority checks." }, "ResDef_Query_SourceJson": {}, "ResDef_Query_SourceRecord": { "additionalProperties": false, "properties": { "mapping_reference": { "description": "Exact Connector Manifest schema-mapping reference for this entity.", "type": "string" }, "payload": { "$ref": "#/components/schemas/ResDef_Query_SourceJson" }, "provenance": { "$ref": "#/components/schemas/ResDef_Query_SourceRecordProvenance" }, "record_id": { "type": "string" }, "stream": { "type": "string" }, "updated_at": { "type": [ "string", "null" ] } }, "required": [ "stream", "record_id", "mapping_reference", "payload", "provenance" ], "type": "object" }, "ResDef_Query_SourceRecordProvenance": { "additionalProperties": false, "properties": { "adapter_kind": { "type": "string" }, "connector": { "type": "string" }, "server": { "type": "string" }, "source_uri": { "type": "string" }, "tool": { "type": "string" }, "tool_schema_sha256": { "$ref": "#/components/schemas/ResDef_Query_Digest256" } }, "required": [ "connector", "adapter_kind", "server", "tool", "tool_schema_sha256", "source_uri" ], "type": "object" }, "ResDef_Query_SourceRelationship": { "additionalProperties": false, "description": "A provider-observed edge. EG derives its durable relationship identity from\nverified tenant/source authority, the exact relation reference and endpoints;\nthe caller cannot supply a competing identity or digest.", "properties": { "properties": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_SourceJson" }, { "type": "null" } ] }, "provenance": { "$ref": "#/components/schemas/ResDef_Query_SourceRecordProvenance" }, "relation_reference": { "description": "Exact Connector Manifest resource-relation reference, for example\n`manifest:demo#resources/Document/relations/contains`.", "type": "string" }, "source": { "$ref": "#/components/schemas/ResDef_Query_SourceEntityRef" }, "target": { "$ref": "#/components/schemas/ResDef_Query_SourceEntityRef" } }, "required": [ "source", "target", "relation_reference", "provenance" ], "type": "object" }, "ResDef_Query_SourceWithdrawal": { "additionalProperties": false, "properties": { "entity": { "$ref": "#/components/schemas/ResDef_Query_SourceEntityRef" }, "reason": { "type": "string" } }, "required": [ "entity", "reason" ], "type": "object" }, "ResDef_Query_SpatialOpKind": { "description": "SPATIAL \u2014 the constructive geometry op applied by `Op::SpatialOp` (CONCEPT:EG-KG.ontology.concept-9).\nPure serde here (Pi-safe, no eg-geo dep); the executor maps it to eg-geo's `algebra`\nbehind eg-plan's `geo` gate. Unary ops (`Buffer`/`ConvexHull`/`Simplify`/`Centroid`)\nderive from the row geometry alone; binary ops (`Union`/`Intersection`/`Difference`)\ntake the second operand as a WKT literal.", "oneOf": [ { "additionalProperties": false, "description": "Grow the geometry outward by `distance` (a convex buffer polygon).", "properties": { "Buffer": { "properties": { "distance": { "format": "double", "type": "number" } }, "required": [ "distance" ], "type": "object" } }, "required": [ "Buffer" ], "type": "object" }, { "const": "ConvexHull", "description": "The convex hull of the geometry's vertices.", "type": "string" }, { "additionalProperties": false, "description": "Douglas\u2013Peucker vertex reduction at `tolerance`.", "properties": { "Simplify": { "properties": { "tolerance": { "format": "double", "type": "number" } }, "required": [ "tolerance" ], "type": "object" } }, "required": [ "Simplify" ], "type": "object" }, { "const": "Centroid", "description": "The centroid (a `Point`).", "type": "string" }, { "additionalProperties": false, "description": "The (convex) union of the row geometry with `wkt`.", "properties": { "Union": { "properties": { "wkt": { "type": "string" } }, "required": [ "wkt" ], "type": "object" } }, "required": [ "Union" ], "type": "object" }, { "additionalProperties": false, "description": "The intersection of the row geometry with `wkt` (Sutherland\u2013Hodgman; convex clip).", "properties": { "Intersection": { "properties": { "wkt": { "type": "string" } }, "required": [ "wkt" ], "type": "object" } }, "required": [ "Intersection" ], "type": "object" }, { "additionalProperties": false, "description": "The difference of the row geometry minus `wkt` (documented subset).", "properties": { "Difference": { "properties": { "wkt": { "type": "string" } }, "required": [ "wkt" ], "type": "object" } }, "required": [ "Difference" ], "type": "object" } ] }, "ResDef_Query_SplitSpec": { "description": "Train/test split knobs (seeded, deterministic \u2014 reuses `datascience::primitives::\ntrain_test_split`).", "properties": { "seed": { "default": 42, "format": "uint64", "minimum": 0, "type": "integer" }, "shuffle": { "default": true, "type": "boolean" }, "test_ratio": { "default": 0.25, "format": "double", "type": "number" } }, "type": "object" }, "ResDef_Query_SqlColumnRef": { "additionalProperties": false, "properties": { "catalog_id": { "type": "string" }, "column_id": { "type": "string" }, "schema_id": { "type": "string" }, "table_id": { "type": "string" } }, "required": [ "catalog_id", "schema_id", "table_id", "column_id" ], "type": "object" }, "ResDef_Query_SqlSourceBatch": { "additionalProperties": false, "description": "Builder data for a checked submission. No request id, nonce, actor, tenant,\nclock, or client-guessed epoch participates in its semantic content digest.", "properties": { "columns": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_256" }, "expected_previous": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_CursorPosition" }, { "type": "null" } ] }, "expected_schema_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "expected_schema_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "mapping_descriptor": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceMappingDescriptor" }, "partition": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceText", "description": "Empty names the provider's unpartitioned stream. Tokens are preserved." }, "position": { "$ref": "#/components/schemas/ResDef_Query_CursorPosition" }, "rows": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_BoundedVec_SqlSourceCell_256_1024" }, "source": { "type": "string" }, "source_descriptor": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceDescriptor" }, "table": { "type": "string" } }, "required": [ "source", "partition", "position", "source_descriptor", "mapping_descriptor", "table", "columns", "rows", "expected_schema_version", "expected_schema_digest" ], "type": "object" }, "ResDef_Query_SqlSourceBatchRequest": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceBatch", "description": "Checked on deserialization before any SQL transaction can open. The\nserver must additionally preflight the outer frame using shared MsgpackLimits\nand verify tenant/actor, mapping authority, schema and persisted cursor in its\nauthoritative transaction. This type cannot verify those external facts." }, "ResDef_Query_SqlSourceCell": { "description": "A closed cell vocabulary; bytes and canonical JSON ride as MessagePack bin,\nintegers/timestamps stay i64, and embeddings stay finite f32 values.", "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "null", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "int", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "finite_float", "type": "string" }, "value": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceFloat" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "text", "type": "string" }, "value": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceText" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "bool", "type": "string" }, "value": { "type": "boolean" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "description": "Microseconds since Unix epoch, matching the native SQL cell convention.", "properties": { "kind": { "const": "timestamp", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "bytes", "type": "string" }, "value": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "json", "type": "string" }, "value": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceJson" } }, "required": [ "kind", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "finite_vector", "type": "string" }, "value": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceVector" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ResDef_Query_SqlSourceDescriptor": { "additionalProperties": false, "description": "Bounded source identity content. Metadata must be a JSON object and must not\ncontain credentials. A future adapter validates provider-specific authority;\nmerely presenting this descriptor does not grant source or table access.", "properties": { "dataset": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/ResDef_Query_SqlSourceJson" }, "provider": { "type": "string" } }, "required": [ "provider", "dataset", "metadata" ], "type": "object" }, "ResDef_Query_SqlSourceFloat": { "description": "A finite IEEE-754 double. Invalid values cannot enter through deserialization.", "format": "double", "type": "number" }, "ResDef_Query_SqlSourceJson": { "description": "Bounded JSON content, stored as canonical JSON bytes so object ordering does\nnot change semantic digests. This is JSON data, never JSON-encoded row cells.", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "ResDef_Query_SqlSourceMappingDescriptor": { "additionalProperties": false, "description": "Actual bounded mapping content, not a caller's unverified digest assertion.\nFormat interpretation/normalization belongs to the future trusted adapter.", "properties": { "content": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "format": { "type": "string" } }, "required": [ "format", "content" ], "type": "object" }, "ResDef_Query_SqlSourceText": { "description": "Text is capped in UTF-8 bytes, without restricting source-system characters.", "type": "string" }, "ResDef_Query_SqlSourceVector": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_float_4096", "description": "A bounded, finite native f32 embedding. An empty embedding is invalid." }, "ResDef_Query_StaleMaterializationsResult": { "description": "Materialized result of a `Method::StaleMaterializations` run (Seam 3 follow-up).\n`ids` is every opaque materialization reference currently `Stale` in the\ndurable per-graph projection, sorted by its persisted `BTreeSet`. Empty means\nnothing is stale; missing or corrupt projection authority is an error.\nReturned via `ResultPayload::raw`.", "properties": { "ids": { "items": { "type": "string" }, "type": "array" }, "source_graph_version": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "ids", "source_graph_version" ], "type": "object" }, "ResDef_Query_StatechartOp": { "description": "The statechart engine control-plane operation (CONCEPT:INT-P2-2).", "oneOf": [ { "additionalProperties": false, "description": "Register a statechart DEFINITION. `def_msgpack` is a MessagePack-encoded\n`eg_statechart::StatechartDef` (opaque here \u2014 decoded + validated at the\nverified boundary). Content-addressed and idempotent server-side: the response\ncarries the deterministic `def_id`.", "properties": { "Define": { "properties": { "def_msgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "def_msgpack" ], "type": "object" } }, "required": [ "Define" ], "type": "object" }, { "additionalProperties": false, "description": "Create a running INSTANCE of a stored definition in its initial state.\n`context` is the initial extended state (a JSON object, or null for empty).", "properties": { "Instantiate": { "properties": { "context": { "default": null }, "def_id": { "type": "string" } }, "required": [ "def_id" ], "type": "object" } }, "required": [ "Instantiate" ], "type": "object" }, { "additionalProperties": false, "description": "Deliver an EVENT to a durable instance. `payload` is optional structured data\nguards/actions may read. `expected_version`, when present, is an OCC token \u2014\nthe send is rejected if the stored instance version has moved on.", "properties": { "SendEvent": { "properties": { "event": { "type": "string" }, "expected_version": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "instance_id": { "type": "string" }, "payload": { "default": null } }, "required": [ "instance_id", "event" ], "type": "object" } }, "required": [ "SendEvent" ], "type": "object" }, { "additionalProperties": false, "description": "Fetch (rehydrate) an instance's current durable `(state, context)` + version.", "properties": { "GetState": { "properties": { "instance_id": { "type": "string" } }, "required": [ "instance_id" ], "type": "object" } }, "required": [ "GetState" ], "type": "object" }, { "additionalProperties": false, "description": "List instances owned by the caller, optionally filtered to one definition.", "properties": { "List": { "properties": { "def_id": { "default": null, "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "List" ], "type": "object" } ] }, "ResDef_Query_StatisticalDecisionRecord": { "additionalProperties": false, "description": "One statistical decision, recorded. Record version 2.", "properties": { "audit": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_AuditDraw" }, { "type": "null" } ], "default": null, "description": "The audit-sampling draw of an acted decision (EH-026)." }, "calibration": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_CalibrationStatement" }, { "type": "null" } ], "default": null }, "caller_principal": { "type": "string" }, "candidate_source": { "$ref": "#/components/schemas/ResDef_Query_CandidateSourceRecord" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "evidence_class": { "$ref": "#/components/schemas/ResDef_Query_EvidenceClass" }, "explanation": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_LinearExplanation" }, { "type": "null" } ], "default": null, "description": "Per-feature logit contributions of the chosen or top option; exact for\na linear head's logit only." }, "inputs": { "$ref": "#/components/schemas/ResDef_Query_StatisticalInputs" }, "inputs_digest": { "type": "string" }, "nl_binding": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_NlBinding" }, { "type": "null" } ], "default": null, "description": "The routed template and slot values of a `TemplateChoice` question." }, "outcome": { "$ref": "#/components/schemas/ResDef_Query_StatisticalOutcome" }, "premises": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_PremiseRef_1024" }, "question": { "$ref": "#/components/schemas/ResDef_Query_StatisticalQuestion" }, "record_digest": { "type": "string" }, "record_id": { "type": "string" }, "resolution_kind": { "$ref": "#/components/schemas/ResDef_Query_ResolutionKind" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "synthetic_evidence": { "description": "Synthetic evidence is labelled as such, always.", "type": "boolean" }, "tenant_id": { "type": "string" }, "trace_fidelity": { "$ref": "#/components/schemas/ResDef_Query_TraceFidelity" } }, "required": [ "schema_version", "record_id", "tenant_id", "caller_principal", "created_at_ms", "question", "candidate_source", "inputs", "inputs_digest", "resolution_kind", "evidence_class", "trace_fidelity", "premises", "outcome", "synthetic_evidence", "record_digest" ], "type": "object" }, "ResDef_Query_StatisticalInputs": { "additionalProperties": false, "description": "The input set of one statistical decision.", "properties": { "exploration": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ExplorationRecord" }, { "type": "null" } ], "default": null }, "feature_matrix": { "$ref": "#/components/schemas/ResDef_Query_FeatureMatrixRef" }, "feature_schema": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "head": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, { "type": "null" } ], "default": null }, "policy_digest": { "type": "string" }, "shortlist": { "$ref": "#/components/schemas/ResDef_Query_ShortlistProvenance" } }, "required": [ "feature_schema", "policy_digest", "feature_matrix", "shortlist" ], "type": "object" }, "ResDef_Query_StatisticalOutcome": { "description": "The conclusion of one statistical decision.", "oneOf": [ { "additionalProperties": false, "description": "An option was chosen, with the propensity it was chosen under and the\nrisk level that choice controls.", "properties": { "option_id": { "type": "string" }, "outcome": { "const": "acted", "type": "string" }, "prediction_set": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" }, "propensity": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" }, "risk": { "$ref": "#/components/schemas/ResDef_Query_RiskStatement" } }, "required": [ "outcome", "option_id", "propensity", "prediction_set", "risk" ], "type": "object" }, { "additionalProperties": false, "description": "An option chosen by the declared exploration budget, not by a score:\nthe propensity is the executed policy's exact probability, and no risk\nclaim is made.", "properties": { "option_id": { "type": "string" }, "outcome": { "const": "explored", "type": "string" }, "propensity": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" } }, "required": [ "outcome", "option_id", "propensity" ], "type": "object" }, { "additionalProperties": false, "description": "Scores only. `calibrated` says whether they mean anything numerically.", "properties": { "calibrated": { "type": "boolean" }, "outcome": { "const": "advisory", "type": "string" }, "scores": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_ScoredOption_64" } }, "required": [ "outcome", "scores", "calibrated" ], "type": "object" }, { "additionalProperties": false, "description": "Below the policy's floor; the same typed reasons as an assembly.", "properties": { "outcome": { "const": "abstained", "type": "string" }, "reasons": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_AbstainReason_64" } }, "required": [ "outcome", "reasons" ], "type": "object" } ] }, "ResDef_Query_StatisticalPolicy": { "additionalProperties": false, "description": "The statistical half of a policy: the risk, coverage and support levels\nbelow which the engine abstains instead of acting.", "properties": { "alpha": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire", "description": "Miscoverage level of the prediction set." }, "audit_sample": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire", "description": "Share of decisions sampled into the audit stream." }, "delta": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire", "description": "Failure probability of that guarantee." }, "epsilon": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire", "description": "Risk level the controlled procedure must hold." }, "min_ess": { "$ref": "#/components/schemas/ResDef_Query_QuantisedValue", "description": "Smallest effective sample size an off-policy estimate may report." }, "min_outcome_fidelity": { "$ref": "#/components/schemas/ResDef_Query_TraceFidelityLevel" }, "min_support": { "description": "Fewest supporting records per option.", "format": "uint64", "minimum": 0, "type": "integer" }, "n_min": { "description": "Fewest records before any calibrated claim is made.", "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_public_features": { "description": "Whether tenant-public features may be read for this question.", "type": "boolean" } }, "required": [ "alpha", "epsilon", "delta", "n_min", "min_support", "min_ess", "min_outcome_fidelity", "tenant_public_features", "audit_sample" ], "type": "object" }, "ResDef_Query_StatisticalQuestion": { "additionalProperties": false, "description": "One named, classified question.", "properties": { "kind": { "$ref": "#/components/schemas/ResDef_Query_QuestionKind" }, "question_id": { "type": "string" }, "safety": { "$ref": "#/components/schemas/ResDef_Query_QuestionSafety" } }, "required": [ "question_id", "kind", "safety" ], "type": "object" }, "ResDef_Query_StructuralEquationWire": { "description": "Wire mirror of `eg_epistemic::StructuralEquation` (EPI-P3-3), keyed by the\nvariable `id` it defines \u2014 one entry of `Method::CausalEstimate::variables`.\n`parents` MUST name only ids that appear EARLIER in that same list (parents\nbefore children), mirroring `eg_epistemic::CausalGraph::add_variable`'s own\ntopological-order invariant; the handler surfaces a violation as an explicit\nerror, never a panic.", "properties": { "bias": { "format": "double", "type": "number" }, "id": { "type": "string" }, "noise_var": { "description": "Variance of this variable's own exogenous noise term (`0.0` = deterministic\ngiven its parents).", "format": "double", "type": "number" }, "parents": { "description": "`(parent id, weight)` pairs.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array" } }, "required": [ "id", "parents", "bias", "noise_var" ], "type": "object" }, "ResDef_Query_SubgraphAlgorithm": { "description": "Which algorithm `MineSubgraph` runs (CONCEPT:EG-KG.mining.gspan-frequent-subgraph\n\u2014 Phase 4). `gspan` is the default (labeled frequent-subgraph patterns);\n`motif` is a label-agnostic topological census.", "enum": [ "gspan", "motif" ], "type": "string" }, "ResDef_Query_SubmitJobSpec": { "description": "Wire spec for [`JobOp::Submit`] (CONCEPT:INT-P2-1). `graph` is BOTH the tenancy\nanchor (where the eventual result claim lands) and the input-snapshot handle's\ngraph name \u2014 the facade stamps in the graph's live `GraphCore::version()` at\nsubmit time, so the snapshot handle is never client-supplied (a client cannot\nforge which graph-version a job actually ran against).\n\nWorker kernels reuse the same durable lease/publication state machine. The jobs\nfeature provides association-rule mining; the program-optimization feature adds\nthe graph-native, governed LM-program compiler.", "properties": { "actor": { "default": "", "type": "string" }, "backoff_ms": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" }, "deadline_unix_ms": { "default": null, "format": "int64", "type": [ "integer", "null" ] }, "graph": { "description": "Target graph: where the result claim lands, and whose `version()` at submit\ntime becomes the job's immutable input-snapshot handle.", "type": "string" }, "io_bytes": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "kind": { "$ref": "#/components/schemas/ResDef_Query_JobKind", "description": "The job kind + its parameters. `params_digest` lineage is derived from\n`kind`'s own fields by the facade \u2014 a client never supplies it directly." }, "max_attempts": { "default": 1, "description": "Retry cap (including the first attempt); `0`/`1` \u21d2 no retry. Default `1`.", "format": "uint32", "minimum": 0, "type": "integer" }, "memory_bytes": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_bytes": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "priority": { "default": 0, "format": "int32", "type": "integer" }, "purpose": { "default": "", "type": "string" }, "quota_cpu_ms": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "required_capabilities": { "default": [], "items": { "type": "string" }, "type": "array" }, "tenant": { "default": "", "type": "string" }, "worker_pool": { "default": "", "type": "string" }, "worker_region": { "default": "", "type": "string" } }, "required": [ "graph", "kind" ], "type": "object" }, "ResDef_Query_SubmitWorkItemRequest": { "additionalProperties": false, "description": "Native WorkItem admission request. `context.tenant_id` and\n`context.graph` are checked against the verified request envelope; they are\nnot caller-controlled routing hints.", "properties": { "catalog_digest": { "type": "string" }, "command_digest": { "type": "string" }, "context": { "$ref": "#/components/schemas/ResDef_Query_RequestContext" }, "deadline_unix": { "format": "double", "type": [ "number", "null" ] }, "depends_on": { "items": { "type": "string" }, "type": "array" }, "idempotency_key": { "type": "string" }, "input_ref": { "type": "string" }, "kind": { "type": "string" }, "max_attempts": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_tenant_in_flight": { "description": "Tenant admission cap. The engine applies a bounded default when zero;\nit never permits a caller to raise the hard engine maximum.", "format": "uint64", "minimum": 0, "type": "integer" }, "metadata": { "additionalProperties": true, "type": "object" }, "model_digest": { "type": "string" }, "policy_digest": { "type": "string" }, "priority": { "format": "int64", "type": "integer" }, "provenance_refs": { "items": { "type": "string" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_NativeControlSchemaVersion" }, "work_item_id": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "context", "idempotency_key", "command_digest", "kind", "priority", "depends_on", "input_ref", "policy_digest", "catalog_digest", "model_digest", "max_attempts", "metadata", "provenance_refs", "max_tenant_in_flight" ], "type": "object" }, "ResDef_Query_SubmitWorkItemsRequest": { "additionalProperties": false, "properties": { "context": { "$ref": "#/components/schemas/ResDef_Query_RequestContext" }, "idempotency_key": { "type": "string" }, "requests": { "items": { "$ref": "#/components/schemas/ResDef_Query_SubmitWorkItemRequest" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_NativeControlSchemaVersion" } }, "required": [ "schema_version", "context", "idempotency_key", "requests" ], "type": "object" }, "ResDef_Query_SvmKernel": { "description": "One-Class SVM kernel (CONCEPT:EG-KG.mining.oneclass-svm).", "enum": [ "rbf", "linear" ], "type": "string" }, "ResDef_Query_TemplateFacts": { "additionalProperties": false, "description": "One operator-published graph template an assembly may fill, pinned to the\nexact revision it was read at. Its `Agent` nodes are the slots.", "properties": { "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph_id": { "type": "string" }, "shape": { "$ref": "#/components/schemas/ResDef_Query_AgentGraphShape" } }, "required": [ "graph_id", "entry_revision", "definition_digest", "shape" ], "type": "object" }, "ResDef_Query_TemplateInstanceRef": { "additionalProperties": false, "description": "Where an instantiated agent came from.", "properties": { "bindings": { "additionalProperties": { "$ref": "#/components/schemas/ResDef_Query_ComponentDependency" }, "description": "Parameter name -> the component it was bound to. Ordered, so an\ninstance's digest does not depend on map iteration order.", "type": "object" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "template_id": { "type": "string" } }, "required": [ "template_id", "entry_revision", "definition_digest", "bindings" ], "type": "object" }, "ResDef_Query_TemplateParam": { "additionalProperties": false, "description": "One declared axis of variation.", "properties": { "kind": { "$ref": "#/components/schemas/ResDef_Query_AgentComponentKind", "description": "The kind the replacement must be. Checked against both the base\ncomponent and the binding, so a parameter cannot be used to smuggle a\ntool in where a model profile belongs." }, "name": { "description": "What a caller names when binding.", "type": "string" }, "replaces": { "description": "The component in the base definition this parameter replaces.\n\nIdentified by `component_id`, not by slot index. An index would be\nbrittle in exactly the way that matters: reordering a tool list -- which\n`definition_digest` deliberately treats as a no-op, since order carries\nno meaning -- would silently repoint every parameter.", "type": "string" }, "required": { "description": "When false, leaving this parameter unbound keeps the base component.", "type": "boolean" }, "summary": { "description": "Human-facing description of the axis, bounded.", "type": "string" } }, "required": [ "name", "replaces", "kind", "required", "summary" ], "type": "object" }, "ResDef_Query_TensorElementwiseOp": { "description": "TENSOR \u2014 the scalar op `TensorOpKind::Elementwise` applies to every element\n(CONCEPT:EG-KG.storage.content-addressed-dedup). Mirrors eg-tensor's `ElementwiseOp`; pure serde here.", "enum": [ "Add", "Sub", "Mul", "Div" ], "type": "string" }, "ResDef_Query_TensorOpKind": { "description": "TENSOR \u2014 the transform carried by `Op::TensorOp` (CONCEPT:EG-KG.storage.content-addressed-dedup): one of the\neg-tensor array ops, applied per-row to each row's tensor. `Slice` gathers a\nhyper-rectangle (`ranges[d] = (start, end)`, one per axis); `Reduce` collapses one\n`axis` with `kind`; `Elementwise` applies `op` with `scalar` to every element. PURE\nserde (only `usize`/`f64`/the two plain enums) \u2014 the actual N-D array math lives in\neg-tensor behind eg-plan's `tensor` gate; this is the wire variant.", "oneOf": [ { "additionalProperties": false, "properties": { "Slice": { "properties": { "ranges": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint", "minimum": 0, "type": "integer" }, { "format": "uint", "minimum": 0, "type": "integer" } ], "type": "array" }, "type": "array" } }, "required": [ "ranges" ], "type": "object" } }, "required": [ "Slice" ], "type": "object" }, { "additionalProperties": false, "properties": { "Reduce": { "properties": { "axis": { "format": "uint", "minimum": 0, "type": "integer" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_TensorReduceKind" } }, "required": [ "axis", "kind" ], "type": "object" } }, "required": [ "Reduce" ], "type": "object" }, { "additionalProperties": false, "properties": { "Elementwise": { "properties": { "op": { "$ref": "#/components/schemas/ResDef_Query_TensorElementwiseOp" }, "scalar": { "format": "double", "type": "number" } }, "required": [ "op", "scalar" ], "type": "object" } }, "required": [ "Elementwise" ], "type": "object" } ] }, "ResDef_Query_TensorReduceKind": { "description": "TENSOR \u2014 how `TensorOpKind::Reduce` collapses one axis (CONCEPT:EG-KG.storage.content-addressed-dedup). Mirrors\neg-tensor's `ReduceKind`, but defined HERE (pure serde, no eg-tensor dep) so the\nwire stays Pi-safe; the executor maps it to eg-tensor's enum behind eg-plan's\n`tensor` gate.", "enum": [ "Sum", "Mean", "Max", "Min" ], "type": "string" }, "ResDef_Query_Term": { "additionalProperties": false, "description": "One `coefficient \u00b7 variable` term of a linear row.", "properties": { "coefficient": { "format": "int64", "type": "integer" }, "var": { "$ref": "#/components/schemas/ResDef_Query_VarId" } }, "required": [ "var", "coefficient" ], "type": "object" }, "ResDef_Query_TerminalOutcomeExtension": { "additionalProperties": false, "description": "Explicit optional extension for the current terminal WorkItem contract.\n\nThe protocol owner may add this as one `#[serde(default)]` field on the\nexisting terminal method. Keeping the extension grouped and optional\nmakes the generated contract change visible without changing the native\nterminal method's identity fields or inventing a second commit operation.", "properties": { "outcome_bundle": { "$ref": "#/components/schemas/ResDef_Query_CommitOutcomeBundle" }, "receipt_nodes": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Query_ReceiptNode" }, "type": "array" }, "run_event": { "$ref": "#/components/schemas/ResDef_Query_RunEvent", "description": "The one durable RunEvent carried by the native mutation outbox." } }, "required": [ "outcome_bundle", "run_event" ], "type": "object" }, "ResDef_Query_TextAlgorithm": { "description": "Which text-mining engine `MineText` runs (CONCEPT:EG-KG.mining.tfidf \u2014 Phase\n4). TF-IDF is the default (descriptive per-document term weights); `lda`/\n`nmf` fit a `k`-topic model.", "enum": [ "tfidf", "lda", "nmf" ], "type": "string" }, "ResDef_Query_TextSource": { "description": "A graph-derived text source for `MineText` (CONCEPT:EG-KG.mining.tfidf \u2014\nPhase 4). Each node carrying `node_label` contributes one document: its\n`field` string property, tokenized (lowercase, alnum-run split).", "properties": { "field": { "description": "The string property to tokenize into the document.", "type": "string" }, "limit": { "description": "Cap the number of nodes scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances each contribute one document.", "type": "string" } }, "required": [ "node_label", "field" ], "type": "object" }, "ResDef_Query_TimeAxis": { "description": "Which timeline an [`Op::AsOf`] instant pins (bi-temporal, KG-2.250).", "oneOf": [ { "const": "Valid", "description": "Valid (event) time \u2014 \"what was TRUE at the instant\" (`valid_from`/`valid_until`).", "type": "string" }, { "const": "Transaction", "description": "Transaction time \u2014 \"what we BELIEVED at the instant\" (`tx_from`/`tx_to`).", "type": "string" } ] }, "ResDef_Query_TimeSeriesWindowRef": { "additionalProperties": false, "properties": { "series_id": { "type": "string" }, "source_revision": { "type": "string" }, "window_end": { "type": "string" }, "window_start": { "type": "string" } }, "required": [ "series_id", "window_start", "window_end", "source_revision" ], "type": "object" }, "ResDef_Query_ToolEffect": { "description": "Whether invoking a tool can change anything.\n\nNot a hint. A read-only agent graph is one whose reachable tools are all\n[`ToolEffect::Read`], and that is a property worth being able to prove\nbefore a run rather than discover during one.", "enum": [ "read", "write" ], "type": "string" }, "ResDef_Query_ToolsetTransport": { "description": "Where a toolset's tools come from.", "oneOf": [ { "const": "mcp", "description": "An MCP server.", "type": "string" }, { "const": "function", "description": "In-process functions.", "type": "string" }, { "const": "skill", "description": "A skill pack.", "type": "string" } ] }, "ResDef_Query_TraceFidelity": { "description": "How complete the recorded trace is.", "oneOf": [ { "additionalProperties": false, "description": "Every step is present.", "properties": { "fidelity": { "const": "full_step", "type": "string" } }, "required": [ "fidelity" ], "type": "object" }, { "additionalProperties": false, "description": "Steps were dropped to stay inside the record bound; each is named.", "properties": { "dropped": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_16" }, "fidelity": { "const": "truncated", "type": "string" } }, "required": [ "fidelity", "dropped" ], "type": "object" } ] }, "ResDef_Query_TraceFidelityLevel": { "description": "How much of a run's trace has to survive for its outcome to count as a\nlabel. Mirrors the record's own [`super::TraceFidelity`] at policy\ngranularity.", "enum": [ "full_step", "tool_calls", "final_output" ], "type": "string" }, "ResDef_Query_TransactionSource": { "description": "A graph-derived transaction source for `MineAssociate` (CONCEPT:EG-KG.mining.graph-derived-transactions).\n\nEach node carrying `node_label` becomes one \"basket owner\"; the basket is the set\nof `item_field` values gathered from its neighbors (following edges in\n`direction`), optionally filtered to a `relation`. This turns node neighborhoods\ninto transactions so mining runs directly over resident graph data \u2014 the\ncross-modal hook (e.g. \"for each :Capability, the set of concepts it touches\" =\none transaction \u21d2 concept-co-occurrence rules).", "properties": { "direction": { "default": "out", "description": "Edge direction to gather neighbors: `out` (successors, default), `in`\n(predecessors), or `any` (both).", "type": "string" }, "item_field": { "description": "Which value of each neighbor becomes an item: `label` (the neighbor's\ntype/label, default) or `prop:` (a neighbor property value). When\n`None`, the neighbor's node id is used verbatim.", "type": [ "string", "null" ] }, "limit": { "description": "Cap the number of basket owners scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances each become one transaction/basket owner.", "type": "string" }, "relation": { "description": "Optional edge-relation filter: only follow edges whose `relationship`\nproperty equals this. `None` \u21d2 all edges.", "type": [ "string", "null" ] } }, "required": [ "node_label" ], "type": "object" }, "ResDef_Query_TransitionControlLeaseRequest": { "additionalProperties": false, "description": "`TransitionControlLease`: consume or end a lease, CAS on its read revision.", "properties": { "expected_revision": { "description": "The `revision` of the view the caller decided on.", "format": "uint64", "minimum": 0, "type": "integer" }, "idempotency_key": { "description": "Caller-stable retry identity for this transition.", "type": "string" }, "lease_id": { "type": "string" }, "tenant": { "description": "Must equal the verified request tenant.", "type": "string" }, "to": { "$ref": "#/components/schemas/ResDef_Query_ControlLeaseTarget" } }, "required": [ "tenant", "lease_id", "expected_revision", "to", "idempotency_key" ], "type": "object" }, "ResDef_Query_TreeNode": { "description": "A flat regression tree: node `i` is a leaf when `feature < 0`.", "properties": { "feature": { "format": "int64", "type": "integer" }, "left": { "format": "int64", "type": "integer" }, "right": { "format": "int64", "type": "integer" }, "threshold": { "format": "double", "type": "number" }, "value": { "format": "double", "type": "number" } }, "required": [ "feature", "threshold", "left", "right", "value" ], "type": "object" }, "ResDef_Query_TypedParam": { "additionalProperties": false, "description": "One named parameter of a question.", "properties": { "name": { "type": "string" }, "value": { "$ref": "#/components/schemas/ResDef_Query_TypedValue" } }, "required": [ "name", "value" ], "type": "object" }, "ResDef_Query_TypedValue": { "description": "A typed question parameter. Values are typed, never substituted into text:\na parameter cannot become part of a prompt or a query string.", "oneOf": [ { "properties": { "type": { "const": "bool", "type": "string" }, "value": { "type": "boolean" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "int", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "text", "type": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "iri", "type": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "iri_list", "type": "string" }, "value": { "$ref": "#/components/schemas/ResDef_Query_BoundedVec_string_64" } }, "required": [ "type", "value" ], "type": "object" }, { "properties": { "type": { "const": "rational", "type": "string" }, "value": { "$ref": "#/components/schemas/ResDef_Query_UnitRationalWire" } }, "required": [ "type", "value" ], "type": "object" } ] }, "ResDef_Query_UnitRationalWire": { "additionalProperties": false, "description": "An exact rational in `[0, 1]`: `numerator / denominator`.\n\nValidated on the way in rather than at each use site, because it appears in\nsix different records and a per-site check is a check that one of them\neventually forgets.", "properties": { "denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "numerator": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "numerator", "denominator" ], "type": "object" }, "ResDef_Query_UnknownCostRule": { "description": "What an unknown cost means when a budget is in force.", "oneOf": [ { "const": "exclude_when_strict", "description": "A strict budget excludes every candidate whose cost is unknown.", "type": "string" }, { "const": "rank_below_known", "description": "An unknown cost ranks below every known one, and is never read as zero.", "type": "string" } ] }, "ResDef_Query_VarId": { "description": "Index of a binary decision variable (its position in [`ModelSpec::variables`]).", "format": "uint32", "minimum": 0, "type": "integer" }, "ResDef_Query_VectorSource": { "description": "A graph-derived VECTOR source for `MineCluster` / `MineAnomaly`\n(CONCEPT:EG-KG.mining.node-embedding-source). Each node carrying `node_label`\ncontributes ONE feature row = its stored embedding vector, and its node id is\ncarried alongside so write-back can link the mined `:Cluster` / `:Anomaly` node\nback to it. This is the cross-modal hook \u2014 \"cluster / anomaly-detect the\nembeddings of these nodes\" runs compute-near-data over resident vectors.", "properties": { "limit": { "description": "Cap the number of nodes scanned (0 = uncapped).", "format": "uint", "minimum": 0, "type": "integer" }, "node_label": { "description": "The node label whose instances each contribute one embedding row.", "type": "string" } }, "required": [ "node_label" ], "type": "object" }, "ResDef_Query_VersionExpectation": { "description": "Explicit OCC semantics captured before validation.", "oneOf": [ { "additionalProperties": false, "properties": { "graph": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "graph" ], "type": "object" }, { "additionalProperties": false, "properties": { "native": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "native" ], "type": "object" }, { "const": "unversioned", "description": "Valid only for a capability-bearing reserved-system operation.", "type": "string" } ] }, "ResDef_Query_Violation": { "description": "Why a candidate was removed before the solver ran.", "oneOf": [ { "additionalProperties": false, "description": "The request denied this component id.", "properties": { "violation": { "const": "denied", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "The component is withdrawn by its connector pack.", "properties": { "violation": { "const": "withdrawn", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "The component revision is retired.", "properties": { "violation": { "const": "retired", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "An external agent without the observation its policy requires.", "properties": { "violation": { "const": "ineligible_external_agent", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "available": { "format": "uint64", "minimum": 0, "type": "integer" }, "required": { "format": "uint64", "minimum": 0, "type": "integer" }, "violation": { "const": "context_window_too_small", "type": "string" } }, "required": [ "violation", "required", "available" ], "type": "object" }, { "additionalProperties": false, "properties": { "violation": { "const": "missing_tool_support", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "violation": { "const": "missing_structured_output", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "iri": { "type": "string" }, "violation": { "const": "missing_modality", "type": "string" } }, "required": [ "violation", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "Its cost is unknown and the budget is strict.", "properties": { "violation": { "const": "unknown_cost_under_strict_budget", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "level": { "$ref": "#/components/schemas/ResDef_Query_ObjectiveLevelKind" }, "violation": { "const": "over_budget", "type": "string" } }, "required": [ "violation", "level" ], "type": "object" }, { "additionalProperties": false, "description": "A template rule refused this component in this slot.", "properties": { "code": { "type": "string" }, "violation": { "const": "template_validation", "type": "string" } }, "required": [ "violation", "code" ], "type": "object" }, { "additionalProperties": false, "description": "A latency ceiling is in force and the component declares no p95. An\nundeclared latency is never read as zero.", "properties": { "violation": { "const": "unknown_latency_under_budget", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "Forcing this component into the assembly leaves no feasible answer.", "properties": { "violation": { "const": "infeasible_when_forced", "type": "string" } }, "required": [ "violation" ], "type": "object" } ] }, "ResDef_Query_VizColumnValues": { "description": "One column's values for [`VizDatasetSource::InlineColumns`] \u2014 mirrors\n`eg_viz_columnstore::ColumnData`'s two most common variants. This crate stays\ndependency-free; the handler converts to the real type at the verified\nboundary.", "oneOf": [ { "additionalProperties": false, "properties": { "F64": { "items": { "format": "double", "type": "number" }, "type": "array" } }, "required": [ "F64" ], "type": "object" }, { "additionalProperties": false, "properties": { "Utf8": { "items": { "type": "string" }, "type": "array" } }, "required": [ "Utf8" ], "type": "object" } ] }, "ResDef_Query_VizDatasetSource": { "description": "Where `VizOp::Render` gets its rows from.", "oneOf": [ { "additionalProperties": false, "description": "Caller-supplied columns, ingested verbatim into a fresh per-request\n`ColumnStore` under `VizRenderRequest::dataset_ref`.", "properties": { "InlineColumns": { "properties": { "columns": { "additionalProperties": { "$ref": "#/components/schemas/ResDef_Query_VizColumnValues" }, "type": "object" } }, "required": [ "columns" ], "type": "object" } }, "required": [ "InlineColumns" ], "type": "object" }, { "additionalProperties": false, "description": "A deterministic, seeded, ENGINE-SIDE-generated clustered scatter dataset \u2014\nnever shipped over the wire \u2014 proving high-density rendering without a\nhuge request payload. Produces `x`/`y` F64 columns with `clusters`\ndistinct Gaussian-ish blobs.", "properties": { "SyntheticScatterClusters": { "properties": { "clusters": { "format": "uint32", "minimum": 0, "type": "integer" }, "row_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "row_count", "clusters", "seed" ], "type": "object" } }, "required": [ "SyntheticScatterClusters" ], "type": "object" }, { "additionalProperties": false, "description": "A deterministic, seeded, ENGINE-SIDE-generated random graph (node ids\n`0..node_count`, `edge_count` edges, no self-loops, dedup not required) \u2014\nthe `MarkKind::Graph` V6-lite demo path. See `src/server/handlers/viz.rs`'s\nmodule doc for the exact dataset/column shape this ingests as.", "properties": { "SyntheticGraph": { "properties": { "edge_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "node_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "seed": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_count", "edge_count", "seed" ], "type": "object" } }, "required": [ "SyntheticGraph" ], "type": "object" } ] }, "ResDef_Query_VizFormat": { "description": "Static export raster/vector format \u2014 mirrors `eg_viz_core::StaticExportFormat`\nfield-for-field, INCLUDING its `rename_all = \"snake_case\"` wire casing (so a\ncaller sends `\"png\"`/`\"svg\"`/`\"pdf\"`, not `\"Png\"`/`\"Svg\"`/`\"Pdf\"`). This crate\nstays dependency-free (no `eg-viz-core` dep), so the variant is not reused\ndirectly; the handler converts one-to-one.", "enum": [ "png", "svg", "pdf" ], "type": "string" }, "ResDef_Query_VizOp": { "description": "The native-visualization render control-plane operation (D-VZ-1, full V4).", "oneOf": [ { "additionalProperties": false, "description": "Resolve a `ViewSpec` against a dataset and render it to static image bytes.", "properties": { "Render": { "$ref": "#/components/schemas/ResDef_Query_VizRenderRequest" } }, "required": [ "Render" ], "type": "object" }, { "const": "CapabilityMatrix", "description": "Fetch the mark x surface capability matrix\n(`eg_viz_core::CapabilityMatrix::default_matrix`) \u2014 what a planner/UI reads\nto know which (mark, surface) pairs are real today.", "type": "string" }, { "additionalProperties": false, "description": "Look up a previously-produced render's durable provenance (lane V4) by\nthe `result_ref` a `VizOp::Render` response returned. Answers `None`\n(not an error) for an unknown/never-produced `result_ref`.", "properties": { "RenderProvenance": { "properties": { "result_ref": { "type": "string" } }, "required": [ "result_ref" ], "type": "object" } }, "required": [ "RenderProvenance" ], "type": "object" } ] }, "ResDef_Query_VizRenderRequest": { "description": "One `VizOp::Render` request: an opaque `eg_viz_core::ViewSpec` (as JSON \u2014 the\nhandler parses + validates it), which dataset to resolve it against, the\ntarget canvas size, the output format, and the frame budget\n`eg_viz_core::select_tier` resolves against.", "properties": { "dataset": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_VizDatasetSource" }, { "type": "null" } ], "default": null, "description": "`None` \u21d2 resolve against a `dataset_ref` this engine already has\nresident from an earlier request (lane V4's persistent ColumnStore \u2014\nsee `src/server/handlers/viz.rs`'s module doc); an unknown\n`dataset_ref` with no data supplied is a clear, typed \"unavailable\"\nerror, never a fabricated empty render. `Some` ingests (or\nre-ingests \u2014 content-addressed, so byte-identical data is a cheap\nno-op for the render cache) the given data under `dataset_ref` first." }, "dataset_ref": { "type": "string" }, "format": { "$ref": "#/components/schemas/ResDef_Query_VizFormat" }, "height_px": { "format": "uint32", "minimum": 0, "type": "integer" }, "max_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_primitives": { "format": "uint64", "minimum": 0, "type": "integer" }, "spec_json": { "description": "A caller-provided `eg_viz_core::ViewSpec`, as JSON. Opaque here (this\ncrate has no `eg-viz-core` dependency); the handler\n`serde_json::from_value`s and `ViewSpec::validate()`s it at the verified\nboundary, exactly as documented as unsupported here for silent misparse." }, "width_px": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "spec_json", "width_px", "height_px", "format", "max_primitives", "max_bytes", "dataset_ref" ], "type": "object" }, "ResDef_Query_WeightedLevel": { "additionalProperties": false, "description": "One weighted objective level.", "properties": { "level": { "$ref": "#/components/schemas/ResDef_Query_ObjectiveLevelKind" }, "weight": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "level", "weight" ], "type": "object" }, "ResDef_Query_WhatChangedResult": { "description": "Materialized result of a `Method::WhatChanged` run. Returned via\n`ResultPayload::raw`.", "properties": { "changed": { "items": { "$ref": "#/components/schemas/ResDef_Query_ChangedBeliefWire" }, "type": "array" } }, "required": [ "changed" ], "type": "object" }, "ResDef_Query_WhyNot": { "additionalProperties": false, "description": "Why one candidate did not win its slot.", "properties": { "component_id": { "type": "string" }, "forced_objective": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ObjectiveValue" }, { "type": "null" } ], "default": null, "description": "The objective it would have forced, when it was feasible but worse." }, "slot": { "type": "string" }, "violation": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_Violation" }, { "type": "null" } ], "default": null, "description": "The rule that removed it, when it was not feasible at all." } }, "required": [ "component_id", "slot" ], "type": "object" }, "ResDef_Query_WhyNotWire": { "description": "Wire mirror of `eg_epistemic::query::WhyNot` \u2014 flattens `WhyNotReason`'s per-variant\npayload (`Contradicted { blockers }` / `Undecided { competing }`) into two plain\n`Vec` fields, each empty unless the matching reason tag applies (a pure-serde\nenum-with-data mirror would work too, but this keeps the wire shape flat like every\nother `*Wire` type here).", "properties": { "blockers": { "description": "Populated iff `reason == \"Contradicted\"`.", "items": { "type": "string" }, "type": "array" }, "claim": { "type": "string" }, "competing": { "description": "Populated iff `reason == \"Undecided\"`.", "items": { "type": "string" }, "type": "array" }, "confidence": { "format": "double", "type": "number" }, "reason": { "description": "One of `\"Unknown\"`, `\"InsufficientConfidence\"`, `\"Contradicted\"`, `\"Undecided\"`.", "type": "string" } }, "required": [ "claim", "reason", "blockers", "competing", "confidence" ], "type": "object" }, "ResDef_Query_WorkItemClaimCapabilityMintRequest": { "additionalProperties": false, "description": "Native mint input. The authenticated worker/session and current lease\nauthority are deliberately absent: only the engine can derive them.", "properties": { "schema_version": { "$ref": "#/components/schemas/ResDef_Query_WorkItemClaimCapabilityRequestSchemaVersion" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "work_item_id" ], "type": "object" }, "ResDef_Query_WorkItemClaimCapabilityRequestSchemaVersion": { "description": "Versioned native capability request. The engine derives every authority\nfield (tenant, owner, lease epoch/fence, attempt, and expiry) from the\nauthenticated request context and the live WorkItem row; callers provide\nonly the opaque WorkItem identifier.", "enum": [ "1" ], "type": "string" }, "ResDef_Query_WorkItemClaimCapabilityVerifyRequest": { "additionalProperties": false, "description": "Native verify input. The capability is an opaque bounded byte string; no\npublic DTO can reconstruct authority from owner/epoch/fence/attempt fields.", "properties": { "capability": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "schema_version": { "$ref": "#/components/schemas/ResDef_Query_WorkItemClaimCapabilityRequestSchemaVersion" }, "work_item_id": { "type": "string" } }, "required": [ "schema_version", "work_item_id", "capability" ], "type": "object" }, "ResDef_Query_WriteBackAttempt": { "additionalProperties": false, "properties": { "applied_field_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "change_set_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "change_set_id": { "type": "string" }, "connector_observation_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "effect_status": { "$ref": "#/components/schemas/ResDef_Query_WriteBackEffectStatus" }, "idempotency_key": { "type": "string" }, "input_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "kind": { "$ref": "#/components/schemas/ResDef_Query_WriteBackAttemptKind" }, "outcome": { "$ref": "#/components/schemas/ResDef_Query_WriteBackOutcome" }, "output_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "post_source_version": { "type": "string" }, "pre_source_version": { "type": "string" }, "provenance_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "change_set_id", "change_set_digest", "idempotency_key", "kind", "input_digest", "output_digest", "pre_source_version", "post_source_version", "applied_field_digest", "outcome", "effect_status", "connector_observation_digest", "provenance_digest" ], "type": "object" }, "ResDef_Query_WriteBackAttemptKind": { "enum": [ "dry_run", "apply" ], "type": "string" }, "ResDef_Query_WriteBackAuthorizationDecision": { "additionalProperties": false, "properties": { "authorization_ref": { "type": "string" }, "authorized": { "type": "boolean" }, "decision_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "input_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" }, "mode": { "$ref": "#/components/schemas/ResDef_Query_WriteBackAuthorizationMode" }, "output_digest": { "$ref": "#/components/schemas/ResDef_Query_Digest256" } }, "required": [ "mode", "authorization_ref", "decision_digest", "input_digest", "output_digest", "authorized" ], "type": "object" }, "ResDef_Query_WriteBackAuthorizationMode": { "enum": [ "proposal_approval", "standing_policy", "manual_trigger" ], "type": "string" }, "ResDef_Query_WriteBackEffectStatus": { "enum": [ "no_effect", "applied", "outcome_uncertain" ], "type": "string" }, "ResDef_Query_WriteBackOp": { "oneOf": [ { "additionalProperties": false, "properties": { "change_set": { "$ref": "#/components/schemas/ResDef_Query_SourceChangeSet" }, "op": { "const": "create", "type": "string" } }, "required": [ "op", "change_set" ], "type": "object" }, { "additionalProperties": false, "properties": { "change_set_id": { "type": "string" }, "op": { "const": "get", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "change_set_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "attempt": { "$ref": "#/components/schemas/ResDef_Query_WriteBackAttempt" }, "op": { "const": "record_attempt", "type": "string" } }, "required": [ "op", "attempt" ], "type": "object" }, { "additionalProperties": false, "properties": { "observation": { "$ref": "#/components/schemas/ResDef_Query_ReconciliationObservation" }, "op": { "const": "record_reconciliation", "type": "string" } }, "required": [ "op", "observation" ], "type": "object" }, { "additionalProperties": false, "properties": { "after_sequence": { "default": 0, "format": "uint64", "minimum": 0, "type": "integer" }, "change_set_id": { "type": "string" }, "limit": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "op": { "const": "receipts", "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "op", "tenant_id", "change_set_id", "limit" ], "type": "object" } ] }, "ResDef_Query_WriteBackOutcome": { "enum": [ "dry_run_ready", "applied", "conflict", "rejected", "outcome_uncertain" ], "type": "string" }, "ResDef_Query_YearData": { "description": "One fiscal year of standardized financial-statement inputs (forensic scores).", "properties": { "cfo": { "format": "double", "type": "number" }, "cogs": { "format": "double", "type": "number" }, "current_assets": { "format": "double", "type": "number" }, "current_liabilities": { "format": "double", "type": "number" }, "depreciation": { "format": "double", "type": "number" }, "ebit": { "format": "double", "type": "number" }, "long_term_debt": { "format": "double", "type": "number" }, "market_cap": { "format": "double", "type": "number" }, "net_income": { "format": "double", "type": "number" }, "ppe_net": { "format": "double", "type": "number" }, "receivables": { "format": "double", "type": "number" }, "retained_earnings": { "format": "double", "type": "number" }, "sales": { "format": "double", "type": "number" }, "sga": { "format": "double", "type": "number" }, "shares": { "format": "double", "type": "number" }, "total_assets": { "format": "double", "type": "number" }, "total_liabilities": { "format": "double", "type": "number" } }, "required": [ "sales", "cogs", "sga", "net_income", "cfo", "receivables", "current_assets", "current_liabilities", "ppe_net", "depreciation", "total_assets", "total_liabilities", "long_term_debt", "retained_earnings", "ebit", "market_cap", "shares" ], "type": "object" }, "ResDef_Reasoning_BoundedVec_GraphSchemaSourceView_32": { "items": { "$ref": "#/components/schemas/ResDef_Reasoning_GraphSchemaSourceView" }, "maxItems": 32, "type": "array" }, "ResDef_Reasoning_DatalogReasoningResult": { "description": "Result of `Method::RunDatalogReasoning`: every inferred triple, each a string map\n(`subject`, `predicate`, `object`, `inference_type`), and their count.", "properties": { "inferred_count": { "format": "uint", "minimum": 0, "type": "integer" }, "inferred_triples": { "items": { "additionalProperties": { "type": "string" }, "type": "object" }, "type": "array" }, "schema_digests": { "description": "Exact committed GraphSchema identity used when the request omitted\nad-hoc rules. Explicit caller-supplied rule programs carry an empty set.", "items": { "type": "string" }, "type": "array" } }, "required": [ "schema_digests", "inferred_count", "inferred_triples" ], "type": "object" }, "ResDef_Reasoning_GraphSchemaCommitted": { "additionalProperties": false, "description": "What one attach or detach committed.", "properties": { "changed": { "description": "False when the request was a no-op against the current set.", "type": "boolean" }, "composed_digest": { "type": "string" }, "graph": { "type": "string" }, "graph_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "graph", "composed_digest", "graph_version", "changed" ], "type": "object" }, "ResDef_Reasoning_GraphSchemaSourceView": { "additionalProperties": false, "description": "One attached source, without its documents.", "properties": { "attached_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "ontology_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "ontology_sha256": { "default": null, "type": [ "string", "null" ] }, "origin": { "$ref": "#/components/schemas/ResDef_Reasoning_SchemaSourceOriginView" }, "shapes_bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "shapes_sha256": { "default": null, "type": [ "string", "null" ] }, "source_id": { "type": "string" } }, "required": [ "source_id", "origin", "shapes_bytes", "ontology_bytes", "attached_at_ms" ], "type": "object" }, "ResDef_Reasoning_GraphSchemaSourcesView": { "additionalProperties": false, "description": "The graph's whole schema-source set.", "properties": { "composed_digest": { "description": "Identity of the exact core+dynamic composition.", "type": "string" }, "core_catalog_digest": { "description": "Identity of the binary-owned catalog, independent of graph attachments.", "type": "string" }, "core_sources": { "$ref": "#/components/schemas/ResDef_Reasoning_BoundedVec_GraphSchemaSourceView_32" }, "dynamic_sources": { "$ref": "#/components/schemas/ResDef_Reasoning_BoundedVec_GraphSchemaSourceView_32" }, "graph": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "graph", "core_catalog_digest", "composed_digest", "core_sources", "dynamic_sources" ], "type": "object" }, "ResDef_Reasoning_OwlExplainResult": { "description": "Materialized result of a `Method::OwlExplain` run (CONCEPT:EG-KG.ontology.owl-proof-tree-explanation). Returned\nvia `ResultPayload::raw`. `tree` is `None` when `sub \u2291 sup` does not hold (nothing\nto explain) \u2014 `found` mirrors that as a convenience boolean for callers that only\njson-decode the top level.", "properties": { "consistent": { "description": "`true` iff the classified ontology is consistent.", "type": "boolean" }, "found": { "description": "Whether `sub \u2291 sup` holds under the classification (`tree.is_some()`).", "type": "boolean" }, "schema_digests": { "description": "Exact composed GraphSchema authority used to build this proof.", "items": { "type": "string" }, "type": "array" }, "tree": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Reasoning_ProofNodeWire" }, { "type": "null" } ], "description": "The reconstructed proof tree, or `None` when `sub \u2291 sup` does not hold." }, "unsatisfiable": { "description": "Named classes derived to be unsatisfiable; empty when consistent.", "items": { "type": "string" }, "type": "array" } }, "required": [ "schema_digests", "found", "consistent", "unsatisfiable" ], "type": "object" }, "ResDef_Reasoning_OwlPropertyFact": { "description": "Materialized result of a `Method::OwlReason` run (CONCEPT:EG-KG.ontology.incremental-materialization). Returned via\n`ResultPayload::raw`. The reasoner lives in eg-rdf; this is the wire projection.", "properties": { "asserted": { "type": "boolean" }, "axiom": { "type": [ "string", "null" ] }, "object": { "type": "string" }, "predicate": { "type": "string" }, "premises": { "description": "Ordered fact triples consumed by the first deterministic derivation.", "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "rule": { "description": "`asserted`, `RL-subPropertyOf`, `RL-symmetric`, `RL-inverseOf`, or\n`RL-propertyChain`.", "type": "string" }, "subject": { "type": "string" } }, "required": [ "subject", "predicate", "object", "asserted", "rule", "premises" ], "type": "object" }, "ResDef_Reasoning_OwlReasonResult": { "description": "Materialized result of a `Method::OwlReason` run (CONCEPT:EG-KG.ontology.incremental-materialization). Returned via\n`ResultPayload::raw`. The reasoner lives in eg-rdf; this is the wire projection.", "properties": { "consistent": { "description": "`true` iff the ontology is consistent (no class forced to subsume `owl:Nothing`).", "type": "boolean" }, "direct_subclasses": { "description": "Direct named `rdfs:subClassOf` axioms in the classified TBox, before\ntransitive closure. Capability routing uses these edges to preserve an\nexplainable shortest path while `subclasses` remains the full closure.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "instance_conf": { "description": "Per-membership confidence in `[0,1]` (CONCEPT:EG-KG.ontology.concept-13), ALIGNED index-for-index\nwith `instances`: the type fact's confidence (per-node confidence \u00d7 Ebbinghaus\ndecay) \u00d7 the subsumption confidence \u2014 so an old/decayed or weakly-asserted fact\nyields a lower-confidence membership.", "items": { "format": "double", "type": "number" }, "type": "array" }, "instances": { "description": "Inferred instance memberships `(instance, class)` \u2014 every individual mapped to\nevery class it (provably) belongs to, INCLUDING classes reached only through\nexistential restrictions / role chains. When `target_class` was set, restricted\nto that class's members. Only memberships with confidence `\u2265 min_confidence`.", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "property_facts": { "description": "Asserted and inferred object-property facts. Inferred rows retain the\nrule, governing axiom and exact premise triples; `schema_digests` above\natomically binds every row to the composed ontology set used.", "items": { "$ref": "#/components/schemas/ResDef_Reasoning_OwlPropertyFact" }, "type": "array" }, "schema_digests": { "description": "Sorted, unique composed GraphSchema digests whose ontology sources were\nincluded in this classification. A single-graph call normally carries\none digest; a distributed call carries the exact set of graph schema\nauthorities it unioned. Consumers cache a derived hierarchy under this\nidentity rather than treating a copied ontology file as authority.", "items": { "type": "string" }, "type": "array" }, "subclass_conf": { "description": "Per-subsumption confidence in `[0,1]` (CONCEPT:EG-KG.ontology.concept-13), ALIGNED index-for-index\nwith `subclasses`. `1.0` for a hard/asserted subsumption; the propagated\n`axiom_conf \u00d7 \u220f premise_conf` (max over alternative derivations) for an uncertain\none. A fully-hard ontology yields all `1.0`.", "items": { "format": "double", "type": "number" }, "type": "array" }, "subclasses": { "description": "Derived named-class subsumptions `(sub, sup)` (the reflexive/asserted ones are\nincluded; the closure is the full classification hierarchy).", "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" }, "unsatisfiable": { "description": "Named classes derived to be unsatisfiable (`A \u2291 \u22a5`); empty when consistent.", "items": { "type": "string" }, "type": "array" } }, "required": [ "schema_digests", "direct_subclasses", "subclasses", "subclass_conf", "instances", "instance_conf", "property_facts", "consistent", "unsatisfiable" ], "type": "object" }, "ResDef_Reasoning_ProofNodeWire": { "description": "One node of a reconstructed OWL proof tree (CONCEPT:EG-KG.ontology.owl-proof-tree-explanation) \u2014 the wire\nprojection of `eg_rdf::owl::ProofNode`. `rule == \"asserted\"` marks a LEAF (a\nreflexive seed or a base fact with no recorded justification \u2014 the proof bottoms\nout there); any other `rule` is a completion rule name (`\"CR-sub\"`, `\"CR-some\u207a\"`,\n`\"CR-instance\"`, \u2026) that consumed `premises` (each itself a full sub-proof) plus the\ncited `axioms`. Recursive \u2014 `premises` nests to the tree's actual depth (never\nflattened), so a client walks it exactly like the reasoner derived it.", "properties": { "axioms": { "items": { "type": "string" }, "type": "array" }, "confidence": { "format": "double", "type": "number" }, "premises": { "items": { "$ref": "#/components/schemas/ResDef_Reasoning_ProofNodeWire" }, "type": "array" }, "rule": { "type": "string" }, "sub": { "type": "string" }, "sup": { "type": "string" } }, "required": [ "sub", "sup", "rule", "axioms", "confidence", "premises" ], "type": "object" }, "ResDef_Reasoning_RuleFact": { "description": "One fact in a [`RuleReasonResponse`].", "properties": { "args": { "items": { "type": "string" }, "type": "array" }, "confidence": { "format": "double", "type": "number" }, "derived": { "type": "boolean" }, "predicate": { "type": "string" } }, "required": [ "predicate", "args", "confidence", "derived" ], "type": "object" }, "ResDef_Reasoning_RuleReasonResponse": { "description": "The serialisable rule-reasoning response.", "properties": { "conflicts": { "items": { "type": "string" }, "type": "array" }, "consistent": { "type": "boolean" }, "facts": { "items": { "$ref": "#/components/schemas/ResDef_Reasoning_RuleFact" }, "type": "array" }, "registered_rules": { "items": { "type": "string" }, "type": "array" }, "same_as": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array" } }, "required": [ "facts", "same_as", "consistent", "conflicts", "registered_rules" ], "type": "object" }, "ResDef_Reasoning_SchemaSourceOriginView": { "description": "Who attached one source.", "oneOf": [ { "additionalProperties": false, "properties": { "module": { "type": "string" }, "origin": { "const": "core", "type": "string" }, "set_digest": { "type": "string" }, "version": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "origin", "module", "version", "set_digest" ], "type": "object" }, { "additionalProperties": false, "description": "The pre-X9 integrity policy, lifted into a keyed source.", "properties": { "origin": { "const": "operator", "type": "string" } }, "required": [ "origin" ], "type": "object" }, { "additionalProperties": false, "properties": { "name": { "type": "string" }, "origin": { "const": "admin", "type": "string" } }, "required": [ "origin", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "connector": { "type": "string" }, "origin": { "const": "pack", "type": "string" }, "record_id": { "type": "string" } }, "required": [ "origin", "connector", "record_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "mapping": { "type": "string" }, "origin": { "const": "ingestion", "type": "string" }, "revision": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "origin", "mapping", "revision" ], "type": "object" } ] }, "ResDef_Reasoning_ShaclSeverity": { "description": "SHACL result severity -- `sh:Violation` / `sh:Warning` / `sh:Info`.", "enum": [ "Violation", "Warning", "Info" ], "type": "string" }, "ResDef_Reasoning_ShaclValidationReport": { "description": "An `sh:ValidationReport` (`Method::ShaclValidate`).", "properties": { "composed_digest": { "description": "The request graph's composed digest when committed GraphSchema shapes\nwere used; absent only for explicit ad-hoc shapes.", "type": [ "string", "null" ] }, "conforms": { "description": "`sh:conforms` -- true iff there are no results.", "type": "boolean" }, "results": { "description": "The `sh:result` list.", "items": { "$ref": "#/components/schemas/ResDef_Reasoning_ShaclValidationResult" }, "type": "array" }, "schema_digests": { "description": "Sorted unique document digests of every committed SHACL source used by\nthis validation. Explicit ad-hoc shapes carry none, so governance\nconsumers can fail closed rather than mistaking caller-supplied\nconstraints for committed authority.", "items": { "type": "string" }, "type": "array" } }, "required": [ "schema_digests", "conforms", "results" ], "type": "object" }, "ResDef_Reasoning_ShaclValidationResult": { "description": "One `sh:ValidationResult`. Terms are N-Triples lexical forms.", "properties": { "constraint_component": { "description": "`sh:sourceConstraintComponent`.", "type": "string" }, "focus_node": { "description": "`sh:focusNode`.", "type": "string" }, "message": { "description": "`sh:resultMessage`.", "type": [ "string", "null" ] }, "path": { "description": "`sh:resultPath`, for a property-shape result.", "type": [ "string", "null" ] }, "severity": { "$ref": "#/components/schemas/ResDef_Reasoning_ShaclSeverity", "description": "`sh:resultSeverity`." }, "source_shape": { "description": "`sh:sourceShape`.", "type": "string" }, "value": { "description": "`sh:value`, when the constraint component reports one.", "type": [ "string", "null" ] } }, "required": [ "focus_node", "source_shape", "constraint_component", "severity" ], "type": "object" }, "ResDef_Reasoning_ShexNodeResult": { "description": "One entry of a ShEx result shape map: one focus node tested against one shape label.", "properties": { "conforms": { "type": "boolean" }, "node": { "description": "The focus node (N-Triples term form).", "type": "string" }, "reason": { "description": "Why the node does not conform, when it does not.", "type": [ "string", "null" ] }, "shape": { "description": "The shape label (an IRI, or `START`).", "type": "string" } }, "required": [ "node", "shape", "conforms" ], "type": "object" }, "ResDef_Reasoning_ShexValidationReport": { "description": "A ShEx validation report over a whole shape map (`Method::ShexValidate`).", "properties": { "conforms": { "description": "True iff every tested (node, shape) pair conforms.", "type": "boolean" }, "results": { "description": "One result per shape-map entry, in input order.", "items": { "$ref": "#/components/schemas/ResDef_Reasoning_ShexNodeResult" }, "type": "array" } }, "required": [ "conforms", "results" ], "type": "object" }, "ResDef_Reasoning_SparqlResult": { "description": "Materialized result of a `Method::Sparql` SELECT (CONCEPT:EG-KG.ontology.concept-11). Returned via\n`ResultPayload::raw`. `vars` is the projected variable order; each row is aligned\nto `vars` with `None` for an unbound (OPTIONAL) variable. Lives in eg-types (the\nwire-DTO crate) so the protocol can embed it; the evaluator lives in eg-rdf.", "properties": { "rows": { "items": { "items": { "type": [ "string", "null" ] }, "type": "array" }, "type": "array" }, "vars": { "items": { "type": "string" }, "type": "array" } }, "required": [ "vars", "rows" ], "type": "object" }, "ResDef_Security_AgentIdentity": { "description": "Agent identity for ACL checks.", "properties": { "agent_id": { "type": "string" }, "role": { "$ref": "#/components/schemas/ResDef_Security_AgentRole" }, "roles": { "description": "RBAC role names this agent holds (CONCEPT:EG-KG.compute.feature). Expanded transitively\nthrough the role hierarchy by the policy evaluator. The field is mandatory in\nevery current wire and durable identity image; an omitted authorization claim\nis rejected during deserialization instead of being synthesized as no roles.", "items": { "type": "string" }, "type": "array" }, "teams": { "description": "Teams this agent belongs to.", "items": { "type": "string" }, "type": "array" } }, "required": [ "agent_id", "role", "teams", "roles" ], "type": "object" }, "ResDef_Security_AgentRole": { "description": "Role of an agent in the system hierarchy.", "oneOf": [ { "const": "System", "description": "System-level (can do anything).", "type": "string" }, { "additionalProperties": false, "description": "Manager agent with subordinates.", "properties": { "Manager": { "properties": { "subordinates": { "items": { "type": "string" }, "type": "array" } }, "required": [ "subordinates" ], "type": "object" } }, "required": [ "Manager" ], "type": "object" }, { "const": "Agent", "description": "Regular agent.", "type": "string" } ] }, "ResDef_Security_AuditReport": { "description": "Outcome of walking a graph's tamper-evident hash-chained audit log\n(CONCEPT:EG-KG.sharding.row-level-security, `Method::AuditVerify`). `ok` is true when every entry's stored\nhash matches the recomputed chain hash AND the sequence is contiguous from 0;\n`first_broken_seq` carries the position of the first detected break.", "properties": { "detail": { "type": "string" }, "entries": { "format": "uint64", "minimum": 0, "type": "integer" }, "first_broken_seq": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "graph": { "type": "string" }, "ok": { "type": "boolean" } }, "required": [ "graph", "ok", "entries", "detail" ], "type": "object" }, "ResDef_Security_Grant": { "description": "A grant binding a role to an (`resource`, `action`, `effect`) triple\n(CONCEPT:EG-KG.compute.feature).", "properties": { "action": { "$ref": "#/components/schemas/ResDef_Security_RbacAction" }, "effect": { "$ref": "#/components/schemas/ResDef_Security_GrantEffect" }, "resource": { "$ref": "#/components/schemas/ResDef_Security_ResourceSelector" }, "role": { "type": "string" } }, "required": [ "role", "resource", "action", "effect" ], "type": "object" }, "ResDef_Security_GrantEffect": { "description": "Whether a [`Grant`] permits or forbids the action (CONCEPT:EG-KG.compute.feature).", "enum": [ "Allow", "Deny" ], "type": "string" }, "ResDef_Security_LedgerReadResult": { "description": "Materialized result of a `Method::GetLedger` call (BUG A1, 2026-08-12: `GetLedger`\nreturned an empty list even after real mutations had committed). The prior wire\nshape was a bare `Vec`, which made \"the ledger is genuinely empty\" and\n\"the ledger could not be read for this request's scope\" indistinguishable \u2014 both\nserialized to `[]`, so a caller (e.g. `agent_utilities.workflows.epistemic_sync`'s\n`flush_ledger_to_backend`, a real production sync path) could not tell \"nothing to\nsync\" from \"I silently read nothing\". Root cause: the terminal handler\nunconditionally reads through the row-level-security PROJECTED core (built by\n`GraphReadAuthority::project_core` / `build_projection`, which constructs its\ndetached copy via `add_node_no_ledger`/`add_edge_no_ledger` and therefore never\ncarries a ledger \u2014 see that function's own doc), even though `GetLedger` is\nauthorized by its own dedicated `ledger:read` RBAC action (`eg_capabilities`)\nenforced upstream in `dispatch.rs` before any handler runs at all \u2014 the row\nprojection was a redundant SECOND gate that, instead of narrowing visibility,\ndestroyed the data outright. Because `security` (and therefore\n`GraphReadAuthority::is_active()`) is compiled into the default `full` build,\nthis fired on every request in production, unconditionally.\n\n`populated: true` means `entries` reflects the graph's REAL, authoritative\nledger (however many entries \u2014 legitimately empty when nothing has mutated\nsince the last flush/clear: that is a genuine `[]`, not a lie). `populated:\nfalse` means the ledger could not be read for this request's scope; `entries`\nis always empty in that case and callers MUST NOT treat it as \"nothing to\nsync\". Any future call site that cannot certify it is reading the\nauthoritative (non-projected) core must answer `not_populated_for_scope()`\nexplicitly rather than silently returning a `populated: true` empty list \u2014\nthat explicit branch is what stops this exact regression from shipping silent\na second time.", "properties": { "entries": { "items": { "type": "string" }, "type": "array" }, "populated": { "type": "boolean" }, "watermark": { "description": "BUG A1 follow-up (2026-08-12): the mutation ledger is a purely\nIN-MEMORY, capped ring (100k entries, drop-oldest-half \u2014 see\n`GraphTxn::push_ledger` in `eg_core::graph`) \u2014 NOT a durable change\nlog. A cold-tenant idle\noffload/hibernate cycle, `MAX_RESIDENT_GRAPHS` eviction + lazy\nrehydrate, a process restart, or simply exceeding the cap can all\nempty or truncate `entries` while the underlying mutations remain\nfully durable in redb \u2014 a typed `populated: true` alone does not\nprove `entries` is COMPLETE. `watermark`\n(`GraphCore::ledger_watermark`) is the 0-based sequence of the\nOLDEST entry `entries` can vouch for: `0` on a graph that has never\ndropped anything (from THIS in-memory instance's point of view); a\ncaller that tracks watermark across reads can detect it advancing\n(or a previously-nonzero watermark resetting to a lower value after\nan eviction/restart) as proof that history was silently dropped,\nrather than inferring completeness from `entries` merely being\nnonzero.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "populated", "entries", "watermark" ], "type": "object" }, "ResDef_Security_MerkleInclusionReport": { "description": "Result of `Method::AuditProveInclusion` (provenance anchoring, CONCEPT:EG-KG.sharding.row-level-security): a\nMerkle inclusion proof for one node against a prior provenance anchor,\nALREADY VERIFIED server-side. `verified` is the tamper signal: `false`\nwhenever the node's CURRENT durable content does not re-hash to the leaf\nfolded into `anchored_root_sha256` at anchor time \u2014 including when the node\nwas altered by an otherwise-ordinary later write, not just raw byte-level\ntampering. `included == false` only means `node_id` was never part of that\nanchor's window (a different anchor, a non-provenance node, or a node created\nafter this anchor ran) \u2014 not itself evidence of tampering.", "properties": { "anchor_seq": { "format": "uint64", "minimum": 0, "type": "integer" }, "anchored_root_sha256": { "type": "string" }, "computed_root_sha256": { "type": "string" }, "detail": { "type": "string" }, "graph": { "type": "string" }, "included": { "type": "boolean" }, "node_id": { "type": "string" }, "proof": { "items": { "$ref": "#/components/schemas/ResDef_Security_MerkleProofStep" }, "type": "array" }, "verified": { "type": "boolean" }, "window_size": { "format": "uint", "minimum": 0, "type": "integer" } }, "required": [ "graph", "node_id", "anchor_seq", "window_size", "included", "verified", "anchored_root_sha256", "computed_root_sha256", "proof", "detail" ], "type": "object" }, "ResDef_Security_MerkleProofStep": { "description": "One Merkle audit-path step, wire-encoded: a hex-encoded sibling subtree hash\nplus which side it sits on. See [`MerkleInclusionReport`].", "properties": { "sibling_sha256": { "type": "string" }, "side": { "$ref": "#/components/schemas/ResDef_Security_MerkleSide" } }, "required": [ "sibling_sha256", "side" ], "type": "object" }, "ResDef_Security_MerkleSide": { "description": "Which side of its parent a Merkle audit-path sibling sits on (provenance\nanchoring, CONCEPT:EG-KG.sharding.row-level-security). The verifier folds the running hash with each\nstep's sibling on the side named here \u2014 RFC 6962 \u00a72.1.1 Merkle audit path\nsemantics.", "enum": [ "Left", "Right" ], "type": "string" }, "ResDef_Security_RbacAction": { "description": "An action a grant permits or denies over a resource (CONCEPT:EG-KG.compute.feature).", "enum": [ "Read", "Write", "Admin" ], "type": "string" }, "ResDef_Security_RbacGrantRemoval": { "description": "`RbacAdmin` op `RemoveGrant`: whether the grant was present.", "properties": { "removed": { "type": "boolean" } }, "required": [ "removed" ], "type": "object" }, "ResDef_Security_RbacPolicyListing": { "description": "`RbacAdmin` op `List`: the whole current RBAC policy.", "properties": { "grants": { "items": { "$ref": "#/components/schemas/ResDef_Security_Grant" }, "type": "array" }, "roles": { "items": { "$ref": "#/components/schemas/ResDef_Security_Role" }, "type": "array" } }, "required": [ "roles", "grants" ], "type": "object" }, "ResDef_Security_ResourceSelector": { "description": "What a [`Grant`] applies to (CONCEPT:EG-KG.compute.feature). Ordered by [`specificity`] so the\nevaluator can implement \"most-specific-resource wins\": a named graph beats a\nlabel, which beats a glob pattern, which beats \"all\".\n\n[`specificity`]: ResourceSelector::specificity", "oneOf": [ { "const": "All", "description": "Every resource (least specific).", "type": "string" }, { "additionalProperties": false, "description": "A glob over the graph name \u2014 a single optional leading and/or trailing `*`\nwildcard (e.g. `agent:*`, `*:private`, `*log*`).", "properties": { "Pattern": { "type": "string" } }, "required": [ "Pattern" ], "type": "object" }, { "additionalProperties": false, "description": "A node label.", "properties": { "Label": { "type": "string" } }, "required": [ "Label" ], "type": "object" }, { "additionalProperties": false, "description": "One named graph (most specific).", "properties": { "Graph": { "type": "string" } }, "required": [ "Graph" ], "type": "object" } ] }, "ResDef_Security_Role": { "description": "A durable RBAC role with an optional set of parent roles forming a hierarchy\n(CONCEPT:EG-KG.compute.feature). A role transitively inherits every grant of its parents.", "properties": { "name": { "type": "string" }, "parents": { "default": [], "items": { "type": "string" }, "type": "array" } }, "required": [ "name" ], "type": "object" }, "ResDef_Storage_AbstainReason": { "description": "Why the engine declined to answer.", "oneOf": [ { "additionalProperties": false, "description": "A required capability no candidate covers.", "properties": { "iri": { "type": "string" }, "reason": { "const": "uncovered_capability", "type": "string" } }, "required": [ "reason", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "A declared capability IRI that is not a native term.", "properties": { "iri": { "type": "string" }, "reason": { "const": "unresolved_capability_iri", "type": "string" } }, "required": [ "reason", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "Free text no mapping resolved to a task.", "properties": { "reason": { "const": "unmapped_task", "type": "string" }, "text_digest": { "type": "string" } }, "required": [ "reason", "text_digest" ], "type": "object" }, { "additionalProperties": false, "description": "The constraints named cannot be satisfied together.", "properties": { "constraints": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_64" }, "reason": { "const": "infeasible", "type": "string" } }, "required": [ "reason", "constraints" ], "type": "object" }, { "additionalProperties": false, "description": "The search budget ran out above the accepted gap.", "properties": { "incumbent": { "default": null, "type": [ "string", "null" ] }, "lower_bound": { "$ref": "#/components/schemas/ResDef_Storage_Scalar" }, "reason": { "const": "budget_exhausted", "type": "string" } }, "required": [ "reason", "lower_bound" ], "type": "object" }, { "additionalProperties": false, "description": "A fact the objective needs is absent on a candidate.", "properties": { "component_id": { "type": "string" }, "field": { "type": "string" }, "reason": { "const": "unknown_fact", "type": "string" } }, "required": [ "reason", "component_id", "field" ], "type": "object" }, { "additionalProperties": false, "description": "An external agent without its required observation.", "properties": { "component_id": { "type": "string" }, "reason": { "const": "ineligible_external_agent", "type": "string" } }, "required": [ "reason", "component_id" ], "type": "object" }, { "additionalProperties": false, "description": "The record itself would exceed the durable record bound.", "properties": { "bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "reason": { "const": "record_too_large", "type": "string" } }, "required": [ "reason", "bytes" ], "type": "object" }, { "additionalProperties": false, "description": "The request tried to widen the pinned policy.", "properties": { "field": { "type": "string" }, "reason": { "const": "policy_loosening", "type": "string" } }, "required": [ "reason", "field" ], "type": "object" }, { "additionalProperties": false, "description": "Statistical: below the policy's support, coverage or risk floor. It\nnames no invisible data, by construction.", "properties": { "reason": { "const": "insufficient_confidence", "type": "string" } }, "required": [ "reason" ], "type": "object" } ] }, "ResDef_Storage_AgentComponentCommittedResult": { "additionalProperties": false, "description": "What a committed component mutation returns.", "properties": { "batch_id": { "type": "string" }, "committed_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "component": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentEntry" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "component", "batch_id", "committed_version" ], "type": "object" }, "ResDef_Storage_AgentComponentContentResult": { "additionalProperties": false, "description": "One component revision's bytes and the identity they were served under.", "properties": { "body": { "description": "At most [`MAX_COMPONENT_BODY_BYTES`].", "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" }, "component_id": { "type": "string" }, "content_digest": { "description": "`sha256:`, verified by the engine against the bytes it is sending.", "type": "string" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "media_type": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "component_id", "entry_revision", "definition_digest", "content_digest", "media_type", "body" ], "type": "object" }, "ResDef_Storage_AgentComponentEntry": { "additionalProperties": false, "description": "One durable, published component revision.", "properties": { "actor_scope": { "type": "string" }, "attributes": { "additionalProperties": { "type": "string" }, "default": {}, "type": "object" }, "classification": { "default": [], "items": { "type": "string" }, "type": "array" }, "component_id": { "type": "string" }, "content_digest": { "type": "string" }, "content_ref": { "default": null, "type": [ "string", "null" ] }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "declared_capabilities": { "default": [], "items": { "type": "string" }, "type": "array" }, "declared_required_capabilities": { "default": [], "items": { "type": "string" }, "type": "array" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "facts": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentFacts" }, "kind": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentKind" }, "lifecycle": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryLifecycle" }, "policy_digest": { "type": "string" }, "provenance": { "$ref": "#/components/schemas/ResDef_Storage_ComponentProvenance" }, "purpose_id": { "type": "string" }, "required_capabilities": { "default": [], "items": { "type": "string" }, "type": "array" }, "requires": { "default": [], "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "source_revision": { "type": "string" }, "source_revision_digest": { "type": "string" }, "summary": { "type": "string" }, "tenant_id": { "type": "string" }, "updated_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "version": { "type": "string" } }, "required": [ "schema_version", "component_id", "kind", "version", "content_digest", "facts", "provenance", "summary", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "source_revision", "source_revision_digest", "entry_revision", "lifecycle", "definition_digest", "created_at_ms", "updated_at_ms" ], "type": "object" }, "ResDef_Storage_AgentComponentFacts": { "description": "Kind-specific facts an optimizer needs in order to CHOOSE a component.\n\nTyped for the kinds selection actually turns on, and\n[`AgentComponentFacts::Opaque`] for the rest. New facts go in\n`attributes` on the entry rather than as new variants, so extending the\nvocabulary does not break the wire.", "oneOf": [ { "properties": { "context_window_tokens": { "format": "uint32", "minimum": 0, "type": "integer" }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_CostFacts" }, { "type": "null" } ], "default": null }, "facts": { "const": "model_profile", "type": "string" }, "latency_declared": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_DeclaredLatency" }, { "type": "null" } ], "default": null }, "latency_observed_ref": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ObservationRef" }, { "type": "null" } ], "default": null, "description": "The evaluation that MEASURED this profile's latency, when one\nexists. A declared latency and a measured one are different claims\nand a selection that cannot tell them apart cannot say which it used." }, "max_output_tokens": { "format": "uint32", "minimum": 0, "type": "integer" }, "modalities": { "$ref": "#/components/schemas/ResDef_Storage_ModalityFacts", "default": { "input": [], "output": [] } }, "model_identity": { "type": "string" }, "provider": { "type": "string" }, "supports_structured_output": { "type": "boolean" }, "supports_tools": { "type": "boolean" }, "supports_vision": { "type": "boolean" } }, "required": [ "facts", "provider", "model_identity", "context_window_tokens", "max_output_tokens", "supports_tools", "supports_structured_output", "supports_vision" ], "type": "object" }, { "properties": { "facts": { "const": "system_prompt", "type": "string" }, "prompt_mode": { "$ref": "#/components/schemas/ResDef_Storage_PromptMode" }, "token_estimate": { "description": "Budgeting input: a graph's prompts have to fit its model's context.", "format": "uint32", "minimum": 0, "type": "integer" }, "variables": { "description": "Names a dynamic prompt expects to be given. Empty for a static one.", "items": { "type": "string" }, "type": "array" } }, "required": [ "facts", "prompt_mode", "token_estimate", "variables" ], "type": "object" }, { "properties": { "cost": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_CostFacts" }, { "type": "null" } ], "default": null }, "destructive_hint": { "default": null, "type": [ "boolean", "null" ] }, "effect": { "$ref": "#/components/schemas/ResDef_Storage_ToolEffect" }, "facts": { "const": "tool", "type": "string" }, "idempotent_hint": { "default": null, "type": [ "boolean", "null" ] }, "input_schema_digest": { "default": null, "description": "`sha256:` of the served-and-serialized input schema section.", "type": [ "string", "null" ] }, "latency_declared": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_DeclaredLatency" }, { "type": "null" } ], "default": null }, "modalities": { "$ref": "#/components/schemas/ResDef_Storage_ModalityFacts", "default": { "input": [], "output": [] } }, "open_world_hint": { "default": null, "type": [ "boolean", "null" ] }, "output_schema_digest": { "default": null, "description": "`None` means the tool declares no output schema.", "type": [ "string", "null" ] }, "read_only_hint": { "default": null, "type": [ "boolean", "null" ] }, "required_scopes": { "description": "Authz actions a caller must hold. An agent that cannot hold them\ncannot be given this tool.", "items": { "type": "string" }, "type": "array" } }, "required": [ "facts", "effect", "required_scopes" ], "type": "object" }, { "properties": { "facts": { "const": "toolset", "type": "string" }, "transport": { "$ref": "#/components/schemas/ResDef_Storage_ToolsetTransport" } }, "required": [ "facts", "transport" ], "type": "object" }, { "description": "Every other kind. Structure and dependencies still apply; there is just\nnothing kind-specific that selection turns on.", "properties": { "facts": { "const": "opaque", "type": "string" } }, "required": [ "facts" ], "type": "object" } ] }, "ResDef_Storage_AgentComponentKind": { "description": "What kind of part this is.\n\nClosed on purpose. Every kind is either referenced from an agent slot \u2014\n[`crate::agent_library::AgentLibraryEntry`],\n[`crate::agent_library::AgentRuntimeContract`] or\n[`crate::agent_graph`] \u2014 or is catalog content an agent is VALIDATED or\nDECIDED against. Both belong to the same closed set for the same reason: a\npart nothing can name is a part nothing can reason about.", "oneOf": [ { "const": "model_profile", "description": "An LLM and the profile it is invoked under (`model_profile_ref`).", "type": "string" }, { "const": "system_prompt", "description": "Instructions, static or dynamic (`system_prompt_ref`).", "type": "string" }, { "const": "tool", "description": "One callable tool (`tool_refs`). An MCP server's tools ingest as these.", "type": "string" }, { "const": "toolset", "description": "A group of tools with one provenance: an MCP server, a function\ntoolset, a skill pack (`toolset_refs`).", "type": "string" }, { "const": "mcp_server", "description": "An MCP server itself -- the thing a set of tools/prompts/resources is\nserved BY. Modelled separately from `Toolset` because impact analysis\nasks about the server (\"this server is down / its schema moved --\nwhich agents are affected?\"), and that question needs the server to be\na node, not an attribute of each tool.", "type": "string" }, { "const": "mcp_prompt", "description": "An MCP prompt: a named, parameterized prompt template a server offers.", "type": "string" }, { "const": "mcp_resource", "description": "An MCP resource: addressable context a server exposes for reading.", "type": "string" }, { "const": "skill", "description": "A pydantic-ai skill (`skill_refs`).", "type": "string" }, { "const": "ontology", "description": "An ontology or vocabulary (`ontology_refs`).", "type": "string" }, { "const": "schema", "description": "A deps/output contract schema (`deps_contract`, `output_contract`).", "type": "string" }, { "const": "output_validator", "description": "An `@agent.output_validator` (`output_validator_refs`).", "type": "string" }, { "const": "predicate", "description": "A predicate behind a graph decision node or edge condition\n(`AgentGraphNodeKind::Decision::decision`, `AgentGraphEdge::condition`).\nBoth slots pin a `ComponentDependency` of this kind, so republishing a\npredicate cannot re-route an already-approved graph.", "type": "string" }, { "const": "shapes", "description": "A SHACL shapes graph a component or request graph is validated against.", "type": "string" }, { "const": "a2a_agent_card", "description": "An A2A agent card: an external agent's own declaration of itself.", "type": "string" }, { "const": "decision_record", "description": "One durable decision record. Published by the engine only; a caller\nthat tries to publish one is refused by name.", "type": "string" }, { "const": "decision_policy", "description": "A decision policy body: what \"better\" means and when to abstain.", "type": "string" }, { "const": "decision_head", "description": "A fitted statistical decision head.", "type": "string" }, { "const": "feature_schema", "description": "The feature schema a decision head is fitted and evaluated against.", "type": "string" }, { "const": "rubric", "description": "A scoring rubric a decision is judged by.", "type": "string" }, { "const": "nl_template", "description": "A natural-language template a decision surface renders with.", "type": "string" } ] }, "ResDef_Storage_AgentComponentSearchPage": { "additionalProperties": false, "description": "One page of a capability search.\n\nAn object, never a bare array: `next_cursor` has to live somewhere, and a\nread that starts life as a JSON array can only grow one by breaking every\nreader.", "properties": { "entries": { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentEntry" }, "type": "array" }, "next_cursor": { "description": "`Some` when more of the tenant remains to be scanned. Hand it back\nunmodified to continue; `None` means the corpus is exhausted.\n\nA page may be EMPTY and still carry a cursor: the engine bounds how much\nit scans per page, so a sparse match over a large tenant makes progress\nacross several pages instead of doing unbounded work in one. A caller\ntherefore loops until `next_cursor` is `None`, not until a page is empty.", "type": [ "string", "null" ] } }, "required": [ "entries" ], "type": "object" }, "ResDef_Storage_AgentGraphCommittedResult": { "additionalProperties": false, "description": "What a committed graph mutation returns.", "properties": { "batch_id": { "type": "string" }, "committed_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphEntry" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "graph", "batch_id", "committed_version" ], "type": "object" }, "ResDef_Storage_AgentGraphDraft": { "additionalProperties": false, "description": "Caller-supplied inputs for one composed graph.", "properties": { "actor_scope": { "type": "string" }, "graph_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "shape": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphShape" }, "synthesis_evidence": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "Why this shape: the evidence an optimizer (or a human) composed it from.\n`None` for a hand-authored graph. RF-ADR-008 requires a SYNTHESIZED\nshape to carry it -- a shape without evidence is a guess, and the\npremise of a context engine is that the context is the justification." }, "tenant_id": { "type": "string" }, "version": { "type": "string" } }, "required": [ "graph_id", "version", "shape", "tenant_id", "actor_scope", "purpose_id", "policy_digest" ], "type": "object" }, "ResDef_Storage_AgentGraphEdge": { "additionalProperties": false, "description": "A directed edge, optionally conditional.", "properties": { "condition": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "Only meaningful out of a [`AgentGraphNodeKind::Decision`]; `None` is an\nunconditional edge.\n\nPinned for the same reason a decision node's predicate is: an unpinned\ncondition would let a republished predicate silently re-route an\napproved graph." }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to" ], "type": "object" }, "ResDef_Storage_AgentGraphEntry": { "additionalProperties": false, "description": "One durable, published graph revision.", "properties": { "actor_scope": { "type": "string" }, "composed_work_ceiling": { "description": "The composed work ceiling ADMISSION derived for this revision --\n[`CompositionFacts::total_work`] from the publish that created it.\n\nStamped by the engine, never supplied by the caller: it is an admission\nverdict, and a caller could only restate it by re-resolving the whole\ncomposition tree client-side to name a number the engine must compute\nanyway. It is stored because it cannot be re-derived from this record\nalone -- deriving it needs every child revision -- and it is inside\n`definition_digest` because a stored-but-unhashed ceiling is one an\nedited durable row could raise while the entry still validated.\n\nThis is the value a delegation's declared `composed_work_ceiling` is\nchecked against. Before it existed the check could not run for any graph\nWITH children, and the caller's own number was accepted unverified.", "format": "uint64", "minimum": 0, "type": "integer" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "definition_digest": { "description": "Digest of this revision's whole immutable definition: the shape digest\nAND the metadata around it -- version, tenant, actor scope, purpose,\npolicy digest, synthesis evidence, admitted ceiling. The impl block\nbelow says why both digests exist and which one a composing parent pins.", "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph_id": { "type": "string" }, "lifecycle": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryLifecycle" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "shape": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphShape" }, "shape_digest": { "type": "string" }, "synthesis_evidence": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, { "type": "null" } ], "default": null }, "tenant_id": { "type": "string" }, "updated_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "version": { "type": "string" } }, "required": [ "schema_version", "graph_id", "version", "shape", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "composed_work_ceiling", "entry_revision", "lifecycle", "shape_digest", "definition_digest", "created_at_ms", "updated_at_ms" ], "type": "object" }, "ResDef_Storage_AgentGraphEntryRef": { "additionalProperties": false, "description": "One pinned agent GRAPH, as a delegation target (RF-ADR-008).\n\nMirrors [`AgentLibraryEntryRef`] exactly: both pin the record's\n`definition_digest`.\n\n# Why a delegation pins the RECORD digest and a composing parent does not\n\nA [`crate::agent_graph::AgentGraphNodeKind::Graph`] node deliberately pins\nthe child's `shape_digest` -- what a parent composes is the child's\nBEHAVIOUR, and the child's governance is re-checked live at every\nresolution, so pinning a stale copy of it would force a cascading republish\nof an entire tree for a change that alters no behaviour.\n\nA delegation is the opposite question. It names a record IDENTITY, and it is\nthe audit point: `synthesis_evidence` -- which RF-ADR-008 section D says is what\nmakes a synthesized graph auditable and reproducible -- is inside\n`definition_digest` and outside `shape_digest`, as are `version`, the actor\nscope, the purpose, the policy digest and the admitted\n`composed_work_ceiling`. A delegation that pinned only the shape would\nattest to what ran while leaving WHY it was composed unpinned.\n\nDo not \"unify\" the two by giving both the same digest: they answer different\nquestions, and [`crate::agent_graph::AgentGraphEntry`]'s own impl-block doc\ncarries the other half of this note.\n\nThe behaviour pin is not lost: `definition_digest` is a hash OVER\n`shape_digest`, and a shape digest covers every node, while an agent node\npins its own `definition_digest`, which pins every component it is assembled\nfrom. So the record digest still pins the ENTIRE tree transitively -- which\nis why a graph target needs no separate `model_digest` (see\n[`KgDelegateRequest::model_digest`]).", "properties": { "actor_scope": { "type": "string" }, "composed_work_ceiling": { "description": "The composed work ceiling this graph was admitted with --\n`CompositionFacts::total_work` from its publish.\n\nCarried rather than recomputed for two reasons. An executor cannot\nderive it without re-resolving the whole composition tree, and more\nimportantly it must honour the ceiling that was VALIDATED at admission,\nnot one it recomputes later against a tree that may have grown new\nrevisions.", "format": "uint64", "minimum": 0, "type": "integer" }, "definition_digest": { "description": "The published RECORD digest -- see the type doc for why this is the\nrecord digest and not the shape digest.", "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "graph_id", "entry_revision", "definition_digest", "actor_scope", "purpose_id", "policy_digest", "composed_work_ceiling" ], "type": "object" }, "ResDef_Storage_AgentGraphNode": { "additionalProperties": false, "description": "One node: an identity, what it does, and the contracts it speaks.\n\nThe contracts are restated here rather than looked up from the referenced\nentry so a shape can be validated on its own, without resolving every agent\nit names. They are digest-pinned, so a shape whose restated contract has\ndrifted from the published entry is detectable at admission.", "properties": { "deps_contract": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "What this node consumes. `None` = takes the graph's own input." }, "kind": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphNodeKind" }, "node_id": { "type": "string" }, "output_contract": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, { "type": "null" } ], "default": null, "description": "What this node produces. `None` = produces nothing a successor can bind." } }, "required": [ "node_id", "kind" ], "type": "object" }, "ResDef_Storage_AgentGraphNodeKind": { "description": "What one node in the graph does.", "oneOf": [ { "additionalProperties": false, "description": "Run one published Agent Library entry.", "properties": { "agent": { "properties": { "agent_id": { "type": "string" }, "definition_digest": { "description": "The exact definition this shape was composed against. Pinning the\ndigest is what stops a graph from silently changing behaviour when\nsomeone republishes an agent under the same id.", "type": "string" } }, "required": [ "agent_id", "definition_digest" ], "type": "object" } }, "required": [ "agent" ], "type": "object" }, { "additionalProperties": false, "description": "Instantiate a template with bound parameters, then run it.", "properties": { "template": { "properties": { "bindings": { "additionalProperties": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "description": "Parameter name -> the component it is bound to, each PINNED.\n\nBare strings here would break the invariant the rest of this type\nrests on: every other reference in a shape is pinned by digest, so\nrepublishing a component cannot change what a graph does. An unpinned\ntemplate binding would be the one hole through which it could.\nOrdered so the shape digest does not depend on map iteration order.", "type": "object" }, "definition_digest": { "type": "string" }, "template_id": { "type": "string" } }, "required": [ "template_id", "definition_digest", "bindings" ], "type": "object" } }, "required": [ "template" ], "type": "object" }, { "additionalProperties": false, "description": "Run another published GRAPH as one step -- the hierarchical case\n(RF-ADR-008): teams composed of teams.\n\n`shape_digest` pins the exact child revision, for the same reason an\nagent node pins `definition_digest`: republishing the child under the\nsame id must not silently change what this graph does. It also has a\nsecond, larger consequence -- see the module's composition notes -- in\nthat it makes the composition acyclic by construction.", "properties": { "graph": { "properties": { "graph_id": { "type": "string" }, "shape_digest": { "type": "string" } }, "required": [ "graph_id", "shape_digest" ], "type": "object" } }, "required": [ "graph" ], "type": "object" }, { "additionalProperties": false, "description": "Choose an outgoing edge by evaluating each edge's condition.\n\nThe predicate is PINNED, like every other reference in a shape.\nA bare `decision_ref: String` was the one remaining hole: republishing\nthe predicate an approved, digest-pinned graph routes through would\nchange which branch that graph executes, and no `shape_digest` would\nmove. [`AgentComponentKind::Predicate`] exists for exactly this slot.", "properties": { "decision": { "properties": { "decision": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" } }, "required": [ "decision" ], "type": "object" } }, "required": [ "decision" ], "type": "object" }, { "const": "fanout", "description": "Take every outgoing edge concurrently.", "type": "string" }, { "const": "join", "description": "Wait for every inbound edge before continuing.", "type": "string" }, { "const": "end", "description": "Terminal node.", "type": "string" } ] }, "ResDef_Storage_AgentGraphShape": { "additionalProperties": false, "description": "The composed shape: nodes, edges, and where a run starts.", "properties": { "edges": { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphEdge" }, "type": "array" }, "entry_node": { "type": "string" }, "max_iterations": { "description": "Hard ceiling on node executions for one run. Required, because a shape\nmay contain cycles and a cycle without a ceiling is an unbounded run.", "format": "uint32", "minimum": 0, "type": "integer" }, "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphNode" }, "type": "array" } }, "required": [ "entry_node", "nodes", "edges", "max_iterations" ], "type": "object" }, "ResDef_Storage_AgentLibraryEntry": { "additionalProperties": false, "description": "One durable Agent Library revision.", "properties": { "actor_scope": { "type": "string" }, "agent_id": { "type": "string" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "definition_digest": { "description": "Digest of the immutable definition fields. Lifecycle, revision and\ntimestamps are revision metadata and are intentionally excluded.", "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "instantiated_from": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_TemplateInstanceRef" }, { "type": "null" } ], "default": null, "description": "Which template produced this agent, if any (RF-ADR-008 item C).\n\n`None` for a hand-authored agent. Present on an instance so \"which agents\ncame from this template?\" is a traversal -- the same reason components\nare pinned rather than named. Otherwise inert: an instance is admitted,\ndelegated and pinned exactly like any other agent, which is what keeps\nthose paths free of a template-aware branch." }, "lifecycle": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryLifecycle" }, "model_identity": { "description": "Kept alongside `model_profile`: the profile is the pinned component,\nthis is the model it names. A reader answering \"what model does this\nagent run on?\" should not have to resolve a component to find out.", "type": "string" }, "model_profile": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "ontologies": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "package_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "role": { "type": "string" }, "role_digest": { "type": "string" }, "runtime": { "$ref": "#/components/schemas/ResDef_Storage_AgentRuntimeContract", "default": { "deps_contract": null, "model_settings": { "max_output_tokens": null, "parallel_tool_calls": null, "request_timeout_ms": null, "seed": null, "stop_sequences": [], "temperature_milli": null, "top_p_milli": null }, "output_contract": null, "output_mode": null, "output_validator_refs": [], "prompt_mode": null, "retry_policy": { "model_retries": 0, "output_retries": 0 }, "toolset_refs": [], "usage_limits": { "input_tokens_limit": null, "output_tokens_limit": null, "request_limit": null, "tool_calls_limit": null } }, "description": "How this agent RUNS -- output/deps contracts, model settings, budgets.\nSee [`AgentRuntimeContract`]. An empty contract is a plain-text agent\nwith engine-default budgets." }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "skills": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "source_revision": { "type": "string" }, "source_revision_digest": { "type": "string" }, "system_prompt": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency", "description": "The components this agent is assembled from, each pinned to an exact\nL1 revision (RF-ADR-008). These were opaque `*_ref` strings plus a\nper-set digest; pinning them by `(component_id, kind, definition_digest)`\nis what connects the hierarchy:\n\n* \"which agents use this tool?\" becomes a traversal, not a string match;\n* republishing a component changes its digest, so an agent assembled\n from the old one no longer resolves -- silently inheriting a changed\n tool is no longer possible;\n* each slot's `kind` is checked, so a tool cannot be wired in where a\n model profile belongs.\n\nThe former `*_set_digest` fields are gone: a digest over the whole set\nwas pinning what the per-item digests now pin individually, and\n`definition_digest` already covers the sorted list." }, "tenant_id": { "type": "string" }, "tools": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "updated_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "version": { "type": "string" } }, "required": [ "schema_version", "agent_id", "package_id", "version", "role", "role_digest", "system_prompt", "tools", "skills", "model_profile", "model_identity", "ontologies", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "source_revision", "source_revision_digest", "entry_revision", "lifecycle", "definition_digest", "created_at_ms", "updated_at_ms" ], "type": "object" }, "ResDef_Storage_AgentLibraryEntryDraft": { "additionalProperties": false, "description": "Caller-supplied, immutable definition inputs for one built agent.\n\nEvery component is represented by an opaque reference and a digest. Raw\nprompts, secrets, tool output, and runtime context deliberately have no\nfield in this type and therefore cannot become part of durable identity.", "properties": { "actor_scope": { "type": "string" }, "agent_id": { "type": "string" }, "instantiated_from": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_TemplateInstanceRef" }, { "type": "null" } ], "default": null, "description": "Which template produced this agent, if any (RF-ADR-008 item C).\n\n`None` for a hand-authored agent. Present on an instance so \"which agents\ncame from this template?\" is a traversal -- the same reason components\nare pinned rather than named. Otherwise inert: an instance is admitted,\ndelegated and pinned exactly like any other agent, which is what keeps\nthose paths free of a template-aware branch." }, "model_identity": { "description": "Kept alongside `model_profile`: the profile is the pinned component,\nthis is the model it names. A reader answering \"what model does this\nagent run on?\" should not have to resolve a component to find out.", "type": "string" }, "model_profile": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "ontologies": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "package_id": { "type": "string" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "role": { "type": "string" }, "role_digest": { "type": "string" }, "runtime": { "$ref": "#/components/schemas/ResDef_Storage_AgentRuntimeContract", "default": { "deps_contract": null, "model_settings": { "max_output_tokens": null, "parallel_tool_calls": null, "request_timeout_ms": null, "seed": null, "stop_sequences": [], "temperature_milli": null, "top_p_milli": null }, "output_contract": null, "output_mode": null, "output_validator_refs": [], "prompt_mode": null, "retry_policy": { "model_retries": 0, "output_retries": 0 }, "toolset_refs": [], "usage_limits": { "input_tokens_limit": null, "output_tokens_limit": null, "request_limit": null, "tool_calls_limit": null } }, "description": "How this agent RUNS -- output/deps contracts, model settings, budgets.\nSee [`AgentRuntimeContract`]. An empty contract is a plain-text agent\nwith engine-default budgets." }, "skills": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "source_revision": { "description": "The source revision is an opaque, source-controlled revision identity;\nits content/provenance digest is carried separately below.", "type": "string" }, "source_revision_digest": { "type": "string" }, "system_prompt": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency", "description": "The components this agent is assembled from, each pinned to an exact\nL1 revision (RF-ADR-008). These were opaque `*_ref` strings plus a\nper-set digest; pinning them by `(component_id, kind, definition_digest)`\nis what connects the hierarchy:\n\n* \"which agents use this tool?\" becomes a traversal, not a string match;\n* republishing a component changes its digest, so an agent assembled\n from the old one no longer resolves -- silently inheriting a changed\n tool is no longer possible;\n* each slot's `kind` is checked, so a tool cannot be wired in where a\n model profile belongs.\n\nThe former `*_set_digest` fields are gone: a digest over the whole set\nwas pinning what the per-item digests now pin individually, and\n`definition_digest` already covers the sorted list." }, "tenant_id": { "type": "string" }, "tools": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "version": { "type": "string" } }, "required": [ "agent_id", "package_id", "version", "role", "role_digest", "system_prompt", "tools", "skills", "model_profile", "model_identity", "ontologies", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "source_revision", "source_revision_digest" ], "type": "object" }, "ResDef_Storage_AgentLibraryLifecycle": { "description": "The retained lifecycle of one Agent Library definition.\n\n`Retired` is a durable tombstone. It remains in the revision stream and\ncannot be replaced by a later publish, preserving the definition's\nprovenance and preventing silent resurrection of an agent identity.\n\n`Withdrawn` is the reversible counterpart, and it exists only for connector\npack members: a pack that stops serving an entry has not decided the entry\nwas wrong, only that it is no longer offered, and a later import that\noffers it again must be able to republish it. Collapsing the two would make\nevery transient publisher outage a permanent tombstone.", "enum": [ "published", "retired", "withdrawn" ], "type": "string" }, "ResDef_Storage_AgentLibraryWriteResult": { "additionalProperties": false, "description": "Receipt returned by the EG Agent Library storage seam.\n\nThe entry is the exact committed revision. `replayed` is set only when the\ncaller's idempotency key reconciles to an already committed receipt.", "properties": { "batch_id": { "type": "string" }, "committed_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "entry": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryEntry" }, "replayed": { "type": "boolean" } }, "required": [ "entry", "batch_id", "committed_version", "replayed" ], "type": "object" }, "ResDef_Storage_AgentModelSettings": { "additionalProperties": false, "description": "Bounded model-invocation settings (pydantic-ai `ModelSettings`).\n\nEvery continuous setting is an INTEGER in thousandths, never a float. These\nvalues are hashed into `definition_digest`, and floats have no canonical\nbyte form for that purpose: `NaN != NaN` breaks `Eq`, `0.0` and `-0.0` are\nequal but hash differently, and the same value can format differently across\nplatforms and serde versions. A reproducible definition digest cannot be\nbuilt on any of that, so the wire type carries milli-units and the harness\ndivides by 1000 when it constructs the model settings.", "properties": { "max_output_tokens": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "parallel_tool_calls": { "type": [ "boolean", "null" ] }, "request_timeout_ms": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "seed": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "stop_sequences": { "items": { "type": "string" }, "type": "array" }, "temperature_milli": { "description": "Sampling temperature in thousandths (`700` = 0.7).", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "top_p_milli": { "description": "Nucleus-sampling mass in thousandths (`950` = 0.95).", "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "stop_sequences" ], "type": "object" }, "ResDef_Storage_AgentOutputMode": { "description": "How the model is asked to produce the agent's structured output.\n\nMirrors pydantic-ai's `ToolOutput` / `NativeOutput` / `PromptedOutput`.", "oneOf": [ { "const": "text", "description": "Free text \u2014 pydantic-ai's default `output_type=str`.", "type": "string" }, { "const": "tool", "description": "A synthesized tool call carries the structured result.", "type": "string" }, { "const": "native", "description": "The provider's own structured-output mode.", "type": "string" }, { "const": "prompted", "description": "The schema is described in the prompt and parsed from the reply.", "type": "string" } ] }, "ResDef_Storage_AgentPromptMode": { "description": "Whether the system prompt is fixed at publish time or resolved per run.\n\npydantic-ai distinguishes `Agent(system_prompt=\u2026)` from `@agent.system_prompt`\n/ `@agent.instructions`. The distinction is durable identity, not style: a\nstatic prompt's digest pins the prompt itself, while a dynamic prompt's\ndigest can only pin the FUNCTION that produces it. A dynamic prompt must\ntherefore be digest-bound again at resolution time, and a reader that cannot\ntell the two apart cannot know whether `system_prompt_digest` covers the text\nthe model actually saw.", "enum": [ "static", "dynamic" ], "type": "string" }, "ResDef_Storage_AgentRetryPolicy": { "additionalProperties": false, "description": "Retry budgets that belong to the agent definition, not to one delegation.\n\nDistinct from `KgDelegateRequest::max_attempts`, which is how many times the\nENGINE will re-admit the work item. These are how many times the agent will\nask the model again within a single run after a tool error or an output that\nfails validation (pydantic-ai `retries` / `output_retries`).", "properties": { "model_retries": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "output_retries": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "model_retries", "output_retries" ], "type": "object" }, "ResDef_Storage_AgentRuntimeContract": { "additionalProperties": false, "description": "The part of an agent's definition that governs how it RUNS, as opposed to\nwhich components it is assembled from.\n\nGrouped into one nested type rather than flattened into\n[`AgentLibraryEntryDraft`] deliberately. The draft, the entry, `create`,\n`retire` and `as_draft` each restate every field, so a flat shape would pay\nfive edits per field and grow a 23-field struct to 35 \u2014 the exact sprawl\nRF-ADR-008 exists to avoid. It also names a real concept: two agents with\nthe same components but different output contracts are different agents.\n\nEvery field participates in `definition_digest`.", "properties": { "deps_contract": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, { "type": "null" } ], "description": "The agent's typed input (pydantic-ai `deps_type`). `None` = no deps." }, "model_settings": { "$ref": "#/components/schemas/ResDef_Storage_AgentModelSettings" }, "output_contract": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, { "type": "null" } ], "description": "The agent's typed output (pydantic-ai `output_type`). `None` with\n[`AgentOutputMode::Text`] is the plain-text default." }, "output_mode": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentOutputMode" }, { "type": "null" } ] }, "output_validator_refs": { "description": "`@agent.output_validator` functions, by reference.", "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "prompt_mode": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentPromptMode" }, { "type": "null" } ], "description": "`None` is read as [`AgentPromptMode::Static`]." }, "retry_policy": { "$ref": "#/components/schemas/ResDef_Storage_AgentRetryPolicy" }, "toolset_refs": { "description": "Grouped tool sources \u2014 a `FunctionToolset`, an MCP server, a skill pack.\n\n`tools` on the entry is the flattened resolution of these WHERE THE\nPUBLISHER CAN FLATTEN THEM, so a reader that only cares which individual\ntools exist need not walk the grouping. The engine does not, and cannot,\nenforce that: a toolset is an L1 reference, its contents live in the\nsystem that owns it, and resolving an MCP server's tool list is not\nsomething this contract can do at publish time. Treating the flattening\nas an invariant would therefore be asserting a property nothing checks.\n\nSo the capability proof covers BOTH lists instead \u2014 see\n[`AgentLibraryEntry::tool_surface_digest`]. An agent that names a toolset\nit did not flatten still has that toolset inside the digest delegation\nadmits, rather than a proof over a strict subset of what it can call.", "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "type": "array" }, "usage_limits": { "$ref": "#/components/schemas/ResDef_Storage_AgentUsageLimits" } }, "required": [ "output_validator_refs", "toolset_refs", "model_settings", "retry_policy", "usage_limits" ], "type": "object" }, "ResDef_Storage_AgentTemplateCommittedResult": { "additionalProperties": false, "description": "What a committed template mutation returns.", "properties": { "batch_id": { "type": "string" }, "committed_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "template": { "$ref": "#/components/schemas/ResDef_Storage_AgentTemplateEntry" } }, "required": [ "schema_version", "template", "batch_id", "committed_version" ], "type": "object" }, "ResDef_Storage_AgentTemplateEntry": { "additionalProperties": false, "description": "One durable, published template revision.", "properties": { "actor_scope": { "type": "string" }, "base": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryEntryDraft" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "lifecycle": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryLifecycle" }, "params": { "items": { "$ref": "#/components/schemas/ResDef_Storage_TemplateParam" }, "type": "array" }, "policy_digest": { "type": "string" }, "purpose_id": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "template_id": { "type": "string" }, "tenant_id": { "type": "string" }, "updated_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "version": { "type": "string" } }, "required": [ "schema_version", "template_id", "version", "base", "params", "tenant_id", "actor_scope", "purpose_id", "policy_digest", "entry_revision", "lifecycle", "definition_digest", "created_at_ms", "updated_at_ms" ], "type": "object" }, "ResDef_Storage_AgentUsageLimits": { "additionalProperties": false, "description": "Per-run consumption ceilings (pydantic-ai `UsageLimits`).\n\n`None` means \"the engine's bounded default\", never \"unlimited\" \u2014 an agent\ndefinition cannot opt out of a ceiling, only decline to tighten it.", "properties": { "input_tokens_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_tokens_limit": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "request_limit": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "tool_calls_limit": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "ResDef_Storage_Algorithm": { "description": "The solver algorithm that produced a certificate.", "oneOf": [ { "const": "depth_first_dual_ascent", "description": "Propagation, greedy incumbent, depth-first branch-and-bound with a\ndual-ascent Lagrangian bound, pre-order leaf-bound certificate.", "type": "string" } ] }, "ResDef_Storage_AssemblyConstraints": { "additionalProperties": false, "description": "Non-capability requirements the assembly must satisfy.", "properties": { "context_budget_tokens": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "cost_budget": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_CostBudget" }, { "type": "null" } ], "default": null }, "max_components": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "max_p95_latency_ms": { "default": null, "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "modalities_in": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_16", "default": [] }, "modalities_out": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_16", "default": [] }, "require_structured_output": { "default": false, "type": "boolean" }, "require_tools": { "default": false, "type": "boolean" } }, "type": "object" }, "ResDef_Storage_AssemblyRequest": { "additionalProperties": false, "description": "One assembly question.", "properties": { "candidates": { "$ref": "#/components/schemas/ResDef_Storage_LibraryCandidateScope" }, "policy": { "$ref": "#/components/schemas/ResDef_Storage_DecisionPolicyRef" }, "requirements": { "$ref": "#/components/schemas/ResDef_Storage_AssemblyRequirements" }, "solver": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_SolverBudget" }, { "type": "null" } ], "default": null }, "templates": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_AgentGraphEntryRef_8", "default": [], "description": "Candidate graph templates. Empty asks for a one-agent graph." }, "tenant_id": { "type": "string" } }, "required": [ "tenant_id", "requirements", "candidates", "policy" ], "type": "object" }, "ResDef_Storage_AssemblyRequirements": { "additionalProperties": false, "description": "What the assembled agent has to be able to do.", "properties": { "capabilities": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_32", "default": [], "description": "Native `eg:capability/*` IRIs." }, "constraints": { "$ref": "#/components/schemas/ResDef_Storage_AssemblyConstraints", "default": { "context_budget_tokens": null, "cost_budget": null, "max_components": null, "max_p95_latency_ms": null, "modalities_in": [], "modalities_out": [], "require_structured_output": false, "require_tools": false } }, "denies": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_64", "default": [], "description": "Component ids that must not be selected." }, "pins": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_ComponentDependency_64", "default": [] }, "task_mappings": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_ClaimedTaskMapping_32", "default": [] }, "tasks": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_32", "default": [], "description": "Native `eg:task/*` IRIs." }, "unmapped_task_digests": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_32", "default": [], "description": "Digests of free text no mapping covered. Each becomes an abstention\nreason rather than a silently dropped requirement." } }, "type": "object" }, "ResDef_Storage_AssemblyResult": { "additionalProperties": false, "description": "The answer: always a record, and a graph draft only when one was proved.", "properties": { "agents": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_AgentLibraryEntryDraft_8", "default": [], "description": "The assembled agents the graph runs, one per slot (one for the\none-agent graph); empty exactly when `graph` is `None`. Each must be\npublished before the graph that pins it." }, "graph": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphDraft" }, { "type": "null" } ], "default": null, "description": "`Some` exactly when the record's outcome is `Solved`: a one-agent\ngraph whose agent node pins [`Self::agent`]. Its `synthesis_evidence`\nis empty until the record is committed; the caller then sets it to the\ncommitted `DecisionRecord` component and publishes it (\u00a74.6)." }, "model": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_SolveModelSpec" }, { "type": "null" } ], "default": null, "description": "The exact integer programme the record's certificate was issued over,\nso a client can verify the certificate without trusting the engine." }, "record": { "$ref": "#/components/schemas/ResDef_Storage_DecisionRecord" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "record" ], "type": "object" }, "ResDef_Storage_BackupReceipt": { "description": "Result of `Method::Backup`: aggregate counts of the published bundle. It carries\nno local path and no raw label.", "properties": { "admin_batches": { "description": "Admin coordinator batches carried.", "format": "uint64", "minimum": 0, "type": "integer" }, "bundled_stores": { "additionalProperties": { "format": "uint64", "minimum": 0, "type": "integer" }, "description": "Non-shard durable stores copied into the bundle, as `file name -> rows copied`.", "type": "object" }, "encrypted_recovery_plans": { "description": "Encrypted staged recovery plans carried.", "format": "uint64", "minimum": 0, "type": "integer" }, "graph_scopes": { "description": "Distinct graph scopes the bundle carries.", "format": "uint64", "minimum": 0, "type": "integer" }, "prepared_parents": { "description": "Admin coordinator parents still prepared.", "format": "uint64", "minimum": 0, "type": "integer" }, "shard_counts": { "description": "Per-shard recovery census, in shard order.", "items": { "$ref": "#/components/schemas/ResDef_Storage_RecoveryStoreCounts" }, "type": "array" }, "shards": { "description": "Shard files written into the bundle.", "format": "uint", "minimum": 0, "type": "integer" }, "xshard_decisions": { "description": "Retained cross-shard coordinator decisions carried.", "format": "uint64", "minimum": 0, "type": "integer" }, "xshard_prepares": { "description": "In-doubt cross-shard participant prepare records carried.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "shards", "graph_scopes", "shard_counts", "xshard_prepares", "xshard_decisions", "bundled_stores", "admin_batches", "prepared_parents", "encrypted_recovery_plans" ], "type": "object" }, "ResDef_Storage_BoundProof": { "description": "The lower-bound evidence a certificate carries.", "oneOf": [ { "additionalProperties": false, "description": "A complete pre-order search tree.", "properties": { "tree": { "additionalProperties": false, "properties": { "nodes": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ProofNode" }, "type": "array" } }, "required": [ "nodes" ], "type": "object" } }, "required": [ "tree" ], "type": "object" }, { "additionalProperties": false, "description": "Only the root dual (the tree exceeded the certificate leaf limit).", "properties": { "root": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Storage_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "root" ], "type": "object" } ] }, "ResDef_Storage_BoundedVec_AbstainReason_64": { "items": { "$ref": "#/components/schemas/ResDef_Storage_AbstainReason" }, "maxItems": 64, "type": "array" }, "ResDef_Storage_BoundedVec_AgentComponentKind_16": { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentKind" }, "maxItems": 16, "type": "array" }, "ResDef_Storage_BoundedVec_AgentGraphEntryRef_8": { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphEntryRef" }, "maxItems": 8, "type": "array" }, "ResDef_Storage_BoundedVec_AgentLibraryEntryDraft_8": { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryEntryDraft" }, "maxItems": 8, "type": "array" }, "ResDef_Storage_BoundedVec_CandidateFacts_64": { "items": { "$ref": "#/components/schemas/ResDef_Storage_CandidateFacts" }, "maxItems": 64, "type": "array" }, "ResDef_Storage_BoundedVec_ClaimedTaskMapping_32": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ClaimedTaskMapping" }, "maxItems": 32, "type": "array" }, "ResDef_Storage_BoundedVec_ComponentDependency_1024": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "maxItems": 1024, "type": "array" }, "ResDef_Storage_BoundedVec_ComponentDependency_256": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "maxItems": 256, "type": "array" }, "ResDef_Storage_BoundedVec_ComponentDependency_64": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "maxItems": 64, "type": "array" }, "ResDef_Storage_BoundedVec_CoverageDerivation_32": { "items": { "$ref": "#/components/schemas/ResDef_Storage_CoverageDerivation" }, "maxItems": 32, "type": "array" }, "ResDef_Storage_BoundedVec_DerivationEdge_16": { "items": { "$ref": "#/components/schemas/ResDef_Storage_DerivationEdge" }, "maxItems": 16, "type": "array" }, "ResDef_Storage_BoundedVec_Elimination_64": { "items": { "$ref": "#/components/schemas/ResDef_Storage_Elimination" }, "maxItems": 64, "type": "array" }, "ResDef_Storage_BoundedVec_ObjectiveLevelKind_8": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ObjectiveLevelKind" }, "maxItems": 8, "type": "array" }, "ResDef_Storage_BoundedVec_PackViolation_256": { "items": { "$ref": "#/components/schemas/ResDef_Storage_PackViolation" }, "maxItems": 256, "type": "array" }, "ResDef_Storage_BoundedVec_PackWarning_256": { "items": { "$ref": "#/components/schemas/ResDef_Storage_PackWarning" }, "maxItems": 256, "type": "array" }, "ResDef_Storage_BoundedVec_PremiseRef_1024": { "items": { "$ref": "#/components/schemas/ResDef_Storage_PremiseRef" }, "maxItems": 1024, "type": "array" }, "ResDef_Storage_BoundedVec_PremiseRef_32": { "items": { "$ref": "#/components/schemas/ResDef_Storage_PremiseRef" }, "maxItems": 32, "type": "array" }, "ResDef_Storage_BoundedVec_SlotAssignment_64": { "items": { "$ref": "#/components/schemas/ResDef_Storage_SlotAssignment" }, "maxItems": 64, "type": "array" }, "ResDef_Storage_BoundedVec_TemplateFacts_8": { "items": { "$ref": "#/components/schemas/ResDef_Storage_TemplateFacts" }, "maxItems": 8, "type": "array" }, "ResDef_Storage_BoundedVec_WeightedLevel_8": { "items": { "$ref": "#/components/schemas/ResDef_Storage_WeightedLevel" }, "maxItems": 8, "type": "array" }, "ResDef_Storage_BoundedVec_WhyNot_64": { "items": { "$ref": "#/components/schemas/ResDef_Storage_WhyNot" }, "maxItems": 64, "type": "array" }, "ResDef_Storage_BoundedVec_string_16": { "items": { "type": "string" }, "maxItems": 16, "type": "array" }, "ResDef_Storage_BoundedVec_string_32": { "items": { "type": "string" }, "maxItems": 32, "type": "array" }, "ResDef_Storage_BoundedVec_string_64": { "items": { "type": "string" }, "maxItems": 64, "type": "array" }, "ResDef_Storage_BoundedVec_string_8": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "ResDef_Storage_CandidateFacts": { "additionalProperties": false, "description": "Everything known about one candidate at decision time.", "properties": { "classification": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_64" }, "component_id": { "type": "string" }, "declared_capabilities": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_64" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "fact_premises": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_PremiseRef_32", "description": "The premises the facts above rest on." }, "facts": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentFacts" }, "kind": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentKind" }, "lifecycle": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryLifecycle" }, "required_capabilities": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_64" }, "requires": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_ComponentDependency_256" } }, "required": [ "component_id", "kind", "entry_revision", "definition_digest", "lifecycle", "classification", "required_capabilities", "declared_capabilities", "requires", "facts", "fact_premises" ], "type": "object" }, "ResDef_Storage_CandidateSourceRecord": { "description": "Where the candidates came from.", "oneOf": [ { "additionalProperties": false, "description": "One tenant-bound agent library snapshot.", "properties": { "classification_under": { "default": null, "type": [ "string", "null" ] }, "kinds": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_AgentComponentKind_16" }, "source": { "const": "agent_library", "type": "string" } }, "required": [ "source", "kinds" ], "type": "object" }, { "additionalProperties": false, "description": "An RLS-filtered graph plan, pinned by its plan digest.", "properties": { "plan_digest": { "type": "string" }, "source": { "const": "graph", "type": "string" } }, "required": [ "source", "plan_digest" ], "type": "object" } ] }, "ResDef_Storage_Certificate": { "additionalProperties": false, "description": "Everything a verifier needs, and nothing it must trust.", "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Storage_Algorithm" }, "config": { "$ref": "#/components/schemas/ResDef_Storage_SolverConfig" }, "incumbent": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_Incumbent" }, { "type": "null" } ] }, "lower_bound": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_Scalar" }, { "type": "null" } ], "description": "Certified scalar lower bound, when any bound leaf exists." }, "model_digest": { "$ref": "#/components/schemas/ResDef_Storage_Sha256Digest" }, "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" }, "proof": { "$ref": "#/components/schemas/ResDef_Storage_BoundProof" }, "status": { "$ref": "#/components/schemas/ResDef_Storage_SolveStatus" } }, "required": [ "model_digest", "algorithm", "config", "status", "proof", "nodes_expanded" ], "type": "object" }, "ResDef_Storage_ClaimProvenance": { "additionalProperties": false, "description": "How a free-text task was mapped onto native task IRIs, and by what.\n\nA mapping is a CLAIM, never a proof: it is recorded with its producer so a\nrecord that leans on one is classified by its weakest premise.", "properties": { "model_profile": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, { "type": "null" } ], "default": null }, "producer": { "type": "string" }, "prompt_digest": { "default": null, "type": [ "string", "null" ] } }, "required": [ "producer" ], "type": "object" }, "ResDef_Storage_ClaimedTaskMapping": { "additionalProperties": false, "description": "One claimed free-text-to-task mapping.", "properties": { "provenance": { "$ref": "#/components/schemas/ResDef_Storage_ClaimProvenance" }, "task_iris": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_8" }, "text_digest": { "description": "`sha256:` of the free text, never the text.", "type": "string" } }, "required": [ "text_digest", "task_iris", "provenance" ], "type": "object" }, "ResDef_Storage_Coefficient": { "description": "An objective coefficient. `Unknown` is never read as zero: a level that\nholds unknown coefficients ranks every selection of an unknown-cost\nvariable below every all-known selection (the \"unknown tier\").", "oneOf": [ { "enum": [ "unknown" ], "type": "string" }, { "additionalProperties": false, "properties": { "known": { "format": "int64", "type": "integer" } }, "required": [ "known" ], "type": "object" } ] }, "ResDef_Storage_ColdStart": { "description": "What the engine does before a head is calibrated.", "oneOf": [ { "additionalProperties": false, "description": "Only the deterministic constraint ladder runs.", "properties": { "mode": { "const": "deterministic_only", "type": "string" } }, "required": [ "mode" ], "type": "object" }, { "additionalProperties": false, "description": "Scores are produced and labelled uncalibrated; nothing acts on them.", "properties": { "mode": { "const": "advisory_uncalibrated", "type": "string" } }, "required": [ "mode" ], "type": "object" }, { "additionalProperties": false, "description": "Bounded exploration is allowed within `budget`.", "properties": { "budget": { "$ref": "#/components/schemas/ResDef_Storage_ExplorationBudget" }, "mode": { "const": "explore", "type": "string" } }, "required": [ "mode", "budget" ], "type": "object" } ] }, "ResDef_Storage_ComponentDependency": { "additionalProperties": false, "description": "One pinned requirement of a component.\n\nThe `kind` is carried alongside the id so a dependency can be type-checked\nwithout resolving it: a [`AgentComponentKind::Tool`] whose input schema\npoints at a [`AgentComponentKind::ModelProfile`] is rejected structurally,\nnot at run time. The `definition_digest` pins the exact revision, so a\ndependency cannot silently change under a component that was reviewed\nagainst it.", "properties": { "component_id": { "type": "string" }, "definition_digest": { "type": "string" }, "kind": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentKind" } }, "required": [ "component_id", "kind", "definition_digest" ], "type": "object" }, "ResDef_Storage_ComponentProvenance": { "description": "Where a component was ingested FROM.\n\nSource packages and MCP servers remain the origin of skills, tools, prompts\nand resources; EG is where they are recorded so they can be queried. That\nsplit only works if the origin travels with the record: without it, \"which\nagents break if this MCP server changes?\" cannot be answered, and a\nre-ingest cannot tell an updated component from a new one.", "oneOf": [ { "description": "Declared directly in EG; no upstream system owns it.", "properties": { "origin": { "const": "native", "type": "string" } }, "required": [ "origin" ], "type": "object" }, { "description": "Ingested from a source package (an `agent-packages/*` distribution).", "properties": { "origin": { "const": "source_package", "type": "string" }, "package_id": { "type": "string" }, "package_version": { "type": "string" } }, "required": [ "origin", "package_id", "package_version" ], "type": "object" }, { "description": "Ingested by listing an MCP server's surface.\n\n`server` PINS the [`AgentComponentKind::McpServer`] record by\n`(id, kind, digest)`, so the server is one node every tool/prompt/\nresource it serves hangs off AND the server a record claims is the\nserver that was reviewed. It was a bare `server_component_id: String`\n-- the last unpinned cross-record reference in this contract -- and an\nid alone is unresolvable in principle: no admission check can tell an\ningest that named the reviewed server from one that named a different\nserver, or a republished one whose tool surface has since moved.\n\nA full [`ComponentDependency`] rather than an id+digest pair, because\nthe kind belongs inside the pin exactly as it does everywhere else\nhere: resolution is by `(id, kind, digest)`, and carrying the kind is\nwhat lets admission refuse a provenance that names a `Toolset` where\nthe serving server belongs instead of discovering it at execution.", "properties": { "origin": { "const": "mcp_server", "type": "string" }, "server": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "upstream_name": { "description": "The name the server itself uses. Distinct from `component_id`,\nwhich is EG-scoped: two servers may both expose a `search` tool.", "type": "string" } }, "required": [ "origin", "server", "upstream_name" ], "type": "object" } ] }, "ResDef_Storage_ConnectorPackBindingResult": { "additionalProperties": false, "description": "What a bind or unbind committed.", "properties": { "batch_id": { "type": "string" }, "bound_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "bound_by": { "type": "string" }, "committed_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "connector": { "type": "string" }, "importer": { "default": null, "type": [ "string", "null" ] }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "tenant_id", "connector", "bound_by", "bound_at_ms", "batch_id", "committed_version" ], "type": "object" }, "ResDef_Storage_ConnectorPackStatus": { "additionalProperties": false, "description": "One connector's pack state.", "properties": { "connector": { "type": "string" }, "head": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_PackHeadView" }, { "type": "null" } ], "default": null }, "importer": { "default": null, "description": "Who may publish this connector's packs. Served only to pack-control and\nadministrative callers: to everyone else it is another tenant's\noperational detail.", "type": [ "string", "null" ] }, "last_receipt": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_PackImportReceipt" }, { "type": "null" } ], "default": null }, "members": { "$ref": "#/components/schemas/ResDef_Storage_PackMemberCounts" }, "projection": { "$ref": "#/components/schemas/ResDef_Storage_PackProjectionState" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" }, "warnings": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_PackWarning_256" } }, "required": [ "schema_version", "tenant_id", "connector", "members", "warnings", "projection" ], "type": "object" }, "ResDef_Storage_ConstraintBody": { "description": "The typed body of a constraint.", "oneOf": [ { "additionalProperties": false, "description": "A general linear row with integer coefficients.", "properties": { "linear": { "additionalProperties": false, "properties": { "relation": { "$ref": "#/components/schemas/ResDef_Storage_Relation" }, "rhs": { "format": "int64", "type": "integer" }, "terms": { "items": { "$ref": "#/components/schemas/ResDef_Storage_Term" }, "type": "array" } }, "required": [ "terms", "relation", "rhs" ], "type": "object" } }, "required": [ "linear" ], "type": "object" }, { "additionalProperties": false, "description": "`antecedent \u21d2 consequent` (`consequent \u2212 antecedent \u2265 0`).", "properties": { "implication": { "additionalProperties": false, "properties": { "antecedent": { "$ref": "#/components/schemas/ResDef_Storage_VarId" }, "consequent": { "$ref": "#/components/schemas/ResDef_Storage_VarId" } }, "required": [ "antecedent", "consequent" ], "type": "object" } }, "required": [ "implication" ], "type": "object" }, { "additionalProperties": false, "description": "`antecedent \u21d2 at least one consequent` (a conditional covering row).", "properties": { "implies_any": { "additionalProperties": false, "properties": { "antecedent": { "$ref": "#/components/schemas/ResDef_Storage_VarId" }, "consequents": { "items": { "$ref": "#/components/schemas/ResDef_Storage_VarId" }, "type": "array" } }, "required": [ "antecedent", "consequents" ], "type": "object" } }, "required": [ "implies_any" ], "type": "object" }, { "additionalProperties": false, "description": "Exactly one of `vars` is selected.", "properties": { "exactly_one": { "additionalProperties": false, "properties": { "vars": { "items": { "$ref": "#/components/schemas/ResDef_Storage_VarId" }, "type": "array" } }, "required": [ "vars" ], "type": "object" } }, "required": [ "exactly_one" ], "type": "object" }, { "additionalProperties": false, "description": "At most `k` of `vars` are selected.", "properties": { "at_most": { "additionalProperties": false, "properties": { "k": { "format": "uint32", "minimum": 0, "type": "integer" }, "vars": { "items": { "$ref": "#/components/schemas/ResDef_Storage_VarId" }, "type": "array" } }, "required": [ "vars", "k" ], "type": "object" } }, "required": [ "at_most" ], "type": "object" }, { "additionalProperties": false, "description": "At least `k` of `vars` are selected (`k = 1` is a covering row).", "properties": { "at_least": { "additionalProperties": false, "properties": { "k": { "format": "uint32", "minimum": 0, "type": "integer" }, "vars": { "items": { "$ref": "#/components/schemas/ResDef_Storage_VarId" }, "type": "array" } }, "required": [ "vars", "k" ], "type": "object" } }, "required": [ "at_least" ], "type": "object" }, { "additionalProperties": false, "description": "`var` is pinned to `value`.", "properties": { "fix": { "additionalProperties": false, "properties": { "value": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ResDef_Storage_VarId" } }, "required": [ "var", "value" ], "type": "object" } }, "required": [ "fix" ], "type": "object" } ] }, "ResDef_Storage_ConstraintSpec": { "additionalProperties": false, "description": "A labelled constraint. The label names the constraint in explanations\n(for example an infeasibility core).", "properties": { "body": { "$ref": "#/components/schemas/ResDef_Storage_ConstraintBody" }, "label": { "type": "string" } }, "required": [ "label", "body" ], "type": "object" }, "ResDef_Storage_CostBudget": { "additionalProperties": false, "description": "A currency-denominated ceiling on the selection's declared cost.", "properties": { "currency": { "description": "ISO 4217, exactly three ASCII uppercase letters.", "type": "string" }, "max_micros": { "format": "uint64", "minimum": 0, "type": "integer" }, "strict": { "description": "Strict means an unknown cost is excluded rather than ranked below.", "type": "boolean" } }, "required": [ "currency", "max_micros", "strict" ], "type": "object" }, "ResDef_Storage_CostFacts": { "additionalProperties": false, "description": "What one invocation costs, plus who says so and how strongly.", "properties": { "currency": { "description": "ISO 4217: exactly three ASCII uppercase letters.", "type": "string" }, "input_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "output_per_mtok_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "per_call_micros": { "default": null, "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "price_source": { "$ref": "#/components/schemas/ResDef_Storage_PriceSource" }, "quality": { "$ref": "#/components/schemas/ResDef_Storage_FactQuality" } }, "required": [ "currency", "price_source", "quality" ], "type": "object" }, "ResDef_Storage_CoverageDerivation": { "additionalProperties": false, "description": "How one required capability is covered, step by step.", "properties": { "chain": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_DerivationEdge_16" }, "covered_by": { "default": null, "description": "The component that covers it, or `None` when nothing does.", "type": [ "string", "null" ] }, "required": { "type": "string" } }, "required": [ "required", "chain" ], "type": "object" }, "ResDef_Storage_CursorPosition": { "oneOf": [ { "properties": { "kind": { "const": "sequence", "type": "string" }, "value": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "timestamp_millis", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "description": "Provider-defined cursors are never ordered lexically.", "properties": { "kind": { "const": "opaque", "type": "string" }, "value": { "properties": { "cursor_type": { "description": "Stable provider cursor type (for example `page_token_v2`).", "type": "string" }, "value": { "type": "string" } }, "required": [ "cursor_type", "value" ], "type": "object" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ResDef_Storage_DecisionCommitResult": { "additionalProperties": false, "description": "The committed record's durable identity.", "properties": { "component": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentCommittedResult" }, "record_id": { "description": "`\"decision:\" + hex(record_digest)`.", "type": "string" }, "replayed": { "description": "True when an identical commit had already landed.", "type": "boolean" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "record_id", "component", "replayed" ], "type": "object" }, "ResDef_Storage_DecisionInputs": { "additionalProperties": false, "description": "The complete input set, digested as `inputs_digest`.", "properties": { "candidates": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_CandidateFacts_64", "description": "Sorted by `component_id`, so the digest does not depend on read order." }, "catalog_digest": { "type": "string" }, "ontology_digest": { "type": "string" }, "policy": { "$ref": "#/components/schemas/ResDef_Storage_DecisionPolicy" }, "policy_digest": { "type": "string" }, "request": { "$ref": "#/components/schemas/ResDef_Storage_AssemblyRequest" }, "solver": { "$ref": "#/components/schemas/ResDef_Storage_SolverIdentity" }, "templates": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_TemplateFacts_8", "default": [], "description": "The graph templates the request named, read at their pinned revisions.\nEmpty asks for a one-agent graph." } }, "required": [ "request", "candidates", "ontology_digest", "policy", "policy_digest", "catalog_digest", "solver" ], "type": "object" }, "ResDef_Storage_DecisionOutcome": { "description": "The conclusion of one assembly decision.", "oneOf": [ { "additionalProperties": false, "description": "An assembly, with the certificate that proves it optimal. Boxed: the\ncertificate's own proof tree dwarfs every other field this enum\ncarries (320 bytes vs. `Abstained`'s 24), so every `DecisionOutcome`\nvalue would otherwise pay `Solved`'s size even when it holds the far\nsmaller `Abstained` variant.", "properties": { "certificate": { "$ref": "#/components/schemas/ResDef_Storage_Certificate" }, "graph_digest": { "type": "string" }, "outcome": { "const": "solved", "type": "string" }, "slots": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_SlotAssignment_64" } }, "required": [ "outcome", "graph_digest", "slots", "certificate" ], "type": "object" }, { "additionalProperties": false, "description": "No assembly, and exactly why.", "properties": { "outcome": { "const": "abstained", "type": "string" }, "reasons": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_AbstainReason_64" } }, "required": [ "outcome", "reasons" ], "type": "object" } ] }, "ResDef_Storage_DecisionPolicy": { "additionalProperties": false, "description": "The complete decision policy.", "properties": { "a2a_requires_observation": { "description": "Whether an A2A agent card needs an observation before it is selectable.", "type": "boolean" }, "accepted_gap": { "$ref": "#/components/schemas/ResDef_Storage_Scalar", "description": "Largest objective gap accepted instead of reporting budget exhaustion." }, "cold_start": { "$ref": "#/components/schemas/ResDef_Storage_ColdStart" }, "max_nogood_rounds": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_slots": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_templates": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "max_why_not_per_slot": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" }, "objective": { "$ref": "#/components/schemas/ResDef_Storage_ObjectiveOrder" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "statistical": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_StatisticalPolicy" }, { "type": "null" } ], "default": null }, "unknown_cost": { "$ref": "#/components/schemas/ResDef_Storage_UnknownCostRule" } }, "required": [ "schema_version", "objective", "unknown_cost", "accepted_gap", "node_budget", "max_templates", "max_slots", "max_nogood_rounds", "max_why_not_per_slot", "a2a_requires_observation", "cold_start" ], "type": "object" }, "ResDef_Storage_DecisionPolicyRef": { "description": "Which policy decides this request.", "oneOf": [ { "additionalProperties": false, "description": "The engine default policy.", "properties": { "policy": { "const": "default", "type": "string" } }, "required": [ "policy" ], "type": "object" }, { "additionalProperties": false, "description": "A published `DecisionPolicy` component, pinned by revision digest.", "properties": { "component": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "policy": { "const": "pinned", "type": "string" } }, "required": [ "policy", "component" ], "type": "object" } ] }, "ResDef_Storage_DecisionQuestion": { "description": "The question a record answers. One variant in this wave; the tag exists so\na later question does not have to break the record shape.", "enum": [ "assemble" ], "type": "string" }, "ResDef_Storage_DecisionRecord": { "additionalProperties": false, "description": "One assembly decision, in full.", "properties": { "caller_principal": { "description": "Privacy-safe persistence id of the caller, never a display name.", "type": "string" }, "candidate_source": { "$ref": "#/components/schemas/ResDef_Storage_CandidateSourceRecord" }, "created_at_ms": { "description": "Recorded, and never read by the math.", "format": "uint64", "minimum": 0, "type": "integer" }, "derivation_class": { "$ref": "#/components/schemas/ResDef_Storage_DerivationClass" }, "derivations": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_CoverageDerivation_32" }, "eliminated": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_Elimination_64" }, "evidence_class": { "$ref": "#/components/schemas/ResDef_Storage_EvidenceClass" }, "inputs": { "$ref": "#/components/schemas/ResDef_Storage_DecisionInputs" }, "inputs_digest": { "type": "string" }, "outcome": { "$ref": "#/components/schemas/ResDef_Storage_DecisionOutcome" }, "premises": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_PremiseRef_1024" }, "question": { "$ref": "#/components/schemas/ResDef_Storage_DecisionQuestion" }, "record_digest": { "type": "string" }, "record_id": { "type": "string" }, "resolution_kind": { "$ref": "#/components/schemas/ResDef_Storage_ResolutionKind" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" }, "trace_fidelity": { "$ref": "#/components/schemas/ResDef_Storage_TraceFidelity" }, "why_not": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_WhyNot_64" } }, "required": [ "schema_version", "record_id", "tenant_id", "caller_principal", "created_at_ms", "question", "candidate_source", "inputs", "inputs_digest", "resolution_kind", "evidence_class", "derivation_class", "trace_fidelity", "premises", "eliminated", "derivations", "outcome", "why_not", "record_digest" ], "type": "object" }, "ResDef_Storage_DeclaredLatency": { "additionalProperties": false, "description": "A publisher's declared latency profile.", "properties": { "p50_ms": { "format": "uint32", "minimum": 0, "type": "integer" }, "p95_ms": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "p50_ms", "p95_ms" ], "type": "object" }, "ResDef_Storage_DerivationClass": { "description": "How the derivation itself was produced. Only checkable derivations are\nadmitted in this wave, so the enum has one arm and a name.", "enum": [ "proof" ], "type": "string" }, "ResDef_Storage_DerivationEdge": { "additionalProperties": false, "description": "One `narrower \u2291 broader` step of a coverage chain.", "properties": { "broader": { "type": "string" }, "class": { "$ref": "#/components/schemas/ResDef_Storage_PremiseClass" }, "narrower": { "type": "string" }, "source": { "$ref": "#/components/schemas/ResDef_Storage_EdgeSource" } }, "required": [ "narrower", "broader", "source", "class" ], "type": "object" }, "ResDef_Storage_Digest256": { "description": "32 bytes of SHA-256 as lowercase hexadecimal", "maxLength": 64, "minLength": 64, "pattern": "^[0-9a-f]{64}$", "type": "string" }, "ResDef_Storage_DualEntry": { "additionalProperties": false, "description": "One non-zero rational multiplier numerator.", "properties": { "numerator": { "$ref": "#/components/schemas/ResDef_Storage_Scalar" }, "row": { "$ref": "#/components/schemas/ResDef_Storage_RowId" } }, "required": [ "row", "numerator" ], "type": "object" }, "ResDef_Storage_EdgeSource": { "description": "Which side of a subsumption edge the engine got it from.", "oneOf": [ { "additionalProperties": false, "description": "The engine's own ontology.", "properties": { "edge": { "const": "native_ontology", "type": "string" } }, "required": [ "edge" ], "type": "object" }, { "additionalProperties": false, "description": "A component's own classification list.", "properties": { "component_id": { "type": "string" }, "edge": { "const": "component_classification", "type": "string" } }, "required": [ "edge", "component_id" ], "type": "object" } ] }, "ResDef_Storage_Elimination": { "additionalProperties": false, "description": "One eliminated candidate and the rule that removed it.", "properties": { "component_id": { "type": "string" }, "violation": { "$ref": "#/components/schemas/ResDef_Storage_Violation" } }, "required": [ "component_id", "violation" ], "type": "object" }, "ResDef_Storage_EvidenceClass": { "description": "The weakest class of evidence the conclusion rests on.", "enum": [ "proof", "observation", "claim" ], "type": "string" }, "ResDef_Storage_ExplorationBudget": { "additionalProperties": false, "description": "How much exploration a cold, uncalibrated question may spend.", "properties": { "fraction": { "$ref": "#/components/schemas/ResDef_Storage_UnitRationalWire" }, "questions": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_16", "description": "Question ids exploration is permitted for. Empty forbids it everywhere." }, "spend_at_risk_micros": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "fraction", "spend_at_risk_micros", "questions" ], "type": "object" }, "ResDef_Storage_FactQuality": { "description": "How strong one declared fact is.\n\nA connector pack carries no measurement and no operator attestation, so a\nprice read out of one is neither measured nor estimated: it is\n[`FactQuality::Declared`], and a record that used it says so.", "enum": [ "measured", "estimated", "declared", "unavailable" ], "type": "string" }, "ResDef_Storage_Incumbent": { "additionalProperties": false, "description": "A feasible assignment and its objective value.", "properties": { "objective": { "$ref": "#/components/schemas/ResDef_Storage_ObjectiveValue" }, "selected": { "items": { "type": "boolean" }, "type": "array" } }, "required": [ "selected", "objective" ], "type": "object" }, "ResDef_Storage_LagrangeDual": { "additionalProperties": false, "description": "Row multipliers `numerator / denominator`, entries strictly ordered by row.", "properties": { "denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "entries": { "items": { "$ref": "#/components/schemas/ResDef_Storage_DualEntry" }, "type": "array" } }, "required": [ "denominator", "entries" ], "type": "object" }, "ResDef_Storage_LeafProof": { "description": "How a leaf of the search tree is closed.", "oneOf": [ { "additionalProperties": false, "description": "`L(dual, path)` is a lower bound on every feasible completion.", "properties": { "bound": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Storage_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "bound" ], "type": "object" }, { "additionalProperties": false, "description": "`L(dual, path)` with a zero objective is positive: no feasible completion.", "properties": { "infeasible": { "additionalProperties": false, "properties": { "dual": { "$ref": "#/components/schemas/ResDef_Storage_LagrangeDual" } }, "required": [ "dual" ], "type": "object" } }, "required": [ "infeasible" ], "type": "object" } ] }, "ResDef_Storage_LevelValue": { "additionalProperties": false, "description": "Value of one objective level under an assignment.", "properties": { "known": { "$ref": "#/components/schemas/ResDef_Storage_Scalar", "description": "Sum of the known coefficients of the selected variables." }, "unknown_selected": { "description": "How many selected variables have an unknown coefficient at this level.", "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "known", "unknown_selected" ], "type": "object" }, "ResDef_Storage_LibraryCandidateScope": { "additionalProperties": false, "description": "Which slice of the agent library the candidates come from.", "properties": { "classification_under": { "default": null, "description": "Restrict to components classified under this ontology term.", "type": [ "string", "null" ] }, "kinds": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_AgentComponentKind_16" } }, "required": [ "kinds" ], "type": "object" }, "ResDef_Storage_McpCatalogSnapshotBinding": { "additionalProperties": false, "description": "Exact identity of the served MCP catalog snapshot this pack came from.\n\nThe pack digest binds this whole value. Consequently a stored resource can\nnever be mistaken for one observed under a different configuration,\nconnection or authorization scope even when its own body is byte-identical.", "properties": { "authorization_scope_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "catalog_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "child_connection_generation": { "format": "uint64", "minimum": 0, "type": "integer" }, "configuration_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "snapshot_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" } }, "required": [ "configuration_revision", "catalog_generation", "snapshot_digest", "child_connection_generation", "authorization_scope_digest" ], "type": "object" }, "ResDef_Storage_ModalityFacts": { "additionalProperties": false, "description": "Which modalities a component consumes and produces.\n\nNative `eg:modality/*` IRIs, sorted and unique, so two components that\nspeak the same modalities digest identically whatever order they declared\nthem in.", "properties": { "input": { "default": [], "items": { "type": "string" }, "type": "array" }, "output": { "default": [], "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "ResDef_Storage_ObjectiveLevelKind": { "description": "One level of the objective, named rather than positional so a record says\nwhich quantity a budget was exhausted on.", "oneOf": [ { "const": "uncovered", "description": "How many required capabilities stay uncovered.", "type": "string" }, { "const": "components", "description": "How many components the assembly selects.", "type": "string" }, { "const": "declared_cost", "description": "Declared cost of the selection, in the budget's currency.", "type": "string" }, { "const": "declared_p95_latency", "description": "Declared p95 latency of the selection.", "type": "string" } ] }, "ResDef_Storage_ObjectiveLevelSpec": { "additionalProperties": false, "description": "One level of the lexicographic objective (minimised).", "properties": { "label": { "type": "string" }, "terms": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ObjectiveTerm" }, "type": "array" } }, "required": [ "label", "terms" ], "type": "object" }, "ResDef_Storage_ObjectiveOrder": { "description": "How the objective levels combine.", "oneOf": [ { "additionalProperties": false, "description": "Strict priority: any change in an earlier level outweighs every\npossible change in all later ones together.", "properties": { "levels": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_ObjectiveLevelKind_8" }, "order": { "const": "lexicographic", "type": "string" } }, "required": [ "order", "levels" ], "type": "object" }, { "additionalProperties": false, "description": "One weighted sum.", "properties": { "order": { "const": "weighted", "type": "string" }, "weights": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_WeightedLevel_8" } }, "required": [ "order", "weights" ], "type": "object" } ] }, "ResDef_Storage_ObjectiveTerm": { "additionalProperties": false, "description": "One term of an objective level.", "properties": { "coefficient": { "$ref": "#/components/schemas/ResDef_Storage_Coefficient" }, "var": { "$ref": "#/components/schemas/ResDef_Storage_VarId" } }, "required": [ "var", "coefficient" ], "type": "object" }, "ResDef_Storage_ObjectiveValue": { "additionalProperties": false, "description": "Every level's value plus the exact scalarised objective.", "properties": { "levels": { "items": { "$ref": "#/components/schemas/ResDef_Storage_LevelValue" }, "type": "array" }, "scalar": { "$ref": "#/components/schemas/ResDef_Storage_Scalar" } }, "required": [ "levels", "scalar" ], "type": "object" }, "ResDef_Storage_ObservationRef": { "additionalProperties": false, "description": "A pointer to a recorded evaluation, for a fact that was MEASURED rather\nthan declared.", "properties": { "digest": { "type": "string" }, "evaluation_id": { "type": "string" } }, "required": [ "evaluation_id", "digest" ], "type": "object" }, "ResDef_Storage_PackBodyReconcileReport": { "additionalProperties": false, "description": "What one body-reconciliation sweep found and released.", "properties": { "next_run_after_ms": { "description": "When the next sweep may usefully run. A sweep that is called back\nsooner does the same scan for nothing.", "format": "uint64", "minimum": 0, "type": "integer" }, "orphaned": { "format": "uint64", "minimum": 0, "type": "integer" }, "released": { "format": "uint64", "minimum": 0, "type": "integer" }, "scanned": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "tenant_id", "scanned", "orphaned", "released", "next_run_after_ms" ], "type": "object" }, "ResDef_Storage_PackDispositionCounts": { "additionalProperties": false, "description": "What an import did to each entry, counted.", "properties": { "published": { "format": "uint32", "minimum": 0, "type": "integer" }, "republished": { "format": "uint32", "minimum": 0, "type": "integer" }, "revised": { "format": "uint32", "minimum": 0, "type": "integer" }, "unchanged": { "format": "uint32", "minimum": 0, "type": "integer" }, "withdrawn": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "published", "revised", "unchanged", "withdrawn", "republished" ], "type": "object" }, "ResDef_Storage_PackHeadView": { "additionalProperties": false, "description": "The current head, as `status` reports it.", "properties": { "binding_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "catalog": { "$ref": "#/components/schemas/ResDef_Storage_McpCatalogSnapshotBinding" }, "committed_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "pack_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "record_id": { "type": "string" }, "server_contract_version": { "default": null, "type": [ "string", "null" ] }, "server_package_version": { "type": "string" }, "visible_record_id": { "default": null, "description": "The record id the graph projection currently exposes, when it lags the\ncommitted one.", "type": [ "string", "null" ] } }, "required": [ "binding_revision", "pack_digest", "catalog", "server_package_version", "record_id", "committed_at_ms" ], "type": "object" }, "ResDef_Storage_PackImportReceipt": { "additionalProperties": false, "description": "The durable receipt of one landed import.", "properties": { "batch_id": { "type": "string" }, "binding_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "catalog": { "$ref": "#/components/schemas/ResDef_Storage_McpCatalogSnapshotBinding" }, "committed_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "connector": { "type": "string" }, "counts": { "$ref": "#/components/schemas/ResDef_Storage_PackDispositionCounts" }, "pack_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "previous_pack_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, { "type": "null" } ], "default": null }, "projection": { "$ref": "#/components/schemas/ResDef_Storage_PackProjectionState" }, "record_id": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" }, "warnings": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_PackWarning_256" } }, "required": [ "schema_version", "tenant_id", "connector", "binding_revision", "pack_digest", "catalog", "record_id", "batch_id", "committed_version", "counts", "warnings", "projection" ], "type": "object" }, "ResDef_Storage_PackImportResult": { "description": "What one import attempt produced.", "oneOf": [ { "additionalProperties": false, "properties": { "receipt": { "$ref": "#/components/schemas/ResDef_Storage_PackImportReceipt" }, "result": { "const": "imported", "type": "string" } }, "required": [ "result", "receipt" ], "type": "object" }, { "additionalProperties": false, "description": "Byte-identical to the current head; nothing was written.", "properties": { "binding_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "pack_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "result": { "const": "unchanged", "type": "string" } }, "required": [ "result", "pack_digest", "binding_revision" ], "type": "object" }, { "additionalProperties": false, "description": "Validation refused the pack. Nothing was written, and every reason is\nnamed; `budget_exhausted` says the list is a prefix, not the whole set.", "properties": { "budget_exhausted": { "type": "boolean" }, "pack_digest": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, { "type": "null" } ], "default": null }, "result": { "const": "rejected", "type": "string" }, "violations": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_PackViolation_256" } }, "required": [ "result", "violations", "budget_exhausted" ], "type": "object" } ] }, "ResDef_Storage_PackMemberCounts": { "additionalProperties": false, "description": "How many members the connector has, by lifecycle.", "properties": { "published": { "format": "uint32", "minimum": 0, "type": "integer" }, "retired": { "format": "uint32", "minimum": 0, "type": "integer" }, "withdrawn": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "published", "withdrawn", "retired" ], "type": "object" }, "ResDef_Storage_PackProjectionState": { "description": "Where the graph projection of this head stands.", "oneOf": [ { "additionalProperties": false, "description": "Nothing to project.", "properties": { "projection": { "const": "none", "type": "string" } }, "required": [ "projection" ], "type": "object" }, { "additionalProperties": false, "description": "Queued on the import outbox.", "properties": { "projection": { "const": "pending", "type": "string" } }, "required": [ "projection" ], "type": "object" }, { "additionalProperties": false, "properties": { "graph": { "type": "string" }, "graph_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "projection": { "const": "applied", "type": "string" } }, "required": [ "projection", "graph", "graph_version" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "type": "string" }, "projection": { "const": "failed", "type": "string" } }, "required": [ "projection", "code" ], "type": "object" } ] }, "ResDef_Storage_PackRetireResult": { "additionalProperties": false, "description": "What a retire committed, entry by entry.", "properties": { "batch_id": { "type": "string" }, "committed_version": { "format": "uint64", "minimum": 0, "type": "integer" }, "connector": { "type": "string" }, "retired": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_ComponentDependency_1024" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "tenant_id", "connector", "retired", "batch_id", "committed_version" ], "type": "object" }, "ResDef_Storage_PackViolation": { "additionalProperties": false, "description": "One rejection, attributed to the entry that caused it where possible.", "properties": { "code": { "$ref": "#/components/schemas/ResDef_Storage_PackViolationCode" }, "detail": { "description": "At most one kibibyte, so a rejection cannot become an exfiltration\nchannel for the pack's own content.", "type": "string" }, "uri": { "default": null, "type": [ "string", "null" ] } }, "required": [ "code", "detail" ], "type": "object" }, "ResDef_Storage_PackViolationCode": { "description": "Why a pack was rejected. Screaming-snake on the wire, so the code a caller\nreads is the code the design documents.", "enum": [ "MALFORMED_INDEX", "UNKNOWN_ENTRY_KIND", "PACK_TOO_LARGE", "ARCHIVE_MISSING", "ARCHIVE_DIGEST_MISMATCH", "MALFORMED_SECTIONS", "PACK_DIGEST_MISMATCH", "DUPLICATE_COMPONENT_ID", "FORBIDDEN_ENTRY_KIND", "MALFORMED_BODY", "MISSING_TOOL_SCHEMA", "UNKNOWN_CAPABILITY_IRI", "INVALID_ANNOTATION", "INVALID_FACTS", "ONTOLOGY_INVALID", "SHAPES_INVALID", "ONTOLOGY_INCONSISTENT", "VALIDATION_BUDGET_EXCEEDED", "SHACL_VIOLATION", "UNRESOLVED_REFERENCE", "REFERENCE_CYCLE", "INVALID_COMPONENT", "IMPORTER_MISMATCH", "PACK_MASS_WITHDRAWAL", "RETIRED_ENTRY_RETURNED" ], "type": "string" }, "ResDef_Storage_PackWarning": { "additionalProperties": false, "description": "One warning, in the same shape as a violation.", "properties": { "code": { "$ref": "#/components/schemas/ResDef_Storage_PackWarningCode" }, "detail": { "type": "string" }, "uri": { "default": null, "type": [ "string", "null" ] } }, "required": [ "code", "detail" ], "type": "object" }, "ResDef_Storage_PackWarningCode": { "description": "Something worth saying that did not stop the import.", "enum": [ "EMPTY_DESCRIPTION", "UNRESOLVED_CAPABILITY_IRI", "DUPLICATE_SHAPE_IRI" ], "type": "string" }, "ResDef_Storage_PremiseClass": { "description": "How strong one premise is.", "oneOf": [ { "const": "definition", "description": "True by the definition of the vocabulary.", "type": "string" }, { "const": "claim", "description": "Asserted by a producer that is not the engine.", "type": "string" }, { "const": "observation", "description": "Measured by a recorded evaluation.", "type": "string" }, { "const": "proof", "description": "Derived by a checkable rule from other premises.", "type": "string" } ] }, "ResDef_Storage_PremiseProvenance": { "description": "Where a premise came from.", "oneOf": [ { "additionalProperties": false, "description": "The engine's own ontology, at the digest named.", "properties": { "ontology_digest": { "type": "string" }, "provenance": { "const": "native_ontology", "type": "string" } }, "required": [ "provenance", "ontology_digest" ], "type": "object" }, { "additionalProperties": false, "description": "The decision policy in force.", "properties": { "policy_digest": { "type": "string" }, "provenance": { "const": "policy", "type": "string" } }, "required": [ "provenance", "policy_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A component publisher's declaration at an exact revision.", "properties": { "component_id": { "type": "string" }, "definition_digest": { "type": "string" }, "provenance": { "const": "publisher", "type": "string" } }, "required": [ "provenance", "component_id", "definition_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A connector pack entry at an exact binding revision.", "properties": { "binding_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "connector": { "type": "string" }, "entry_digest": { "type": "string" }, "pack_digest": { "type": "string" }, "provenance": { "const": "connector_pack", "type": "string" } }, "required": [ "provenance", "connector", "binding_revision", "pack_digest", "entry_digest" ], "type": "object" }, { "additionalProperties": false, "description": "A free-text-to-task mapping asserted by a producer.", "properties": { "producer": { "type": "string" }, "provenance": { "const": "claimed_mapping", "type": "string" }, "text_digest": { "type": "string" } }, "required": [ "provenance", "text_digest", "producer" ], "type": "object" }, { "additionalProperties": false, "description": "A recorded evaluation.", "properties": { "evaluation_id": { "type": "string" }, "provenance": { "const": "observation", "type": "string" } }, "required": [ "provenance", "evaluation_id" ], "type": "object" }, { "additionalProperties": false, "description": "The request itself: a requirement the caller stated in `field`.", "properties": { "field": { "type": "string" }, "provenance": { "const": "request", "type": "string" } }, "required": [ "provenance", "field" ], "type": "object" } ] }, "ResDef_Storage_PremiseRef": { "additionalProperties": false, "description": "One fact the decision used.", "properties": { "class": { "$ref": "#/components/schemas/ResDef_Storage_PremiseClass" }, "fact": { "type": "string" }, "provenance": { "$ref": "#/components/schemas/ResDef_Storage_PremiseProvenance" }, "subject": { "type": "string" } }, "required": [ "subject", "fact", "class", "provenance" ], "type": "object" }, "ResDef_Storage_PriceSource": { "description": "Who says what this costs.", "oneOf": [ { "additionalProperties": false, "description": "The model or tool publisher's own list price.", "properties": { "source": { "const": "publisher", "type": "string" } }, "required": [ "source" ], "type": "object" }, { "additionalProperties": false, "description": "A connector pack entry, pinned by the entry's digest.", "properties": { "connector": { "type": "string" }, "entry_digest": { "type": "string" }, "source": { "const": "connector_pack", "type": "string" } }, "required": [ "source", "connector", "entry_digest" ], "type": "object" }, { "additionalProperties": false, "description": "An operator override, with the reference that justifies it.", "properties": { "reference": { "type": "string" }, "source": { "const": "operator", "type": "string" } }, "required": [ "source", "reference" ], "type": "object" } ] }, "ResDef_Storage_PromptMode": { "description": "How a prompt's text is resolved.", "oneOf": [ { "const": "static", "description": "Fixed at publish time; `content_digest` pins the text itself.", "type": "string" }, { "const": "dynamic", "description": "Produced per run; `content_digest` can only pin the FUNCTION, so the\ntext the model saw must be bound again at resolution.", "type": "string" } ] }, "ResDef_Storage_ProofNode": { "description": "One pre-order node of the search-tree proof.", "oneOf": [ { "additionalProperties": false, "properties": { "branch": { "additionalProperties": false, "properties": { "first": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ResDef_Storage_VarId" } }, "required": [ "var", "first" ], "type": "object" } }, "required": [ "branch" ], "type": "object" }, { "additionalProperties": false, "properties": { "forced": { "additionalProperties": false, "properties": { "row": { "$ref": "#/components/schemas/ResDef_Storage_RowId" }, "value": { "type": "boolean" }, "var": { "$ref": "#/components/schemas/ResDef_Storage_VarId" } }, "required": [ "var", "value", "row" ], "type": "object" } }, "required": [ "forced" ], "type": "object" }, { "additionalProperties": false, "properties": { "leaf": { "additionalProperties": false, "properties": { "proof": { "$ref": "#/components/schemas/ResDef_Storage_LeafProof" } }, "required": [ "proof" ], "type": "object" } }, "required": [ "leaf" ], "type": "object" } ] }, "ResDef_Storage_QuantScaleTag": { "description": "The fixed-point scale a [`QuantisedValue`] is read on. Mirrors\n`eg_numeric`'s `QuantScale`.", "oneOf": [ { "const": "pico", "description": "`value / 10^12`.", "type": "string" }, { "const": "q32", "description": "`value / 2^32`.", "type": "string" } ] }, "ResDef_Storage_QuantisedValue": { "additionalProperties": false, "description": "An exact fixed-point number: `value` read on `scale`.", "properties": { "scale": { "$ref": "#/components/schemas/ResDef_Storage_QuantScaleTag" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "scale", "value" ], "type": "object" }, "ResDef_Storage_ReconciliationReceipt": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "authorization": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackAuthorizationDecision" }, "change_set_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "change_set_id": { "type": "string" }, "connector_observation_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "effect_status": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackEffectStatus" }, "evidence_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "idempotency_key": { "type": "string" }, "observed_source_version": { "type": "string" }, "policy_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "provenance_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "receipt_id": { "type": "string" }, "recorded_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "retry_allowed": { "type": "boolean" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "sequence": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "receipt_id", "sequence", "change_set_id", "change_set_digest", "tenant_id", "actor", "authorization", "policy_digest", "idempotency_key", "observed_source_version", "effect_status", "retry_allowed", "evidence_digest", "connector_observation_digest", "provenance_digest", "recorded_at_ms" ], "type": "object" }, "ResDef_Storage_RecoveryStoreCounts": { "additionalProperties": false, "description": "Integrity census of one physical recovery owner file: the row count of every\nrecovery-relevant table, as the storage kernel validated it.", "properties": { "aborted": { "format": "uint64", "minimum": 0, "type": "integer" }, "batches": { "format": "uint64", "minimum": 0, "type": "integer" }, "committed": { "format": "uint64", "minimum": 0, "type": "integer" }, "encrypted_private_payloads": { "format": "uint64", "minimum": 0, "type": "integer" }, "fences": { "format": "uint64", "minimum": 0, "type": "integer" }, "maintenance": { "format": "uint64", "minimum": 0, "type": "integer" }, "maintenance_claims": { "format": "uint64", "minimum": 0, "type": "integer" }, "outbox": { "format": "uint64", "minimum": 0, "type": "integer" }, "prepared": { "format": "uint64", "minimum": 0, "type": "integer" }, "replay_nonces": { "format": "uint64", "minimum": 0, "type": "integer" }, "replay_operations": { "format": "uint64", "minimum": 0, "type": "integer" }, "scope_bindings": { "format": "uint64", "minimum": 0, "type": "integer" }, "store_roots": { "format": "uint64", "minimum": 0, "type": "integer" }, "versions": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "store_roots", "scope_bindings", "batches", "prepared", "committed", "aborted", "maintenance_claims", "versions", "fences", "outbox", "encrypted_private_payloads", "replay_nonces", "replay_operations", "maintenance" ], "type": "object" }, "ResDef_Storage_Relation": { "description": "Relation of a linear row's left-hand side to its right-hand side.", "oneOf": [ { "const": "less_equal", "description": "`\u03a3 a\u00b7x \u2264 rhs`.", "type": "string" }, { "const": "greater_equal", "description": "`\u03a3 a\u00b7x \u2265 rhs`.", "type": "string" }, { "const": "equal", "description": "`\u03a3 a\u00b7x = rhs`.", "type": "string" } ] }, "ResDef_Storage_ResolutionKind": { "description": "How the conclusion was reached.", "enum": [ "constraint", "entailment", "optimization", "statistical", "abstention" ], "type": "string" }, "ResDef_Storage_RestoreReceipt": { "description": "Result of `Method::Restore`: the opaque stage reference an operator swaps in, plus\nthe import totals. Portable: no username or filesystem reference.", "properties": { "admin_batches": { "format": "uint64", "minimum": 0, "type": "integer" }, "audit": { "format": "uint64", "minimum": 0, "type": "integer" }, "auxiliary": { "format": "uint64", "minimum": 0, "type": "integer" }, "edges": { "format": "uint64", "minimum": 0, "type": "integer" }, "encrypted_recovery_plans": { "format": "uint64", "minimum": 0, "type": "integer" }, "global": { "format": "uint64", "minimum": 0, "type": "integer" }, "graphs": { "format": "uint", "minimum": 0, "type": "integer" }, "ledger": { "format": "uint64", "minimum": 0, "type": "integer" }, "nodes": { "format": "uint64", "minimum": 0, "type": "integer" }, "prepared_parents": { "format": "uint64", "minimum": 0, "type": "integer" }, "restored_shards": { "description": "Shard count the persist dir was rebuilt at.", "format": "uint", "minimum": 0, "type": "integer" }, "semantic": { "format": "uint64", "minimum": 0, "type": "integer" }, "stage_ref": { "description": "Deterministic opaque token naming the staged restore.", "type": "string" }, "xshard_decisions": { "format": "uint64", "minimum": 0, "type": "integer" }, "xshard_prepares": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "stage_ref", "restored_shards", "graphs", "nodes", "edges", "ledger", "semantic", "audit", "auxiliary", "global", "xshard_prepares", "xshard_decisions", "admin_batches", "prepared_parents", "encrypted_recovery_plans" ], "type": "object" }, "ResDef_Storage_RowId": { "description": "Index of a constraint (its position in [`ModelSpec::constraints`]). Every\nconstraint lowers to exactly one linear row, so this is also the row index.", "format": "uint32", "minimum": 0, "type": "integer" }, "ResDef_Storage_Scalar": { "description": "An exact 128-bit signed integer (objective values, bounds, multipliers).", "type": "string" }, "ResDef_Storage_Sha256Digest": { "description": "A SHA-256 digest, serialised as 64 lower-case hex characters.", "type": "string" }, "ResDef_Storage_SlotAssignment": { "additionalProperties": false, "description": "One slot of the assembled graph and the component bound to it.", "properties": { "component": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "slot": { "type": "string" } }, "required": [ "slot", "component" ], "type": "object" }, "ResDef_Storage_SolveModelSpec": { "additionalProperties": false, "description": "A complete 0-1 integer programme: binary variables, labelled constraints and\na lexicographic objective whose first level is the most significant.", "properties": { "constraints": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ConstraintSpec" }, "type": "array" }, "objective": { "items": { "$ref": "#/components/schemas/ResDef_Storage_ObjectiveLevelSpec" }, "type": "array" }, "variables": { "items": { "type": "string" }, "type": "array" } }, "required": [ "variables", "constraints", "objective" ], "type": "object" }, "ResDef_Storage_SolveStatus": { "description": "The outcome class of a solve.", "oneOf": [ { "const": "optimal", "description": "The incumbent is optimal and the tree or root proof certifies it.", "type": "string" }, { "additionalProperties": false, "description": "The search completed; its tree exceeded the certificate limit, so the\nproof is a reproducible deterministic derivation, not a certificate.", "properties": { "optimal_by_deterministic_search": { "additionalProperties": false, "properties": { "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes_expanded" ], "type": "object" } }, "required": [ "optimal_by_deterministic_search" ], "type": "object" }, { "additionalProperties": false, "description": "The budget ran out with a certified gap no larger than the accepted gap.", "properties": { "feasible_with_gap": { "additionalProperties": false, "properties": { "gap": { "$ref": "#/components/schemas/ResDef_Storage_Scalar" } }, "required": [ "gap" ], "type": "object" } }, "required": [ "feasible_with_gap" ], "type": "object" }, { "additionalProperties": false, "description": "No feasible assignment exists; `core` lists the rows the proof uses.", "properties": { "infeasible": { "additionalProperties": false, "properties": { "core": { "items": { "$ref": "#/components/schemas/ResDef_Storage_RowId" }, "type": "array" } }, "required": [ "core" ], "type": "object" } }, "required": [ "infeasible" ], "type": "object" }, { "additionalProperties": false, "description": "The search completed without a feasible assignment and without a\ncertificate-sized tree.", "properties": { "infeasible_by_deterministic_search": { "additionalProperties": false, "properties": { "nodes_expanded": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "nodes_expanded" ], "type": "object" } }, "required": [ "infeasible_by_deterministic_search" ], "type": "object" }, { "const": "budget_exhausted", "description": "The budget ran out with no incumbent or a gap above the accepted gap.", "type": "string" } ] }, "ResDef_Storage_SolverBudget": { "additionalProperties": false, "description": "A caller's per-request solver budget. It may only TIGHTEN the policy; a\nrequest that tries to widen one is refused with `POLICY_LOOSENING`.", "properties": { "max_why_not_per_slot": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_why_not_per_slot" ], "type": "object" }, "ResDef_Storage_SolverConfig": { "additionalProperties": false, "description": "Deterministic work limits and gap acceptance. No wall clock is read.", "properties": { "accepted_gap": { "$ref": "#/components/schemas/ResDef_Storage_Scalar" }, "bound_denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "max_certificate_leaves": { "format": "uint32", "minimum": 0, "type": "integer" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "node_budget", "max_certificate_leaves", "bound_denominator", "accepted_gap" ], "type": "object" }, "ResDef_Storage_SolverIdentity": { "additionalProperties": false, "description": "The solver identity a record was decided under.", "properties": { "algorithm": { "$ref": "#/components/schemas/ResDef_Storage_Algorithm" }, "node_budget": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "algorithm", "node_budget" ], "type": "object" }, "ResDef_Storage_SourceChangeSet": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "authorization": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackAuthorizationDecision" }, "base_source_version": { "type": "string" }, "change_set_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "change_set_id": { "type": "string" }, "connector_id": { "type": "string" }, "desired_patch": { "additionalProperties": true, "type": "object" }, "entity_id": { "type": "string" }, "expires_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "field_provenance": { "additionalProperties": { "type": "string" }, "type": "object" }, "field_scope": { "items": { "type": "string" }, "type": "array" }, "idempotency_key": { "type": "string" }, "policy_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "purpose": { "type": "string" }, "reconciliation_procedure": { "type": "string" }, "required_capability": { "type": "string" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "source_instance_id": { "type": "string" }, "source_of_truth_rule": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "change_set_id", "change_set_digest", "tenant_id", "actor", "purpose", "connector_id", "source_instance_id", "entity_id", "field_scope", "base_source_version", "desired_patch", "source_of_truth_rule", "field_provenance", "required_capability", "policy_digest", "authorization", "idempotency_key", "expires_at_ms", "reconciliation_procedure" ], "type": "object" }, "ResDef_Storage_SqlSourceBatchDigests": { "additionalProperties": false, "properties": { "batch_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "mapping_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "source_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" } }, "required": [ "source_digest", "mapping_digest", "batch_digest" ], "type": "object" }, "ResDef_Storage_SqlSourceBatchResult": { "additionalProperties": false, "description": "Durable terminal result, generated after the exact SQL source epoch increment\ninside the owner transaction and retained unchanged for idempotent replay.\nNever construct from a server preflight or a freshly sampled current epoch.", "properties": { "accepted_position": { "$ref": "#/components/schemas/ResDef_Storage_CursorPosition" }, "affected_count": { "format": "uint64", "minimum": 0, "type": "integer" }, "authority_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "canonical_digests": { "$ref": "#/components/schemas/ResDef_Storage_SqlSourceBatchDigests" }, "committed_source_epoch": { "format": "uint64", "minimum": 1, "type": "integer" } }, "required": [ "canonical_digests", "accepted_position", "affected_count", "committed_source_epoch", "authority_digest" ], "type": "object" }, "ResDef_Storage_SqliteExportDestination": { "description": "Where an exported table set was published: always the configured private transfer\nroot, never a host path.", "enum": [ "transfer-root" ], "type": "string" }, "ResDef_Storage_SqliteExportReport": { "description": "Result of `Method::ExportSqliteFile`.", "properties": { "destination": { "$ref": "#/components/schemas/ResDef_Storage_SqliteExportDestination" }, "exported_tables": { "items": { "$ref": "#/components/schemas/ResDef_Storage_SqliteTableRows" }, "type": "array" } }, "required": [ "destination", "exported_tables" ], "type": "object" }, "ResDef_Storage_SqliteImportReport": { "description": "Result of `Method::ImportSqliteFile`, also the durable batch result a replay\nreturns.", "properties": { "imported_tables": { "items": { "$ref": "#/components/schemas/ResDef_Storage_SqliteTableRows" }, "type": "array" }, "source": { "$ref": "#/components/schemas/ResDef_Storage_SqliteImportSource" } }, "required": [ "source", "imported_tables" ], "type": "object" }, "ResDef_Storage_SqliteImportSource": { "description": "Where an imported table set came from. The only source is a SQLite `.db` file.", "enum": [ "sqlite" ], "type": "string" }, "ResDef_Storage_SqliteTableRows": { "description": "Rows transferred for one SQLite user table.", "properties": { "rows": { "format": "uint64", "minimum": 0, "type": "integer" }, "table": { "type": "string" } }, "required": [ "table", "rows" ], "type": "object" }, "ResDef_Storage_StatisticalPolicy": { "additionalProperties": false, "description": "The statistical half of a policy: the risk, coverage and support levels\nbelow which the engine abstains instead of acting.", "properties": { "alpha": { "$ref": "#/components/schemas/ResDef_Storage_UnitRationalWire", "description": "Miscoverage level of the prediction set." }, "audit_sample": { "$ref": "#/components/schemas/ResDef_Storage_UnitRationalWire", "description": "Share of decisions sampled into the audit stream." }, "delta": { "$ref": "#/components/schemas/ResDef_Storage_UnitRationalWire", "description": "Failure probability of that guarantee." }, "epsilon": { "$ref": "#/components/schemas/ResDef_Storage_UnitRationalWire", "description": "Risk level the controlled procedure must hold." }, "min_ess": { "$ref": "#/components/schemas/ResDef_Storage_QuantisedValue", "description": "Smallest effective sample size an off-policy estimate may report." }, "min_outcome_fidelity": { "$ref": "#/components/schemas/ResDef_Storage_TraceFidelityLevel" }, "min_support": { "description": "Fewest supporting records per option.", "format": "uint64", "minimum": 0, "type": "integer" }, "n_min": { "description": "Fewest records before any calibrated claim is made.", "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_public_features": { "description": "Whether tenant-public features may be read for this question.", "type": "boolean" } }, "required": [ "alpha", "epsilon", "delta", "n_min", "min_support", "min_ess", "min_outcome_fidelity", "tenant_public_features", "audit_sample" ], "type": "object" }, "ResDef_Storage_TemplateFacts": { "additionalProperties": false, "description": "One operator-published graph template an assembly may fill, pinned to the\nexact revision it was read at. Its `Agent` nodes are the slots.", "properties": { "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "graph_id": { "type": "string" }, "shape": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphShape" } }, "required": [ "graph_id", "entry_revision", "definition_digest", "shape" ], "type": "object" }, "ResDef_Storage_TemplateInstanceRef": { "additionalProperties": false, "description": "Where an instantiated agent came from.", "properties": { "bindings": { "additionalProperties": { "$ref": "#/components/schemas/ResDef_Storage_ComponentDependency" }, "description": "Parameter name -> the component it was bound to. Ordered, so an\ninstance's digest does not depend on map iteration order.", "type": "object" }, "definition_digest": { "type": "string" }, "entry_revision": { "format": "uint64", "minimum": 0, "type": "integer" }, "template_id": { "type": "string" } }, "required": [ "template_id", "entry_revision", "definition_digest", "bindings" ], "type": "object" }, "ResDef_Storage_TemplateParam": { "additionalProperties": false, "description": "One declared axis of variation.", "properties": { "kind": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentKind", "description": "The kind the replacement must be. Checked against both the base\ncomponent and the binding, so a parameter cannot be used to smuggle a\ntool in where a model profile belongs." }, "name": { "description": "What a caller names when binding.", "type": "string" }, "replaces": { "description": "The component in the base definition this parameter replaces.\n\nIdentified by `component_id`, not by slot index. An index would be\nbrittle in exactly the way that matters: reordering a tool list -- which\n`definition_digest` deliberately treats as a no-op, since order carries\nno meaning -- would silently repoint every parameter.", "type": "string" }, "required": { "description": "When false, leaving this parameter unbound keeps the base component.", "type": "boolean" }, "summary": { "description": "Human-facing description of the axis, bounded.", "type": "string" } }, "required": [ "name", "replaces", "kind", "required", "summary" ], "type": "object" }, "ResDef_Storage_Term": { "additionalProperties": false, "description": "One `coefficient \u00b7 variable` term of a linear row.", "properties": { "coefficient": { "format": "int64", "type": "integer" }, "var": { "$ref": "#/components/schemas/ResDef_Storage_VarId" } }, "required": [ "var", "coefficient" ], "type": "object" }, "ResDef_Storage_ToolEffect": { "description": "Whether invoking a tool can change anything.\n\nNot a hint. A read-only agent graph is one whose reachable tools are all\n[`ToolEffect::Read`], and that is a property worth being able to prove\nbefore a run rather than discover during one.", "enum": [ "read", "write" ], "type": "string" }, "ResDef_Storage_ToolsetTransport": { "description": "Where a toolset's tools come from.", "oneOf": [ { "const": "mcp", "description": "An MCP server.", "type": "string" }, { "const": "function", "description": "In-process functions.", "type": "string" }, { "const": "skill", "description": "A skill pack.", "type": "string" } ] }, "ResDef_Storage_TraceFidelity": { "description": "How complete the recorded trace is.", "oneOf": [ { "additionalProperties": false, "description": "Every step is present.", "properties": { "fidelity": { "const": "full_step", "type": "string" } }, "required": [ "fidelity" ], "type": "object" }, { "additionalProperties": false, "description": "Steps were dropped to stay inside the record bound; each is named.", "properties": { "dropped": { "$ref": "#/components/schemas/ResDef_Storage_BoundedVec_string_16" }, "fidelity": { "const": "truncated", "type": "string" } }, "required": [ "fidelity", "dropped" ], "type": "object" } ] }, "ResDef_Storage_TraceFidelityLevel": { "description": "How much of a run's trace has to survive for its outcome to count as a\nlabel. Mirrors the record's own [`super::TraceFidelity`] at policy\ngranularity.", "enum": [ "full_step", "tool_calls", "final_output" ], "type": "string" }, "ResDef_Storage_UnitRationalWire": { "additionalProperties": false, "description": "An exact rational in `[0, 1]`: `numerator / denominator`.\n\nValidated on the way in rather than at each use site, because it appears in\nsix different records and a per-site check is a check that one of them\neventually forgets.", "properties": { "denominator": { "format": "uint64", "minimum": 0, "type": "integer" }, "numerator": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "numerator", "denominator" ], "type": "object" }, "ResDef_Storage_UnknownCostRule": { "description": "What an unknown cost means when a budget is in force.", "oneOf": [ { "const": "exclude_when_strict", "description": "A strict budget excludes every candidate whose cost is unknown.", "type": "string" }, { "const": "rank_below_known", "description": "An unknown cost ranks below every known one, and is never read as zero.", "type": "string" } ] }, "ResDef_Storage_VarId": { "description": "Index of a binary decision variable (its position in [`ModelSpec::variables`]).", "format": "uint32", "minimum": 0, "type": "integer" }, "ResDef_Storage_Violation": { "description": "Why a candidate was removed before the solver ran.", "oneOf": [ { "additionalProperties": false, "description": "The request denied this component id.", "properties": { "violation": { "const": "denied", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "The component is withdrawn by its connector pack.", "properties": { "violation": { "const": "withdrawn", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "The component revision is retired.", "properties": { "violation": { "const": "retired", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "An external agent without the observation its policy requires.", "properties": { "violation": { "const": "ineligible_external_agent", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "available": { "format": "uint64", "minimum": 0, "type": "integer" }, "required": { "format": "uint64", "minimum": 0, "type": "integer" }, "violation": { "const": "context_window_too_small", "type": "string" } }, "required": [ "violation", "required", "available" ], "type": "object" }, { "additionalProperties": false, "properties": { "violation": { "const": "missing_tool_support", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "violation": { "const": "missing_structured_output", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "iri": { "type": "string" }, "violation": { "const": "missing_modality", "type": "string" } }, "required": [ "violation", "iri" ], "type": "object" }, { "additionalProperties": false, "description": "Its cost is unknown and the budget is strict.", "properties": { "violation": { "const": "unknown_cost_under_strict_budget", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "properties": { "level": { "$ref": "#/components/schemas/ResDef_Storage_ObjectiveLevelKind" }, "violation": { "const": "over_budget", "type": "string" } }, "required": [ "violation", "level" ], "type": "object" }, { "additionalProperties": false, "description": "A template rule refused this component in this slot.", "properties": { "code": { "type": "string" }, "violation": { "const": "template_validation", "type": "string" } }, "required": [ "violation", "code" ], "type": "object" }, { "additionalProperties": false, "description": "A latency ceiling is in force and the component declares no p95. An\nundeclared latency is never read as zero.", "properties": { "violation": { "const": "unknown_latency_under_budget", "type": "string" } }, "required": [ "violation" ], "type": "object" }, { "additionalProperties": false, "description": "Forcing this component into the assembly leaves no feasible answer.", "properties": { "violation": { "const": "infeasible_when_forced", "type": "string" } }, "required": [ "violation" ], "type": "object" } ] }, "ResDef_Storage_WeightedLevel": { "additionalProperties": false, "description": "One weighted objective level.", "properties": { "level": { "$ref": "#/components/schemas/ResDef_Storage_ObjectiveLevelKind" }, "weight": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "level", "weight" ], "type": "object" }, "ResDef_Storage_WhyNot": { "additionalProperties": false, "description": "Why one candidate did not win its slot.", "properties": { "component_id": { "type": "string" }, "forced_objective": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ObjectiveValue" }, { "type": "null" } ], "default": null, "description": "The objective it would have forced, when it was feasible but worse." }, "slot": { "type": "string" }, "violation": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_Violation" }, { "type": "null" } ], "default": null, "description": "The rule that removed it, when it was not feasible at all." } }, "required": [ "component_id", "slot" ], "type": "object" }, "ResDef_Storage_WriteBackAttemptKind": { "enum": [ "dry_run", "apply" ], "type": "string" }, "ResDef_Storage_WriteBackAuthorizationDecision": { "additionalProperties": false, "properties": { "authorization_ref": { "type": "string" }, "authorized": { "type": "boolean" }, "decision_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "input_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "mode": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackAuthorizationMode" }, "output_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" } }, "required": [ "mode", "authorization_ref", "decision_digest", "input_digest", "output_digest", "authorized" ], "type": "object" }, "ResDef_Storage_WriteBackAuthorizationMode": { "enum": [ "proposal_approval", "standing_policy", "manual_trigger" ], "type": "string" }, "ResDef_Storage_WriteBackEffectStatus": { "enum": [ "no_effect", "applied", "outcome_uncertain" ], "type": "string" }, "ResDef_Storage_WriteBackOutcome": { "enum": [ "dry_run_ready", "applied", "conflict", "rejected", "outcome_uncertain" ], "type": "string" }, "ResDef_Storage_WriteBackReceipt": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "applied_field_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "authorization": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackAuthorizationDecision" }, "change_set_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "change_set_id": { "type": "string" }, "connector_observation_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "effect_status": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackEffectStatus" }, "idempotency_key": { "type": "string" }, "input_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "kind": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackAttemptKind" }, "outcome": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackOutcome" }, "output_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "policy_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "post_source_version": { "type": "string" }, "pre_source_version": { "type": "string" }, "provenance_digest": { "$ref": "#/components/schemas/ResDef_Storage_Digest256" }, "receipt_id": { "type": "string" }, "recorded_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "sequence": { "format": "uint64", "minimum": 0, "type": "integer" }, "tenant_id": { "type": "string" } }, "required": [ "schema_version", "receipt_id", "sequence", "change_set_id", "change_set_digest", "tenant_id", "actor", "authorization", "policy_digest", "idempotency_key", "kind", "input_digest", "output_digest", "pre_source_version", "post_source_version", "applied_field_digest", "outcome", "effect_status", "connector_observation_digest", "provenance_digest", "recorded_at_ms" ], "type": "object" }, "ResDef_Storage_WriteBackReceiptPage": { "additionalProperties": false, "properties": { "next_sequence": { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ] }, "receipts": { "items": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackReceiptRecord" }, "type": "array" } }, "required": [ "receipts" ], "type": "object" }, "ResDef_Storage_WriteBackReceiptRecord": { "oneOf": [ { "properties": { "receipt": { "$ref": "#/components/schemas/ResDef_Storage_WriteBackReceipt" }, "receipt_kind": { "const": "attempt", "type": "string" } }, "required": [ "receipt_kind", "receipt" ], "type": "object" }, { "properties": { "receipt": { "$ref": "#/components/schemas/ResDef_Storage_ReconciliationReceipt" }, "receipt_kind": { "const": "reconciliation", "type": "string" } }, "required": [ "receipt_kind", "receipt" ], "type": "object" } ] }, "ResDef_Transactions_BatchUpdateReport": { "description": "The per-kind operation counts of one applied `BatchUpdate`.", "properties": { "added_edges": { "format": "uint32", "minimum": 0, "type": "integer" }, "added_embeddings": { "format": "uint32", "minimum": 0, "type": "integer" }, "added_nodes": { "format": "uint32", "minimum": 0, "type": "integer" }, "errors": { "items": { "type": "string" }, "type": "array" }, "removed_edges": { "format": "uint32", "minimum": 0, "type": "integer" }, "removed_nodes": { "format": "uint32", "minimum": 0, "type": "integer" }, "upserted_edges": { "format": "uint32", "minimum": 0, "type": "integer" }, "upserted_nodes": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "added_nodes", "upserted_nodes", "removed_nodes", "added_edges", "upserted_edges", "removed_edges", "added_embeddings", "errors" ], "type": "object" }, "ResDef_Transactions_BeliefMaterialization": { "description": "The propagated belief a `TxnMaterializeBelief` stage froze into the transaction.", "properties": { "confidence": { "format": "double", "type": "number" }, "node_id": { "type": "string" } }, "required": [ "node_id", "confidence" ], "type": "object" }, "ResDef_Transactions_BoundedVec_OutboxDeadLetterView_256": { "items": { "$ref": "#/components/schemas/ResDef_Transactions_OutboxDeadLetterView" }, "maxItems": 256, "type": "array" }, "ResDef_Transactions_ChangeCursor": { "properties": { "expected_previous": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Transactions_CursorPosition" }, { "type": "null" } ] }, "partition": { "default": "", "type": "string" }, "position": { "$ref": "#/components/schemas/ResDef_Transactions_CursorPosition" }, "source": { "type": "string" } }, "required": [ "source", "position" ], "type": "object" }, "ResDef_Transactions_ChangeEnvelopeApplied": { "description": "A durably committed change envelope.", "properties": { "batch_id": { "type": "string" }, "content_version": { "$ref": "#/components/schemas/ResDef_Transactions_ContentVersion" }, "cursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Transactions_ChangeCursor" }, { "type": "null" } ] }, "envelope_id": { "type": "string" }, "epoch": { "format": "uint64", "minimum": 0, "type": "integer" }, "fencing_token": { "format": "uint64", "minimum": 0, "type": "integer" }, "group": { "format": "uint64", "minimum": 0, "type": "integer" }, "outbox_count": { "format": "uint32", "minimum": 0, "type": "integer" }, "projection_pending": { "description": "The commit is durable but its in-memory projection has not been published.", "type": "boolean" }, "replayed": { "type": "boolean" }, "replicated": { "type": "boolean" } }, "required": [ "envelope_id", "batch_id", "content_version", "outbox_count", "replayed", "projection_pending" ], "type": "object" }, "ResDef_Transactions_ChangeEnvelopeBatch": { "description": "Per-envelope outcomes, in request order.", "properties": { "results": { "items": { "$ref": "#/components/schemas/ResDef_Transactions_ChangeEnvelopeOutcome" }, "type": "array" } }, "required": [ "results" ], "type": "object" }, "ResDef_Transactions_ChangeEnvelopeConflict": { "description": "An envelope of an `ApplyChangeEnvelopes` batch that did not commit.", "properties": { "envelope_id": { "type": [ "string", "null" ] }, "error": { "type": "string" } }, "required": [ "error" ], "type": "object" }, "ResDef_Transactions_ChangeEnvelopeOutcome": { "description": "One envelope's outcome within an `ApplyChangeEnvelopes` batch, tagged by `status`.", "oneOf": [ { "$ref": "#/components/schemas/ResDef_Transactions_ChangeEnvelopeApplied", "properties": { "status": { "const": "applied", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "$ref": "#/components/schemas/ResDef_Transactions_ChangeEnvelopeApplied", "properties": { "status": { "const": "idempotent_skip", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "$ref": "#/components/schemas/ResDef_Transactions_ChangeEnvelopeConflict", "properties": { "status": { "const": "conflict", "type": "string" } }, "required": [ "status" ], "type": "object" } ] }, "ResDef_Transactions_CommitOutcome": { "anyOf": [ { "type": "boolean" }, { "properties": { "committed": { "type": "boolean" }, "replayed": { "type": "boolean" } }, "required": [ "committed", "replayed" ], "type": "object" } ], "description": "A `Commit` outcome. Without a caller idempotency key the body is the bare\n`committed` boolean; with one it also reports whether this answer replayed an\nearlier commit under the same key." }, "ResDef_Transactions_ContentVersion": { "properties": { "digest": { "type": "string" }, "digest_algorithm": { "type": "string" }, "object_id": { "type": "string" }, "previous_digest": { "type": [ "string", "null" ] }, "source_version": { "$ref": "#/components/schemas/ResDef_Transactions_ContentVersionPosition", "description": "Typed source-side version. It is never compared lexically." } }, "required": [ "object_id", "digest_algorithm", "digest", "source_version" ], "type": "object" }, "ResDef_Transactions_ContentVersionPosition": { "oneOf": [ { "properties": { "kind": { "const": "sequence", "type": "string" }, "value": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "timestamp_millis", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "opaque", "type": "string" }, "value": { "properties": { "value": { "type": "string" }, "version_type": { "type": "string" } }, "required": [ "version_type", "value" ], "type": "object" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ResDef_Transactions_CursorPosition": { "oneOf": [ { "properties": { "kind": { "const": "sequence", "type": "string" }, "value": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "properties": { "kind": { "const": "timestamp_millis", "type": "string" }, "value": { "format": "int64", "type": "integer" } }, "required": [ "kind", "value" ], "type": "object" }, { "description": "Provider-defined cursors are never ordered lexically.", "properties": { "kind": { "const": "opaque", "type": "string" }, "value": { "properties": { "cursor_type": { "description": "Stable provider cursor type (for example `page_token_v2`).", "type": "string" }, "value": { "type": "string" } }, "required": [ "cursor_type", "value" ], "type": "object" } }, "required": [ "kind", "value" ], "type": "object" } ] }, "ResDef_Transactions_MultiGraphBatchReport": { "description": "A partial-success cross-graph batch: every requested graph appears exactly once,\nin `results` (its `BatchUpdate` report) or in `errors`.", "properties": { "errors": { "additionalProperties": { "type": "string" }, "type": "object" }, "results": { "additionalProperties": { "$ref": "#/components/schemas/ResDef_Transactions_BatchUpdateReport" }, "type": "object" } }, "required": [ "results", "errors" ], "type": "object" }, "ResDef_Transactions_MutationOutboxStatusView": { "additionalProperties": false, "description": "One consumer's standing on the generic mutation outbox.", "properties": { "head": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Transactions_OutboxHeadView" }, { "type": "null" } ], "default": null }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "status": { "$ref": "#/components/schemas/ResDef_Transactions_OutboxConsumerStatus" } }, "required": [ "schema_version", "status" ], "type": "object" }, "ResDef_Transactions_OutboxConsumerStatus": { "additionalProperties": false, "description": "One consumer's standing on one outbox -- the fields that mean the same\nthing regardless of WHICH durable outbox backs the view. Shared by\n[`MutationOutboxStatusView`] (this generic outbox) and\n[`crate::result_contract::ingestion::SemanticOutboxStatus`] (the\nsemantic-index stage queue's own outbox), which otherwise built an\nidentical 13-field struct independently; each view keeps its own\nsystem-specific fields (a schema version and the head-of-queue detail\nhere, claim counters there) beside this rather than inside it, and this\ntype is neither `#[serde(flatten)]`ed nor a wire-visible name of its\nown's alternative -- it is a genuinely nested field, precisely so both\ncontainers can keep `#[serde(deny_unknown_fields)]`, which `flatten`\ncannot coexist with.\n\nSeveral counters carry an explicit `_is_lower_bound` flag rather than being\nsilently approximate: a saturated index can only be scanned so far, and an\noperator deciding whether to rewind needs to know that \"12\" might mean\n\"at least 12\".", "properties": { "capacity": { "format": "uint32", "minimum": 0, "type": "integer" }, "consumer": { "type": "string" }, "dead_lettered": { "format": "uint64", "minimum": 0, "type": "integer" }, "delivered": { "format": "uint64", "minimum": 0, "type": "integer" }, "index_complete": { "type": "boolean" }, "inflight": { "format": "uint32", "minimum": 0, "type": "integer" }, "inflight_is_lower_bound": { "type": "boolean" }, "lag_rows": { "format": "uint64", "minimum": 0, "type": "integer" }, "lag_versions": { "format": "uint64", "minimum": 0, "type": "integer" }, "live": { "type": "boolean" }, "oldest_pending_age_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "pending": { "format": "uint64", "minimum": 0, "type": "integer" }, "pending_is_lower_bound": { "type": "boolean" }, "saturated": { "type": "boolean" }, "topic": { "default": null, "type": [ "string", "null" ] } }, "required": [ "consumer", "live", "capacity", "inflight", "inflight_is_lower_bound", "pending", "pending_is_lower_bound", "delivered", "dead_lettered", "oldest_pending_age_ms", "lag_rows", "lag_versions", "saturated", "index_complete" ], "type": "object" }, "ResDef_Transactions_OutboxDeadLetterPage": { "additionalProperties": false, "description": "One page of dead letters.", "properties": { "consumer": { "type": "string" }, "items": { "$ref": "#/components/schemas/ResDef_Transactions_BoundedVec_OutboxDeadLetterView_256" }, "next_after": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Transactions_OutboxPositionView" }, { "type": "null" } ], "default": null }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "schema_version", "consumer", "items" ], "type": "object" }, "ResDef_Transactions_OutboxDeadLetterView": { "additionalProperties": false, "description": "One row the consumer gave up on.", "properties": { "attempt": { "format": "uint32", "minimum": 0, "type": "integer" }, "event_schema": { "type": "string" }, "payload_digest": { "description": "The payload's digest, never the payload: a dead-letter listing is an\noperational read and must not become a way to read another tenant's\nmutation content.", "type": "string" }, "position": { "$ref": "#/components/schemas/ResDef_Transactions_OutboxPositionView" }, "topic": { "type": "string" } }, "required": [ "position", "topic", "event_schema", "attempt", "payload_digest" ], "type": "object" }, "ResDef_Transactions_OutboxHeadView": { "additionalProperties": false, "description": "The oldest undelivered row, when there is one.", "properties": { "age_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "attempt": { "format": "uint32", "minimum": 0, "type": "integer" }, "leased": { "type": "boolean" }, "position": { "$ref": "#/components/schemas/ResDef_Transactions_OutboxPositionView" } }, "required": [ "position", "attempt", "leased", "age_ms" ], "type": "object" }, "ResDef_Transactions_OutboxPositionView": { "additionalProperties": false, "description": "One position in an outbox, exactly as the kernel orders rows.", "properties": { "batch_id": { "type": "string" }, "created_at_ms": { "format": "uint64", "minimum": 0, "type": "integer" }, "ordinal": { "format": "uint32", "minimum": 0, "type": "integer" }, "sequence": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sequence", "created_at_ms", "batch_id", "ordinal" ], "type": "object" }, "ResDef_Transactions_OutboxRewindReceipt": { "additionalProperties": false, "description": "What a rewind did.", "properties": { "completed": { "description": "False when the rewind ran out of its bounded transaction budget and\nmust be called again to finish.", "type": "boolean" }, "consumer": { "type": "string" }, "deleted_deliveries": { "format": "uint64", "minimum": 0, "type": "integer" }, "schema_version": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "to": { "$ref": "#/components/schemas/ResDef_Transactions_RewindTarget" } }, "required": [ "schema_version", "consumer", "to", "completed", "deleted_deliveries" ], "type": "object" }, "ResDef_Transactions_RewindTarget": { "description": "Where a rewind puts the consumer's cursor.", "oneOf": [ { "additionalProperties": false, "description": "Re-deliver everything the outbox still retains.", "properties": { "to": { "const": "start", "type": "string" } }, "required": [ "to" ], "type": "object" }, { "additionalProperties": false, "properties": { "position": { "$ref": "#/components/schemas/ResDef_Transactions_OutboxPositionView" }, "to": { "const": "at", "type": "string" } }, "required": [ "to", "position" ], "type": "object" } ] }, "ResDef_Transactions_SparqlUpdateReport": { "description": "What one SPARQL UPDATE changed, whichever path executed it.\n\n`ApplyMutation` has two executors: the per-graph gateway (one graph, the update\nruns against its staged image) and the coordinated SPARQL-HTTP saga (the\n`sparql_http_update_v1` event, which may create and rewrite several graphs). Both\nanswer with this one body; a per-graph update reports `updated_graphs: 1` and\n`created_graphs: 0`.", "properties": { "created_graphs": { "description": "Graphs this update created.", "format": "uint64", "minimum": 0, "type": "integer" }, "deleted": { "description": "Triples deleted.", "format": "uint64", "minimum": 0, "type": "integer" }, "inserted": { "description": "Triples inserted.", "format": "uint64", "minimum": 0, "type": "integer" }, "operations": { "description": "Update operations applied (one per `;`-separated clause).", "format": "uint64", "minimum": 0, "type": "integer" }, "updated_graphs": { "description": "Graphs whose committed image this update replaced.", "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "operations", "inserted", "deleted", "updated_graphs", "created_graphs" ], "type": "object" }, "Res_cluster_CancelRequest": { "type": "boolean", "x-encoding": "Bool" }, "Res_cluster_CatalogAssign": { "type": "boolean", "x-encoding": "Bool" }, "Res_cluster_CatalogList": { "$ref": "#/components/schemas/ResDef_Cluster_CatalogListing", "x-encoding": "Json" }, "Res_cluster_CatalogReassign": { "type": "boolean", "x-encoding": "Bool" }, "Res_cluster_CatalogRemove": { "type": "boolean", "x-encoding": "Bool" }, "Res_cluster_ClusterMembers": { "$ref": "#/components/schemas/ResDef_Cluster_ClusterDiscoverySnapshot", "x-encoding": "Json" }, "Res_cluster_CreateGraph": { "$ref": "#/components/schemas/ResDef_Cluster_GraphCreated", "x-encoding": "Json" }, "Res_cluster_CreateMatView": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_cluster_DeleteGraph": { "$ref": "#/components/schemas/ResDef_Cluster_GraphDeleted", "x-encoding": "Json" }, "Res_cluster_FleetCatalog": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Cluster_FleetWriteReceipt", "x-body": "clear_override", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Cluster_FleetCatalogPage", "x-body": "list", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Cluster_FleetCatalogLookup", "x-body": "lookup", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Cluster_FleetWriteReceipt", "x-body": "record_discovery", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Cluster_FleetWriteReceipt", "x-body": "set_override", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_cluster_GetMatView": { "$ref": "#/components/schemas/ResDef_Cluster_DistResult", "x-encoding": "Raw" }, "Res_cluster_Health": { "$ref": "#/components/schemas/ResDef_Cluster_HealthReport", "x-encoding": "Json" }, "Res_cluster_ListGraphs": { "items": { "$ref": "#/components/schemas/ResDef_Cluster_GraphListing" }, "type": "array", "x-encoding": "Json" }, "Res_cluster_ListRegisteredServers": { "$ref": "#/components/schemas/ResDef_Cluster_RegisteredServerListPage", "x-encoding": "Raw" }, "Res_cluster_Ping": { "type": "string", "x-encoding": "String" }, "Res_cluster_PlacementAdmin": { "oneOf": [ { "type": "boolean", "x-body": "abort_move", "x-encoding": "Bool" }, { "$ref": "#/components/schemas/ResDef_Cluster_PlacementEpoch", "x-body": "assign", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Cluster_PlacementMoveResult", "x-body": "move", "x-encoding": "Json" } ], "x-selected-by": "op" }, "Res_cluster_PlacementRoute": { "$ref": "#/components/schemas/ResDef_Cluster_PlacementRouteWire", "x-encoding": "Raw" }, "Res_cluster_PlanMatViewDefine": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_cluster_PlanMatViewDrop": { "type": "boolean", "x-encoding": "Bool" }, "Res_cluster_PlanMatViewGet": { "x-dynamic": { "reason": "query-rows", "summary": "rows whose columns and value types are chosen by the caller's query text" }, "x-encoding": "Raw" }, "Res_cluster_PlanMatViewRefresh": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_cluster_RaftAddLearner": { "type": "boolean", "x-encoding": "Bool" }, "Res_cluster_RaftChangeMembership": { "type": "boolean", "x-encoding": "Bool" }, "Res_cluster_RebalanceExecute": { "$ref": "#/components/schemas/ResDef_Cluster_RebalanceExecution", "x-encoding": "Json" }, "Res_cluster_RebalancePlan": { "$ref": "#/components/schemas/ResDef_Cluster_RebalancePlanReport", "x-encoding": "Json" }, "Res_cluster_RefreshMatView": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_cluster_RegisterForeignSource": { "type": "string", "x-encoding": "String" }, "Res_cluster_RegisterServer": { "type": "string", "x-encoding": "String" }, "Res_cluster_RegisterUdf": { "type": "string", "x-encoding": "String" }, "Res_cluster_Reshard": { "$ref": "#/components/schemas/ResDef_Cluster_ShardReshardReport", "x-encoding": "Json" }, "Res_cluster_Shutdown": { "type": "string", "x-encoding": "String" }, "Res_compute_BatchL2Normalize": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_BetweennessCentrality": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_ClusterHierarchyClusters": { "$ref": "#/components/schemas/ResDef_Compute_ClusterLevelView", "x-encoding": "Json" }, "Res_compute_ClusterHierarchyExpand": { "$ref": "#/components/schemas/ResDef_Compute_ClusterExpansion", "x-encoding": "Json" }, "Res_compute_ClusterHierarchyRefresh": { "$ref": "#/components/schemas/ResDef_Compute_ClusterHierarchySummary", "x-encoding": "Json" }, "Res_compute_CommunityDetectEphemeral": { "items": { "items": { "type": "string" }, "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_CommunityDetection": { "items": { "items": { "type": "string" }, "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_ComputeSimilarityEdges": { "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_ConnectedComponents": { "items": { "items": { "type": "string" }, "type": "array" }, "type": "array", "x-encoding": "Json" }, "Res_compute_DegreeCentrality": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_DegreeCentralityAll": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Json" }, "Res_compute_DistributedCompute": { "$ref": "#/components/schemas/ResDef_Compute_DistResult", "x-encoding": "Raw" }, "Res_compute_DsAdamStep": { "$ref": "#/components/schemas/ResDef_Compute_AdamResult", "x-encoding": "Json" }, "Res_compute_DsComputeStats": { "$ref": "#/components/schemas/ResDef_Compute_DatasetStats", "x-encoding": "Json" }, "Res_compute_DsCrossEntropy": { "$ref": "#/components/schemas/ResDef_Compute_CrossEntropyResult", "x-encoding": "Json" }, "Res_compute_DsDpoLoss": { "$ref": "#/components/schemas/ResDef_Compute_DpoResult", "x-encoding": "Json" }, "Res_compute_DsFitEstimator": { "$ref": "#/components/schemas/ResDef_Compute_FittedModel", "x-encoding": "Json" }, "Res_compute_DsGrpoSurrogate": { "$ref": "#/components/schemas/ResDef_Compute_GrpoResult", "x-encoding": "Json" }, "Res_compute_DsKMeans": { "$ref": "#/components/schemas/ResDef_Compute_KMeansResult", "x-encoding": "Json" }, "Res_compute_DsKlDivergence": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_DsLinearRegression": { "$ref": "#/components/schemas/ResDef_Compute_RegressionResult", "x-encoding": "Json" }, "Res_compute_DsLogSoftmax": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Json" }, "Res_compute_DsPca": { "$ref": "#/components/schemas/ResDef_Compute_PCAResult", "x-encoding": "Json" }, "Res_compute_DsPredictEstimator": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Json" }, "Res_compute_DsSgdStep": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Json" }, "Res_compute_DsSoftmax": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Json" }, "Res_compute_DsTrainTestSplit": { "$ref": "#/components/schemas/ResDef_Compute_TrainTestSplitResult", "x-encoding": "Json" }, "Res_compute_FinanceAdfTest": { "$ref": "#/components/schemas/ResDef_Compute_AdfResult", "x-encoding": "Raw" }, "Res_compute_FinanceAlphaCombinationEngine": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceAvellanedaStoikov": { "$ref": "#/components/schemas/ResDef_Compute_Quote", "x-encoding": "Raw" }, "Res_compute_FinanceBayesianKelly": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceBlackLitterman": { "$ref": "#/components/schemas/ResDef_Compute_OptimizationResult", "x-encoding": "Json" }, "Res_compute_FinanceBreakevenAlpha": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceBrierScore": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceCombineAlphas": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceConvergenceGate": { "$ref": "#/components/schemas/ResDef_Compute_ConvergenceGate", "x-encoding": "Raw" }, "Res_compute_FinanceCrossSectionalRank": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceCvar": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceDeflatedSharpe": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceDetectRegimes": { "$ref": "#/components/schemas/ResDef_Compute_RegimeResult", "x-encoding": "Json" }, "Res_compute_FinanceDieboldMariano": { "$ref": "#/components/schemas/ResDef_Compute_DieboldMariano", "x-encoding": "Raw" }, "Res_compute_FinanceDownsideDeviation": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceDrawdownSeries": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceEffectiveIndependentN": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceEfficientFrontier": { "$ref": "#/components/schemas/ResDef_Compute_OptimizationResult", "x-encoding": "Json" }, "Res_compute_FinanceEmpiricalKelly": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceEwma": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceExpectedPnlRate": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceForensicReport": { "$ref": "#/components/schemas/ResDef_Compute_ForensicReport", "x-encoding": "Raw" }, "Res_compute_FinanceGlostenMilgromSpread": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceGltQuotes": { "$ref": "#/components/schemas/ResDef_Compute_Quote", "x-encoding": "Raw" }, "Res_compute_FinanceHardimanBouchaud": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceHawkesMle": { "$ref": "#/components/schemas/ResDef_Compute_HawkesFit", "x-encoding": "Raw" }, "Res_compute_FinanceInformationCoefficient": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceInformationRatio": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceKalmanBeta": { "$ref": "#/components/schemas/ResDef_Compute_KalmanState", "x-encoding": "Raw" }, "Res_compute_FinanceKalmanFilter1d": { "$ref": "#/components/schemas/ResDef_Compute_KalmanState", "x-encoding": "Raw" }, "Res_compute_FinanceKalmanVolatility": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceKellyFraction": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceKyleLambda": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceLogitQuotes": { "$ref": "#/components/schemas/ResDef_Compute_Quote", "x-encoding": "Raw" }, "Res_compute_FinanceMarketImpact": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceMarkovTransitionMatrix": { "items": { "items": { "format": "double", "type": "number" }, "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceMatchOrders": { "items": { "$ref": "#/components/schemas/ResDef_Compute_Fill" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceMaxDrawdown": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceMeanReversion": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceMicropriceSeries": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceMomentum": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceMonteCarloVar": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceOfiSeries": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceOptimizePortfolio": { "$ref": "#/components/schemas/ResDef_Compute_OptimizationResult", "x-encoding": "Json" }, "Res_compute_FinanceOrderBookImbalance": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceOuCalibrate": { "$ref": "#/components/schemas/ResDef_Compute_OuParams", "x-encoding": "Raw" }, "Res_compute_FinanceOuOptimalThresholds": { "$ref": "#/components/schemas/ResDef_Compute_OuThresholds", "x-encoding": "Raw" }, "Res_compute_FinancePairsTrading": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinancePosteriorCredibleInterval": { "$ref": "#/components/schemas/ResDef_Compute_PosteriorCredibleInterval", "x-encoding": "Json" }, "Res_compute_FinanceProbabilityBacktestOverfit": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinancePurgedCpcv": { "items": { "$ref": "#/components/schemas/ResDef_Compute_CvSplit" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceQueueImbalance": { "$ref": "#/components/schemas/ResDef_Compute_QueueSignal", "x-encoding": "Raw" }, "Res_compute_FinanceRealizedVolTick": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceRiskMetrics": { "$ref": "#/components/schemas/ResDef_Compute_RiskMetrics", "x-encoding": "Json" }, "Res_compute_FinanceRiskParity": { "$ref": "#/components/schemas/ResDef_Compute_OptimizationResult", "x-encoding": "Json" }, "Res_compute_FinanceRollingZscore": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceSabrCalibrate": { "$ref": "#/components/schemas/ResDef_Compute_SabrFit", "x-encoding": "Raw" }, "Res_compute_FinanceSabrImpliedVol": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceSabrSmile": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceSignalDecay": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceSpreadReversion": { "$ref": "#/components/schemas/ResDef_Compute_SpreadReversion", "x-encoding": "Raw" }, "Res_compute_FinanceStressTest": { "items": { "format": "double", "type": "number" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceSurveillanceRisk": { "$ref": "#/components/schemas/ResDef_Compute_SurveillanceRisk", "x-encoding": "Raw" }, "Res_compute_FinanceTwap": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint64", "minimum": 0, "type": "integer" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FinanceVar": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceVpinPm": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_compute_FinanceVwap": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint64", "minimum": 0, "type": "integer" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_FindCycle": { "items": { "type": "string" }, "type": [ "array", "null" ], "x-encoding": "Json" }, "Res_compute_GetBlastRadius": { "items": { "type": "string" }, "type": "array", "x-encoding": "Json" }, "Res_compute_GetShortestPath": { "items": { "type": "string" }, "type": [ "array", "null" ], "x-encoding": "Json" }, "Res_compute_GraphColoring": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "uint", "minimum": 0, "type": "integer" } ], "type": "array" }, "type": "array", "x-encoding": "Json" }, "Res_compute_GraphLearnFit": { "$ref": "#/components/schemas/ResDef_Compute_LinkPredictorFit", "x-encoding": "Json" }, "Res_compute_GraphLearnPredict": { "$ref": "#/components/schemas/ResDef_Compute_LinkPrediction", "x-encoding": "Json" }, "Res_compute_MatchOntologyTerms": { "items": { "$ref": "#/components/schemas/ResDef_Compute_OntologyMatch" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_MineAnomaly": { "$ref": "#/components/schemas/ResDef_Compute_AnomalyMiningResult", "x-encoding": "Json" }, "Res_compute_MineAssociate": { "$ref": "#/components/schemas/ResDef_Compute_AssociationMiningResult", "x-encoding": "Json" }, "Res_compute_MineCausalImpact": { "$ref": "#/components/schemas/ResDef_Compute_CausalImpactMiningResult", "x-encoding": "Json" }, "Res_compute_MineClassifyFit": { "$ref": "#/components/schemas/ResDef_Compute_ClassifierFitResult", "x-encoding": "Json" }, "Res_compute_MineClassifyPredict": { "$ref": "#/components/schemas/ResDef_Compute_ClassificationMiningResult", "x-encoding": "Json" }, "Res_compute_MineCluster": { "$ref": "#/components/schemas/ResDef_Compute_ClusterMiningResult", "x-encoding": "Json" }, "Res_compute_MineCommunity": { "$ref": "#/components/schemas/ResDef_Compute_CommunityMiningResult", "x-encoding": "Json" }, "Res_compute_MineEntityResolve": { "$ref": "#/components/schemas/ResDef_Compute_EntityResolutionMiningResult", "x-encoding": "Json" }, "Res_compute_MineForecast": { "$ref": "#/components/schemas/ResDef_Compute_ForecastMiningResult", "x-encoding": "Json" }, "Res_compute_MineOntologyGap": { "$ref": "#/components/schemas/ResDef_Compute_OntologyGapMiningResult", "x-encoding": "Json" }, "Res_compute_MineProcess": { "$ref": "#/components/schemas/ResDef_Compute_ProcessMiningResult", "x-encoding": "Json" }, "Res_compute_MineReduce": { "$ref": "#/components/schemas/ResDef_Compute_ReductionMiningResult", "x-encoding": "Json" }, "Res_compute_MineRetrievalQuality": { "$ref": "#/components/schemas/ResDef_Compute_RetrievalQualityMiningResult", "x-encoding": "Json" }, "Res_compute_MineRiskPropagation": { "$ref": "#/components/schemas/ResDef_Compute_RiskPropagationMiningResult", "x-encoding": "Json" }, "Res_compute_MineRootCause": { "$ref": "#/components/schemas/ResDef_Compute_RootCauseMiningResult", "x-encoding": "Json" }, "Res_compute_MineSequence": { "$ref": "#/components/schemas/ResDef_Compute_SequenceMiningResult", "x-encoding": "Json" }, "Res_compute_MineSubgraph": { "$ref": "#/components/schemas/ResDef_Compute_SubgraphMiningResult", "x-encoding": "Json" }, "Res_compute_MineText": { "$ref": "#/components/schemas/ResDef_Compute_TextMiningResult", "x-encoding": "Json" }, "Res_compute_MinimumSpanningTree": { "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_MiningPipelineCompare": { "$ref": "#/components/schemas/ResDef_Compute_PipelineComparison", "x-encoding": "Json" }, "Res_compute_MiningPipelineEvaluate": { "$ref": "#/components/schemas/ResDef_Compute_PipelineEvaluation", "x-encoding": "Json" }, "Res_compute_MiningPipelinePredict": { "$ref": "#/components/schemas/ResDef_Compute_PipelinePrediction", "x-encoding": "Json" }, "Res_compute_MiningPipelineServe": { "$ref": "#/components/schemas/ResDef_Compute_PipelineServeResult", "x-encoding": "Json" }, "Res_compute_MiningPipelineTrain": { "$ref": "#/components/schemas/ResDef_Compute_PipelineTrainResult", "x-encoding": "Json" }, "Res_compute_PageRank": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_PersonalizedPageRank": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "double", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_ResolveCandidates": { "items": { "$ref": "#/components/schemas/ResDef_Compute_MergeProposal" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_RunUdf": { "x-dynamic": { "reason": "caller-bytes", "summary": "opaque bytes the caller wrote or a caller-supplied program produced" }, "x-encoding": "Raw" }, "Res_compute_Solve": { "$ref": "#/components/schemas/ResDef_Compute_SolveResult", "x-encoding": "Raw" }, "Res_compute_StronglyConnectedComponents": { "items": { "items": { "type": "string" }, "type": "array" }, "type": "array", "x-encoding": "Json" }, "Res_compute_TopologicalSort": { "items": { "type": "string" }, "type": "array", "x-encoding": "Raw" }, "Res_compute_Vf2SubgraphMatch": { "$ref": "#/components/schemas/ResDef_Compute_Vf2MatchResult", "x-encoding": "Raw" }, "Res_coordination_AcquireCapacity": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityAcquireResult", "x-encoding": "Raw" }, "Res_coordination_AnalyticsJob": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "Cancel", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "Resume", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "Status", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "Submit", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "WorkerCancel", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "WorkerCheckpoint", "x-encoding": "Json" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_WorkerJobClaim" }, { "type": "null" } ], "x-body": "WorkerClaim", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "WorkerFail", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "WorkerPublish", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_JobWorkerLease", "x-body": "WorkerRenew", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_AnalyticsJobRecord", "x-body": "WorkerStage", "x-encoding": "Json" } ], "x-selected-by": "op" }, "Res_coordination_CancelWorkItem": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemTransition2", "x-encoding": "Json" }, "Res_coordination_CapacityStatus": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityStatusResult", "x-encoding": "Raw" }, "Res_coordination_CasWorkItemMetadata": { "$ref": "#/components/schemas/ResDef_Coordination_CasWorkItemMetadataResult", "x-encoding": "Raw" }, "Res_coordination_ClaimNext": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, true ], "type": [ "array", "null" ], "x-encoding": "Raw" }, "Res_coordination_ClaimWorkItem": { "$ref": "#/components/schemas/ResDef_Coordination_ClaimWorkItemResult", "x-encoding": "Raw" }, "Res_coordination_CleanupDevelopmentLane": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneCleanupCompleteResult", "x-encoding": "Raw" }, "Res_coordination_CommitWorkItemResult": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemTransition", "x-encoding": "Json" }, "Res_coordination_DecisionEval": { "oneOf": [ { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DecisionJobRecord" }, { "type": "null" } ], "x-body": "status", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Coordination_DecisionJobRecord", "x-body": "submit", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_coordination_DecisionFit": { "oneOf": [ { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_DecisionJobRecord" }, { "type": "null" } ], "x-body": "status", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Coordination_DecisionJobRecord", "x-body": "submit", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_coordination_DeferWorkItem": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemDeferral", "x-encoding": "Json" }, "Res_coordination_DevelopmentLaneStatus": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneStatusResult", "x-encoding": "Raw" }, "Res_coordination_FinishDevelopmentLane": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneFinishResult", "x-encoding": "Raw" }, "Res_coordination_GetControlLease": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_ControlLeaseView" }, { "type": "null" } ], "x-encoding": "Raw" }, "Res_coordination_GetWorkItem": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemView" }, { "type": "null" } ], "x-encoding": "Raw" }, "Res_coordination_GetWorkItemOutcome": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemOutcomeView" }, { "type": "null" } ], "x-encoding": "Raw" }, "Res_coordination_IssueControlLease": { "$ref": "#/components/schemas/ResDef_Coordination_ControlLeaseIssued", "x-encoding": "Json" }, "Res_coordination_KgDelegate": { "$ref": "#/components/schemas/ResDef_Coordination_KgDelegateResult", "x-encoding": "Raw" }, "Res_coordination_ListWorkItems": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemPage", "x-encoding": "Raw" }, "Res_coordination_MintWorkItemClaimCapability": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemClaimCapabilityResult", "x-encoding": "Raw" }, "Res_coordination_ObserveDevelopmentLane": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneObserveResult", "x-encoding": "Raw" }, "Res_coordination_QueryDevelopmentLane": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQueryResult", "x-encoding": "Raw" }, "Res_coordination_QueryWorkItemReservation": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationResult", "x-encoding": "Raw" }, "Res_coordination_ReclaimExpiredCapacity": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityReclaimResult", "x-encoding": "Raw" }, "Res_coordination_ReclaimWorkItemResources": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationResult", "x-encoding": "Raw" }, "Res_coordination_ReconcileCapacity": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityStatusResult", "x-encoding": "Raw" }, "Res_coordination_ReleaseCapacity": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityMutationResult", "x-encoding": "Raw" }, "Res_coordination_ReleaseWorkItemResources": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationResult", "x-encoding": "Raw" }, "Res_coordination_RenewCapacity": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityMutationResult", "x-encoding": "Raw" }, "Res_coordination_RenewDevelopmentLane": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneRenewResult", "x-encoding": "Raw" }, "Res_coordination_RenewWorkItemLease": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemLeaseRenewal", "x-encoding": "Json" }, "Res_coordination_ReserveDevelopmentLane": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneResult", "x-encoding": "Raw" }, "Res_coordination_ReserveWorkItemResources": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationResult", "x-encoding": "Raw" }, "Res_coordination_ResourceReservationStatus": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceReservationStatusResult", "x-encoding": "Raw" }, "Res_coordination_ResourceStatsPage": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceSnapshot", "x-encoding": "Json" }, "Res_coordination_Statechart": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Coordination_StatechartDefinitionId", "x-body": "Define", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_StatechartInstance", "x-body": "GetState", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_StatechartInstance", "x-body": "Instantiate", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_StatechartInstanceList", "x-body": "List", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Coordination_StatechartEventOutcome", "x-body": "SendEvent", "x-encoding": "Json" } ], "x-selected-by": "op" }, "Res_coordination_SubmitWorkItem": { "$ref": "#/components/schemas/ResDef_Coordination_SubmitWorkItemResult", "x-encoding": "Raw" }, "Res_coordination_SubmitWorkItems": { "$ref": "#/components/schemas/ResDef_Coordination_SubmitWorkItemsResult", "x-encoding": "Raw" }, "Res_coordination_TransitionControlLease": { "$ref": "#/components/schemas/ResDef_Coordination_ControlLeaseTransition", "x-encoding": "Json" }, "Res_coordination_UpdateCapacityCell": { "$ref": "#/components/schemas/ResDef_Coordination_CapacityCellUpdateResult", "x-encoding": "Raw" }, "Res_coordination_UpdateDevelopmentLaneQuota": { "$ref": "#/components/schemas/ResDef_Coordination_DevelopmentLaneQuotaUpdateResult", "x-encoding": "Raw" }, "Res_coordination_UpdateResourceHost": { "$ref": "#/components/schemas/ResDef_Coordination_ResourceHostUpdateResult", "x-encoding": "Raw" }, "Res_coordination_VerifyWorkItemClaimCapability": { "$ref": "#/components/schemas/ResDef_Coordination_WorkItemClaimCapabilityResult", "x-encoding": "Raw" }, "Res_graph_AddEdge": { "type": "string", "x-encoding": "String" }, "Res_graph_AddNode": { "type": "string", "x-encoding": "String" }, "Res_graph_AddSceneObject": { "type": "string", "x-encoding": "String" }, "Res_graph_AddTriples": { "$ref": "#/components/schemas/ResDef_Graph_LoadReport", "x-encoding": "Raw" }, "Res_graph_AppendStep": { "type": [ "string", "null" ], "x-encoding": "Raw" }, "Res_graph_ApplyMutation": { "$ref": "#/components/schemas/ResDef_Graph_SparqlUpdateReport", "x-encoding": "Json" }, "Res_graph_BestTrajectory": { "type": [ "string", "null" ], "x-encoding": "Raw" }, "Res_graph_ClearGraph": { "type": "string", "x-encoding": "String" }, "Res_graph_CompactNodesByType": { "$ref": "#/components/schemas/ResDef_Graph_CompactNodesResult", "x-encoding": "Json" }, "Res_graph_CompareAndSetNodeFields": { "type": "boolean", "x-encoding": "Bool" }, "Res_graph_Consolidate": { "type": "string", "x-encoding": "String" }, "Res_graph_CreateNodeIfAbsent": { "type": "boolean", "x-encoding": "Bool" }, "Res_graph_CreateSummaryNode": { "type": "string", "x-encoding": "String" }, "Res_graph_DecayMemories": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_DecayNode": { "type": "boolean", "x-encoding": "Bool" }, "Res_graph_DecaySweep": { "$ref": "#/components/schemas/ResDef_Graph_DecayStats", "x-encoding": "Json" }, "Res_graph_DiffAgainst": { "$ref": "#/components/schemas/ResDef_Graph_GraphDiff", "x-encoding": "Json" }, "Res_graph_DiscountedReturn": { "format": "double", "type": "number", "x-encoding": "Float" }, "Res_graph_DropNamedGraph": { "type": "string", "x-encoding": "String" }, "Res_graph_EdgeCount": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_EvictBelow": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_EvictLRU": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_Fork": { "x-dynamic": { "reason": "caller-properties", "summary": "property maps the caller wrote, returned verbatim" }, "x-encoding": "Json" }, "Res_graph_GetEdgeProperties": { "x-dynamic": { "reason": "caller-properties", "summary": "property maps the caller wrote, returned verbatim" }, "x-encoding": "Json" }, "Res_graph_GetEdgePropertiesBatch": { "items": { "items": { "$ref": "#/components/schemas/ResDef_Graph_PropertyBlob" }, "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_graph_GetEdges": { "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } ], "type": "array" }, "type": "array", "x-encoding": "EdgeList" }, "Res_graph_GetEdgesPage": { "items": { "maxItems": 4, "minItems": 4, "prefixItems": [ { "type": "string" }, { "type": "string" }, { "format": "uint32", "minimum": 0, "type": "integer" }, { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_graph_GetNeighbors": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_GetNeighborsBatch": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_graph_GetNodeProperties": { "x-dynamic": { "reason": "caller-properties", "summary": "property maps the caller wrote, returned verbatim" }, "x-encoding": "RawOrNull" }, "Res_graph_GetNodePropertiesBatch": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Graph_PropertyBlob" }, { "type": "null" } ] } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_graph_GetNodes": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, true ], "type": "array" }, "type": "array", "x-encoding": "NodeList" }, "Res_graph_GetNodesByLabel": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, true ], "type": "array" }, "type": "array", "x-encoding": "NodeList" }, "Res_graph_GetPredecessors": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_GetSubgraph": { "$ref": "#/components/schemas/ResDef_Graph_SubgraphResult", "x-encoding": "Json" }, "Res_graph_GetSuccessors": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_HasEdge": { "type": "boolean", "x-encoding": "Bool" }, "Res_graph_HasNode": { "type": "boolean", "x-encoding": "Bool" }, "Res_graph_HasNodesBatch": { "items": { "type": "boolean" }, "type": "array", "x-encoding": "Raw" }, "Res_graph_InDegree": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_InvalidateEdge": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_Maintain": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint", "minimum": 0, "type": "integer" }, { "items": { "type": "string" }, "type": "array" } ], "type": "array", "x-encoding": "Raw" }, "Res_graph_Metrics": { "$ref": "#/components/schemas/ResDef_Graph_GraphMetrics", "x-encoding": "Json" }, "Res_graph_NodeCount": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_NodeIds": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_OutDegree": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_PruneByLifecycle": { "$ref": "#/components/schemas/ResDef_Graph_PruneStats", "x-encoding": "Json" }, "Res_graph_Reconcile": { "type": "string", "x-encoding": "String" }, "Res_graph_Reinforce": { "type": "boolean", "x-encoding": "Bool" }, "Res_graph_RemoveEdge": { "type": "string", "x-encoding": "String" }, "Res_graph_RemoveNode": { "type": "string", "x-encoding": "String" }, "Res_graph_RemoveTriples": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_Reparent": { "type": "boolean", "x-encoding": "Bool" }, "Res_graph_SceneChildren": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_SetPose": { "type": "boolean", "x-encoding": "Bool" }, "Res_graph_StartTrajectory": { "type": "string", "x-encoding": "String" }, "Res_graph_SummariesAtLevel": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_SummaryChildren": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_SupersedeEdge": { "type": "string", "x-encoding": "String" }, "Res_graph_TouchNodes": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_graph_UnionGetNeighbors": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_graph_UnionGetNodeProperties": { "x-dynamic": { "reason": "caller-properties", "summary": "property maps the caller wrote, returned verbatim" }, "x-encoding": "RawOrNull" }, "Res_graph_UnionGetNodesByLabel": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, true ], "type": "array" }, "type": "array", "x-encoding": "NodeList" }, "Res_graph_WorldTransform": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Graph_ScenePose" }, { "type": "null" } ], "x-encoding": "Json" }, "Res_ingestion_AddEmbedding": { "type": "string", "x-encoding": "String" }, "Res_ingestion_Asr": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_AsrTranscription", "x-body": "TranscribeFile", "x-encoding": "Json" } ], "x-selected-by": "op" }, "Res_ingestion_Discover": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_DiscoverHit" }, "type": "array", "x-encoding": "Json" }, "Res_ingestion_IndexRepository": { "$ref": "#/components/schemas/ResDef_Ingestion_IndexResult", "x-encoding": "Json" }, "Res_ingestion_ObserveScreen": { "$ref": "#/components/schemas/ResDef_Ingestion_ScreenObservationResult", "x-encoding": "Json" }, "Res_ingestion_ParseFile": { "$ref": "#/components/schemas/ResDef_Ingestion_ParseResult", "x-encoding": "Json" }, "Res_ingestion_ParseFiles": { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ParseResult" }, "type": "array", "x-encoding": "Json" }, "Res_ingestion_Quantum": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumExpectationResult", "x-body": "expectation", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumQaoaResult", "x-body": "optimize_qaoa", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Ingestion_QuantumRankResult", "x-body": "rank", "x-encoding": "Json" } ], "x-selected-by": "op" }, "Res_ingestion_SemanticIndex": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "admit_binding", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticSqlSourcePageAdmission", "x-body": "admit_source_page", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticSqlSourceReconciliationAdmission", "x-body": "admit_source_reconcile", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "admit_source_record", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "admit_source_replacement", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticBinding" }, { "type": "null" } ], "x-body": "binding", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageLeasePage", "x-body": "claim_stage_leases", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "complete_generation_stage", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "complete_sql_source_stage", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "complete_stage", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "drop_binding", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticBindingPage", "x-body": "list_bindings", "x-encoding": "Raw" }, { "format": "uint64", "minimum": 0, "type": [ "integer", "null" ], "x-body": "live_generation", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "refresh_binding", "x-encoding": "Raw" }, { "type": "boolean", "x-body": "release_stage_lease", "x-encoding": "Raw" }, { "maxItems": 2, "minItems": 2, "prefixItems": [ { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageTransition" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt" } ], "type": [ "array", "null" ], "x-body": "replay_completed_sql_source_stage", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticSqlSourceManifest" }, { "type": "null" } ], "x-body": "sql_source_manifest", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticOutboxStatus", "x-body": "stage_status", "x-encoding": "Raw" }, { "type": "boolean", "x-body": "subscribe_stage_consumer", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticMutationReceipt", "x-body": "transition_binding", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_SemanticStageIntent", "x-body": "validate_stage_lease", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_ingestion_SemanticSearch": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "float", "type": "number" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_ingestion_ServedModality": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityAuthority", "x-body": "authority", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityCapabilities", "x-body": "capabilities", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityTombstoneCollection", "x-body": "collect_tombstones", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityApplyOutcome", "x-body": "delete", "x-encoding": "Raw" }, { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityEvent" }, "type": "array", "x-body": "events", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityApplyOutcome", "x-body": "ingest", "x-encoding": "Raw" }, { "items": { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityApplyOutcome" }, "type": "array", "x-body": "ingest_stream", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityApplyOutcome", "x-body": "move_to_cold", "x-encoding": "Raw" }, { "x-body": "native_query", "x-dynamic": { "reason": "requested-modality", "summary": "the server-declared served-modality body selected by the request" }, "x-encoding": "Raw" }, { "x-body": "query", "x-dynamic": { "reason": "requested-modality", "summary": "the server-declared served-modality body selected by the request" }, "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityApplyOutcome", "x-body": "restore", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_ServedModalityStats", "x-body": "stats", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_ingestion_SourceIngest": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceIngestionReceipt", "x-encoding": "Raw" }, "Res_ingestion_SourceIngestStatus": { "$ref": "#/components/schemas/ResDef_Ingestion_SourceIngestStatus", "x-encoding": "Raw" }, "Res_ingestion_Viz": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_VizCapabilityMatrix", "x-body": "CapabilityMatrix", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Ingestion_VizRenderResponse", "x-body": "Render", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Ingestion_VizProvenanceRecord" }, { "type": "null" } ], "x-body": "RenderProvenance", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_messaging_BindQueue": { "type": "string", "x-encoding": "String" }, "Res_messaging_BrokerAck": { "type": "boolean", "x-encoding": "Bool" }, "Res_messaging_BrokerAckTag": { "type": "boolean", "x-encoding": "Bool" }, "Res_messaging_BrokerConsume": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, true ], "type": [ "array", "null" ], "x-encoding": "Raw" }, "Res_messaging_BrokerNackTag": { "type": "string", "x-encoding": "String" }, "Res_messaging_BrokerReject": { "type": "string", "x-encoding": "String" }, "Res_messaging_BrokerRenewTag": { "type": "boolean", "x-encoding": "Bool" }, "Res_messaging_CdcRead": { "$ref": "#/components/schemas/ResDef_Messaging_CdcReadResult", "x-encoding": "Raw" }, "Res_messaging_CepPoll": { "items": { "$ref": "#/components/schemas/ResDef_Messaging_CepMatch" }, "type": "array", "x-encoding": "Raw" }, "Res_messaging_CepSubscribe": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_messaging_CepUnsubscribe": { "type": "boolean", "x-encoding": "Bool" }, "Res_messaging_CloseChannel": { "$ref": "#/components/schemas/ResDef_Messaging_ChannelDeparture", "x-encoding": "Json" }, "Res_messaging_CreateChannel": { "$ref": "#/components/schemas/ResDef_Messaging_ChannelCreated", "x-encoding": "Json" }, "Res_messaging_DeclareExchange": { "type": "string", "x-encoding": "String" }, "Res_messaging_DeclareQueue": { "type": "string", "x-encoding": "String" }, "Res_messaging_DeleteExchange": { "type": "boolean", "x-encoding": "Bool" }, "Res_messaging_DropContinuousQuery": { "type": "boolean", "x-encoding": "Bool" }, "Res_messaging_DropTrigger": { "type": "boolean", "x-encoding": "Bool" }, "Res_messaging_FiredTriggers": { "$ref": "#/components/schemas/ResDef_Messaging_FiredTriggersResult", "x-encoding": "Raw" }, "Res_messaging_GetChannelMembers": { "items": { "type": "string" }, "type": "array", "x-encoding": "Ids" }, "Res_messaging_GetChannelMessages": { "items": { "$ref": "#/components/schemas/ResDef_Messaging_ChannelMessage" }, "type": "array", "x-encoding": "Json" }, "Res_messaging_JoinChannel": { "type": "string", "x-encoding": "String" }, "Res_messaging_LeaveChannel": { "$ref": "#/components/schemas/ResDef_Messaging_ChannelDeparture", "x-encoding": "Json" }, "Res_messaging_ListChannels": { "items": { "$ref": "#/components/schemas/ResDef_Messaging_ChannelSummary" }, "type": "array", "x-encoding": "Json" }, "Res_messaging_ListTriggers": { "items": { "$ref": "#/components/schemas/ResDef_Messaging_TriggerInfo" }, "type": "array", "x-encoding": "Raw" }, "Res_messaging_Publish": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_messaging_PublishConfirmed": { "$ref": "#/components/schemas/ResDef_Messaging_ConfirmToken", "x-encoding": "Raw" }, "Res_messaging_PublishEx": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_messaging_PublishIdempotent": { "$ref": "#/components/schemas/ResDef_Messaging_IdempotentPublish", "x-encoding": "Raw" }, "Res_messaging_ReadContinuousQuery": { "$ref": "#/components/schemas/ResDef_Messaging_ContinuousQueryResult", "x-encoding": "Raw" }, "Res_messaging_RegisterContinuousQuery": { "type": "string", "x-encoding": "String" }, "Res_messaging_RegisterTrigger": { "type": "string", "x-encoding": "String" }, "Res_messaging_SendMessage": { "type": "string", "x-encoding": "String" }, "Res_messaging_StreamCommitOffset": { "type": "string", "x-encoding": "String" }, "Res_messaging_StreamCommittedOffset": { "format": "int64", "type": [ "integer", "null" ], "x-encoding": "Raw" }, "Res_messaging_StreamDeclare": { "type": "string", "x-encoding": "String" }, "Res_messaging_StreamPublish": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_messaging_StreamRead": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "int64", "type": "integer" }, { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_messaging_StreamTrim": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_messaging_SweepExpired": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_messaging_UnbindQueue": { "type": "boolean", "x-encoding": "Bool" }, "Res_messaging_Watch": { "$ref": "#/components/schemas/ResDef_Messaging_WatchBatch", "x-encoding": "Raw" }, "Res_query_CausalCounterfactual": { "$ref": "#/components/schemas/ResDef_Query_CausalCounterfactualResult", "x-encoding": "Raw" }, "Res_query_CausalEstimate": { "$ref": "#/components/schemas/ResDef_Query_CausalEstimateResult", "x-encoding": "Raw" }, "Res_query_CypherQuery": { "x-dynamic": { "reason": "query-rows", "summary": "rows whose columns and value types are chosen by the caller's query text" }, "x-encoding": "Raw" }, "Res_query_Decide": { "$ref": "#/components/schemas/ResDef_Query_DecisionBatch", "x-encoding": "Raw" }, "Res_query_EpistemicStatus": { "$ref": "#/components/schemas/ResDef_Query_EpistemicStatusResult", "x-encoding": "Raw" }, "Res_query_ExplainBelief": { "$ref": "#/components/schemas/ResDef_Query_ExplainBeliefResponse", "x-encoding": "Raw" }, "Res_query_ExplainEvidence": { "$ref": "#/components/schemas/ResDef_Query_ExplainEvidenceResult", "x-encoding": "Raw" }, "Res_query_ExplainPlan": { "$ref": "#/components/schemas/ResDef_Query_ExplainPlanResult", "x-encoding": "Raw" }, "Res_query_ExplainPolicy": { "$ref": "#/components/schemas/ResDef_Query_ExplainPolicyResult", "x-encoding": "Raw" }, "Res_query_ExplainProvenance": { "$ref": "#/components/schemas/ResDef_Query_EvidenceBundle", "x-encoding": "Raw" }, "Res_query_ExplainProvenanceByIds": { "$ref": "#/components/schemas/ResDef_Query_EvidenceBundle", "x-encoding": "Raw" }, "Res_query_GetChangeCursor": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ChangeCursor" }, { "type": "null" } ], "x-encoding": "Raw" }, "Res_query_GetChangeEnvelope": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ChangeEnvelopeRecord" }, { "type": "null" } ], "x-encoding": "Raw" }, "Res_query_GetContentVersion": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Query_ContentVersion" }, { "type": "null" } ], "x-encoding": "Raw" }, "Res_query_GetContextView": { "$ref": "#/components/schemas/ResDef_Query_ContextView", "x-encoding": "Json" }, "Res_query_GraphQl": { "x-dynamic": { "reason": "query-rows", "summary": "rows whose columns and value types are chosen by the caller's query text" }, "x-encoding": "Raw" }, "Res_query_KnowledgeStream": { "$ref": "#/components/schemas/ResDef_Query_KnowledgeStreamBatch", "x-encoding": "Raw" }, "Res_query_MaterializationStatus": { "$ref": "#/components/schemas/ResDef_Query_MaterializationStatusResult", "x-encoding": "Raw" }, "Res_query_NlQuery": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "float", "type": [ "number", "null" ] } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_query_RankByProvenance": { "$ref": "#/components/schemas/ResDef_Query_RankByProvenanceResult", "x-encoding": "Raw" }, "Res_query_RecomputeMaterialization": { "$ref": "#/components/schemas/ResDef_Query_RecomputeMaterializationResult", "x-encoding": "Raw" }, "Res_query_ResolveConflict": { "$ref": "#/components/schemas/ResDef_Query_ResolveConflictResult", "x-encoding": "Raw" }, "Res_query_Sql": { "x-dynamic": { "reason": "query-rows", "summary": "rows whose columns and value types are chosen by the caller's query text" }, "x-encoding": "Raw" }, "Res_query_StaleMaterializations": { "$ref": "#/components/schemas/ResDef_Query_StaleMaterializationsResult", "x-encoding": "Raw" }, "Res_query_TxnUnifiedQuery": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "float", "type": [ "number", "null" ] } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_query_TxnUnifiedQueryText": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "float", "type": [ "number", "null" ] } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_query_UnifiedQuery": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "float", "type": [ "number", "null" ] } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_query_UnifiedQueryText": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "format": "float", "type": [ "number", "null" ] } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_query_WhatChanged": { "$ref": "#/components/schemas/ResDef_Query_WhatChangedResult", "x-encoding": "Raw" }, "Res_reasoning_GetRdf": { "type": "string", "x-encoding": "Raw" }, "Res_reasoning_GraphSchema": { "$ref": "#/components/schemas/ResDef_Reasoning_GraphSchemaCommitted", "x-encoding": "Raw" }, "Res_reasoning_GraphSchemaList": { "$ref": "#/components/schemas/ResDef_Reasoning_GraphSchemaSourcesView", "x-encoding": "Raw" }, "Res_reasoning_IcvConfigure": { "type": "boolean", "x-encoding": "Bool" }, "Res_reasoning_OwlExplain": { "$ref": "#/components/schemas/ResDef_Reasoning_OwlExplainResult", "x-encoding": "Raw" }, "Res_reasoning_OwlReason": { "$ref": "#/components/schemas/ResDef_Reasoning_OwlReasonResult", "x-encoding": "Raw" }, "Res_reasoning_OwlReasonDistributed": { "$ref": "#/components/schemas/ResDef_Reasoning_OwlReasonResult", "x-encoding": "Raw" }, "Res_reasoning_RunDatalogReasoning": { "$ref": "#/components/schemas/ResDef_Reasoning_DatalogReasoningResult", "x-encoding": "Json" }, "Res_reasoning_RunRules": { "$ref": "#/components/schemas/ResDef_Reasoning_RuleReasonResponse", "x-encoding": "Raw" }, "Res_reasoning_ShaclValidate": { "$ref": "#/components/schemas/ResDef_Reasoning_ShaclValidationReport", "x-encoding": "Json" }, "Res_reasoning_ShexValidate": { "$ref": "#/components/schemas/ResDef_Reasoning_ShexValidationReport", "x-encoding": "Json" }, "Res_reasoning_Sparql": { "$ref": "#/components/schemas/ResDef_Reasoning_SparqlResult", "x-encoding": "Raw" }, "Res_reasoning_SparqlVirtual": { "$ref": "#/components/schemas/ResDef_Reasoning_SparqlResult", "x-encoding": "Raw" }, "Res_security_AuditProveInclusion": { "$ref": "#/components/schemas/ResDef_Security_MerkleInclusionReport", "x-encoding": "Raw" }, "Res_security_AuditVerify": { "$ref": "#/components/schemas/ResDef_Security_AuditReport", "x-encoding": "Raw" }, "Res_security_GetIdentity": { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Security_AgentIdentity" }, { "type": "null" } ], "x-encoding": "Json" }, "Res_security_GetLedger": { "$ref": "#/components/schemas/ResDef_Security_LedgerReadResult", "x-encoding": "Json" }, "Res_security_RbacAdmin": { "oneOf": [ { "type": "string", "x-body": "AddGrant", "x-encoding": "String" }, { "type": "string", "x-body": "AddRole", "x-encoding": "String" }, { "$ref": "#/components/schemas/ResDef_Security_RbacPolicyListing", "x-body": "List", "x-encoding": "Json" }, { "$ref": "#/components/schemas/ResDef_Security_RbacGrantRemoval", "x-body": "RemoveGrant", "x-encoding": "Json" }, { "type": "string", "x-body": "RemoveRole", "x-encoding": "String" } ], "x-selected-by": "op" }, "Res_security_RegisterIdentity": { "type": "string", "x-encoding": "String" }, "Res_storage_AgentAssemble": { "$ref": "#/components/schemas/ResDef_Storage_AssemblyResult", "x-encoding": "Raw" }, "Res_storage_AgentComponent": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentContentResult", "x-body": "content", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentEntry" }, { "type": "null" } ], "x-body": "current", "x-encoding": "Raw" }, { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentEntry" }, "type": "array", "x-body": "history", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentCommittedResult", "x-body": "publish", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentCommittedResult", "x-body": "retire", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentSearchPage", "x-body": "search", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentComponentCommittedResult" }, { "type": "null" } ], "x-body": "status", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_storage_AgentGraph": { "oneOf": [ { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphEntry" }, { "type": "null" } ], "x-body": "current", "x-encoding": "Raw" }, { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphEntry" }, "type": "array", "x-body": "history", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphCommittedResult", "x-body": "publish", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphCommittedResult", "x-body": "retire", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentGraphCommittedResult" }, { "type": "null" } ], "x-body": "status", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_storage_AgentLibrary": { "oneOf": [ { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryEntry" }, { "type": "null" } ], "x-body": "current", "x-encoding": "Raw" }, { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryEntry" }, "type": "array", "x-body": "history", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryWriteResult", "x-body": "publish", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryWriteResult", "x-body": "retire", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryWriteResult" }, { "type": "null" } ], "x-body": "status", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_storage_AgentTemplate": { "oneOf": [ { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentTemplateEntry" }, { "type": "null" } ], "x-body": "current", "x-encoding": "Raw" }, { "items": { "$ref": "#/components/schemas/ResDef_Storage_AgentTemplateEntry" }, "type": "array", "x-body": "history", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentLibraryEntryDraft", "x-body": "instantiate", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentTemplateCommittedResult", "x-body": "publish", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_AgentTemplateCommittedResult", "x-body": "retire", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_AgentTemplateCommittedResult" }, { "type": "null" } ], "x-body": "status", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_storage_ApplyLedger": { "type": "string", "x-encoding": "String" }, "Res_storage_Backup": { "$ref": "#/components/schemas/ResDef_Storage_BackupReceipt", "x-encoding": "Json" }, "Res_storage_BlobBegin": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_storage_BlobChunkGet": { "x-dynamic": { "reason": "caller-bytes", "summary": "opaque bytes the caller wrote or a caller-supplied program produced" }, "x-encoding": "Raw" }, "Res_storage_BlobChunkPut": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_storage_BlobCommit": { "type": "string", "x-encoding": "String" }, "Res_storage_BlobFetchBegin": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint64", "minimum": 0, "type": "integer" }, { "format": "uint32", "minimum": 0, "type": "integer" } ], "type": "array", "x-encoding": "Raw" }, "Res_storage_BlobFetchEnd": { "type": "boolean", "x-encoding": "Bool" }, "Res_storage_BlobGc": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uint64", "minimum": 0, "type": "integer" }, { "format": "uint64", "minimum": 0, "type": "integer" } ], "type": "array", "x-encoding": "Raw" }, "Res_storage_BlobRef": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_storage_BlobUnref": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_storage_ClearLedger": { "type": "string", "x-encoding": "String" }, "Res_storage_ConnectorPack": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Storage_ConnectorPackBindingResult", "x-body": "bind", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_PackImportResult", "x-body": "import", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_PackBodyReconcileReport", "x-body": "reconcile_bodies", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_PackImportReceipt", "x-body": "reproject", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_PackRetireResult", "x-body": "retire", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_ConnectorPackStatus", "x-body": "status", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_ConnectorPackBindingResult", "x-body": "unbind", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_storage_DecisionCommit": { "$ref": "#/components/schemas/ResDef_Storage_DecisionCommitResult", "x-encoding": "Raw" }, "Res_storage_ExportSqliteFile": { "$ref": "#/components/schemas/ResDef_Storage_SqliteExportReport", "x-encoding": "Json" }, "Res_storage_FromMsgpack": { "type": "string", "x-encoding": "String" }, "Res_storage_ImportSqliteFile": { "$ref": "#/components/schemas/ResDef_Storage_SqliteImportReport", "x-encoding": "Json" }, "Res_storage_KvCas": { "type": "boolean", "x-encoding": "Bool" }, "Res_storage_KvDelete": { "type": "boolean", "x-encoding": "Bool" }, "Res_storage_KvGet": { "x-dynamic": { "reason": "caller-bytes", "summary": "opaque bytes the caller wrote or a caller-supplied program produced" }, "x-encoding": "RawOrNull" }, "Res_storage_KvPut": { "type": "string", "x-encoding": "String" }, "Res_storage_KvScan": { "x-dynamic": { "reason": "caller-bytes", "summary": "opaque bytes the caller wrote or a caller-supplied program produced" }, "x-encoding": "Raw" }, "Res_storage_Restore": { "$ref": "#/components/schemas/ResDef_Storage_RestoreReceipt", "x-encoding": "Json" }, "Res_storage_SqlSourceBatch": { "$ref": "#/components/schemas/ResDef_Storage_SqlSourceBatchResult", "x-encoding": "Raw" }, "Res_storage_ToMsgpack": { "items": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": "array", "x-encoding": "Json" }, "Res_storage_TsAppend": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_storage_TsAsofJoin": { "items": { "format": "double", "type": [ "number", "null" ] }, "type": "array", "x-encoding": "Raw" }, "Res_storage_TsDeleteSeries": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_storage_TsEvict": { "format": "uint64", "minimum": 0, "type": "integer", "x-encoding": "Count" }, "Res_storage_TsGapFill": { "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "int64", "type": "integer" }, { "format": "double", "type": "number" }, { "type": "boolean" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_storage_TsListSeries": { "items": { "type": "string" }, "type": "array", "x-encoding": "Raw" }, "Res_storage_TsRange": { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "int64", "type": "integer" }, { "items": { "format": "double", "type": "number" }, "type": "array" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_storage_TsWindow": { "items": { "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "int64", "type": "integer" }, { "format": "double", "type": "number" }, { "format": "uint", "minimum": 0, "type": "integer" } ], "type": "array" }, "type": "array", "x-encoding": "Raw" }, "Res_storage_WriteBack": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Storage_SourceChangeSet", "x-body": "create", "x-encoding": "Raw" }, { "anyOf": [ { "$ref": "#/components/schemas/ResDef_Storage_SourceChangeSet" }, { "type": "null" } ], "x-body": "get", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_WriteBackReceiptPage", "x-body": "receipts", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_WriteBackReceipt", "x-body": "record_attempt", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Storage_ReconciliationReceipt", "x-body": "record_reconciliation", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_transactions_ApplyChangeEnvelope": { "$ref": "#/components/schemas/ResDef_Transactions_ChangeEnvelopeApplied", "x-encoding": "Json" }, "Res_transactions_ApplyChangeEnvelopes": { "$ref": "#/components/schemas/ResDef_Transactions_ChangeEnvelopeBatch", "x-encoding": "Json" }, "Res_transactions_ApplyMultisigMutation": { "$ref": "#/components/schemas/ResDef_Transactions_SparqlUpdateReport", "x-encoding": "Json" }, "Res_transactions_BatchUpdate": { "$ref": "#/components/schemas/ResDef_Transactions_BatchUpdateReport", "x-encoding": "Json" }, "Res_transactions_BeginTxn": { "type": "string", "x-encoding": "String" }, "Res_transactions_Commit": { "$ref": "#/components/schemas/ResDef_Transactions_CommitOutcome", "x-encoding": "Json" }, "Res_transactions_MultiGraphBatchUpdate": { "$ref": "#/components/schemas/ResDef_Transactions_MultiGraphBatchReport", "x-encoding": "Json" }, "Res_transactions_MutationOutbox": { "oneOf": [ { "$ref": "#/components/schemas/ResDef_Transactions_OutboxDeadLetterPage", "x-body": "dead_letters", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Transactions_OutboxRewindReceipt", "x-body": "rewind", "x-encoding": "Raw" }, { "$ref": "#/components/schemas/ResDef_Transactions_MutationOutboxStatusView", "x-body": "status", "x-encoding": "Raw" } ], "x-selected-by": "op" }, "Res_transactions_Rollback": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnAddEdge": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnAddEmbedding": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnAddMeasurement": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnAddNode": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnAxiom": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnBlobRef": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnCas": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnConstruct": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnMaterializeBelief": { "$ref": "#/components/schemas/ResDef_Transactions_BeliefMaterialization", "x-encoding": "Json" }, "Res_transactions_TxnPlanWriteback": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnRemoveEdge": { "type": "boolean", "x-encoding": "Bool" }, "Res_transactions_TxnRemoveNode": { "type": "boolean", "x-encoding": "Bool" } } }, "info": { "description": "Generated from contract/methods.json + contract/schemas/ (eg-capabilities/gen_contract, 436 methods) by scripts/gen_api_docs.py -- do not hand-edit. Schemas describe each method's JSON-Schema-equivalent request/result SHAPE; the real wire encoding is MessagePack, not JSON (contract/schemas/method.request.json's own $comment), so the media type below is `application/msgpack`, not `application/json`. Regenerate with `python3 scripts/gen_api_docs.py --write`.", "title": "Epistemic Graph API", "version": "1" }, "openapi": "3.1.0", "paths": { "/rpc/cluster/CancelRequest": { "post": { "operationId": "CancelRequest", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CancelRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_CancelRequest" } } }, "description": "`CancelRequest` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CancelRequest", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "service:control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/cluster/CatalogAssign": { "post": { "operationId": "CatalogAssign", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CatalogAssign" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_CatalogAssign" } } }, "description": "`CatalogAssign` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed admin MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/CatalogList": { "post": { "operationId": "CatalogList", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CatalogList" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_CatalogList" } } }, "description": "`CatalogList` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CatalogList", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster-read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/cluster/CatalogReassign": { "post": { "operationId": "CatalogReassign", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CatalogReassign" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_CatalogReassign" } } }, "description": "`CatalogReassign` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed admin MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/CatalogRemove": { "post": { "operationId": "CatalogRemove", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CatalogRemove" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_CatalogRemove" } } }, "description": "`CatalogRemove` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed admin MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/ClusterMembers": { "post": { "operationId": "ClusterMembers", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ClusterMembers" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_ClusterMembers" } } }, "description": "`ClusterMembers` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ADR-1/W1.1 engine-authoritative client topology; deliberately NOT admin:cluster-read -- ordinary service roles need it to re-resolve after a failover; answered from any node, not just the leader", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "cluster:topology-read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/cluster/CreateGraph": { "post": { "operationId": "CreateGraph", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CreateGraph" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_CreateGraph" } } }, "description": "`CreateGraph` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "native lifecycle MutationBatch before registry publication", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "graph:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/cluster/CreateMatView": { "post": { "operationId": "CreateMatView", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CreateMatView" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_CreateMatView" } } }, "description": "`CreateMatView` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed control-plane MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "matview:admin", "x-consumer-profiles": [], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Saga" } }, "/rpc/cluster/DeleteGraph": { "post": { "operationId": "DeleteGraph", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DeleteGraph" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_DeleteGraph" } } }, "description": "`DeleteGraph` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "native lifecycle MutationBatch before registry eviction", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "graph:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/cluster/FleetCatalog": { "post": { "operationId": "FleetCatalog", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FleetCatalog" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_FleetCatalog" } } }, "description": "`FleetCatalog` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "EH-345 fleet catalog, runtime-conditional: list/lookup are tenant- and principal-projected snapshot reads forced to __commons__ that join discovery records and operator overrides with connector-pack AgentComponents; record_discovery/set_override/clear_override self-translate into CreateNodeIfAbsent/CompareAndSetNodeFields against __commons__ (overrides need admin:fleet-catalog)", "tags": [ "cluster" ], "x-audited": true, "x-authz-action": "registry:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/cluster/GetMatView": { "post": { "operationId": "GetMatView", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetMatView" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_GetMatView" } } }, "description": "`GetMatView` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetMatView", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "matview:read", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/cluster/Health": { "post": { "operationId": "Health", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Health" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_Health" } } }, "description": "`Health` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Health", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "service:control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/cluster/ListGraphs": { "post": { "operationId": "ListGraphs", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ListGraphs" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_ListGraphs" } } }, "description": "`ListGraphs` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ListGraphs", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "graph:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/cluster/ListRegisteredServers": { "post": { "operationId": "ListRegisteredServers", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ListRegisteredServers" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_ListRegisteredServers" } } }, "description": "`ListRegisteredServers` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "typed, RLS-projected live :Server snapshot forced to __commons__; revision+digest-fenced keyset pages; authoritative on the single-node/full route (no cluster read barrier is claimed)", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "registry:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/cluster/Ping": { "post": { "operationId": "Ping", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Ping" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_Ping" } } }, "description": "`Ping` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Ping", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "service:control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/cluster/PlacementAdmin": { "post": { "operationId": "PlacementAdmin", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PlacementAdmin" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_PlacementAdmin" } } }, "description": "`PlacementAdmin` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "raft-replicated placement-catalog admin op (Assign/Move/AbortMove, the placement DECISION + PLAN->EXECUTE->CATALOG-UPDATE legs): MultiRaft::placement_assign / TenantManager::move_partition / abort_move commit through the DEFAULT group's own client_write / commit_placement, not this gateway's per-graph MutationBatch", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/PlacementRoute": { "post": { "operationId": "PlacementRoute", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PlacementRoute" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_PlacementRoute" } } }, "description": "`PlacementRoute` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "engine-authoritative complete route; single-node returns authoritative unplaced group 0/epoch 0, while clustered routing requires a live MultiRaft control leader; GOC-15/BUG-030 narrowed off admin:cluster-read (2026-08-17) -- ordinary kg:read/kg:write routes their OWN tenant, handlers::placement::handle_route requires kg:admin for any other tenant's route", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "cluster:placement-read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/cluster/PlanMatViewDefine": { "post": { "operationId": "PlanMatViewDefine", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PlanMatViewDefine" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_PlanMatViewDefine" } } }, "description": "`PlanMatViewDefine` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed control-plane MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "matview:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/PlanMatViewDrop": { "post": { "operationId": "PlanMatViewDrop", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PlanMatViewDrop" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_PlanMatViewDrop" } } }, "description": "`PlanMatViewDrop` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed control-plane MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "matview:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/PlanMatViewGet": { "post": { "operationId": "PlanMatViewGet", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PlanMatViewGet" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_PlanMatViewGet" } } }, "description": "`PlanMatViewGet` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "PlanMatViewGet", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "matview:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/cluster/PlanMatViewRefresh": { "post": { "operationId": "PlanMatViewRefresh", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PlanMatViewRefresh" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_PlanMatViewRefresh" } } }, "description": "`PlanMatViewRefresh` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed control-plane MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "matview:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/RaftAddLearner": { "post": { "operationId": "RaftAddLearner", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RaftAddLearner" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_RaftAddLearner" } } }, "description": "`RaftAddLearner` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "leader-only openraft add_learner; attaches a non-voting replica without changing the voter set", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/RaftChangeMembership": { "post": { "operationId": "RaftChangeMembership", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RaftChangeMembership" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_RaftChangeMembership" } } }, "description": "`RaftChangeMembership` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "leader-only openraft change_membership; sets the group's exact voter set (the usual way to promote a learner added via RaftAddLearner)", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/RebalanceExecute": { "post": { "operationId": "RebalanceExecute", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RebalanceExecute" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_RebalanceExecute" } } }, "description": "`RebalanceExecute` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed admin MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/RebalancePlan": { "post": { "operationId": "RebalancePlan", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RebalancePlan" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_RebalancePlan" } } }, "description": "`RebalancePlan` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RebalancePlan", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster-read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/cluster/RefreshMatView": { "post": { "operationId": "RefreshMatView", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RefreshMatView" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_RefreshMatView" } } }, "description": "`RefreshMatView` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed control-plane MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "matview:admin", "x-consumer-profiles": [], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Saga" } }, "/rpc/cluster/RegisterForeignSource": { "post": { "operationId": "RegisterForeignSource", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RegisterForeignSource" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_RegisterForeignSource" } } }, "description": "`RegisterForeignSource` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed control receipt; endpoint configuration is not duplicated in the ledger", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "federation:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/RegisterServer": { "post": { "operationId": "RegisterServer", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RegisterServer" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_RegisterServer" } } }, "description": "`RegisterServer` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "W2.5 fleet server push-registration/heartbeat: self-translates into Method::AddNode against __commons__ (dispatch.rs), writing a REAL :Server graph node, unlike the internal non-graph topology rows", "tags": [ "cluster" ], "x-audited": true, "x-authz-action": "registry:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/cluster/RegisterUdf": { "post": { "operationId": "RegisterUdf", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RegisterUdf" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_RegisterUdf" } } }, "description": "`RegisterUdf` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed control receipt; module bytes are not duplicated in the ledger", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "udf:admin", "x-consumer-profiles": [], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Saga" } }, "/rpc/cluster/Reshard": { "post": { "operationId": "Reshard", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Reshard" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_Reshard" } } }, "description": "`Reshard` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed admin MutationBatch saga", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "admin:cluster", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/cluster/Shutdown": { "post": { "operationId": "Shutdown", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Shutdown" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_cluster_Shutdown" } } }, "description": "`Shutdown` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "explicitly ephemeral process control; never acknowledges a user-data commit", "tags": [ "cluster" ], "x-audited": false, "x-authz-action": "service:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "VolatileControl", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "NonceOnly", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/BatchL2Normalize": { "post": { "operationId": "BatchL2Normalize", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BatchL2Normalize" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_BatchL2Normalize" } } }, "description": "`BatchL2Normalize` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BatchL2Normalize", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:semantic", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/BetweennessCentrality": { "post": { "operationId": "BetweennessCentrality", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BetweennessCentrality" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_BetweennessCentrality" } } }, "description": "`BetweennessCentrality` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BetweennessCentrality", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/ClusterHierarchyClusters": { "post": { "operationId": "ClusterHierarchyClusters", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ClusterHierarchyClusters" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_ClusterHierarchyClusters" } } }, "description": "`ClusterHierarchyClusters` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "VIZ-1: GET clusters(graph, level, parent_cluster_id?) from the cached hierarchy", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/ClusterHierarchyExpand": { "post": { "operationId": "ClusterHierarchyExpand", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ClusterHierarchyExpand" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_ClusterHierarchyExpand" } } }, "description": "`ClusterHierarchyExpand` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "VIZ-1: GET expand(graph, cluster_id) -- a level-1 cluster's member nodes/edges read live off the graph", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/ClusterHierarchyRefresh": { "post": { "operationId": "ClusterHierarchyRefresh", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ClusterHierarchyRefresh" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_ClusterHierarchyRefresh" } } }, "description": "`ClusterHierarchyRefresh` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "VIZ-1 hierarchical Leiden clustering for million-node graph visualization: (re)computes and durably caches the cluster hierarchy in its own non-authoritative store (server::persistence::cluster_hierarchy_store), never as graph nodes/edges -- see ClusterHierarchyClusters/ClusterHierarchyExpand", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/CommunityDetectEphemeral": { "post": { "operationId": "CommunityDetectEphemeral", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CommunityDetectEphemeral" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_CommunityDetectEphemeral" } } }, "description": "`CommunityDetectEphemeral` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CommunityDetectEphemeral", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/CommunityDetection": { "post": { "operationId": "CommunityDetection", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CommunityDetection" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_CommunityDetection" } } }, "description": "`CommunityDetection` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CommunityDetection", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/ComputeSimilarityEdges": { "post": { "operationId": "ComputeSimilarityEdges", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ComputeSimilarityEdges" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_ComputeSimilarityEdges" } } }, "description": "`ComputeSimilarityEdges` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ComputeSimilarityEdges", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/ConnectedComponents": { "post": { "operationId": "ConnectedComponents", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ConnectedComponents" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_ConnectedComponents" } } }, "description": "`ConnectedComponents` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ConnectedComponents", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/DegreeCentrality": { "post": { "operationId": "DegreeCentrality", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DegreeCentrality" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DegreeCentrality" } } }, "description": "`DegreeCentrality` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DegreeCentrality", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/DegreeCentralityAll": { "post": { "operationId": "DegreeCentralityAll", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DegreeCentralityAll" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DegreeCentralityAll" } } }, "description": "`DegreeCentralityAll` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DegreeCentralityAll", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/DistributedCompute": { "post": { "operationId": "DistributedCompute", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DistributedCompute" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DistributedCompute" } } }, "description": "`DistributedCompute` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "read-only Pregel/GAS computation; materialization uses the distinct Create*/Refresh* methods", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "distcompute:read", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/compute/DsAdamStep": { "post": { "operationId": "DsAdamStep", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsAdamStep" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsAdamStep" } } }, "description": "`DsAdamStep` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsAdamStep", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsComputeStats": { "post": { "operationId": "DsComputeStats", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsComputeStats" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsComputeStats" } } }, "description": "`DsComputeStats` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsComputeStats", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsCrossEntropy": { "post": { "operationId": "DsCrossEntropy", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsCrossEntropy" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsCrossEntropy" } } }, "description": "`DsCrossEntropy` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsCrossEntropy", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsDpoLoss": { "post": { "operationId": "DsDpoLoss", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsDpoLoss" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsDpoLoss" } } }, "description": "`DsDpoLoss` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsDpoLoss", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsFitEstimator": { "post": { "operationId": "DsFitEstimator", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsFitEstimator" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsFitEstimator" } } }, "description": "`DsFitEstimator` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsFitEstimator", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsGrpoSurrogate": { "post": { "operationId": "DsGrpoSurrogate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsGrpoSurrogate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsGrpoSurrogate" } } }, "description": "`DsGrpoSurrogate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsGrpoSurrogate", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsKMeans": { "post": { "operationId": "DsKMeans", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsKMeans" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsKMeans" } } }, "description": "`DsKMeans` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsKMeans", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsKlDivergence": { "post": { "operationId": "DsKlDivergence", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsKlDivergence" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsKlDivergence" } } }, "description": "`DsKlDivergence` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsKlDivergence", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsLinearRegression": { "post": { "operationId": "DsLinearRegression", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsLinearRegression" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsLinearRegression" } } }, "description": "`DsLinearRegression` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsLinearRegression", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsLogSoftmax": { "post": { "operationId": "DsLogSoftmax", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsLogSoftmax" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsLogSoftmax" } } }, "description": "`DsLogSoftmax` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsLogSoftmax", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsPca": { "post": { "operationId": "DsPca", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsPca" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsPca" } } }, "description": "`DsPca` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsPca", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsPredictEstimator": { "post": { "operationId": "DsPredictEstimator", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsPredictEstimator" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsPredictEstimator" } } }, "description": "`DsPredictEstimator` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsPredictEstimator", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsSgdStep": { "post": { "operationId": "DsSgdStep", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsSgdStep" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsSgdStep" } } }, "description": "`DsSgdStep` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsSgdStep", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsSoftmax": { "post": { "operationId": "DsSoftmax", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsSoftmax" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsSoftmax" } } }, "description": "`DsSoftmax` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsSoftmax", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/DsTrainTestSplit": { "post": { "operationId": "DsTrainTestSplit", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DsTrainTestSplit" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_DsTrainTestSplit" } } }, "description": "`DsTrainTestSplit` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DsTrainTestSplit", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:datascience", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceAdfTest": { "post": { "operationId": "FinanceAdfTest", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceAdfTest" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceAdfTest" } } }, "description": "`FinanceAdfTest` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceAdfTest", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceAlphaCombinationEngine": { "post": { "operationId": "FinanceAlphaCombinationEngine", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceAlphaCombinationEngine" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceAlphaCombinationEngine" } } }, "description": "`FinanceAlphaCombinationEngine` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceAlphaCombinationEngine", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceAvellanedaStoikov": { "post": { "operationId": "FinanceAvellanedaStoikov", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceAvellanedaStoikov" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceAvellanedaStoikov" } } }, "description": "`FinanceAvellanedaStoikov` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceAvellanedaStoikov", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceBayesianKelly": { "post": { "operationId": "FinanceBayesianKelly", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceBayesianKelly" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceBayesianKelly" } } }, "description": "`FinanceBayesianKelly` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceBayesianKelly", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceBlackLitterman": { "post": { "operationId": "FinanceBlackLitterman", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceBlackLitterman" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceBlackLitterman" } } }, "description": "`FinanceBlackLitterman` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceBlackLitterman", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceBreakevenAlpha": { "post": { "operationId": "FinanceBreakevenAlpha", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceBreakevenAlpha" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceBreakevenAlpha" } } }, "description": "`FinanceBreakevenAlpha` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceBreakevenAlpha", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceBrierScore": { "post": { "operationId": "FinanceBrierScore", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceBrierScore" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceBrierScore" } } }, "description": "`FinanceBrierScore` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceBrierScore", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceCombineAlphas": { "post": { "operationId": "FinanceCombineAlphas", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceCombineAlphas" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceCombineAlphas" } } }, "description": "`FinanceCombineAlphas` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceCombineAlphas", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceConvergenceGate": { "post": { "operationId": "FinanceConvergenceGate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceConvergenceGate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceConvergenceGate" } } }, "description": "`FinanceConvergenceGate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceConvergenceGate", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceCrossSectionalRank": { "post": { "operationId": "FinanceCrossSectionalRank", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceCrossSectionalRank" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceCrossSectionalRank" } } }, "description": "`FinanceCrossSectionalRank` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceCrossSectionalRank", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceCvar": { "post": { "operationId": "FinanceCvar", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceCvar" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceCvar" } } }, "description": "`FinanceCvar` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceCvar", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceDeflatedSharpe": { "post": { "operationId": "FinanceDeflatedSharpe", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceDeflatedSharpe" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceDeflatedSharpe" } } }, "description": "`FinanceDeflatedSharpe` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceDeflatedSharpe", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceDetectRegimes": { "post": { "operationId": "FinanceDetectRegimes", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceDetectRegimes" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceDetectRegimes" } } }, "description": "`FinanceDetectRegimes` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceDetectRegimes", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceDieboldMariano": { "post": { "operationId": "FinanceDieboldMariano", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceDieboldMariano" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceDieboldMariano" } } }, "description": "`FinanceDieboldMariano` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceDieboldMariano", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceDownsideDeviation": { "post": { "operationId": "FinanceDownsideDeviation", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceDownsideDeviation" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceDownsideDeviation" } } }, "description": "`FinanceDownsideDeviation` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceDownsideDeviation", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceDrawdownSeries": { "post": { "operationId": "FinanceDrawdownSeries", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceDrawdownSeries" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceDrawdownSeries" } } }, "description": "`FinanceDrawdownSeries` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceDrawdownSeries", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceEffectiveIndependentN": { "post": { "operationId": "FinanceEffectiveIndependentN", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceEffectiveIndependentN" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceEffectiveIndependentN" } } }, "description": "`FinanceEffectiveIndependentN` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceEffectiveIndependentN", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceEfficientFrontier": { "post": { "operationId": "FinanceEfficientFrontier", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceEfficientFrontier" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceEfficientFrontier" } } }, "description": "`FinanceEfficientFrontier` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceEfficientFrontier", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceEmpiricalKelly": { "post": { "operationId": "FinanceEmpiricalKelly", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceEmpiricalKelly" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceEmpiricalKelly" } } }, "description": "`FinanceEmpiricalKelly` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceEmpiricalKelly", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceEwma": { "post": { "operationId": "FinanceEwma", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceEwma" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceEwma" } } }, "description": "`FinanceEwma` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceEwma", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceExpectedPnlRate": { "post": { "operationId": "FinanceExpectedPnlRate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceExpectedPnlRate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceExpectedPnlRate" } } }, "description": "`FinanceExpectedPnlRate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceExpectedPnlRate", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceForensicReport": { "post": { "operationId": "FinanceForensicReport", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceForensicReport" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceForensicReport" } } }, "description": "`FinanceForensicReport` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceForensicReport", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceGlostenMilgromSpread": { "post": { "operationId": "FinanceGlostenMilgromSpread", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceGlostenMilgromSpread" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceGlostenMilgromSpread" } } }, "description": "`FinanceGlostenMilgromSpread` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceGlostenMilgromSpread", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceGltQuotes": { "post": { "operationId": "FinanceGltQuotes", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceGltQuotes" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceGltQuotes" } } }, "description": "`FinanceGltQuotes` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceGltQuotes", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceHardimanBouchaud": { "post": { "operationId": "FinanceHardimanBouchaud", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceHardimanBouchaud" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceHardimanBouchaud" } } }, "description": "`FinanceHardimanBouchaud` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceHardimanBouchaud", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceHawkesMle": { "post": { "operationId": "FinanceHawkesMle", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceHawkesMle" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceHawkesMle" } } }, "description": "`FinanceHawkesMle` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceHawkesMle", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceInformationCoefficient": { "post": { "operationId": "FinanceInformationCoefficient", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceInformationCoefficient" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceInformationCoefficient" } } }, "description": "`FinanceInformationCoefficient` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceInformationCoefficient", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceInformationRatio": { "post": { "operationId": "FinanceInformationRatio", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceInformationRatio" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceInformationRatio" } } }, "description": "`FinanceInformationRatio` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceInformationRatio", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceKalmanBeta": { "post": { "operationId": "FinanceKalmanBeta", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceKalmanBeta" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceKalmanBeta" } } }, "description": "`FinanceKalmanBeta` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceKalmanBeta", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceKalmanFilter1d": { "post": { "operationId": "FinanceKalmanFilter1d", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceKalmanFilter1d" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceKalmanFilter1d" } } }, "description": "`FinanceKalmanFilter1d` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceKalmanFilter1d", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceKalmanVolatility": { "post": { "operationId": "FinanceKalmanVolatility", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceKalmanVolatility" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceKalmanVolatility" } } }, "description": "`FinanceKalmanVolatility` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceKalmanVolatility", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceKellyFraction": { "post": { "operationId": "FinanceKellyFraction", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceKellyFraction" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceKellyFraction" } } }, "description": "`FinanceKellyFraction` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceKellyFraction", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceKyleLambda": { "post": { "operationId": "FinanceKyleLambda", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceKyleLambda" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceKyleLambda" } } }, "description": "`FinanceKyleLambda` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceKyleLambda", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceLogitQuotes": { "post": { "operationId": "FinanceLogitQuotes", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceLogitQuotes" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceLogitQuotes" } } }, "description": "`FinanceLogitQuotes` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceLogitQuotes", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceMarketImpact": { "post": { "operationId": "FinanceMarketImpact", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceMarketImpact" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceMarketImpact" } } }, "description": "`FinanceMarketImpact` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceMarketImpact", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceMarkovTransitionMatrix": { "post": { "operationId": "FinanceMarkovTransitionMatrix", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceMarkovTransitionMatrix" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceMarkovTransitionMatrix" } } }, "description": "`FinanceMarkovTransitionMatrix` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceMarkovTransitionMatrix", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceMatchOrders": { "post": { "operationId": "FinanceMatchOrders", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceMatchOrders" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceMatchOrders" } } }, "description": "`FinanceMatchOrders` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceMatchOrders", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceMaxDrawdown": { "post": { "operationId": "FinanceMaxDrawdown", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceMaxDrawdown" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceMaxDrawdown" } } }, "description": "`FinanceMaxDrawdown` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceMaxDrawdown", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceMeanReversion": { "post": { "operationId": "FinanceMeanReversion", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceMeanReversion" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceMeanReversion" } } }, "description": "`FinanceMeanReversion` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceMeanReversion", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceMicropriceSeries": { "post": { "operationId": "FinanceMicropriceSeries", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceMicropriceSeries" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceMicropriceSeries" } } }, "description": "`FinanceMicropriceSeries` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceMicropriceSeries", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceMomentum": { "post": { "operationId": "FinanceMomentum", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceMomentum" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceMomentum" } } }, "description": "`FinanceMomentum` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceMomentum", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceMonteCarloVar": { "post": { "operationId": "FinanceMonteCarloVar", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceMonteCarloVar" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceMonteCarloVar" } } }, "description": "`FinanceMonteCarloVar` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceMonteCarloVar", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceOfiSeries": { "post": { "operationId": "FinanceOfiSeries", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceOfiSeries" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceOfiSeries" } } }, "description": "`FinanceOfiSeries` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceOfiSeries", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceOptimizePortfolio": { "post": { "operationId": "FinanceOptimizePortfolio", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceOptimizePortfolio" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceOptimizePortfolio" } } }, "description": "`FinanceOptimizePortfolio` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceOptimizePortfolio", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceOrderBookImbalance": { "post": { "operationId": "FinanceOrderBookImbalance", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceOrderBookImbalance" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceOrderBookImbalance" } } }, "description": "`FinanceOrderBookImbalance` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceOrderBookImbalance", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceOuCalibrate": { "post": { "operationId": "FinanceOuCalibrate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceOuCalibrate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceOuCalibrate" } } }, "description": "`FinanceOuCalibrate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceOuCalibrate", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceOuOptimalThresholds": { "post": { "operationId": "FinanceOuOptimalThresholds", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceOuOptimalThresholds" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceOuOptimalThresholds" } } }, "description": "`FinanceOuOptimalThresholds` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceOuOptimalThresholds", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinancePairsTrading": { "post": { "operationId": "FinancePairsTrading", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinancePairsTrading" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinancePairsTrading" } } }, "description": "`FinancePairsTrading` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinancePairsTrading", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinancePosteriorCredibleInterval": { "post": { "operationId": "FinancePosteriorCredibleInterval", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinancePosteriorCredibleInterval" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinancePosteriorCredibleInterval" } } }, "description": "`FinancePosteriorCredibleInterval` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinancePosteriorCredibleInterval", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceProbabilityBacktestOverfit": { "post": { "operationId": "FinanceProbabilityBacktestOverfit", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceProbabilityBacktestOverfit" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceProbabilityBacktestOverfit" } } }, "description": "`FinanceProbabilityBacktestOverfit` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceProbabilityBacktestOverfit", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinancePurgedCpcv": { "post": { "operationId": "FinancePurgedCpcv", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinancePurgedCpcv" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinancePurgedCpcv" } } }, "description": "`FinancePurgedCpcv` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinancePurgedCpcv", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceQueueImbalance": { "post": { "operationId": "FinanceQueueImbalance", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceQueueImbalance" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceQueueImbalance" } } }, "description": "`FinanceQueueImbalance` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceQueueImbalance", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceRealizedVolTick": { "post": { "operationId": "FinanceRealizedVolTick", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceRealizedVolTick" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceRealizedVolTick" } } }, "description": "`FinanceRealizedVolTick` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceRealizedVolTick", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceRiskMetrics": { "post": { "operationId": "FinanceRiskMetrics", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceRiskMetrics" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceRiskMetrics" } } }, "description": "`FinanceRiskMetrics` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceRiskMetrics", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceRiskParity": { "post": { "operationId": "FinanceRiskParity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceRiskParity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceRiskParity" } } }, "description": "`FinanceRiskParity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceRiskParity", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceRollingZscore": { "post": { "operationId": "FinanceRollingZscore", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceRollingZscore" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceRollingZscore" } } }, "description": "`FinanceRollingZscore` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceRollingZscore", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceSabrCalibrate": { "post": { "operationId": "FinanceSabrCalibrate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceSabrCalibrate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceSabrCalibrate" } } }, "description": "`FinanceSabrCalibrate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceSabrCalibrate", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceSabrImpliedVol": { "post": { "operationId": "FinanceSabrImpliedVol", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceSabrImpliedVol" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceSabrImpliedVol" } } }, "description": "`FinanceSabrImpliedVol` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceSabrImpliedVol", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceSabrSmile": { "post": { "operationId": "FinanceSabrSmile", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceSabrSmile" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceSabrSmile" } } }, "description": "`FinanceSabrSmile` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceSabrSmile", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceSignalDecay": { "post": { "operationId": "FinanceSignalDecay", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceSignalDecay" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceSignalDecay" } } }, "description": "`FinanceSignalDecay` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceSignalDecay", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceSpreadReversion": { "post": { "operationId": "FinanceSpreadReversion", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceSpreadReversion" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceSpreadReversion" } } }, "description": "`FinanceSpreadReversion` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceSpreadReversion", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceStressTest": { "post": { "operationId": "FinanceStressTest", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceStressTest" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceStressTest" } } }, "description": "`FinanceStressTest` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceStressTest", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceSurveillanceRisk": { "post": { "operationId": "FinanceSurveillanceRisk", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceSurveillanceRisk" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceSurveillanceRisk" } } }, "description": "`FinanceSurveillanceRisk` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceSurveillanceRisk", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceTwap": { "post": { "operationId": "FinanceTwap", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceTwap" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceTwap" } } }, "description": "`FinanceTwap` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceTwap", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceVar": { "post": { "operationId": "FinanceVar", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceVar" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceVar" } } }, "description": "`FinanceVar` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceVar", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceVpinPm": { "post": { "operationId": "FinanceVpinPm", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceVpinPm" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceVpinPm" } } }, "description": "`FinanceVpinPm` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceVpinPm", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FinanceVwap": { "post": { "operationId": "FinanceVwap", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinanceVwap" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FinanceVwap" } } }, "description": "`FinanceVwap` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FinanceVwap", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:finance", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/FindCycle": { "post": { "operationId": "FindCycle", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FindCycle" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_FindCycle" } } }, "description": "`FindCycle` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FindCycle", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/GetBlastRadius": { "post": { "operationId": "GetBlastRadius", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetBlastRadius" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_GetBlastRadius" } } }, "description": "`GetBlastRadius` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetBlastRadius", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/GetShortestPath": { "post": { "operationId": "GetShortestPath", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetShortestPath" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_GetShortestPath" } } }, "description": "`GetShortestPath` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetShortestPath", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/GraphColoring": { "post": { "operationId": "GraphColoring", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GraphColoring" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_GraphColoring" } } }, "description": "`GraphColoring` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GraphColoring", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/GraphLearnFit": { "post": { "operationId": "GraphLearnFit", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GraphLearnFit" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_GraphLearnFit" } } }, "description": "`GraphLearnFit` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "graphlearn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/GraphLearnPredict": { "post": { "operationId": "GraphLearnPredict", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GraphLearnPredict" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_GraphLearnPredict" } } }, "description": "`GraphLearnPredict` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "graphlearn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MatchOntologyTerms": { "post": { "operationId": "MatchOntologyTerms", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MatchOntologyTerms" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MatchOntologyTerms" } } }, "description": "`MatchOntologyTerms` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "MatchOntologyTerms", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:semantic", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/MineAnomaly": { "post": { "operationId": "MineAnomaly", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineAnomaly" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineAnomaly" } } }, "description": "`MineAnomaly` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineAssociate": { "post": { "operationId": "MineAssociate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineAssociate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineAssociate" } } }, "description": "`MineAssociate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineCausalImpact": { "post": { "operationId": "MineCausalImpact", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineCausalImpact" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineCausalImpact" } } }, "description": "`MineCausalImpact` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineClassifyFit": { "post": { "operationId": "MineClassifyFit", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineClassifyFit" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineClassifyFit" } } }, "description": "`MineClassifyFit` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "the one Mine* family member that is unconditionally read-only (produces a model blob, never writes back)", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "mining:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/MineClassifyPredict": { "post": { "operationId": "MineClassifyPredict", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineClassifyPredict" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineClassifyPredict" } } }, "description": "`MineClassifyPredict` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineCluster": { "post": { "operationId": "MineCluster", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineCluster" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineCluster" } } }, "description": "`MineCluster` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineCommunity": { "post": { "operationId": "MineCommunity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineCommunity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineCommunity" } } }, "description": "`MineCommunity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineEntityResolve": { "post": { "operationId": "MineEntityResolve", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineEntityResolve" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineEntityResolve" } } }, "description": "`MineEntityResolve` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineForecast": { "post": { "operationId": "MineForecast", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineForecast" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineForecast" } } }, "description": "`MineForecast` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound; writeback=true enters the canonical durable mutation path", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineOntologyGap": { "post": { "operationId": "MineOntologyGap", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineOntologyGap" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineOntologyGap" } } }, "description": "`MineOntologyGap` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineProcess": { "post": { "operationId": "MineProcess", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineProcess" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineProcess" } } }, "description": "`MineProcess` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineReduce": { "post": { "operationId": "MineReduce", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineReduce" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineReduce" } } }, "description": "`MineReduce` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineRetrievalQuality": { "post": { "operationId": "MineRetrievalQuality", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineRetrievalQuality" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineRetrievalQuality" } } }, "description": "`MineRetrievalQuality` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineRiskPropagation": { "post": { "operationId": "MineRiskPropagation", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineRiskPropagation" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineRiskPropagation" } } }, "description": "`MineRiskPropagation` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineRootCause": { "post": { "operationId": "MineRootCause", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineRootCause" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineRootCause" } } }, "description": "`MineRootCause` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineSequence": { "post": { "operationId": "MineSequence", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineSequence" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineSequence" } } }, "description": "`MineSequence` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound; writeback=true enters the canonical durable mutation path", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineSubgraph": { "post": { "operationId": "MineSubgraph", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineSubgraph" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineSubgraph" } } }, "description": "`MineSubgraph` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound; writeback=true for gspan enters the canonical durable mutation path", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MineText": { "post": { "operationId": "MineText", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MineText" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MineText" } } }, "description": "`MineText` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound; writeback=true for lda/nmf enters the canonical durable mutation path", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MinimumSpanningTree": { "post": { "operationId": "MinimumSpanningTree", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MinimumSpanningTree" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MinimumSpanningTree" } } }, "description": "`MinimumSpanningTree` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "MinimumSpanningTree", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/MiningPipelineCompare": { "post": { "operationId": "MiningPipelineCompare", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MiningPipelineCompare" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MiningPipelineCompare" } } }, "description": "`MiningPipelineCompare` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "read-only: diffs two model versions' held-out metrics", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "mining:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/MiningPipelineEvaluate": { "post": { "operationId": "MiningPipelineEvaluate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MiningPipelineEvaluate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MiningPipelineEvaluate" } } }, "description": "`MiningPipelineEvaluate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "read-only: scores a stored versioned model against a labeled set", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "mining:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/MiningPipelinePredict": { "post": { "operationId": "MiningPipelinePredict", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MiningPipelinePredict" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MiningPipelinePredict" } } }, "description": "`MiningPipelinePredict` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field (materializes :Prediction nodes)", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MiningPipelineServe": { "post": { "operationId": "MiningPipelineServe", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MiningPipelineServe" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MiningPipelineServe" } } }, "description": "`MiningPipelineServe` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "always writes the :ServedModel pointer to deploy a version", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/MiningPipelineTrain": { "post": { "operationId": "MiningPipelineTrain", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MiningPipelineTrain" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_MiningPipelineTrain" } } }, "description": "`MiningPipelineTrain` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "mutates is a conservative upper bound: the REAL access::requires_write(m) returns the runtime `writeback` field (persists a versioned :Model artifact)", "tags": [ "compute" ], "x-audited": true, "x-authz-action": "mining:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/compute/PageRank": { "post": { "operationId": "PageRank", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PageRank" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_PageRank" } } }, "description": "`PageRank` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "PageRank", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/PersonalizedPageRank": { "post": { "operationId": "PersonalizedPageRank", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PersonalizedPageRank" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_PersonalizedPageRank" } } }, "description": "`PersonalizedPageRank` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "PersonalizedPageRank", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/ResolveCandidates": { "post": { "operationId": "ResolveCandidates", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ResolveCandidates" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_ResolveCandidates" } } }, "description": "`ResolveCandidates` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ResolveCandidates", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/RunUdf": { "post": { "operationId": "RunUdf", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RunUdf" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_RunUdf" } } }, "description": "`RunUdf` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "executes a registered sandboxed function; treated as read/compute unless the UDF itself writes back (not modeled -- the wire protocol has no writeback flag here)", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "udf:exec", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": false, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/compute/Solve": { "post": { "operationId": "Solve", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Solve" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_Solve" } } }, "description": "`Solve` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "pure compute: a bounded 0-1 integer programme with an independently verifiable certificate. Reads no store, no clock and no float, so it participates in no transaction", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:solve", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/compute/StronglyConnectedComponents": { "post": { "operationId": "StronglyConnectedComponents", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StronglyConnectedComponents" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_StronglyConnectedComponents" } } }, "description": "`StronglyConnectedComponents` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "StronglyConnectedComponents", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/TopologicalSort": { "post": { "operationId": "TopologicalSort", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TopologicalSort" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_TopologicalSort" } } }, "description": "`TopologicalSort` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "TopologicalSort", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/compute/Vf2SubgraphMatch": { "post": { "operationId": "Vf2SubgraphMatch", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Vf2SubgraphMatch" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_compute_Vf2SubgraphMatch" } } }, "description": "`Vf2SubgraphMatch` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Vf2SubgraphMatch", "tags": [ "compute" ], "x-audited": false, "x-authz-action": "compute:graph-algo", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/AcquireCapacity": { "post": { "operationId": "AcquireCapacity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AcquireCapacity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_AcquireCapacity" } } }, "description": "`AcquireCapacity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "atomic multi-dimensional capacity admission with epoch/fence ownership", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "capacity:lease", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/AnalyticsJob": { "post": { "operationId": "AnalyticsJob", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AnalyticsJob" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_AnalyticsJob" } } }, "description": "`AnalyticsJob` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "runtime-conditional: Status is a read; Submit/Cancel/Resume commit through the native jobs.redb MutationBatch gateway", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "jobs:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "JobsRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/CancelWorkItem": { "post": { "operationId": "CancelWorkItem", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CancelWorkItem" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_CancelWorkItem" } } }, "description": "`CancelWorkItem` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "pending cancellation never steals an active lease", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/CapacityStatus": { "post": { "operationId": "CapacityStatus", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CapacityStatus" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_CapacityStatus" } } }, "description": "`CapacityStatus` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "exact tenant-scoped native capacity status", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "capacity:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/CasWorkItemMetadata": { "post": { "operationId": "CasWorkItemMetadata", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CasWorkItemMetadata" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_CasWorkItemMetadata" } } }, "description": "`CasWorkItemMetadata` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BUG-111: atomic single-field CAS on non-authority scheduling metadata (checkpoint_id/metadata/prio_bucket); status/lease/tenant are fenced but never written", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ClaimNext": { "post": { "operationId": "ClaimNext", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ClaimNext" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ClaimNext" } } }, "description": "`ClaimNext` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ClaimNext", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "node:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ClaimWorkItem": { "post": { "operationId": "ClaimWorkItem", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ClaimWorkItem" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ClaimWorkItem" } } }, "description": "`ClaimWorkItem` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "engine-native tenant/fair WorkItem lease claim", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:claim", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/CleanupDevelopmentLane": { "post": { "operationId": "CleanupDevelopmentLane", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CleanupDevelopmentLane" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_CleanupDevelopmentLane" } } }, "description": "`CleanupDevelopmentLane` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "distinct cleanup WorkItem fence releases retained disk and exclusivity; now_ms is authority-normalized", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "lane:cleanup", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/CommitWorkItemResult": { "post": { "operationId": "CommitWorkItemResult", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CommitWorkItemResult" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_CommitWorkItemResult" } } }, "description": "`CommitWorkItemResult` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "terminal result references and outbox commit atomically", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/DecisionEval": { "post": { "operationId": "DecisionEval", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DecisionEval" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_DecisionEval" } } }, "description": "`DecisionEval` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-010 DL-6, runtime-conditional: status is an authenticated tenant-bound read; submit evaluates a draft or published head on admitted labels and commits the job row and its receipt in one agent_library.redb control-owner transaction; a DecisionHead publish requires a passed receipt. Local-only authority, refused in clustered mode", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "admin:decision-eval", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/DecisionFit": { "post": { "operationId": "DecisionFit", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DecisionFit" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_DecisionFit" } } }, "description": "`DecisionFit` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-010 DL-6, runtime-conditional: status is an authenticated tenant-bound read; submit runs one bounded deterministic fit to its terminal state and commits the job row and the draft head body in one agent_library.redb control-owner transaction. Local-only authority, refused in clustered mode", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "admin:decision-fit", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/DeferWorkItem": { "post": { "operationId": "DeferWorkItem", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DeferWorkItem" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_DeferWorkItem" } } }, "description": "`DeferWorkItem` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "fenced lease release schedules retry without consuming an attempt", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/DevelopmentLaneStatus": { "post": { "operationId": "DevelopmentLaneStatus", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DevelopmentLaneStatus" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_DevelopmentLaneStatus" } } }, "description": "`DevelopmentLaneStatus` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded tenant-scoped status with maintained counters", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "lane:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/FinishDevelopmentLane": { "post": { "operationId": "FinishDevelopmentLane", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FinishDevelopmentLane" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_FinishDevelopmentLane" } } }, "description": "`FinishDevelopmentLane` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "terminal lifecycle releases active count but retains cleanup charges and identity; now_ms is authority-normalized", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "lane:reserve", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/GetControlLease": { "post": { "operationId": "GetControlLease", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetControlLease" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_GetControlLease" } } }, "description": "`GetControlLease` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "tenant-bound native control-lease view", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "lease:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/GetWorkItem": { "post": { "operationId": "GetWorkItem", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetWorkItem" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_GetWorkItem" } } }, "description": "`GetWorkItem` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "tenant-bound native WorkItem row view; lease owner/epoch/fencing token never projected", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "work:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/GetWorkItemOutcome": { "post": { "operationId": "GetWorkItemOutcome", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetWorkItemOutcome" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_GetWorkItemOutcome" } } }, "description": "`GetWorkItemOutcome` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "tenant-bound terminal WorkItem plus the provenance its native commit bound; the OutcomeEvaluation receipt is digest-verified", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "work:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/IssueControlLease": { "post": { "operationId": "IssueControlLease", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_IssueControlLease" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_IssueControlLease" } } }, "description": "`IssueControlLease` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "tenant-bound immutable grant record in the WorkItem MutationBatch; an existing id is a collision, never an overwrite", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "lease:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/KgDelegate": { "post": { "operationId": "KgDelegate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_KgDelegate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_KgDelegate" } } }, "description": "`KgDelegate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "authenticated Agent Library pinned delegation lowered to native WorkItem admission", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:delegate", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ListWorkItems": { "post": { "operationId": "ListWorkItems", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ListWorkItems" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ListWorkItems" } } }, "description": "`ListWorkItems` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded tenant-bound WorkItem page; limit/scan/byte bounds each resume through an opaque tenant-bound cursor", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "work:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/MintWorkItemClaimCapability": { "post": { "operationId": "MintWorkItemClaimCapability", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MintWorkItemClaimCapability" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_MintWorkItemClaimCapability" } } }, "description": "`MintWorkItemClaimCapability` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque native capability is retained in a private ledger and never projected", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "work:claim-capability", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ObserveDevelopmentLane": { "post": { "operationId": "ObserveDevelopmentLane", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ObserveDevelopmentLane" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ObserveDevelopmentLane" } } }, "description": "`ObserveDevelopmentLane` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "monotonic retained-footprint observation replaces the prior native charge; now_ms is authority-normalized", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "lane:reserve", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/QueryDevelopmentLane": { "post": { "operationId": "QueryDevelopmentLane", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_QueryDevelopmentLane" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_QueryDevelopmentLane" } } }, "description": "`QueryDevelopmentLane` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "linearizable exact lane hold/tombstone read", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "lane:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/QueryWorkItemReservation": { "post": { "operationId": "QueryWorkItemReservation", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_QueryWorkItemReservation" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_QueryWorkItemReservation" } } }, "description": "`QueryWorkItemReservation` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "linearizable exact native authority read", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "resource:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/ReclaimExpiredCapacity": { "post": { "operationId": "ReclaimExpiredCapacity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ReclaimExpiredCapacity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ReclaimExpiredCapacity" } } }, "description": "`ReclaimExpiredCapacity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded expiry reclaim with native aggregate accounting", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "capacity:lease", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ReclaimWorkItemResources": { "post": { "operationId": "ReclaimWorkItemResources", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ReclaimWorkItemResources" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ReclaimWorkItemResources" } } }, "description": "`ReclaimWorkItemResources` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "controller-only expiry/supersession reclaim with retained tombstone", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "resource:reserve", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ReconcileCapacity": { "post": { "operationId": "ReconcileCapacity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ReconcileCapacity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ReconcileCapacity" } } }, "description": "`ReconcileCapacity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded native cells/leases reconciliation page", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "capacity:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/ReleaseCapacity": { "post": { "operationId": "ReleaseCapacity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ReleaseCapacity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ReleaseCapacity" } } }, "description": "`ReleaseCapacity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded all-or-nothing lease release", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "capacity:lease", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ReleaseWorkItemResources": { "post": { "operationId": "ReleaseWorkItemResources", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ReleaseWorkItemResources" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ReleaseWorkItemResources" } } }, "description": "`ReleaseWorkItemResources` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "controller-only lifecycle release with retained tombstone", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "resource:reserve", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/RenewCapacity": { "post": { "operationId": "RenewCapacity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RenewCapacity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_RenewCapacity" } } }, "description": "`RenewCapacity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded all-or-nothing lease renewal", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "capacity:lease", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/RenewDevelopmentLane": { "post": { "operationId": "RenewDevelopmentLane", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RenewDevelopmentLane" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_RenewDevelopmentLane" } } }, "description": "`RenewDevelopmentLane` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "in-place O(1) hold renewal bound to the current WorkItem lease; now_ms is authority-normalized", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "lane:reserve", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/RenewWorkItemLease": { "post": { "operationId": "RenewWorkItemLease", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RenewWorkItemLease" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_RenewWorkItemLease" } } }, "description": "`RenewWorkItemLease` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "lease epoch and fencing token are validated atomically", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ReserveDevelopmentLane": { "post": { "operationId": "ReserveDevelopmentLane", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ReserveDevelopmentLane" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ReserveDevelopmentLane" } } }, "description": "`ReserveDevelopmentLane` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "controller-only atomic branch/worktree uniqueness and multi-scope quota hold; now_ms is authority-normalized", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "lane:reserve", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ReserveWorkItemResources": { "post": { "operationId": "ReserveWorkItemResources", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ReserveWorkItemResources" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ReserveWorkItemResources" } } }, "description": "`ReserveWorkItemResources` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "controller-only atomic host admission and WorkItem fence validation", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "resource:reserve", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/ResourceReservationStatus": { "post": { "operationId": "ResourceReservationStatus", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ResourceReservationStatus" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ResourceReservationStatus" } } }, "description": "`ResourceReservationStatus` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded linearizable reconciliation read", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "resource:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/coordination/ResourceStatsPage": { "post": { "operationId": "ResourceStatsPage", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ResourceStatsPage" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_ResourceStatsPage" } } }, "description": "`ResourceStatsPage` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded ACL-filtered keyset page; summary suppresses detail arrays", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "service:control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/coordination/Statechart": { "post": { "operationId": "Statechart", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Statechart" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_Statechart" } } }, "description": "`Statechart` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "runtime-conditional: GetState/List are reads; Define/Instantiate/SendEvent commit to the native statecharts.redb store (CONCEPT:INT-P2-2)", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "statechart:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "StatechartRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/SubmitWorkItem": { "post": { "operationId": "SubmitWorkItem", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SubmitWorkItem" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_SubmitWorkItem" } } }, "description": "`SubmitWorkItem` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "native tenant-scoped WorkItem command-log admission and outbox commit", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:submit", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/SubmitWorkItems": { "post": { "operationId": "SubmitWorkItems", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SubmitWorkItems" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_SubmitWorkItems" } } }, "description": "`SubmitWorkItems` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bounded all-or-nothing WorkItem admission batch", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "work:submit", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/TransitionControlLease": { "post": { "operationId": "TransitionControlLease", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TransitionControlLease" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_TransitionControlLease" } } }, "description": "`TransitionControlLease` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "one-way active to revoked/expired, CAS on the read revision", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "lease:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/UpdateCapacityCell": { "post": { "operationId": "UpdateCapacityCell", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UpdateCapacityCell" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_UpdateCapacityCell" } } }, "description": "`UpdateCapacityCell` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "controller epoch CAS for resource dimension/capacity policy", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "capacity:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/UpdateDevelopmentLaneQuota": { "post": { "operationId": "UpdateDevelopmentLaneQuota", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UpdateDevelopmentLaneQuota" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_UpdateDevelopmentLaneQuota" } } }, "description": "`UpdateDevelopmentLaneQuota` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "controller/admin-only monotonic server-owned quota policy with numeric expected_policy_revision CAS; now_ms is authority-normalized", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "lane:quota", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/UpdateResourceHost": { "post": { "operationId": "UpdateResourceHost", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UpdateResourceHost" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_UpdateResourceHost" } } }, "description": "`UpdateResourceHost` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "controller-only monotonic host telemetry update", "tags": [ "coordination" ], "x-audited": true, "x-authz-action": "resource:host", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/coordination/VerifyWorkItemClaimCapability": { "post": { "operationId": "VerifyWorkItemClaimCapability", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_VerifyWorkItemClaimCapability" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_coordination_VerifyWorkItemClaimCapability" } } }, "description": "`VerifyWorkItemClaimCapability` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "linearizable live-lease check precedes private capability lookup", "tags": [ "coordination" ], "x-audited": false, "x-authz-action": "work:claim-capability", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/AddEdge": { "post": { "operationId": "AddEdge", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AddEdge" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_AddEdge" } } }, "description": "`AddEdge` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "AddEdge", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "edge:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/AddNode": { "post": { "operationId": "AddNode", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AddNode" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_AddNode" } } }, "description": "`AddNode` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "AddNode", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "node:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/AddSceneObject": { "post": { "operationId": "AddSceneObject", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AddSceneObject" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_AddSceneObject" } } }, "description": "`AddSceneObject` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "AddSceneObject", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "scene:write", "x-consumer-profiles": [], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Atomic" } }, "/rpc/graph/AddTriples": { "post": { "operationId": "AddTriples", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AddTriples" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_AddTriples" } } }, "description": "`AddTriples` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "AddTriples", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "rdf:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/AppendStep": { "post": { "operationId": "AppendStep", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AppendStep" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_AppendStep" } } }, "description": "`AppendStep` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "AppendStep", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/ApplyMutation": { "post": { "operationId": "ApplyMutation", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ApplyMutation" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_ApplyMutation" } } }, "description": "`ApplyMutation` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "graph:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/BestTrajectory": { "post": { "operationId": "BestTrajectory", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BestTrajectory" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_BestTrajectory" } } }, "description": "`BestTrajectory` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BestTrajectory", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "memory:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/ClearGraph": { "post": { "operationId": "ClearGraph", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ClearGraph" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_ClearGraph" } } }, "description": "`ClearGraph` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ClearGraph", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "graph:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/CompactNodesByType": { "post": { "operationId": "CompactNodesByType", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CompactNodesByType" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_CompactNodesByType" } } }, "description": "`CompactNodesByType` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "node:admin", "x-consumer-profiles": [], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Atomic" } }, "/rpc/graph/CompareAndSetNodeFields": { "post": { "operationId": "CompareAndSetNodeFields", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CompareAndSetNodeFields" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_CompareAndSetNodeFields" } } }, "description": "`CompareAndSetNodeFields` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CompareAndSetNodeFields", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "node:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/Consolidate": { "post": { "operationId": "Consolidate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Consolidate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_Consolidate" } } }, "description": "`Consolidate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Consolidate", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/CreateNodeIfAbsent": { "post": { "operationId": "CreateNodeIfAbsent", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CreateNodeIfAbsent" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_CreateNodeIfAbsent" } } }, "description": "`CreateNodeIfAbsent` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "atomic create returns true only to the inserting writer, so its result is not cross-request cacheable", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "node:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/CreateSummaryNode": { "post": { "operationId": "CreateSummaryNode", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CreateSummaryNode" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_CreateSummaryNode" } } }, "description": "`CreateSummaryNode` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CreateSummaryNode", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/DecayMemories": { "post": { "operationId": "DecayMemories", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DecayMemories" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_DecayMemories" } } }, "description": "`DecayMemories` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DecayMemories", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/DecayNode": { "post": { "operationId": "DecayNode", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DecayNode" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_DecayNode" } } }, "description": "`DecayNode` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DecayNode", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/DecaySweep": { "post": { "operationId": "DecaySweep", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DecaySweep" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_DecaySweep" } } }, "description": "`DecaySweep` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch commits the resulting authoritative image", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/DiffAgainst": { "post": { "operationId": "DiffAgainst", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DiffAgainst" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_DiffAgainst" } } }, "description": "`DiffAgainst` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DiffAgainst", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "graph:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/DiscountedReturn": { "post": { "operationId": "DiscountedReturn", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DiscountedReturn" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_DiscountedReturn" } } }, "description": "`DiscountedReturn` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DiscountedReturn", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "memory:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/DropNamedGraph": { "post": { "operationId": "DropNamedGraph", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DropNamedGraph" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_DropNamedGraph" } } }, "description": "`DropNamedGraph` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DropNamedGraph", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "rdf:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/EdgeCount": { "post": { "operationId": "EdgeCount", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_EdgeCount" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_EdgeCount" } } }, "description": "`EdgeCount` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "EdgeCount", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/EvictBelow": { "post": { "operationId": "EvictBelow", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_EvictBelow" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_EvictBelow" } } }, "description": "`EvictBelow` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "EvictBelow", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/EvictLRU": { "post": { "operationId": "EvictLRU", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_EvictLRU" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_EvictLRU" } } }, "description": "`EvictLRU` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch commits the resulting authoritative image", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/Fork": { "post": { "operationId": "Fork", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Fork" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_Fork" } } }, "description": "`Fork` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "returns the forked snapshot to the caller; never registers/persists it server-side", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "graph:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetEdgeProperties": { "post": { "operationId": "GetEdgeProperties", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetEdgeProperties" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetEdgeProperties" } } }, "description": "`GetEdgeProperties` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetEdgeProperties", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetEdgePropertiesBatch": { "post": { "operationId": "GetEdgePropertiesBatch", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetEdgePropertiesBatch" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetEdgePropertiesBatch" } } }, "description": "`GetEdgePropertiesBatch` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetEdgePropertiesBatch", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetEdges": { "post": { "operationId": "GetEdges", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetEdges" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetEdges" } } }, "description": "`GetEdges` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetEdges", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetEdgesPage": { "post": { "operationId": "GetEdgesPage", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetEdgesPage" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetEdgesPage" } } }, "description": "`GetEdgesPage` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetEdgesPage", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetNeighbors": { "post": { "operationId": "GetNeighbors", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetNeighbors" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetNeighbors" } } }, "description": "`GetNeighbors` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetNeighbors", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetNeighborsBatch": { "post": { "operationId": "GetNeighborsBatch", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetNeighborsBatch" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetNeighborsBatch" } } }, "description": "`GetNeighborsBatch` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetNeighborsBatch", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetNodeProperties": { "post": { "operationId": "GetNodeProperties", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetNodeProperties" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetNodeProperties" } } }, "description": "`GetNodeProperties` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetNodeProperties", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetNodePropertiesBatch": { "post": { "operationId": "GetNodePropertiesBatch", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetNodePropertiesBatch" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetNodePropertiesBatch" } } }, "description": "`GetNodePropertiesBatch` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetNodePropertiesBatch", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetNodes": { "post": { "operationId": "GetNodes", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetNodes" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetNodes" } } }, "description": "`GetNodes` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetNodes", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetNodesByLabel": { "post": { "operationId": "GetNodesByLabel", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetNodesByLabel" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetNodesByLabel" } } }, "description": "`GetNodesByLabel` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetNodesByLabel", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetPredecessors": { "post": { "operationId": "GetPredecessors", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetPredecessors" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetPredecessors" } } }, "description": "`GetPredecessors` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetPredecessors", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetSubgraph": { "post": { "operationId": "GetSubgraph", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetSubgraph" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetSubgraph" } } }, "description": "`GetSubgraph` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetSubgraph", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/GetSuccessors": { "post": { "operationId": "GetSuccessors", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetSuccessors" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_GetSuccessors" } } }, "description": "`GetSuccessors` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetSuccessors", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/HasEdge": { "post": { "operationId": "HasEdge", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_HasEdge" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_HasEdge" } } }, "description": "`HasEdge` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "HasEdge", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/HasNode": { "post": { "operationId": "HasNode", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_HasNode" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_HasNode" } } }, "description": "`HasNode` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "HasNode", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/HasNodesBatch": { "post": { "operationId": "HasNodesBatch", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_HasNodesBatch" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_HasNodesBatch" } } }, "description": "`HasNodesBatch` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "HasNodesBatch", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/InDegree": { "post": { "operationId": "InDegree", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_InDegree" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_InDegree" } } }, "description": "`InDegree` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "InDegree", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/InvalidateEdge": { "post": { "operationId": "InvalidateEdge", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_InvalidateEdge" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_InvalidateEdge" } } }, "description": "`InvalidateEdge` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "InvalidateEdge", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "edge:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/Maintain": { "post": { "operationId": "Maintain", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Maintain" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_Maintain" } } }, "description": "`Maintain` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Maintain", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/Metrics": { "post": { "operationId": "Metrics", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Metrics" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_Metrics" } } }, "description": "`Metrics` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Metrics", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "service:control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/graph/NodeCount": { "post": { "operationId": "NodeCount", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_NodeCount" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_NodeCount" } } }, "description": "`NodeCount` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "NodeCount", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/NodeIds": { "post": { "operationId": "NodeIds", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_NodeIds" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_NodeIds" } } }, "description": "`NodeIds` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "NodeIds", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/OutDegree": { "post": { "operationId": "OutDegree", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_OutDegree" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_OutDegree" } } }, "description": "`OutDegree` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "OutDegree", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "edge:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/PruneByLifecycle": { "post": { "operationId": "PruneByLifecycle", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PruneByLifecycle" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_PruneByLifecycle" } } }, "description": "`PruneByLifecycle` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch commits the resulting authoritative image", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/Reconcile": { "post": { "operationId": "Reconcile", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Reconcile" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_Reconcile" } } }, "description": "`Reconcile` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch commits the merged image", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "graph:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/graph/Reinforce": { "post": { "operationId": "Reinforce", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Reinforce" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_Reinforce" } } }, "description": "`Reinforce` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Reinforce", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/RemoveEdge": { "post": { "operationId": "RemoveEdge", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RemoveEdge" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_RemoveEdge" } } }, "description": "`RemoveEdge` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RemoveEdge", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "edge:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/RemoveNode": { "post": { "operationId": "RemoveNode", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RemoveNode" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_RemoveNode" } } }, "description": "`RemoveNode` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RemoveNode", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "node:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/RemoveTriples": { "post": { "operationId": "RemoveTriples", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RemoveTriples" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_RemoveTriples" } } }, "description": "`RemoveTriples` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RemoveTriples", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "rdf:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/Reparent": { "post": { "operationId": "Reparent", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Reparent" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_Reparent" } } }, "description": "`Reparent` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Reparent", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "scene:write", "x-consumer-profiles": [], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Atomic" } }, "/rpc/graph/SceneChildren": { "post": { "operationId": "SceneChildren", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SceneChildren" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_SceneChildren" } } }, "description": "`SceneChildren` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "SceneChildren", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "scene:read", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/graph/SetPose": { "post": { "operationId": "SetPose", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SetPose" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_SetPose" } } }, "description": "`SetPose` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "SetPose", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "scene:write", "x-consumer-profiles": [], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Atomic" } }, "/rpc/graph/StartTrajectory": { "post": { "operationId": "StartTrajectory", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StartTrajectory" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_StartTrajectory" } } }, "description": "`StartTrajectory` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "StartTrajectory", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "memory:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/SummariesAtLevel": { "post": { "operationId": "SummariesAtLevel", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SummariesAtLevel" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_SummariesAtLevel" } } }, "description": "`SummariesAtLevel` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "SummariesAtLevel", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "memory:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/SummaryChildren": { "post": { "operationId": "SummaryChildren", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SummaryChildren" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_SummaryChildren" } } }, "description": "`SummaryChildren` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "SummaryChildren", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "memory:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/SupersedeEdge": { "post": { "operationId": "SupersedeEdge", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SupersedeEdge" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_SupersedeEdge" } } }, "description": "`SupersedeEdge` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "SupersedeEdge", "tags": [ "graph" ], "x-audited": true, "x-authz-action": "edge:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/TouchNodes": { "post": { "operationId": "TouchNodes", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TouchNodes" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_TouchNodes" } } }, "description": "`TouchNodes` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch commits the resulting authoritative image", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/graph/UnionGetNeighbors": { "post": { "operationId": "UnionGetNeighbors", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UnionGetNeighbors" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_UnionGetNeighbors" } } }, "description": "`UnionGetNeighbors` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "UnionGetNeighbors", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/UnionGetNodeProperties": { "post": { "operationId": "UnionGetNodeProperties", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UnionGetNodeProperties" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_UnionGetNodeProperties" } } }, "description": "`UnionGetNodeProperties` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "UnionGetNodeProperties", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/UnionGetNodesByLabel": { "post": { "operationId": "UnionGetNodesByLabel", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UnionGetNodesByLabel" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_UnionGetNodesByLabel" } } }, "description": "`UnionGetNodesByLabel` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "UnionGetNodesByLabel", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/graph/WorldTransform": { "post": { "operationId": "WorldTransform", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_WorldTransform" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_graph_WorldTransform" } } }, "description": "`WorldTransform` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "WorldTransform", "tags": [ "graph" ], "x-audited": false, "x-authz-action": "scene:read", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/ingestion/AddEmbedding": { "post": { "operationId": "AddEmbedding", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AddEmbedding" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_AddEmbedding" } } }, "description": "`AddEmbedding` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "AddEmbedding", "tags": [ "ingestion" ], "x-audited": true, "x-authz-action": "node:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/ingestion/Asr": { "post": { "operationId": "Asr", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Asr" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_Asr" } } }, "description": "`Asr` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "self-routes before dispatch_graph_op like Quantum/Viz; direct non-durable whisper-rs transcription, commits no asr.result.v1 (that governed commit is future worker/AU-orchestration work, W03/W06)", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "asr:transcribe", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": false, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/ingestion/Discover": { "post": { "operationId": "Discover", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Discover" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_Discover" } } }, "description": "`Discover` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Discover", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "compute:semantic", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/ingestion/IndexRepository": { "post": { "operationId": "IndexRepository", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_IndexRepository" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_IndexRepository" } } }, "description": "`IndexRepository` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "IndexRepository", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "compute:parse", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/ingestion/ObserveScreen": { "post": { "operationId": "ObserveScreen", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ObserveScreen" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_ObserveScreen" } } }, "description": "`ObserveScreen` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ObserveScreen", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "compute:vision", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": false, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/ingestion/ParseFile": { "post": { "operationId": "ParseFile", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ParseFile" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_ParseFile" } } }, "description": "`ParseFile` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ParseFile", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "compute:parse", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/ingestion/ParseFiles": { "post": { "operationId": "ParseFiles", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ParseFiles" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_ParseFiles" } } }, "description": "`ParseFiles` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ParseFiles", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "compute:parse", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/ingestion/Quantum": { "post": { "operationId": "Quantum", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Quantum" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_Quantum" } } }, "description": "`Quantum` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "self-routes before dispatch_graph_op like AnalyticsJob/Statechart, never reaches the graph tamper-evident audit chain; R5 override audit instead rides the response's PlannerDecision.audit trail into the agent-utilities :ToolCall/:QuantumJob provenance", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "quantum:run", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/ingestion/SemanticIndex": { "post": { "operationId": "SemanticIndex", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SemanticIndex" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_SemanticIndex" } } }, "description": "`SemanticIndex` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-019's S1-S6 tiered ingestion queue. Runtime-conditional like the four agent layers, but over SIX authz actions rather than two: binding lifecycle is semantic:binding-write, S1 admission semantic:source-admit, subscribe/claim/release semantic:stage-claim, stage completion semantic:stage-complete, and the reads semantic:binding-read / semantic:stage-read. The row names the binding-write leg; SemanticIndexOp::authz_action is the authority for each operation", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "semantic:binding-write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "SemanticIndexRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/ingestion/SemanticSearch": { "post": { "operationId": "SemanticSearch", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SemanticSearch" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_SemanticSearch" } } }, "description": "`SemanticSearch` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "SemanticSearch", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "compute:semantic", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/ingestion/ServedModality": { "post": { "operationId": "ServedModality", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ServedModality" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_ServedModality" } } }, "description": "`ServedModality` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "runtime-conditional: authority/query/events/capabilities are verified read snapshots; ingest/delete/cold/restore commit an encrypted state-backed MutationBatch", "tags": [ "ingestion" ], "x-audited": true, "x-authz-action": "modality:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/ingestion/SourceIngest": { "post": { "operationId": "SourceIngest", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SourceIngest" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_SourceIngest" } } }, "description": "`SourceIngest` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-009 native ingestion authority: tenant-bound typed Connector Manifest mapping resolution and idempotent raw-CAS admission precede one atomic ChangeEnvelope commit for mapped graph material, provenance, cursor and receipt; unknown mapping, tenant or authority fails closed; exact MCP catalog generation and digest binding makes the generated consumer contract replay-safe", "tags": [ "ingestion" ], "x-audited": true, "x-authz-action": "source:ingest", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/ingestion/SourceIngestStatus": { "post": { "operationId": "SourceIngestStatus", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SourceIngestStatus" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_SourceIngestStatus" } } }, "description": "`SourceIngestStatus` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "read-only authoritative source-partition checkpoint and receipt identity for restart/failover CAS recovery; callers must not substitute local checkpoint authority", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "source:ingest", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/ingestion/Viz": { "post": { "operationId": "Viz", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Viz" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_ingestion_Viz" } } }, "description": "`Viz` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "pure compute: resolves a fresh per-request ColumnStore and returns rendered bytes, no durable write (D-VZ-1 lanes V4/V6)", "tags": [ "ingestion" ], "x-audited": false, "x-authz-action": "viz:render", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/messaging/BindQueue": { "post": { "operationId": "BindQueue", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BindQueue" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_BindQueue" } } }, "description": "`BindQueue` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BindQueue", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/BrokerAck": { "post": { "operationId": "BrokerAck", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BrokerAck" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_BrokerAck" } } }, "description": "`BrokerAck` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BrokerAck", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:ack", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/BrokerAckTag": { "post": { "operationId": "BrokerAckTag", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BrokerAckTag" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_BrokerAckTag" } } }, "description": "`BrokerAckTag` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "current-generation result must not be replay-cached across requests", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:ack", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/BrokerConsume": { "post": { "operationId": "BrokerConsume", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BrokerConsume" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_BrokerConsume" } } }, "description": "`BrokerConsume` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BrokerConsume", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:consume", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/BrokerNackTag": { "post": { "operationId": "BrokerNackTag", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BrokerNackTag" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_BrokerNackTag" } } }, "description": "`BrokerNackTag` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "current-generation result must not be replay-cached across requests", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:ack", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/BrokerReject": { "post": { "operationId": "BrokerReject", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BrokerReject" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_BrokerReject" } } }, "description": "`BrokerReject` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BrokerReject", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:ack", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/BrokerRenewTag": { "post": { "operationId": "BrokerRenewTag", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BrokerRenewTag" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_BrokerRenewTag" } } }, "description": "`BrokerRenewTag` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "current-generation result must not be replay-cached across requests", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:ack", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/CdcRead": { "post": { "operationId": "CdcRead", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CdcRead" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_CdcRead" } } }, "description": "`CdcRead` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CdcRead", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/CepPoll": { "post": { "operationId": "CepPoll", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CepPoll" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_CepPoll" } } }, "description": "`CepPoll` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CepPoll", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cep:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/CepSubscribe": { "post": { "operationId": "CepSubscribe", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CepSubscribe" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_CepSubscribe" } } }, "description": "`CepSubscribe` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cep:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/CepUnsubscribe": { "post": { "operationId": "CepUnsubscribe", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CepUnsubscribe" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_CepUnsubscribe" } } }, "description": "`CepUnsubscribe` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cep:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/CloseChannel": { "post": { "operationId": "CloseChannel", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CloseChannel" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_CloseChannel" } } }, "description": "`CloseChannel` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "channel:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/CreateChannel": { "post": { "operationId": "CreateChannel", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CreateChannel" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_CreateChannel" } } }, "description": "`CreateChannel` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch; message/member payloads stay out of the ledger", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "channel:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/DeclareExchange": { "post": { "operationId": "DeclareExchange", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DeclareExchange" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_DeclareExchange" } } }, "description": "`DeclareExchange` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DeclareExchange", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/DeclareQueue": { "post": { "operationId": "DeclareQueue", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DeclareQueue" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_DeclareQueue" } } }, "description": "`DeclareQueue` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DeclareQueue", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/DeleteExchange": { "post": { "operationId": "DeleteExchange", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DeleteExchange" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_DeleteExchange" } } }, "description": "`DeleteExchange` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "DeleteExchange", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/DropContinuousQuery": { "post": { "operationId": "DropContinuousQuery", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DropContinuousQuery" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_DropContinuousQuery" } } }, "description": "`DropContinuousQuery` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/DropTrigger": { "post": { "operationId": "DropTrigger", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DropTrigger" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_DropTrigger" } } }, "description": "`DropTrigger` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/FiredTriggers": { "post": { "operationId": "FiredTriggers", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FiredTriggers" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_FiredTriggers" } } }, "description": "`FiredTriggers` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "FiredTriggers", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/GetChannelMembers": { "post": { "operationId": "GetChannelMembers", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetChannelMembers" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_GetChannelMembers" } } }, "description": "`GetChannelMembers` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetChannelMembers", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "channel:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/GetChannelMessages": { "post": { "operationId": "GetChannelMessages", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetChannelMessages" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_GetChannelMessages" } } }, "description": "`GetChannelMessages` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetChannelMessages", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "channel:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/JoinChannel": { "post": { "operationId": "JoinChannel", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_JoinChannel" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_JoinChannel" } } }, "description": "`JoinChannel` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "channel:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/LeaveChannel": { "post": { "operationId": "LeaveChannel", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_LeaveChannel" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_LeaveChannel" } } }, "description": "`LeaveChannel` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "channel:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/ListChannels": { "post": { "operationId": "ListChannels", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ListChannels" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_ListChannels" } } }, "description": "`ListChannels` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ListChannels", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "channel:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/ListTriggers": { "post": { "operationId": "ListTriggers", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ListTriggers" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_ListTriggers" } } }, "description": "`ListTriggers` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ListTriggers", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/Publish": { "post": { "operationId": "Publish", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Publish" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_Publish" } } }, "description": "`Publish` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "PublishIdempotent is the one exception (producer-id/seq dedup makes replays idempotent by construction)", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:publish", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/PublishConfirmed": { "post": { "operationId": "PublishConfirmed", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PublishConfirmed" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_PublishConfirmed" } } }, "description": "`PublishConfirmed` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "PublishIdempotent is the one exception (producer-id/seq dedup makes replays idempotent by construction)", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:publish", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/PublishEx": { "post": { "operationId": "PublishEx", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PublishEx" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_PublishEx" } } }, "description": "`PublishEx` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "PublishIdempotent is the one exception (producer-id/seq dedup makes replays idempotent by construction)", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:publish", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/PublishIdempotent": { "post": { "operationId": "PublishIdempotent", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_PublishIdempotent" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_PublishIdempotent" } } }, "description": "`PublishIdempotent` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "PublishIdempotent is the one exception (producer-id/seq dedup makes replays idempotent by construction)", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:publish", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/ReadContinuousQuery": { "post": { "operationId": "ReadContinuousQuery", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ReadContinuousQuery" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_ReadContinuousQuery" } } }, "description": "`ReadContinuousQuery` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ReadContinuousQuery", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/RegisterContinuousQuery": { "post": { "operationId": "RegisterContinuousQuery", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RegisterContinuousQuery" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_RegisterContinuousQuery" } } }, "description": "`RegisterContinuousQuery` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/RegisterTrigger": { "post": { "operationId": "RegisterTrigger", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RegisterTrigger" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_RegisterTrigger" } } }, "description": "`RegisterTrigger` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opaque prepared/committed session-control MutationBatch", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/SendMessage": { "post": { "operationId": "SendMessage", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SendMessage" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_SendMessage" } } }, "description": "`SendMessage` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "request-scoped opaque session-control receipt prevents acknowledgement-lost duplicate sends", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "channel:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/messaging/StreamCommitOffset": { "post": { "operationId": "StreamCommitOffset", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StreamCommitOffset" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_StreamCommitOffset" } } }, "description": "`StreamCommitOffset` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "StreamCommitOffset", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "stream:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/StreamCommittedOffset": { "post": { "operationId": "StreamCommittedOffset", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StreamCommittedOffset" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_StreamCommittedOffset" } } }, "description": "`StreamCommittedOffset` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "StreamCommittedOffset", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "stream:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/StreamDeclare": { "post": { "operationId": "StreamDeclare", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StreamDeclare" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_StreamDeclare" } } }, "description": "`StreamDeclare` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "StreamDeclare", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "stream:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/StreamPublish": { "post": { "operationId": "StreamPublish", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StreamPublish" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_StreamPublish" } } }, "description": "`StreamPublish` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "StreamPublish", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "stream:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/StreamRead": { "post": { "operationId": "StreamRead", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StreamRead" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_StreamRead" } } }, "description": "`StreamRead` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "StreamRead", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "stream:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/messaging/StreamTrim": { "post": { "operationId": "StreamTrim", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StreamTrim" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_StreamTrim" } } }, "description": "`StreamTrim` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "StreamTrim", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "stream:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/SweepExpired": { "post": { "operationId": "SweepExpired", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SweepExpired" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_SweepExpired" } } }, "description": "`SweepExpired` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "SweepExpired", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/UnbindQueue": { "post": { "operationId": "UnbindQueue", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UnbindQueue" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_UnbindQueue" } } }, "description": "`UnbindQueue` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "UnbindQueue", "tags": [ "messaging" ], "x-audited": true, "x-authz-action": "broker:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "Outbox", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/messaging/Watch": { "post": { "operationId": "Watch", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Watch" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_messaging_Watch" } } }, "description": "`Watch` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "opens a push subscription; not a snapshot read nor a mutation", "tags": [ "messaging" ], "x-audited": false, "x-authz-action": "cdc:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": false, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "None" } }, "/rpc/query/CausalCounterfactual": { "post": { "operationId": "CausalCounterfactual", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CausalCounterfactual" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_CausalCounterfactual" } } }, "description": "`CausalCounterfactual` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "EPI-P3-6 Pearl point-counterfactual over a request-carried SCM + a fully-observed unit; handler additionally gated `epistemic-causal`", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/CausalEstimate": { "post": { "operationId": "CausalEstimate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CausalEstimate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_CausalEstimate" } } }, "description": "`CausalEstimate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "EPI-P3-3/P3-6 do-calculus intervention OR observational conditioning (selected by `mode`) over a request-carried SCM; handler additionally gated `epistemic-causal`", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/CypherQuery": { "post": { "operationId": "CypherQuery", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_CypherQuery" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_CypherQuery" } } }, "description": "`CypherQuery` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "runtime-conditional; writes execute against a staged graph and publish only after durable MutationBatch commit", "tags": [ "query" ], "x-audited": true, "x-authz-action": "query:cypher", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/query/Decide": { "post": { "operationId": "Decide", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Decide" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_Decide" } } }, "description": "`Decide` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-010 DL-4. Evaluate-only: scores the tenant-visible library candidates under a pinned feature schema, head and policy and answers a batch of sealed statistical records; it commits none of them. Graph-sourced candidates are refused until graph-sourced records land", "tags": [ "query" ], "x-audited": false, "x-authz-action": "query:decide", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/EpistemicStatus": { "post": { "operationId": "EpistemicStatus", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_EpistemicStatus" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_EpistemicStatus" } } }, "description": "`EpistemicStatus` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "L53 (EPI-P3-5) acceptance capstone; handler additionally gated `epistemic-tms`", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/ExplainBelief": { "post": { "operationId": "ExplainBelief", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ExplainBelief" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_ExplainBelief" } } }, "description": "`ExplainBelief` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ExplainBelief", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/ExplainEvidence": { "post": { "operationId": "ExplainEvidence", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ExplainEvidence" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_ExplainEvidence" } } }, "description": "`ExplainEvidence` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CONCEPT:EG-X1 multimodal-citation resolver; handler additionally gated `evidence-graph`", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/ExplainPlan": { "post": { "operationId": "ExplainPlan", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ExplainPlan" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_ExplainPlan" } } }, "description": "`ExplainPlan` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ExplainPlan", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/ExplainPolicy": { "post": { "operationId": "ExplainPolicy", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ExplainPolicy" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_ExplainPolicy" } } }, "description": "`ExplainPolicy` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ExplainPolicy", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/ExplainProvenance": { "post": { "operationId": "ExplainProvenance", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ExplainProvenance" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_ExplainProvenance" } } }, "description": "`ExplainProvenance` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ExplainProvenance", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/ExplainProvenanceByIds": { "post": { "operationId": "ExplainProvenanceByIds", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ExplainProvenanceByIds" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_ExplainProvenanceByIds" } } }, "description": "`ExplainProvenanceByIds` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "CONCEPT:EG-KB-CURRENCY \u2014 ID-seeded sibling of ExplainProvenance, same policy profile", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/GetChangeCursor": { "post": { "operationId": "GetChangeCursor", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetChangeCursor" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_GetChangeCursor" } } }, "description": "`GetChangeCursor` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Typed source cursors are tenant/graph/partition scoped", "tags": [ "query" ], "x-audited": false, "x-authz-action": "ingest:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/GetChangeEnvelope": { "post": { "operationId": "GetChangeEnvelope", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetChangeEnvelope" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_GetChangeEnvelope" } } }, "description": "`GetChangeEnvelope` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Verified tenant-scoped reconciliation read", "tags": [ "query" ], "x-audited": false, "x-authz-action": "ingest:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/GetContentVersion": { "post": { "operationId": "GetContentVersion", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetContentVersion" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_GetContentVersion" } } }, "description": "`GetContentVersion` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Typed content versions are never compared lexically", "tags": [ "query" ], "x-audited": false, "x-authz-action": "ingest:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/GetContextView": { "post": { "operationId": "GetContextView", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetContextView" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_GetContextView" } } }, "description": "`GetContextView` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetContextView", "tags": [ "query" ], "x-audited": false, "x-authz-action": "node:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/GraphQl": { "post": { "operationId": "GraphQl", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GraphQl" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_GraphQl" } } }, "description": "`GraphQl` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "runtime-conditional; ordinary writes stage through MutationBatch and cross-modal commit atomically includes universal status/fence/idempotency/outbox", "tags": [ "query" ], "x-audited": true, "x-authz-action": "query:graphql", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/query/KnowledgeStream": { "post": { "operationId": "KnowledgeStream", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_KnowledgeStream" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_KnowledgeStream" } } }, "description": "`KnowledgeStream` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "one RequestContext/RLS/placement-bound stream with the sole native Arrow IPC projection for all seven query families", "tags": [ "query" ], "x-audited": false, "x-authz-action": "query:stream", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/MaterializationStatus": { "post": { "operationId": "MaterializationStatus", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MaterializationStatus" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_MaterializationStatus" } } }, "description": "`MaterializationStatus` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "read-only status from the durable per-graph incremental reasoning authority", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/NlQuery": { "post": { "operationId": "NlQuery", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_NlQuery" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_NlQuery" } } }, "description": "`NlQuery` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "NlQuery", "tags": [ "query" ], "x-audited": false, "x-authz-action": "query:nl", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": false, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/RankByProvenance": { "post": { "operationId": "RankByProvenance", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RankByProvenance" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_RankByProvenance" } } }, "description": "`RankByProvenance` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "EPI-P3-3 provenance-aware retrieval ranking; handler additionally gated `epistemic-causal`", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/RecomputeMaterialization": { "post": { "operationId": "RecomputeMaterialization", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RecomputeMaterialization" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_RecomputeMaterialization" } } }, "description": "`RecomputeMaterialization` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "fenced recompute/writeback resolves provenance from the authoritative graph and fsyncs the per-graph projection", "tags": [ "query" ], "x-audited": false, "x-authz-action": "reasoning:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ReasoningProjection", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/query/ResolveConflict": { "post": { "operationId": "ResolveConflict", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ResolveConflict" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_ResolveConflict" } } }, "description": "`ResolveConflict` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "EPI-P3-7 (gap-fill) standalone Dung argumentation (grounded/preferred/stable) conflict resolution over a BeliefGraph snapshot; handler additionally gated `epistemic-tms`", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/Sql": { "post": { "operationId": "Sql", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Sql" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_Sql" } } }, "description": "`Sql` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "runtime-conditional; graph DML uses staged graph state while table/catalog writes atomically commit SQL rows plus MutationBatch status/fence/idempotency/outbox", "tags": [ "query" ], "x-audited": true, "x-authz-action": "query:sql", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/query/StaleMaterializations": { "post": { "operationId": "StaleMaterializations", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_StaleMaterializations" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_StaleMaterializations" } } }, "description": "`StaleMaterializations` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "bulk opaque stale references from the durable per-graph incremental reasoning authority", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/TxnUnifiedQuery": { "post": { "operationId": "TxnUnifiedQuery", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnUnifiedQuery" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_TxnUnifiedQuery" } } }, "description": "`TxnUnifiedQuery` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "TxnUnifiedQuery", "tags": [ "query" ], "x-audited": false, "x-authz-action": "txn:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/query/TxnUnifiedQueryText": { "post": { "operationId": "TxnUnifiedQueryText", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnUnifiedQueryText" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_TxnUnifiedQueryText" } } }, "description": "`TxnUnifiedQueryText` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "TxnUnifiedQueryText", "tags": [ "query" ], "x-audited": false, "x-authz-action": "txn:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/query/UnifiedQuery": { "post": { "operationId": "UnifiedQuery", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UnifiedQuery" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_UnifiedQuery" } } }, "description": "`UnifiedQuery` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "UnifiedQuery", "tags": [ "query" ], "x-audited": false, "x-authz-action": "query:unified", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/UnifiedQueryText": { "post": { "operationId": "UnifiedQueryText", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_UnifiedQueryText" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_UnifiedQueryText" } } }, "description": "`UnifiedQueryText` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "UnifiedQueryText", "tags": [ "query" ], "x-audited": false, "x-authz-action": "query:unified", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/query/WhatChanged": { "post": { "operationId": "WhatChanged", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_WhatChanged" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_query_WhatChanged" } } }, "description": "`WhatChanged` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "L53 (EPI-P3-5) bitemporal diff; handler additionally gated `epistemic-tms`", "tags": [ "query" ], "x-audited": false, "x-authz-action": "explain:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/GetRdf": { "post": { "operationId": "GetRdf", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetRdf" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_GetRdf" } } }, "description": "`GetRdf` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetRdf", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "rdf:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/GraphSchema": { "post": { "operationId": "GraphSchema", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GraphSchema" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_GraphSchema" } } }, "description": "`GraphSchema` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "X9. Gateway-routed exactly like IcvConfigure: every op attaches, replaces or detaches one keyed schema source through the graph commit kernel, so it is audited, emits CDC, and is recorded in the native Raft GraphState catalog", "tags": [ "reasoning" ], "x-audited": true, "x-authz-action": "security:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/reasoning/GraphSchemaList": { "post": { "operationId": "GraphSchemaList", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GraphSchemaList" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_GraphSchemaList" } } }, "description": "`GraphSchemaList` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "X9. Reads the request graph's schema-source set and its composed digest; a separate method rather than an op because a read op inside a gateway-routed method would need a runtime-conditional gateway plan", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "security:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/IcvConfigure": { "post": { "operationId": "IcvConfigure", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_IcvConfigure" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_IcvConfigure" } } }, "description": "`IcvConfigure` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch", "tags": [ "reasoning" ], "x-audited": true, "x-authz-action": "security:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/reasoning/OwlExplain": { "post": { "operationId": "OwlExplain", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_OwlExplain" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_OwlExplain" } } }, "description": "`OwlExplain` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "OwlExplain", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "owl:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/OwlReason": { "post": { "operationId": "OwlReason", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_OwlReason" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_OwlReason" } } }, "description": "`OwlReason` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "OwlReason", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "owl:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/OwlReasonDistributed": { "post": { "operationId": "OwlReasonDistributed", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_OwlReasonDistributed" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_OwlReasonDistributed" } } }, "description": "`OwlReasonDistributed` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "OwlReasonDistributed", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "owl:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/RunDatalogReasoning": { "post": { "operationId": "RunDatalogReasoning", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RunDatalogReasoning" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_RunDatalogReasoning" } } }, "description": "`RunDatalogReasoning` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch commits inferred facts; operation-identity replay prevents duplicate materialization/audit/CDC", "tags": [ "reasoning" ], "x-audited": true, "x-authz-action": "reasoning:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/reasoning/RunRules": { "post": { "operationId": "RunRules", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RunRules" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_RunRules" } } }, "description": "`RunRules` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "READ-ONLY (EG-P0-2/L11 handler audit): handle_run_rules reasons over an off-lock analysis_snapshot and returns inferred triples, no writeback -- unlike its sibling RunDatalogReasoning which materialises in-place. Corrected from a prior mutates=true semantic guess; now agrees with access.rs (never a write there)", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "reasoning:read", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/ShaclValidate": { "post": { "operationId": "ShaclValidate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ShaclValidate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_ShaclValidate" } } }, "description": "`ShaclValidate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ShaclValidate", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "validation:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/ShexValidate": { "post": { "operationId": "ShexValidate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ShexValidate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_ShexValidate" } } }, "description": "`ShexValidate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ShexValidate", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "validation:read", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/Sparql": { "post": { "operationId": "Sparql", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Sparql" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_Sparql" } } }, "description": "`Sparql` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Sparql", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "sparql:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/reasoning/SparqlVirtual": { "post": { "operationId": "SparqlVirtual", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SparqlVirtual" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_reasoning_SparqlVirtual" } } }, "description": "`SparqlVirtual` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "SparqlVirtual", "tags": [ "reasoning" ], "x-audited": false, "x-authz-action": "sparql:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/security/AuditProveInclusion": { "post": { "operationId": "AuditProveInclusion", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AuditProveInclusion" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_security_AuditProveInclusion" } } }, "description": "`AuditProveInclusion` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "provenance anchoring: Merkle inclusion proof for one node against a prior PROVENANCE_ANCHOR audit-chain entry", "tags": [ "security" ], "x-audited": false, "x-authz-action": "security:audit", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/security/AuditVerify": { "post": { "operationId": "AuditVerify", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AuditVerify" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_security_AuditVerify" } } }, "description": "`AuditVerify` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "AuditVerify", "tags": [ "security" ], "x-audited": false, "x-authz-action": "security:audit", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/security/GetIdentity": { "post": { "operationId": "GetIdentity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetIdentity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_security_GetIdentity" } } }, "description": "`GetIdentity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "identity read-back closing the RegisterIdentity blind-upsert gap: None means unregistered/unknown, Some(identity) with empty roles means registered-and-confirmed-empty -- gated security:admin like RegisterIdentity/RbacAdmin so it grants no caller new privilege", "tags": [ "security" ], "x-audited": false, "x-authz-action": "security:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/security/GetLedger": { "post": { "operationId": "GetLedger", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_GetLedger" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_security_GetLedger" } } }, "description": "`GetLedger` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "GetLedger", "tags": [ "security" ], "x-audited": false, "x-authz-action": "ledger:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/security/RbacAdmin": { "post": { "operationId": "RbacAdmin", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RbacAdmin" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_security_RbacAdmin" } } }, "description": "`RbacAdmin` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "runtime-conditional: List is a read; role and grant updates share one rbac.redb WTX with MutationBatch metadata", "tags": [ "security" ], "x-audited": false, "x-authz-action": "security:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/security/RegisterIdentity": { "post": { "operationId": "RegisterIdentity", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_RegisterIdentity" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_security_RegisterIdentity" } } }, "description": "`RegisterIdentity` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RBAC/identity snapshot and MutationBatch metadata share one rbac.redb WTX", "tags": [ "security" ], "x-audited": false, "x-authz-action": "security:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/AgentAssemble": { "post": { "operationId": "AgentAssemble", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AgentAssemble" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_AgentAssemble" } } }, "description": "`AgentAssemble` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-010 A1. Reads ONE tenant-bound agent_library.redb snapshot and proves an agent graph against it; commits nothing. The record it answers with is durable only if the caller then sends DecisionCommit", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "agent:assemble-read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/AgentComponent": { "post": { "operationId": "AgentComponent", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AgentComponent" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_AgentComponent" } } }, "description": "`AgentComponent` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-008 layer 1. Runtime-conditional like AgentLibrary/AgentGraph: Current/History/Status/Search are authenticated tenant-bound read snapshots; Publish/Retire atomically commit native component revisions, action provenance, replay receipts and outbox through ControlRedb into the SAME agent_library.redb owner", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "agent:component-write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/AgentGraph": { "post": { "operationId": "AgentGraph", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AgentGraph" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_AgentGraph" } } }, "description": "`AgentGraph` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-008. Runtime-conditional exactly like AgentLibrary: Current/History/Status are authenticated tenant-bound read snapshots; Publish/Retire atomically commit native graph revisions, action provenance, replay receipts, and outbox through ControlRedb into the SAME agent_library.redb owner", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "agent:graph-write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/AgentLibrary": { "post": { "operationId": "AgentLibrary", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AgentLibrary" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_AgentLibrary" } } }, "description": "`AgentLibrary` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "runtime-conditional: Current/History/Status are authenticated tenant-bound read snapshots; Publish/Retire atomically commit native revisions, action provenance, replay receipts, and outbox through ControlRedb", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "agent:library-write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/AgentTemplate": { "post": { "operationId": "AgentTemplate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_AgentTemplate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_AgentTemplate" } } }, "description": "`AgentTemplate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-008 item C. Runtime-conditional like the three layers beside it: Current/History/Status/Instantiate are authenticated tenant-bound read snapshots (Instantiate binds parameters and returns a draft, committing nothing); Publish/Retire atomically commit native template revisions, action provenance, replay receipts and outbox through ControlRedb into the SAME agent_library.redb owner. Its own authz action because publishing a parameterized FAMILY of agents is a distinct privilege from publishing one", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "agent:template-write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/ApplyLedger": { "post": { "operationId": "ApplyLedger", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ApplyLedger" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_ApplyLedger" } } }, "description": "`ApplyLedger` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch", "tags": [ "storage" ], "x-audited": true, "x-authz-action": "ledger:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/Backup": { "post": { "operationId": "Backup", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Backup" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_Backup" } } }, "description": "`Backup` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "reads a consistent snapshot out to a bundle; does not mutate the live graph", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "admin:backup", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/BlobBegin": { "post": { "operationId": "BlobBegin", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobBegin" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobBegin" } } }, "description": "`BlobBegin` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "multi-call chunked-upload protocol (Begin ... ChunkPut* ... Commit); no single-call atomicity; durable via its own blob.redb (group-committed Immediate), self-routes before dispatch_graph_op", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "BlobRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/storage/BlobChunkGet": { "post": { "operationId": "BlobChunkGet", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobChunkGet" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobChunkGet" } } }, "description": "`BlobChunkGet` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BlobChunkGet", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/BlobChunkPut": { "post": { "operationId": "BlobChunkPut", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobChunkPut" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobChunkPut" } } }, "description": "`BlobChunkPut` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "durable via its own blob.redb (group-committed Immediate); self-routes before dispatch_graph_op", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "BlobRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/storage/BlobCommit": { "post": { "operationId": "BlobCommit", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobCommit" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobCommit" } } }, "description": "`BlobCommit` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "multi-call chunked-upload protocol (Begin ... ChunkPut* ... Commit); no single-call atomicity; durable via its own blob.redb (group-committed Immediate), self-routes before dispatch_graph_op", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "BlobRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/storage/BlobFetchBegin": { "post": { "operationId": "BlobFetchBegin", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobFetchBegin" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobFetchBegin" } } }, "description": "`BlobFetchBegin` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BlobFetchBegin", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/BlobFetchEnd": { "post": { "operationId": "BlobFetchEnd", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobFetchEnd" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobFetchEnd" } } }, "description": "`BlobFetchEnd` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BlobFetchEnd", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/BlobGc": { "post": { "operationId": "BlobGc", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobGc" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobGc" } } }, "description": "`BlobGc` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "durable via blob.redb", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "BlobRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/BlobRef": { "post": { "operationId": "BlobRef", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobRef" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobRef" } } }, "description": "`BlobRef` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "X6 (fix/eg-blob-cas-hardening-20260917): holder-scoped named reference (digest, owner scope), not a bare counter -- a retry or replay of the same reference is one holder row, never a second count (holders.rs's own module doc and handle_blob_ref_op's doc comment). Idempotent as of the 2.27.x blob CAS hardening; durable via blob.redb.", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "BlobRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/BlobUnref": { "post": { "operationId": "BlobUnref", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BlobUnref" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_BlobUnref" } } }, "description": "`BlobUnref` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "X6: releasing an already-released holder returns changed: false rather than erroring or underflowing (HolderOutcome's own doc comment). Idempotent as of the 2.27.x blob CAS hardening; durable via blob.redb.", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "blob:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "BlobRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/ClearLedger": { "post": { "operationId": "ClearLedger", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ClearLedger" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_ClearLedger" } } }, "description": "`ClearLedger` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch", "tags": [ "storage" ], "x-audited": true, "x-authz-action": "ledger:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/ConnectorPack": { "post": { "operationId": "ConnectorPack", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ConnectorPack" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_ConnectorPack" } } }, "description": "`ConnectorPack` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-009 A2 plus RF-021 durable catalog reconciliation; runtime-conditional: status is an authenticated tenant-bound read snapshot exposing the exact MCP catalog generation/digest binding; import atomically commits resources/templates, component revisions, CAS body holders, provenance, receipt and outbox. Bind/unbind/retire/reproject/reconcile_bodies and a mass-withdrawal import need admin:connector-pack; local-only authority, refused in clustered mode", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "agent:pack-control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/DecisionCommit": { "post": { "operationId": "DecisionCommit", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_DecisionCommit" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_DecisionCommit" } } }, "description": "`DecisionCommit` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "native MutationBatch in agent_library.redb: one DecisionRecord component revision, its receipt and outbox in one WTX after re-derivation and a catalog compare-and-set; local-only authority, refused in clustered mode", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "agent:decision-write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/ExportSqliteFile": { "post": { "operationId": "ExportSqliteFile", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ExportSqliteFile" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_ExportSqliteFile" } } }, "description": "`ExportSqliteFile` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "operator-provisioned transfer root; logical filenames only", "tags": [ "storage" ], "x-audited": true, "x-authz-action": "admin:sqlite-file", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/FromMsgpack": { "post": { "operationId": "FromMsgpack", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_FromMsgpack" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_FromMsgpack" } } }, "description": "`FromMsgpack` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "state-backed MutationBatch commits the imported authoritative image", "tags": [ "storage" ], "x-audited": true, "x-authz-action": "graph:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/ImportSqliteFile": { "post": { "operationId": "ImportSqliteFile", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ImportSqliteFile" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_ImportSqliteFile" } } }, "description": "`ImportSqliteFile` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "native SQL-catalog MutationBatch; logical transfer name is excluded from the durable receipt", "tags": [ "storage" ], "x-audited": true, "x-authz-action": "admin:sqlite-file", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/KvCas": { "post": { "operationId": "KvCas", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_KvCas" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_KvCas" } } }, "description": "`KvCas` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "durable via its own kv.redb (redb::Durability::Immediate, commit-before-ack); self-routes before graph dispatch", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "kv:write", "x-consumer-profiles": [], "x-durability-domain": "KvRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Atomic" } }, "/rpc/storage/KvDelete": { "post": { "operationId": "KvDelete", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_KvDelete" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_KvDelete" } } }, "description": "`KvDelete` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "durable via its own kv.redb (redb::Durability::Immediate); self-routes before dispatch_graph_op", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "kv:write", "x-consumer-profiles": [], "x-durability-domain": "KvRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Atomic" } }, "/rpc/storage/KvGet": { "post": { "operationId": "KvGet", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_KvGet" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_KvGet" } } }, "description": "`KvGet` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "KvGet", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "kv:read", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/storage/KvPut": { "post": { "operationId": "KvPut", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_KvPut" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_KvPut" } } }, "description": "`KvPut` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "durable via its own kv.redb (redb::Durability::Immediate, commit-before-ack); self-routes before graph dispatch", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "kv:write", "x-consumer-profiles": [], "x-durability-domain": "KvRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Atomic" } }, "/rpc/storage/KvScan": { "post": { "operationId": "KvScan", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_KvScan" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_KvScan" } } }, "description": "`KvScan` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "KvScan", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "kv:read", "x-consumer-profiles": [], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "internal", "x-txn-participation": "Snapshot" } }, "/rpc/storage/Restore": { "post": { "operationId": "Restore", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Restore" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_Restore" } } }, "description": "`Restore` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "prepared/committed admin MutationBatch saga", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "admin:backup", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/storage/SqlSourceBatch": { "post": { "operationId": "SqlSourceBatch", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_SqlSourceBatch" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_SqlSourceBatch" } } }, "description": "`SqlSourceBatch` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "native SQL-catalog MutationBatch: typed source rows, provider cursor, committed source epoch, terminal result, replay/idempotency and outbox in one WTX; self-routes before graph dispatch; local-only authority, refused in clustered mode", "tags": [ "storage" ], "x-audited": true, "x-authz-action": "query:sql", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/ToMsgpack": { "post": { "operationId": "ToMsgpack", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ToMsgpack" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_ToMsgpack" } } }, "description": "`ToMsgpack` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "ToMsgpack", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "graph:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/TsAppend": { "post": { "operationId": "TsAppend", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TsAppend" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_TsAppend" } } }, "description": "`TsAppend` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "graph ACL + placement policy precede the tenant/graph/series-scoped series.redb write", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "timeseries:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "SeriesRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/TsAsofJoin": { "post": { "operationId": "TsAsofJoin", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TsAsofJoin" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_TsAsofJoin" } } }, "description": "`TsAsofJoin` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "TsAsofJoin", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "timeseries:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/TsDeleteSeries": { "post": { "operationId": "TsDeleteSeries", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TsDeleteSeries" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_TsDeleteSeries" } } }, "description": "`TsDeleteSeries` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "content-idempotent unlike TsAppend: re-deleting an already-gone series is a safe no-op (see SeriesStore::delete_series)", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "timeseries:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "SeriesRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/TsEvict": { "post": { "operationId": "TsEvict", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TsEvict" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_TsEvict" } } }, "description": "`TsEvict` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "content-idempotent unlike TsAppend: re-evicting an already-past cutoff is a safe no-op (see SeriesStore::evict_before)", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "timeseries:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "SeriesRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/storage/TsGapFill": { "post": { "operationId": "TsGapFill", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TsGapFill" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_TsGapFill" } } }, "description": "`TsGapFill` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "TsGapFill", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "timeseries:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/TsListSeries": { "post": { "operationId": "TsListSeries", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TsListSeries" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_TsListSeries" } } }, "description": "`TsListSeries` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "TsListSeries", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "timeseries:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/TsRange": { "post": { "operationId": "TsRange", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TsRange" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_TsRange" } } }, "description": "`TsRange` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "TsRange", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "timeseries:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/TsWindow": { "post": { "operationId": "TsWindow", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TsWindow" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_TsWindow" } } }, "description": "`TsWindow` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "TsWindow", "tags": [ "storage" ], "x-audited": false, "x-authz-action": "timeseries:read", "x-consumer-profiles": [ "python" ], "x-durability-domain": "None", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED" ], "x-idempotent": true, "x-mutates": false, "x-replay-class": "NotReplayable", "x-stability": "stable", "x-txn-participation": "Snapshot" } }, "/rpc/storage/WriteBack": { "post": { "operationId": "WriteBack", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_WriteBack" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_storage_WriteBack" } } }, "description": "`WriteBack` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "RF-ADR-009 D18, runtime-conditional: create/record operations append tenant-bound change-set and receipt rows through the existing Agent Library ControlRedb mutation kernel; get/receipts are authenticated snapshots. EG records authorization and source observations and never calls vendor APIs", "tags": [ "storage" ], "x-audited": true, "x-authz-action": "connector:write-back", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/transactions/ApplyChangeEnvelope": { "post": { "operationId": "ApplyChangeEnvelope", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ApplyChangeEnvelope" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_ApplyChangeEnvelope" } } }, "description": "`ApplyChangeEnvelope` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Engine-native object/material/governance/version/cursor/outbox commit; verified context is mandatory", "tags": [ "transactions" ], "x-audited": true, "x-authz-action": "ingest:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/transactions/ApplyChangeEnvelopes": { "post": { "operationId": "ApplyChangeEnvelopes", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ApplyChangeEnvelopes" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_ApplyChangeEnvelopes" } } }, "description": "`ApplyChangeEnvelopes` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "Batch envelope coordinator: one coalesced graph transaction per shard-partition; same policy class as ApplyChangeEnvelope", "tags": [ "transactions" ], "x-audited": true, "x-authz-action": "ingest:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/transactions/ApplyMultisigMutation": { "post": { "operationId": "ApplyMultisigMutation", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_ApplyMultisigMutation" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_ApplyMultisigMutation" } } }, "description": "`ApplyMultisigMutation` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "threshold validation translates into the graph MutationBatch gateway", "tags": [ "transactions" ], "x-audited": true, "x-authz-action": "security:admin", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": true, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/BatchUpdate": { "post": { "operationId": "BatchUpdate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BatchUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_BatchUpdate" } } }, "description": "`BatchUpdate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "BatchUpdate", "tags": [ "transactions" ], "x-audited": true, "x-authz-action": "node:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "GraphRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Atomic" } }, "/rpc/transactions/BeginTxn": { "post": { "operationId": "BeginTxn", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_BeginTxn" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_BeginTxn" } } }, "description": "`BeginTxn` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native transaction staging authority", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/Commit": { "post": { "operationId": "Commit", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Commit" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_Commit" } } }, "description": "`Commit` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "named parent receipt plus atomic graph/cross-modal child batches", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/MultiGraphBatchUpdate": { "post": { "operationId": "MultiGraphBatchUpdate", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MultiGraphBatchUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_MultiGraphBatchUpdate" } } }, "description": "`MultiGraphBatchUpdate` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "durable parent coordinator with per-graph MutationBatch children", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "node:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/MutationOutbox": { "post": { "operationId": "MutationOutbox", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_MutationOutbox" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_MutationOutbox" } } }, "description": "`MutationOutbox` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "X10, runtime-conditional: status and dead_letters are reads; rewind resets one consumer's durable cursor through bounded eg-transaction transactions, so it is a saga rather than one atomic write. Local-only authority, refused in clustered mode", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "admin:outbox", "x-consumer-profiles": [], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "internal", "x-txn-participation": "Saga" } }, "/rpc/transactions/Rollback": { "post": { "operationId": "Rollback", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_Rollback" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_Rollback" } } }, "description": "`Rollback` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native transaction staging removal", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:control", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnAddEdge": { "post": { "operationId": "TxnAddEdge", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnAddEdge" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnAddEdge" } } }, "description": "`TxnAddEdge` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native staging; Commit owns graph publication", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnAddEmbedding": { "post": { "operationId": "TxnAddEmbedding", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnAddEmbedding" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnAddEmbedding" } } }, "description": "`TxnAddEmbedding` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native cross-modal staging", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnAddMeasurement": { "post": { "operationId": "TxnAddMeasurement", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnAddMeasurement" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnAddMeasurement" } } }, "description": "`TxnAddMeasurement` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native cross-modal staging", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnAddNode": { "post": { "operationId": "TxnAddNode", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnAddNode" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnAddNode" } } }, "description": "`TxnAddNode` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native staging; Commit owns graph publication", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnAxiom": { "post": { "operationId": "TxnAxiom", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnAxiom" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnAxiom" } } }, "description": "`TxnAxiom` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native cross-modal staging", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnBlobRef": { "post": { "operationId": "TxnBlobRef", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnBlobRef" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnBlobRef" } } }, "description": "`TxnBlobRef` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native cross-modal staging", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnCas": { "post": { "operationId": "TxnCas", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnCas" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnCas" } } }, "description": "`TxnCas` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native staging; Commit owns graph publication", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnConstruct": { "post": { "operationId": "TxnConstruct", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnConstruct" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnConstruct" } } }, "description": "`TxnConstruct` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native cross-modal staging", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnMaterializeBelief": { "post": { "operationId": "TxnMaterializeBelief", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnMaterializeBelief" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnMaterializeBelief" } } }, "description": "`TxnMaterializeBelief` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native cross-modal staging", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnPlanWriteback": { "post": { "operationId": "TxnPlanWriteback", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnPlanWriteback" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnPlanWriteback" } } }, "description": "`TxnPlanWriteback` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native cross-modal staging", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": false, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnRemoveEdge": { "post": { "operationId": "TxnRemoveEdge", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnRemoveEdge" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnRemoveEdge" } } }, "description": "`TxnRemoveEdge` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native staging; Commit owns graph publication", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } }, "/rpc/transactions/TxnRemoveNode": { "post": { "operationId": "TxnRemoveNode", "requestBody": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Req_TxnRemoveNode" } } }, "required": true }, "responses": { "200": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Res_transactions_TxnRemoveNode" } } }, "description": "`TxnRemoveNode` result." }, "default": { "content": { "application/msgpack": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Typed engine error (one of `x-error-set`)." } }, "summary": "encrypted Raft-native staging; Commit owns graph publication", "tags": [ "transactions" ], "x-audited": false, "x-authz-action": "txn:write", "x-consumer-profiles": [ "python" ], "x-durability-domain": "ControlRedb", "x-emits-cdc": false, "x-error-set": [ "INVALID_ARGUMENT", "ACCESS_DENIED", "CONFLICT", "IDEMPOTENCY_CONFLICT", "REDIRECTED", "READ_ONLY" ], "x-idempotent": true, "x-mutates": true, "x-replay-class": "OperationIdentity", "x-stability": "stable", "x-txn-participation": "Saga" } } }, "servers": [ { "description": "Placeholder -- Epistemic Graph is embedded/deployed per-installation; see docs/deployment.md for real endpoints.", "url": "/" } ], "tags": [ { "name": "cluster" }, { "name": "compute" }, { "name": "coordination" }, { "name": "graph" }, { "name": "ingestion" }, { "name": "messaging" }, { "name": "query" }, { "name": "reasoning" }, { "name": "security" }, { "name": "storage" }, { "name": "transactions" } ] }