provenance: pass directly through thought::dispatch, remove globals

Provenance now flows as a function parameter through the entire tool
dispatch chain: thought::dispatch → memory::dispatch → store methods.

Removed task_local (TASK_AGENT), thread_local (TASK_PHASE), and env
var (POC_PROVENANCE) from the tool dispatch path. The env var remains
only as a fallback for non-tool paths (CLI commands, digest).

Phase names are passed from knowledge.rs → llm.rs → api.rs, and
api.rs updates the provenance string between steps. No globals needed.
This commit is contained in:
ProofOfConcept 2026-03-27 15:44:39 -04:00
parent 36bde60ba0
commit 92ca2bf2c8
7 changed files with 34 additions and 47 deletions

View file

@ -39,8 +39,8 @@ pub async fn dispatch(
return result.unwrap_or_else(ToolOutput::error);
}
// Delegate to shared thought layer
if let Some(output) = crate::thought::dispatch(name, args, tracker).await {
// Delegate to shared thought layer (poc-agent uses default provenance)
if let Some(output) = crate::thought::dispatch(name, args, tracker, None).await {
return output;
}

View file

@ -37,7 +37,7 @@ pub use parse::{MemoryUnit, parse_units};
pub use view::{StoreView, AnyView};
pub use persist::fsck;
pub use persist::strip_md_keys;
pub use ops::{TASK_AGENT, set_phase};
pub use ops::current_provenance;
use crate::graph::{self, Graph};

View file

@ -7,34 +7,11 @@ use super::types::*;
use std::collections::{HashMap, HashSet};
tokio::task_local! {
/// Task-scoped agent name for provenance. Set before running an agent's
/// tool calls, so all writes within that task are attributed to the agent.
pub static TASK_AGENT: String;
}
thread_local! {
/// Current phase within a multi-step agent. Updated by the bail function
/// between steps. Combined with TASK_AGENT to form the full provenance.
static TASK_PHASE: std::cell::RefCell<Option<String>> = const { std::cell::RefCell::new(None) };
}
/// Set the current phase (called from bail function between steps).
pub fn set_phase(phase: &str) {
TASK_PHASE.with(|p| *p.borrow_mut() = Some(phase.to_string()));
}
/// Get the full provenance string: "agent:phase" or "agent" or env var or "manual".
/// Fallback provenance for non-tool-dispatch paths (CLI, digest, etc.).
/// Tool dispatch passes provenance directly through thought::dispatch.
pub fn current_provenance() -> String {
let agent = TASK_AGENT.try_with(|a| a.clone()).ok();
let phase = TASK_PHASE.with(|p| p.borrow().clone());
match (agent, phase) {
(Some(a), Some(p)) => format!("{}:{}", a, p),
(Some(a), None) => a,
_ => std::env::var("POC_PROVENANCE")
.unwrap_or_else(|_| "manual".to_string()),
}
std::env::var("POC_PROVENANCE")
.unwrap_or_else(|_| "manual".to_string())
}
impl Store {

View file

@ -32,8 +32,9 @@ fn get_client() -> Result<&'static ApiClient, String> {
/// context carries forward naturally between steps.
/// Returns the final text response after all steps complete.
pub async fn call_api_with_tools(
_agent: &str,
agent: &str,
prompts: &[String],
phases: &[String],
temperature: Option<f32>,
bail_fn: Option<&(dyn Fn(usize) -> Result<(), String> + Sync)>,
log: &dyn Fn(&str),
@ -46,6 +47,13 @@ pub async fn call_api_with_tools(
// Build tool definitions — all shared tools (memory, files, bash, journal)
let tool_defs = thought::all_definitions();
let tracker = ProcessTracker::new();
// Provenance tracks which agent:phase is making writes.
// Updated between steps by the bail function via set_provenance().
let first_phase = phases.first().map(|s| s.as_str()).unwrap_or("");
let provenance = std::cell::RefCell::new(
if first_phase.is_empty() { format!("agent:{}", agent) }
else { format!("agent:{}:{}", agent, first_phase) }
);
// Start with the first prompt as a user message
let mut messages = vec![Message::user(&prompts[0])];
@ -157,7 +165,8 @@ pub async fn call_api_with_tools(
}
};
let output = match thought::dispatch(&call.function.name, &args, &tracker).await {
let prov = provenance.borrow().clone();
let output = match thought::dispatch(&call.function.name, &args, &tracker, Some(&prov)).await {
Some(out) => out,
None => thought::ToolOutput::error(format!("Unknown tool: {}", call.function.name)),
};
@ -187,6 +196,10 @@ pub async fn call_api_with_tools(
if let Some(ref check) = bail_fn {
check(next_prompt_idx)?;
}
// Update provenance for the new phase
if let Some(phase) = phases.get(next_prompt_idx) {
*provenance.borrow_mut() = format!("agent:{}:{}", agent, phase);
}
messages.push(Message::assistant(&text));
let next = &prompts[next_prompt_idx];
next_prompt_idx += 1;
@ -206,6 +219,7 @@ pub async fn call_api_with_tools(
pub fn call_api_with_tools_sync(
agent: &str,
prompts: &[String],
phases: &[String],
temperature: Option<f32>,
bail_fn: Option<&(dyn Fn(usize) -> Result<(), String> + Sync)>,
log: &(dyn Fn(&str) + Sync),
@ -216,10 +230,8 @@ pub fn call_api_with_tools_sync(
.enable_all()
.build()
.map_err(|e| format!("tokio runtime: {}", e))?;
let agent_name = format!("agent:{}", agent);
rt.block_on(
crate::store::TASK_AGENT.scope(agent_name,
call_api_with_tools(agent, prompts, temperature, bail_fn, log))
call_api_with_tools(agent, prompts, phases, temperature, bail_fn, log)
)
}).join().unwrap()
})

View file

@ -333,17 +333,13 @@ fn run_one_agent_inner(
.map(|s| s.prompt.clone()).collect();
let step_phases: Vec<String> = agent_batch.steps.iter()
.map(|s| s.phase.clone()).collect();
let step_phases_for_bail = step_phases.clone();
for (i, s) in agent_batch.steps.iter().enumerate() {
log(&format!("=== PROMPT {}/{} ({}) ===\n\n{}", i + 1, n_steps, s.phase, s.prompt));
}
log("\n=== CALLING LLM ===");
// Set initial phase for provenance tracking
if let Some(first_phase) = step_phases.first() {
crate::store::set_phase(first_phase);
}
// Bail check: if the agent defines a bail script, run it between steps.
// The script receives the pid file path as $1, cwd = state dir.
let bail_script = def.bail.as_ref().map(|name| {
@ -355,9 +351,8 @@ fn run_one_agent_inner(
let pid_path_for_bail = pid_path.clone();
let bail_fn = move |step_idx: usize| -> Result<(), String> {
// Update phase in pid file and provenance tracking
if step_idx < step_phases.len() {
write_pid(&step_phases[step_idx]);
crate::store::set_phase(&step_phases[step_idx]);
if step_idx < step_phases_for_bail.len() {
write_pid(&step_phases_for_bail[step_idx]);
}
// Run bail script if defined
if let Some(ref script) = bail_script {
@ -375,7 +370,7 @@ fn run_one_agent_inner(
Ok(())
};
let output = llm::call_for_def_multi(def, &prompts, Some(&bail_fn), log)?;
let output = llm::call_for_def_multi(def, &prompts, &step_phases, Some(&bail_fn), log)?;
Ok(AgentResult {
output,

View file

@ -20,7 +20,8 @@ pub(crate) fn call_simple(caller: &str, prompt: &str) -> Result<String, String>
};
let prompts = vec![prompt.to_string()];
super::api::call_api_with_tools_sync(caller, &prompts, None, None, &log)
let phases = vec![];
super::api::call_api_with_tools_sync(caller, &prompts, &phases, None, None, &log)
}
/// Call a model using an agent definition's configuration (multi-step).
@ -28,10 +29,11 @@ pub(crate) fn call_simple(caller: &str, prompt: &str) -> Result<String, String>
pub(crate) fn call_for_def_multi(
def: &super::defs::AgentDef,
prompts: &[String],
phases: &[String],
bail_fn: Option<&(dyn Fn(usize) -> Result<(), String> + Sync)>,
log: &(dyn Fn(&str) + Sync),
) -> Result<String, String> {
super::api::call_api_with_tools_sync(&def.agent, prompts, def.temperature, bail_fn, log)
super::api::call_api_with_tools_sync(&def.agent, prompts, phases, def.temperature, bail_fn, log)
}

View file

@ -74,10 +74,11 @@ pub async fn dispatch(
name: &str,
args: &serde_json::Value,
tracker: &ProcessTracker,
provenance: Option<&str>,
) -> Option<ToolOutput> {
// Memory and journal tools
if name.starts_with("memory_") || name.starts_with("journal_") || name == "output" {
let result = memory::dispatch(name, args, None);
let result = memory::dispatch(name, args, provenance);
return Some(match result {
Ok(s) => ToolOutput::text(s),
Err(e) => ToolOutput::error(e),