matrx-api 0.1.0__tar.gz

matrx_api-0.1.0/.gitignore

@@ -0,0 +1,345 @@
+*.pyc
+secrets/
+ignore/
+temp/
+logs/
+# The broad `logs/` rule above is for RUNTIME log output, but it also matched
+# the dashboard's SOURCE directory and silently swallowed an entire feature's
+# files (only the pre-existing index.tsx stayed tracked), breaking the prod
+# Docker build with "Could not resolve ./structured-tab". Re-include the source.
+!apps/dashboard/src/features/logs/
+!apps/dashboard/src/features/logs/**
+todo
+text_notes/
+aidream/secrets/2.env
+automation_matrix/matrix_processing/temp/*
+cd
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+.venv/
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+# The blanket lib/ rule above is from the standard Python .gitignore template
+# and was silently swallowing TS source under the SPA `src/lib/` folders.
+# Re-allow them explicitly so frontend builds don't ship without their lib layer.
+!apps/dashboard/src/lib/
+!apps/dashboard/src/lib/**
+!apps/dashboard/src/features/crawler/lib/
+!apps/dashboard/src/features/crawler/lib/**
+!apps/workflow-studio/src/lib/
+!apps/workflow-studio/src/lib/**
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+ai/tests/clean_response.json
+ai/tests/cx_storage_response.json
+ai/tests/execution_test.py
+ai/tests/final_response.json
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.env_remote
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.env.armanonly
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# random armani files
+/armani_dev/secrets/
+/armani/
+/_armani/
+
+
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+.idea/
+.vscode/
+/node_modules/
+
+# Frontend pnpm workspace (apps/) — node_modules at the workspace root and any
+# member, plus Vite caches and build output. The unified lockfile (apps/pnpm-lock.yaml)
+# IS committed; everything below is regenerated.
+#
+# 🚨 BOTH SPELLINGS. `node_modules/` with the slash matches a DIRECTORY only, so
+# a SYMLINK named `node_modules` slipped straight past it: five of them — each
+# an absolute path into one machine's checkout — were committed on main and
+# broke `pnpm install --frozen-lockfile` on every CI runner, where the symlink
+# is dangling and pnpm's `mkdir` of it answers ENOENT. Every package release was
+# blocked by it. The bare spelling below matches the symlink too.
+node_modules
+node_modules/
+apps/**/.vite/
+apps/**/dist/
+.vite/
+
+dump.rdb
+
+frontend/
+
+# AME Temp Files and directory structure
+# Ignore all files in the temp directory and its subdirectories
+/temp/**/*
+/tmp/**/*
+
+# Allow .gitkeep files to retain directory structure
+!/temp/**/.gitkeep
+!/tmp/**/.gitkeep
+
+# Armani
+.history*
+.history/
+/local_data/
+local_reports_data/
+webscraper/quick_scrapes/temp/
+automation_matrix/ai_apis/fireworks/_dev/*
+automation_matrix/ai_apis/fireworks/_dev/fireworks_sample.py
+*.pdf
+*.flac
+*.mp3
+*.wav
+miniconda.sh
+/database/python_sql/temp_data/
+ .history*
+ .history/
+.history/
+
+_dev/
+/_dev/
+requirements_filtered.txt
+
+# matrx-dev-tools backups
+.env-backups/
+# Matrx Ship config (contains API key)
+.matrx-ship.json
+
+# Matrx config (contains API keys)
+.matrx.json
+.matrx-tools.conf
+
+# Claude Code local worktrees and per-user settings
+.claude/worktrees/
+.worktrees/
+.claude/settings.local.json
+
+# Append-only snapshots from matrx_utils.update_history (unbounded; do not commit)
+common/utils/data_in_code/data_history.json
+packages/matrx-utils/matrx_utils/data_in_code/data_history.json
+
+# Tool-dispatch debug logs — one file per server start, never committed
+.matrx-debug/
+# Per-definition BEFORE snapshots written by a live migration script. They are
+# the recovery record for one machine's run, not repo content — the durable
+# audit trail is the `metadata.migrations` stamp on the row itself.
+.matrx-migrations/
+
+# Trial Bench records written on THIS machine — the trial's JSON record, its §8
+# report and the index that finds them (aidream/services/masterworks/bench/index.py,
+# and the runs a product-started trial writes beside it). They are never repo
+# content: a record carries every arm's full text INCLUDING the expert's ground
+# truth, which is material deliberately withheld from the Rulebook, and a trial
+# that matters is published deliberately under common-docs/projects/<its trial>/.
+# Untracked-but-not-ignored meant one `git add -A` away from committing an
+# expert's withheld work.
+.matrx/bench/
+
+# macOS Finder metadata
+.DS_Store
+**/.DS_Store
+
+# Environment files
+.env
+.env.*
+*.env
+*.env.*
+
+# Keep safe templates trackable
+!.env.example
+!.env.sample
+!.env.template
+
+# Never commit local OAuth client/token artifacts
+credentials.json
+token*.pickle
+token*.json
+tests_trials/rag_tests/kg_export_output/
+
+# Pooler-contamination watch output (machine-local evidence, not source)
+db/evidence/
+
+# Pooler contamination evidence — machine-local forensic capture, not source
+db/evidence/
+db/mirror/.env.mirror
+supabase/.temp/
+**/supabase/.temp/
+# Packed npm artifacts. Kept locally for a one-time bootstrap publish; never
+# committed (they are large binaries regenerable with `pnpm pack`).
+apps/shared/*/*.tgz
+
+# Guard forcing-function scratch packages. These tests plant real files inside
+# the real tree the guard scans (a temp dir would prove nothing) and delete
+# them in teardown — ignoring them keeps the auto-commit tooling from
+# capturing one mid-run.
+_kind_boundary_scratch*/
+_kind_marker_law_scratch*/
+
+# packed npm tarballs are build output, never source (doctrine: typescript-package-standard)
+*.tgz
+
+# Peers' kit scratch witnesses. A `.kit-<name>-witness.XXXXXX/` directory is a
+# full COPY of kit/src planted inside the packages tree — three of them held a
+# duplicate `format.ts` on 2026-09-12 — and it sits in the `check:package-twins`
+# scan ROOT. `git ls-files` only reaches TRACKED files, so the guard never saw
+# them; the risk was a broad `git add` committing three formatter twins in one
+# stroke, which is the exact class that guard exists to stop. Ignored, never
+# deleted: they are another agent's evidence.
+apps/shared/.kit-*-witness.*/
+
+# Agent worktrees. Extra checkouts of this same repo, never product source.
+# They live at .wt/<slug> (disk-groom). Committing the folder would add a
+# second copy of the entire tree and a symlink into common-docs.
+.wt/
+.matrx/fixer-dispatch.json
+.matrx/fixer-ledger.json
+
+# Release streak ledger (scripts/release_repeats.py): per-machine state, never committed
+.matrx/release-repeats.json
+.matrx/release-repeats.json.tmp
+.matrx/fixer-ledger.json

matrx_api-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.5
+Name: matrx-api
+Version: 0.1.0
+Summary: Python client for every AI Matrx server, generated from the language-neutral server contract (sister of @ai-matrx/api)
+Author-email: Matrx <admin@aimatrx.com>
+License: MIT
+Keywords: api-client,matrx,ndjson,openapi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# matrx-api
+
+The Python client of every AI Matrx server. Sister of the TypeScript `@ai-matrx/api`: both are
+GENERATED from the same language-neutral server contract (`aidream/api-contract/`), so every
+operation, deployment route, auth tier, org rule and stream kind agrees across languages.
+
+Depends on `httpx` only. Never imports `aidream`, never reads env vars: the host injects
+credentials, the organization and base URLs.
+
+```python
+from matrx_api import MatrxApi, UserCredential
+from matrx_api.generated import files
+
+async with MatrxApi(credentials=lambda: UserCredential(token()), organization_id=org_id,
+                    base_urls={"aidream": "http://localhost:8000"}) as api:
+    meta = await files.get_file(api, path={"file_id": fid})
+    async for frame in await some_domain.some_ndjson_op(api, body={...}):   # NDJSON -> parsed dicts
+        ...
+```
+
+Behaviours: credentials on every call (user / guest / api_key / service / scoped, re-read per call);
+`X-Organization-Id` per the operation's org rule (required + missing -> `OrganizationContextError`
+before the wire; exempt never sends one); unique `X-Request-Id`; GET/HEAD retry with backoff on network
+failure, writes never; one `MatrxApiError(status, code, message)`; NDJSON/SSE/bytes streams as async
+iterators (`*_or_json` operations return `JsonOrStream`).
+
+## Regenerate
+
+```
+python packages/matrx-api/scripts/generate.py          # after the contract changes
+python packages/matrx-api/scripts/generate.py --check  # exit 1 on drift (also run by the tests)
+```
+
+Writes `matrx_api/generated/<domain>.py` (one module per `x-matrx-domain`) and
+`matrx_api/deployments.py` (`CONTRACT_SHA256`, default base URLs). RED (exit 1) on a missing/unknown
+`x-matrx-*` tag, an operation no deployment serves, or a domain-module collision. Never edit generated files.
+
+## Test
+
+`uv run pytest packages/matrx-api/tests`

matrx_api-0.1.0/README.md

@@ -0,0 +1,40 @@
+# matrx-api
+
+The Python client of every AI Matrx server. Sister of the TypeScript `@ai-matrx/api`: both are
+GENERATED from the same language-neutral server contract (`aidream/api-contract/`), so every
+operation, deployment route, auth tier, org rule and stream kind agrees across languages.
+
+Depends on `httpx` only. Never imports `aidream`, never reads env vars: the host injects
+credentials, the organization and base URLs.
+
+```python
+from matrx_api import MatrxApi, UserCredential
+from matrx_api.generated import files
+
+async with MatrxApi(credentials=lambda: UserCredential(token()), organization_id=org_id,
+                    base_urls={"aidream": "http://localhost:8000"}) as api:
+    meta = await files.get_file(api, path={"file_id": fid})
+    async for frame in await some_domain.some_ndjson_op(api, body={...}):   # NDJSON -> parsed dicts
+        ...
+```
+
+Behaviours: credentials on every call (user / guest / api_key / service / scoped, re-read per call);
+`X-Organization-Id` per the operation's org rule (required + missing -> `OrganizationContextError`
+before the wire; exempt never sends one); unique `X-Request-Id`; GET/HEAD retry with backoff on network
+failure, writes never; one `MatrxApiError(status, code, message)`; NDJSON/SSE/bytes streams as async
+iterators (`*_or_json` operations return `JsonOrStream`).
+
+## Regenerate
+
+```
+python packages/matrx-api/scripts/generate.py          # after the contract changes
+python packages/matrx-api/scripts/generate.py --check  # exit 1 on drift (also run by the tests)
+```
+
+Writes `matrx_api/generated/<domain>.py` (one module per `x-matrx-domain`) and
+`matrx_api/deployments.py` (`CONTRACT_SHA256`, default base URLs). RED (exit 1) on a missing/unknown
+`x-matrx-*` tag, an operation no deployment serves, or a domain-module collision. Never edit generated files.
+
+## Test
+
+`uv run pytest packages/matrx-api/tests`

matrx_api-0.1.0/matrx_api/__init__.py

@@ -0,0 +1,31 @@
+"""matrx-api: the Python client of every AI Matrx server, generated from the server contract."""
+
+from .client import (
+    ApiStream,
+    CallOptions,
+    JsonOrStream,
+    MatrxApi,
+    Multipart,
+    OperationDescriptor,
+    RequestInfo,
+)
+from .credentials import (
+    ApiKeyCredential,
+    GuestCredential,
+    MATRX_HEADERS,
+    ScopedCredential,
+    ServiceCredential,
+    UserCredential,
+    credential_to_headers,
+)
+from .deployments import CONTRACT_SHA256, DEPLOYMENTS, DOMAINS
+from .errors import MatrxApiError, OrganizationContextError
+from .streams import NdjsonFramer, SseFrame, SseFramer
+
+__all__ = [
+    "ApiKeyCredential", "ApiStream", "CONTRACT_SHA256", "CallOptions", "DEPLOYMENTS", "DOMAINS",
+    "GuestCredential", "JsonOrStream", "MATRX_HEADERS", "MatrxApi", "MatrxApiError", "Multipart",
+    "NdjsonFramer", "OperationDescriptor", "OrganizationContextError", "RequestInfo",
+    "ScopedCredential", "ServiceCredential", "SseFrame", "SseFramer", "UserCredential",
+    "credential_to_headers",
+]