tactus 0.21.0__tar.gz → 0.21.1__tar.gz

{tactus-0.21.0 → tactus-0.21.1}/.github/workflows/release.yml

@@ -77,10 +77,10 @@ jobs:
           semantic-release publish
 
       - name: Publish to PyPI
-        if: success()
+        if: success() && hashFiles('dist/*') != ''
         env:
           TWINE_USERNAME: __token__
           TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
         run: |
           pip install twine
-          twine upload dist/*
+          twine upload --skip-existing dist/*

{tactus-0.21.0 → tactus-0.21.1}/.gitignore

@@ -37,6 +37,7 @@ yarn-error.log*
 .tactus/config.yml
 progress.output
 .tac/
+tmp/
 examples/output/
 
 *storybook.log

{tactus-0.21.0 → tactus-0.21.1}/CHANGELOG.md

@@ -2,26 +2,52 @@
 
 <!-- version list -->
 
+## v0.21.1 (2026-01-10)
+
+### Bug Fixes
+
+- **ci**: Add --skip-existing to twine upload
+  ([`7a1b369`](https://github.com/AnthusAI/Tactus/commit/7a1b369376ce68869b98f0faed877a52855b4459))
+
+
 ## v0.21.0 (2026-01-10)
 
 ### Bug Fixes
 
+- Add Checkpoint.exists and Checkpoint.get
+  ([`d652411`](https://github.com/AnthusAI/Tactus/commit/d6524115dea8de42559b94a1f35309f7538958e7))
+
+- Add System.alert primitive
+  ([`18ece11`](https://github.com/AnthusAI/Tactus/commit/18ece114eea760e97b07a493b7ee13eb27034516))
+
 - Clarify summarization prompts are logged
-  ([`1fbabee`](https://github.com/AnthusAI/Tactus/commit/1fbabeef3c6634fb9b2927e39a3e575f1074ff7d))
+  ([`423b912`](https://github.com/AnthusAI/Tactus/commit/423b912c590cd7e9702a0e9dbb76288f26cdfd4a))
 
 - Clarify template namespaces and rendering
-  ([`b4b61c1`](https://github.com/AnthusAI/Tactus/commit/b4b61c15107a85c83c7646d347fafc3dd98943c3))
+  ([`a33a383`](https://github.com/AnthusAI/Tactus/commit/a33a3831fb335b81d1e3152f5feb6d24f436bdb8))
+
+- Expose agent Result usage and history
+  ([`7f41286`](https://github.com/AnthusAI/Tactus/commit/7f412860f94c79a442fc8e86365f71ddddc9b58f))
+
+- Handle string input in agent __call__ method
+  ([`4af6ad5`](https://github.com/AnthusAI/Tactus/commit/4af6ad590cacb116885ce60ca93656c092f01435))
 
 - Remove incompatible tests and skip deprecated YAML test
-  ([`5960ed3`](https://github.com/AnthusAI/Tactus/commit/5960ed3580d958101dffca626c0d2cdd773e83be))
+  ([`f96f084`](https://github.com/AnthusAI/Tactus/commit/f96f0842ceffa8176329b5553096c39ff1ba15d1))
+
+- Standardize on TactusResult.value and fix agent mock lookup
+  ([`a4e02c0`](https://github.com/AnthusAI/Tactus/commit/a4e02c0699a40461a2d0476e1359216d02a82616))
 
 - Support message alias for agent calls
-  ([`43c911b`](https://github.com/AnthusAI/Tactus/commit/43c911bd9ad8aa3be6b7f0751f044d25f40cd9fa))
+  ([`9a2b817`](https://github.com/AnthusAI/Tactus/commit/9a2b817478acf5848dad346fa9d0f0dd1a78eb86))
+
+- **ci**: Only run twine upload when dist files exist
+  ([`d490f55`](https://github.com/AnthusAI/Tactus/commit/d490f5527c8588666ffcafa67d13e195815c2856))
 
 ### Chores
 
 - Update .gitignore to include tmp/ directory
-  ([`9871bae`](https://github.com/AnthusAI/Tactus/commit/9871baeaa0d0dd3a14861d1e88b329164f238a2f))
+  ([`1294360`](https://github.com/AnthusAI/Tactus/commit/1294360a261cec1ff8c35f8063ae2b652c340373))
 
 
 ## v0.20.0 (2026-01-09)

{tactus-0.21.0 → tactus-0.21.1}/IMPLEMENTATION.md

@@ -741,9 +741,9 @@ Defines interface for HITL implementations.
 
 **Specification**: Programmatic alerts from anywhere (not just procedures).
 
-**Status**: ❌ **Not Implemented**
+**Status**: ✅ **Implemented**
 
-Only `Human.notify()` exists, which logs notifications. No `System.alert()` primitive or system-level alert infrastructure.
+Implemented as a non-blocking primitive that emits a structured `SystemAlertEvent` via the configured `LogHandler` (CLI/IDE), with a fallback to standard Python logging when no handler is present.
 
 #### Message Classification
 
@@ -1103,6 +1103,9 @@ Explicit checkpoints do **not** create suspend points. They simply persist curre
 
 - ✅ `Checkpoint.clear_all()` - Clear all checkpoints (execution log)
 - ✅ `Checkpoint.clear_after(position)` - Clear from position onwards
+- ✅ `Checkpoint.next_position()` - Get next checkpoint position
+- ✅ `Checkpoint.exists(position)` - Check whether a checkpoint exists
+- ✅ `Checkpoint.get(position)` - Get cached value (or nil)
 
 **Usage**: Testing and debugging checkpoint replay behavior. These are utility functions for test scenarios, not for production use.
 
@@ -1181,35 +1184,30 @@ main = procedure("main", {
 end)
 ```
 
-#### ResultPrimitive (`tactus/primitives/result.py`)
-
-**Status**: ✅ **Fully Implemented**
+#### Result (`tactus/protocols/result.py`)
 
-Wraps pydantic-ai's `RunResult` for Lua access.
+**Status**: ✅ **Implemented (DSPy)**
 
-**Aligned with pydantic-ai:** Direct mapping to `RunResult.data`, `RunResult.usage()`, `RunResult.new_messages()`, `RunResult.all_messages()`.
+`Agent()` returns a standard `TactusResult` wrapper (instead of raw text).
 
 **Features:**
-- ✅ `result.data` - Response data (text or structured dict)
+- ✅ `result.value` - Response value (string or structured data)
 - ✅ `result.usage` - Token usage stats (prompt_tokens, completion_tokens, total_tokens)
-- ✅ `result.new_messages()` - Messages from this turn
-- ✅ `result.all_messages()` - Full conversation history
-- ✅ `result.cost()` - Token usage (for cost calculation)
+- ✅ `result.cost()` - Cost stats (total_cost, prompt_cost, completion_cost)
+
+**Breaking change:** Access agent output via `result.value` (not `result.message` / `result.data`).
 
-**Breaking change:** `Agent()` now returns `ResultPrimitive` instead of raw data. Access response via `result.data`.
+**Implementation locations:**
+- `tactus/dspy/agent.py` (`DSPyAgentHandle.__call__`)
+- `tactus/protocols/result.py` (`TactusResult`)
+- `tactus/protocols/cost.py` (`UsageStats`, `CostStats`)
 
 **Example:**
 ```lua
 local result = Agent()
-
--- Access response
-Log.info(result.data)
-
--- Access usage
+Log.info(result.value)
 Log.info("Tokens", {total = result.usage.total_tokens})
-
--- Access messages
-local msgs = result.new_messages()
+Log.info("Cost", {total = result.cost().total_cost})
 ```
 
 #### Structured Output (output_type)
@@ -1234,7 +1232,7 @@ agent("extractor", {
 
 -- Agent automatically validates output against schema
 local result = Extractor()
-Log.info(result.data.city)  -- Type-safe access
+Log.info(result.value.city)
 ```
 
 #### State Primitives
@@ -1756,9 +1754,9 @@ tactus evaluate procedure.tac --runs 10
    - Only local context exists
    - No AWS Lambda integration
 
-4. **System.alert()** ❌
-   - No system-level alerts
-   - Only `Human.notify()` exists
+4. **System.alert()** ✅
+   - Non-blocking alerts via `System.alert()`
+   - Emits structured `system_alert` events to log handlers (CLI/IDE)
 
 5. **Async Procedure Spawning** ❌
    - No `Procedure.spawn()` for async invocation
@@ -1825,7 +1823,6 @@ tactus/
 │   ├── retry.py                # RetryPrimitive
 │   ├── file.py                 # FilePrimitive
 │   ├── message_history.py      # MessageHistoryPrimitive
-│   ├── result.py               # ResultPrimitive
 │   └── deps_generator.py       # Dynamic AgentDeps generation [NEW]
 │
 ├── backends/
@@ -1902,7 +1899,7 @@ To align the implementation with the specification:
 ### Medium Priority
 4. **Inline Procedures** - Parse and support `procedures:` section in YAML
 5. **Agent `prepare` hook** - Enable `prepared` template namespace
-6. **System.alert()** - System-level alert infrastructure
+6. **System.alert() integrations** - Route alerts to external monitoring
 7. **Template variables** - Add `context`, `env`, `output` support
 8. **More Model Backends** - BERT, scikit-learn, ONNX, SageMaker
 

{tactus-0.21.0 → tactus-0.21.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tactus
-Version: 0.21.0
+Version: 0.21.1
 Summary: Tactus: Lua-based DSL for agentic workflows
 Project-URL: Homepage, https://github.com/AnthusAI/Tactus
 Project-URL: Documentation, https://github.com/AnthusAI/Tactus/tree/main/docs

{tactus-0.21.0 → tactus-0.21.1}/SPECIFICATION.md

@@ -356,13 +356,11 @@ This ensures type-safe, structured outputs from agents.
 **Aligned with pydantic-ai:** The Result object wraps pydantic-ai's `RunResult` and provides Lua-accessible properties.
 
 **Properties:**
-- `result.message` - The response message (text string or structured data dict)
+- `result.value` - The response value (string or structured data)
 - `result.usage` - Token usage stats (prompt_tokens, completion_tokens, total_tokens)
 
 **Methods:**
-- `result.new_messages()` - Messages from this turn only
-- `result.all_messages()` - Full conversation history
-- `result.cost()` - Token usage (same as .usage, for cost calculation)
+- `result.cost()` - Cost statistics (total_cost, prompt_cost, completion_cost)
 
 **Example:**
 
@@ -377,8 +375,8 @@ Procedure {
     function(input)
         local result = worker()
 
-        -- Access response message
-        Log.info("Response", {message = result.message})
+        -- Access response value
+        Log.info("Response", {value = result.value})
 
         -- Access token usage
         Log.info("Tokens used", {
@@ -387,11 +385,6 @@ Procedure {
             total = result.usage.total_tokens
         })
 
-        -- Access messages
-        local messages = result.new_messages()
-        for i, msg in ipairs(messages) do
-            Log.info("Message", {role = msg.role, content = msg.content})
-        end
     end
 }
 ```
@@ -414,8 +407,8 @@ Procedure {
 
         -- Access structured data fields
         Log.info("Extracted", {
-            city = result.message.city,
-            country = result.message.country
+            city = result.value.city,
+            country = result.value.country
         })
     end
 }
@@ -2197,6 +2190,8 @@ For testing and debugging:
 Checkpoint.clear_all()              -- Clear all checkpoints
 Checkpoint.clear_after(position)    -- Clear checkpoint at position and all after (position is a number)
 Checkpoint.next_position()          -- Get the next checkpoint position number
+Checkpoint.exists(position)         -- Check if a checkpoint exists at a position
+Checkpoint.get(position)            -- Get cached value at a position (or nil)
 ```
 
 ### Human Interaction Primitives
@@ -2477,9 +2472,9 @@ local error_matcher = contains("error")
 
 -- Use in conditional logic
 local result = worker()
-if result.message:find("success") then
+if tostring(result.value):find("success") then
     -- Contains success
-elseif result.message:find("error") then
+elseif tostring(result.value):find("error") then
     -- Contains error
 end
 ```
@@ -3260,4 +3255,4 @@ Tests are executed using Behave programmatically with:
 
 **Declarative + Imperative:** Declare HITL points in YAML for documentation, invoke them in Lua for control.
 
-**BDD Testing:** First-class Gherkin specifications with built-in steps, custom steps, parallel execution, and consistency evaluation.
+**BDD Testing:** First-class Gherkin specifications with built-in steps, custom steps, parallel execution, and consistency evaluation.

{tactus-0.21.0 → tactus-0.21.1}/TECHNICAL_DEBT.md

@@ -77,37 +77,32 @@ These are minor features documented in the spec that could be implemented with s
 
 ### Checkpoint Inspection Methods
 
-The spec documents methods to inspect checkpoint state that don't exist:
-
-```lua
-Checkpoint.exists(name)  -- Check if a checkpoint exists
-Checkpoint.get(name)     -- Get the cached value from a checkpoint
-```
-
-**What exists:** `clear_all()`, `clear_after(position)`, `next_position()`
-
-**Why it matters:** These would be useful for testing and debugging checkpoint behavior.
-
-**Implementation location:** `tactus/primitives/step.py` CheckpointPrimitive class
+Implemented in `tactus/primitives/step.py` (`Checkpoint.exists(position)`, `Checkpoint.get(position)`).
 
 ---
 
 ### Result Object with Usage Statistics
 
-The spec documents a rich Result object with token usage and message history:
+We want a standard Result object with response data + token usage + cost:
 
 ```lua
-result.usage          -- {prompt_tokens, completion_tokens, total_tokens}
-result.new_messages() -- Messages from this turn only
-result.all_messages() -- Full conversation history
-result.cost()         -- Cost calculation
+result.value   -- string or structured data
+result.usage   -- {prompt_tokens, completion_tokens, total_tokens}
+result.cost()  -- {total_cost, prompt_cost, completion_cost}
 ```
 
-**What exists:** `TactusPrediction` with `.text` only
+**What exists now:** `TactusResult` returned by `Agent()` (breaking change: use `result.value`)
+
+**Intentionally not implemented (YAGNI for now):**
+- `result.new_messages()`
+- `result.all_messages()`
 
 **Why it matters:** Users can't track token usage or costs per-call, which is important for optimization and budgeting.
 
-**Implementation location:** `tactus/dspy/prediction.py`
+**Implementation locations:**
+- `tactus/dspy/agent.py`
+- `tactus/protocols/result.py`
+- `tactus/protocols/cost.py`
 
 ---
 

{tactus-0.21.0 → tactus-0.21.1}/docs/DURABILITY.md

@@ -1097,7 +1097,7 @@ class AgentPrimitive:
         )
         return {
             "output": result.output,
-            "messages": self.messages + result.new_messages()
+            "messages": self.messages
         }
 ```
 
@@ -1390,4 +1390,4 @@ result = await runtime.execute(
 
 4. **Observability**: Integration with Logfire/OpenTelemetry for tracing?
 
-5. **Error recovery**: Retry policies, dead letter queues, manual intervention?
+5. **Error recovery**: Retry policies, dead letter queues, manual intervention?

{tactus-0.21.0 → tactus-0.21.1}/docs/TOOL_ROADMAP.md

@@ -1126,7 +1126,7 @@ sequenceDiagram
     PA->>LLM: Send tool result
     LLM-->>PA: Final response
     PA-->>AP: RunResult
-    AP-->>Lua: ResultPrimitive
+    AP-->>Lua: Result
 
     Lua->>Lua: search.called()
     Lua->>Lua: search.last_result()

{tactus-0.21.0 → tactus-0.21.1}/examples/01-basics-hello-world.tac

@@ -5,5 +5,5 @@ World = Agent {
 }
 
 return {
-    message = (World {message = "Hello, World!"}).response
+    World("Hello, World!")
 }

{tactus-0.21.0 → tactus-0.21.1}/examples/05-basics-multi-model.tac

@@ -45,7 +45,7 @@ Procedure {
         if done.called() then
             research = done.last_result() or "Task completed"
         else
-            research = result.message or "Research not completed"
+            research = tostring(result.value) or "Research not completed"
             Log.warn("Researcher did not call done within max turns")
         end
         state.research = research
@@ -66,7 +66,7 @@ Procedure {
         if done.called() then
             summary = done.last_result() or "Task completed"
         else
-            summary = result.message or "Summary not completed"
+            summary = tostring(result.value) or "Summary not completed"
             Log.warn("Summarizer did not call done within max turns")
         end
 

{tactus-0.21.0 → tactus-0.21.1}/examples/06-basics-streaming.tac

@@ -26,7 +26,7 @@ Procedure {
         local result = storyteller({message = input.prompt})
 
         return {
-            story = result.response,
+            story = result.value,
             success = true
         }
     end

{tactus-0.21.0 → tactus-0.21.1}/examples/07-basics-bedrock.tac

@@ -36,9 +36,9 @@ Procedure {
             local response = haiku_assistant()
             turn_count = turn_count + 1
 
-            -- Accumulate the response message from each turn using .message property
-            if response.message and response.message ~= "" then
-                response_text = response_text .. response.message
+            -- Accumulate the response value from each turn using .value property
+            if response.value and response.value ~= "" then
+                response_text = response_text .. response.value
             end
 
             -- Safety check: exit if too many turns

{tactus-0.21.0 → tactus-0.21.1}/examples/08-basics-models.tac

@@ -137,8 +137,8 @@ Procedure {
                     local response = agent_ref()
                     turn_count = turn_count + 1
 
-                    if response.message and response.message ~= "" then
-                        response_text = response_text .. response.message
+                    if response.value and response.value ~= "" then
+                        response_text = response_text .. response.value
                     end
 
                     if turn_count >= max_turns then
@@ -175,7 +175,7 @@ Procedure {
             local success, result = pcall(function(input)
                 local response = agent_ref()
                 return {
-                    response = response.message or "",
+                    response = response.value or "",
                     turns = 1,
                     success = true,
                     error = nil

{tactus-0.21.0 → tactus-0.21.1}/examples/09-basics-google-gemini.tac

@@ -56,8 +56,8 @@ Procedure {
             pro_turns = pro_turns + 1
 
             -- Accumulate the response text
-            if response.message and response.message ~= "" then
-                pro_response = pro_response .. response.message
+            if response.value and response.value ~= "" then
+                pro_response = pro_response .. response.value
             end
 
             -- Safety check
@@ -86,8 +86,8 @@ Procedure {
             flash_turns = flash_turns + 1
 
             -- Accumulate the response text
-            if response.message and response.message ~= "" then
-                flash_response = flash_response .. response.message
+            if response.value and response.value ~= "" then
+                flash_response = flash_response .. response.value
             end
 
             -- Safety check

{tactus-0.21.0 → tactus-0.21.1}/examples/12-feature-structured-output.tac

@@ -1,11 +1,11 @@
 -- Structured Output Demo
 -- Demonstrates using output for structured data extraction
--- and accessing result.data, result.usage
+-- and accessing result.value, result.usage
 
 extractor = Agent {
     provider = "openai",
     model = "gpt-4o-mini",
-    system_prompt = [[You extract city information. Return ONLY structured data with these fields:
+    system_prompt = [[You extract city information. Return ONLY a JSON object with these fields:
 - city: city name
 - country: country name
 - population: estimated population (number, optional)
@@ -32,30 +32,26 @@ Procedure {
     function(input)
         Log.info("Starting structured output demo", {query = input.query})
 
-        -- Call agent - in mock mode, returns mock response
+        -- Agent returns a Result wrapper (not raw data)
         local result = extractor()
 
-        -- Extract city data from response message
-        -- Note: Full result.data/result.usage support pending for mock mode
-        local city_data = {
-            city = "Paris",
-            country = "France",
-            population = 2161000
-        }
-
-        -- If the agent result has message, log it
-        if result and result.message then
-            Log.info("Agent response", {message = result.message})
-        end
-
-        Log.info("Extracted city information", city_data)
+        -- Access structured data via result.value
+        Log.info("Extracted city information", {
+            city = result.value.city,
+            country = result.value.country,
+            population = result.value.population or "unknown"
+        })
 
-        -- Simulated token count for demo
-        local tokens_used = 150
+        -- Access token usage stats
+        Log.info("Token usage", {
+            prompt_tokens = result.usage.prompt_tokens,
+            completion_tokens = result.usage.completion_tokens,
+            total_tokens = result.usage.total_tokens
+        })
 
         return {
-            city_data = city_data,
-            tokens_used = tokens_used
+            city_data = result.value,
+            tokens_used = result.usage.total_tokens
         }
     end
 }

{tactus-0.21.0 → tactus-0.21.1}/examples/15-feature-local-tools.tac

@@ -83,7 +83,7 @@ Procedure {
             end
         else
             -- Max turns reached - use last response
-            answer = result.message
+            answer = tostring(result.value)
         end
 
         return {

{tactus-0.21.0 → tactus-0.21.1}/examples/16-feature-toolsets-advanced.tac

@@ -103,7 +103,7 @@ Procedure {
                 turn_count = turn_count + 1
             until done.called() or turn_count >= max_turns
 
-            local response = result.message
+            local response = tostring(result.value)
             Log.info(agent_name .. " response", {text = response})
             return response
         end
@@ -123,7 +123,7 @@ Procedure {
         -- Test Agent 5: No tools (explicitly empty) - only needs 1 turn
         Log.info("Testing Agent 5: No tools")
         local observer_result = observer()
-        local observer_response = observer_result.message
+        local observer_response = tostring(observer_result.value)
         Log.info("Observer response", {text = observer_response})
 
         return {

{tactus-0.21.0 → tactus-0.21.1}/examples/17-feature-toolsets-dsl.tac

@@ -94,7 +94,8 @@ Procedure {
         else
             Log.warn("Agent did not call done within max turns")
             return {
-                calculation_result = result.message or "Agent did not complete",
+                calculation_result = (result and result.value and tostring(result.value))
+                    or "Agent did not complete",
                 completed = false
             }
         end

{tactus-0.21.0 → tactus-0.21.1}/examples/18-feature-lua-tools-individual.tac

@@ -110,7 +110,7 @@ Procedure {
         if done.called() then
             answer = done.last_result() or "Task completed"
         else
-            answer = result.message
+            answer = tostring(result.value)
         end
 
         return {

{tactus-0.21.0 → tactus-0.21.1}/examples/18-feature-lua-tools-inline.tac

@@ -140,7 +140,7 @@ Procedure {
         if done.called() then
             answer = done.last_result() or "Task completed"
         else
-            answer = result.message
+            answer = tostring(result.value)
         end
 
         if #tools_used > 0 then

{tactus-0.21.0 → tactus-0.21.1}/examples/18-feature-lua-tools-toolset.tac

@@ -158,7 +158,7 @@ Procedure {
         if done.called() then
             answer = done.last_result() or "Task completed"
         else
-            answer = result.message
+            answer = tostring(result.value)
         end
 
         return {

{tactus-0.21.0 → tactus-0.21.1}/examples/61-inline-toolset-lua.tac

@@ -127,8 +127,8 @@ Procedure {
                         answer = reason
                     end
                 end
-            elseif result and result.message then
-                answer = result.message
+            elseif result and result.value then
+                answer = tostring(result.value)
             end
 
             Log.info("Task completed", {result = answer, completed = completed})

{tactus-0.21.0 → tactus-0.21.1}/examples/62-mcp-toolset-by-server.tac

@@ -122,8 +122,8 @@ Procedure {
                         answer = reason
                     end
                 end
-            elseif result and result.message then
-                answer = result.message
+            elseif result and result.value ~= nil then
+                answer = tostring(result.value)
             end
 
             Log.info("Task result", {

{tactus-0.21.0 → tactus-0.21.1}/examples/63-toolset-import-from-file.tac

@@ -106,8 +106,8 @@ Procedure {
                         answer = reason
                     end
                 end
-            elseif result and result.message then
-                answer = result.message
+            elseif result and result.value ~= nil then
+                answer = tostring(result.value)
             end
 
             Log.info("Import result", {

{tactus-0.21.0 → tactus-0.21.1}/examples/99-misc-test-loading.tac

@@ -13,8 +13,8 @@ Procedure {
 
     log("Starting test...")
       local result = test_agent()
-      log("Agent responded: " .. result.data)
+      log("Agent responded: " .. tostring(result.value))
       return {success = true}
 
     end
-}
+}