welt-client 0.7.0__tar.gz

welt_client-0.7.0/.github/workflows/check.yml

@@ -0,0 +1,29 @@
+name: SDK checks
+on: [push, pull_request]
+permissions:
+  contents: read
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        include:
+          - python: '3.11'
+            sklearn: '1.6.1'
+          - python: '3.12'
+            sklearn: '1.9.1'
+          - python: '3.13'
+            sklearn: '1.9.1'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install uv==0.5.16
+      - run: uv sync --frozen
+      - run: uv pip install --python .venv/bin/python 'scikit-learn==${{ matrix.sklearn }}'
+      - run: .venv/bin/python -m pytest -q
+      - run: uv build
+      - run: uv pip install --python .venv/bin/python --reinstall --no-deps dist/*.whl
+      - run: .venv/bin/python scripts/check_notebooks.py
+      - run: .venv/bin/python scripts/build_docs.py

welt_client-0.7.0/.github/workflows/sdk-docs.yml

@@ -0,0 +1,85 @@
+name: SDK documentation
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      release_tag:
+        description: Published SDK release to document
+        required: true
+        default: v0.7.0
+permissions:
+  contents: read
+concurrency:
+  group: sdk-pages
+  cancel-in-progress: false
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: refs/tags/${{ github.event.release.tag_name || inputs.release_tag }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: python -m pip install uv==0.5.16
+      - run: uv sync --frozen
+      - name: Verify matching published release assets
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name || inputs.release_tag }}
+        run: |
+          python - <<'PYCODE'
+          import json, os, tomllib, urllib.request
+          version = tomllib.load(open('pyproject.toml', 'rb'))['project']['version']
+          tag = os.environ['RELEASE_TAG']
+          if tag != 'v' + version:
+              raise SystemExit('Documentation must check out its matching release tag.')
+          request = urllib.request.Request(
+              'https://api.github.com/repos/ergodic-ai/welt-python/releases/tags/' + tag,
+              headers={'Accept': 'application/vnd.github+json', 'User-Agent': 'Welt-SDK-docs'})
+          with urllib.request.urlopen(request, timeout=30) as response:
+              release = json.load(response)
+          assets = {asset['name'] for asset in release['assets']}
+          required = {'welt_client-' + version + '-py3-none-any.whl', 'welt_client-' + version + '.tar.gz'}
+          if release['draft'] or release['tag_name'] != tag or not required <= assets:
+              raise SystemExit('Publish matching reviewed wheel and sdist before documentation.')
+          with open(os.environ['GITHUB_ENV'], 'a') as env:
+              env.write('SDK_VERSION=' + version + '\n')
+          PYCODE
+      - name: Install the published matching wheel
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name || inputs.release_tag }}
+        run: uv pip install --python .venv/bin/python --reinstall --no-deps "https://github.com/ergodic-ai/welt-python/releases/download/$RELEASE_TAG/welt_client-$SDK_VERSION-py3-none-any.whl"
+      - run: .venv/bin/python scripts/check_notebooks.py
+      # Preserve v0.6 URLs and corrected research archive/licence notices.
+      # This is an isolated checkout/environment: historical docs cannot inherit 0.7 APIs.
+      - uses: actions/checkout@v4
+        with:
+          ref: 1cea7d9998bf433bd4404add75ed9e2e35b2de87
+          path: .legacy-sdk
+      - run: uv sync --frozen
+        working-directory: .legacy-sdk
+      - run: uv build
+        working-directory: .legacy-sdk
+      - run: uv pip install --python .venv/bin/python --reinstall --no-deps dist/*.whl
+        working-directory: .legacy-sdk
+      - run: .venv/bin/python scripts/build_historical_docs.py --source .legacy-sdk --output site
+      - run: .venv/bin/python scripts/build_docs.py
+      - run: test -f site/v0.6.0/index.html && test -f site/v0.6.0/research-datasets.html && test -f site/v0.7.0/index.html
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/deploy-pages@v4
+        id: deployment

welt_client-0.7.0/.gitignore

@@ -0,0 +1,10 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+dist/
+*.egg-info/
+.env*
+.ipynb_checkpoints/
+
+site/

welt_client-0.7.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## 0.7.0
+
+- `Client`, `AsyncClient`, `Classifier` and `Regressor` now default to
+  `https://welt.ergodic.dev`. An explicit `base_url` takes precedence over
+  `WELT_BASE_URL`, which takes precedence over the hosted default. Local service
+  users must pass `base_url="http://localhost:8080"` or set `WELT_BASE_URL` explicitly.
+- Authenticated operations reject missing workspace keys before sending a request.
+  Public model and research catalogue reads remain keyless. Authentication and
+  permission errors explain workspace-key setup; current keys are redacted from
+  server error messages and diagnostic attributes.
+- `Classifier` and `Regressor` accept `fit(df, target="column")` and
+  `submit_fit(df, target="column")`. Exactly one of `y` or `target` is required;
+  targets require a direct pandas DataFrame with unique, nonempty string columns.
+  The declared target is removed from features and transmitted as labels using the
+  existing dataset contract. Separate `fit(X, y)`, array inputs, sklearn cloning,
+  Pipeline/CV, immutable predictor versions and explicit task selection remain.
+- Named prediction-schema mismatches report bounded missing/extra column names.
+  Errors display only bounded opaque request/job identifiers.
+- `Job.result(timeout=...)` and `AsyncJob.result(timeout=...)` account for polling,
+  read retries and the final result read. Zero timeout sends no read. HTTP timeout
+  phases are capped at the remaining local wait budget. Async requests have a
+  cancellable total-await bound; synchronous transports cannot be forcibly
+  interrupted, and separate HTTP phases can exceed a strict wall-clock bound.
+  Elapsed time is checked after each read. This wait starts after submission and
+  does not bound uploads or submission. Timeout preserves the durable job and
+  supplies reconnect guidance using the same origin and current credentials.
+
+No new large-file, resumable-upload or Parquet batch API is included in this release.
+Existing in-memory CSV/Parquet estimator input behavior is retained.

welt_client-0.7.0/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+SDK edits belong in this repository. The private service integration pins an
+immutable SDK commit/artifact and runs additional real API and account/tenant tests.
+Update the public controlled-transport tests and guide for behavior changes. Public
+CI must remain independent of private backend imports/resources.
+
+Use Python 3.11–3.13. The dependency lock records the development resolution;
+broader sklearn compatibility is an explicit qualification task, not a claim from
+a single environment. Keep credentials, data rows from customers, saved prediction
+outputs and fitted contexts out of Git. Examples use inputs supplied by the user
+or generated synthetic fixtures; no automatic live tests.
+
+Reviewers should check schema/row/class order, job timeout/retry semantics,
+credential handling and safe errors. Explicit credentials are redacted in estimator/Pipeline representations,
+and pickle strips them for environment-based reauthentication. Retain tests for
+these guarantees and keep secrets out of examples regardless of SDK safeguards. Do not invent support for unavailable model capabilities.
+
+Guides/notebooks evolve only with actual released contracts. Build a wheel, install
+it into the locked development environment, execute scripts/check_notebooks.py,
+and build scripts/build_docs.py. Never commit execution outputs. Versioned docs
+publication uses the same public repository; no live CI credentials or FM execution.

welt_client-0.7.0/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

welt_client-0.7.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.5
+Name: welt-client
+Version: 0.7.0
+Summary: Welt Python client and scikit-learn estimators
+License-Expression: Apache-2.0
+License-File: LICENSE
+Requires-Python: <3.14,>=3.11
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: numpy<3,>=2
+Requires-Dist: pandas<4,>=2.2
+Requires-Dist: scikit-learn<2,>=1.6
+Provides-Extra: parquet
+Requires-Dist: pyarrow<30,>=19; extra == 'parquet'
+Description-Content-Type: text/markdown
+
+# Welt Python SDK
+
+From a DataFrame to a prediction. Use familiar `Classifier` and `Regressor`
+estimators backed by durable predictors in your private Welt workspace.
+Install `welt-client`, import `welt`. Python 3.11–3.13.
+
+[Start here](https://ergodic-ai.github.io/welt-python/) ·
+[Guides](https://ergodic-ai.github.io/welt-python/v0.7.0/own-data.html) ·
+[Reference](https://ergodic-ai.github.io/welt-python/v0.7.0/reference.html) ·
+[Models and limits](docs/capabilities.md)
+
+## Install
+
+```sh
+python -m pip install 'welt-client @ https://github.com/ergodic-ai/welt-python/releases/download/v0.7.0/welt_client-0.7.0-py3-none-any.whl'
+```
+
+Create a workspace API key at [Welt](https://welt.ergodic.dev) with **Allow writes,
+fits and predictions** enabled. Configure `WELT_API_KEY` through local secret
+configuration or a hidden `getpass` prompt. Keep the secret out of source, notebooks,
+logs and shell history. SDK 0.7 defaults to `https://welt.ergodic.dev`; an explicit
+`base_url` overrides `WELT_BASE_URL`, which overrides that default. Local development
+must explicitly select localhost.
+
+## Predict
+
+```python
+import numpy as np
+import pandas as pd
+from welt import Classifier
+
+rng = np.random.default_rng(9)
+values = rng.normal(size=(160, 4))
+train = pd.DataFrame(values[:128], columns=["a", "b", "c", "d"])
+train["label"] = np.where(values[:128, 0] + 0.5 * values[:128, 1] > 0,
+                          "positive", "negative")
+query = pd.DataFrame(values[128:], columns=["a", "b", "c", "d"])
+model = Classifier(model="tabicl-v2", random_state=9)
+model.fit(train, target="label")
+predictions = model.predict(query)
+print(predictions.shape)  # (32,)
+reopened = Classifier.from_predictor(model.predictor_id_)
+repeat = reopened.predict(query)
+```
+
+This synthetic recipe returns one label per query row, in order; actual labels
+come from the hosted model. It is not an accuracy benchmark. Use `Regressor`
+explicitly for numeric targets; the [complete regression example](docs/start.md)
+returns one finite target-unit point per row. `fit` uploads the table and waits for
+remote preparation; `predict` executes remotely. Created datasets/predictors remain
+retained. Reopening uses the pinned identity without another fit or training upload.
+
+SDK 0.7 adds explicit DataFrame target convenience and hosted credential guidance
+while preserving `fit(X, y)`, sync/async resources, durable jobs, research downloads
+and native causal objects. Available hosted tasks and workers follow the service
+catalogue. Bounded TabICLv2, Kumo Medium, TabDPT1.3 and Mitra-v2 classification and
+regression previews are separately qualified: 500 training rows, 20 features,
+100 query rows, and 10 classes for classification. Other tasks need separate
+qualification. File reads load into memory. Held resumable CSV and large batch
+APIs are excluded.
+
+A local wait timeout leaves server work running. Reconnect by its job ID rather
+than fitting again; [recovery](docs/async-and-errors.md) describes typed failures,
+authentication, cancellation and retry behavior. Probabilities are not calibrated
+coverage. ArrowFM, CDFM and AVICI discovery preserve native graph and score semantics;
+[causal conversion](docs/causal-discovery.md) is restricted to declared native DAGs
+and the separately approved Ergodic co-release artifact. Public Ergodic distribution
+and the complete all-model catalogue remain gated.
+
+## Examples and development
+
+[Runnable script](examples/first_prediction.py) · [Jupyter notebooks](docs/notebooks.md) ·
+[Research datasets](docs/research-datasets.md) · [Contributing](CONTRIBUTING.md)
+
+```sh
+uv sync --frozen
+uv run --frozen pytest -q
+uv build
+```
+
+Controlled synthetic transport tests neither contact the hosted service nor execute
+foundation models. Notebook sources have cleared outputs; clean-wheel execution and
+bounded authorized live acceptance are separate evidence. CI requires no private
+backend, credentials or checkpoints.
+
+Apache 2.0: see [LICENSE](LICENSE). Model weights and hosted service are separate
+from this SDK licence.

welt_client-0.7.0/README.md

@@ -0,0 +1,87 @@
+# Welt Python SDK
+
+From a DataFrame to a prediction. Use familiar `Classifier` and `Regressor`
+estimators backed by durable predictors in your private Welt workspace.
+Install `welt-client`, import `welt`. Python 3.11–3.13.
+
+[Start here](https://ergodic-ai.github.io/welt-python/) ·
+[Guides](https://ergodic-ai.github.io/welt-python/v0.7.0/own-data.html) ·
+[Reference](https://ergodic-ai.github.io/welt-python/v0.7.0/reference.html) ·
+[Models and limits](docs/capabilities.md)
+
+## Install
+
+```sh
+python -m pip install 'welt-client @ https://github.com/ergodic-ai/welt-python/releases/download/v0.7.0/welt_client-0.7.0-py3-none-any.whl'
+```
+
+Create a workspace API key at [Welt](https://welt.ergodic.dev) with **Allow writes,
+fits and predictions** enabled. Configure `WELT_API_KEY` through local secret
+configuration or a hidden `getpass` prompt. Keep the secret out of source, notebooks,
+logs and shell history. SDK 0.7 defaults to `https://welt.ergodic.dev`; an explicit
+`base_url` overrides `WELT_BASE_URL`, which overrides that default. Local development
+must explicitly select localhost.
+
+## Predict
+
+```python
+import numpy as np
+import pandas as pd
+from welt import Classifier
+
+rng = np.random.default_rng(9)
+values = rng.normal(size=(160, 4))
+train = pd.DataFrame(values[:128], columns=["a", "b", "c", "d"])
+train["label"] = np.where(values[:128, 0] + 0.5 * values[:128, 1] > 0,
+                          "positive", "negative")
+query = pd.DataFrame(values[128:], columns=["a", "b", "c", "d"])
+model = Classifier(model="tabicl-v2", random_state=9)
+model.fit(train, target="label")
+predictions = model.predict(query)
+print(predictions.shape)  # (32,)
+reopened = Classifier.from_predictor(model.predictor_id_)
+repeat = reopened.predict(query)
+```
+
+This synthetic recipe returns one label per query row, in order; actual labels
+come from the hosted model. It is not an accuracy benchmark. Use `Regressor`
+explicitly for numeric targets; the [complete regression example](docs/start.md)
+returns one finite target-unit point per row. `fit` uploads the table and waits for
+remote preparation; `predict` executes remotely. Created datasets/predictors remain
+retained. Reopening uses the pinned identity without another fit or training upload.
+
+SDK 0.7 adds explicit DataFrame target convenience and hosted credential guidance
+while preserving `fit(X, y)`, sync/async resources, durable jobs, research downloads
+and native causal objects. Available hosted tasks and workers follow the service
+catalogue. Bounded TabICLv2, Kumo Medium, TabDPT1.3 and Mitra-v2 classification and
+regression previews are separately qualified: 500 training rows, 20 features,
+100 query rows, and 10 classes for classification. Other tasks need separate
+qualification. File reads load into memory. Held resumable CSV and large batch
+APIs are excluded.
+
+A local wait timeout leaves server work running. Reconnect by its job ID rather
+than fitting again; [recovery](docs/async-and-errors.md) describes typed failures,
+authentication, cancellation and retry behavior. Probabilities are not calibrated
+coverage. ArrowFM, CDFM and AVICI discovery preserve native graph and score semantics;
+[causal conversion](docs/causal-discovery.md) is restricted to declared native DAGs
+and the separately approved Ergodic co-release artifact. Public Ergodic distribution
+and the complete all-model catalogue remain gated.
+
+## Examples and development
+
+[Runnable script](examples/first_prediction.py) · [Jupyter notebooks](docs/notebooks.md) ·
+[Research datasets](docs/research-datasets.md) · [Contributing](CONTRIBUTING.md)
+
+```sh
+uv sync --frozen
+uv run --frozen pytest -q
+uv build
+```
+
+Controlled synthetic transport tests neither contact the hosted service nor execute
+foundation models. Notebook sources have cleared outputs; clean-wheel execution and
+bounded authorized live acceptance are separate evidence. CI requires no private
+backend, credentials or checkpoints.
+
+Apache 2.0: see [LICENSE](LICENSE). Model weights and hosted service are separate
+from this SDK licence.

welt_client-0.7.0/docs/assets/brand-provenance.json

@@ -0,0 +1,20 @@
+{
+  "tracking": "API-068",
+  "scope": "Company mark in user-authorized public Welt SDK documentation; no third-party model licence assertion",
+  "assets": [
+    {
+      "file": "ergodic-mark-dark.svg",
+      "source": "Welt approved Signal/Workbench company asset: apps/web/src/assets/ergodic-mark-dark.svg",
+      "source_sha256": "50ad34c1bf3c029eac0479414886bc1b9605775ee5d11a1e23e5bbf9313e75eb",
+      "sha256": "7bf1b625839d8a19ba7321c22f204c82474bee646d23edb377775ff1b4ce5cc3",
+      "transformation": "Removed Adobe embedded editor metadata; visible SVG artwork unchanged."
+    },
+    {
+      "file": "ergodic-mark-light.svg",
+      "source": "Welt approved Signal/Workbench company asset: apps/web/src/assets/ergodic-mark-light.svg",
+      "source_sha256": "642be05439a731787e0099d09ba1092c8d87aef2689252fc46b5bae0db3cca82",
+      "sha256": "f3ba67cb066f484a89b167da5ca6c4d171014e958cb19e5a4b6018212d6036fe",
+      "transformation": "Removed Adobe embedded editor metadata; visible SVG artwork unchanged."
+    }
+  ]
+}

welt_client-0.7.0/docs/assets/docs.css

@@ -0,0 +1,18 @@
+/* API-068: Signal/Workbench documentation. System fonts, no external requests. */
+:root{color-scheme:dark;--bg:#101112;--panel:#17191a;--raised:#202324;--text:#f0f0e9;--muted:#a7aba5;--border:#343835;--accent:#c3d9be;--focus:#bbcaff;--code:#d9ddd6;--keyword:#b9bce5;--string:#c5d6a7;--paper:#e6e4db;--papertext:#252a26}
+:root[data-theme=light]{color-scheme:light;--bg:#f6f5ef;--panel:#eeeee7;--raised:#e5e7de;--text:#232723;--muted:#60665e;--border:#ccd0c5;--accent:#395b37;--focus:#415fba;--code:#2b352c;--keyword:#6a3d9a;--string:#3c6327;--paper:#e8e7df;--papertext:#252a26}
+*{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:110px}body{margin:0;background:var(--bg);color:var(--text);font:15px/1.75 Inter,"Helvetica Neue",Helvetica,Arial,sans-serif;-webkit-font-smoothing:antialiased}a{color:inherit;text-underline-offset:4px}button,input,select{font:inherit;color:inherit}button{cursor:pointer}button:focus-visible,a:focus-visible,input:focus-visible,select:focus-visible,summary:focus-visible,[tabindex]:focus-visible{outline:2px solid var(--focus);outline-offset:4px}button:focus:not(:focus-visible){outline:none}.skip{position:absolute;top:-100px;left:20px;background:var(--text);color:var(--bg);padding:10px;z-index:20}.skip:focus{top:12px}.header{height:91px;display:flex;align-items:center;justify-content:space-between;padding:0 5%;border-bottom:1px solid var(--border);gap:20px;position:sticky;top:0;background:var(--bg);z-index:5}.brand{display:flex;align-items:center;text-decoration:none;gap:12px;white-space:nowrap}.brand img{width:30px;height:30px}.brand strong{font-size:27px;font-weight:500;letter-spacing:-1.4px}.brand span{color:var(--muted);font-size:12px;margin-left:5px}.logo-light{display:none}:root[data-theme=light] .logo-light{display:block}:root[data-theme=light] .logo-dark{display:none}.topnav{display:flex;gap:27px;align-items:center}.topnav a{text-decoration:none;font-size:12px;padding:6px 0}.topnav a[aria-current=page]{border-bottom:1px solid var(--text)}.tools{display:flex;align-items:center;gap:19px}.tools button,.menu-button{border:0;background:none;padding:5px;font-size:12px}.version{appearance:auto;border:0;background:var(--bg);font-size:11px;max-width:115px}.menu-button{display:none}.layout{max-width:1530px;margin:auto;display:grid;grid-template-columns:235px minmax(0,1fr) 190px;padding:0 4%;gap:44px}.sidebar{padding:44px 0;position:sticky;top:91px;height:calc(100vh - 91px);overflow-y:auto;font-size:12px}.sidebar p{color:var(--muted);font-size:10px;letter-spacing:.1em;text-transform:uppercase;margin:26px 0 10px}.sidebar p:first-child{margin-top:0}.sidebar a{display:block;text-decoration:none;padding:7px 12px;margin-left:-12px;color:var(--muted);border-left:1px solid transparent}.sidebar a[aria-current=page]{color:var(--text);border-left-color:var(--accent);background:var(--panel)}.sidebar a:hover{color:var(--text)}.article{min-width:0;padding:52px 0 90px;max-width:800px}.article h1{font-size:42px;line-height:1.15;letter-spacing:-1.8px;font-weight:400;margin:0 0 22px}.article h2{font-size:24px;letter-spacing:-.65px;font-weight:400;margin:48px 0 16px;border-top:1px solid var(--border);padding-top:28px}.article h3{font-size:18px;font-weight:500;margin:30px 0 10px}.article p,.article li{color:var(--muted)}.article strong{color:var(--text);font-weight:500}.article a{color:var(--text)}.article ul{padding-left:23px}.article code{font-family:"SFMono-Regular",Consolas,"Liberation Mono",monospace;font-size:12px;overflow-wrap:anywhere;color:var(--code)}.article p code,.article li code{background:var(--panel);padding:2px 4px}.code-wrap{position:relative;min-width:0;border:1px solid var(--border);margin:22px 0;background:var(--panel)}pre{margin:0;padding:25px 24px;max-width:100%;overflow:auto;tab-size:4;line-height:1.85}pre code{overflow-wrap:normal!important;white-space:pre;font-size:12px!important}.copy{position:absolute;right:8px;top:7px;border:0;background:var(--panel);font-size:10px;color:var(--muted);padding:4px 8px}.copy:hover{color:var(--text)}.code-language{display:block;border-bottom:1px solid var(--border);padding:7px 24px;font:10px/1.6 system-ui;color:var(--muted)}.kw{color:var(--keyword)}.st{color:var(--string)}.co{color:var(--muted)}.table-wrap{max-width:100%;overflow:auto;overscroll-behavior-x:contain;border:1px solid var(--border);margin:22px 0}table{border-collapse:collapse;width:100%;font-size:12px;line-height:1.8}th,td{text-align:left;padding:13px 16px;border-bottom:1px solid var(--border);vertical-align:top;min-width:140px}th{font-weight:500;background:var(--panel)}td{color:var(--muted)}tr:last-child td{border:0}details{border-bottom:1px solid var(--border);padding:16px 0}summary{cursor:pointer;color:var(--text)}.outline{position:sticky;top:135px;padding-top:48px;font-size:10px;max-height:calc(100vh - 135px);overflow:auto}.outline strong{font-size:10px;font-weight:400;color:var(--muted)}.outline a{display:block;text-decoration:none;padding:6px 0;color:var(--muted)}.outline a:hover{color:var(--text)}.anchor{font-size:14px;color:var(--muted)!important;margin-left:9px;opacity:0;text-decoration:none}.article h2:hover .anchor,.article h3:hover .anchor,.anchor:focus{opacity:1}.footer{border-top:1px solid var(--border);padding:24px 5%;display:flex;gap:20px;justify-content:space-between;color:var(--muted);font-size:10px}.footer a{text-decoration:none}.sr-only{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap}.home{max-width:1440px;margin:auto;padding:52px 6% 82px}.hero{display:grid;grid-template-columns:minmax(0,1fr) minmax(430px,1fr);gap:70px;align-items:start}.hero h1{font-size:clamp(44px,4.7vw,68px);line-height:1.07;letter-spacing:-3px;font-weight:400;margin:0 0 25px}.hero h1 span{color:var(--muted)}.hero-copy{color:var(--muted);font-size:15px;line-height:1.85;max-width:425px;margin:0}.hero .visual{margin-top:34px}.visual{padding:24px 0;width:100%;max-width:510px}.visual-stages{display:flex;align-items:center;gap:17px;font-size:10px;color:var(--muted);margin-bottom:25px}.visual-stages span{white-space:nowrap}.visual-stages .line{height:1px;background:var(--border);flex:1;position:relative;overflow:hidden}.visual-stages .line:after{content:'';width:25px;height:1px;background:var(--accent);position:absolute;animation:flow 4s linear infinite}.visual-table{display:grid;grid-template-columns:1fr 1fr 1fr;gap:2px;width:165px;transform:perspective(450px) rotateY(-15deg) rotateX(10deg)}.visual-table i{height:22px;background:var(--raised);border:1px solid var(--border);position:relative}.visual-table i:after{content:'';position:absolute;left:9px;right:9px;top:10px;height:1px;background:var(--muted);opacity:.4}.visual-scene{height:130px;display:flex;align-items:center;justify-content:space-between;gap:20px}.predictor-glyph{width:80px;height:80px;border:1px solid var(--border);transform:rotate(45deg);position:relative}.predictor-glyph:before,.predictor-glyph:after{content:'';position:absolute;inset:13px;border:1px solid var(--muted);border-radius:50%}.predictor-glyph:after{inset:27px;border-color:var(--accent)}.visual-points{display:flex;gap:7px;align-items:center;height:80px}.visual-points i{width:8px;background:var(--accent);height:var(--h);opacity:.65;animation:signal 4s ease-in-out infinite;animation-delay:var(--d)}.visual-note{color:var(--muted);font-size:10px;margin:17px 0 0}.motion-control{background:none;border:0;padding:0;text-decoration:underline;text-underline-offset:4px;color:var(--muted);font-size:10px;margin-left:10px}.paused *,.offscreen *{animation-play-state:paused!important}.reduced *{animation:none!important}.quickstart{min-width:0;background:var(--paper);color:var(--papertext);padding:28px 30px;--bg:var(--paper);--panel:#eeede5;--muted:#5d645a;--border:#c6c9bd;--text:#252a26;--code:#2b352c;--keyword:#6a3d9a;--string:#3c6327;--focus:#415fba;color-scheme:light}.quickstart h2{font-size:22px;letter-spacing:-.7px;font-weight:400;margin:0 0 5px}.quickstart .intro{font-size:11px;color:var(--muted);margin:0 0 20px}.quickstart .step{display:flex;justify-content:space-between;align-items:baseline;gap:10px;margin:16px 0 8px;font-size:11px}.quickstart .step a{font-size:10px}.quickstart .code-wrap{margin:0 0 18px}.quickstart pre{padding:20px 16px;font-size:12px;line-height:1.75}.quickstart pre code{font-size:12px!important}.quickstart .credential-note{font-size:10px;line-height:1.8;color:var(--muted)}.task-tabs{display:flex;gap:26px;border-bottom:1px solid var(--border);margin:20px 0 0}.task-tabs button{font-size:11px;border:0;background:none;color:var(--muted);padding:0 0 10px;border-bottom:2px solid transparent}.task-tabs [aria-selected=true]{color:var(--text);border-bottom-color:var(--text)}.task-panel .code-wrap{border-top:0}.result{padding:15px 16px;background:#dce1d3;color:#323d2c;font-size:11px;line-height:1.8}.result strong{display:block;font-weight:500}.result code{font-size:10px}.home-bottom{display:grid;grid-template-columns:1fr 1fr 1fr;gap:45px;margin-top:70px;border-top:1px solid var(--border);padding-top:26px}.home-bottom a{display:block;text-decoration:none;font-size:19px;letter-spacing:-.5px}.home-bottom p{font-size:12px;color:var(--muted);margin:9px 0 0;max-width:300px}.boundary{margin-top:25px;font-size:10px;color:var(--muted);max-width:440px;line-height:1.8}dialog{border:1px solid var(--border);background:var(--bg);color:var(--text);width:min(640px,calc(100% - 32px));max-height:80vh;padding:26px}dialog::backdrop{background:#000a}dialog header{display:flex;justify-content:space-between;align-items:center;margin-bottom:20px}dialog header button{background:none;border:0;color:var(--muted)}dialog label{display:block;font-size:12px;margin-bottom:8px}dialog input{width:100%;padding:12px;border:1px solid var(--border);background:var(--panel)}#search-results{padding:0;list-style:none;max-height:45vh;overflow:auto}#search-results a{display:block;padding:14px 5px;border-bottom:1px solid var(--border);text-decoration:none}#search-results small{display:block;color:var(--muted);font-size:11px}#search-empty{font-size:12px;color:var(--muted)}.nav-dialog a{display:block;padding:11px;text-decoration:none}.nav-dialog p{color:var(--muted);font-size:11px}body:has(dialog[open]){overflow:hidden}
+@keyframes flow{from{left:-30px}to{left:100%}}@keyframes signal{0%,100%{opacity:.4;transform:scaleY(.85)}50%{opacity:.9;transform:scaleY(1)}}
+@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}.visual *{animation:none!important}.motion-control{display:none}}
+@media(min-width:1700px){.hero{gap:100px}.home{padding-top:85px}}
+@media(max-width:1200px){.layout{grid-template-columns:195px minmax(0,1fr);gap:35px}.outline{display:none}.hero{gap:40px}.topnav{gap:20px}.tools{gap:12px}.hero h1{font-size:52px}.home{padding:50px 5%}}
+@media(max-width:900px){.header{height:78px;padding:0 24px}.topnav{display:none}.menu-button{display:block}.layout{display:block;padding:0 25px}.sidebar{display:none}.article{padding:40px 0 65px;max-width:760px;margin:auto}.hero{grid-template-columns:minmax(0,1fr);gap:30px}.hero-intro{min-width:0;max-width:660px}.hero h1{font-size:58px}.visual{max-width:450px;margin-top:20px!important}.hero .boundary{max-width:650px}.quickstart{max-width:660px;width:100%}.home{padding:45px 25px}.home-bottom{gap:25px;margin-top:45px}.brand span{display:none}}
+@media(max-width:520px){.header{padding:0 20px;gap:8px}.brand{gap:9px}.brand strong{font-size:25px}.brand img{width:26px;height:26px}.tools{gap:8px}.tools button,.menu-button{font-size:11px}.version{font-size:10px;max-width:86px}.search-label{display:none}.home{padding:37px 20px 45px}.hero h1{font-size:43px;letter-spacing:-2px}.hero-copy{font-size:13px}.hero{gap:24px}.quickstart{padding:23px 17px}.visual-scene{gap:12px}.visual-table{width:133px}.predictor-glyph{width:55px;height:55px}.predictor-glyph:before{inset:8px}.predictor-glyph:after{inset:19px}.visual-points{gap:5px}.visual-points i{width:6px}.visual-stages{gap:9px;font-size:9px}.home-bottom{grid-template-columns:1fr;gap:22px}.home-bottom a{font-size:18px}.home-bottom p{max-width:100%}.article h1{font-size:33px;letter-spacing:-1px}.article h2{font-size:23px}.article{font-size:14px}.layout{padding:0 20px}pre{padding:25px 16px}.footer{padding:22px 20px;flex-wrap:wrap;gap:10px}.quickstart pre code{font-size:12px!important}.visual-note{font-size:9px}.motion-control{font-size:9px}}
+
+.sample-data{font-size:11px;padding:12px 0}.sample-data summary{font-size:11px}.task-panel .sample-data+.code-wrap{border-top:1px solid var(--border);margin-top:14px}.quickstart .credential-note{font-size:11px}.quickstart .intro{font-size:12px}.boundary{font-size:12px;max-width:470px}.visual-note{font-size:11px}.motion-control{font-size:11px}.result{font-size:12px}.result code{font-size:12px}
+.article h2,.article h3{overflow-wrap:anywhere}.quickstart details>summary{font-size:11px}
+@media(max-width:900px){.hero-intro{display:contents}.hero-intro>h1{order:0;margin-bottom:0}.hero-copy{order:1}.quickstart{order:2}.visual{order:3;margin-top:15px!important}.visual-note{order:4;margin-top:0}.boundary{order:5;margin-top:0}.hero{gap:22px}}
+
+.article{overflow-wrap:anywhere}
+
+.copy-fallback{display:block;width:100%;max-width:100%;padding:18px;background:var(--panel);border:1px solid var(--border);font:12px/1.75 monospace;white-space:pre;overflow:auto;resize:vertical}