Skip to content

feat(tracing): add TypeScript SDK and publish pipeline#126

Merged
davidfarah2003 merged 6 commits intomainfrom
add_trace_sdk
Apr 11, 2026
Merged

feat(tracing): add TypeScript SDK and publish pipeline#126
davidfarah2003 merged 6 commits intomainfrom
add_trace_sdk

Conversation

@davidfarah2003
Copy link
Copy Markdown
Contributor

Summary

  • Add TypeScript tracing SDK (@kayba_ai/tracing) wrapping mlflow-tracing — mirrors the Python SDK API
  • Restructure tracing code into sdk/ directory with standalone kayba-tracing Python package
  • ace.tracing re-exports from kayba_tracing so existing imports keep working
  • Update CI publish workflow for all three packages with trusted publishing (OIDC)
  • Bump all package versions to 0.9.5

SDK usage

Python (unchanged):

from ace.tracing import configure, trace
# or standalone:
from kayba_tracing import configure, trace

TypeScript (new):

import kayba from "@kayba_ai/tracing";
kayba.configure({ apiKey: "kb-...", folder: "my-project" });
const myFunc = kayba.trace(async () => { ... }, { name: "my_func" });

Test plan

  • All 26 Python tracing tests pass with updated imports
  • TypeScript SDK compiles and builds (CJS + ESM + .d.ts)
  • Tested end-to-end against local Kayba backend with real LLM calls
  • Verified traces stored correctly with full span tree in markdown
  • Published @kayba_ai/tracing@0.9.4 to npm, verified install from fresh project

🤖 Generated with Claude Code

Adds ace.tracing module that wraps MLflow behind a Kayba-branded API.
Users install ace-framework[tracing] and call configure(api_key=...) to
send traces to the Kayba dashboard — MLflow is never exposed.

API: configure(), @trace, start_span(), set_folder(), enable/disable.
…mple

- experiment= is now an alias for folder= (no mlflow.set_experiment call)
- Folder names are sanitized: HTML stripped, allowlist enforced, capped at 256 chars
- Add GLM 5.1 two-agent example (examples/tracing_glm_example.py)
- Add agent guide for tracing SDK (agent-guides/tracing-sdk.md)
- Move Python tracing code to sdk/python/ as standalone kayba-tracing package
- ace/tracing/ re-exports from kayba_tracing so both import paths work
- Add TypeScript SDK (sdk/typescript/) wrapping mlflow-tracing for Node.js
- Update publish workflow for all three packages (ace-framework,
  kayba-tracing, @kayba_ai/tracing) with trusted publishing (OIDC)
- Update test imports from ace.tracing._wrapper to kayba_tracing._wrapper
@davidfarah2003 davidfarah2003 merged commit 22af19f into main Apr 11, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant