mainsequence 8.1.25.dev26__tar.gz → 8.1.26__tar.gz

mainsequence-8.1.26/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MainSequence GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mainsequence-8.1.26/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: mainsequence
+Version: 8.1.26
+Summary: Main Sequence SDK
+Author-email: Main Sequence GmbH <dev@main-sequence.io>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mainsequence-sdk/mainsequence-sdk
+Project-URL: Issues, https://github.com/mainsequence-sdk/mainsequence-sdk/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cachetools
+Requires-Dist: click>=8.3.3
+Requires-Dist: concurrent-log-handler
+Requires-Dist: keyring<26,>=25.7.0
+Requires-Dist: opentelemetry-api
+Requires-Dist: opentelemetry-exporter-otlp
+Requires-Dist: opentelemetry-sdk
+Requires-Dist: packaging>=24.2
+Requires-Dist: protobuf>=6.33.5
+Requires-Dist: psutil
+Requires-Dist: pydantic<3,>=2.11
+Requires-Dist: pygments>=2.20.0
+Requires-Dist: pyyaml
+Requires-Dist: requests>=2.33.0
+Requires-Dist: structlog
+Requires-Dist: typer
+Requires-Dist: urllib3>=2.7.0
+Provides-Extra: server
+Requires-Dist: PyJWT[crypto]<3,>=2.10; extra == "server"
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://www.main-sequence.io/images/logos/MS_logo_long_black.png" alt="Main Sequence Logo" width="500"/>
+</p>
+
+# Main Sequence Python SDK
+
+[![Docs](https://img.shields.io/badge/docs-online-blue)](https://mainsequence-sdk.github.io/mainsequence-sdk/)
+[![Open Issues](https://img.shields.io/github/issues/mainsequence-sdk/mainsequence-sdk)](https://github.com/mainsequence-sdk/mainsequence-sdk/issues)
+[![Last Commit](https://img.shields.io/github/last-commit/mainsequence-sdk/mainsequence-sdk)](https://github.com/mainsequence-sdk/mainsequence-sdk/commits/main/)
+[![Maintained](https://img.shields.io/badge/maintained-actively-green.svg)](https://github.com/mainsequence-sdk/mainsequence-sdk/commits/main/)
+
+The Main Sequence Python SDK is the client and development toolkit for the Main
+Sequence platform. It provides authentication, typed platform resources,
+CodeRepository development and release operations, Agent and A2A workflows,
+jobs, sharing, observability, logging, tracing, and reusable scaffold tooling.
+
+MetaTables is now an independent domain package, installed as
+`mainsequence-metatable` and imported as `metatables`. Table models, time-index
+table updates, SQLAlchemy schemas, local database interfaces, and Alembic
+execution are no longer implemented by this distribution.
+
+## Repository Status
+
+- Status: actively maintained
+- Open issues: [GitHub Issues](https://github.com/mainsequence-sdk/mainsequence-sdk/issues)
+- Documentation: [Documentation Site](https://mainsequence-sdk.github.io/mainsequence-sdk/)
+- Security policy: [SECURITY.md](SECURITY.md)
+- Release history: [CHANGELOG.md](CHANGELOG.md)
+- Major-version migrations: [Migration guides](docs/migrations/v8-code-repository-ontology.md)
+
+## What This Repository Contains
+
+Main package areas:
+
+- `mainsequence.client`: API client models for users, CodeRepositories, jobs,
+  Agents, artifacts, constants, secrets, sharing, releases, and other platform
+  resources
+- `mainsequence.cli`: the complete `mainsequence` command-line interface for
+  authentication, platform resources, and local CodeRepository operations
+- `mainsequence.instrumentation` and `mainsequence.logconf`: SDK tracing and
+  logging integration
+- `mainsequence.server`: optional server-side caller assertion verification
+- `mainsequence.scaffold_skills`: reusable, version-pinned skill copying for
+  this SDK and extension libraries
+
+Repository areas:
+
+- `agent_scaffold/`: version-matched SDK skills and managed `AGENTS.md` content
+- `docs/`: knowledge guides, CLI docs, architecture decisions, and generated
+  reference docs
+- `tests/`: offline tests plus explicitly marked live-backend tests
+
+## Documentation Map
+
+Recommended entry points:
+
+- [Documentation home](docs/index.md)
+- [Authentication](docs/knowledge/infrastructure/auth.md)
+- [CLI overview](docs/cli/index.md)
+- [Git source and Environment context](docs/knowledge/infrastructure/context.md)
+- [Constants and Secrets](docs/knowledge/infrastructure/constants_and_secrets.md)
+- [Scheduling Jobs](docs/knowledge/infrastructure/scheduling_jobs.md)
+- [Resource releases](docs/knowledge/infrastructure/resource_releases.md)
+- [Generated API reference](docs/reference/index.md)
+- [MetaTables extraction guide](docs/migrations/metatables-sdk-removal.md)
+- [ADR 0034](docs/adr/0034-extract-metatables-python-package.md)
+
+The beginner tutorial is maintained in the separate
+[MainSequence SDK tutorial CodeRepository](https://github.com/mainsequence-projects/mainsequence-sdk-tutorial).
+
+## Quick Start
+
+Install and authenticate:
+
+```bash
+pip install mainsequence
+mainsequence login
+mainsequence doctor
+```
+
+An already MCP-authenticated coding agent can establish the same persisted CLI
+session with `mainsequence login --mcp`, then call the printed
+`auth.cli_authorize` tool while the command waits. The backend supplies the
+callback URI; tokens return directly to the CLI and are never exposed through
+MCP.
+
+Inspect and create CodeRepositories:
+
+```bash
+mainsequence code-repository search
+mainsequence code-repository create my-first-repository
+mainsequence code-repository set-up-locally <CODE_REPOSITORY_UID>
+cd my-first-repository
+mainsequence code-repository build-local-venv --path .
+```
+
+Use `mainsequence --help` and `mainsequence code-repository --help` for the
+installed command surface. The CLI includes Agent and AgentSession,
+CodeRepository, jobs and runs, images, resources and releases, constants,
+secrets, teams, sharing, scaffold, Docker, and local-development commands.
+
+## Python Client
+
+`mainsequence.client` provides `AuthLoaders`, `MainSequenceClient`, generic
+request and response helpers, and typed platform adapters. The platform owns
+authorization and lifecycle policy. The SDK resolves CodeRepository source
+identity from the current Git checkout when an operation requires that context.
+
+Discover deployments with `ResourceRelease.filter(name=...)` or resolve a known
+release UID with `ResourceRelease.get(pk=...)`. For shared deployments owned by
+another repository, use the explicitly scoped `filter_admin` path. See
+[Resource releases](docs/knowledge/infrastructure/resource_releases.md) for
+supported filters and examples.
+
+Server integrations can install `mainsequence[server]` for the
+framework-independent [caller assertion verifier](docs/knowledge/server/caller_assertions.md).
+Applications remain responsible for resource authorization and storage
+operations.
+
+Install `mainsequence-metatable` and import `metatables` for table-domain work.
+See the [MetaTables migration guide](docs/migrations/metatables-sdk-removal.md)
+for the install step, old and new imports, retired table CLI commands, and the
+legacy SDK option.
+
+## Development
+
+This repository requires Python 3.13 or newer and uses `pyproject.toml` with a
+development dependency group.
+
+```bash
+uv sync --group dev
+pytest
+ruff check .
+mkdocs build --strict
+```
+
+Live-backend tests are marked `live` and excluded from a normal test run. Run
+them explicitly with `pytest -m live` when credentials and a target backend are
+available.
+
+Package metadata is defined in [pyproject.toml](pyproject.toml). This repository
+is licensed under the MIT License; see [LICENSE](LICENSE).

mainsequence-8.1.26/README.md

@@ -0,0 +1,142 @@
+<p align="center">
+  <img src="https://www.main-sequence.io/images/logos/MS_logo_long_black.png" alt="Main Sequence Logo" width="500"/>
+</p>
+
+# Main Sequence Python SDK
+
+[![Docs](https://img.shields.io/badge/docs-online-blue)](https://mainsequence-sdk.github.io/mainsequence-sdk/)
+[![Open Issues](https://img.shields.io/github/issues/mainsequence-sdk/mainsequence-sdk)](https://github.com/mainsequence-sdk/mainsequence-sdk/issues)
+[![Last Commit](https://img.shields.io/github/last-commit/mainsequence-sdk/mainsequence-sdk)](https://github.com/mainsequence-sdk/mainsequence-sdk/commits/main/)
+[![Maintained](https://img.shields.io/badge/maintained-actively-green.svg)](https://github.com/mainsequence-sdk/mainsequence-sdk/commits/main/)
+
+The Main Sequence Python SDK is the client and development toolkit for the Main
+Sequence platform. It provides authentication, typed platform resources,
+CodeRepository development and release operations, Agent and A2A workflows,
+jobs, sharing, observability, logging, tracing, and reusable scaffold tooling.
+
+MetaTables is now an independent domain package, installed as
+`mainsequence-metatable` and imported as `metatables`. Table models, time-index
+table updates, SQLAlchemy schemas, local database interfaces, and Alembic
+execution are no longer implemented by this distribution.
+
+## Repository Status
+
+- Status: actively maintained
+- Open issues: [GitHub Issues](https://github.com/mainsequence-sdk/mainsequence-sdk/issues)
+- Documentation: [Documentation Site](https://mainsequence-sdk.github.io/mainsequence-sdk/)
+- Security policy: [SECURITY.md](SECURITY.md)
+- Release history: [CHANGELOG.md](CHANGELOG.md)
+- Major-version migrations: [Migration guides](docs/migrations/v8-code-repository-ontology.md)
+
+## What This Repository Contains
+
+Main package areas:
+
+- `mainsequence.client`: API client models for users, CodeRepositories, jobs,
+  Agents, artifacts, constants, secrets, sharing, releases, and other platform
+  resources
+- `mainsequence.cli`: the complete `mainsequence` command-line interface for
+  authentication, platform resources, and local CodeRepository operations
+- `mainsequence.instrumentation` and `mainsequence.logconf`: SDK tracing and
+  logging integration
+- `mainsequence.server`: optional server-side caller assertion verification
+- `mainsequence.scaffold_skills`: reusable, version-pinned skill copying for
+  this SDK and extension libraries
+
+Repository areas:
+
+- `agent_scaffold/`: version-matched SDK skills and managed `AGENTS.md` content
+- `docs/`: knowledge guides, CLI docs, architecture decisions, and generated
+  reference docs
+- `tests/`: offline tests plus explicitly marked live-backend tests
+
+## Documentation Map
+
+Recommended entry points:
+
+- [Documentation home](docs/index.md)
+- [Authentication](docs/knowledge/infrastructure/auth.md)
+- [CLI overview](docs/cli/index.md)
+- [Git source and Environment context](docs/knowledge/infrastructure/context.md)
+- [Constants and Secrets](docs/knowledge/infrastructure/constants_and_secrets.md)
+- [Scheduling Jobs](docs/knowledge/infrastructure/scheduling_jobs.md)
+- [Resource releases](docs/knowledge/infrastructure/resource_releases.md)
+- [Generated API reference](docs/reference/index.md)
+- [MetaTables extraction guide](docs/migrations/metatables-sdk-removal.md)
+- [ADR 0034](docs/adr/0034-extract-metatables-python-package.md)
+
+The beginner tutorial is maintained in the separate
+[MainSequence SDK tutorial CodeRepository](https://github.com/mainsequence-projects/mainsequence-sdk-tutorial).
+
+## Quick Start
+
+Install and authenticate:
+
+```bash
+pip install mainsequence
+mainsequence login
+mainsequence doctor
+```
+
+An already MCP-authenticated coding agent can establish the same persisted CLI
+session with `mainsequence login --mcp`, then call the printed
+`auth.cli_authorize` tool while the command waits. The backend supplies the
+callback URI; tokens return directly to the CLI and are never exposed through
+MCP.
+
+Inspect and create CodeRepositories:
+
+```bash
+mainsequence code-repository search
+mainsequence code-repository create my-first-repository
+mainsequence code-repository set-up-locally <CODE_REPOSITORY_UID>
+cd my-first-repository
+mainsequence code-repository build-local-venv --path .
+```
+
+Use `mainsequence --help` and `mainsequence code-repository --help` for the
+installed command surface. The CLI includes Agent and AgentSession,
+CodeRepository, jobs and runs, images, resources and releases, constants,
+secrets, teams, sharing, scaffold, Docker, and local-development commands.
+
+## Python Client
+
+`mainsequence.client` provides `AuthLoaders`, `MainSequenceClient`, generic
+request and response helpers, and typed platform adapters. The platform owns
+authorization and lifecycle policy. The SDK resolves CodeRepository source
+identity from the current Git checkout when an operation requires that context.
+
+Discover deployments with `ResourceRelease.filter(name=...)` or resolve a known
+release UID with `ResourceRelease.get(pk=...)`. For shared deployments owned by
+another repository, use the explicitly scoped `filter_admin` path. See
+[Resource releases](docs/knowledge/infrastructure/resource_releases.md) for
+supported filters and examples.
+
+Server integrations can install `mainsequence[server]` for the
+framework-independent [caller assertion verifier](docs/knowledge/server/caller_assertions.md).
+Applications remain responsible for resource authorization and storage
+operations.
+
+Install `mainsequence-metatable` and import `metatables` for table-domain work.
+See the [MetaTables migration guide](docs/migrations/metatables-sdk-removal.md)
+for the install step, old and new imports, retired table CLI commands, and the
+legacy SDK option.
+
+## Development
+
+This repository requires Python 3.13 or newer and uses `pyproject.toml` with a
+development dependency group.
+
+```bash
+uv sync --group dev
+pytest
+ruff check .
+mkdocs build --strict
+```
+
+Live-backend tests are marked `live` and excluded from a normal test run. Run
+them explicitly with `pytest -m live` when credentials and a target backend are
+available.
+
+Package metadata is defined in [pyproject.toml](pyproject.toml). This repository
+is licensed under the MIT License; see [LICENSE](LICENSE).

{mainsequence-8.1.25.dev26 → mainsequence-8.1.26}/agent_scaffold/AGENTS.md

@@ -64,14 +64,13 @@ never owns or updates the `ms_tau_sdk` namespace.
   `.agents/skills/mainsequence/maintenance/code_repository_maintenance/SKILL.md`
 - Blocker analysis, failure classification, and SDK/platform contract mismatches:
   `.agents/skills/mainsequence/maintenance/bug_auditor/SKILL.md`
-- Platform data discovery before implementation:
-  `.agents/skills/mainsequence/data_access/exploration/SKILL.md`
-- TimeIndexTableUpdaters and update behavior:
-  `.agents/skills/mainsequence/data_publishing/time_index_table_updates/SKILL.md`
-- MetaTables and governed table operations:
-  `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
-- Alembic-managed MetaTable schema changes:
-  `.agents/skills/mainsequence/data_publishing/meta_table_migrations/SKILL.md`
+- MetaTable modeling, queries, external registration, table updates, Alembic
+  schema changes, and data discovery: use the skills the `metatables` package
+  installs under `.agents/skills/metatables/` and its documentation.
+- Code that still imports `mainsequence.meta_tables` or
+  `mainsequence.client.metatables`, or calls the retired `mainsequence` table
+  and migration commands:
+  `.agents/skills/mainsequence/maintenance/metatables_transition/SKILL.md`
 - FastAPI APIs serving the Command Center frontend:
   `.agents/skills/mainsequence/application_surfaces/api_surfaces/SKILL.md`
 - Jobs, schedules, images, resources, releases, and Artifacts:
@@ -96,7 +95,7 @@ never owns or updates the `ms_tau_sdk` namespace.
   not ask users to inject CodeRepositoryBranch or Environment identity.
 - Use the `mainsequence` CLI as the default platform control surface. Prefer
   `--json` when output will be parsed or used as evidence.
-- Use the data-exploration skill before designing against unknown platform data.
+- Use the owning domain package before designing against an unfamiliar domain contract.
 - Keep reusable business logic under `src/` and keep API, job, and other
   integration layers thin.
 - Verify only the platform objects relevant to the requested outcome.

{mainsequence-8.1.25.dev26 → mainsequence-8.1.26}/agent_scaffold/skills/application_surfaces/api_surfaces/SKILL.md

@@ -88,7 +88,7 @@ Record:
   administrative, webhook, external integration, or backend-to-backend
 - the exact contract ID and role for each request or response body
 - route paths, HTTP methods, authentication expectations, and error semantics
-- upstream `TimeIndexTableRef`, MetaTable, service, or external data dependencies
+- upstream domain-package, service, or external data dependencies
 - whether the API uses backend transport or a contract-defined direct
   development transport
 

{mainsequence-8.1.25.dev26 → mainsequence-8.1.26}/agent_scaffold/skills/maintenance/bug_auditor/SKILL.md

@@ -52,10 +52,8 @@ This skill audits. It does not implement by default.
   platform catalog; do not assume its filesystem path
 - bootstrap, routing, and repository structure:
   `.agents/skills/mainsequence/sdk_code_repository_execution/SKILL.md`
-- TimeIndexTableUpdater implementation issues:
-  `.agents/skills/mainsequence/data_publishing/time_index_table_updates/SKILL.md`
-- MetaTable implementation issues:
-  `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
+- MetaTable and table-update implementation issues: use the installed
+  `metatables` package skill that owns the affected contract
 - Command Center FastAPI contract or release issues:
   `.agents/skills/mainsequence/application_surfaces/api_surfaces/SKILL.md`
 - jobs, images, releases, and runtime environment issues:

{mainsequence-8.1.25.dev26 → mainsequence-8.1.26}/agent_scaffold/skills/maintenance/code_repository_maintenance/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: code_repository_maintenance
+name: mainsequence-code-repository-maintenance
 description: Maintain an existing Main Sequence CodeRepository checkout using the SDK-version-matched CLI. Use for inspecting repository state, building or repairing .venv, refreshing local authentication, performing explicitly requested SDK, skill, or AGENTS.md updates, publishing changes with CodeRepository sync, or diagnosing a partially completed maintenance workflow.
 ---
 
@@ -22,7 +22,7 @@ Own:
 Do not own:
 
 - platform ontology or CodeRepository Blueprint design;
-- domain implementation for MetaTables, TimeIndexTableUpdaters, APIs, jobs, or releases;
+- domain implementation for data packages, APIs, jobs, or releases;
 - backend repository reconciliation;
 - MCP authorization policy, OAuth token storage, or access-token extraction;
 - repository-owned skills outside `.agents/skills/mainsequence/`.
@@ -91,10 +91,10 @@ mainsequence code-repository build-local-venv --path . --recreate
 Treat `.venv` as generated state, never as source code or durable repository
 documentation.
 
-## Refresh CodeRepository Authentication
+## Refresh Authentication
 
-Establish CLI authentication before refreshing a CodeRepository. Select exactly one
-existing authentication lane:
+Authentication belongs to the machine, not to a CodeRepository. Establish the
+CLI session through exactly one existing authentication lane:
 
 - When `MAINSEQUENCE_AUTH_MODE=runtime_credential`, run `mainsequence login`.
   The CLI exchanges the injected runtime credential without a browser or a
@@ -114,24 +114,39 @@ terminal. If `auth.cli_authorize` returns an error, preserve the pending local
 workflow output and report that exact error rather than starting multiple
 handoffs blindly.
 
-Refresh only the CLI-managed runtime authentication entries in the CodeRepository
-`.env`:
+The session is one record per backend in the operating system credential
+store. A login made from any CodeRepository serves every other one on the
+machine, and the SDK reads the saved session when it is imported. No
+CodeRepository holds a copy: `.env` has the backend endpoint and no credential.
+
+Renew the saved session and confirm that it works:
 
 ```bash
-mainsequence code-repository refresh-token --path .
+mainsequence refresh-token
 ```
 
+The command takes no path, because the session does not belong to a checkout.
+It renews the access token, saves it, and reports the session without printing
+a token value. When the directory it runs in has a `.env` with an access token,
+a refresh token, or a runtime credential left by an earlier version or another
+tool, it removes those entries and reports them by name only; it changes
+nothing else in that file.
+
 Require one supported Main Sequence CLI login lane first. Never print,
 inspect, summarize, copy, or return access and refresh token values. Do not
 attempt to extract the calling MCP host's protected bearer token: the handoff
 authorizes a new PKCE grant and the backend returns credentials directly to
 the waiting CLI process.
 
-The command preserves unrelated repository configuration and renders only the
-current supported authentication shape. It removes legacy token aliases and
-all retired repository, branch, and environment identity entries. The Git
-checkout supplies source identity; switching branches changes
-context on the next process run without rewriting `.env`.
+Never write a token into `.env` to make a tool work. `mainsequence auth status`
+reports whether a session exists, when it expires, and whether the process
+takes its credentials from its environment or from the saved session; it
+prints no token value. `mainsequence auth token` exists for local tools that
+consume a short-lived access token programmatically. Do not run it to read a
+token into the conversation.
+
+The Git checkout supplies source identity; switching branches changes context
+on the next process run without rewriting `.env`.
 
 ## Update The CodeRepository SDK
 

mainsequence-8.1.26/agent_scaffold/skills/maintenance/metatables_transition/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: mainsequence-metatables-transition
+description: "Use when a repository still depends on the MetaTables code that used to ship inside `mainsequence`: imports from `mainsequence.meta_tables` or `mainsequence.client.metatables`, table classes imported from `mainsequence.client`, or the retired `mainsequence meta-table`, `time-index-table`, `code-repository time-index-table-updates`, and `migrations` commands. Covers only the one-time move to the `mainsequence-metatable` package; all MetaTables usage after the move belongs to the skills that package installs."
+---
+
+# Move a repository to the `metatables` package
+
+MetaTables no longer ships inside `mainsequence`. This skill moves one
+repository's code and dependencies to the package that now owns it, and stops
+there. It does not move tables or catalog records. For table modeling, queries,
+DataSources, updaters, and Alembic migrations, use the skills installed in
+step 2.
+
+## 1. Find what the repository uses
+
+Search code, scripts, workflow files, and `pyproject.toml` for:
+
+- `mainsequence.meta_tables` and `mainsequence.client.metatables`
+- `MetaTable`, `TimeIndexMetaTable`, `TimeIndexTableUpdate`, or `DataSource`
+  imported from `mainsequence.client`
+- `mainsequence meta-table`, `mainsequence time-index-table`,
+  `mainsequence code-repository time-index-table-updates`, and
+  `mainsequence migrations`
+- the `mainsequence[local-data]` extra
+
+Report what you found before editing. If nothing matches, there is nothing to
+move.
+
+## 2. Install the package and its skills
+
+```bash
+uv add mainsequence-metatable
+uv run python -m metatables.sdk_compat
+uv run metatables copy-metatables-skills --path .
+```
+
+The distribution is `mainsequence-metatable`; the import and the command are
+`metatables`. Do not install the PyPI project named `metatables`: it is
+unrelated. The compatibility check must pass before you continue. If it fails,
+the installed `mainsequence` is not compatible; upgrading it is an update the
+user has to request.
+
+The last command copies the package's skills into `.agents/skills/metatables/`.
+
+`mainsequence-metatable` brings back `alembic`, `sqlalchemy`, `pandas`,
+`numpy`, `psycopg2-binary`, and `tqdm`, which the SDK no longer installs. The
+`local-data` extra is gone: remove it, and declare `duckdb` and `pyarrow`
+directly if the repository imports them.
+
+## 3. Rewrite imports
+
+| Old | New |
+| --- | --- |
+| `mainsequence.meta_tables` | `metatables` |
+| `mainsequence.meta_tables.<module>` | `metatables.<module>` |
+| `mainsequence.meta_tables.time_index_table_updates.<module>` | `metatables.updaters.<module>` |
+| `mainsequence.client.metatables`, `mainsequence.client.metatables.core` | `metatables.models` |
+| table classes from `mainsequence.client` | `metatables` |
+
+Change module paths only. In an existing Alembic provider, update the provider
+module and `env.py` the same way, and leave applied revision files untouched.
+If a name is missing from `metatables`, report it instead of guessing a
+substitute.
+
+`CodeRepositoryBranch.get_time_index_table_updates()` and DataSource resolution
+through `CodeRepositoryContext` have no SDK replacement. The `metatables` skills
+cover what to use instead.
+
+## 4. Replace commands
+
+The four command groups keep their names: `mainsequence <group> ...` becomes
+`metatables <group> ...`. Confirm each one with `metatables <group> --help`. If
+a subcommand is missing or refuses to run, stop and report it. Do not pin an
+older `mainsequence`, connect to the database directly, or register tables by
+hand to get around it.
+
+## 5. Check the result
+
+- The search from step 1 returns nothing.
+- The changed modules import and the repository's tests pass.
+- `.agents/skills/metatables/` exists.
+
+Then hand over to those skills.

{mainsequence-8.1.25.dev26 → mainsequence-8.1.26}/agent_scaffold/skills/platform_operations/access_control_and_sharing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mainsequence-access-control-and-sharing
-description: Use this skill when the task is about RBAC, resource sharing, or access verification in a Main Sequence CodeRepository. This skill owns organization and team access concepts, view and edit semantics, choosing the correct shareable resource boundary, and access checks across CodeRepositories, TimeIndexMetaTable, constants, secrets, buckets, artifacts, and releases. It does not own job scheduling, TimeIndexTableUpdater producer logic, or API route design.
+description: Use this skill when the task is about RBAC, resource sharing, or access verification in a Main Sequence CodeRepository. This skill owns organization and team access concepts, view and edit semantics, choosing the correct shareable resource boundary, and access checks across CodeRepositories, constants, secrets, buckets, artifacts, and releases. It does not own job scheduling, domain-package data behavior, or API route design.
 ---
 
 # Main Sequence Access Control And Sharing
@@ -26,13 +26,11 @@ This skill is for:
 - decide whether a user needs `view` or `edit`
 - identify the correct shareable object boundary:
   - `CodeRepository`
-  - `TimeIndexMetaTable`
   - `Constant`
   - `Secret`
   - `Bucket`
   - `Artifact`
   - `ResourceRelease`
-- explain that sharing an updater's published output means sharing its `TimeIndexMetaTable`
 - choose whether configuration belongs in a `Constant` or a `Secret`
 - review CLI sharing flows for existing resources
 - verify access assumptions before claiming a workflow is shareable
@@ -42,8 +40,7 @@ This skill is for:
 This skill must not claim ownership of:
 
 - job scheduling or image pinning
-- TimeIndexTableUpdater producer implementation
-- MetaTable schema design
+- domain-package data production and schema design
 - FastAPI route design
 - application UI design or implementation
 
@@ -51,10 +48,8 @@ This skill must not claim ownership of:
 
 - jobs, schedules, images, code repository resources, releases, and Artifacts as operational workflows:
   `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
-- TimeIndexTableUpdaters:
-  `.agents/skills/mainsequence/data_publishing/time_index_table_updates/SKILL.md`
-- MetaTables:
-  `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
+- MetaTables and table updates: use the installed `metatables` package skills
+  and documentation
 - Command Center-serving FastAPI providers:
   `.agents/skills/mainsequence/application_surfaces/api_surfaces/SKILL.md`
 This skill only reasons about access to deployed resources such as `ResourceRelease`.
@@ -108,7 +103,6 @@ Do not speak loosely about sharing "the code" when the operational boundary is a
 
 Examples:
 
-- sharing an updater's published output usually means sharing the `TimeIndexMetaTable`
 - sharing a deployed experience usually means sharing the `ResourceRelease`
 - sharing runtime configuration means sharing the `Constant` or `Secret`
 

{mainsequence-8.1.25.dev26 → mainsequence-8.1.26}/agent_scaffold/skills/platform_operations/orchestration_and_releases/SKILL.md

@@ -32,18 +32,15 @@ This skill is for:
 
 This skill must not claim ownership of:
 
-- TimeIndexTableUpdater producer behavior
-- MetaTable schema and row semantics
+- domain-package data production and schema semantics
 - Command Center FastAPI wire contracts
 - RBAC or sharing policy
 - application UI implementation details
 
 ## Route Adjacent Work
 
-- TimeIndexTableUpdaters:
-  `.agents/skills/mainsequence/data_publishing/time_index_table_updates/SKILL.md`
-- MetaTables:
-  `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
+- MetaTables, table updates, and table schemas: use the installed `metatables`
+  package skills and documentation
 - Command Center FastAPI provider implementation and contract validation:
   `.agents/skills/mainsequence/application_surfaces/api_surfaces/SKILL.md`
 - RBAC and sharing: