originchain 0.3.0__tar.gz

originchain-0.3.0/.gitignore

@@ -0,0 +1,25 @@
+# Build outputs
+backend/target/
+**/node_modules/
+**/dist/
+.build-admin/
+
+# Local secrets / tmp
+.env
+.env.local
+*.tfstate
+*.tfstate.backup
+.terraform/
+.terraform.lock.hcl
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+
+# Logs
+*.log
+admin-backend/logs/
+
+# Cargo lock kept; npm lock kept

originchain-0.3.0/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to the OriginChain Python SDK. See the repo-root
+`CHANGELOG.md` for engine releases.
+
+## 0.3.0
+
+### Changed
+- **`vector_topk` `mode` parameter is now `"fast" | "high_recall"`** —
+  replaces the previous `"hnsw" | "bruteforce"` value space. The
+  parameter is now optional (`mode=None` by default) and is omitted
+  from the request body when unset; the server defaults to
+  `"high_recall"` when the field is absent. `"fast"` favours latency,
+  `"high_recall"` favours recall.
+- Default `User-Agent` bumped to `originchain-python/0.3.0`.
+
+## Unreleased
+
+### Added
+- **Typed methods for `/sql`, `/vector/*`, `/fts/*`, `/graph/*`.** Customers
+  no longer hand-roll dicts and parse JSON manually for the four
+  substrate-extension surfaces. New methods on both `OriginChain` and
+  `AsyncOriginChain`:
+  - `client.sql(query)` and `client.sql_one(query)` — return a
+    `SqlSelect` / `SqlInsert` / `SqlDelete` discriminated union.
+  - `client.vector_put(table, *, id, embedding, dim, metric, metadata)`
+    and `client.vector_topk(table, *, query, k, dim, metric, filter,
+    mode)` — return `list[VectorHit]`.
+  - `client.fts_index(table, field, *, doc_id, text)` and
+    `client.fts_search(table, field, *, q, mode, k)` — return
+    `list[FtsHit]`. Boolean / phrase / BM25 modes share one shape.
+  - `client.graph.{neighbors, reverse_neighbors, bfs, path, dijkstra}` —
+    return `list[Neighbor]`, `list[GraphBfsHit]`, `GraphPath`, and
+    `DijkstraResult` respectively.
+- **Frozen-dataclass response models** — `SqlSelect`, `SqlInsert`,
+  `SqlDelete`, `VectorHit`, `FtsHit`, `Neighbor`, `GraphBfsHit`,
+  `GraphPath`, `DijkstraResult` — all hashable + immutable, snake_case
+  field names matching the wire.
+- **`OCPaymentRequiredError`** — 402 add-on-required mapping. Surfaces
+  `addon` / `name` / `monthly_usd` / `preview` / `enterprise_only` /
+  `purchase_url` / `msg` as attributes.
+- **Tests** under `sdk/python/tests/` using `httpx.MockTransport`. One
+  test per method on the sync client; one e2e test gated behind
+  `OC_E2E_TEST=1` against `localhost:8080`.
+
+### Changed
+- Default `User-Agent` bumped to `originchain-python/0.2.0`.

originchain-0.3.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: originchain
+Version: 0.3.0
+Summary: Official Python client for OriginChain — managed database for AI applications.
+Project-URL: Homepage, https://originchain.ai
+Project-URL: Documentation, https://originchain.ai/docs
+Project-URL: Source, https://github.com/silicoyn/originchain-python
+Project-URL: Issues, https://github.com/silicoyn/originchain-python/issues
+Author-email: Silicoyn Technologies <support@originchain.ai>
+License: Proprietary
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: typing-extensions>=4.7
+Provides-Extra: async
+Provides-Extra: dev
+Requires-Dist: h2<5,>=4; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: http2
+Requires-Dist: h2<5,>=4; extra == 'http2'
+Description-Content-Type: text/markdown
+
+# originchain (Python)
+
+Official Python client for [OriginChain](https://originchain.ai).
+
+## Install
+
+```bash
+pip install originchain
+```
+
+## Quick start
+
+```python
+from originchain import OriginChain
+
+# Reads OC_BASE_URL, OC_BEARER, OC_TENANT from env.
+db = OriginChain.from_env()
+
+# Register a schema.
+db.schemas.register(open("orders.toml").read())
+
+# Insert a row.
+db.rows.put(
+    "trading.orders",
+    {"order_id": "o1", "symbol": "AAPL", "qty": 100},
+    idempotency_key="user-action-42",
+)
+
+# Ask in natural language.
+result = db.ask("orders for AAPL above 50 shares last week")
+for row in result["rows"]:
+    print(row)
+```
+
+## Async
+
+```python
+import asyncio
+from originchain import AsyncOriginChain
+
+async def main() -> None:
+    async with AsyncOriginChain.from_env() as db:
+        await db.rows.put("trading.orders", {"order_id": "o2", "symbol": "MSFT", "qty": 50})
+        print(await db.ask("show me the largest MSFT order this hour"))
+
+asyncio.run(main())
+```
+
+## SQL
+
+```python
+resp = db.sql("SELECT order_id, qty FROM trading.orders WHERE symbol = 'AAPL'")
+for row in resp.rows:
+    print(row["order_id"], row["qty"])
+```
+
+`db.sql_one("SELECT ... LIMIT 1")` returns the first row dict (or `None`).
+
+## Vector
+
+```python
+db.vector_put("embeddings", id="doc-1", embedding=[0.1, 0.2, 0.3], dim=3)
+hits = db.vector_topk("embeddings", query=[0.1, 0.2, 0.3], k=5, dim=3)
+for h in hits:
+    print(h.id, h.score)
+```
+
+## Full-text
+
+```python
+db.fts_index("articles", "body", doc_id="d1", text="the quick brown fox")
+hits = db.fts_search("articles", "body", q="quick fox", mode="bm25", k=5)
+print([(h.doc_id, h.score) for h in hits])
+```
+
+## Graph
+
+```python
+nbrs = db.graph.neighbors("users", rel="follows", pk="u1")
+for n in nbrs:
+    print(n.pk)
+result = db.graph.dijkstra("users", rel="follows", src="u1", dst="u9",
+                           weights={"u1|u2": 1.0, "u2|u9": 0.5})
+print(result.cost)
+```
+
+## Auth
+
+Bearer tokens are minted in the OriginChain console and scoped to a
+single instance. Treat them like database passwords — env vars or
+secrets manager, never committed.
+
+## Errors
+
+The client maps HTTP errors to a typed hierarchy:
+
+```python
+from originchain import (
+    OCAuthError,
+    OCPaymentRequiredError,
+    OCRateLimitedError,
+    OCServerError,
+)
+
+try:
+    db.rows.put("trading.orders", row)
+except OCRateLimitedError as e:
+    time.sleep(e.retry_after)
+    db.rows.put("trading.orders", row)
+except OCPaymentRequiredError as e:
+    print(f"enable {e.name} at {e.purchase_url}")
+except OCAuthError:
+    print("rotate your bearer in the console")
+```
+
+When the leader returns 200 but synchronous replication didn't ack
+within the configured timeout, the client emits an
+`OCReplicationDegraded` warning. The write IS durable on the leader;
+the warning surfaces a follower-lag signal callers can monitor or page
+on.
+
+## Versioning
+
+This client follows semver. The `0.x` line is for design partners;
+the API surface may change before `1.0`.

originchain-0.3.0/README.md

@@ -0,0 +1,125 @@
+# originchain (Python)
+
+Official Python client for [OriginChain](https://originchain.ai).
+
+## Install
+
+```bash
+pip install originchain
+```
+
+## Quick start
+
+```python
+from originchain import OriginChain
+
+# Reads OC_BASE_URL, OC_BEARER, OC_TENANT from env.
+db = OriginChain.from_env()
+
+# Register a schema.
+db.schemas.register(open("orders.toml").read())
+
+# Insert a row.
+db.rows.put(
+    "trading.orders",
+    {"order_id": "o1", "symbol": "AAPL", "qty": 100},
+    idempotency_key="user-action-42",
+)
+
+# Ask in natural language.
+result = db.ask("orders for AAPL above 50 shares last week")
+for row in result["rows"]:
+    print(row)
+```
+
+## Async
+
+```python
+import asyncio
+from originchain import AsyncOriginChain
+
+async def main() -> None:
+    async with AsyncOriginChain.from_env() as db:
+        await db.rows.put("trading.orders", {"order_id": "o2", "symbol": "MSFT", "qty": 50})
+        print(await db.ask("show me the largest MSFT order this hour"))
+
+asyncio.run(main())
+```
+
+## SQL
+
+```python
+resp = db.sql("SELECT order_id, qty FROM trading.orders WHERE symbol = 'AAPL'")
+for row in resp.rows:
+    print(row["order_id"], row["qty"])
+```
+
+`db.sql_one("SELECT ... LIMIT 1")` returns the first row dict (or `None`).
+
+## Vector
+
+```python
+db.vector_put("embeddings", id="doc-1", embedding=[0.1, 0.2, 0.3], dim=3)
+hits = db.vector_topk("embeddings", query=[0.1, 0.2, 0.3], k=5, dim=3)
+for h in hits:
+    print(h.id, h.score)
+```
+
+## Full-text
+
+```python
+db.fts_index("articles", "body", doc_id="d1", text="the quick brown fox")
+hits = db.fts_search("articles", "body", q="quick fox", mode="bm25", k=5)
+print([(h.doc_id, h.score) for h in hits])
+```
+
+## Graph
+
+```python
+nbrs = db.graph.neighbors("users", rel="follows", pk="u1")
+for n in nbrs:
+    print(n.pk)
+result = db.graph.dijkstra("users", rel="follows", src="u1", dst="u9",
+                           weights={"u1|u2": 1.0, "u2|u9": 0.5})
+print(result.cost)
+```
+
+## Auth
+
+Bearer tokens are minted in the OriginChain console and scoped to a
+single instance. Treat them like database passwords — env vars or
+secrets manager, never committed.
+
+## Errors
+
+The client maps HTTP errors to a typed hierarchy:
+
+```python
+from originchain import (
+    OCAuthError,
+    OCPaymentRequiredError,
+    OCRateLimitedError,
+    OCServerError,
+)
+
+try:
+    db.rows.put("trading.orders", row)
+except OCRateLimitedError as e:
+    time.sleep(e.retry_after)
+    db.rows.put("trading.orders", row)
+except OCPaymentRequiredError as e:
+    print(f"enable {e.name} at {e.purchase_url}")
+except OCAuthError:
+    print("rotate your bearer in the console")
+```
+
+When the leader returns 200 but synchronous replication didn't ack
+within the configured timeout, the client emits an
+`OCReplicationDegraded` warning. The write IS durable on the leader;
+the warning surfaces a follower-lag signal callers can monitor or page
+on.
+
+## Versioning
+
+This client follows semver. The `0.x` line is for design partners;
+the API surface may change before `1.0`.

originchain-0.3.0/originchain/__init__.py

@@ -0,0 +1,78 @@
+"""OriginChain Python client.
+
+Two clients ship in this package:
+
+- :class:`OriginChain` — synchronous, suitable for scripts and Jupyter.
+- :class:`AsyncOriginChain` — asyncio, suitable for ASGI / async data
+  pipelines.
+
+Both wrap the same ``/v1`` HTTP surface that the engine exposes; they
+encode bearer auth, idempotency keys, and retries so callers don't have
+to repeat themselves.
+
+Quick start::
+
+    from originchain import OriginChain
+
+    db = OriginChain.from_env()                  # OC_BASE_URL + OC_BEARER
+    db.schemas.register(open("orders.toml").read())
+    db.rows.put("trading.orders", {"order_id": "o1", "symbol": "AAPL", "qty": 100})
+    rows = db.ask("orders for AAPL above 50 shares last week")
+
+The four substrate-extension surfaces (SQL, vector, full-text, graph)
+are also typed first-class. See :class:`OriginChain.sql`,
+``vector_topk`` / ``vector_put``, ``fts_search``, and the ``graph``
+namespace.
+"""
+
+from .client import OriginChain
+from .async_client import AsyncOriginChain
+from .errors import (
+    OCAuthError,
+    OCError,
+    OCNotFoundError,
+    OCPaymentRequiredError,
+    OCRateLimitedError,
+    OCReplicationDegraded,
+    OCServerError,
+    OCValidationError,
+)
+from .models import (
+    DijkstraResult,
+    FtsHit,
+    GraphBfsHit,
+    GraphPath,
+    Neighbor,
+    SqlDelete,
+    SqlInsert,
+    SqlResponse,
+    SqlSelect,
+    VectorHit,
+)
+
+__all__ = [
+    "OriginChain",
+    "AsyncOriginChain",
+    # Errors
+    "OCError",
+    "OCAuthError",
+    "OCNotFoundError",
+    "OCPaymentRequiredError",
+    "OCRateLimitedError",
+    "OCServerError",
+    "OCValidationError",
+    "OCReplicationDegraded",
+    # Models
+    "SqlSelect",
+    "SqlInsert",
+    "SqlDelete",
+    "SqlResponse",
+    "VectorHit",
+    "FtsHit",
+    "Neighbor",
+    "GraphBfsHit",
+    "GraphPath",
+    "DijkstraResult",
+]
+
+__version__ = "0.3.0"