Skip to content

ollama_artifact_list

List artifacts. ARTIFACT. Metadata-only index of pack artifacts on disk. Returns one compact record per artifact: {pack, slug, title, created_at, weak, corpus_used, evidence_count, section_counts, md_path, json_path}. Filter by pack / date_after / date_before / weak_only / strong_only; sort is newest first. Scans ~/.ollama-intern/artifacts/{incident,repo,change} by default; pass extra_artifact_dirs for additional read-only search surfaces. Full payloads belong to ollama_artifact_read — listing stays cheap.

Parameter Type Required Default Description
pack "incident_pack" \ "repo_pack" \ "change_pack" no
date_after string no ISO timestamp. Include only artifacts with created_at >= date_after.
date_before string no ISO timestamp. Include only artifacts with created_at <= date_before.
weak_only boolean no If true, keep only artifacts where the brief flagged weak=true.
strong_only boolean no If true, keep only artifacts where weak=false. Mutually exclusive with weak_only.
limit integer no Cap on entries returned after sorting (default 50). Apply after filters.
extra_artifact_dirs string[] no Additional read-only search dirs. Canonical identity is still (pack, slug) — extras don’t shift precedence.

The JSON Schema below is generated from the same zod schema the server validates against at the wire — it cannot drift from runtime behavior.

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"pack": {
"description": "Filter to a single pack. Omit to include all three.",
"type": "string",
"enum": [
"incident_pack",
"repo_pack",
"change_pack"
]
},
"date_after": {
"description": "ISO timestamp. Include only artifacts with created_at >= date_after.",
"type": "string"
},
"date_before": {
"description": "ISO timestamp. Include only artifacts with created_at <= date_before.",
"type": "string"
},
"weak_only": {
"description": "If true, keep only artifacts where the brief flagged weak=true.",
"type": "boolean"
},
"strong_only": {
"description": "If true, keep only artifacts where weak=false. Mutually exclusive with weak_only.",
"type": "boolean"
},
"limit": {
"description": "Cap on entries returned after sorting (default 50). Apply after filters.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"extra_artifact_dirs": {
"description": "Additional read-only search dirs. Canonical identity is still (pack, slug) — extras don't shift precedence.",
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
}
}

Every tool returns the standard envelope — tier_used, model, tokens_in/tokens_out, elapsed_ms, backend provenance, warnings. See Envelope & tiers.

Schema + handler: src/tools/artifactList.ts · registration: src/index.ts


Back to the Tool Reference.