agentcompile 0.2.0__tar.gz → 0.2.1__tar.gz

agentcompile-0.2.1/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @kbhatnagar1506

agentcompile-0.2.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,23 @@
+name: Bug report
+description: Something in the SDK doesn't work as documented
+labels: [bug]
+body:
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened, and what did you expect?
+    validations: { required: true }
+  - type: textarea
+    id: repro
+    attributes:
+      label: Minimal code to reproduce
+      render: python
+  - type: input
+    id: versions
+    attributes:
+      label: Versions
+      placeholder: agentcompile 0.2.0, openai 2.x, Python 3.12
+  - type: textarea
+    id: trail
+    attributes:
+      label: Trail lines (`agentcompile trail --json`), with secrets removed

agentcompile-0.2.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security problem
+    url: https://github.com/kbhatnagar1506/agentcompile-python/security/advisories/new
+    about: Report vulnerabilities privately, not as an issue.

agentcompile-0.2.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,9 @@
+name: Feature request
+description: Something you'd like the SDK to do
+labels: [enhancement]
+body:
+  - type: textarea
+    id: need
+    attributes:
+      label: What do you need, and why?
+    validations: { required: true }

agentcompile-0.2.1/.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule: { interval: weekly }
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule: { interval: weekly }

agentcompile-0.2.1/.github/pull_request_template.md

@@ -0,0 +1,6 @@
+## What and why
+
+## Checklist
+- [ ] Tests added or updated
+- [ ] Commit messages follow Conventional Commits (`fix:`, `feat:`, ...)
+- [ ] The SDK still never raises into the caller and still fails open

agentcompile-0.2.1/.release-please-manifest.json

@@ -0,0 +1 @@
+{".":"0.2.1"}

agentcompile-0.2.1/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## [0.2.1](https://github.com/kbhatnagar1506/agentcompile-python/compare/v0.2.0...v0.2.1) (2026-10-01)
+
+
+### Bug Fixes
+
+* keep AgentCompile's decision events in the trail ([#5](https://github.com/kbhatnagar1506/agentcompile-python/issues/5)) ([944c178](https://github.com/kbhatnagar1506/agentcompile-python/commit/944c178e5121f3389041335e36cee06a7f80e441))
+
+## [0.2.0](https://github.com/kbhatnagar1506/agentcompile-python/compare/agentcompile-v0.1.0...agentcompile-v0.2.0) (2026-10-01)
+
+
+### Features
+
+* agentcompile --version ([c2fea67](https://github.com/kbhatnagar1506/agentcompile-python/commit/c2fea67a3bc9b23457a41545f19f94f8005583ce))

agentcompile-0.2.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+# Code of conduct
+
+Be respectful and constructive. Harassment, personal attacks and discrimination of any kind are not welcome in issues, pull requests or any other project space.
+
+Maintainers may edit or remove comments, and block contributors, who don't follow this.
+
+Report problems to founders@tryagentcompile.com.

agentcompile-0.2.1/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+Thanks for helping. Issues and pull requests are welcome.
+
+## Setup
+
+```
+pip install -e ".[dev]" ruff
+pytest
+ruff check src tests && ruff format --check src tests
+```
+
+## Pull requests
+
+- One change per pull request, with a test.
+- Commit messages follow [Conventional Commits](https://www.conventionalcommits.org): `fix: ...`, `feat: ...`, `docs: ...`, `chore: ...`. They decide the next version and the changelog.
+- CI must pass on Python 3.9 and 3.13 before a pull request can merge.
+- The SDK must stay safe in someone's live path: it never raises into the caller's agent, never edits the caller's prompts, and fails open.
+
+## Releases
+
+Maintainers merge the release pull request that release-please keeps open; that tags the release and publishes it to PyPI.

{agentcompile-0.2.0 → agentcompile-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentcompile
-Version: 0.2.0
+Version: 0.2.1
 Summary: Wrap your agent's model client: repeated jobs run compiled, everything else goes to your model unchanged.
 Project-URL: Homepage, https://tryagentcompile.com
 Author-email: AgentCompile <founders@tryagentcompile.com>
@@ -25,6 +25,8 @@ Description-Content-Type: text/markdown
 
 # agentcompile
 
+[![PyPI](https://img.shields.io/pypi/v/agentcompile)](https://pypi.org/project/agentcompile/) [![Python](https://img.shields.io/pypi/pyversions/agentcompile)](https://pypi.org/project/agentcompile/) [![CI](https://github.com/kbhatnagar1506/agentcompile-python/actions/workflows/ci.yml/badge.svg)](https://github.com/kbhatnagar1506/agentcompile-python/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+
 ```
 pip install agentcompile
 ```

{agentcompile-0.2.0 → agentcompile-0.2.1}/README.md

@@ -1,5 +1,7 @@
 # agentcompile
 
+[![PyPI](https://img.shields.io/pypi/v/agentcompile)](https://pypi.org/project/agentcompile/) [![Python](https://img.shields.io/pypi/pyversions/agentcompile)](https://pypi.org/project/agentcompile/) [![CI](https://github.com/kbhatnagar1506/agentcompile-python/actions/workflows/ci.yml/badge.svg)](https://github.com/kbhatnagar1506/agentcompile-python/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+
 ```
 pip install agentcompile
 ```

agentcompile-0.2.1/SECURITY.md

@@ -0,0 +1,18 @@
+# Security
+
+## Reporting a vulnerability
+
+Please don't open a public issue for security problems. Report them privately through **GitHub → Security → Report a vulnerability** on this repository, or email founders@tryagentcompile.com.
+
+We'll acknowledge your report within 3 business days and keep you updated until it's fixed.
+
+## How the SDK handles your data
+
+- Your model provider key never leaves your process: the SDK calls your provider itself.
+- To decide, the SDK sends the conversation's messages, system prompt, tool definitions and model name to AgentCompile, with your AgentCompile key. Nothing else from the request is sent.
+- If AgentCompile fails, is slow or answers something unusable, your call goes straight to your model (fail-open).
+- The trail is written only to a local file (`~/.agentcompile/trail.jsonl` by default) unless you pass `trail=False`.
+
+## Supported versions
+
+Security fixes go into the latest release.

{agentcompile-0.2.0 → agentcompile-0.2.1}/src/agentcompile/_core.py

@@ -65,6 +65,7 @@ class Router:
             tool=decision.tool if decision else None,
             reason=(decision.reason if decision and decision.action == "forward" else None)
             or error,
+            events=list(decision.events) if decision and decision.events else None,
             decide_ms=round(decide_ms, 1) if decide_ms is not None else None,
             total_ms=round((time.perf_counter() - started) * 1000, 1),
             stream=stream or None,

{agentcompile-0.2.0 → agentcompile-0.2.1}/src/agentcompile/_decide.py

@@ -22,12 +22,17 @@ class Decision:
     call_id: str | None = None
     text: str | None = None
     reason: str | None = None
+    # What AgentCompile decided along the way (which job, what it asked, why it handed
+    # off), as the server reported it: kept so the trail can show it.
+    events: tuple[dict[str, Any], ...] = ()
 
     @classmethod
     def parse(cls, body: Any) -> Decision | None:
         if not isinstance(body, dict):
             return None
         action = body.get("action")
+        raw = body.get("events")
+        events = tuple(e for e in (raw if isinstance(raw, list) else []) if isinstance(e, dict))
         if (
             action == "tool_call"
             and isinstance(body.get("tool"), str)
@@ -38,11 +43,12 @@ class Decision:
                 tool=body["tool"],
                 args=body["args"],
                 call_id=str(body.get("call_id") or ""),
+                events=events,
             )
         if action == "say" and isinstance(body.get("text"), str):
-            return cls(action, text=body["text"])
+            return cls(action, text=body["text"], events=events)
         if action == "forward":
-            return cls(action, reason=str(body.get("reason") or ""))
+            return cls(action, reason=str(body.get("reason") or ""), events=events)
         return None
 
 

{agentcompile-0.2.0 → agentcompile-0.2.1}/src/agentcompile/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.0'
-__version_tuple__ = version_tuple = (0, 2, 0)
+__version__ = version = '0.2.1'
+__version_tuple__ = version_tuple = (0, 2, 1)
 
 __commit_id__ = commit_id = None

{agentcompile-0.2.0 → agentcompile-0.2.1}/tests/test_wrap.py

@@ -169,6 +169,27 @@ def test_forward_calls_the_model_with_our_keyword_removed(tmp_path: Path) -> Non
     assert event["route"] == "forwarded" and event["reason"] == "no job matched"
 
 
+def test_the_trail_keeps_what_agentcompile_decided_along_the_way(tmp_path: Path) -> None:
+    events = [
+        {"decision": "activate_recipe", "recipe": "cancel_order"},
+        {"decision": "forward", "reason": "the customer asked a question"},
+    ]
+    fake = Fake({**FORWARD, "events": events})
+    _openai(fake, tmp_path).chat.completions.create(
+        model="gpt-x", messages=MESSAGES, conversation_id="c1"
+    )
+    assert _trail(tmp_path)[0]["events"] == events
+
+
+def test_malformed_events_are_dropped_not_fatal(tmp_path: Path) -> None:
+    fake = Fake({**CALL, "events": ["not a dict", {"decision": "emit_read"}]})
+    _openai(fake, tmp_path).chat.completions.create(
+        model="gpt-x", messages=MESSAGES, conversation_id="c1"
+    )
+    event = _trail(tmp_path)[0]
+    assert event["route"] == "compiled" and event["events"] == [{"decision": "emit_read"}]
+
+
 @pytest.mark.parametrize(
     "fake",
     [

agentcompile-0.2.0/.release-please-manifest.json

@@ -1 +0,0 @@
-{".":"0.2.0"}

agentcompile-0.2.0/CHANGELOG.md

@@ -1,8 +0,0 @@
-# Changelog
-
-## [0.2.0](https://github.com/kbhatnagar1506/agentcompile-python/compare/agentcompile-v0.1.0...agentcompile-v0.2.0) (2026-10-01)
-
-
-### Features
-
-* agentcompile --version ([c2fea67](https://github.com/kbhatnagar1506/agentcompile-python/commit/c2fea67a3bc9b23457a41545f19f94f8005583ce))