@thinkingai/ae-cli 6.0.18 → 6.0.22

package/skills/ae-metadata/references/metadata_data_table_sql_write.md

@@ -0,0 +1,31 @@
+# metadata data-table sql-write
+
+> Capability id: `metadata.data_table.sql_write` · Domain: `metadata`.
+
+## Command
+
+```bash
+ae-cli metadata data-table sql-write --project-id <project_id> --operation create --table-name <name> --columns '<columns_json>' --qp '<qp_json>' --strategy overwrite --yes
+ae-cli metadata data-table sql-write --project-id <project_id> --operation update --data-table-id <id> --columns '<columns_json>' --qp '<qp_json>' --yes
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--operation` | Yes | `create` or `update`. |
+| `--columns` | Yes | Column definitions JSON array. |
+| `--qp` | Yes | SQL data table query plan JSON. |
+| `--data-table-id` | For update | Existing data table ID. |
+| `--table-name` | For create | Technical table name. |
+| `--display-name` | No | Human-readable name. |
+| `--remarks` | No | Table remarks. |
+| `--zone-offset` | No | Time zone offset such as `+08:00`. |
+| `--strategy` | No | `overwrite` or `insert`. |
+| `--update-cron` | No | Scheduled update cron. |
+
+## Decision Rules
+
+- This is a write command; use `--dry-run` before non-dry-run and pass `--yes` when executing.
+- Keep `columns` and `qp` as valid JSON; do not pass raw SQL unless the server schema requires it inside `qp`.

package/skills/ae-metadata/references/metadata_event_get.md

@@ -0,0 +1,52 @@
+# metadata event get (Super-Event Detail)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md) (`ae-metadata` skill).
+>
+> Capability id: `metadata.event.get` · Domain: `metadata` (capability gateway REST, not MCP `analysis_meta`).
+
+## Use Cases
+
+- Fetch **one** super-event metadata record by technical name (full detail, not a paginated list).
+- Inspect virtual event definition (`definition.sources`, filters, relation) when `event_kind=virtual_event`.
+- Read-only; requires metadata **view** permission (`VIEW_META`) in the target project.
+
+## Commands
+
+```bash
+ae-cli metadata event get --project-id <project_id> --event-name <event_name>
+ae-cli metadata event get -p <project_id> --event-name <event_name> --dry-run
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--event-name` | Yes | Super-event technical name. Virtual events use the same field. |
+
+Gateway request body uses snake_case `input`:
+
+```json
+{
+  "project_id": 1,
+  "event_name": "purchase"
+}
+```
+
+## Decision Rules
+
+- Prefer **`metadata event get`** over `analysis_meta +list_events` when you need **full detail + virtual definition**, not browsing or fuzzy search.
+- Use `ae-analysis` → `analysis_meta +list_events` first when the event name is unknown or you need keyword search / pagination.
+- If the gateway returns `EVENT_NOT_FOUND`, verify `event_name` spelling and `project_id`; do not invent names.
+- Auth: `cli-token` header (ae-cli injects automatically in sandbox; local CLI uses `getCliToken()`).
+
+## Recommended Chaining
+
+- `ae-analysis`: `analysis_meta +list_events` (discover name) → `metadata event get` (detail)
+- `metadata event get` → `metadata property get` (inspect properties listed in response)
+
+## Next Steps After Failure
+
+- Empty or not found: confirm project id and exact `event_name` from `+list_events`.
+- Permission error: confirm metadata view permission in the project.
+- Gateway unavailable: confirm nginx routes `/api/cli/metadata/` and backend capability catalog is deployed.

package/skills/ae-metadata/references/metadata_input_file_upload.md

@@ -0,0 +1,29 @@
+# metadata input-file upload
+
+> Capability endpoint: `POST /api/cli/metadata/v1/input-files` · Domain: `metadata`.
+
+## Use Cases
+
+- Upload a local CSV file before `metadata data-table csv-write`.
+- Get an `input_file_id` such as `ifile_<32 lowercase hex>`.
+
+## Command
+
+```bash
+ae-cli metadata input-file upload --project-id <project_id> --purpose data_table.csv --file <local_file> --yes
+ae-cli metadata input-file upload --project-id <project_id> --purpose data_table.csv --file <local_file> --dry-run
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--purpose` | Yes | Input-file purpose. Use `data_table.csv` for data table CSV imports. |
+| `--file` | Yes | Local file path to upload. |
+
+## Decision Rules
+
+- Run `--dry-run` first to verify the gateway URL and multipart fields.
+- Use the returned `input_file_id` in CSV data-table write or create-and-bind commands.
+- This is a write command; non-dry-run execution requires `--yes`.

package/skills/ae-metadata/references/metadata_property_dimension_table_bind_existing.md

@@ -0,0 +1,27 @@
+# metadata property bind-existing-dimension-table
+
+> Capability id: `metadata.property.bind_existing_dimension_table` · Domain: `metadata`.
+
+## Command
+
+```bash
+ae-cli metadata property bind-existing-dimension-table --project-id <project_id> --property-name <name> --property-scope user --data-table-id <id> --yes
+ae-cli metadata property bind-existing-dimension-table --project-id <project_id> --property-name <name> --property-scope event --data-table-id <id> --dict-columns '["display_name"]' --yes
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--property-name` | Yes | Property technical name. |
+| `--property-scope` | Yes | Property owner table, for example `event` or `user`. |
+| `--data-table-id` | Yes | Existing dimension data table ID. |
+| `--timestamp-join-format` | No | Timestamp join format. |
+| `--dict-columns` | No | Dictionary column names JSON array. |
+
+## Decision Rules
+
+- Confirm the property with `metadata property get` or `analysis_meta +list_properties`.
+- Confirm the data table with `metadata data-table get`.
+- This is a write command; use `--dry-run` before non-dry-run and pass `--yes` when executing.

package/skills/ae-metadata/references/metadata_property_dimension_table_create_and_bind_csv.md

@@ -0,0 +1,30 @@
+# metadata property create-and-bind-csv-dimension-table
+
+> Capability id: `metadata.property.create_and_bind_csv_dimension_table` · Domain: `metadata`.
+
+## Command
+
+```bash
+ae-cli metadata property create-and-bind-csv-dimension-table --project-id <project_id> --property-name <name> --property-scope user --input-file-id <input_file_id> --data-table-name <table_name> --columns '<columns_json>' --yes
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--property-name` | Yes | Property technical name. |
+| `--property-scope` | Yes | Property owner table, for example `event` or `user`. |
+| `--input-file-id` | Yes | ID returned by `metadata input-file upload`. |
+| `--data-table-name` | No | Technical data table name. |
+| `--display-name` | No | Human-readable table name. |
+| `--description` | No | Table description. |
+| `--columns` | No | Column definitions JSON array. |
+| `--timestamp-join-format` | No | Timestamp join format. |
+| `--dict-columns` | No | Dictionary column names JSON array. |
+
+## Decision Rules
+
+- Upload the CSV first with `metadata input-file upload --purpose data_table.csv`.
+- Use this one-step command when the user wants a new CSV dimension table bound to a property.
+- This is a write command; use `--dry-run` before non-dry-run and pass `--yes` when executing.

package/skills/ae-metadata/references/metadata_property_get.md

@@ -0,0 +1,54 @@
+# metadata property get (Super-Property Detail)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md) (`ae-metadata` skill).
+>
+> Capability id: `metadata.property.get` · Domain: `metadata` (capability gateway REST, not MCP `analysis_meta`).
+
+## Use Cases
+
+- Fetch **one** super-property metadata record (event scope or user scope).
+- Inspect virtual property definition (`definition.expression`, `dependencies`).
+- Read-only; requires metadata **view** permission in the target project.
+
+## Commands
+
+```bash
+ae-cli metadata property get --project-id <project_id> --property-name <name> --property-scope event
+ae-cli metadata property get --project-id <project_id> --property-name <name> --property-scope user --dry-run
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--property-name` | Yes | Super-property technical name. |
+| `--property-scope` | Yes | `event` (super event properties) or `user` (super user properties). |
+
+Gateway request body uses snake_case `input`:
+
+```json
+{
+  "project_id": 1,
+  "property_name": "price",
+  "property_scope": "event"
+}
+```
+
+## Decision Rules
+
+- Prefer **`metadata property get`** over `analysis_meta +list_properties` when you need **full detail + virtual definition**, not browsing or fuzzy search.
+- Use `ae-analysis` → `analysis_meta +list_properties` first when the property name is unknown or you need keyword search / pagination.
+- `property_scope` must be exactly `event` or `user` (backend accepts case-insensitive).
+- Virtual / dict / exchange-rate properties are addressed by `property-name` only; do not pass legacy `prop_name`.
+- Event-scoped names like `#account_id` must be passed literally (quote in shell when `#` is present).
+
+## Recommended Chaining
+
+- `ae-analysis`: `analysis_meta +list_properties` (discover name + scope) → `metadata property get` (detail)
+- `metadata event get` → `metadata property get` (follow properties from event detail)
+
+## Next Steps After Failure
+
+- Not found: confirm scope (`event` vs `user`) and exact name from `+list_properties`.
+- Permission error: confirm metadata view permission in the project.

package/dist/te-audience-KMKYI2YJ.js

@@ -1,400 +0,0 @@
-import {
-  callMcpTool,
-  parseMcpResult,
-  resolveMcpUrl
-} from "./chunk-DMMEPCST.js";
-import "./chunk-PN3OS34E.js";
-import "./chunk-NOO24N7W.js";
-import "./chunk-RSHMZ3LG.js";
-import "./chunk-6W4QOZAL.js";
-
-// src/commands/te-audience/shared.ts
-function createMcpCommand(config) {
-  const toolName = config.command.slice(1);
-  const mcpService = config.mcpService || "analysis";
-  return {
-    service: "analysis_audience",
-    command: config.command,
-    description: config.description,
-    flags: config.flags,
-    risk: config.risk,
-    dryRun: (ctx) => ({
-      method: "tools/call",
-      url: resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService),
-      body: {
-        name: toolName,
-        arguments: config.buildArgs(ctx)
-      }
-    }),
-    execute: async (ctx) => {
-      const url = resolveMcpUrl(ctx.mcpUrl(), ctx.host(), mcpService);
-      const result = await callMcpTool(url, toolName, config.buildArgs(ctx), ctx.host());
-      return parseMcpResult(result);
-    }
-  };
-}
-function optionalString(ctx, name) {
-  const value = ctx.str(name);
-  return value === "" ? void 0 : value;
-}
-function optionalNumber(ctx, name) {
-  const value = ctx.str(name);
-  return value === "" ? void 0 : Number(value);
-}
-function optionalBoolean(ctx, name) {
-  const value = ctx.str(name);
-  return value === "" ? void 0 : ctx.bool(name);
-}
-function optionalJson(ctx, name) {
-  const value = ctx.str(name);
-  return value === "" ? void 0 : ctx.json(name);
-}
-function optionalJsonString(ctx, name) {
-  const value = optionalJson(ctx, name);
-  return value === void 0 ? void 0 : JSON.stringify(value);
-}
-function requiredJsonString(ctx, name) {
-  return JSON.stringify(ctx.json(name));
-}
-
-// src/commands/te-audience/cluster/list-clusters.ts
-var listClusters = createMcpCommand({
-  command: "+list_clusters",
-  description: "List user cohort/segment cluster metadata with optional query/fields/limit/offset.",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "query", type: "string", required: false, desc: "Keyword filter", alias: "q" },
-    { name: "fields", type: "json", required: false, desc: "Optional return field list JSON array" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 10000" },
-    { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" }
-  ],
-  risk: "read",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    query: optionalString(ctx, "query"),
-    fields: optionalJson(ctx, "fields"),
-    limit: optionalNumber(ctx, "limit"),
-    offset: optionalNumber(ctx, "offset")
-  })
-});
-
-// src/commands/te-audience/cluster/get-clusters-by-name.ts
-var getClustersByName = createMcpCommand({
-  command: "+get_clusters_by_name",
-  description: "Get cluster definition details in batch by cluster names",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "names", type: "json", required: true, desc: 'Cluster name list JSON array, e.g. ["cluster_a","cluster_b"]' }
-  ],
-  risk: "read",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    names: ctx.json("names")
-  })
-});
-
-// src/commands/te-audience/cluster/list-cluster-members.ts
-var listClusterMembers = createMcpCommand({
-  command: "+list_cluster_members",
-  description: "List members in the specified cluster with optional query/fields/limit/offset. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "cluster_name", type: "string", required: true, desc: "Cluster name" },
-    { name: "property_names", type: "json", required: false, desc: "Optional user property name list JSON array" },
-    { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache, default true" },
-    { name: "query", type: "string", required: false, desc: "Optional keyword filter on #user_id and selected properties" },
-    { name: "fields", type: "json", required: false, desc: "Optional return field list JSON array" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 10000" },
-    { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" },
-    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
-    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
-  ],
-  risk: "read",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    clusterName: ctx.str("cluster_name"),
-    propertyNames: optionalJson(ctx, "property_names"),
-    useCache: optionalBoolean(ctx, "use_cache"),
-    query: optionalString(ctx, "query"),
-    fields: optionalJson(ctx, "fields"),
-    limit: optionalNumber(ctx, "limit"),
-    offset: optionalNumber(ctx, "offset"),
-    requestId: optionalString(ctx, "request_id"),
-    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
-  })
-});
-
-// src/commands/te-audience/cluster/create-cluster.ts
-var createCluster = createMcpCommand({
-  command: "+create_cluster",
-  description: "Create a user cluster definition",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "cluster_name", type: "string", required: true, desc: "Cluster name. Must start with a letter and contain only letters, digits, and underscores. Length: 1-80" },
-    { name: "display_name", type: "string", required: true, desc: "Cluster display name. Length: 1-80" },
-    { name: "type", type: "string", required: false, desc: "Cluster type: condition/sql. Default: condition" },
-    { name: "definition", type: "json", required: true, desc: "Cluster definition JSON. See +get_cluster_definition_schema" },
-    { name: "zone_offset", type: "number", required: false, desc: "Optional time zone offset, valid range: -12 to 14" },
-    { name: "entity_id", type: "number", required: false, desc: "Optional entity ID. Use analysis_meta +list_entities to query" }
-  ],
-  risk: "write",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    clusterName: ctx.str("cluster_name"),
-    displayName: ctx.str("display_name"),
-    type: optionalString(ctx, "type"),
-    definition: requiredJsonString(ctx, "definition"),
-    zoneOffset: optionalNumber(ctx, "zone_offset"),
-    entityId: optionalNumber(ctx, "entity_id")
-  })
-});
-
-// src/commands/te-audience/cluster/update-cluster.ts
-var updateCluster = createMcpCommand({
-  command: "+update_cluster",
-  description: "Update a user cluster definition",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "cluster_name", type: "string", required: true, desc: "Cluster name" },
-    { name: "display_name", type: "string", required: false, desc: "New cluster display name. Length: 1-80" },
-    { name: "remark", type: "string", required: false, desc: "New cluster remark" },
-    { name: "type", type: "string", required: false, desc: "New cluster type: condition/sql. Recommended when updating definition" },
-    { name: "definition", type: "json", required: false, desc: "New cluster definition JSON. See +get_cluster_definition_schema" },
-    { name: "zone_offset", type: "number", required: false, desc: "Optional time zone offset, valid range: -12 to 14" }
-  ],
-  risk: "write",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    clusterName: ctx.str("cluster_name"),
-    displayName: optionalString(ctx, "display_name"),
-    remark: optionalString(ctx, "remark"),
-    type: optionalString(ctx, "type"),
-    definition: optionalJsonString(ctx, "definition"),
-    zoneOffset: optionalNumber(ctx, "zone_offset")
-  })
-});
-
-// src/commands/te-audience/cluster/refresh-cluster.ts
-var refreshCluster = createMcpCommand({
-  command: "+refresh_cluster",
-  description: "Trigger cluster recomputation asynchronously",
-  flags: [
-    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
-    { name: "cluster_name", type: "string", required: true, desc: "Cluster name" }
-  ],
-  risk: "write",
-  mcpService: "te_analysis_extend",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    clusterName: ctx.str("cluster_name")
-  })
-});
-
-// src/commands/te-audience/cluster/index.ts
-var commands = [
-  listClusters,
-  getClustersByName,
-  listClusterMembers,
-  createCluster,
-  updateCluster,
-  refreshCluster
-];
-var cluster_default = commands;
-
-// src/commands/te-audience/tag/list-tags.ts
-var listTags = createMcpCommand({
-  command: "+list_tags",
-  description: "List tag metadata with optional query/fields/limit/offset",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "query", type: "string", required: false, desc: "Keyword filter", alias: "q" },
-    { name: "fields", type: "json", required: false, desc: "Optional return field list JSON array" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 10000" },
-    { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" }
-  ],
-  risk: "read",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    query: optionalString(ctx, "query"),
-    fields: optionalJson(ctx, "fields"),
-    limit: optionalNumber(ctx, "limit"),
-    offset: optionalNumber(ctx, "offset")
-  })
-});
-
-// src/commands/te-audience/tag/get-tags-by-name.ts
-var getTagsByName = createMcpCommand({
-  command: "+get_tags_by_name",
-  description: "Get tag definition details in batch by tag names",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "names", type: "json", required: true, desc: 'Tag name list JSON array, e.g. ["tag_a","tag_b"]' }
-  ],
-  risk: "read",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    names: ctx.json("names")
-  })
-});
-
-// src/commands/te-audience/tag/list-tag-members.ts
-var listTagMembers = createMcpCommand({
-  command: "+list_tag_members",
-  description: "List members in the specified tag with optional query/fields/limit/offset. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "tag_name", type: "string", required: true, desc: "Tag name" },
-    { name: "snapshot_date", type: "string", required: false, desc: "Optional tag snapshot date, format YYYY-MM-DD" },
-    { name: "property_names", type: "json", required: false, desc: "Optional user property name list JSON array" },
-    { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache, default true" },
-    { name: "query", type: "string", required: false, desc: "Optional keyword filter on #user_id and selected properties" },
-    { name: "fields", type: "json", required: false, desc: "Optional return field list JSON array" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 10000" },
-    { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" },
-    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
-    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
-  ],
-  risk: "read",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    tagName: ctx.str("tag_name"),
-    snapshotDate: optionalString(ctx, "snapshot_date"),
-    propertyNames: optionalJson(ctx, "property_names"),
-    useCache: optionalBoolean(ctx, "use_cache"),
-    query: optionalString(ctx, "query"),
-    fields: optionalJson(ctx, "fields"),
-    limit: optionalNumber(ctx, "limit"),
-    offset: optionalNumber(ctx, "offset"),
-    requestId: optionalString(ctx, "request_id"),
-    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
-  })
-});
-
-// src/commands/te-audience/tag/create-tag.ts
-var createTag = createMcpCommand({
-  command: "+create_tag",
-  description: "Create a user tag definition",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "tag_name", type: "string", required: true, desc: "Tag name. Must start with a letter and contain only letters, digits, and underscores. Length: 1-80" },
-    { name: "display_name", type: "string", required: true, desc: "Tag display name. Length: 1-80" },
-    { name: "type", type: "string", required: false, desc: "Tag type: condition/metric/first_last/sql. Default: condition" },
-    { name: "definition", type: "json", required: true, desc: "Tag definition JSON. See +get_tag_definition_schema" },
-    { name: "zone_offset", type: "number", required: false, desc: "Optional time zone offset, valid range: -12 to 14" },
-    { name: "entity_id", type: "number", required: false, desc: "Optional entity ID. Use analysis_meta +list_entities to query" }
-  ],
-  risk: "write",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    tagName: ctx.str("tag_name"),
-    displayName: ctx.str("display_name"),
-    type: optionalString(ctx, "type"),
-    definition: requiredJsonString(ctx, "definition"),
-    zoneOffset: optionalNumber(ctx, "zone_offset"),
-    entityId: optionalNumber(ctx, "entity_id")
-  })
-});
-
-// src/commands/te-audience/tag/update-tag.ts
-var updateTag = createMcpCommand({
-  command: "+update_tag",
-  description: "Update a user tag definition",
-  flags: [
-    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
-    { name: "tag_name", type: "string", required: true, desc: "Tag name" },
-    { name: "display_name", type: "string", required: false, desc: "New tag display name. Length: 1-80" },
-    { name: "remark", type: "string", required: false, desc: "New tag remark" },
-    { name: "type", type: "string", required: false, desc: "New tag type: condition/metric/first_last/sql" },
-    { name: "definition", type: "json", required: false, desc: "New tag definition JSON. See +get_tag_definition_schema" },
-    { name: "zone_offset", type: "number", required: false, desc: "Optional time zone offset, valid range: -12 to 14" }
-  ],
-  risk: "write",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    tagName: ctx.str("tag_name"),
-    displayName: optionalString(ctx, "display_name"),
-    remark: optionalString(ctx, "remark"),
-    type: optionalString(ctx, "type"),
-    definition: optionalJsonString(ctx, "definition"),
-    zoneOffset: optionalNumber(ctx, "zone_offset")
-  })
-});
-
-// src/commands/te-audience/tag/refresh-tag.ts
-var refreshTag = createMcpCommand({
-  command: "+refresh_tag",
-  description: "Trigger tag recomputation asynchronously",
-  flags: [
-    { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
-    { name: "tag_name", type: "string", required: true, desc: "Tag name" }
-  ],
-  risk: "write",
-  mcpService: "te_analysis_extend",
-  buildArgs: (ctx) => ({
-    projectId: ctx.num("project_id"),
-    tagName: ctx.str("tag_name")
-  })
-});
-
-// src/commands/te-audience/tag/index.ts
-var commands2 = [
-  listTags,
-  getTagsByName,
-  listTagMembers,
-  createTag,
-  updateTag,
-  refreshTag
-];
-var tag_default = commands2;
-
-// src/commands/te-audience/schema/get-cluster-definition-schema.ts
-var getClusterDefinitionSchema = createMcpCommand({
-  command: "+get_cluster_definition_schema",
-  description: "Get the cluster definition schema by type and optional response mode",
-  flags: [
-    { name: "cluster_type", type: "string", required: true, desc: "Cluster type: condition/sql" },
-    { name: "response_mode", type: "string", required: false, desc: "Optional response mode: base/examples/full" },
-    { name: "condition_subtype", type: "string", required: false, desc: "Optional subtype when cluster_type=condition: core/behavior_seq/all" }
-  ],
-  risk: "read",
-  buildArgs: (ctx) => ({
-    clusterType: ctx.str("cluster_type"),
-    responseMode: optionalString(ctx, "response_mode"),
-    conditionSubtype: optionalString(ctx, "condition_subtype")
-  })
-});
-
-// src/commands/te-audience/schema/get-tag-definition-schema.ts
-var getTagDefinitionSchema = createMcpCommand({
-  command: "+get_tag_definition_schema",
-  description: "Get the tag definition schema by type and optional response mode",
-  flags: [
-    { name: "type", type: "string", required: true, desc: "Tag type: condition/metric/first_last/sql" },
-    { name: "response_mode", type: "string", required: false, desc: "Optional response mode: base/examples/full" },
-    { name: "condition_subtype", type: "string", required: false, desc: "Optional subtype when type=condition: core/behavior_seq/all" }
-  ],
-  risk: "read",
-  buildArgs: (ctx) => ({
-    type: ctx.str("type"),
-    responseMode: optionalString(ctx, "response_mode"),
-    conditionSubtype: optionalString(ctx, "condition_subtype")
-  })
-});
-
-// src/commands/te-audience/schema/index.ts
-var commands3 = [
-  getClusterDefinitionSchema,
-  getTagDefinitionSchema
-];
-var schema_default = commands3;
-
-// src/commands/te-audience/index.ts
-var commands4 = [
-  ...cluster_default,
-  ...tag_default,
-  ...schema_default
-];
-var te_audience_default = commands4;
-export {
-  te_audience_default as default
-};