Metadata-Version: 2.5
Name: kitaru-jsonl-importer
Version: 0.1.1
Summary: Canonical JSONL session importer for Kitaru.
Project-URL: Homepage, https://kitaru.ai
Project-URL: Documentation, https://docs.zenml.io/kitaru/guides/importing-sessions
Project-URL: Repository, https://github.com/zenml-io/kitaru
Project-URL: Issues, https://github.com/zenml-io/kitaru/issues
Project-URL: Changelog, https://github.com/zenml-io/kitaru/blob/develop/plugins/packages/jsonl-importer/CHANGELOG.md
Author-email: ZenML GmbH <info@zenml.io>
License-Expression: Apache-2.0
Keywords: ai-agents,jsonl,kitaru,observability,traces
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: kitaru>=0.22.0
Description-Content-Type: text/markdown

# Kitaru JSONL importer

Import sessions that already match Kitaru's canonical JSONL session contract. This package backs the built-in `kitaru/kitaru-jsonl` importer and validates each line independently on a Kitaru worker.

Most users do not install or call this package directly. Start a Kitaru worker, then select the built-in importer:

```bash
kitaru session import sessions.jsonl \
  --importer kitaru/kitaru-jsonl@latest \
  --agent support-agent@latest \
  --wait
```

Write one complete Kitaru session object per line. Unknown fields and invalid records are rejected independently, so valid lines in the same upload can still import. Use a provider-specific importer when the input is a raw observability export rather than canonical Kitaru JSONL.

See the [Kitaru JSONL guide](https://docs.zenml.io/kitaru/guides/importing-sessions) for the full session and node schema.

Nodes must use the flat indexed representation; no nested parent-depth limit applies to those indexes. Costs must be finite and nonnegative, and token counts must be nonnegative. A line whose data cannot decode or serialize is reported as a failure without preventing valid neighboring lines from importing.

## Links

- [Kitaru documentation](https://docs.zenml.io/kitaru)
- [Source code](https://github.com/zenml-io/kitaru)
- [Issue tracker](https://github.com/zenml-io/kitaru/issues)

Licensed under Apache-2.0.
