mammoth-cli 2.4.0__tar.gz → 2.4.1__tar.gz

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.4.0
+Version: 2.4.1
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -20,7 +20,7 @@ Requires-Dist: certifi>=2026.10.19
 Requires-Dist: click<9,>=8.1
 Requires-Dist: jsonschema>=4.20
 Requires-Dist: keyring<26,>=25.7
-Requires-Dist: mammoth-io<0.9,>=0.8.53
+Requires-Dist: mammoth-io<0.9,>=0.8.54
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/__init__.py

@@ -6,7 +6,7 @@ not implement a second HTTP client and does not call private SDK members.
 
 from __future__ import annotations
 
-__version__ = "2.4.0"
+__version__ = "2.4.1"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/__main__.py

@@ -12,6 +12,14 @@ import os
 import sys
 from typing import Any
 
+_SDK_MISSING = (
+    "mammoth: the mammoth-io SDK cannot be imported ({error}).\n"
+    "This install is broken: mammoth-io is missing, or it was installed from a checkout "
+    "that no longer exists.\n"
+    "Reinstall the CLI, which brings its own mammoth-io: "
+    "pipx install --force mammoth-cli (or pip install --force-reinstall mammoth-cli).\n"
+)
+
 
 def main() -> Any:
     """Run the Mammoth CLI application.
@@ -30,11 +38,18 @@ def main() -> Any:
 
         sys.stdout.write(f"{__version__}\n")
         return 0
-    from mammoth_cli.app import app
-    from mammoth_cli.context import keyring_backend
-
-    keyring_backend.enable()
-    return app()
+    try:
+        from mammoth_cli.app import app
+        from mammoth_cli.context import keyring_backend
+
+        keyring_backend.enable()
+        return app()
+    except ModuleNotFoundError as exc:
+        # Commands import the SDK as they run, so the failure can surface inside app().
+        if exc.name is None or exc.name.split(".")[0] != "mammoth":
+            raise
+        sys.stderr.write(_SDK_MISSING.format(error=exc))
+        return 1
 
 
 if __name__ == "__main__":  # pragma: no cover

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/app/help_text.py

@@ -127,8 +127,11 @@ _SUBGROUP_DESCRIPTIONS = {
     "connector connection": "Create, read, update and delete connector connections.",
     "connector draft": "Build a connector step by step: sources, gaps, sample, then save.",
     "connector draft source": "List a draft's sources, preview them and find join keys.",
+    "connector draft spec": "Read the spec an AI-built connector draft is building.",
     "connector ds-config": "Create, read, update and delete data-source configs.",
     "connector query": "Generate connector queries and check their status.",
+    "connector version": "Read stored versions of an AI-built connector.",
+    "connector version spec": "Read the spec of a stored AI connector version.",
     "context project": "Show, select or clear the active project.",
     "dashboard audience": "Read who views a dashboard and its digest.",
     "dashboard audience digest": "Read and set the audience digest of a dashboard.",

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.4.0
+version: 2.4.1
 description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines (join, merge, pivot, filter, clean), dashboards, exports, and handoffs."
 ---
 

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities.md

@@ -1,7 +1,7 @@
 # What is proven on release
 
 Generated from `docs/release-capability-matrix.json`; do not edit by hand.
-The CLI publishes 872 commands. 705 of them bind one of the 769 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (`view transform *` commands submit through `view.task.add`, except `rename-columns` and `sort`, which set view display properties through `view.update`). 261 bound commands ran once successfully on release, 1 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer. Use an untried command normally: confirm a write with the user first, check its result with a read afterwards, and never refuse a command only because it is untried.
+The CLI publishes 875 commands. 705 of them bind one of the 769 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (`view transform *` commands submit through `view.task.add`, except `rename-columns` and `sort`, which set view display properties through `view.update`). 261 bound commands ran once successfully on release, 1 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer. Use an untried command normally: confirm a write with the user first, check its result with a read afterwards, and never refuse a command only because it is untried.
 
 Status meanings:
 

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/bundled_skill/mammoth-cli/references/command-index.md

@@ -1,12 +1,12 @@
 # Published CLI command catalog
 
-This generated catalog is a lookup table for every command in the published CLI manifest, currently 872; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
+This generated catalog is a lookup table for every command in the published CLI manifest, currently 875; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
 
 Load only the applicable domain file:
 
 - [activity](commands/activity.md) — 2 published commands
 - [addon](commands/addon.md) — 6 published commands
-- [agent](commands/agent.md) — 44 published commands
+- [agent](commands/agent.md) — 45 published commands
 - [ai](commands/ai.md) — 5 published commands
 - [annotation](commands/annotation.md) — 5 published commands
 - [auth](commands/auth.md) — 5 published commands
@@ -21,7 +21,7 @@ Load only the applicable domain file:
 - [collection](commands/collection.md) — 21 published commands
 - [completion](commands/completion.md) — 2 published commands
 - [config](commands/config.md) — 4 published commands
-- [connector](commands/connector.md) — 40 published commands
+- [connector](commands/connector.md) — 42 published commands
 - [context](commands/context.md) — 4 published commands
 - [dashboard-qa](commands/dashboard-qa.md) — 14 published commands
 - [dashboard-template](commands/dashboard-template.md) — 12 published commands

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/agent.md

@@ -162,6 +162,16 @@ Result: `AgentAccessSettingsUpdateResult`; mutation `high_impact`, confirmation
 
 Status on release: untried; no live run recorded.
 
+### `agent.access.today`
+
+Run: `mammoth agent access today`. Exact input fields: `mammoth schema get agent.access.today`.
+
+Example: `mammoth agent access today`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessTodayResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.access.tree`
 
 Run: `mammoth agent access tree`. Exact input fields: `mammoth schema get agent.access.tree`.

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/connector.md

@@ -296,6 +296,16 @@ Result: `ConnectorDraftSourcePreviewResult`; mutation `benign_mutation`, confirm
 
 Status on release: untried; no live run recorded.
 
+### `connector.draft.spec.get`
+
+Run: `mammoth connector draft spec get`. Exact input fields: `mammoth schema get connector.draft.spec.get`.
+
+Example: `mammoth connector draft spec get 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ConnectorDraftSpecGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `connector.draft.update`
 
 Run: `mammoth connector draft update`. Exact input fields: `mammoth schema get connector.draft.update`.
@@ -405,3 +415,13 @@ Example: `mammoth connector query status postgres prod-warehouse`. Placeholders
 Result: `ConnectorQueryStatusResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 
 Status on release: observed blocker — blocked_missing_fixture: No real connector connection exists in workspace 4 (connector list shows all is_added:false; connector active returns []) and creating one requires externa. Re-check before relying on it.
+
+### `connector.version.spec.get`
+
+Run: `mammoth connector version spec get`. Exact input fields: `mammoth schema get connector.version.spec.get`.
+
+Example: `mammoth connector version spec get isams_ab12cd34 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ConnectorVersionSpecGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/commands/help_summaries.json

@@ -23,6 +23,7 @@
   "agent.access.request.resolve": "Close a request. Owners, admins and the file's keeper.",
   "agent.access.settings.get": "Get the workspace's AI Agent controls. Managers only.",
   "agent.access.settings.update": "Change the workspace's AI Agent controls. Managers only.",
+  "agent.access.today": "Read the caller's Today page on the Ask home.",
   "agent.access.tree": "List the projects and files the Give access tree offers. Managers only.",
   "agent.action.delete": "Delete one object the chat created, by action id. Prompt or '--yes' required.",
   "agent.action.list": "List the changes one agent chat session made.",
@@ -185,6 +186,7 @@
   "connector.draft.source.join-candidates": "List the column pairs that could join a source onto the main one.",
   "connector.draft.source.list": "List a draft's sources.",
   "connector.draft.source.preview": "Read up to 'limit' rows of one source through its connection.",
+  "connector.draft.spec.get": "Read the spec an AI-built connector's draft is building, with secrets left out.",
   "connector.draft.update": "Change a draft.",
   "connector.ds-config.create": "Sample a data source config; REST 'query' is a JSON string. '--yes' always needed.",
   "connector.ds-config.delete": "Delete a data source configuration. Prompt or '--yes' required.",
@@ -196,6 +198,7 @@
   "connector.list": "List all available connectors (workspace-scoped, no project).",
   "connector.query.generate": "Generate a query for a connector using AI. 'query' (the intent) is required input.",
   "connector.query.status": "Get the status of an AI chat session for a connector connection.",
+  "connector.version.spec.get": "Read one stored version of the workspace's AI-built connector, secrets left out.",
   "context.project.clear": "Clear the active project id for one profile. Idempotent.",
   "context.project.status": "Report the resolved active project id for one profile.",
   "context.project.use": "Save a positive project id as the active project for one profile.",

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/commands/registry.py

@@ -1166,6 +1166,7 @@ _TARGETS: dict[str, str] = {
     "view.transform.window": "mammoth_cli.commands.view_ops.transforms:view_transform_window",
     # Operation-bound commands served by the manifest-driven generic handler.
     "agent.access.me": "mammoth_cli.commands.dashboard.generated:generated_dashboard",
+    "agent.access.today": "mammoth_cli.commands.dashboard.generated:generated_dashboard",
     "agent.access.settings.get": "mammoth_cli.commands.dashboard.generated:generated_dashboard",
     "agent.access.settings.update": "mammoth_cli.commands.dashboard.generated:generated_dashboard",
     "agent.access.grant.list": "mammoth_cli.commands.dashboard.generated:generated_dashboard",
@@ -1229,6 +1230,9 @@ _TARGETS: dict[str, str] = {
     "connector.draft.source.preview": (
         "mammoth_cli.commands.dashboard.generated:generated_dashboard"
     ),
+    # An AI-built connector's spec, secrets left out (mvc-service #7302).
+    "connector.draft.spec.get": "mammoth_cli.commands.dashboard.generated:generated_dashboard",
+    "connector.version.spec.get": "mammoth_cli.commands.dashboard.generated:generated_dashboard",
     # From URL: preview a link, follow or copy a link dataset, list the linked datasets.
     "dataset.from-url.preview": "mammoth_cli.commands.dashboard.generated:generated_dashboard",
     "dataset.from-url.follow": "mammoth_cli.commands.dashboard.generated:generated_dashboard",

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/commands/view/settle.py

@@ -125,9 +125,10 @@ def wait_for_followon_job(service: Any, write_result: Any) -> dict[str, Any] | N
     try:
         service.wait_if_job(write_result)
     except CliError as exc:
-        if exc.code == "timeout":
-            # Out of time is not a failed job: it is still running, the change was
-            # accepted, and replaying it would apply the step twice.
+        if exc.code in ("timeout", "retryable_error", "outcome_unknown"):
+            # Out of time, or a job the CLI could not read, is not a failed job: it may
+            # still be running or done, the change was accepted, and replaying it would
+            # apply the step twice.
             pending: dict[str, Any] = {
                 "execution_state": UNFINISHED_STATE,
                 "wait_error": exc.message,
@@ -135,6 +136,12 @@ def wait_for_followon_job(service: Any, write_result: Any) -> dict[str, Any] | N
             for key in ("job_id", "resume"):
                 if exc.details.get(key) is not None:
                     pending[key] = exc.details[key]
+            if "job_id" not in pending:
+                job_id = next(
+                    (write_result[k] for k in ("future_id", "job_id") if k in write_result), None
+                )
+                pending["job_id"] = job_id
+                pending.setdefault("resume", f"mammoth job wait {job_id}")
             return pending
         return {"execution_state": JOB_FAILED_STATE, "wait_error": exc.message}
     return None

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/discovery/purposes.py

@@ -717,6 +717,20 @@ COMMAND_DISCOVERY_PURPOSES = {
         "build an AI connector custom connector for our own internal api or an unsupported "
         "source; sends the request to the builder agent"
     ),
+    "agent.access.today": (
+        "read the today page, the ask home page, its suggestions, today's blocks headline "
+        "numbers, is a new page being written, updating, writing, empty, check a deploy of "
+        "the today page"
+    ),
+    "connector.draft.spec.get": (
+        "read the spec of an AI connector draft, how a custom connector table is read, paging "
+        "type page size, records path, request path, data root path, why a save repeats the "
+        "same page"
+    ),
+    "connector.version.spec.get": (
+        "read a stored version of an AI custom connector, its spec paging type page size "
+        "records path request path, which version a dataset runs, compare connector versions"
+    ),
     "file.set-password": "locked password protected file pdf excel unlock",
     "file.update": (
         "pdf extraction method choose select pending tables only all content custom "

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/runtime/trace.py

@@ -5,7 +5,7 @@ The server already logs every request it serves, with its path, status, latency,
 ``mammoth-cli/<version>``; this module adds a comment naming the command, so the log can
 answer which commands run, from which surface, by which agent, and how they end:
 
-    mammoth-cli/2.4.0 (cmd=view.data.get; inv=3f9c2a1b7d4e; surface=run; agent=claude-code)
+    mammoth-cli/2.4.1 (cmd=view.data.get; inv=3f9c2a1b7d4e; surface=run; agent=claude-code)
 
 ``inv`` is the invocation id: every request one command makes carries the same one, and the
 local run log (:mod:`mammoth_cli.runtime.runlog`) records it as its ``run_id``, so a local

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/services/positional_overrides.py

@@ -297,6 +297,16 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
             example_value="deals_2026-10.csv",
         ),
     ),
+    "connector.version.spec.get": (
+        PositionalSpec(
+            name="connector_slug",
+            type=str,
+            required=True,
+            help="The connector's slug, as 'connector draft spec get' shows it.",
+            example_value="isams_ab12cd34",
+        ),
+        PositionalSpec(name="version", type=int, required=True, help="The version number, from 1."),
+    ),
     "dashboard.chat.attachment.upload": (
         PositionalSpec(name="dashboard_id", type=int, required=True, help="ID of the dashboard."),
         PositionalSpec(

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/mammoth_cli/services/sdk_service.py

@@ -214,10 +214,6 @@ class SdkMammothService:
             kwargs["job_timeout"] = job_timeout
         if pipeline_timeout is not None:
             kwargs["pipeline_timeout"] = pipeline_timeout
-        if embedded.active():
-            # The server answering is this process's own worker: a retry of a 5xx read
-            # adds load to the worker that is already overloaded.
-            kwargs["retry_gateway_errors"] = False
         credential: dict[str, Any] = (
             {"token_provider": auth.token_provider, "workspace_id": auth.workspace_id}
             if auth.token_provider is not None

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.4.0"
+version = "2.4.1"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"
 license = "LicenseRef-Proprietary"
 requires-python = ">=3.12,<3.15"
 dependencies = [
-    "mammoth-io (>=0.8.53,<0.9)",
+    "mammoth-io (>=0.8.54,<0.9)",
     "typer (>=0.27,<0.28)",
     "click (>=8.1,<9)",
     "rich (>=15,<16)",

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/spec/manifests/commands/agent.yaml

@@ -380,6 +380,20 @@ commands:
     kind: object
 - command_id: agent.access.me
   output_schema: openapi
+- command_id: agent.access.today
+  output_schema:
+    type: object
+    required: [state, updating, blocks]
+    properties:
+      state:
+        type: string
+        enum: [page, writing, empty]
+      updating:
+        type: boolean
+      blocks:
+        type: array
+        items:
+          type: object
 - command_id: agent.access.people
   output_schema: openapi
   known_restrictions: Only a manager of the workspace's AI Agent settings can list the people.

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/spec/manifests/commands/connector.yaml

@@ -242,6 +242,28 @@ commands:
     `limit_requested`, `limit_applied` and `source_row_count`. A preview is a sample; save the draft
     to read every row.
   no_readback: returns the source's first rows itself; nothing is saved for a read to show
+- command_id: connector.draft.spec.get
+  output_schema:
+    type: object
+    required: [spec, tables]
+    properties:
+      spec:
+        type: object
+      tables:
+        type: array
+        items:
+          type: object
+- command_id: connector.version.spec.get
+  output_schema:
+    type: object
+    required: [spec, tables]
+    properties:
+      spec:
+        type: object
+      tables:
+        type: array
+        items:
+          type: object
 - command_id: connector.draft.update
   output_schema:
     ref: WriteResult

{mammoth_cli-2.4.0 → mammoth_cli-2.4.1}/spec/manifests/commands.generated.yaml

@@ -930,6 +930,40 @@ commands:
   undo_test: null
   known_restrictions: null
   reviewed_by: primary
+- command_id: agent.access.today
+  command_path: agent access today
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.agents.AgentsAPI.access_today
+  sdk_conversion: Call mammoth.api.agents.AgentsAPI.access_today with validated request fields.
+  request_model: AgentAccessTodayRequest
+  result_model: AgentAccessTodayResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-AGENT-ACCESS-TODAY
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth agent access today --help
+  agent_example: mammoth agent access today
+  unit_tests:
+  - UT-AGENT-ACCESS-TODAY
+  contract_tests:
+  - CT-AGENT-ACCESS-TODAY-HUMAN
+  - CT-AGENT-ACCESS-TODAY-JSON
+  - CT-AGENT-ACCESS-TODAY-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'The caller''s Today page: its state, whether a newer page is being written, and
+    its blocks.'
+  reviewed_by: primary
 - command_id: agent.access.tree
   command_path: agent access tree
   disposition: command
@@ -7608,6 +7642,46 @@ commands:
   known_restrictions: Reads up to `limit` (1-100) rows through the connection and records what came back
     on the source.
   reviewed_by: primary
+- command_id: connector.draft.spec.get
+  command_path: connector draft spec get
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: draft_id
+    type: int
+    required: true
+    metavar: DRAFT_ID
+    falls_back_to_field: null
+    help: ID of the draft.
+  options: []
+  sdk_symbol: mammoth.api.connector_drafts.ConnectorDraftsAPI.spec
+  sdk_conversion: Call mammoth.api.connector_drafts.ConnectorDraftsAPI.spec with validated request fields.
+  request_model: ConnectorDraftSpecGetRequest
+  result_model: ConnectorDraftSpecGetResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-CONNECTOR-DRAFT-SPEC-GET
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth connector draft spec get DRAFT_ID --help
+  agent_example: mammoth connector draft spec get 123
+  unit_tests:
+  - UT-CONNECTOR-DRAFT-SPEC-GET
+  contract_tests:
+  - CT-CONNECTOR-DRAFT-SPEC-GET-HUMAN
+  - CT-CONNECTOR-DRAFT-SPEC-GET-JSON
+  - CT-CONNECTOR-DRAFT-SPEC-GET-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: Each table's request path, records path and paging, then the whole spec; credentials
+    are references and anything that could be a secret reads [redacted].
+  reviewed_by: primary
 - command_id: connector.draft.update
   command_path: connector draft update
   disposition: command
@@ -8135,6 +8209,52 @@ commands:
   undo_test: null
   known_restrictions: null
   reviewed_by: primary
+- command_id: connector.version.spec.get
+  command_path: connector version spec get
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: connector_slug
+    type: str
+    required: true
+    metavar: CONNECTOR_SLUG
+    falls_back_to_field: null
+    help: The connector's slug, as 'connector draft spec get' shows it.
+  - name: version
+    type: int
+    required: true
+    metavar: VERSION
+    falls_back_to_field: null
+    help: The version number, from 1.
+  options: []
+  sdk_symbol: mammoth.api.connector_drafts.ConnectorDraftsAPI.version_spec
+  sdk_conversion: Call mammoth.api.connector_drafts.ConnectorDraftsAPI.version_spec with validated request
+    fields.
+  request_model: ConnectorVersionSpecGetRequest
+  result_model: ConnectorVersionSpecGetResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-CONNECTOR-VERSION-SPEC-GET
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth connector version spec get CONNECTOR_SLUG VERSION --help
+  agent_example: mammoth connector version spec get isams_ab12cd34 123
+  unit_tests:
+  - UT-CONNECTOR-VERSION-SPEC-GET
+  contract_tests:
+  - CT-CONNECTOR-VERSION-SPEC-GET-HUMAN
+  - CT-CONNECTOR-VERSION-SPEC-GET-JSON
+  - CT-CONNECTOR-VERSION-SPEC-GET-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: One stored version of the workspace's AI-built connector, by slug and version number.
+  reviewed_by: primary
 - command_id: context.project.clear
   command_path: context project clear
   disposition: command