Asset Core Docs

Deterministic world-state engine documentation and API references.

Decision Gate docs

assetcore_reverse_commit

AssetCore is a deterministic structured memory substrate. It stores all world state explicitly in containers and modifies that state through atomic, replayable transactions. Apply a stored reverse plan from the undo sidecar as a compensating commit after validating expected post-state.

Details

AssetCore is a deterministic structured memory substrate. It stores all world state explicitly in containers and modifies that state through atomic, replayable transactions. Apply a stored reverse plan from the undo sidecar as a compensating commit after validating expected post-state.

Calls POST /v1/write/namespaces/{namespace_id}/commits/{commit_id}/reverse with a required audit reason plus optional idempotency_key, metadata, and origin. The daemon loads a stored reverse plan from the undo sidecar, captured at commit time from the undo log plus post-state, and validates that the current state still matches the plan’s expected post-state before applying it as a new commit. Reverse commits append a compensating commit, do not rewrite history, and are mechanical: they apply the stored plan or fail without inferring user intent. Response includes the compensating commit_id, outcome, world_seq ranges, timing metadata, correlation ids, and echoes metadata. Reverse commits fail closed if the undo sidecar entry is missing, the retention policy disallows reversal, or post-state validation fails.

Protocols

  • MCP
  • OpenAI
  • Gemini

Input Schema

{
  "properties": {
    "actor_id": {
      "description": "Optional actor identifier for audit trails.",
      "type": "string"
    },
    "commit_id": {
      "description": "Commit identifier to reverse (hex string).",
      "type": "string"
    },
    "idempotency_key": {
      "description": "Optional idempotency key to deduplicate retries.",
      "type": "string"
    },
    "metadata": {
      "description": "Optional metadata echoed in the response.",
      "type": "object"
    },
    "namespace_id": {
      "description": "Required namespace identifier for all namespaced operations.",
      "minimum": 1,
      "type": "integer"
    },
    "origin": {
      "description": "Optional origin metadata for observability.",
      "properties": {
        "action": {
          "description": "Optional action label.",
          "type": "string"
        },
        "agent_id": {
          "description": "Optional agent identifier.",
          "type": "string"
        },
        "client_session_id": {
          "description": "Optional client session identifier.",
          "type": "string"
        },
        "labels": {
          "description": "Optional structured labels.",
          "type": "object"
        },
        "tool": {
          "description": "Optional tool identifier.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "policy_id": {
      "description": "Optional policy identifier for authorization.",
      "type": "string"
    },
    "reason": {
      "description": "Audit reason for the reverse commit.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "commit_id",
    "reason",
    "namespace_id"
  ],
  "type": "object"
}

Examples

No examples are currently available for this tool.