Execution

Fully deterministic — no LLM involved. The same entity, concept version, condition version, and timestamp always produce the same Result (Rₜ) and Decision (Aₜ).

---

Execute Full Pipeline

POST /evaluate/full

Runs concept execution (ψ), condition evaluation (φ), and action triggering (α) in one atomic request. Returns a FullPipelineResult containing the Result (Rₜ) and Decision (Aₜ).

Determinism: Provide a timestamp for fully deterministic, reproducible execution. Omit for snapshot mode — current data, not guaranteed reproducible.

dry_run

Pass dry_run: true to simulate without firing actions. decision.actions_triggered[].status will be "would_trigger".

Request Body

Parameter	Type	Required	Description
concept_id / concept_version	string	Required	Pinned concept reference.
condition_id / condition_version	string	Required	Pinned condition reference.
entity	string	Required	Entity to evaluate.
timestamp	datetime	Optional	ISO 8601 UTC. Provides deterministic execution.
explain	boolean	Optional	Default false. Include Explanation in Result (Rₜ).
dry_run	boolean	Optional	Default false. Simulate without firing actions.

Response — FullPipelineResult

Parameter	Type	Required	Description
result	Result (Rₜ)	Always	Concept execution output.
result.value	number|bool|string	Always	Computed output. Type matches declared output type.
result.deterministic	boolean	Always	true when timestamp was provided.
decision	Decision (Aₜ)	Always	Condition evaluation output.
decision.value	boolean|string	Always	true/false for boolean strategies; matched label for equals.
decision.actions_triggered	array	Always	action_id, status, payload_sent, error? per action.

Response Codes

Status	Description
200	Pipeline executed. Action failures return 200 with per-action status.
401	Unauthorised.
404	Concept, condition, or entity not found.
408	Execution timed out (30s).
422	Execution failed — missing data or null propagation.
429	Rate limit.

TypeScript Example

const pipeline = await client.evaluateFull({
  conceptId: "org.churn_risk",
  conceptVersion: "1.2",
  conditionId: "org.high_churn",
  conditionVersion: "1.0",
  entity: "user_abc123",
  timestamp: new Date().toISOString(),
  explain: true,
});

console.log(pipeline.result.value);        // 0.87  (Result Rₜ)
console.log(pipeline.result.deterministic); // true
console.log(pipeline.decision.value);       // true  (Decision Aₜ)

pipeline.decision.actions_triggered.forEach(a =>
  console.log(a.action_id, a.status)
);