Deliverables Tools

Browse and register work products. Search previously produced charts, exports, data, and reports.

Deliverables are permanent records of work products — everything from auto-captured chart outputs to explicitly packaged analysis results. Unlike ephemerals (which vanish when their cache TTL expires), deliverables persist in the database indefinitely.

deliverables.list@1

List previously produced work products with optional filters and search.

Parameters

Parameter Type Required Default Description
type string no all Filter by type: "chart", "export", "data", "content", "report"
query string no – Keyword search across title, summary, and ref
agent_id integer no – Filter by producing agent ID
limit integer no 20 Max results (max 100)
offset integer no 0 Pagination offset

Example

{
  "name": "data-grout@1/deliverables.list@1",
  "arguments": {
    "type": "chart",
    "limit": 5
  }
}

Response:

{
  "deliverables": [
    {
      "ref": "del_a1b2c3d4e5f6",
      "type": "chart",
      "title": "Monthly Revenue Trend",
      "summary": "Line chart of revenue by month for Q1 2026",
      "created_at": "2026-03-15T05:00:00Z",
      "agent_name": "Finance Agent",
      "has_cache_ref": false
    }
  ],
  "total": 12,
  "limit": 5,
  "offset": 0,
  "message": "12 deliverables found. Use deliverables.get with a ref for full details."
}

Cost

0 credits — database query only.

deliverables.get@1

Retrieve a specific deliverable by its ref. Returns the full payload and metadata.

Parameters

Parameter Type Required Default Description
ref string yes – Deliverable ref (e.g. "del_a1b2c3d4e5f6")

Example

{
  "name": "data-grout@1/deliverables.get@1",
  "arguments": {
    "ref": "del_a1b2c3d4e5f6"
  }
}

Response:

{
  "ref": "del_a1b2c3d4e5f6",
  "type": "chart",
  "title": "Monthly Revenue Trend",
  "summary": "Line chart of revenue by month for Q1 2026",
  "payload": {
    "image_url": "https://...",
    "sparkline": "▁▂▃▅▇"
  },
  "metadata": {
    "source_type": "auto",
    "tool_name": "prism.chart"
  },
  "created_at": "2026-03-15T05:00:00Z",
  "agent": {"id": 42, "name": "Finance Agent"},
  "run_id": 123
}

Cost

0 credits.

deliverables.register@1

Explicitly package and register a work product as a deliverable for permanent storage.

Use this to promote ephemeral cached data or to package any result for later retrieval. Registered deliverables appear in deliverables.list even after the original cache entry expires.

Parameters

Parameter Type Required Default Description
title string yes – Human-readable title
type string yes – "chart", "export", "data", "content", "report"
summary string no – Brief description
payload object no {} The deliverable content (data, URLs, etc.)
cache_ref string no – Reference to cached data to attach
tags array no [] Tags for categorization

Example

{
  "name": "data-grout@1/deliverables.register@1",
  "arguments": {
    "title": "Q1 Revenue Analysis",
    "type": "data",
    "summary": "Filtered and aggregated revenue data for Q1 2026",
    "cache_ref": "rc_abc123",
    "tags": ["revenue", "q1", "2026"]
  }
}

Response:

{
  "ref": "del_f6e5d4c3b2a1",
  "type": "data",
  "title": "Q1 Revenue Analysis",
  "status": "registered",
  "message": "Deliverable registered. Use deliverables.get with ref 'del_f6e5d4c3b2a1' to retrieve."
}

Cost

0 credits.

Lifecycle: Ephemeral → Deliverable

  1. A tool call produces data → cached in ResultCache with a cache_ref
  2. The cached data is visible via ephemerals.list
  3. You can inspect it (ephemerals.inspect), label it (ephemerals.tag), or extend its TTL (ephemerals.extend)
  4. To keep it permanently, call deliverables.register with the cache_ref
  5. The deliverable persists in the database even after the cache entry expires
  6. Find it later via deliverables.list or deliverables.get

When to use which tool

Situation Tool
See what work products have been created list
Get the full content of a deliverable get
Save ephemeral data or results permanently register