Application-language function catalog
Application-language functions are selected by program.function inside a callable MCP tool. The tables below show contracts extracted from the current local code.
Use authenticated discovery for the actual deployment, role and scope. Application discovery is filtered by current grants and capabilities. Security functions additionally require the configured security service. Some functions require other deployment services such as a Python build runtime.
Application functions
Discover with list_v2_functions.
231 functions in this local catalog.
application.assignment.deactivate
Tool reference · execute_v2_application_assignment
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "admin",
"idempotencyRequired": true,
"mode": "atomic_policy_write",
"arguments": {
"assignmentSetId": "stable assignment-set ID",
"expectedStateRevision": "current assignment-set state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "inactive assignment pointer and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.assignment.list
Tool reference · execute_v2_application_assignment, read_v2_program
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "read",
"idempotencyRequired": false,
"mode": "read",
"arguments": {},
"optionalArguments": {
"limit": "1-100",
"afterAssignmentSetId": "keyset cursor"
},
"result": "bounded latest assignment definitions"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.assignment.publish
Tool reference · execute_v2_application_assignment
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "admin",
"idempotencyRequired": true,
"mode": "atomic_policy_write",
"arguments": {
"assignmentSetId": "stable assignment-set ID",
"version": "exact immutable version",
"expectedStateRevision": "current assignment-set state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "active assignment pointer and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.assignment.read
Tool reference · execute_v2_application_assignment, read_v2_program
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "read",
"idempotencyRequired": false,
"mode": "read",
"arguments": {
"assignmentSetId": "stable assignment-set ID"
},
"optionalArguments": {
"version": "exact immutable version"
},
"result": "verified assignment definition and publication state"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.assignment.save
Tool reference · execute_v2_application_assignment
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "admin",
"idempotencyRequired": true,
"mode": "immutable_assignment_write",
"arguments": {
"definition": "canonical application-assignment-set v1",
"expectedStateRevision": "current assignment-set state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "immutable assignment version and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.decision.create
Tool reference · execute_v2_application_decision
{
"permission": "admin",
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"mode": "atomic_context_write",
"idempotencyRequired": true,
"arguments": {
"decisionId": "stable ID",
"title": "1–200 UTF-8 bytes",
"text": "1–8000 UTF-8 bytes",
"provenance": "UserDecision or AgentInterpretation"
},
"optionalArguments": {
"rationale": "up to 2000 UTF-8 bytes",
"sourceReference": "up to 1000 UTF-8 bytes; plain text"
},
"result": "immutable version 1 and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.decision.history
Tool reference · read_v2_program
{
"permission": "admin",
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"mode": "read_only",
"idempotencyRequired": false,
"arguments": {
"decisionId": "stable ID"
},
"optionalArguments": {
"limit": "1–100; default 25",
"afterVersion": "keyset cursor",
"expectedVersion": "required with cursor; pins current head"
},
"result": "bounded immutable versions, currentVersion and nextAfterVersion"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.decision.list
Tool reference · read_v2_program
{
"permission": "admin",
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"mode": "read_only",
"idempotencyRequired": false,
"arguments": {},
"optionalArguments": {
"limit": "1–100; default 25",
"afterDecisionId": "keyset cursor",
"expectedDecisionRevision": "required with cursor"
},
"result": "bounded current summaries, decisionRevision and nextAfterDecisionId"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.decision.read
Tool reference · read_v2_program
{
"permission": "admin",
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"mode": "read_only",
"idempotencyRequired": false,
"arguments": {
"decisionId": "stable ID"
},
"optionalArguments": {
"version": "exact version; current by default"
},
"result": "decision content and server attribution"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.decision.revise
Tool reference · execute_v2_application_decision
{
"permission": "admin",
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"mode": "atomic_context_write",
"idempotencyRequired": true,
"arguments": {
"decisionId": "stable ID",
"expectedVersion": "current version",
"title": "1–200 UTF-8 bytes",
"text": "1–8000 UTF-8 bytes",
"provenance": "UserDecision or AgentInterpretation"
},
"optionalArguments": {
"rationale": "up to 2000 UTF-8 bytes",
"sourceReference": "up to 1000 UTF-8 bytes; plain text"
},
"result": "new Active immutable version and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.decision.withdraw
Tool reference · execute_v2_application_decision
{
"permission": "admin",
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"mode": "atomic_context_write",
"idempotencyRequired": true,
"arguments": {
"decisionId": "stable ID",
"expectedVersion": "current version"
},
"result": "new Withdrawn version preserving content and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.operation.receipt.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"operationId": "exact application operation identity"
},
"result": "bounded receipt identity, actor, revision, time and safe outcome summary",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.rule.run
Tool reference · execute_v2_expression_rule_program
{
"workClass": "long",
"previewRequired": false,
"mode": "durable_workflow",
"permission": "rule_run",
"idempotencyRequired": true,
"arguments": {
"ruleId": "published application rule ID"
},
"optionalArguments": {
"bindings": "exact values for every declared typed runtime parameter",
"expectedVersion": "exact inspected active version; required with expectedProgramDigest for source-bound rules",
"expectedProgramDigest": "exact inspected compiled digest"
},
"result": "durable rule workflow with binding digest and checkpoint receipts",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.rule.run.cancel
Tool reference · execute_v2_expression_rule_program
{
"workClass": "short",
"previewRequired": false,
"mode": "technical_control",
"permission": "rule_run",
"idempotencyRequired": true,
"arguments": {
"workflowId": "caller-owned workflow ID"
},
"result": "cancellation state; committed effects remain",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.rule.run.read
Tool reference · read_v2_program
{
"workClass": "short",
"previewRequired": false,
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"workflowId": "caller-owned workflow ID"
},
"result": "durable workflow, sealed child/receipt lineage and dependency freshness",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.rule.run.reconcile
Tool reference · execute_v2_expression_rule_program
{
"workClass": "short",
"previewRequired": false,
"mode": "technical_control",
"permission": "rule_run",
"idempotencyRequired": true,
"arguments": {
"workflowId": "needs-inspection workflow ID"
},
"result": "durable child inspection and safe resume state",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.rule.version.list
Tool reference · read_v2_program
{
"workClass": "short",
"previewRequired": false,
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {},
"optionalArguments": {
"limit": "1-100",
"afterRuleId": "stable keyset cursor",
"expectedMetadataRevision": "required with afterRuleId",
"expectedPolicyRevision": "required with afterRuleId"
},
"result": "bounded published application-rule summaries",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.rule.version.read
Tool reference · read_v2_program
{
"workClass": "short",
"previewRequired": false,
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"ruleId": "stable ID"
},
"optionalArguments": {
"version": "exact immutable version; omit to read the current publication"
},
"result": "immutable definition and publication state",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.state.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"arguments": {},
"result": "application status and current metadata/data/policy/security/capability/schema/commit revision pins; no application mode or domain capability semantics",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.workflow.activity.complete
Tool reference · execute_v2_application_workflow_occurrence
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"idempotencyRequired": true,
"permission": "read",
"mode": "atomic_workflow_transition",
"arguments": {
"occurrenceId": "stable occurrence ID",
"activityId": "stable activity ID",
"expectedActivityVersion": "current activity version",
"evidence": "typed configured evidence reference"
},
"result": "receipt-backed activity transition"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.workflow.activity.return
Tool reference · execute_v2_application_workflow_occurrence
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"idempotencyRequired": true,
"permission": "read",
"mode": "atomic_workflow_transition",
"arguments": {
"occurrenceId": "stable occurrence ID",
"activityId": "stable review activity ID",
"expectedActivityVersion": "current activity version",
"reason": "bounded return reason"
},
"result": "receipt-backed return and invalidation transition"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.workflow.deactivate
Tool reference · execute_v2_application_workflow
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "admin",
"idempotencyRequired": true,
"mode": "atomic_policy_write",
"arguments": {
"flowId": "stable workflow ID",
"expectedStateRevision": "current workflow state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "inactive workflow pointer and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.workflow.list
Tool reference · execute_v2_application_workflow, read_v2_program
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "read",
"idempotencyRequired": false,
"mode": "read",
"arguments": {},
"optionalArguments": {
"limit": "1-100",
"afterFlowId": "keyset cursor"
},
"result": "bounded latest workflow definitions"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.workflow.occurrence.cancel
Tool reference · execute_v2_application_workflow_occurrence
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"idempotencyRequired": true,
"permission": "admin",
"mode": "atomic_workflow_transition",
"arguments": {
"occurrenceId": "stable occurrence ID",
"expectedOccurrenceVersion": "current occurrence version"
},
"result": "receipt-backed occurrence cancellation"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.workflow.occurrence.read
Tool reference · execute_v2_application_workflow_occurrence, read_v2_program
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "read",
"idempotencyRequired": false,
"mode": "read",
"arguments": {
"occurrenceId": "stable occurrence ID"
},
"optionalArguments": {
"eventLimit": "1-500",
"afterEventOrdinal": "nonnegative event cursor"
},
"result": "occurrence, activities and bounded event page"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.workflow.occurrence.start
Tool reference · execute_v2_application_workflow_occurrence
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"idempotencyRequired": true,
"permission": "admin",
"mode": "atomic_workflow_transition",
"arguments": {
"flowId": "stable workflow ID",
"version": "exact immutable version",
"expectedStateRevision": "current workflow state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "durable occurrence and initial Ready activities"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.workflow.publish
Tool reference · execute_v2_application_workflow
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "admin",
"idempotencyRequired": true,
"mode": "atomic_policy_write",
"arguments": {
"flowId": "stable workflow ID",
"version": "exact immutable version",
"expectedStateRevision": "current workflow state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "active workflow pointer and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.workflow.read
Tool reference · execute_v2_application_workflow, read_v2_program
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "read",
"idempotencyRequired": false,
"mode": "read",
"arguments": {
"flowId": "stable workflow ID"
},
"optionalArguments": {
"version": "exact immutable version"
},
"result": "verified workflow definition and publication state"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}application.workflow.save
Tool reference · execute_v2_application_workflow
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "admin",
"idempotencyRequired": true,
"mode": "immutable_workflow_write",
"arguments": {
"definition": "canonical application-task-flow v2",
"expectedStateRevision": "current workflow state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "immutable workflow version and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}application.workflow.worklist
Tool reference · execute_v2_application_workflow_occurrence, read_v2_program
{
"previewRequired": false,
"workClass": "short",
"requiredCapabilities": [],
"permission": "read",
"idempotencyRequired": false,
"mode": "read",
"arguments": {},
"optionalArguments": {
"limit": "1-100",
"afterOccurrenceId": "keyset cursor",
"afterActivityId": "paired keyset cursor"
},
"result": "currently assigned Ready activities"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}calculated.member.evaluate
Tool reference · read_v2_program
{
"previewRequired": false,
"workClass": "short",
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"definitionId": "current published dynamic definition"
},
"optionalArguments": {
"expectedVersion": "exact inspected active version; required with expectedProgramDigest for source-bound definitions",
"expectedProgramDigest": "exact inspected compiled digest"
},
"result": "bounded typed rows evaluated in one read snapshot",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}calculated.member.materialize
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_calculation",
"permission": "write",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"arguments": {
"definitionId": "current published materialized definition"
},
"optionalArguments": {
"expectedVersion": "exact inspected active version; required with expectedProgramDigest for source-bound definitions",
"expectedProgramDigest": "exact inspected compiled digest"
},
"result": "immutable exact generation and atomic result publication",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}calculated.member.version.list
Tool reference · read_v2_program
{
"previewRequired": false,
"workClass": "short",
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {},
"optionalArguments": {
"limit": "1-100",
"afterDefinitionId": "stable keyset cursor",
"expectedMetadataRevision": "cursor metadata revision",
"expectedPolicyRevision": "cursor policy revision"
},
"result": "bounded current calculated-member publications",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}calculated.member.version.read
Tool reference · read_v2_program
{
"previewRequired": false,
"workClass": "short",
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"definitionId": "definition identity"
},
"optionalArguments": {
"version": "positive immutable version"
},
"result": "definition and publication state",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}cube.aggregate.cancel
Tool reference · read_v2_program
{
"permission": "read",
"previewRequired": false,
"mode": "technical_control",
"workClass": "short",
"idempotencyRequired": false,
"arguments": {
"queryId": "accepted generic aggregate query"
},
"result": "durable cancellation state",
"requiredCapabilities": []
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "authorized_status_read_before_new_intent",
"reconciliation": {
"strategy": "call_authorized_status_function",
"function": "cube.aggregate.read"
}
}cube.aggregate.lineage.read
Tool reference · read_v2_program
{
"permission": "read",
"previewRequired": false,
"mode": "read",
"workClass": "short",
"idempotencyRequired": false,
"arguments": {
"queryId": "accepted placement aggregate query"
},
"result": "immutable exact placement paths and effective operators",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}cube.aggregate.read
Tool reference · read_v2_program
{
"permission": "read",
"previewRequired": false,
"mode": "read",
"workClass": "short",
"idempotencyRequired": false,
"arguments": {
"queryId": "accepted generic aggregate query"
},
"optionalArguments": {
"cursor": "signed continuation cursor",
"pageSize": "1-500"
},
"result": "durable status or bounded exact result page",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}cube.aggregate.request
Tool reference · read_v2_program
{
"permission": "read",
"previewRequired": false,
"mode": "durable_technical_query",
"workClass": "medium",
"idempotencyRequired": false,
"arguments": {
"selectionId": "current sealed selection identity",
"groupBy": "output dimensions",
"reduceDimensions": "reduced dimensions",
"measures": "sum and/or count_present",
"membershipSemantics": "unique_member or placement",
"memberOperatorPolicy": "configured",
"missing": "exclude"
},
"optionalArguments": {
"limits": "lower aggregate execution budgets"
},
"result": "durable generic aggregate query identity",
"requiredCapabilities": []
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "authorized_status_read_before_new_intent",
"reconciliation": {
"strategy": "call_authorized_status_function",
"function": "cube.aggregate.read"
}
}cube.selection.preview
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"workClass": "short",
"previewRequired": false,
"idempotencyRequired": false,
"arguments": {
"selection": "complete-grain openepm-cube-selection-v1",
"expectedPolicyRevision": "current authorization policy revision"
},
"result": "resolved member IDs, reusable-list pins and resolution digest",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}cube.selection.read
Tool reference · read_v2_program
{
"permission": "read",
"workClass": "short",
"previewRequired": false,
"mode": "read",
"idempotencyRequired": false,
"arguments": {
"selectionId": "sealed selection identity"
},
"result": "current authorized unexpired sealed selection",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}cube.selection.seal
Tool reference · read_v2_program
{
"permission": "read",
"workClass": "short",
"previewRequired": false,
"mode": "technical_artifact_write",
"idempotencyRequired": true,
"arguments": {
"selectionId": "caller-stable 8-200 character request identity",
"selection": "complete-grain openepm-cube-selection-v1",
"expectedPolicyRevision": "current authorization policy revision",
"ttlSeconds": "60-3600"
},
"result": "durable subject-bound resolved selection artifact",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}cube.write.policy.deactivate
Tool reference · execute_v2_cube_write_policy
{
"permission": "admin",
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_policy_write",
"idempotencyRequired": true,
"arguments": {
"policyId": "currently active policy ID",
"version": "currently active version",
"expectedPointerVersion": "current positive pointer version"
},
"result": "inactive policy pointer and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}cube.write.policy.list
Tool reference · execute_v2_cube_write_policy
{
"permission": "admin",
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read",
"idempotencyRequired": false,
"arguments": {
"limit": "optional 1-100",
"afterPolicyId": "optional composite cursor policy ID",
"afterVersion": "optional composite cursor version"
},
"result": "verified policy versions and composite cursor"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}cube.write.policy.publish
Tool reference · execute_v2_cube_write_policy
{
"permission": "admin",
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_policy_write",
"idempotencyRequired": true,
"arguments": {
"policyId": "stable policy ID",
"version": "positive immutable version",
"expectedPointerVersion": "current nonnegative pointer version"
},
"result": "active policy pointer and receipt"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}cube.write.policy.read
Tool reference · execute_v2_cube_write_policy
{
"permission": "admin",
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read",
"idempotencyRequired": false,
"arguments": {
"policyId": "stable policy ID",
"version": "positive immutable version"
},
"result": "verified immutable definition"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}cube.write.policy.save
Tool reference · execute_v2_cube_write_policy
{
"permission": "admin",
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "immutable_policy_write",
"idempotencyRequired": false,
"arguments": {
"definition": "bounded exact planning workflow policy definition"
},
"result": "immutable policy version and canonical digest"
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "authorized_named_version_read",
"reconciliation": {
"strategy": "call_authorized_status_function",
"function": "cube.write.policy.read"
}
}cube.write.scope.approve
Tool reference · preview_v2_program, apply_v2_cube_write_scope_transition
{
"mode": "reviewed_workflow_write",
"permission": "admin",
"arguments": {
"lockId": "submission lock ID",
"expectedSubmissionVersion": "current version",
"reason": "required decision reason",
"idempotencyKey": "8–128 safe characters"
},
"result": "approved submission, locked slice and receipt",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}cube.write.scope.lock
Tool reference · preview_v2_program, apply_v2_cube_write_scope_transition
{
"mode": "reviewed_policy_write",
"permission": "admin",
"arguments": {
"scopeMembers": "stable-ID equality filter",
"scopeAll": "explicit whole-application flag",
"reason": "required audit reason",
"idempotencyKey": "8–128 safe characters"
},
"result": "locked slice, policy revision and receipt",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}cube.write.scope.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"lockId": "server-issued lock ID"
},
"result": "exact lock scope and status",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}cube.write.scope.reopen
Tool reference · preview_v2_program, apply_v2_cube_write_scope_transition
{
"mode": "reviewed_policy_write",
"permission": "admin",
"arguments": {
"lockId": "server-issued lock ID",
"expectedLockVersion": "current version",
"reason": "required audit reason",
"idempotencyKey": "8–128 safe characters"
},
"result": "open slice, policy revision and receipt",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}cube.write.scope.submit
Tool reference · preview_v2_program, apply_v2_cube_write_scope_transition
{
"mode": "reviewed_workflow_write",
"permission": "write",
"arguments": {
"scopeMembers": "stable-ID equality filter",
"scopeAll": "explicit whole-application flag",
"reviewerIssuer": "verified reviewer issuer",
"reviewerSubjectId": "assigned administrator",
"reason": "required submission reason",
"idempotencyKey": "8–128 safe characters"
},
"result": "submitted, locked slice and assigned reviewer",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}cube.write.scope.worklist
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"limit": "optional 1–100, default 100",
"afterLockId": "optional prior page lock ID",
"includeResolved": "optional boolean, default false"
},
"result": "current verified-principal cube write-scope submissions",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}execution.delegation.create
Tool reference · execute_v2_execution_delegation
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_security_write",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"delegationId": "stable ID",
"version": "next positive version",
"issuer": "verified execution issuer",
"subjectId": "verified execution subject",
"operationScope": "1-32 exact function names",
"validFrom": "UTC timestamp",
"validUntil": "UTC timestamp",
"scheduleId": "exact schedule ID, or null for an unbound delegation",
"scheduleVersion": "exact schedule version, or null for an unbound delegation",
"expectedMetadataRevision": "current integer",
"expectedPolicyRevision": "current integer",
"expectedSchemaEpoch": "current integer"
},
"result": "immutable active delegation version"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}execution.delegation.list
Tool reference · read_v2_program
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read_only",
"permission": "admin",
"idempotencyRequired": false,
"arguments": {
"limit": "1-100",
"afterDelegationId": "optional keyset"
},
"result": "bounded delegation page"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}execution.delegation.read
Tool reference · read_v2_program
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read_only",
"permission": "admin",
"idempotencyRequired": false,
"arguments": {
"delegationId": "stable ID"
},
"result": "current delegation without credentials"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}execution.delegation.revoke
Tool reference · execute_v2_execution_delegation
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_security_write",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"delegationId": "stable ID",
"version": "current active version",
"expectedMetadataRevision": "current integer",
"expectedPolicyRevision": "current integer",
"expectedSchemaEpoch": "current integer"
},
"result": "revoked delegation"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.calculation.publication.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"limit": "optional 1–100",
"afterResultKey": "optional stable keyset cursor"
},
"result": "bounded current immutable-publication catalogue",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.calculation.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"resultKey": "named output publication"
},
"result": "published generation and bounded exact rows",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.calculation.scan
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"resultKey": "named output publication",
"members": "stable-ID equality filters",
"limit": "1–500",
"cursor": "opaque signed continuation"
},
"result": "generation-pinned calculated page",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.cube.aggregate.cancel
Tool reference · read_v2_program
{
"mode": "technical_control",
"permission": "read",
"arguments": {
"queryId": "accepted aggregate query ID"
},
"result": "durable cancellation state; no business revision or receipt",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "authorized_status_read_before_new_intent",
"reconciliation": {
"strategy": "call_authorized_status_function",
"function": "facts.cube.aggregate.read"
}
}facts.cube.aggregate.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"arguments": {
"queryId": "accepted aggregate query ID"
},
"optionalArguments": {
"cursor": "signed subject-bound continuation cursor",
"pageSize": "1–500 rows, fixed by the first page"
},
"result": "durable status or one bounded persisted result page with a technical query certificate; never a business receipt",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.cube.aggregate.request
Tool reference · read_v2_program
{
"mode": "durable_technical_query",
"permission": "read",
"arguments": {
"query": "bounded raw numeric aggregate intent"
},
"optionalArguments": {
"limits": "lower maxGroups, maxResultBytes, pageSize and ttlSeconds budgets"
},
"result": "durable ready query ID; a technical worker computes asynchronously without a business receipt or revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "medium",
"requiredCapabilities": []
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "authorized_status_read_before_new_intent",
"reconciliation": {
"strategy": "call_authorized_status_function",
"function": "facts.cube.aggregate.read"
}
}facts.cube.layer-report.scan
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"members": "optional stable-ID equality filters",
"snapshotRevision": "optional committed raw/journal snapshot",
"resultKey": "one current untyped calculated publication",
"expectedPublishedRevision": "required current publication revision",
"limit": "1–500",
"cursor": "opaque signed complete continuation"
},
"result": "separate raw, manualJournal, adjusted and pinned calculated layers; no inferred final balance",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.cube.scan
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"members": "stable-ID equality filters",
"limit": "1–500",
"cursor": "opaque signed continuation",
"snapshotRevision": "optional committed revision on the first page",
"includeMissing": "optional boolean, retain raw event tombstones"
},
"result": "snapshot-pinned raw numeric/text page; includeMissing retains raw event tombstones, excluding calculated/journal-only coordinates",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.cube.select
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"grain": {
"type": "object",
"properties": {
"mode": {
"const": "full_coordinate"
},
"dimensions": {
"type": "array",
"minItems": 1,
"maxItems": 128,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"mode",
"dimensions"
],
"additionalProperties": false
},
"selectors": {
"type": "object",
"minProperties": 1,
"maxProperties": 16,
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"additionalProperties": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"const": "Members"
},
"memberIds": {
"type": "array",
"minItems": 1,
"maxItems": 500,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"kind",
"memberIds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"enum": [
"Descendants",
"Children",
"Leaves"
]
},
"rootMemberId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hierarchyVersion": {
"oneOf": [
{
"const": "active"
},
{
"type": "integer",
"minimum": 1
}
]
},
"includeSelf": {
"type": "boolean"
}
},
"required": [
"kind",
"rootMemberId",
"hierarchyVersion",
"includeSelf"
],
"additionalProperties": false
}
]
}
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"includeMissing": {
"type": "boolean"
},
"snapshotRevision": {
"type": "integer",
"minimum": 0
}
},
"result": "unaggregated exact source rows, explicit full grain, metadata/snapshot/hierarchy pins, bounded page and signed continuation",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "bounded_read",
"programContract": {
"version": 1,
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"languageVersion": {
"type": "integer",
"const": 2
},
"function": {
"const": "facts.cube.select"
},
"arguments": {
"oneOf": [
{
"type": "object",
"properties": {
"grain": {
"type": "object",
"properties": {
"mode": {
"const": "full_coordinate"
},
"dimensions": {
"type": "array",
"minItems": 1,
"maxItems": 128,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"mode",
"dimensions"
],
"additionalProperties": false
},
"selectors": {
"type": "object",
"minProperties": 1,
"maxProperties": 16,
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"additionalProperties": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"const": "Members"
},
"memberIds": {
"type": "array",
"minItems": 1,
"maxItems": 500,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"kind",
"memberIds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"enum": [
"Descendants",
"Children",
"Leaves"
]
},
"rootMemberId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hierarchyVersion": {
"oneOf": [
{
"const": "active"
},
{
"type": "integer",
"minimum": 1
}
]
},
"includeSelf": {
"type": "boolean"
}
},
"required": [
"kind",
"rootMemberId",
"hierarchyVersion",
"includeSelf"
],
"additionalProperties": false
}
]
}
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"includeMissing": {
"type": "boolean"
},
"snapshotRevision": {
"type": "integer",
"minimum": 0
}
},
"required": [
"grain",
"selectors"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"cursor": {
"type": "string",
"maxLength": 65536
}
},
"required": [
"cursor"
],
"additionalProperties": false
}
]
}
},
"required": [
"languageVersion",
"function",
"arguments"
],
"additionalProperties": false
},
"resultSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"rows": {
"type": "array",
"maxItems": 500,
"items": {
"type": "object",
"properties": {
"seriesKey": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"members": {
"type": "object",
"minProperties": 1,
"additionalProperties": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"kind": {
"enum": [
"numeric",
"text",
"missing"
]
},
"present": {
"type": "boolean"
},
"amount": {
"type": [
"string",
"null"
]
},
"text": {
"type": [
"string",
"null"
]
},
"changeId": {
"type": "string"
},
"numericChangeId": {
"type": "string"
},
"textChangeId": {
"type": "string"
},
"lastRevision": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"required": [
"seriesKey",
"members",
"kind",
"present",
"amount",
"text",
"changeId",
"numericChangeId",
"textChangeId",
"lastRevision"
],
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"kind": {
"const": "numeric"
}
}
},
"then": {
"properties": {
"present": {
"const": true
},
"amount": {
"type": "string"
},
"text": {
"type": "null"
}
}
}
},
{
"if": {
"properties": {
"kind": {
"const": "text"
}
}
},
"then": {
"properties": {
"present": {
"const": true
},
"amount": {
"type": "null"
},
"text": {
"type": "string"
}
}
}
},
{
"if": {
"properties": {
"kind": {
"const": "missing"
}
}
},
"then": {
"properties": {
"present": {
"const": false
},
"amount": {
"type": "null"
},
"text": {
"type": "null"
}
}
}
}
]
}
},
"hasMore": {
"type": "boolean"
},
"nextCursor": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"postgres_current",
"postgres_event_history"
]
},
"grain": {
"type": "object",
"properties": {
"mode": {
"const": "full_coordinate"
},
"dimensions": {
"type": "array",
"minItems": 1,
"maxItems": 128,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"mode",
"dimensions"
],
"additionalProperties": false
},
"metadataRevision": {
"type": "integer",
"minimum": 0
},
"snapshotRevision": {
"type": "integer",
"minimum": 0
},
"hierarchyVersions": {
"type": "object",
"additionalProperties": {
"type": "integer",
"minimum": 1
}
},
"selectedMemberCounts": {
"type": "object",
"additionalProperties": {
"type": "integer",
"minimum": 0,
"maximum": 5000
}
},
"aggregation": {
"const": "none"
},
"profileVersion": {
"const": 1
}
},
"required": [
"rows",
"hasMore",
"nextCursor",
"source",
"grain",
"metadataRevision",
"snapshotRevision",
"hierarchyVersions",
"selectedMemberCounts",
"aggregation",
"profileVersion"
],
"additionalProperties": false
},
"semanticRules": [
"Selectors form AND across axes and set membership within an axis; no aggregation, Cartesian expansion or duplicate source cell for shared paths.",
"grain dimensions must equal all active fact axes except Currency; stable canonical IDs only. Counts are strict integers, never booleans/decimal tokens.",
"Members require active IDs. Hierarchy selector roots/versions are scoped to this application/axis and built at current metadata revision. Stale hierarchy versions fail; no implicit rebuild.",
"Descendants excludes root unless includeSelf. Children means minimum depth1 plus root when includeSelf. Leaves have no proper descendants in the immutable version; includeSelf matters when root is itself a leaf.",
"First active hierarchy resolves once; cursor pins that immutable version despite same-metadata rebuild. Any metadata revision change rejects continuation. Data changes reconstruct the original committed snapshot from events.",
"Limits:16 selector axes,128 full-grain axes,500 explicit IDs total,16KB normalized intent,5000 resolved members/axis and10000 total,1–500 rows/page,5s SQL stages and shorter inherited limits. Cursor expires1h from first page and binds identity/scope/profile/intent/pins/page size.",
"Continuation arguments are cursor only. Each page rechecks current read authority. includeMissing exposes numeric/text event tombstones, not a synthetic full metadata Cartesian product or calculated-only coordinates. Present zero and empty text remain distinct.",
"This profile reads raw numeric/text source state, including numeric supporting-detail totals. Calculation generations, merged financial layers and accounting placement rollups are separate functions."
],
"examples": [
{
"id": "leaves-at-full-grain",
"program": {
"languageVersion": 2,
"function": "facts.cube.select",
"arguments": {
"grain": {
"mode": "full_coordinate",
"dimensions": [
"Metric"
]
},
"selectors": {
"Metric": {
"kind": "Leaves",
"rootMemberId": "Total",
"hierarchyVersion": "active",
"includeSelf": false
}
},
"limit": 100
}
},
"prerequisites": "Fresh generic Metric axis with Total→A and Total→B, current metadata hierarchy built through metadata.hierarchy.build, and authorized numeric/text values at A/B."
}
],
"execution": {
"tool": "read_v2_program",
"scope": "Bound application or router with workspace_id/application_id",
"continuation": "Use unchanged nextCursor as sole arguments.cursor; no new selectors or limit."
}
},
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.export.page
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"members": "stable-ID equality filters",
"limit": "1–50 typed rows",
"cursor": "opaque signed continuation, omit members and snapshotRevision when supplied",
"snapshotRevision": "optional committed revision"
},
"result": "snapshot-pinned AmountLiteral/TextLiteral/LineDetailLiteral source rows",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.expression.calculate
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_calculation",
"permission": "write",
"arguments": {
"sourceMembers": "stable-ID equality filters",
"expression": "bounded typed arithmetic tree: SourceAmount, SourceValue(memberOverrides, measureDimensionId, valueType amount or ratio matching active member numericValueKind) for present raw driver cells, PublishedAmount or PublishedRatio(resultKey, optional memberOverrides), AmountLiteral, RatioLiteral, Add, Subtract, Multiply, Divide(nonzero ratio or amount/amount deriving ratio), Compare(same unit; eq/ne/lt/le/gt/ge), If(boolean test, same-unit branches); dynamic division is not allowed inside Compare, zero denominators fail preview and worker publication, and lookup cells are required at each selected full coordinate",
"resultKey": "named output publication"
},
"optionalArguments": {
"sourceMemberSets": "bounded explicit stable member IDs on selected source dimensions; combines with sourceMembers and is sealed into the compiler plan without caller cell enumeration",
"SourceTextPredicate": "v28 boolean expression node allowed as If.test: exact eq/ne against one present raw text cell selected by memberOverrides, UTF-8 text length <=32768 and missingPolicy='error'; present empty text remains distinct from missing; numeric and text raw lookups share an eight-lookup bound",
"targetMembers": "1–4 active target member IDs on axes fixed by sourceMembers; set-based result coordinates are materialized in the effect transaction",
"resultUnit": "exact {'type':'Ratio','scale':12} required only when the expression result is Ratio; target Measure member must declare numericValueKind ratio",
"reduceSelection": "v26 alternative to enumerated reduceMemberSet: exactly one non-Currency dimension with kind Children, Descendants or Leaves; explicit active hierarchyVersion; membershipSemantics UniqueMember; rootMemberId; distinct targetMemberId; measures exactly ['SumAmount','CountPresent'] or ['AverageAmount','CountPresent']; trusted preview resolves and seals at most 100 active unique members and therefore at most 100 present full-grain sources",
"reduceSelections": "v27 alternative with exactly two distinct non-Currency dimensions; each selector has explicit current hierarchyVersion, Children/Descendants/Leaves, UniqueMember, root and target; measures are SumAmount+CountPresent or AverageAmount+CountPresent; trusted preview seals <=100 members per axis and <=500 present cartesian sources",
"contextDependencies": "v32 bounded OwnershipValue and CalendarPeriod current-source pins, resolved and sealed by the fixed core; requires contextAssertions",
"contextAssertions": "v32 bounded boolean audit claims whose assurance must remain CallerDeclaredUnverified; assertions never select policy, authorize effects, or alter arithmetic"
},
"sealedEvidence": "v26 preview returns the exact admitted sealedProgram, explicit hierarchy and metadata pins, sorted resolved members, membership and fact-layout digests, distinct present-source count and grouped-output count; complete fixed non-reduced grain permits exactly zero or one output intersection",
"result": "immutable exact Amount or scale-12 Ratio generation and atomic publication with pinned published-input provenance and optional target coordinate mapping; v26 hierarchy reductions expose selector context, CountPresent lineage and publish zero or one output intersection without caller cell enumeration",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.generic.table.create
Tool reference · execute_v2_generic_fact_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"name": "unique application-local name",
"shortDescription": "text up to 500 characters",
"semanticDefinition": "text up to 2000 characters",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "new table ID and atomic metadata receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.generic.table.delete
Tool reference · execute_v2_generic_fact_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"tableId": "registered generic table ID",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "retired empty table with retained event provenance",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.generic.table.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"afterTableId": "optional exclusive table ID",
"limit": "1–100"
},
"result": "bounded table page",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.generic.table.update
Tool reference · execute_v2_generic_fact_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"tableId": "registered generic table ID",
"name": "unique application-local name",
"shortDescription": "text up to 500 characters",
"semanticDefinition": "text up to 2000 characters",
"status": "Active or Inactive",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "updated table and atomic metadata receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.generic.value.bulk
Tool reference · execute_v2_generic_fact_program
{
"mode": "atomic_write",
"permission": "write",
"arguments": {
"tableId": "registered generic table ID",
"changes": "1–100 distinct Set/Delete series changes",
"expectedDataRevision": "initially current nonnegative integer; later disjoint commits are revalidated"
},
"result": "one revision and receipt for all value events",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.generic.value.delete
Tool reference · execute_v2_generic_fact_program
{
"mode": "atomic_write",
"permission": "write",
"arguments": {
"tableId": "registered generic table ID",
"seriesKey": "opaque key up to 1000 characters",
"expectedChangeId": "current change ID",
"expectedDataRevision": "initially current nonnegative integer; later disjoint commits are revalidated"
},
"result": "deletion and atomic data/event receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.generic.value.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"tableId": "registered generic table ID",
"seriesKey": "opaque key"
},
"result": "current value and change ID or explicit absence",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.generic.value.scan
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"tableId": "registered generic table ID",
"afterSeriesKey": "optional exclusive key",
"limit": "1–200"
},
"result": "bounded current-value page",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.generic.value.set
Tool reference · execute_v2_generic_fact_program
{
"mode": "atomic_write",
"permission": "write",
"arguments": {
"tableId": "registered generic table ID",
"seriesKey": "opaque key up to 1000 characters",
"value": "finite non-null JSON up to 100000 characters",
"expectedChangeId": "current change ID or empty",
"expectedDataRevision": "initially current nonnegative integer; later disjoint commits are revalidated"
},
"result": "new change ID and atomic data/event receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.generic.value.snapshot.scan
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"tableId": "registered generic table ID",
"limit": "1–200",
"cursor": "null initially, then signed page cursor"
},
"result": "bounded page pinned to one committed revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"dataModel": "application_non_dimensional_json",
"authorizationModel": "application_grant_and_rls",
"dimensionalSecurity": "not_applicable_no_cube_coordinate",
"planningControlModel": "synthetic_guard_coordinate_only",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.line-detail.replace
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "write",
"arguments": {
"coordinate": "one full stable-ID coordinate",
"items": "0–500 exact description/amount rows",
"expectedCellChangeId": "current numeric total CAS identity",
"expectedDetailChangeId": "current supporting-detail CAS identity"
},
"result": "jobId then one atomic detail-plus-total receipt",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.numeric.adjusted.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"members": "one full finance coordinate",
"snapshotRevision": "optional committed revision"
},
"result": "raw numeric source plus manual journal adjustment",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.numeric.adjusted.scan
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"members": "stable-ID equality filters",
"limit": "1–500",
"cursor": "opaque signed continuation",
"snapshotRevision": "optional committed revision"
},
"result": "paged raw numeric plus manual-journal adjustments",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.numeric.batch
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "write",
"arguments": {
"mutations": "1–500 typed Set/Add/Clear rows"
},
"result": "jobId then atomic receipt",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.numeric.iterate
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "write",
"arguments": {
"statements": "1–500 ordered set/add/clear at full coordinates, first touch has expectedChangeId",
"rounding": "half_even_8",
"convergence": {
"mode": "absolute_delta",
"tolerance": {
"type": "AmountLiteral",
"decimal": "nonnegative exact amount"
},
"maxIterations": "1–128",
"onNonConvergence": "fail"
}
},
"workBound": "8192 executed statements,32768 instructions,16MB expanded program;20s compute/native SQL budget,shorter inherited limits preserved",
"semantics": "each prior final vector seeds next iteration; earlier statement indices reset; all target presence and final deltas must match criterion",
"result": "diagnostics and admissionAllowed; non-convergence has no previewToken; success admits one atomic job and retains all iteration statement events",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"programContract": {
"version": 1,
"validationScope": "JSON Schema wire structure plus required semanticRules; fixed compiler/core is authoritative",
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"languageVersion": {
"type": "integer",
"const": 2
},
"function": {
"const": "facts.numeric.iterate"
},
"arguments": {
"type": "object",
"properties": {
"statements": {
"$ref": "#/$defs/statements"
},
"rounding": {
"const": "half_even_8"
},
"convergence": {
"type": "object",
"properties": {
"mode": {
"const": "absolute_delta"
},
"tolerance": {
"type": "object",
"properties": {
"type": {
"const": "AmountLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"type",
"decimal"
],
"additionalProperties": false
},
"maxIterations": {
"type": "integer",
"minimum": 1,
"maximum": 128
},
"onNonConvergence": {
"const": "fail"
}
},
"required": [
"mode",
"tolerance",
"maxIterations",
"onNonConvergence"
],
"additionalProperties": false
}
},
"required": [
"statements",
"rounding",
"convergence"
],
"additionalProperties": false
}
},
"required": [
"languageVersion",
"function",
"arguments"
],
"additionalProperties": false,
"$defs": {
"expression": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"const": "CurrentAmount"
}
},
"required": [
"op"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "CurrentPresent"
}
},
"required": [
"op"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "StatementAmount"
},
"statementIndex": {
"type": "integer",
"minimum": 0
}
},
"required": [
"op",
"statementIndex"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "StatementPresent"
},
"statementIndex": {
"type": "integer",
"minimum": 0
}
},
"required": [
"op",
"statementIndex"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "AmountLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"op",
"decimal"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "RatioLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"op",
"decimal"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Add"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Subtract"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Multiply"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Divide"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Compare"
},
"operator": {
"enum": [
"eq",
"ne",
"lt",
"le",
"gt",
"ge"
]
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"operator",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "If"
},
"test": {
"$ref": "#/$defs/expression"
},
"then": {
"$ref": "#/$defs/expression"
},
"else": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"test",
"then",
"else"
],
"additionalProperties": false
}
]
},
"value": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"const": "AmountLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"type",
"decimal"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "StatementValue"
},
"statementIndex": {
"type": "integer",
"minimum": 0
}
},
"required": [
"type",
"statementIndex"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "NumericExpression"
},
"expression": {
"$ref": "#/$defs/expression"
}
},
"required": [
"type",
"expression"
],
"additionalProperties": false
}
]
},
"statement": {
"oneOf": [
{
"type": "object",
"properties": {
"coordinate": {
"type": "object",
"minProperties": 1,
"propertyNames": {
"type": "string",
"minLength": 1
},
"additionalProperties": {
"type": "string",
"minLength": 1
}
},
"expectedChangeId": {
"type": "string",
"maxLength": 200
},
"op": {
"const": "set"
},
"value": {
"$ref": "#/$defs/value"
}
},
"required": [
"coordinate",
"op",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"coordinate": {
"type": "object",
"minProperties": 1,
"propertyNames": {
"type": "string",
"minLength": 1
},
"additionalProperties": {
"type": "string",
"minLength": 1
}
},
"expectedChangeId": {
"type": "string",
"maxLength": 200
},
"op": {
"const": "add"
},
"value": {
"$ref": "#/$defs/value"
}
},
"required": [
"coordinate",
"op",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"coordinate": {
"type": "object",
"minProperties": 1,
"propertyNames": {
"type": "string",
"minLength": 1
},
"additionalProperties": {
"type": "string",
"minLength": 1
}
},
"expectedChangeId": {
"type": "string",
"maxLength": 200
},
"op": {
"const": "clear"
}
},
"required": [
"coordinate",
"op"
],
"additionalProperties": false
}
]
},
"statements": {
"type": "array",
"minItems": 1,
"maxItems": 500,
"items": {
"$ref": "#/$defs/statement"
}
}
}
},
"semanticRules": [
"Unknown object fields are rejected. Counts/revisions/statement indices/languageVersion are strict JSON integers, never booleans or decimal-number tokens such as1.0. Schemas validate structure; the fixed compiler/core remains authoritative.",
"A coordinate maps every active fact dimension except modelRole Currency to one active stable member ID. No omitted axes, wildcards, display names, implicit member sets or invented financial axes. Discover metadata in the target application.",
"On each distinct full coordinate the first statement requires current numeric expectedChangeId, even for Clear; subsequent touches must omit it. Empty string means no numeric event has ever existed, not a previously cleared tombstone. Refresh current IDs and preview for a new intent.",
"Statement indices are zero-based and strictly earlier than the referring statement; the whole ordered array shares history across coordinates. StatementValue/StatementAmount require a present earlier output; StatementPresent safely tests presence. Clear yields missing; Set zero remains present. Add on missing starts at zero.",
"NumericExpression requires explicit rounding half_even_8. Omitting rounding supports only outer AmountLiteral and StatementValue under the original compiler. Clear has no value; Set/Add require an amount-valued result.",
"AmountLiteral/CurrentAmount/StatementAmount are amount; RatioLiteral is ratio; CurrentPresent/StatementPresent are boolean. Current nodes read that coordinate at this statement, including earlier touches. Missing amount reads fail unless guarded by a selected If branch.",
"Add/Subtract require equal numeric types. Multiply permits amount×ratio, ratio×amount or ratio×ratio; amount×amount is rejected. Divide permits amount/ratio→amount, ratio/ratio→ratio, amount/amount→ratio; ratio/amount is rejected. Zero or missing evaluated denominators fail. Compare requires equal numeric types and permits exact dynamic division in either operand.",
"If requires a boolean test and same numeric type for then/else. Both branches must be structurally/type valid; only the selected branch propagates runtime missing/division errors. No standalone boolean literals or logical operators exist in this profile.",
"Each NumericExpression has at most64 nodes and depth12 (root depth0); a typed program has at most2048 expression/value nodes excluding per-statement Publish instructions and500 statements. Every statement result must fit NUMERIC(28,8), even if subsequently cleared.",
"Typed arithmetic uses exact rational PostgreSQL stages; half-even rounding is once at each statement boundary including existing target for Add. Later statements see that rounded amount. SourceAmount, SourceValue, PublishedAmount, SQL, Python, callbacks and arbitrary executable code are unsupported here.",
"Require explicit half_even_8 and convergence:{mode:absolute_delta,tolerance:{type:AmountLiteral,decimal:nonnegative amount string},maxIterations:strict integer1–128,onNonConvergence:fail}. No best-effort final publication.",
"Each previous-final target vector seeds next initial state. Earlier statement indices reset per iteration; Current nodes still see preceding same-iteration writes. No implicit prior-iteration StatementAmount or external source node.",
"Every final target presence must equal its iteration-initial presence and every present amount absolute delta must be<=tolerance in exact PostgreSQL arithmetic. Missing and present zero differ; final rather than intermediate statement values determine convergence.",
"At declared maxIterations reject more than8192 executed statement effects,32768 instructions including Publish, or16MB expanded normalized program.20s computation/staged-publication budget inherits shorter tool/lease time; SQL stages at most5s. This does not certify outer commit acknowledgement or all background DNS/process limits.",
"Nonconvergent preview returns admissionAllowed:false, diagnostics, errorCode NUMERIC_ITERATION_NOT_CONVERGED and no previewToken. It cannot admit work. Success returns signed token, finalValues and per-iteration presenceChanges/maxAbsoluteDelta; worker result retains convergence report and all executed events atomically."
],
"examples": [
{
"id": "bounded-recurrence",
"program": {
"languageVersion": 2,
"function": "facts.numeric.iterate",
"arguments": {
"statements": [
{
"coordinate": {
"Metric": "A"
},
"op": "set",
"expectedChangeId": "",
"value": {
"type": "NumericExpression",
"expression": {
"op": "Add",
"left": {
"op": "AmountLiteral",
"decimal": "100"
},
"right": {
"op": "Multiply",
"left": {
"op": "If",
"test": {
"op": "CurrentPresent"
},
"then": {
"op": "CurrentAmount"
},
"else": {
"op": "AmountLiteral",
"decimal": "0"
}
},
"right": {
"op": "RatioLiteral",
"decimal": "0.1"
}
}
}
}
}
],
"rounding": "half_even_8",
"convergence": {
"mode": "absolute_delta",
"tolerance": {
"type": "AmountLiteral",
"decimal": "0.00000001"
},
"maxIterations": 16,
"onNonConvergence": "fail"
}
}
},
"expectedFinal": {
"A": "111.11111111"
},
"expectedIterations": 11
}
],
"examplePrerequisites": {
"warning": "Synthetic examples; never run blindly in an existing business application.",
"application": "Separate fresh blank application for each data example; saved lifecycle examples share one fresh application. Consolidation disabled.",
"metadata": [
{
"function": "metadata.dimension.create",
"arguments": {
"dimensionId": "Metric",
"name": "Metric",
"modelRole": "Custom",
"expectedMetadataRevision": 0
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "A",
"name": "A",
"expectedMetadataRevision": 1
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "B",
"name": "B",
"expectedMetadataRevision": 2
}
}
],
"snapshot": "Metadata revision3/policy0; no prior numeric events. Saved examples run save→publish→read/list→run; save/publish revisions are examples, use actual current revisions.",
"authority": "Current write; saved lifecycle also needs separate design/publish/run grants. Reader can inspect saved read/list, not execute writes."
},
"execution": {
"previewTool": "preview_v2_program",
"submitTool": "submit_v2_program",
"jobTool": "read_v2_job",
"cancelTool": "cancel_v2_job",
"scope": "application listener is bound; router tools additionally require workspace_id/application_id",
"submission": "Send unchanged program + preview_token from current preview + unique idempotency_key; optional depends_on_job_ids. Use durable jobId to poll. Do not execute statement/iteration loops in the client.",
"snapshot": "Preview writes no data. New admission and publication recheck grants, revisions, CAS, active metadata, planning locks and claim. Re-preview on stale input; never silently rewrite an accepted intent.",
"replay": "Same verified identity/application/key/program/dependency order returns original job without rebasing, even after preview expiry; current write/run authority still required. Changed intent under an existing key conflicts. Cancellation cannot undo committed publication.",
"publication": "All statement events/final cells/receipt/revision/published-job result commit atomically. A failed/cancelled/stale worker cannot publish partial effects."
}
},
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.numeric.scale
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_calculation",
"permission": "write",
"arguments": {
"sourceMembers": "stable-ID equality filters",
"factor": "exact RatioLiteral",
"resultKey": "named output publication"
},
"result": "immutable generation and atomic publication",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.numeric.sequence
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "write",
"effect": "atomic ordered numeric statements",
"arguments": {
"statements": "1–500 ordered set/add/clear statements at full coordinates; first touch requires expectedChangeId; later touches omit it; values are AmountLiteral, earlier present StatementValue or NumericExpression",
"rounding": "omit for original literal/reference v1; half_even_8 required for v2 typed amount/ratio arithmetic, comparisons, If, CurrentAmount/Present and StatementAmount/Present"
},
"workBound": "500 statements/coordinates; expression limits: 64 nodes, depth 12, 2,048 program nodes; exact NUMERIC(28,8)",
"preview": "signed revision/CAS snapshot with intermediate presence/value",
"idempotency": "same identity/scope/key/program returns its job",
"job": "durable queue; one atomic statement/event receipt",
"result": "statementCount, changedCount of distinct targets, committedRevision",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"programContract": {
"version": 1,
"validationScope": "JSON Schema wire structure plus required semanticRules; fixed compiler/core is authoritative",
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"languageVersion": {
"type": "integer",
"const": 2
},
"function": {
"const": "facts.numeric.sequence"
},
"arguments": {
"type": "object",
"properties": {
"statements": {
"$ref": "#/$defs/statements"
},
"rounding": {
"const": "half_even_8"
}
},
"required": [
"statements"
],
"additionalProperties": false
}
},
"required": [
"languageVersion",
"function",
"arguments"
],
"additionalProperties": false,
"$defs": {
"expression": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"const": "CurrentAmount"
}
},
"required": [
"op"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "CurrentPresent"
}
},
"required": [
"op"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "StatementAmount"
},
"statementIndex": {
"type": "integer",
"minimum": 0
}
},
"required": [
"op",
"statementIndex"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "StatementPresent"
},
"statementIndex": {
"type": "integer",
"minimum": 0
}
},
"required": [
"op",
"statementIndex"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "AmountLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"op",
"decimal"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "RatioLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"op",
"decimal"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Add"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Subtract"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Multiply"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Divide"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Compare"
},
"operator": {
"enum": [
"eq",
"ne",
"lt",
"le",
"gt",
"ge"
]
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"operator",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "If"
},
"test": {
"$ref": "#/$defs/expression"
},
"then": {
"$ref": "#/$defs/expression"
},
"else": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"test",
"then",
"else"
],
"additionalProperties": false
}
]
},
"value": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"const": "AmountLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"type",
"decimal"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "StatementValue"
},
"statementIndex": {
"type": "integer",
"minimum": 0
}
},
"required": [
"type",
"statementIndex"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "NumericExpression"
},
"expression": {
"$ref": "#/$defs/expression"
}
},
"required": [
"type",
"expression"
],
"additionalProperties": false
}
]
},
"statement": {
"oneOf": [
{
"type": "object",
"properties": {
"coordinate": {
"type": "object",
"minProperties": 1,
"propertyNames": {
"type": "string",
"minLength": 1
},
"additionalProperties": {
"type": "string",
"minLength": 1
}
},
"expectedChangeId": {
"type": "string",
"maxLength": 200
},
"op": {
"const": "set"
},
"value": {
"$ref": "#/$defs/value"
}
},
"required": [
"coordinate",
"op",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"coordinate": {
"type": "object",
"minProperties": 1,
"propertyNames": {
"type": "string",
"minLength": 1
},
"additionalProperties": {
"type": "string",
"minLength": 1
}
},
"expectedChangeId": {
"type": "string",
"maxLength": 200
},
"op": {
"const": "add"
},
"value": {
"$ref": "#/$defs/value"
}
},
"required": [
"coordinate",
"op",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"coordinate": {
"type": "object",
"minProperties": 1,
"propertyNames": {
"type": "string",
"minLength": 1
},
"additionalProperties": {
"type": "string",
"minLength": 1
}
},
"expectedChangeId": {
"type": "string",
"maxLength": 200
},
"op": {
"const": "clear"
}
},
"required": [
"coordinate",
"op"
],
"additionalProperties": false
}
]
},
"statements": {
"type": "array",
"minItems": 1,
"maxItems": 500,
"items": {
"$ref": "#/$defs/statement"
}
}
}
},
"semanticRules": [
"Unknown object fields are rejected. Counts/revisions/statement indices/languageVersion are strict JSON integers, never booleans or decimal-number tokens such as1.0. Schemas validate structure; the fixed compiler/core remains authoritative.",
"A coordinate maps every active fact dimension except modelRole Currency to one active stable member ID. No omitted axes, wildcards, display names, implicit member sets or invented financial axes. Discover metadata in the target application.",
"On each distinct full coordinate the first statement requires current numeric expectedChangeId, even for Clear; subsequent touches must omit it. Empty string means no numeric event has ever existed, not a previously cleared tombstone. Refresh current IDs and preview for a new intent.",
"Statement indices are zero-based and strictly earlier than the referring statement; the whole ordered array shares history across coordinates. StatementValue/StatementAmount require a present earlier output; StatementPresent safely tests presence. Clear yields missing; Set zero remains present. Add on missing starts at zero.",
"NumericExpression requires explicit rounding half_even_8. Omitting rounding supports only outer AmountLiteral and StatementValue under the original compiler. Clear has no value; Set/Add require an amount-valued result.",
"AmountLiteral/CurrentAmount/StatementAmount are amount; RatioLiteral is ratio; CurrentPresent/StatementPresent are boolean. Current nodes read that coordinate at this statement, including earlier touches. Missing amount reads fail unless guarded by a selected If branch.",
"Add/Subtract require equal numeric types. Multiply permits amount×ratio, ratio×amount or ratio×ratio; amount×amount is rejected. Divide permits amount/ratio→amount, ratio/ratio→ratio, amount/amount→ratio; ratio/amount is rejected. Zero or missing evaluated denominators fail. Compare requires equal numeric types and permits exact dynamic division in either operand.",
"If requires a boolean test and same numeric type for then/else. Both branches must be structurally/type valid; only the selected branch propagates runtime missing/division errors. No standalone boolean literals or logical operators exist in this profile.",
"Each NumericExpression has at most64 nodes and depth12 (root depth0); a typed program has at most2048 expression/value nodes excluding per-statement Publish instructions and500 statements. Every statement result must fit NUMERIC(28,8), even if subsequently cleared.",
"Typed arithmetic uses exact rational PostgreSQL stages; half-even rounding is once at each statement boundary including existing target for Add. Later statements see that rounded amount. SourceAmount, SourceValue, PublishedAmount, SQL, Python, callbacks and arbitrary executable code are unsupported here."
],
"examples": [
{
"id": "ordered-literal-reference-clear",
"program": {
"languageVersion": 2,
"function": "facts.numeric.sequence",
"arguments": {
"statements": [
{
"coordinate": {
"Metric": "A"
},
"op": "set",
"expectedChangeId": "",
"value": {
"type": "AmountLiteral",
"decimal": "100"
}
},
{
"coordinate": {
"Metric": "A"
},
"op": "add",
"value": {
"type": "AmountLiteral",
"decimal": "5"
}
},
{
"coordinate": {
"Metric": "B"
},
"op": "set",
"expectedChangeId": "",
"value": {
"type": "StatementValue",
"statementIndex": 1
}
},
{
"coordinate": {
"Metric": "A"
},
"op": "clear"
}
]
}
},
"expectedFinal": {
"A": null,
"B": "105.00000000"
}
},
{
"id": "ordered-typed-guard",
"program": {
"languageVersion": 2,
"function": "facts.numeric.sequence",
"arguments": {
"statements": [
{
"coordinate": {
"Metric": "A"
},
"op": "set",
"expectedChangeId": "",
"value": {
"type": "NumericExpression",
"expression": {
"op": "Add",
"left": {
"op": "AmountLiteral",
"decimal": "100"
},
"right": {
"op": "Multiply",
"left": {
"op": "If",
"test": {
"op": "CurrentPresent"
},
"then": {
"op": "CurrentAmount"
},
"else": {
"op": "AmountLiteral",
"decimal": "0"
}
},
"right": {
"op": "RatioLiteral",
"decimal": "0.1"
}
}
}
}
}
],
"rounding": "half_even_8"
}
},
"expectedFinal": {
"A": "100.00000000"
}
}
],
"examplePrerequisites": {
"warning": "Synthetic examples; never run blindly in an existing business application.",
"application": "Separate fresh blank application for each data example; saved lifecycle examples share one fresh application. Consolidation disabled.",
"metadata": [
{
"function": "metadata.dimension.create",
"arguments": {
"dimensionId": "Metric",
"name": "Metric",
"modelRole": "Custom",
"expectedMetadataRevision": 0
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "A",
"name": "A",
"expectedMetadataRevision": 1
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "B",
"name": "B",
"expectedMetadataRevision": 2
}
}
],
"snapshot": "Metadata revision3/policy0; no prior numeric events. Saved examples run save→publish→read/list→run; save/publish revisions are examples, use actual current revisions.",
"authority": "Current write; saved lifecycle also needs separate design/publish/run grants. Reader can inspect saved read/list, not execute writes."
},
"execution": {
"previewTool": "preview_v2_program",
"submitTool": "submit_v2_program",
"jobTool": "read_v2_job",
"cancelTool": "cancel_v2_job",
"scope": "application listener is bound; router tools additionally require workspace_id/application_id",
"submission": "Send unchanged program + preview_token from current preview + unique idempotency_key; optional depends_on_job_ids. Use durable jobId to poll. Do not execute statement/iteration loops in the client.",
"snapshot": "Preview writes no data. New admission and publication recheck grants, revisions, CAS, active metadata, planning locks and claim. Re-preview on stale input; never silently rewrite an accepted intent.",
"replay": "Same verified identity/application/key/program/dependency order returns original job without rebasing, even after preview expiry; current write/run authority still required. Changed intent under an existing key conflicts. Cancellation cannot undo committed publication.",
"publication": "All statement events/final cells/receipt/revision/published-job result commit atomically. A failed/cancelled/stale worker cannot publish partial effects."
}
},
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.numeric.transform
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "write",
"arguments": {
"selection": "full grain + member/hierarchy selectors",
"expression": "amount-valued shared numeric expression with CurrentAmount/CurrentPresent",
"expectedMetadataRevision": "nonnegative integer",
"rounding": "half_even_8"
},
"result": "one atomic stored numeric-fact effect; durable job and operation receipt",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "medium",
"programContract": {
"version": 1,
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"languageVersion": {
"type": "integer",
"const": 2
},
"function": {
"const": "facts.numeric.transform"
},
"arguments": {
"type": "object",
"properties": {
"selection": {
"type": "object",
"properties": {
"grain": {
"type": "object",
"properties": {
"mode": {
"const": "full_coordinate"
},
"dimensions": {
"type": "array",
"minItems": 1,
"maxItems": 128,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"mode",
"dimensions"
],
"additionalProperties": false
},
"selectors": {
"type": "object",
"minProperties": 1,
"maxProperties": 16,
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"additionalProperties": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"const": "Members"
},
"memberIds": {
"type": "array",
"minItems": 1,
"maxItems": 500,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"kind",
"memberIds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"enum": [
"Descendants",
"Children",
"Leaves"
]
},
"rootMemberId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hierarchyVersion": {
"type": "integer",
"minimum": 1
},
"includeSelf": {
"type": "boolean"
}
},
"required": [
"kind",
"rootMemberId",
"hierarchyVersion",
"includeSelf"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"grain",
"selectors"
],
"additionalProperties": false
},
"expression": {
"$ref": "#/$defs/expression"
},
"expectedMetadataRevision": {
"type": "integer",
"minimum": 0
},
"rounding": {
"const": "half_even_8"
}
},
"required": [
"selection",
"expression",
"expectedMetadataRevision",
"rounding"
],
"additionalProperties": false
}
},
"required": [
"languageVersion",
"function",
"arguments"
],
"additionalProperties": false,
"$defs": {
"expression": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"const": "CurrentAmount"
}
},
"required": [
"op"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "CurrentPresent"
}
},
"required": [
"op"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "AmountLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"op",
"decimal"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "RatioLiteral"
},
"decimal": {
"type": "string",
"description": "Finite exact decimal string; no JSON number. Amount: at most20 integer digits/8 fractional places. Ratio:8/12. Fixed compiler validates Decimal exponent/range; canonical plain decimal recommended."
}
},
"required": [
"op",
"decimal"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Add"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Subtract"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Multiply"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Divide"
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "Compare"
},
"operator": {
"enum": [
"eq",
"ne",
"lt",
"le",
"gt",
"ge"
]
},
"left": {
"$ref": "#/$defs/expression"
},
"right": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"operator",
"left",
"right"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "If"
},
"test": {
"$ref": "#/$defs/expression"
},
"then": {
"$ref": "#/$defs/expression"
},
"else": {
"$ref": "#/$defs/expression"
}
},
"required": [
"op",
"test",
"then",
"else"
],
"additionalProperties": false
}
]
}
}
},
"semanticRules": [
"Existing numeric facts only; every unmentioned axis and full coordinate is retained.",
"Exact shared amount/ratio expression rules; CurrentAmount reads pinned input, half_even_8 rounds once at the write boundary.",
"Selectors use unique members and explicit sealed hierarchy versions; shared hierarchy paths never duplicate a fact.",
"No selected detail-backed writes, no absent-cell materialization, no text coercion, no partial publication."
]
},
"semantics": {
"source": "existing numeric facts only; other axes preserved",
"emptySelection": "NUMERIC_TRANSFORM_NO_MATCHING_NUMERIC_FACTS; no job or effect",
"missingAndText": "unchanged",
"detail": "selected detail-backed coordinates rejected",
"hierarchy": "explicit sealed version; unique members, no shared-path duplication",
"bounds": {
"selectedExistingFacts": 10000,
"instructions": 250000,
"candidateBytes": 16777216
},
"pins": "metadata, data and policy revisions; stale accepted input is never rebased",
"replay": "same identity/key/program/dependencies returns original job",
"stages": {
"compile": true,
"evaluate": true,
"publish": true
}
},
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.projections.cleanup
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "admin",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "long",
"arguments": {
"rebuildJobId": "Existing V2 recovery job ID",
"generationKind": "abandoned target of a failed/cancelled build or retired source of a published build",
"reason": "1–500 nonblank characters"
},
"result": "jobId then bounded hidden-row deletion checkpoints and receipt",
"programContract": {
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"languageVersion",
"function",
"arguments"
],
"properties": {
"languageVersion": {
"const": 2
},
"function": {
"const": "facts.projections.cleanup"
},
"arguments": {
"type": "object",
"additionalProperties": false,
"required": [
"rebuildJobId",
"generationKind",
"reason"
],
"properties": {
"rebuildJobId": {
"type": "string",
"pattern": "^[0-9a-f]{32}$"
},
"generationKind": {
"enum": [
"abandoned",
"retired"
]
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
}
},
"examples": [
{
"program": {
"languageVersion": 2,
"function": "facts.projections.cleanup",
"arguments": {
"rebuildJobId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"generationKind": "retired",
"reason": "Reclaim an obsolete derived generation"
}
}
}
],
"semanticRules": [
"Administrator permission is required at preview, admission, replay and each worker quantum.",
"Native recovery metadata selects the target; arbitrary generation numbers or rows are forbidden.",
"Active generations, canonical events, receipts and source history are never cleanup targets.",
"Admission pins the usual revision vector; after admission business writes may advance while the exact hidden target and schema stay valid.",
"Each quantum has a 20-second budget preserving shorter configured limits; successful checkpoints do not consume failure attempts.",
"No active pointer or data/metadata/policy/schema revision changes; only the final technical receipt advances commit revision."
],
"execution": {
"scope": "one authorized application; one fixed hidden generation",
"compiler": "projection-generations-cleanup-v1",
"planDigest": "b264fe3557ae52e85b2ee89a757e153d926bd0721947e4727781233bf2019f29"
}
},
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.projections.rebuild
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "admin",
"arguments": {
"reason": "1–500 nonblank characters explaining derived-state recovery"
},
"result": "jobId then durable checkpoints and atomic generation activation receipt; source history and original change IDs preserved",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "long",
"programContract": {
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"required": [
"languageVersion",
"function",
"arguments"
],
"properties": {
"languageVersion": {
"const": 2
},
"function": {
"const": "facts.projections.rebuild"
},
"arguments": {
"type": "object",
"additionalProperties": false,
"required": [
"reason"
],
"properties": {
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
}
},
"examples": [
{
"program": {
"languageVersion": 2,
"function": "facts.projections.rebuild",
"arguments": {
"reason": "Recover current projections from sealed history"
}
}
}
],
"semanticRules": [
"Administrator permission is required at preview, admission, replay and publication.",
"Reason is trimmed, nonblank and excludes NUL; arbitrary SQL or replacement values are forbidden.",
"Preview pins commit revision, schema epoch and metadata/data/policy revisions without scanning facts.",
"A stale source fails; accepted requests never silently rebase onto later business state.",
"The fixed compiler builds hidden numeric, text, detail, opaque JSON and coordinate projections in bounded durable quanta.",
"Only native certified generation activation publishes the complete replacement; checkpoints remain invisible to current readers.",
"Source events, change IDs and data revision are retained; only commit revision advances.",
"Each V2 quantum has a 20-second budget and preserves shorter deployment limits; accepted V1 jobs keep their 20-second total budget."
],
"execution": {
"scope": "one authorized application; durable long worker queue",
"compiler": "fact-projections-rebuild-v2",
"planDigest": "bdb24ea0001349b4f4b2778486cfcf01856ede90cf8a0b297807e56162c4aea8"
}
},
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.source.append
Tool reference · execute_v2_source_program
{
"mode": "durable_staging",
"permission": "write",
"arguments": {
"batchId": "server-issued ID",
"chunkIndex": "ordered 0–999",
"rows": "1–500 full-coordinate AmountLiteral/TextLiteral/LineDetailLiteral rows"
},
"result": "cumulative row count and digest",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.source.begin
Tool reference · execute_v2_source_program
{
"mode": "durable_staging",
"permission": "write",
"arguments": {
"idempotencyKey": "8–128 safe characters",
"mode": "merge or replace",
"scopeMembers": "stable-ID equality scope",
"scopeAll": "explicit whole-application flag",
"expectedMetadataRevision": "nonnegative integer",
"expectedDataRevision": "nonnegative integer"
},
"result": "durable batchId",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.source.csv.append
Tool reference · execute_v2_source_program
{
"mode": "durable_staging",
"permission": "write",
"arguments": {
"batchId": "server-issued ID",
"chunkIndex": "ordered 0–999",
"csvText": "UTF-8 CSV with axis.<dimensionId>, literalType, value and sourceRef columns; at most 500 rows"
},
"result": "cumulative staged row count and digest",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.source.diagnostics.compile
Tool reference · execute_v2_source_program
{
"mode": "durable_staging",
"permission": "write",
"arguments": {
"batchId": "manifest-backed caller-owned batch ID",
"rows": "bounded raw typed source rows",
"allowWarnings": "explicit boolean diagnostic admission policy"
},
"result": "immutable diagnostic artifact identity and counts",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "bounded_write",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.source.manifest.attach
Tool reference · execute_v2_source_program
{
"mode": "durable_staging",
"permission": "write",
"arguments": {
"batchId": "caller-owned staged batch ID",
"requestKey": "8–128 safe idempotency characters",
"originKind": "file, mcp, schedule or system-generated",
"originRef": "bounded non-control source reference",
"schemaVersion": "versioned declared source schema identity",
"schema": "bounded JSON source schema; never executable code",
"contentDigest": "SHA-256 of the complete acknowledged source"
},
"result": "immutable manifest identity and retention state",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.source.manifest.read
Tool reference · execute_v2_source_program
{
"mode": "read",
"permission": "read",
"arguments": {
"batchId": "server-issued batch ID"
},
"result": "immutable source manifest and verified creator identity",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.source.preview
Tool reference · execute_v2_source_program
{
"mode": "preview",
"permission": "write",
"arguments": {
"batchId": "ready batch"
},
"optionalArguments": {
"allowWarnings": "explicit boolean; default false"
},
"result": "set/clear counts and signed token",
"operationalPublication": {
"function": "facts.source.publish",
"boundary": "separate preview-token-bound durable publication of the same ready source batch under current authorization"
},
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.source.publish
Tool reference · execute_v2_source_program
{
"mode": "durable_write",
"permission": "write",
"arguments": {
"batchId": "ready batch",
"previewToken": "signed preview token"
},
"result": "atomic receipt and exact set/clear counts",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "bounded_write",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.source.seal
Tool reference · execute_v2_source_program
{
"mode": "durable_staging",
"permission": "write",
"arguments": {
"batchId": "server-issued ID",
"expectedRows": "acknowledged row count",
"expectedContentDigest": "acknowledged digest"
},
"result": "ready batch",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.text.batch
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "write",
"arguments": {
"mutations": "1–500 typed Set/Clear TextLiteral rows"
},
"result": "jobId then atomic receipt",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.transfer.export.cancel
Tool reference · execute_v2_source_program
{
"mode": "technical_cancel",
"permission": "read",
"arguments": {
"requestId": "caller-owned durable request ID"
},
"result": "actual status after safe cancellation attempt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.transfer.export.manifest.list
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"limit": "optional 1-100, default 50",
"includeExpired": "optional boolean, default false",
"cursor": "signed complete continuation request"
},
"result": "bounded finalized-manifest summaries; no exported row payload or download",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.transfer.export.manifest.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"artifactId": "exact 32-character hexadecimal ID"
},
"result": "verified finalized export manifest metadata/pages only; no exported row payload or download",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.transfer.export.payload.page
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"artifactId": "exact 32-character export artifact ID on the first request",
"cursor": "signed complete continuation request; supplied alone after the first chunk"
},
"result": "one verified stored plaintext chunk, maximum 500 rows and 8 MiB, with typed schema/digests and signed continuation; incomplete, held, or expired payloads are unavailable",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.transfer.export.read
Tool reference · execute_v2_source_program
{
"mode": "read",
"permission": "read",
"arguments": {
"requestId": "caller-owned durable request ID"
},
"result": "bounded status, pinned revisions and finalized artifact identity",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.transfer.export.request
Tool reference · execute_v2_source_program
{
"mode": "durable_query",
"permission": "read",
"arguments": {
"idempotencyKey": "8–128 safe idempotency characters",
"members": "stable-ID equality filters",
"expectedSnapshotRevision": "current application commitRevision from application.state.read",
"expectedMetadataRevision": "current metadata revision",
"expiresAt": "absolute epoch, 60 seconds to 24 hours"
},
"result": "caller-owned durable request ID and accepted status",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.transfer.import.cancel
Tool reference · execute_v2_source_program
{
"mode": "technical_cancel",
"permission": "write",
"arguments": {
"requestId": "owned import execution identity"
},
"result": "actual status after cancellation request",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}facts.transfer.import.diagnostics.list
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"limit": "optional 1-100, default 50",
"includeExpired": "optional boolean, default false",
"cursor": "signed complete continuation request"
},
"result": "bounded diagnostic-artifact summaries in stable createdAt/artifactId order; expired excluded by default",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.transfer.import.diagnostics.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"artifactId": "exact 32-character hexadecimal ID"
},
"result": "verified bounded compiled diagnostics; exact-ID reads remain visible after expiry and return expired=true",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.transfer.import.read
Tool reference · execute_v2_source_program
{
"mode": "read",
"permission": "write",
"arguments": {
"requestId": "owned import execution identity"
},
"result": "actual execution, lease and receipt status",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}facts.transfer.import.request
Tool reference · execute_v2_source_program
{
"mode": "durable_write",
"permission": "write",
"arguments": {
"idempotencyKey": "8–128 safe characters",
"batchId": "owned ready source batch",
"previewToken": "signed exact publication preview"
},
"result": "durable accepted import execution identity",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}grid.definition.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"limit": "optional 1-100",
"afterGridId": "optional stable cursor"
},
"result": "latest version of each saved grid in stable order",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}grid.definition.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"gridId": "stable grid ID",
"version": "positive immutable version"
},
"result": "one verified saved-grid definition",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}grid.definition.save
Tool reference · execute_v2_metadata_program
{
"mode": "immutable_definition_write",
"permission": "write",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"gridId": "stable grid ID",
"version": "positive immutable version",
"name": "display name",
"definition": "bounded row/column/POV definition",
"expectedMetadataRevision": "current metadata revision"
},
"result": "verified immutable saved-grid version",
"requiredCapabilities": []
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "authorized_named_version_read",
"reconciliation": {
"strategy": "call_authorized_status_function",
"function": "grid.definition.read"
}
}metadata.attribute-definition.create
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"scope": "Dimension, Member or Relationship",
"attributeId": "immutable stable ID",
"defaultName": "immutable default name",
"displayName": "mutable display name",
"shortDescription": "text, at most 500 characters",
"semanticDescription": "text, at most 10000 characters",
"valueType": "Text, Decimal, Boolean or MemberReference",
"validationConstraints": "bounded typed constraint object",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"dimensionId": "required for Member or Relationship scope"
},
"result": "definition version, metadata revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.attribute-definition.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"scope": "Dimension, Member or Relationship"
},
"optionalArguments": {
"dimensionId": "required for Member or Relationship scope",
"status": "Active or Inactive",
"query": "bounded ID, display-name or semantic search",
"limit": "1–500",
"afterAttributeId": "exclusive stable-ID cursor"
},
"result": "revision-pinned definition page",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.attribute-definition.status.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"scope": "Dimension, Member or Relationship",
"attributeId": "immutable stable ID",
"status": "Active or Inactive",
"expectedDefinitionVersion": "current positive version",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"dimensionId": "required for Member or Relationship scope"
},
"result": "new definition version, metadata revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.attribute-definition.update
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"scope": "Dimension, Member or Relationship",
"attributeId": "immutable stable ID",
"displayName": "mutable display name",
"shortDescription": "text, at most 500 characters",
"semanticDescription": "text, at most 10000 characters",
"valueType": "Text, Decimal, Boolean or MemberReference",
"validationConstraints": "bounded typed constraint object",
"expectedDefinitionVersion": "current positive version",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"dimensionId": "required for Member or Relationship scope"
},
"result": "new definition version, metadata revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.attribute-definition.usage.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"scope": "Dimension, Member or Relationship",
"attributeId": "stable definition ID"
},
"optionalArguments": {
"dimensionId": "required for Member or Relationship scope"
},
"result": "definition, exact value count and bounded object sample",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.attribute-value.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"scope": "Dimension, Member or Relationship",
"attributeId": "stable definition ID",
"objectId": "dimension, member or relationship stable ID"
},
"optionalArguments": {
"dimensionId": "required for Member or Relationship scope"
},
"result": "definition, presence and typed value at one object",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.attribute-value.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"scope": "Dimension, Member or Relationship",
"attributeId": "active stable definition ID",
"objectId": "dimension, member or relationship stable ID",
"value": "typed value or null to clear",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"dimensionId": "required for Member or Relationship scope"
},
"result": "metadata revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.calendar.period.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"yearId": "active Year member",
"periodId": "active Period member"
},
"result": "explicit mapped range or undefined, with revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.calendar.period.set
Tool reference · execute_v2_calendar_program
{
"mode": "atomic_metadata_write",
"permission": "admin",
"arguments": {
"yearId": "active Year member",
"periodId": "active Period member",
"ordinal": "1–366 within Year",
"startsOn": "ISO date, inclusive",
"endsBefore": "ISO date, exclusive",
"expectedChangeId": "current mapping change ID",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "explicit fiscal range, metadata revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.dimension.create
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "stable ID",
"name": "display name",
"modelRole": "known role or null",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"shortDescription": "text, at most 500 characters",
"detailedDescription": "text, at most 10000 characters"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.dimension.delete
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "inactive stable ID with no dependencies",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "dimension removed, metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.dimension.describe
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable ID",
"shortDescription": "text, at most 500 characters",
"detailedDescription": "text, at most 10000 characters",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "updated semantic descriptions, metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.dimension.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {},
"optionalArguments": {
"limit": "1–500; defaults to 100",
"afterDimensionId": "stable ID from prior page",
"expectedMetadataRevision": "revision from prior page"
},
"result": "bounded dimensions with descriptions, statuses and revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.dimension.rename
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable ID",
"name": "new display name",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.dimension.resolve
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"reference": "stable ID or unique name"
},
"result": "resolved active dimension",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.dimension.security-string.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable ID",
"securityString": "canonical read=...;write=... using known dimension tags",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "normalized dimension security arrays, metadata and security revisions, and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.dimension.status.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "stable dimension ID",
"status": "Active or Inactive",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "metadata revision and atomic receipt; inactivation requires no active members or live dependencies",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.hierarchy.build
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension stable ID",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"membershipSemantics": "unique_member or placement"
},
"result": "versioned active closure and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.hierarchy.relationships.apply
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active non-Currency dimension ID",
"changes": "1–100 Create/Activate/Deactivate relationship changes",
"expectedMetadataRevision": "current nonnegative metadata revision",
"expectedHierarchyVersion": "current positive active hierarchy version",
"previewToken": "server-signed exact preview"
},
"result": "one metadata/commit revision, hierarchy version and receipt",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "medium",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.hierarchy.relationships.preview
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "admin",
"arguments": {
"dimensionId": "active non-Currency dimension ID",
"changes": "1–100 Create/Activate/Deactivate relationship changes",
"expectedMetadataRevision": "current nonnegative metadata revision",
"expectedHierarchyVersion": "current positive active hierarchy version"
},
"result": "signed exact graph/closure impact and pins",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "medium",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.layout.populated.activate.cancel
Tool reference · read_v2_program
{
"mode": "technical_control",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"activationId": "exact 32-character activation identity",
"expectedStatus": "exact Requested state pin",
"expectedStateVersion": "exact nonnegative lifecycle version"
},
"result": "Cancelled only while Requested; activation publication is never relabelled cancelled",
"requiredCapabilities": []
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "authorized_status_read_before_new_intent",
"reconciliation": {
"strategy": "call_authorized_status_function",
"function": "metadata.layout.populated.activate.read"
}
}metadata.layout.populated.activate.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"activationId": "exact 32-character activation identity"
},
"result": "bounded state, certificate pins, private generation and committed receipt if activated",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.layout.populated.activate.request
Tool reference · read_v2_program
{
"mode": "durable_workflow",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"arguments": {
"requestId": "exact validated 32-character request identity",
"targetGenerationId": "exact validated private generation identity",
"validationDigest": "exact eligible validation certificate digest",
"expectedPins": "exact metadata/data/policy/schema/commit source revision vector",
"dependencyDecisions": "0-10,000 explicit compatible/invalidate/rebuild rule or publication decisions",
"idempotencyKey": "8-128 safe characters"
},
"result": "durable Requested activation identity; a private worker owns publication",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.layout.populated.preview
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "medium",
"arguments": {
"expectedPins": "exact metadata/data/policy/schema/commit revision vector",
"targetAxes": "1-200 explicit member axes; no implicit defaults",
"axisMapping": "complete source-axis to target-axis or null mapping",
"coordinateMappings": "complete bounded old-to-new coordinate mapping",
"targetMetadata": "optional plan-v2 definition of exactly one new Custom leaf axis and explicitly mapped members"
},
"result": "read-only deterministic impact summary and sealed plan/preview digests",
"workflowRoute": {
"stages": [
"metadata.layout.populated.replace.request",
"metadata.layout.populated.replace.read",
"metadata.layout.populated.activate.request",
"metadata.layout.populated.activate.read"
],
"boundary": "replacement builds and validates a private generation before a separate eligible activation request atomically switches the layout; cancellation remains available before each publication boundary"
},
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.layout.populated.replace.cancel
Tool reference · read_v2_program
{
"mode": "technical_control",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"requestId": "exact 32-character hexadecimal request identity",
"expectedStatus": "exact Accepted or Staging state pin"
},
"result": "Cancelled only before staged completion; no active layout effect",
"requiredCapabilities": []
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "authorized_status_read_before_new_intent",
"reconciliation": {
"strategy": "call_authorized_status_function",
"function": "metadata.layout.populated.replace.read"
}
}metadata.layout.populated.replace.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"requestId": "exact 32-character hexadecimal request identity"
},
"result": "bounded technical state, pins, digests and staged-coordinate count",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.layout.populated.replace.request
Tool reference · read_v2_program
{
"mode": "durable_workflow",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "medium",
"arguments": {
"preview": "exact current populated-layout preview certificate",
"plan": "complete canonical explicit coordinate mapping plan, maximum 100,000 coordinates",
"idempotencyKey": "8-128 safe characters"
},
"result": "durable private replacement request and target generation identity; no activation",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member.aggregation-operator.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"memberId": "active member ID",
"aggregationOperator": "Add, Subtract, Ignore, NeverAggregate or Formula",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member.attribute.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"memberId": "active member ID",
"slot": "defined semantic slot number",
"value": "typed value or null to clear; Decimal is a string",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "member attribute, revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member.attributes.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"dimensionId": "active dimension ID",
"memberId": "active member ID"
},
"result": "member attributes, definitions and metadata revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.member.create
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"memberId": "stable ID",
"name": "display name",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"shortDescription": "text, at most 500 characters",
"detailedDescription": "text, at most 10000 characters"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member.describe
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable ID",
"memberId": "active stable ID",
"shortDescription": "text, at most 500 characters",
"detailedDescription": "text, at most 10000 characters",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "updated semantic descriptions, metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"dimension": "active dimension stable ID or unique name"
},
"optionalArguments": {
"limit": "1–500; defaults to 100",
"afterMemberId": "stable ID from prior page",
"expectedMetadataRevision": "revision from prior page"
},
"result": "bounded members with descriptions, statuses, numeric_value_kind, exact custom values and revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.member.numeric-kind.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"memberId": "active member ID",
"numericValueKind": "amount, ratio, or null to clear",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member.rename
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable ID",
"memberId": "active stable ID",
"name": "new display name",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member.resolve
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"dimension": "stable ID or unique name",
"reference": "stable ID or unique name"
},
"result": "resolved active member including numericValueKind as numeric_value_kind",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.member.security-string.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable ID",
"memberId": "active stable ID",
"securityString": "canonical read=...;write=... using known dimension tags",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "normalized member security arrays, metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member.status.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "stable dimension ID",
"memberId": "stable member ID",
"status": "Active or Inactive",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "metadata revision and atomic receipt; inactivation rejects live references",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member_list.deactivate
Tool reference · execute_v2_metadata_program
{
"previewRequired": false,
"workClass": "short",
"mode": "atomic_publication",
"permission": "rule_publish",
"idempotencyRequired": true,
"arguments": {
"listId": "stable list ID",
"expectedStateRevision": "current list state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision"
},
"result": "inactive pointer and receipt",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.member_list.evaluate
Tool reference · read_v2_program
{
"previewRequired": false,
"workClass": "short",
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"listId": "stable list ID",
"version": "exact immutable version",
"parameters": "declared typed parameter bindings",
"expectedMetadataRevision": "current metadata revision"
},
"result": "bounded stable member IDs with definition pin",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.member_list.version.list
Tool reference · read_v2_program
{
"previewRequired": false,
"workClass": "short",
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {},
"optionalArguments": {
"limit": "1-100",
"afterListId": "stable keyset cursor",
"expectedMetadataRevision": "cursor metadata revision",
"expectedPolicyRevision": "cursor policy revision"
},
"result": "bounded latest definitions and publication states",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.member_list.version.read
Tool reference · read_v2_program
{
"previewRequired": false,
"workClass": "short",
"mode": "read",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"listId": "stable list ID"
},
"optionalArguments": {
"version": "positive immutable version"
},
"result": "definition and current publication state",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.relationship.aggregation-operator.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"relationshipId": "active stable relationship ID",
"aggregationOperatorOverride": "null, Add, Subtract, Ignore, NeverAggregate or Formula",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.relationship.attribute.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"relationshipId": "active relationship ID",
"slot": "defined semantic slot number",
"value": "typed value or null to clear; Decimal is a string",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "relationship attribute, revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.relationship.attributes.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"dimensionId": "active dimension ID",
"relationshipId": "active relationship ID"
},
"result": "relationship attributes, endpoints, definitions and revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.relationship.create
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"relationshipId": "stable ID",
"parentMemberId": "active parent ID",
"childMemberId": "active child ID",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"name": "display name; defaults to stable ID",
"shortDescription": "text, at most 500 characters",
"detailedDescription": "semantic text, at most 10000 characters"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.relationship.describe
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"relationshipId": "active stable relationship ID",
"shortDescription": "text, at most 500 characters",
"detailedDescription": "text, at most 10000 characters",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "updated semantic descriptions, metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.relationship.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"dimension": "active dimension stable ID or unique name"
},
"optionalArguments": {
"status": "Active or Inactive; omission returns both",
"limit": "1–500; defaults to 100",
"cursor": "opaque signed sole continuation argument"
},
"result": "bounded current relationship records with endpoints, semantic fields, exact custom values and revision; does not assert membership in a hierarchy version",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.relationship.rename
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"relationshipId": "active stable relationship ID",
"name": "new display name",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.relationship.security-string.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"relationshipId": "active stable ID",
"securityString": "canonical read=...;write=... using tags from the relationship dimension",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "normalized relationship security arrays, metadata and security revisions, and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.relationship.semantic_column.create
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"slot": "relationship Custom01–Custom20 slot number",
"displayName": "unique display name, at most 200 characters",
"semanticDefinition": "required meaning, at most 2000 characters",
"populationGuidance": "text, at most 2000 characters",
"restrictions": "text, at most 2000 characters",
"valueType": "Text, Decimal, Boolean or MemberReference",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"allowedValues": "at most 100 distinct Text values",
"referenceDimensionId": "required for MemberReference"
},
"result": "typed relationship semantic definition, revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.relationship.semantic_column.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"dimensionId": "active dimension ID"
},
"result": "typed relationship semantic definitions and metadata revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.relationship.semantic_column.update
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"slot": "defined Relationship Custom01–Custom20 slot number",
"displayName": "unique display name, at most 200 characters",
"semanticDefinition": "required meaning, at most 2000 characters",
"populationGuidance": "text, at most 2000 characters",
"restrictions": "text, at most 2000 characters",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "updated description, revision and receipt; value type is immutable",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.relationship.status.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"relationshipId": "stable relationship ID",
"status": "Active or Inactive",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "new metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.security-tag.create
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable dimension ID",
"tagId": "stable exact tag ID, 1–20 characters",
"displayName": "display name, 1–200 characters",
"shortDescription": "text, at most 500 characters",
"semanticDescription": "text, at most 10000 characters",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "catalogue row, metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.security-tag.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"dimension": "active dimension stable ID or unique name"
},
"optionalArguments": {
"status": "Active or Inactive; omission returns both",
"limit": "1–500; defaults to 100",
"afterTagId": "stable tag ID from prior page",
"expectedMetadataRevision": "revision from prior page"
},
"result": "bounded dimension tag catalogue with descriptions, status and revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.security-tag.status.set
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable dimension ID",
"tagId": "existing stable exact tag ID",
"status": "Active or Inactive",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "catalogue status, metadata revision and atomic receipt; in-use inactivation is rejected",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.security-tag.update
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active stable dimension ID",
"tagId": "existing stable exact tag ID",
"displayName": "display name, 1–200 characters",
"shortDescription": "text, at most 500 characters",
"semanticDescription": "text, at most 10000 characters",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "updated catalogue row, metadata revision and atomic receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.semantic_column.create
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"slot": "member Custom01–Custom30 slot number",
"displayName": "unique display name, at most 200 characters",
"semanticDefinition": "required meaning, at most 2000 characters",
"populationGuidance": "text, at most 2000 characters",
"restrictions": "text, at most 2000 characters",
"valueType": "Text, Decimal, Boolean or MemberReference",
"expectedMetadataRevision": "nonnegative integer"
},
"optionalArguments": {
"allowedValues": "at most 100 distinct Text values",
"referenceDimensionId": "required for MemberReference"
},
"result": "typed semantic definition, revision and receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}metadata.semantic_column.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"dimensionId": "active dimension ID"
},
"result": "typed semantic definitions and metadata revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}metadata.semantic_column.update
Tool reference · execute_v2_metadata_program
{
"mode": "atomic_write",
"permission": "admin",
"arguments": {
"dimensionId": "active dimension ID",
"slot": "defined Member Custom01–Custom30 slot number",
"displayName": "unique display name, at most 200 characters",
"semanticDefinition": "required meaning, at most 2000 characters",
"populationGuidance": "text, at most 2000 characters",
"restrictions": "text, at most 2000 characters",
"expectedMetadataRevision": "nonnegative integer"
},
"result": "updated description, revision and receipt; value type is immutable",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.environment.list
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"limit": "1-100",
"afterEnvironmentId": "optional keyset"
},
"result": "bounded registered environment page",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}python.environment.profile.list
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {},
"result": "deployment-approved registration profiles; no caller image input",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}python.environment.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"arguments": {
"environmentId": "stable environment ID"
},
"result": "current registered immutable environment",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}python.environment.register
Tool reference · execute_v2_python_program_registry
{
"mode": "atomic_write",
"permission": "admin",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"arguments": {
"environmentId": "1-200 safe characters",
"version": "next positive integer",
"profileId": "deployment-approved profile identity; never an image supplied by the caller",
"expectedMetadataRevision": "exact current nonnegative revision",
"expectedPolicyRevision": "exact current nonnegative revision",
"expectedSchemaEpoch": "exact current nonnegative epoch"
},
"result": "active immutable environment version, deployment-owned image digest and committed receipt",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.program.build
Tool reference · execute_v2_python_program_build
{
"mode": "durable_technical_build",
"permission": "rule_run",
"arguments": {
"programId": "published program ID",
"programVersion": "exact published immutable version",
"parameters": "bounded typed JSON parameter object",
"expectedMetadataRevision": "current revision",
"expectedPolicyRevision": "current revision",
"expectedSchemaEpoch": "current schema epoch",
"delegationId": "current execution delegation ID",
"delegationVersion": "exact current delegation version",
"scheduleId": "required field, exact schedule ID or null for a direct build",
"scheduleVersion": "required field, exact schedule version or null for a direct build"
},
"result": "durable build ID and technical status; no business effect or receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "medium",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.program.deactivate
Tool reference · execute_v2_python_program_registry
{
"mode": "atomic_rule_publication",
"permission": "rule_publish",
"arguments": {
"programId": "currently published program ID",
"version": "exact current published version",
"expectedMetadataRevision": "current revision",
"expectedPolicyRevision": "current revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "deactivated publication pointer and operation receipt",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.program.list
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"arguments": {
"limit": "optional 1-100",
"afterProgramId": "optional keyset cursor"
},
"result": "bounded current publication summaries",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}python.program.publish
Tool reference · execute_v2_python_program_registry
{
"mode": "atomic_rule_publication",
"permission": "rule_publish",
"arguments": {
"programId": "saved program ID",
"version": "immutable version to publish",
"expectedMetadataRevision": "current revision",
"expectedPolicyRevision": "current revision",
"expectedSchemaEpoch": "current schema epoch"
},
"optionalArguments": {
"validationBuildId": "exact reviewed caller-owned current Validation or ImpactTest build; required for typed definition activation"
},
"result": "authorized publication pointer and receipt after current-pin sealed Validation or completed ImpactTest of this exact source version",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.program.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"arguments": {
"programId": "program ID",
"version": "optional immutable version"
},
"result": "authorized immutable source and publication state",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}python.program.run
Tool reference · execute_v2_python_program_run
{
"mode": "durable_business_workflow",
"permission": "rule_run",
"arguments": {
"buildId": "caller-owned sealed build ID"
},
"result": "checkpointed workflow",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "medium",
"limits": {
"atomicProfiles": {
"single": "1 op",
"sameFact": "2-500 ops; numeric OR text; max 500 mutations; unique coords",
"mixedFact": "3-100 ops; numeric+text+detail; max 500 mutations; reject cross-type/repeat-detail; same-family chains"
},
"publication": "1 transaction + receipt/unit",
"unsupported": "other multi-op units fail closed"
},
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.program.save
Tool reference · execute_v2_python_program_registry
{
"mode": "atomic_rule_authoring",
"permission": "rule_design",
"arguments": {
"programId": "stable program ID",
"version": "next immutable positive version",
"sourceText": "bounded UTF-8 Python builder source",
"entryPoint": "approved build function name",
"parameterSchema": "bounded JSON parameter schema",
"environmentId": "approved environment ID",
"environmentVersion": "active immutable environment version",
"expectedMetadataRevision": "current revision",
"expectedPolicyRevision": "current revision",
"expectedSchemaEpoch": "current schema epoch"
},
"optionalArguments": {
"validationParameters": "bounded sample parameter object; defaults to {}"
},
"result": "immutable source, receipt and atomically queued Validation build; poll returned validation build/task for semantic diagnostics",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.program.test
Tool reference · execute_v2_python_program_build
{
"mode": "durable_technical_build",
"permission": "rule_design",
"arguments": {
"programId": "saved program ID, active or inactive",
"programVersion": "exact immutable source version",
"parameters": "bounded typed parameter values",
"expectedMetadataRevision": "current revision",
"expectedPolicyRevision": "current revision",
"expectedSchemaEpoch": "current schema epoch"
},
"optionalArguments": {
"definitionParameters": "explicit returned-definition runtime bindings, distinct from builder parameters; default {}"
},
"result": "ImpactTest build/task ID; sealed status includes complete private Impact artifact, never live writes",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "medium",
"limits": {
"cells": 10000,
"units": 500,
"statementVisits": 100000,
"resultBytes": 16777216,
"impactSeconds": 20,
"supported": [
"facts.numeric.transform",
"facts.numeric.sequence",
"facts.numeric.batch"
],
"unsupported": "rejected before evaluation; no partial success"
},
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.schedule.deactivate
Tool reference · execute_v2_python_program_registry
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_configuration",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"scheduleId": "ID",
"version": "version",
"expectedStateRevision": "revision",
"expectedMetadataRevision": "revision",
"expectedPolicyRevision": "revision",
"expectedSchemaEpoch": "epoch"
},
"result": "inactive pointer"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.schedule.list
Tool reference · read_v2_program
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read_only",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"limit": "1-100",
"afterScheduleId": "keyset"
},
"result": "page"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}python.schedule.occurrence.cancel
Tool reference · execute_v2_python_program_registry
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_configuration",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"occurrenceId": "ID"
},
"result": "cancel requested"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.schedule.occurrence.read
Tool reference · read_v2_program
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read_only",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"occurrenceId": "ID"
},
"result": "occurrence"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}python.schedule.publish
Tool reference · execute_v2_python_program_registry
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_configuration",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"scheduleId": "ID",
"version": "version",
"expectedStateRevision": "revision",
"expectedMetadataRevision": "revision",
"expectedPolicyRevision": "revision",
"expectedSchemaEpoch": "epoch"
},
"result": "active pointer"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.schedule.read
Tool reference · read_v2_program
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read_only",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"scheduleId": "ID"
},
"result": "schedule"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}python.schedule.run
Tool reference · execute_v2_python_program_registry
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_configuration",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"scheduleId": "ID"
},
"result": "durable occurrence"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}python.schedule.save
Tool reference · execute_v2_python_program_registry
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_configuration",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"scheduleId": "ID",
"expectedVersion": "latest or zero",
"expectedStateRevision": "state revision",
"programId": "published program",
"programVersion": "exact version",
"parameters": "typed object",
"intervalSeconds": "60-2678400",
"firstDueAt": "UTC",
"catchUpPolicy": "skip/latest/all",
"maxCatchUp": "1-36",
"delegationId": "exact authority",
"delegationVersion": "exact version",
"expectedMetadataRevision": "revision",
"expectedPolicyRevision": "revision",
"expectedSchemaEpoch": "epoch"
},
"result": "immutable schedule"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}rules.expression.run
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_calculation",
"permission": "rule_run",
"arguments": {
"ruleId": "current published immutable expression rule"
},
"optionalArguments": {
"bindings": "exact decimal strings or active stable member IDs for every declared parameter"
},
"result": "revision-pinned expression generation with saved-rule provenance",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}rules.expression.sequence.cancel
Tool reference · cancel_v2_expression_sequence
{
"mode": "atomic_sequence_control",
"permission": "write",
"arguments": {
"sequenceId": "caller-owned durable sequence ID"
},
"result": "cancelled or cancel-requested sequence status",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "operation_is_not_client_replayable",
"uncertainOutcome": "repeat_terminal_control",
"reconciliation": {
"strategy": "repeat_compare_and_set_terminal_control"
}
}rules.expression.sequence.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"sequenceId": "caller-owned durable sequence ID"
},
"result": "step progress, job IDs and terminal error",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}rules.expression.sequence.run
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_sequence",
"permission": "rule_run",
"arguments": {
"ruleIds": "2–8 distinct published expression rules in execution order"
},
"optionalArguments": {
"bindings": "rule ID to exact decimal or active stable-member binding map for each parameterized step"
},
"result": "durable sequence ID, per-step job IDs and terminal status",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "bounded_write",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}rules.expression.version.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {},
"optionalArguments": {
"limit": "1–100 published rules; default 100",
"afterRuleId": "last ruleId from previous page",
"expectedMetadataRevision": "required with afterRuleId",
"expectedPolicyRevision": "required with afterRuleId"
},
"result": "published rule IDs, versions, result keys, typed parameter declarations and revision-pinned next page; drafts omitted",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}rules.expression.version.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"ruleId": "saved-rule ID"
},
"optionalArguments": {
"version": "specific saved version; default current published"
},
"result": "immutable definition and current published status",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}rules.numeric_sequence.run
Tool reference · preview_v2_program, submit_v2_program
{
"mode": "durable_write",
"permission": "rule_run",
"arguments": {
"ruleId": "published ID"
},
"optionalArguments": {
"bindings": "exact declared typed values"
},
"result": "durable job; ordered exact statement events and saved-program provenance",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"programContract": {
"version": 1,
"validationScope": "JSON Schema wire structure plus required semanticRules; fixed compiler/core is authoritative",
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"languageVersion": {
"type": "integer",
"const": 2
},
"function": {
"const": "rules.numeric_sequence.run"
},
"arguments": {
"type": "object",
"properties": {
"ruleId": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,100}$"
},
"bindings": {
"type": "object",
"maxProperties": 8,
"propertyNames": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
},
"additionalProperties": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"ruleId"
],
"additionalProperties": false
}
},
"required": [
"languageVersion",
"function",
"arguments"
],
"additionalProperties": false
},
"semanticRules": [
"Saved definitions contain statements plus optional parameters/rounding; authored expectedChangeId and convergence are forbidden. Server obtains current first-touch CAS IDs set-wise at run preview. Saved versions never become iterative implicitly.",
"Declare at most8 parameters; names start with an ASCII letter and continue ASCII letters/digits/underscore up to64 characters. Every declaration must be used; no undeclared reference. amount/ratio declarations bind exact decimal strings; member declarations require type:member, dimensionId, active sampleMemberId.",
"MemberParameter {type:MemberParameter,name} is allowed only as a coordinate value and its declared dimensionId must equal that axis. Runtime member binding is an active ID in that same dimension, trimmed/non-NUL,1–200 characters; sampleMemberId validates authoring, not a runtime default.",
"AmountParameter {type:AmountParameter,name} is an outer statement value only for an amount declaration. Parameter {op:Parameter,name} is an expression leaf of its declared amount/ratio type. No member-expression parameter, code substitution or partial coordinate substitution.",
"Run bindings must match all and only declared parameter names; no defaults. Values cross the wire as strings. Numeric bindings satisfy amount20/8 or ratio8/12 ranges; member bindings satisfy their dimension. Fetch definition with version.read to learn its declarations.",
"Save requires next immutable version and current metadata/policy revisions; sample numeric parameters compile as1 and member samples must be active. Publish takes a saved version/current revisions, advances policy revision, and requires separate publish grant. Run needs current write+rule_run and current published version; authoring needs write+rule_design.",
"Rule IDs are1–100 ASCII letters/digits/dot/underscore/hyphen. Definition kind cannot change; expression and ordered version read/list are separate. A LIST continuation requires both pinned metadata/policy revisions and afterRuleId; limit defaults100. READ omitting version resolves current published ordered version."
],
"examples": [
{
"id": "run-typed-template",
"program": {
"languageVersion": 2,
"function": "rules.numeric_sequence.run",
"arguments": {
"ruleId": "plan.example",
"bindings": {
"Target": "A",
"Seed": "100",
"Rate": "0.25"
}
}
},
"expectedFinal": {
"A": "125.00000000"
}
}
],
"examplePrerequisites": {
"warning": "Synthetic examples; never run blindly in an existing business application.",
"application": "Separate fresh blank application for each data example; saved lifecycle examples share one fresh application. Consolidation disabled.",
"metadata": [
{
"function": "metadata.dimension.create",
"arguments": {
"dimensionId": "Metric",
"name": "Metric",
"modelRole": "Custom",
"expectedMetadataRevision": 0
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "A",
"name": "A",
"expectedMetadataRevision": 1
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "B",
"name": "B",
"expectedMetadataRevision": 2
}
}
],
"snapshot": "Metadata revision3/policy0; no prior numeric events. Saved examples run save→publish→read/list→run; save/publish revisions are examples, use actual current revisions.",
"authority": "Current write; saved lifecycle also needs separate design/publish/run grants. Reader can inspect saved read/list, not execute writes."
},
"execution": {
"previewTool": "preview_v2_program",
"submitTool": "submit_v2_program",
"jobTool": "read_v2_job",
"cancelTool": "cancel_v2_job",
"scope": "application listener is bound; router tools additionally require workspace_id/application_id",
"submission": "Send unchanged program + preview_token from current preview + unique idempotency_key; optional depends_on_job_ids. Use durable jobId to poll. Do not execute statement/iteration loops in the client.",
"snapshot": "Preview writes no data. New admission and publication recheck grants, revisions, CAS, active metadata, planning locks and claim. Re-preview on stale input; never silently rewrite an accepted intent.",
"replay": "Same verified identity/application/key/program/dependency order returns original job without rebasing, even after preview expiry; current write/run authority still required. Changed intent under an existing key conflicts. Cancellation cannot undo committed publication.",
"publication": "All statement events/final cells/receipt/revision/published-job result commit atomically. A failed/cancelled/stale worker cannot publish partial effects."
}
},
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}rules.numeric_sequence.version.list
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {},
"optionalArguments": {
"limit": "1–100",
"afterRuleId": "stable cursor",
"expectedMetadataRevision": "cursor revision",
"expectedPolicyRevision": "cursor revision"
},
"result": "bounded published ordered programs",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"programContract": {
"version": 1,
"validationScope": "JSON Schema wire structure plus required semanticRules; fixed compiler/core is authoritative",
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"languageVersion": {
"type": "integer",
"const": 2
},
"function": {
"const": "rules.numeric_sequence.version.list"
},
"arguments": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"afterRuleId": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,100}$"
},
"expectedMetadataRevision": {
"type": "integer",
"minimum": 0
},
"expectedPolicyRevision": {
"type": "integer",
"minimum": 0
}
},
"required": [],
"additionalProperties": false,
"dependentRequired": {
"afterRuleId": [
"expectedMetadataRevision",
"expectedPolicyRevision"
]
}
}
},
"required": [
"languageVersion",
"function",
"arguments"
],
"additionalProperties": false
},
"semanticRules": [
"Saved definitions contain statements plus optional parameters/rounding; authored expectedChangeId and convergence are forbidden. Server obtains current first-touch CAS IDs set-wise at run preview. Saved versions never become iterative implicitly.",
"Declare at most8 parameters; names start with an ASCII letter and continue ASCII letters/digits/underscore up to64 characters. Every declaration must be used; no undeclared reference. amount/ratio declarations bind exact decimal strings; member declarations require type:member, dimensionId, active sampleMemberId.",
"MemberParameter {type:MemberParameter,name} is allowed only as a coordinate value and its declared dimensionId must equal that axis. Runtime member binding is an active ID in that same dimension, trimmed/non-NUL,1–200 characters; sampleMemberId validates authoring, not a runtime default.",
"AmountParameter {type:AmountParameter,name} is an outer statement value only for an amount declaration. Parameter {op:Parameter,name} is an expression leaf of its declared amount/ratio type. No member-expression parameter, code substitution or partial coordinate substitution.",
"Run bindings must match all and only declared parameter names; no defaults. Values cross the wire as strings. Numeric bindings satisfy amount20/8 or ratio8/12 ranges; member bindings satisfy their dimension. Fetch definition with version.read to learn its declarations.",
"Save requires next immutable version and current metadata/policy revisions; sample numeric parameters compile as1 and member samples must be active. Publish takes a saved version/current revisions, advances policy revision, and requires separate publish grant. Run needs current write+rule_run and current published version; authoring needs write+rule_design.",
"Rule IDs are1–100 ASCII letters/digits/dot/underscore/hyphen. Definition kind cannot change; expression and ordered version read/list are separate. A LIST continuation requires both pinned metadata/policy revisions and afterRuleId; limit defaults100. READ omitting version resolves current published ordered version."
],
"examples": [
{
"id": "list-templates",
"program": {
"languageVersion": 2,
"function": "rules.numeric_sequence.version.list",
"arguments": {
"limit": 10
}
}
}
],
"examplePrerequisites": {
"warning": "Synthetic examples; never run blindly in an existing business application.",
"application": "Separate fresh blank application for each data example; saved lifecycle examples share one fresh application. Consolidation disabled.",
"metadata": [
{
"function": "metadata.dimension.create",
"arguments": {
"dimensionId": "Metric",
"name": "Metric",
"modelRole": "Custom",
"expectedMetadataRevision": 0
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "A",
"name": "A",
"expectedMetadataRevision": 1
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "B",
"name": "B",
"expectedMetadataRevision": 2
}
}
],
"snapshot": "Metadata revision3/policy0; no prior numeric events. Saved examples run save→publish→read/list→run; save/publish revisions are examples, use actual current revisions.",
"authority": "Current write; saved lifecycle also needs separate design/publish/run grants. Reader can inspect saved read/list, not execute writes."
},
"execution": {
"tool": "read_v2_program",
"scope": "Router additionally needs workspace_id/application_id; bound application listener does not.",
"submission": "Authoring/publication needs program + unique idempotency_key, no preview; reads need only program.",
"effects": "Save stores immutable definition only; publish moves pointer/policy revision, never runs data calculations."
}
},
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}rules.numeric_sequence.version.read
Tool reference · read_v2_program
{
"mode": "read",
"permission": "read",
"arguments": {
"ruleId": "stable ID"
},
"optionalArguments": {
"version": "saved immutable version"
},
"result": "typed authored program, digest and publication state",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"programContract": {
"version": 1,
"validationScope": "JSON Schema wire structure plus required semanticRules; fixed compiler/core is authoritative",
"programSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"languageVersion": {
"type": "integer",
"const": 2
},
"function": {
"const": "rules.numeric_sequence.version.read"
},
"arguments": {
"type": "object",
"properties": {
"ruleId": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,100}$"
},
"version": {
"type": "integer",
"minimum": 1
}
},
"required": [
"ruleId"
],
"additionalProperties": false
}
},
"required": [
"languageVersion",
"function",
"arguments"
],
"additionalProperties": false
},
"semanticRules": [
"Saved definitions contain statements plus optional parameters/rounding; authored expectedChangeId and convergence are forbidden. Server obtains current first-touch CAS IDs set-wise at run preview. Saved versions never become iterative implicitly.",
"Declare at most8 parameters; names start with an ASCII letter and continue ASCII letters/digits/underscore up to64 characters. Every declaration must be used; no undeclared reference. amount/ratio declarations bind exact decimal strings; member declarations require type:member, dimensionId, active sampleMemberId.",
"MemberParameter {type:MemberParameter,name} is allowed only as a coordinate value and its declared dimensionId must equal that axis. Runtime member binding is an active ID in that same dimension, trimmed/non-NUL,1–200 characters; sampleMemberId validates authoring, not a runtime default.",
"AmountParameter {type:AmountParameter,name} is an outer statement value only for an amount declaration. Parameter {op:Parameter,name} is an expression leaf of its declared amount/ratio type. No member-expression parameter, code substitution or partial coordinate substitution.",
"Run bindings must match all and only declared parameter names; no defaults. Values cross the wire as strings. Numeric bindings satisfy amount20/8 or ratio8/12 ranges; member bindings satisfy their dimension. Fetch definition with version.read to learn its declarations.",
"Save requires next immutable version and current metadata/policy revisions; sample numeric parameters compile as1 and member samples must be active. Publish takes a saved version/current revisions, advances policy revision, and requires separate publish grant. Run needs current write+rule_run and current published version; authoring needs write+rule_design.",
"Rule IDs are1–100 ASCII letters/digits/dot/underscore/hyphen. Definition kind cannot change; expression and ordered version read/list are separate. A LIST continuation requires both pinned metadata/policy revisions and afterRuleId; limit defaults100. READ omitting version resolves current published ordered version."
],
"examples": [
{
"id": "read-template",
"program": {
"languageVersion": 2,
"function": "rules.numeric_sequence.version.read",
"arguments": {
"ruleId": "plan.example",
"version": 1
}
}
}
],
"examplePrerequisites": {
"warning": "Synthetic examples; never run blindly in an existing business application.",
"application": "Separate fresh blank application for each data example; saved lifecycle examples share one fresh application. Consolidation disabled.",
"metadata": [
{
"function": "metadata.dimension.create",
"arguments": {
"dimensionId": "Metric",
"name": "Metric",
"modelRole": "Custom",
"expectedMetadataRevision": 0
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "A",
"name": "A",
"expectedMetadataRevision": 1
}
},
{
"function": "metadata.member.create",
"arguments": {
"dimensionId": "Metric",
"memberId": "B",
"name": "B",
"expectedMetadataRevision": 2
}
}
],
"snapshot": "Metadata revision3/policy0; no prior numeric events. Saved examples run save→publish→read/list→run; save/publish revisions are examples, use actual current revisions.",
"authority": "Current write; saved lifecycle also needs separate design/publish/run grants. Reader can inspect saved read/list, not execute writes."
},
"execution": {
"tool": "read_v2_program",
"scope": "Router additionally needs workspace_id/application_id; bound application listener does not.",
"submission": "Authoring/publication needs program + unique idempotency_key, no preview; reads need only program.",
"effects": "Save stores immutable definition only; publish moves pointer/policy revision, never runs data calculations."
}
},
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}schedule.version.deactivate
Tool reference · execute_v2_application_schedule
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_configuration",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"scheduleId": "stable schedule ID",
"expectedStateRevision": "current schedule state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "inactive schedule pointer"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}schedule.version.list
Tool reference · execute_v2_application_schedule
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read_only",
"permission": "read",
"idempotencyRequired": false,
"arguments": {},
"optionalArguments": {
"limit": "1-100",
"afterScheduleId": "keyset cursor"
},
"result": "bounded schedule-definition page"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}schedule.version.publish
Tool reference · execute_v2_application_schedule
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_configuration",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"scheduleId": "stable schedule ID",
"version": "exact immutable version",
"expectedStateRevision": "current schedule state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "active schedule pointer"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}schedule.version.read
Tool reference · execute_v2_application_schedule
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "read_only",
"permission": "read",
"idempotencyRequired": false,
"arguments": {
"scheduleId": "stable schedule ID"
},
"optionalArguments": {
"version": "exact immutable version"
},
"result": "schedule definition and publication state"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}schedule.version.save
Tool reference · execute_v2_application_schedule
{
"requiredCapabilities": [],
"previewRequired": false,
"workClass": "short",
"mode": "atomic_configuration",
"permission": "admin",
"idempotencyRequired": true,
"arguments": {
"definition": "openepm-application-schedule-v1 definition",
"expectedStateRevision": "current schedule state revision",
"expectedMetadataRevision": "current metadata revision",
"expectedPolicyRevision": "current policy revision",
"expectedSchemaEpoch": "current schema epoch"
},
"result": "immutable exact schedule version"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.application.access.list
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {
"afterSubjectId": "optional subject keyset",
"limit": "optional 1-100"
},
"result": "bounded application grants with dimensional and rule access",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.application.access.set
Requires the configured application security service.
Tool reference · set_v2_application_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"subjectId": "verified-provider subject ID",
"action": "grant or revoke",
"role": "Reader, Editor, Administrator, or null on revoke"
},
"result": "scoped grant effect, security receipt and audit",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.application.audit.list
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {
"beforeAuditId": "optional descending keyset cursor",
"limit": "optional 1-100"
},
"result": "bounded immutable application security events with safe digests and optional receipt correlation",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.application.dimension-access.read
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {
"subjectId": "existing application-grant subject ID"
},
"result": "current scoped role, read/write tag assignments and security revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.application.dimension-access.set
Requires the configured application security service.
Tool reference · set_v2_application_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"subjectId": "existing application-grant subject ID",
"readTags": "dimension-ID map of exact read tags",
"writeTags": "dimension-ID map of exact write tags",
"expectedSecurityRevision": "nonnegative integer"
},
"result": "inert scoped tag assignments, security revision, receipt and audit",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.application.dimension-policy.activate
Requires the configured application security service.
Tool reference · set_v2_application_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"policyVersion": "exact saved immutable version",
"expectedSecurityRevision": "current nonnegative revision"
},
"result": "active supported policy identity and advanced security revision; hierarchy-effective drafts are not activatable",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.application.dimension-policy.active.read
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {},
"result": "current active integrity-checked policy or explicit inactive state",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.application.dimension-policy.deactivate
Requires the configured application security service.
Tool reference · set_v2_application_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"expectedSecurityRevision": "current nonnegative revision"
},
"result": "explicit policy deactivation and advanced security revision",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.application.dimension-policy.version.list
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {
"afterVersion": "optional nonnegative keyset cursor",
"limit": "optional integer from 1 through 100"
},
"result": "ascending integrity-checked inert policy versions",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.application.dimension-policy.version.read
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {
"policyVersion": "exact positive immutable version"
},
"result": "integrity-checked inert policy version; no implicit latest",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.application.dimension-policy.version.save
Requires the configured application security service.
Tool reference · set_v2_application_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"policyVersion": "exact next positive immutable version",
"policy": "all ten explicit dimensional-security choices"
},
"result": "saved inert policy version; no activation or authorization effect",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.application.group-access.list
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {
"afterGroupId": "optional group keyset",
"limit": "optional 1-100"
},
"result": "bounded application group grants with dimensional and rule access",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.application.group-access.set
Requires the configured application security service.
Tool reference · set_v2_application_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"groupId": "stable verified Keycloak group ID",
"action": "grant or revoke",
"role": "Reader, Editor, Administrator, or null on revoke"
},
"result": "scoped group grant effect, security receipt and audit",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application and group target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.application.group-dimension-access.read
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {
"groupId": "existing application group-grant ID"
},
"result": "current scoped group role, read/write tag assignments and security revision",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.application.group-dimension-access.set
Requires the configured application security service.
Tool reference · set_v2_application_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"groupId": "existing application group-grant ID",
"readTags": "dimension-ID map of exact read tags",
"writeTags": "dimension-ID map of exact write tags",
"expectedSecurityRevision": "nonnegative integer"
},
"result": "scoped group tag assignments, security revision, receipt and audit",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application and group target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.application.receipt.read
Requires the configured application security service.
Tool reference · read_v2_program
{
"mode": "read",
"permission": "admin",
"arguments": {
"operationId": "exact security audit correlation"
},
"result": "application-bound committed security receipt with allowlisted identifiers, action, time and digests",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.identity.current.read
Tool reference · read_v2_program
{
"mode": "read_only",
"permission": "read",
"arguments": {},
"result": "server-verified current issuer and subject identity for this authorized application scope",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.rule.access.set
Requires the configured application security service.
Tool reference · set_v2_rule_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"subjectId": "verified-provider subject ID",
"action": "set or revoke",
"permissions": "explicit design/publish/run booleans, or null on revoke"
},
"result": "scoped rule permissions, receipt and audit",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application/rule target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.rule.group-access.set
Requires the configured application security service.
Tool reference · set_v2_rule_access
{
"mode": "atomic_security_write",
"permission": "admin",
"arguments": {
"groupId": "stable verified Keycloak group ID",
"action": "set or revoke",
"permissions": "explicit design/publish/run booleans, or null on revoke"
},
"result": "scoped group rule permissions, receipt and audit",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace; include the application/group target in the key",
"workClass": "short"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}Workspace functions
Discover with list_v2_workspace_functions.
11 functions in this local catalog.
security.workspace.access.set
Tool reference · set_v2_workspace_access
{
"mode": "atomic_security_write",
"permission": "workspace_admin",
"arguments": {
"subjectId": "verified-provider subject ID",
"action": "grant or revoke",
"role": "Administrator or null on revoke"
},
"result": "workspace grant, security receipt and audit",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace shared with application and rule grant writes",
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}security.workspace.group-access.list
Tool reference · read_v2_workspace_access
{
"mode": "read",
"permission": "workspace_admin",
"arguments": {
"afterGroupId": "optional group keyset",
"limit": "1 through 100, default 100"
},
"result": "bounded workspace group-administrator grants",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}security.workspace.group-access.set
Tool reference · set_v2_workspace_access
{
"mode": "atomic_security_write",
"permission": "workspace_admin",
"arguments": {
"groupId": "stable verified Keycloak group ID",
"action": "grant or revoke",
"role": "Administrator or null on revoke"
},
"result": "workspace group grant, security receipt and audit",
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace security-operation namespace shared with application and rule grant writes",
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}workspace.application.create
Tool reference · execute_v2_workspace_program
{
"mode": "atomic_write",
"permission": "workspace_admin",
"arguments": {
"applicationId": "stable ID",
"name": "display name",
"kind": "multidimensional; eight mandatory axes, no seeded business members"
},
"optionalArguments": {
"enabledCapabilities": "explicit initial known capabilities; default empty, no finance metadata seeded"
},
"result": "created application and administrator grant with the eight-axis programmable blueprint and editable semantic descriptions",
"applicationBlueprint": {
"version": 2,
"dimensions": [
{
"dimensionId": "Account",
"name": "Account",
"modelRole": "Account",
"semanticRole": "Context",
"density": "Sparse",
"shortDescription": "Accounts, measures, KPIs and goals.",
"detailedDescription": "Application-defined financial or statistical accounts, measures, key performance indicators and goals. Their calculations and aggregation behavior are defined explicitly by the application's rules."
},
{
"dimensionId": "Entity",
"name": "Entity",
"modelRole": "Entity",
"semanticRole": "Core entity",
"density": "Sparse",
"shortDescription": "Business objects and organizational units.",
"detailedDescription": "The business objects or organizational units modeled by this application. Hierarchies describe their relationships; aggregation, consolidation and other behavior must be defined explicitly."
},
{
"dimensionId": "Year",
"name": "Year",
"modelRole": "Year",
"semanticRole": "Context",
"density": "Sparse",
"shortDescription": "Year-level time classification.",
"detailedDescription": "The application's year-level time classification. Members and calendar relationships are defined by the application; no particular fiscal calendar is assumed."
},
{
"dimensionId": "Period",
"name": "Period",
"modelRole": "Period",
"semanticRole": "Context",
"density": "Sparse",
"shortDescription": "Periods in the application's timeline.",
"detailedDescription": "Periods within the application's timeline or calendar. Their order, duration and relationship to years are defined by the application."
},
{
"dimensionId": "View",
"name": "View",
"modelRole": "View",
"semanticRole": "Context",
"density": "Sparse",
"shortDescription": "Interpretation or presentation of values.",
"detailedDescription": "The application's interpretation or presentation of values. Any period, cumulative or other behavior is defined explicitly by its rules rather than inferred from a member name."
},
{
"dimensionId": "Value",
"name": "Value",
"modelRole": "Value",
"semanticRole": "Context",
"density": "Sparse",
"shortDescription": "Application-defined value categories or layers.",
"detailedDescription": "Value categories or layers defined by the application. Their meaning and transformations are expressed by the model and its rules; no currency or accounting behavior is activated automatically."
},
{
"dimensionId": "Scenario",
"name": "Scenario",
"modelRole": "Scenario",
"semanticRole": "Context",
"density": "Sparse",
"shortDescription": "Application-defined alternatives and assumptions.",
"detailedDescription": "Alternatives chosen by the application, such as Actual, Budget, Forecast or Simulation. These are examples rather than required members; the dimension does not create experimental applications."
},
{
"dimensionId": "DataType",
"name": "Data Type",
"modelRole": "DataType",
"semanticRole": "Context",
"density": "Sparse",
"shortDescription": "Application-defined information classification.",
"detailedDescription": "A classification chosen by the application, such as numeric, text, commentary, source or input category. Members do not coerce stored values or replace the platform's numeric, text and supporting-detail validation."
}
]
},
"previewRequired": false,
"idempotencyRequired": true,
"idempotencyScope": "workspace lifecycle-operation namespace; use a distinct key for each intended application creation",
"nameUniqueness": "application display names are unique within their workspace",
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}workspace.application.purge.apply
Tool reference · execute_v2_application_purge
{
"permission": "workspace_admin",
"previewRequired": false,
"workClass": "long",
"requiredCapabilities": [],
"mode": "atomic_write",
"idempotencyRequired": true,
"arguments": {
"applicationId": "exact application ID",
"createdAt": "exact creation timestamp returned by prepare"
},
"result": "minimal terminal actor receipt; all targeted application content deleted, workspace retained"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}workspace.application.purge.prepare
Tool reference · execute_v2_application_purge
{
"permission": "workspace_admin",
"previewRequired": false,
"workClass": "medium",
"requiredCapabilities": [],
"mode": "read_only",
"idempotencyRequired": false,
"arguments": {
"applicationId": "exact application ID"
},
"result": "application incarnation, revisions, scoped inventory, live leases and digest; no mutation"
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}workspace.application.purge.quiesce
Tool reference · execute_v2_application_purge
{
"permission": "workspace_admin",
"previewRequired": false,
"workClass": "medium",
"requiredCapabilities": [],
"mode": "atomic_write",
"idempotencyRequired": true,
"arguments": {
"applicationId": "exact application ID",
"createdAt": "exact creation timestamp returned by prepare",
"manifestDigest": "current prepare digest"
},
"result": "one application in Deleting; existing work cannot publish and live leases must drain"
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}workspace.reset.prepare
Tool reference · prepare_v2_workspace_reset
{
"mode": "read_only",
"permission": "platform_operator_and_workspace_admin",
"arguments": {
"scope": "workspace"
},
"result": "signed PostgreSQL target inventory; no deletion",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "medium",
"requiredCapabilities": []
}{
"idempotency": "not_applicable",
"uncertainOutcome": "repeat_read",
"reconciliation": {
"strategy": "repeat_authorized_read"
}
}workspace.reset.quiesce
Tool reference · transition_v2_workspace_reset
{
"mode": "atomic_write",
"permission": "platform_operator_and_workspace_admin",
"arguments": {
"manifestDigest": "sha256 from prepare",
"expiresAt": "epoch seconds from prepare",
"signature": "signature from prepare"
},
"result": "workspace Maintenance; no deletion",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}workspace.reset.resume
Tool reference · transition_v2_workspace_reset
{
"mode": "atomic_write",
"permission": "platform_operator_and_workspace_admin",
"arguments": {
"reason": "explicit reason, 1–200 characters"
},
"result": "workspace Active; no deletion",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}workspace.reset.settle
Tool reference · transition_v2_workspace_reset
{
"mode": "atomic_write",
"permission": "platform_operator_and_workspace_admin",
"arguments": {
"manifestDigest": "sha256 from Maintenance prepare",
"expiresAt": "epoch seconds from Maintenance prepare",
"signature": "signature from Maintenance prepare"
},
"result": "fenced job and staged-source settlement counts",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "short",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}Platform functions
Discover with list_v2_platform_functions.
16 functions in this local catalog.
identity.directory.reconcile
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "current Keycloak authorization snapshot",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.group.create
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "stable group and mutable descriptions",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.group.list
Tool reference · read_v2_platform_program
{
"mode": "read",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "bounded managed-group page",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}identity.group.membership.list
Tool reference · read_v2_platform_program
{
"mode": "read",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "current bounded group-membership page",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}identity.group.membership.set
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "explicit user/group membership",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.group.read
Tool reference · read_v2_platform_program
{
"mode": "read",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "one managed group",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}identity.group.status.set
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "group active status",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.group.update
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "group descriptive fields",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.native-user.create
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "native user without password material",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.native-user.list
Tool reference · read_v2_platform_program
{
"mode": "read",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "bounded managed native-user page",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}identity.native-user.password.set
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "temporary password replacement without retention",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.native-user.read
Tool reference · read_v2_platform_program
{
"mode": "read",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "one managed native user",
"previewRequired": false,
"idempotencyRequired": false,
"workClass": "short"
}identity.native-user.status.set
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "native user active status",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.native-user.update
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "native user descriptive fields",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}identity.server-administrator.access.set
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": "strict typed V2 arguments",
"result": "audited Server Administrator authority",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}platform.workspace.create
Tool reference · execute_v2_platform_program
{
"mode": "atomic_write",
"permission": "platform_operator",
"arguments": {
"workspaceId": "stable ID",
"name": "display name"
},
"result": "blank workspace and creator Administrator grant",
"previewRequired": false,
"idempotencyRequired": true,
"workClass": "short"
}Dedicated reset function
1 functions in this local catalog.
workspace.reset.apply
Tool reference · apply_v2_workspace_reset
{
"mode": "atomic_write",
"permission": "platform_operator_and_workspace_admin_and_migration_owner",
"arguments": {
"manifestDigest": "sha256 from prepare",
"expiresAt": "epoch seconds from prepare",
"signature": "signature from prepare"
},
"result": "retained reset receipt after bounded workspace deletion",
"previewRequired": true,
"idempotencyRequired": true,
"workClass": "long",
"requiredCapabilities": []
}{
"idempotency": "same_key_same_content_returns_original_changed_content_conflicts",
"uncertainOutcome": "exact_replay_before_new_intent",
"reconciliation": {
"strategy": "resubmit_same_key_and_identical_content",
"changedContent": "typed_conflict"
}
}