maxc-cli 0.8.1__tar.gz → 0.9.0__tar.gz

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxc-cli
-Version: 0.8.1
+Version: 0.9.0
 Summary: Agent-native MaxCompute CLI for external coding agents
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
@@ -70,7 +70,7 @@ maxc agent doctor --online --json
 |------|------|------|
 | **query** | `query [run]`, `query cost`, `query explain` | SQL 执行、成本估算、执行计划 |
 | **job** | `submit`, `status`, `wait`, `result`, `cancel`, `diagnose`, `list` | 异步任务全生命周期 |
-| **meta** | `list-tables`, `describe`, `search`, `search-columns`, `partitions`, `latest-partition`, `freshness`, `list-projects`, `list-schemas`, `semantic set/get/clear/list-missing` | 元数据发现与语义管理 |
+| **meta** | `list-tables`, `describe`, `list-functions`, `describe-function`, `search`, `search-columns`, `partitions`, `latest-partition`, `freshness`, `list-projects`, `list-schemas`, `semantic set/get/clear/list-missing` | 元数据发现与语义管理 |
 | **data** | `sample`, `profile`, `upload`, `download` | 数据采样、画像与 CSV/TSV 传输 |
 | **auth** | `login`, `login-external`, `logout`, `whoami`, `can-i` | 认证与权限 |
 | **session** | `set`, `show`, `unset` | 项目/Schema 切换 |
@@ -81,6 +81,18 @@ maxc agent doctor --online --json
 使用 `--json`；CSV/NDJSON 行流和 `job wait --stream` 生命周期流是明确例外，
 不会为每条记录重复封装 Envelope。
 
+0.9.0 起支持已注册函数的目录与详情查询：
+
+```bash
+aliyun maxc meta list-functions --project <project> --prefix <prefix> --limit 20 --json
+aliyun maxc meta describe-function <alias> --project <project> --json
+```
+
+三层项目可加 `--schema`；详情参数使用裸函数别名。列表有界分页，详情保留
+类名和原始资源引用，不下载资源内容，也不推断签名或 Python 版本。
+按作者文档确定调用契约后，复用现有 SQL 成本、执行和作业命令引用函数。
+具体流程见 [已注册函数](src/maxc_cli/skills/references/registered-functions.md)。
+
 ## Agent 集成
 
 ### 方式 1：公共 Skill（主路径）

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/README.md

@@ -48,7 +48,7 @@ maxc agent doctor --online --json
 |------|------|------|
 | **query** | `query [run]`, `query cost`, `query explain` | SQL 执行、成本估算、执行计划 |
 | **job** | `submit`, `status`, `wait`, `result`, `cancel`, `diagnose`, `list` | 异步任务全生命周期 |
-| **meta** | `list-tables`, `describe`, `search`, `search-columns`, `partitions`, `latest-partition`, `freshness`, `list-projects`, `list-schemas`, `semantic set/get/clear/list-missing` | 元数据发现与语义管理 |
+| **meta** | `list-tables`, `describe`, `list-functions`, `describe-function`, `search`, `search-columns`, `partitions`, `latest-partition`, `freshness`, `list-projects`, `list-schemas`, `semantic set/get/clear/list-missing` | 元数据发现与语义管理 |
 | **data** | `sample`, `profile`, `upload`, `download` | 数据采样、画像与 CSV/TSV 传输 |
 | **auth** | `login`, `login-external`, `logout`, `whoami`, `can-i` | 认证与权限 |
 | **session** | `set`, `show`, `unset` | 项目/Schema 切换 |
@@ -59,6 +59,18 @@ maxc agent doctor --online --json
 使用 `--json`；CSV/NDJSON 行流和 `job wait --stream` 生命周期流是明确例外，
 不会为每条记录重复封装 Envelope。
 
+0.9.0 起支持已注册函数的目录与详情查询：
+
+```bash
+aliyun maxc meta list-functions --project <project> --prefix <prefix> --limit 20 --json
+aliyun maxc meta describe-function <alias> --project <project> --json
+```
+
+三层项目可加 `--schema`；详情参数使用裸函数别名。列表有界分页，详情保留
+类名和原始资源引用，不下载资源内容，也不推断签名或 Python 版本。
+按作者文档确定调用契约后，复用现有 SQL 成本、执行和作业命令引用函数。
+具体流程见 [已注册函数](src/maxc_cli/skills/references/registered-functions.md)。
+
 ## Agent 集成
 
 ### 方式 1：公共 Skill（主路径）

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/src/maxc_cli/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.8.1"
+__version__ = "0.9.0"

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/src/maxc_cli/_samples.py

@@ -85,6 +85,14 @@ SAMPLES: dict[str, str] = {
         "maxc meta describe default.orders --project my_proj\n"
         "maxc meta describe default.orders --project my_proj --full --json"
     ),
+    "meta.list-functions": (
+        "maxc meta list-functions --project my_proj --prefix normalize_ --limit 20 --json\n"
+        "maxc meta list-functions --project my_proj --schema default --limit 20 --json"
+    ),
+    "meta.describe-function": (
+        "maxc meta describe-function normalize_phone --project my_proj --json\n"
+        "maxc meta describe-function normalize_phone --project my_proj --schema default --json"
+    ),
     "meta.search": (
         "maxc meta search orders\n"
         "maxc meta search user --project my_proj --json"

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/src/maxc_cli/app.py

@@ -44,6 +44,7 @@ from .exceptions import (
     TwoTierNamespaceError,
     ValidationError,
 )
+from .function_metadata import function_cursor, function_offset
 from .helpers import (
     build_odps_identity_payload,
     build_task_summary,
@@ -866,13 +867,22 @@ class MaxCApp:
                 session["job_id"],
                 project=session.get("project") or None,
             )
-            result = self.backend.fetch_job_result(
-                resolved.instance_id,
-                project=resolved.project,
-                max_rows=max_rows,
-                offset=offset,
-                session_context=resolved.session_context,
-            )
+            try:
+                result = self.backend.fetch_job_result(
+                    resolved.instance_id,
+                    project=resolved.project,
+                    max_rows=max_rows,
+                    offset=offset,
+                    session_context=resolved.session_context,
+                )
+            except Exception as exc:
+                error = exc if isinstance(exc, MaxCError) else translate_odps_error(exc)
+                envelope = self._job_result_fetch_failure(
+                    command, resolved, None, error.to_payload(),
+                    max_rows=max_rows, cursor=cursor,
+                )
+                self.log(command, envelope.status, envelope.metadata)
+                return envelope
             envelope = self._build_query_envelope(
                 command=command,
                 result=result,
@@ -1098,25 +1108,13 @@ class MaxCApp:
             except Exception as exc:
                 fetch_error = translate_odps_error(exc).to_payload()
             if fetch_error is not None:
-                envelope = Envelope(
-                    command=command,
-                    status="failure",
-                    data=None,
-                    error=fetch_error,
+                envelope = self._job_result_fetch_failure(
+                    command, resolved, job_info, fetch_error, max_rows=max_rows,
                     metadata={
-                        "job_id": resolved.external_job_id,
-                        "project": resolved.project,
-                        "logview": job_info.logview,
                         "sql_executed": sql,
                         **execution_metadata,
                     },
-                    agent_hints=AgentHints(
-                        actions=[
-                            action("job.result", data={"job_id": resolved.external_job_id}, metadata={"job_id": resolved.external_job_id, "project": resolved.project, "sql_executed": sql}),
-                            action("job.status", data={"job_id": resolved.external_job_id}, metadata={"job_id": resolved.external_job_id, "project": resolved.project}),
-                        ],
-                        warnings=common_warnings,
-                    ),
+                    warnings=common_warnings,
                 )
                 if idempotency_key:
                     envelope.metadata["idempotency_key"] = idempotency_key
@@ -1458,12 +1456,20 @@ class MaxCApp:
                 ]
                 self.log("job.wait", envelope.status, envelope.metadata)
                 return envelope, events
-            result = self.backend.fetch_job_result(
-                resolved.instance_id,
-                project=resolved.project,
-                max_rows=100,
-                session_context=resolved.session_context,
-            )
+            try:
+                result = self.backend.fetch_job_result(
+                    resolved.instance_id,
+                    project=resolved.project,
+                    max_rows=100,
+                    session_context=resolved.session_context,
+                )
+            except Exception as exc:
+                error = exc if isinstance(exc, MaxCError) else translate_odps_error(exc)
+                envelope = self._job_result_fetch_failure(
+                    "job.wait", resolved, after, error.to_payload(), max_rows=100,
+                )
+                self.log("job.wait", envelope.status, envelope.metadata)
+                return envelope, []
             envelope = self._build_query_envelope(
                 command="job.wait",
                 result=result,
@@ -1561,13 +1567,22 @@ class MaxCApp:
                 )
                 self.log("job.result", envelope.status, envelope.metadata)
                 return envelope
-            result = self.backend.fetch_job_result(
-                resolved.instance_id,
-                project=resolved.project,
-                max_rows=max_rows,
-                offset=offset,
-                session_context=resolved.session_context,
-            )
+            try:
+                result = self.backend.fetch_job_result(
+                    resolved.instance_id,
+                    project=resolved.project,
+                    max_rows=max_rows,
+                    offset=offset,
+                    session_context=resolved.session_context,
+                )
+            except Exception as exc:
+                error = exc if isinstance(exc, MaxCError) else translate_odps_error(exc)
+                envelope = self._job_result_fetch_failure(
+                    "job.result", resolved, info, error.to_payload(),
+                    max_rows=max_rows, cursor=cursor,
+                )
+                self.log("job.result", envelope.status, envelope.metadata)
+                return envelope
             envelope = self._build_query_envelope(
                 command="job.result",
                 result=result,
@@ -1669,6 +1684,48 @@ class MaxCApp:
         self.log("job.result", envelope.status, envelope.metadata)
         return envelope
 
+    def _job_result_fetch_failure(
+        self,
+        command: 'str',
+        resolved: '_ResolvedExternalJobId',
+        info: 'JobInfo | None',
+        error: 'ErrorPayload',
+        *,
+        max_rows: 'int',
+        cursor: 'str | None' = None,
+        metadata: 'dict[str, Any] | None' = None,
+        warnings: 'list[str] | None' = None,
+    ) -> 'Envelope':
+        """Keep the existing job and page observable when reading fails."""
+        scope = {
+            "job_id": resolved.external_job_id,
+            "project": resolved.project,
+            "logview": info.logview if info else error.logview,
+            **({
+                "job_status": info.status,
+                "submitted_at": info.submitted_at,
+                "completed_at": info.completed_at,
+            } if info else {}),
+            **(metadata or {}),
+        }
+        retry = action("job.result", data={"max_rows": max_rows, "cursor": cursor}, metadata=scope)
+        error.instance_id = resolved.external_job_id
+        error.logview = scope["logview"]
+        error.recovery_steps = [
+            "Retry reading the existing job result: " + retry.command,
+            "Do not resubmit the SQL to recover a result-reader failure.",
+        ]
+        return Envelope(
+            command=command,
+            status="failure",
+            error=error,
+            metadata=scope,
+            agent_hints=AgentHints(
+                actions=[retry, action("job.diagnose", metadata=scope)],
+                warnings=warnings or [],
+            ),
+        )
+
     def _bound_job_result_cursor(
         self,
         cursor: 'str | None',
@@ -1967,6 +2024,73 @@ class MaxCApp:
         self.log("job.list", envelope.status, envelope.metadata)
         return envelope
 
+    def meta_list_functions(
+        self,
+        *,
+        schema: 'str | None' = None,
+        project: 'str | None' = None,
+        prefix: 'str | None' = None,
+        limit: int = 50,
+        cursor: 'str | None' = None,
+    ) -> Envelope:
+        if type(limit) is not int or not 1 <= limit <= 1000:
+            raise ValidationError("Function list limit must be between 1 and 1000.")
+        target_project = project or self.config.default_project
+        effective_schema = schema or self.config.default_schema
+        offset = function_offset(cursor, project=target_project, schema=effective_schema, prefix=prefix)
+        rows, has_more = self.backend.list_functions(
+            project=target_project, schema=effective_schema, prefix=prefix, limit=limit, offset=offset,
+        )
+        data = {
+            "functions": [dict(row, project=target_project, schema_name=effective_schema) for row in rows],
+            "pagination": {
+                "returned_count": len(rows),
+                "has_more": has_more,
+                "limit": limit,
+                "offset": offset,
+                "next_cursor": function_cursor(
+                    offset + len(rows), project=target_project, schema=effective_schema, prefix=prefix,
+                ) if has_more else None,
+            },
+        }
+        metadata = {"project": target_project, "schema": effective_schema, "prefix": prefix}
+        envelope = Envelope(
+            command="meta.list-functions", status="success", data=data, metadata=metadata,
+            agent_hints=AgentHints(warnings=[
+                "Catalog pages are live and not a snapshot; registrations can change between calls.",
+                "Function aliases are metadata names, not SQL-qualified references. Verify namespace settings before constructing SQL.",
+            ]),
+        )
+        self.log(envelope.command, envelope.status, metadata)
+        return envelope
+
+    def meta_describe_function(
+        self,
+        function_name: str,
+        *,
+        schema: 'str | None' = None,
+        project: 'str | None' = None,
+    ) -> Envelope:
+        if not function_name or any(char.isspace() or char in ".:/\\" for char in function_name):
+            raise ValidationError(
+                "Pass a bare registered function alias.",
+                suggestion="Select the function's project and schema with --project and --schema.",
+            )
+        target_project = project or self.config.default_project
+        effective_schema = schema or self.config.default_schema
+        detail = self.backend.describe_function(function_name, project=target_project, schema=effective_schema)
+        detail = dict(detail, project=target_project, schema_name=effective_schema)
+        metadata = {"project": target_project, "schema": effective_schema}
+        envelope = Envelope(
+            command="meta.describe-function", status="success", data={"function": detail}, metadata=metadata,
+            agent_hints=AgentHints(warnings=[
+                "Registration metadata does not establish the input/output signature or runtime version. Use the function owner's documentation or verified user context; do not infer them from class or resource names.",
+                "Metadata Read and SQL Execute are separate permissions. A failed describe is not proof that an already-known function cannot be executed.",
+            ]),
+        )
+        self.log(envelope.command, envelope.status, metadata)
+        return envelope
+
     def meta_list_tables(
         self,
         *,

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/src/maxc_cli/backend/job.py

@@ -846,10 +846,12 @@ class JobMixin(QueryMixin):
         return sql.rstrip(";") if sql else None
 
     def _safe_logview(self, instance) -> 'str | None':
-        """Get a LogView URL without exposing its signed query or fragment."""
+        """Get a usable SDK LogView URL for the caller, without URL userinfo."""
         from ..utils import sanitize_logview_url
 
         try:
-            return sanitize_logview_url(instance.get_logview_address())
+            return sanitize_logview_url(
+                instance.get_logview_address(), include_access_token=True,
+            )
         except Exception:
             return None

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/src/maxc_cli/backend/meta.py

@@ -20,6 +20,100 @@ from ..helpers import (
 class MetaMixin:
     """Mixin providing metadata methods."""
 
+    def list_functions(
+        self,
+        *,
+        project: 'str | None' = None,
+        schema: 'str | None' = None,
+        prefix: 'str | None' = None,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> 'tuple[list[dict[str, Any]], bool]':
+        """Read a bounded catalog window without per-function metadata GETs.
+
+        Args:
+            project: Function project, or the configured project.
+            schema: Explicit function schema, when applicable.
+            prefix: Server-side alias prefix filter.
+            limit: Maximum returned functions.
+            offset: Number of earlier matching catalog entries to skip.
+
+        Returns:
+            Parsed collection rows and whether another matching entry exists.
+        """
+        try:
+            iterator = iter(self.client.list_functions(
+                project=project or self.project, schema=schema, prefix=prefix,
+            ))
+            window = list(islice(iterator, offset, offset + limit + 1))
+            # PyODPS models lazily reload missing fields. Read only parsed
+            # collection fields here so List does not also require Read.
+            rows = [{
+                "function_name": object.__getattribute__(item, "name"),
+                "class_type": object.__getattribute__(item, "class_type"),
+                "owner": object.__getattribute__(item, "_owner"),
+            } for item in window[:limit]]
+            return rows, len(window) > limit
+        except Exception as exc:
+            raise translate_odps_error(exc, "list_functions") from exc
+
+    def describe_function(
+        self,
+        function_name: str,
+        *,
+        project: 'str | None' = None,
+        schema: 'str | None' = None,
+    ) -> 'dict[str, Any]':
+        """Read registration metadata without loading resource contents.
+
+        Args:
+            function_name: Bare registered function alias.
+            project: Function project, or the configured project.
+            schema: Explicit function schema, when applicable.
+
+        Returns:
+            Registration metadata with exact resource references and unknown
+            signature/runtime fields. Implementation code is excluded.
+        """
+        try:
+            function = self.client.get_function(
+                function_name, project=project or self.project, schema=schema,
+            )
+            # get_function is lazy: reload explicitly so missing aliases fail
+            # even when the SDK already knows the requested name.
+            function.reload()
+
+            def read(key: str) -> Any:
+                try:
+                    return object.__getattribute__(function, key)
+                except AttributeError:
+                    # Older supported PyODPS releases omit optional flags.
+                    return None
+
+            return {
+                "function_name": read("name"),
+                "class_type": read("class_type"),
+                "resource_names": list(read("_resources") or []),
+                "owner": read("_owner"),
+                "creation_time": _dt_to_iso(read("creation_time")),
+                "program_language": read("program_language"),
+                "is_sql_function": self._function_boolean(read("is_sql_function")),
+                "is_embedded_function": self._function_boolean(read("is_embedded_function")),
+                "file_name": read("file_name"),
+                "signature": None,
+                "runtime_version": None,
+            }
+        except Exception as exc:
+            raise translate_odps_error(exc, "describe_function") from exc
+
+    @staticmethod
+    def _function_boolean(value: Any) -> 'bool | None':
+        if value is True or str(value).lower() == "true":
+            return True
+        if value is False or str(value).lower() == "false":
+            return False
+        return None
+
     def list_tables(
         self,
         *,

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/src/maxc_cli/backend/odps.py

@@ -152,7 +152,17 @@ class OdpsBackend(
                             # timeout), the column metadata is parsed lazily from the
                             # CSV header during the first __next__ call — so we can
                             # only inspect it after iteration begins.
-                            records = list(islice(reader, offset, offset + max_rows))
+                            iterator = iter(reader)
+                            skipped = sum(1 for _ in islice(iterator, offset))
+                            records = list(islice(iterator, max_rows))
+                            count = getattr(reader, "count", None)
+                            # CSV fallback readers expose no count. Count the
+                            # remaining accessible records without retaining
+                            # them so a page is not mistaken for the full result.
+                            accessible_count = (
+                                skipped + len(records) + sum(1 for _ in iterator)
+                                if count is None else int(count)
+                            )
 
                             reader_schema = getattr(reader, "schema", None)
                             if reader_schema is not None and hasattr(reader_schema, "columns"):
@@ -181,7 +191,7 @@ class OdpsBackend(
                                     record_to_dict(column_names, record.values)
                                     for record in records
                                 ]
-                                total_rows = int(getattr(reader, "count", len(rows)) or len(rows))
+                                total_rows = accessible_count
                     except Exception as reader_exc:
                         # Some SHOW results (e.g. multi-column SHOW INDEXES
                         # col_names) contain unquoted commas that make
@@ -197,7 +207,7 @@ class OdpsBackend(
                         rows = all_raw_rows[offset : offset + max_rows]
                         schema = [{"name": name, "type": "string", "comment": ""}
                                   for name in _RAW_RESULT_COLUMNS]
-                        total_rows = len(rows)
+                        total_rows = len(all_raw_rows)
 
                 for w in captured:
                     msg_text = str(w.message)
@@ -210,7 +220,10 @@ class OdpsBackend(
                         warnings.formatwarning(w.message, w.category, w.filename, w.lineno)
                     )
             except Exception as exc:
-                raise translate_odps_error(exc) from exc
+                error = translate_odps_error(exc)
+                error.instance_id = instance.id
+                error.logview = self._safe_logview(instance)
+                raise error from exc
 
         if degraded_reason is not None:
             fallback_warnings.append(
@@ -223,6 +236,7 @@ class OdpsBackend(
         returned_rows = len(rows)
         has_more = total_rows > (offset + returned_rows)
         extra_metadata["current_offset"] = offset
+        extra_metadata["logview"] = self._safe_logview(instance)
         if degraded_reason is not None:
             extra_metadata["result_kind"] = "raw_task_result"
         if resultless_statement:

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/src/maxc_cli/backend/query.py

@@ -506,7 +506,6 @@ class QueryMixin:
             submitted_at=now_utc_iso(),
             updated_at=now_utc_iso(),
             logview=self._safe_logview(instance),
-            warnings=["The MaxCompute instance has been submitted; use job.status or job.wait to track it."],
             session_task_name=session_task_name,
             session_subquery_id=session_subquery_id,
             session_project_name=getattr(getattr(instance, "project", None), "name", None),

{maxc_cli-0.8.1 → maxc_cli-0.9.0}/src/maxc_cli/cli.py

@@ -455,6 +455,22 @@ def build_parser() -> argparse.ArgumentParser:
     meta_describe.add_argument("--full", action="store_true", help="Show full column list (default is summary mode)")
     meta_describe.set_defaults(handler=_handle_meta_describe)
 
+    meta_functions = _make_parser(meta_subparsers, "list-functions", "meta.list-functions", help="List registered functions")
+    meta_functions.add_argument("--project", help="Target MaxCompute project")
+    meta_functions.add_argument("--schema", help="Schema name (overrides session default)")
+    meta_functions.add_argument("--prefix", help="Function alias prefix filter")
+    meta_functions.add_argument("--limit", type=positive_int, default=50, help="Maximum functions to return (1-1000; default 50)")
+    meta_functions.add_argument("--cursor", help="Scope-bound cursor returned by the previous function list")
+    meta_functions.add_argument("--json", action="store_true", help="Output as JSON envelope")
+    meta_functions.set_defaults(handler=_handle_meta_list_functions)
+
+    meta_function = _make_parser(meta_subparsers, "describe-function", "meta.describe-function", help="Describe a registered function")
+    meta_function.add_argument("function_name", help="Bare registered alias; select scope with --project / --schema")
+    meta_function.add_argument("--project", help="Target MaxCompute project")
+    meta_function.add_argument("--schema", help="Schema name (overrides session default)")
+    meta_function.add_argument("--json", action="store_true", help="Output as JSON envelope")
+    meta_function.set_defaults(handler=_handle_meta_describe_function)
+
     meta_search = _make_parser(meta_subparsers, "search", "meta.search", help="Search tables")
     meta_search.add_argument("keyword", help="Search keyword")
     meta_search.add_argument("--schema", help="Schema name (overrides session default)")
@@ -1786,7 +1802,7 @@ def run(
             if getattr(exc, "logview", None):
                 from .utils import sanitize_logview_url
 
-                stderr.write(f"  LogView: {sanitize_logview_url(exc.logview)}\n")
+                stderr.write(f"  LogView: {sanitize_logview_url(exc.logview, include_access_token=True)}\n")
         return exc.exit_code
     except Exception as exc:
         error_payload = ErrorPayload(
@@ -2121,6 +2137,18 @@ def _handle_meta_list_tables(app: MaxCApp, args: argparse.Namespace, stdout: Tex
     _emit_envelope(envelope, args=args, stdout=stdout, default_format="table")
 
 
+def _handle_meta_list_functions(app: MaxCApp, args: argparse.Namespace, stdout: TextIO) -> None:
+    envelope = app.meta_list_functions(
+        project=args.project, schema=args.schema, prefix=args.prefix, limit=args.limit, cursor=args.cursor,
+    )
+    _emit_envelope(envelope, args=args, stdout=stdout, default_format="table")
+
+
+def _handle_meta_describe_function(app: MaxCApp, args: argparse.Namespace, stdout: TextIO) -> None:
+    envelope = app.meta_describe_function(args.function_name, project=args.project, schema=args.schema)
+    _emit_envelope(envelope, args=args, stdout=stdout, default_format="table")
+
+
 def _handle_meta_describe(app: MaxCApp, args: argparse.Namespace, stdout: TextIO) -> None:
     # When --json is used, always return full schema (agents need all columns)
     full = args.full or _is_json_mode(args)
@@ -2966,6 +2994,8 @@ def _manifest_effects(command: str) -> list[dict[str, Any]]:
         ),
     ]
     effects_by_command: dict[str, list[dict[str, Any]]] = {
+        "meta.list-functions": [_manifest_effect("remote", "read", "maxcompute_function_catalog")],
+        "meta.describe-function": [_manifest_effect("remote", "read", "maxcompute_function_metadata")],
         "agent.context": [
             _manifest_effect("local", "read", "config_and_runtime_readiness"),
         ],
@@ -4446,7 +4476,7 @@ def _render_human(envelope: Envelope) -> str:
         if logview:
             from .utils import sanitize_logview_url
 
-            details["logview"] = sanitize_logview_url(logview)
+            details["logview"] = sanitize_logview_url(logview, include_access_token=True)
         if error.context:
             details["context"] = error.context
         sections.append(render_key_values(details))
@@ -4491,11 +4521,20 @@ def _render_human(envelope: Envelope) -> str:
                 )
         return "\n\n".join(section for section in sections if section)
 
+    if envelope.status == "pending" and (command == "query" or command.startswith("job.")):
+        from .output import render_markdown
+
+        return render_markdown(envelope)
+
     if command == "query":
+        from .utils import sanitize_logview_url
+
         rows = data.get("rows", [])
         summary = render_key_values(
             {
                 "status": envelope.status,
+                "job_id": metadata.get("job_id"),
+                "logview": sanitize_logview_url(metadata.get("logview"), include_access_token=True),
                 "project": metadata.get("project"),
                 "elapsed_ms": metadata.get("elapsed_ms"),
                 "returned_rows": data.get("returned_rows"),
@@ -4518,6 +4557,12 @@ def _render_human(envelope: Envelope) -> str:
     if command == "meta.list-tables":
         return render_table(data.get("tables", []))
 
+    if command == "meta.list-functions":
+        return render_table(data.get("functions", []))
+
+    if command == "meta.describe-function":
+        return render_key_values(data.get("function", {}))
+
     if command == "meta.describe":
         # Render schema/partition_columns as nested sub-tables instead of
         # JSON-stringifying them into a single cell.
@@ -4584,6 +4629,7 @@ _RECORD_COLLECTION_KEYS: dict[str, tuple[str, str]] = {
     "meta.list-projects": ("projects", "project"),
     "meta.list-schemas": ("schemas", "schema"),
     "meta.list-tables": ("tables", "table"),
+    "meta.list-functions": ("functions", "function"),
     "meta.partitions": ("partitions", "partition"),
     "meta.search": ("matches", "match"),
     "meta.search-columns": ("matches", "match"),
@@ -4596,6 +4642,7 @@ _RECORD_DEFAULT_COLUMNS: dict[str, list[str]] = {
     "job.list": ["job_id", "status", "progress", "project", "submitted_at"],
     "meta.list-projects": ["name"],
     "meta.list-schemas": ["name"],
+    "meta.list-functions": ["function_name", "project", "schema_name", "class_type", "owner"],
     "meta.list-tables": [
         "table_name",
         "schema_name",