Summarize completedTx in tool calll response

[bfollington]

• WIP tx-analysis
• Add real implementation
• Remove test data and scripts
• Refine tx summary

---

Summary by cubic

Return a concise transaction summary alongside tool call results to help LLMs debug without large payloads. The result now includes { value, summary } built from the completed transaction.

• New Features

  • Added transaction-summary module with summarizeTransaction, formatTransactionSummary, debugTransactionWrites, and TransactionSummary type.
  • llm-dialog now resolves tool calls with { value, summary } using formatTransactionSummary(completedTx, space).
  • Re-exported summary helpers from packages/runner/src/index.ts.
  • Added TX_ROLLUP_README and unit tests for summary behavior.

• Migration

  • Update consumers of tool call results to handle an object: { value, summary } instead of a raw value.
  • Pass the MemorySpace to formatTransactionSummary for detailed write values when needed.

[linear]

CT-978 Include completedTx contents in tool call result

[cubic-dev-ai]

No issues found across 5 files

[cubic-dev-ai]

2 issues found across 5 files

Prompt for AI agents (all 2 issues)

Understand the root cause of the following 2 issues and fix them.


<file name="packages/runner/src/storage/transaction-summary.ts">

<violation number="1" location="packages/runner/src/storage/transaction-summary.ts:131">
When a space is provided but no write details are available (writes occurred elsewhere or produced no novelty), this branch ladder returns an empty string and hides the summary from summarizeTransaction. Fall back to summary.summary so the caller still gets a description.</violation>
</file>

<file name="packages/runner/src/builtins/llm-dialog.ts">

<violation number="1" location="packages/runner/src/builtins/llm-dialog.ts:823">
Handler tool results are now double-wrapped, so LLM/tool consumers receive `{ value: { value, summary } }` instead of the handler output.</violation>
</file>

_{React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.}

[cubic-dev-ai]

Handler tool results are now double-wrapped, so LLM/tool consumers receive { value: { value, summary } } instead of the handler output.

Prompt for AI agents

Address the following comment on packages/runner/src/builtins/llm-dialog.ts at line 823:

<comment>Handler tool results are now double-wrapped, so LLM/tool consumers receive `{ value: { value, summary } }` instead of the handler output.</comment>

<file context>
@@ -811,8 +815,13 @@ async function invokeToolCall(
+        const summary = formatTransactionSummary(completedTx, space);
+        const value = result.withTx(completedTx).get();
+
+        resolve({ value, summary });
+      });
     } else {
</file context>

[cubic-dev-ai]

No issues found across 1 file