Deliverables Tools

Search, retrieve, and register work products. Semantic search over 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 with encrypted-at-rest payloads.

deliverables.list@1

Search and list previously produced work products. When a query is provided, uses semantic search via pgvector embeddings — describe what you’re looking for in natural language rather than exact keywords. Falls back to standard text filtering when embeddings are unavailable.

Parameters

Example — Semantic Search

{
  "name": "data-grout@1/deliverables.list@1",
  "arguments": {
    "query": "customer churn analysis"
  }
}

Example — Type Filter

{
  "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,
  "search_mode": "semantic",
  "message": "12 deliverables found (semantic match). Use deliverables.get with a ref for full details."
}

Cost

0 credits — database/embedding query only.

deliverables.get@1

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

Parameters

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

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 and returns a cache_ref
2. The cached result is visible via ephemerals.list
3. You can inspect it with ephemerals.inspect
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