ARTIFACT-BANKING

Artifact Banking (bankArtifact / readArtifact)

A long-running agent produces outputs that do not fit in a conversation: a worker's full report, a build log, a stage's structured result. The tempting answer is to truncate one and send the head — but the discarded bytes are gone, and nothing records that they ever existed.

Banking is the other answer. The payload is written to disk whole, and what goes into the conversation is a bounded preview plus the exact call that reads the rest. Context cost stays flat, evidence stays complete, and compaction can evict the preview without destroying anything.

Read-back is the tool that already existed: retrieve_context. No new tool, no new name for the model to learn.

Quick start

import { NeuroLink } from "@juspay/neurolink";

const neurolink = new NeuroLink();

const ref = await neurolink.bankArtifact(fullWorkerReport, {
  kind: "worker-report",
  label: "delegate:auth-review",
  sessionId: "review-1421",
});

// Put THIS in the conversation — never the report itself:
//   ref.preview        bounded head slice (1000 chars by default)
//   ref.readBackHint   the literal retrieve_context call that fetches the rest
//   ref.sizeBytes      how much is actually there

// And from host code, whenever you want it back:
const whole = await neurolink.readArtifact(ref.artifactId);
const window = await neurolink.readArtifact(ref.artifactId, {
  offset: 100_000,
  limit: 50_000,
});

The model reads the same artifact with the tool it already has:

// retrieve_context
{ "artifactId": "9f1c…", "offset": 0, "limit": 50000 }
// → { content, totalSize, hasMore, offset, limit }

retrieve_context is registered automatically the first time anything banks — you do not have to configure mcp.outputLimits to get it.

API

Member	Returns	Notes
bankArtifact(payload, options)	BankedArtifactRef	Stores the payload whole; returns id + bounded preview
readArtifact(id, page?)	string | null	Full payload when page is omitted; null if unknown
getArtifactStore()	ArtifactStore	Creates the store on demand and registers retrieve_context
setArtifactStore(store)	void	Swaps the backend for every path, MCP normalizer included