Skip to main content
Glama

ChainLock append

chainlock_append

Append a fact-bearing stamp to a named local ChainLock chain when you have a concrete fact to write. Use confirm or dry_run; omit chain to stamp the session chain.

Instructions

Append one fact-bearing stamp to a local ChainLock chain (CL-WP-0.4). Grounded write — not a tip read, not AKM observe, not a LOCKSET seal. Fabric, not Softwares-tab. No Node Gate. Use this when you have a concrete fact to stamp onto a named chain. Do not use it for reading the tip, adaptive memory observation, or sealing LOCKSET; use chainlock_tip, memory_observe, or chainlock_seal instead. Write: additive append (append-only vault; no chainlock_delete). Hash-only or empty fact refuses no-fact. Unknown roster name refuses unknown-chain. Oversized card refuses card-cap. Does not write godlock.uk. Omit c/chain to stamp the session chain. Door aliases: chain→c, s→subject, f→fact, kind→k. Omit k to store kind stamp. subject clips to 80; fact clips to 160 then refuses if still empty. Mutation requires confirm=true (runtime gate) or dry_run=true (preview only, no write). confirm and dry_run stay optional on inputSchema.required. dry_run still returns FG-HALLUC-TOOL, FG-STUB, FG-UNKNOWN-OP, or FG-LOCAL-ONLY when a confirm call would refuse. confirm is consent, not tenant auth, and it does not upgrade shared public-demo isolation. Returns the new stamp (id, h, fh, chain, seq) plus display envelope.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "fact": "<fact>"
    },
    "name": "chainlock_append"
  }
}

Input Schema

NameRequiredDescriptionDefault
cNoOptional chain name. One of genesis, identity, ssh, session, acts, evidence, recall, mesh, library, learn. Alias: chain. Omit both to stamp the session chain.
kNoOptional kind label. Omit to store kind stamp. Alias: kind.
factYesRequired fact text clipped to 160 characters. Empty or hash-only after clip refuses no-fact. Alias: f.
chainNoAlias of c. Omit both to stamp the session chain.
confirmNoDocumented confirmation flag. Optional in inputSchema.required (connector refresh must not break). tools/call still refuses MCP-CONFIRM-REQUIRED when confirm is missing or false unless dry_run=true. confirm is consent to run the call. It is not tenant auth and it does not upgrade shared public-demo isolation.
dry_runNoOptional preview flag. When true, do not write and do not stamp a ledger tip. Allowlist, hallucination, stub, and local-only checks still run and return the same FragGate refuse code a confirm call would get. MCP-DRY-RUN is returned only when that call would have been allowed to proceed. confirm is consent, not tenant auth, and it does not upgrade shared public-demo isolation.
subjectNoOptional subject clipped to 80 characters. Alias: s.

Output Schema

NameRequiredDescriptionDefault
codeNoFragGate or fabric code when present: FG-OK, FG-HALLUC-TOOL, FG-STUB, FG-LOCAL-ONLY, FG-UNKNOWN-OP, FG-GATE-REFUSE, FG-LAMB-REFUSE, or a module refuse such as MESH-* / AKM-*.
doorNoDoor name. The public door is fraggate.
ran_inNoExecution locale (for example aziel-runtime) when present.
resultNoAppend body: ok, stamp (id, c, k, fact, fh, stamp_sha256, prev), card, seq, vault path. Refuses: no-fact, unknown-chain, card-cap.
statusNoHTTP-like status when present on wrappers (200 ok; 400+ error / refuse).
displayNoHuman-facing envelope. Show display.action, title, and summary, then take the next input. Never echo raw tool names.
receiptNoOptional receipt, ledger tip, or TemporalLock/ForgeReceipts exit when the door stamped one.
refusalNoExplicit refuse object, code, or message when the door or engine refused.
engine_opNoResolved engine op when present (often inside result).
ledger_tipNoAsk/refuse ledger tip when the door stamped one.
provenanceNoProvenance / input packet when the pipeline attached one.
session_idNoRaw session id when session plumbing was used. Hidden unless the user asked for the chain.
engine_slugNoResolved engine slug when present (often inside result).
limitationsNoCapability limitations or Remain-OFF notes when present.
engine_digestNo64-hex engine_digest when a true in-process engine ran (often inside result).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv2.0.9
    • changedOutput schema / description
      Previous value: -"Display envelope shown to the user (display.title / display.summary) plus the machine result. Extra engine fields may appear."New value: +"Display envelope shown to the user (display.action / display.title / display.summary) plus the machine result. Extra engine fields may appear. Do not echo raw tool names."
    • changedOutput schema / properties / display / description
      Previous value: -"Human-facing envelope. Show title and summary, then take the next input."New value: +"Human-facing envelope. Show display.action, title, and summary, then take the next input. Never echo raw tool names."
    • addedOutput schema / properties / display / properties / action
      Added value: +{
      +  "description": "Human-visible run frame. Always \"Run aziel runtime\". Product verb titles stay on title. Not a tool name.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / display / properties / image
      Added value: +{
      +  "additionalProperties": true,
      +  "description": "Present only when a real production included png_b64, jpeg_b64 (or the same byte family), or a cited http(s) image URL. No invented thumbs. Omitted on dry_run. reviewed is true only when executed production bytes are attached; a dry_run never mints reviewed.",
      +  "properties": {
      +    "data": {
      +      "description": "Base64 image bytes copied from the production. Omitted for a URL-only cite. Never present on dry_run.",
      +      "type": "string"
      +    },
      +    "mimeType": {
      +      "description": "Sniffed image media type (image/png, image/jpeg, image/webp, or image/gif).",
      +      "type": "string"
      +    },
      +    "reviewed": {
      +      "description": "True only when data came from an executed production. False for a URL cite without bytes. Never true on dry_run.",
      +      "type": "boolean"
      +    },
      +    "source": {
      +      "description": "Production field the image was taken from (for example png_b64, jpeg_b64, or image_url).",
      +      "type": "string"
      +    },
      +    "url": {
      +      "description": "Cited http(s) image URL when the production named one. Not invented.",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • changedOutput schema / properties / display / properties / title / description
      Previous value: -"Short result title for the AI client."New value: +"Product verb title for the AI client. Not a raw tool name."
  2. Changed2 schema fields changedv2.0.8
    • changedInput schema / properties / confirm / description
      Previous value: -"Documented confirmation flag. Optional in inputSchema.required (connector refresh must not break). tools/call still refuses MCP-CONFIRM-REQUIRED when confirm is missing or false unless dry_run=true (preview, no write)."New value: +"Documented confirmation flag. Optional in inputSchema.required (connector refresh must not break). tools/call still refuses MCP-CONFIRM-REQUIRED when confirm is missing or false unless dry_run=true. confirm is consent to run the call. It is not tenant auth and it does not upgrade shared public-demo isolation."
    • changedInput schema / properties / dry_run / description
      Previous value: -"Optional preview flag. When true, return a would-mutate preview and do not write. Alternative to confirm=true. Does not mutate."New value: +"Optional preview flag. When true, do not write and do not stamp a ledger tip. Allowlist, hallucination, stub, and local-only checks still run and return the same FragGate refuse code a confirm call would get. MCP-DRY-RUN is returned only when that call would have been allowed to proceed. confirm is consent, not tenant auth, and it does not upgrade shared public-demo isolation."
  3. Changed3 schema fields changedv2.0.2
    • changedInput schema / description
      Previous value: -"fact is required. Omit c/chain to stamp session. Extra keys such as s/f/kind are aliases; they do not change the append-only rule."New value: +"fact is required. Omit c/chain to stamp session. Extra keys such as s/f/kind are aliases; they do not change the append-only rule. Mutation requires confirm=true or dry_run=true."
    • addedInput schema / properties / confirm
      Added value: +{
      +  "description": "Documented confirmation flag. Optional in inputSchema.required (connector refresh must not break). tools/call still refuses MCP-CONFIRM-REQUIRED when confirm is missing or false unless dry_run=true (preview, no write).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / dry_run
      Added value: +{
      +  "description": "Optional preview flag. When true, return a would-mutate preview and do not write. Alternative to confirm=true. Does not mutate.",
      +  "type": "boolean"
      +}
  4. Changed7 schema fields changedv2.0.1
    • changedInput schema / description
      Previous value: -"fact is required (≤160). Hash-only cards without a fact refuse."New value: +"fact is required. Omit c/chain to stamp session. Extra keys such as s/f/kind are aliases; they do not change the append-only rule."
    • changedInput schema / properties / c / description
      Previous value: -"Optional chain name. One of genesis, identity, ssh, session, acts, evidence, recall, mesh, library, learn. Alias: chain."New value: +"Optional chain name. One of genesis, identity, ssh, session, acts, evidence, recall, mesh, library, learn. Alias: chain. Omit both to stamp the session chain."
    • addedInput schema / properties / chain
      Added value: +{
      +  "description": "Alias of c. Omit both to stamp the session chain.",
      +  "enum": [
      +    "genesis",
      +    "identity",
      +    "ssh",
      +    "session",
      +    "acts",
      +    "evidence",
      +    "recall",
      +    "mesh",
      +    "library",
      +    "learn"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / fact / description
      Previous value: -"Required fact text clipped to 160 characters. Hash-only / empty fact refuses."New value: +"Required fact text clipped to 160 characters. Empty or hash-only after clip refuses no-fact. Alias: f."
    • changedInput schema / properties / k / description
      Previous value: -"Optional kind label for the stamp."New value: +"Optional kind label. Omit to store kind stamp. Alias: kind."
    • changedInput schema / properties / subject / description
      Previous value: -"Optional subject clipped to 80 characters."New value: +"Optional subject clipped to 80 characters. Alias: s."
    • changedOutput schema / properties / result / description
      Previous value: -"FragGate body: ok, code, door, slug, op, engine_digest, ran_in, provenance, refusal, limitations, receipt, plus the engine result. Unknown names refuse FG-HALLUC-TOOL; stubs refuse FG-STUB."New value: +"Append body: ok, stamp (id, c, k, fact, fh, stamp_sha256, prev), card, seq, vault path. Refuses: no-fact, unknown-chain, card-cap."
  5. Addedv1.6.2

TDQS

A5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Despite annotations providing minimal hints, the description thoroughly discloses behavior: append-only (no chainlock_delete), refusal conditions (no-fact, unknown chain, card-cap), the godlock.uk exclusion, the confirm/dry_run gate, and the distinction between consent and tenant auth. This goes far beyond the annotation fields.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but every sentence earns its place. It front-loads the core action, then exclusions, then behavioral rules, then parameter details and output summary. No filler; the structure guides an agent from decision to invocation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with a runtime gate, aliases, multiple refusal conditions, and a specific output shape, the description covers everything needed: when to call, how to call, what can go wrong, and what is returned. The output schema exists, but the description still explains the return envelope, making it self-sufficient.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, but the description adds substantial meaning: alias mappings (chain→c, s→subject, f→fact, kind→k), the clipping behavior with empty-after-clip refusal, the precise semantics of confirm as consent (not auth) and dry_run as a preview that still runs safety checks. These details are not fully captured in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource: 'Append one fact-bearing stamp to a local ChainLock chain'. It then distinguishes itself from three siblings (chainlock_tip, memory_observe, chainlock_seal) and names the exact conditions for use, making its purpose unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states when to use ('when you have a concrete fact to stamp onto a named chain') and when not to ('Do not use it for reading the tip, adaptive memory observation, or sealing LOCKSET'), naming the alternatives. Also covers the session-chain default ('Omit c/chain to stamp the session chain').

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.