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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.4.0
+Version: 2.4.2
 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.2}/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.2"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.4.0 → mammoth_cli-2.4.2}/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.2}/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.2}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.4.0
+version: 2.4.2
 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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/mammoth_cli/commands/view/aggregate.py

@@ -35,7 +35,7 @@ from mammoth_cli.runtime.session import (
     open_service,
     require_project,
 )
-from mammoth_cli.services import read_queries
+from mammoth_cli.services import medians, read_queries
 from mammoth_cli.services.conditions import CONDITION_KWARG, compile_condition
 from mammoth_cli.services.read_queries import ReadContext
 
@@ -198,6 +198,10 @@ def _run_aggregate(
         )
         kwargs[CONDITION_KWARG] = condition
     _forward_optional(document, kwargs, ("sequence",))
+    if medians.requested(document):
+        result = medians.aggregate(reads, fields, condition)
+        rows = read_queries.sort_locally(result["data"], sort)
+        return {**result, "data": rows[:limit] if limit else rows}
     if levels:
         response = read_queries.pivot_with_text_dates(
             reads,
@@ -222,7 +226,9 @@ def view_data_aggregate(invocation: Invocation) -> HandlerResult:
     Read-only: computes and returns the aggregated result without adding a
     task to the view's pipeline or otherwise changing it. Pass exactly one of
     ``aggregations`` (a PIVOT; ``group_by`` is optional) or ``metric`` (a
-    METRIC). ``function`` is one of SUM, COUNT, AVG, MIN, MAX, STDDEV, DISTINCT_COUNT. An optional
+    METRIC). ``function`` is one of SUM, COUNT, AVG, MIN, MAX, STDDEV, DISTINCT_COUNT, MEDIAN.
+    MEDIAN is exact, over a NUMERIC column's non-blank values (``median_note`` says how many
+    blank rows it left out), and goes in a read of its own. An optional
     ``condition`` filters rows before aggregating, and ``sequence`` pins the
     read to a pipeline step (default: latest). ``order_by`` (result labels,
     ``"Total desc"``) with ``top`` ranks the groups on the backend (and adds
@@ -308,9 +314,13 @@ def aggregate_on(
     reads = source.reads
     column_types = reads.column_types
     display_to_internal = reads.display_to_internal
-    levels: dict[int, str] = {}
-    if "aggregations" in document or "group_by" in document:
-        levels = read_queries.text_date_group_levels(document.get("group_by"), column_types)
+    pivot = "aggregations" in document or "group_by" in document
+    levels: dict[int, str] = (
+        read_queries.text_date_group_levels(document.get("group_by"), column_types) if pivot else {}
+    )
+    if medians.requested(document):
+        medians.check(document, column_types, bool(levels))
+    if pivot:
         fields, as_map = _build_pivot_fields(
             _plain_text_date_groups(document, levels, column_types), display_to_internal
         )

{mammoth_cli-2.4.0 → mammoth_cli-2.4.2}/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.2}/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.2}/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.2 (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.2/mammoth_cli/services/medians.py

@@ -0,0 +1,145 @@
+"""MEDIAN for ``view data aggregate``, computed exactly in the CLI.
+
+The backend's volatile aggregate has no MEDIAN. Paging sorted rows to find the
+middle one is slow and goes wrong on blanks, which sort last but still count. So
+the CLI asks for one COUNT per stored value of the column (per group), drops the
+blank values, and takes the middle of what is left. The result says how many
+blank rows were skipped.
+"""
+
+from __future__ import annotations
+
+from collections import defaultdict
+from typing import Any
+
+from mammoth_cli.errors.envelope import CODE_INVALID_ARGUMENTS, EXIT_USAGE, CliError
+from mammoth_cli.services.conditions import CONDITION_KWARG
+from mammoth_cli.services.read_queries import ReadContext
+
+MEDIAN = "MEDIAN"
+#: The backend returns at most this many grouped rows.
+BACKEND_ROW_CAP = 40000
+
+
+def _fail(message: str, hint: str = "") -> CliError:
+    return CliError(code=CODE_INVALID_ARGUMENTS, message=message, exit_status=EXIT_USAGE, hint=hint)
+
+
+def _items(document: dict[str, Any]) -> list[dict[str, Any]]:
+    if isinstance(document.get("metric"), dict):
+        return [document["metric"]]
+    aggregations = document.get("aggregations")
+    return (
+        [a for a in aggregations if isinstance(a, dict)] if isinstance(aggregations, list) else []
+    )
+
+
+def requested(document: dict[str, Any]) -> bool:
+    """Whether the read asks for a MEDIAN."""
+    return any(str(item.get("function") or "").upper() == MEDIAN for item in _items(document))
+
+
+def check(document: dict[str, Any], column_types: dict[str, str], text_date_groups: bool) -> None:
+    """Refuse a MEDIAN read this path cannot answer exactly, before any query."""
+    items = _items(document)
+    if any(str(item.get("function") or "").upper() != MEDIAN for item in items):
+        raise _fail(
+            "MEDIAN cannot be mixed with other functions in one read.",
+            "Run the MEDIAN aggregations in their own 'view data aggregate' call.",
+        )
+    if text_date_groups:
+        raise _fail(
+            "MEDIAN cannot be grouped by a date 'part', or by a 'truncate' of a TEXT date.",
+            "Group by a DATE column with 'truncate', or convert the TEXT date with "
+            "'view transform convert-type'.",
+        )
+    for item in items:
+        column = item.get("column")
+        if not column:
+            raise _fail("MEDIAN needs a 'column'.")
+        kind = column_types.get(str(column), "")
+        if kind not in ("", "NUMERIC"):
+            raise _fail(f"MEDIAN needs a NUMERIC column; '{column}' is {kind}.")
+
+
+def _number(value: Any) -> float | None:
+    try:
+        return None if value is None or isinstance(value, bool) else float(value)
+    except (TypeError, ValueError):
+        return None
+
+
+def weighted_median(counts: list[tuple[float, int]]) -> float | None:
+    """The median of values given as (value, how many rows hold it); None when empty."""
+    ordered = sorted(counts)
+    total = sum(n for _, n in ordered)
+    if total == 0:
+        return None
+    wanted = [(total - 1) // 2, total // 2]
+    found: list[float] = []
+    seen = 0
+    for value, n in ordered:
+        found.extend(value for position in wanted if seen <= position < seen + n)
+        seen += n
+    return (found[0] + found[1]) / 2
+
+
+def _counts_by_group(
+    reads: ReadContext, column: str, group_by: list[Any], condition: Any
+) -> tuple[dict[tuple[Any, ...], list[tuple[float, int]]], int]:
+    """(value, rows) per group for one column, and how many blank rows were left out."""
+    fields: dict[str, Any] = {
+        "aggregations": [{"function": "COUNT", "as_name": "n"}],
+        "group_by": [*group_by, column],
+        "limit": BACKEND_ROW_CAP,
+    }
+    if condition is not None:
+        fields[CONDITION_KWARG] = condition
+    rows = reads.query(**fields).get("data") or []
+    if len(rows) >= BACKEND_ROW_CAP:
+        raise _fail(
+            "Too many distinct values to take an exact median "
+            f"(the backend returns at most {BACKEND_ROW_CAP} groups).",
+            "Narrow the read with a condition.",
+        )
+    width = len(group_by)
+    counts: dict[tuple[Any, ...], list[tuple[float, int]]] = defaultdict(list)
+    blank = 0
+    for row in rows:
+        key = tuple(row.get(f"group_{i}") for i in range(width))
+        value, n = _number(row.get(f"group_{width}")), int(row.get("agg_0") or 0)
+        bucket = counts[key]  # a group whose values are all blank still gets a row
+        if value is None:
+            blank += n
+        else:
+            bucket.append((value, n))
+    return counts, blank
+
+
+def aggregate(reads: ReadContext, fields: dict[str, Any], condition: Any) -> dict[str, Any]:
+    """Answer a MEDIAN read with rows shaped like the backend's (``group_N``, ``agg_N``/``metric``).
+
+    ``fields`` holds the resolved SDK kwargs (internal column names).
+    """
+    group_by = list(fields.get("group_by") or [])
+    items = [fields["metric"]] if "metric" in fields else list(fields["aggregations"])
+    keys = ["metric"] if "metric" in fields else [f"agg_{i}" for i in range(len(items))]
+    merged: dict[tuple[Any, ...], dict[str, Any]] = {}
+    skipped: dict[str, int] = {}
+    for key, item in zip(keys, items, strict=True):
+        counts, blank = _counts_by_group(reads, item["column"], group_by, condition)
+        if not group_by:
+            counts.setdefault((), [])
+        for group, values in counts.items():
+            row = merged.setdefault(group, {f"group_{i}": v for i, v in enumerate(group)})
+            row[key] = weighted_median(values)
+        if blank:
+            skipped[item["as_name"]] = blank
+    rows = list(merged.values())
+    result: dict[str, Any] = {"data": rows, "row_count": len(rows)}
+    if skipped:
+        named = ", ".join(f"{label}: {n}" for label, n in skipped.items())
+        result["median_note"] = (
+            f"MEDIAN is over non-blank values only; blank rows left out ({named})."
+        )
+    return result

{mammoth_cli-2.4.0 → mammoth_cli-2.4.2}/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.2}/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.2}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.4.0"
+version = "2.4.2"
 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.2}/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.2}/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.2}/spec/manifests/commands/view.yaml

@@ -291,7 +291,8 @@ commands:
   known_restrictions: 'Read-only: computes and returns an aggregated result without adding a task to the
     view''s pipeline or otherwise changing it. Pass exactly one of ''aggregations'' (a PIVOT group-by;
     ''group_by'' is optional) or ''metric'' (a single METRIC value). ''function'' is one of SUM, COUNT,
-    AVG, MIN, MAX, STDDEV, DISTINCT_COUNT. A group_by item is a column name, or {"column": C, "truncate":
+    AVG, MIN, MAX, STDDEV, DISTINCT_COUNT, MEDIAN. MEDIAN is exact over a NUMERIC column''s non-blank
+    values (median_note counts the blank rows left out) and goes in a read of its own. A group_by item is a column name, or {"column": C, "truncate":
     DAY|WEEK|MONTH|QUARTER|YEAR} to bucket a DATE (a trend over time), or {"column": C, "resolution":
     N} to bucket a NUMERIC; grouping by a raw date gives one row per day. A metric is a number: only COUNT
     and DISTINCT_COUNT work on a DATE or TEXT column. For one column''s trend, top values or spread, view