@thinkingai/ae-cli 6.0.18 → 6.0.20

package/dist/te-audience-MYDE5WEH.js

@@ -0,0 +1,590 @@
+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. Query performs fuzzy matching on clusterName, displayName, and remarks. Default returned fields: id, clusterName, displayName, remarks, clusterType, progress, usersNum.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to clusterName, displayName, and remarks.", alias: "q" },
+    { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: id, clusterName, displayName, clusterType, progress, usersNum, refreshStatus, remarks. Default fields when omitted: id, clusterName, displayName, remarks, clusterType, progress, usersNum." },
+    { 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, requestId is required and must be provided before starting. For any query that may exceed the CLI or MCP HTTP timeout, generate requestId first 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. 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. requestId is not auto-generated for MCP query tools because the caller must know it before the response for proactive cleanup. If requestId is omitted or blank, the backend returns REQUEST_ID_REQUIRED; invalid format returns INVALID_REQUEST_ID.",
+  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: true, desc: "Required unique request ID used for tracking and cancellation. Generate it before starting the query. It must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. 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. requestId is not auto-generated for MCP query tools because the caller must know it before the response for proactive cleanup. If omitted or blank, the backend returns REQUEST_ID_REQUIRED; invalid format returns INVALID_REQUEST_ID. The response metadata.requestId echoes the supplied requestId and can also be passed to cancel_query(requestId) 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: ctx.str("request_id"),
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
+  })
+});
+
+// src/commands/te-audience/cluster/build-cluster-definition.ts
+var buildClusterDefinition = createMcpCommand({
+  command: "+build_cluster_definition",
+  description: "Build a cluster definition JSON from structured intent. Call this before create_cluster or update_cluster to generate the definition field. For type=condition, event and property names are resolved from project metadata \u2014 do not guess. For type=sql, pass the SQL string directly. On success, pass the returned definition to create_cluster or update_cluster.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "type", type: "string", required: true, desc: "Cluster type: condition or sql" },
+    { name: "conditions", type: "json", required: false, desc: 'For type=condition: main condition group JSON (required). Example: {"filts":[{"conditionType":"event","eventCondition":{...}}],"relation":"and"}' },
+    { name: "include_filter", type: "json", required: false, desc: "For type=condition: global include condition group JSON (cluster-type conditions only)." },
+    { name: "exclude_filter", type: "json", required: false, desc: "For type=condition: global exclude condition group JSON (cluster-type conditions only)." },
+    { name: "sql", type: "string", required: false, desc: "For type=sql: SQL query returning a single column named #user_id." }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    request: {
+      projectId: ctx.num("project_id"),
+      type: ctx.str("type"),
+      conditions: optionalJson(ctx, "conditions"),
+      includeFilter: optionalJson(ctx, "include_filter"),
+      excludeFilter: optionalJson(ctx, "exclude_filter"),
+      sql: optionalString(ctx, "sql")
+    }
+  })
+});
+
+// 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. Call +build_cluster_definition first to generate this value." },
+    { 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. Call +build_cluster_definition first to generate this value." },
+    { 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/create-id-cluster.ts
+var createIdCluster = createMcpCommand({
+  command: "+create_id_cluster",
+  description: "Create an ID cluster by providing CSV file content as plain text. The CSV should contain a single column of user IDs (no header row required). The operation is asynchronous.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "display_name", type: "string", required: true, desc: "Cluster display name (1-80 characters)" },
+    { name: "file_content", type: "string", required: true, desc: "CSV file content as plain text. No header row, UTF-8 encoding. Each row contains one user ID. Max 100MB." },
+    { name: "entity_id", type: "number", required: true, desc: "Entity ID to associate the cluster with" },
+    { name: "cluster_name", type: "string", required: false, desc: "Optional cluster name (lowercase letters, digits, underscores, starts with a letter, max 80 chars). Auto-generated if omitted." },
+    { name: "remarks", type: "string", required: false, desc: "Optional remarks (max 200 characters)" },
+    { name: "main_column_name", type: "string", required: false, desc: "Optional main column name for ID matching" }
+  ],
+  risk: "write",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    displayName: ctx.str("display_name"),
+    fileContent: ctx.str("file_content"),
+    entityId: ctx.num("entity_id"),
+    clusterName: optionalString(ctx, "cluster_name"),
+    remarks: optionalString(ctx, "remarks"),
+    mainColumnName: optionalString(ctx, "main_column_name")
+  })
+});
+
+// src/commands/te-audience/cluster/update-id-cluster.ts
+var updateIdCluster = createMcpCommand({
+  command: "+update_id_cluster",
+  description: "Update an existing ID cluster by re-uploading CSV file content as plain text. The cluster is identified by cluster_name. The operation is asynchronous.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "cluster_name", type: "string", required: true, desc: "Cluster name to update" },
+    { name: "file_content", type: "string", required: true, desc: "New CSV file content as plain text. No header row, UTF-8 encoding. Each row contains one user ID. Max 100MB." },
+    { name: "display_name", type: "string", required: false, desc: "Optional new display name" },
+    { name: "remarks", type: "string", required: false, desc: "Optional new remarks (max 200 characters)" },
+    { name: "main_column_name", type: "string", required: false, desc: "Optional new main column name for ID matching" }
+  ],
+  risk: "write",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    clusterName: ctx.str("cluster_name"),
+    fileContent: ctx.str("file_content"),
+    displayName: optionalString(ctx, "display_name"),
+    remarks: optionalString(ctx, "remarks"),
+    mainColumnName: optionalString(ctx, "main_column_name")
+  })
+});
+
+// src/commands/te-audience/cluster/delete-cluster.ts
+var deleteCluster = createMcpCommand({
+  command: "+delete_cluster",
+  description: "Delete a cluster by clusterName. If dependencies exist, shows an influence list and requires --confirmed to proceed.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "cluster_name", type: "string", required: true, desc: "Cluster name to delete" },
+    { name: "confirmed", type: "boolean", required: false, desc: "Pass after user explicitly confirms deletion despite listed dependencies" }
+  ],
+  risk: "write",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    clusterName: ctx.str("cluster_name"),
+    confirmed: optionalBoolean(ctx, "confirmed")
+  })
+});
+
+// src/commands/te-audience/cluster/index.ts
+var commands = [
+  listClusters,
+  getClustersByName,
+  listClusterMembers,
+  buildClusterDefinition,
+  createCluster,
+  updateCluster,
+  refreshCluster,
+  createIdCluster,
+  updateIdCluster,
+  deleteCluster
+];
+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. Query performs fuzzy matching on clusterName, displayName, and remarks. Default returned fields: id, clusterName, displayName, remarks, clusterType, subConditionTabType, progress, usersNum.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to clusterName, displayName, and remarks.", alias: "q" },
+    { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: id, clusterName, displayName, clusterType, subConditionTabType, progress, usersNum, remarks. Default fields when omitted: id, clusterName, displayName, remarks, clusterType, subConditionTabType, progress, usersNum." },
+    { 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, requestId is required and must be provided before starting. For any query that may exceed the CLI or MCP HTTP timeout, generate requestId first 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. 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. requestId is not auto-generated for MCP query tools because the caller must know it before the response for proactive cleanup. If requestId is omitted or blank, the backend returns REQUEST_ID_REQUIRED; invalid format returns INVALID_REQUEST_ID.",
+  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: true, desc: "Required unique request ID used for tracking and cancellation. Generate it before starting the query. It must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. 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. requestId is not auto-generated for MCP query tools because the caller must know it before the response for proactive cleanup. If omitted or blank, the backend returns REQUEST_ID_REQUIRED; invalid format returns INVALID_REQUEST_ID. The response metadata.requestId echoes the supplied requestId and can also be passed to cancel_query(requestId) 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: ctx.str("request_id"),
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
+  })
+});
+
+// src/commands/te-audience/tag/build-tag-definition.ts
+var buildTagDefinition = createMcpCommand({
+  command: "+build_tag_definition",
+  description: "Build a tag definition JSON from structured intent. Call this before create_tag or update_tag to generate the definition field. Supported types: condition (multi-value), metric (event metric), first_last (first/last occurrence), sql. For condition/metric/first_last types, event and property names are resolved from project metadata \u2014 do not guess. On success, pass the returned definition to create_tag or update_tag.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "type", type: "string", required: true, desc: "Tag type: condition / metric / first_last / sql" },
+    { name: "condition_values", type: "json", required: false, desc: "For type=condition: list of tag value definitions JSON array. Each item defines a segment label and its conditions." },
+    { name: "metric", type: "json", required: false, desc: "For type=metric: metric definition JSON. Fields: eventName, analysis, quota (property name), recentDay/startTime/endTime." },
+    { name: "first_last", type: "json", required: false, desc: "For type=first_last: first/last occurrence definition JSON. Fields: eventName, firstEvent (true=first occurrence, false=last occurrence), calcPropType, property, recentDay/startTime/endTime." },
+    { name: "sql", type: "string", required: false, desc: "For type=sql: SQL query returning two columns: #user_id and the tag value." }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    request: {
+      projectId: ctx.num("project_id"),
+      type: ctx.str("type"),
+      conditionValues: optionalJson(ctx, "condition_values"),
+      metric: optionalJson(ctx, "metric"),
+      firstLast: optionalJson(ctx, "first_last"),
+      sql: optionalString(ctx, "sql")
+    }
+  })
+});
+
+// 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. Call +build_tag_definition first to generate this value." },
+    { 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. Call +build_tag_definition first to generate this value." },
+    { 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/create-id-tag.ts
+var createIdTag = createMcpCommand({
+  command: "+create_id_tag",
+  description: "Create an ID tag by providing CSV file content as plain text. The CSV should contain two columns: user ID and tag value. The operation is asynchronous.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "display_name", type: "string", required: true, desc: "Tag display name (1-80 characters)" },
+    { name: "file_content", type: "string", required: true, desc: "CSV file content as plain text. No header row, UTF-8 encoding. Column 1: user ID. Column 2: tag value (optional). Example row: user_001,gold_member. Max 100MB." },
+    { name: "entity_id", type: "number", required: true, desc: "Entity ID to associate the tag with" },
+    { name: "tag_name", type: "string", required: false, desc: "Optional tag name (letters/digits/underscores, starts with a letter, max 80 chars). Auto-generated if omitted." },
+    { name: "remarks", type: "string", required: false, desc: "Optional remarks (max 200 characters)" },
+    { name: "main_column_name", type: "string", required: false, desc: "Optional main column name for ID matching" }
+  ],
+  risk: "write",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    displayName: ctx.str("display_name"),
+    fileContent: ctx.str("file_content"),
+    entityId: ctx.num("entity_id"),
+    tagName: optionalString(ctx, "tag_name"),
+    remarks: optionalString(ctx, "remarks"),
+    mainColumnName: optionalString(ctx, "main_column_name")
+  })
+});
+
+// src/commands/te-audience/tag/update-id-tag.ts
+var updateIdTag = createMcpCommand({
+  command: "+update_id_tag",
+  description: "Update an existing ID tag by re-uploading CSV file content as plain text. The tag is identified by tag_name. The operation is asynchronous.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "tag_name", type: "string", required: true, desc: "Tag name to update" },
+    { name: "file_content", type: "string", required: true, desc: "New CSV file content as plain text. No header row, UTF-8 encoding. Column 1: user ID. Column 2: tag value (optional). Example row: user_001,gold_member. Max 100MB." },
+    { name: "display_name", type: "string", required: false, desc: "Optional new display name" },
+    { name: "remarks", type: "string", required: false, desc: "Optional new remarks (max 200 characters)" },
+    { name: "entity_id", type: "number", required: false, desc: "Entity ID to associate the tag with" },
+    { name: "main_column_name", type: "string", required: false, desc: "Optional new main column name for ID matching" }
+  ],
+  risk: "write",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    tagName: ctx.str("tag_name"),
+    fileContent: ctx.str("file_content"),
+    displayName: optionalString(ctx, "display_name"),
+    remarks: optionalString(ctx, "remarks"),
+    entityId: optionalNumber(ctx, "entity_id"),
+    mainColumnName: optionalString(ctx, "main_column_name")
+  })
+});
+
+// src/commands/te-audience/tag/delete-tag.ts
+var deleteTag = createMcpCommand({
+  command: "+delete_tag",
+  description: "Delete a tag by tagName. If dependencies exist, shows an influence list and requires --confirmed to proceed.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "tag_name", type: "string", required: true, desc: "Tag name to delete" },
+    { name: "confirmed", type: "boolean", required: false, desc: "Pass after user explicitly confirms deletion despite listed dependencies" }
+  ],
+  risk: "write",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    tagName: ctx.str("tag_name"),
+    confirmed: optionalBoolean(ctx, "confirmed")
+  })
+});
+
+// src/commands/te-audience/tag/index.ts
+var commands2 = [
+  listTags,
+  getTagsByName,
+  listTagMembers,
+  buildTagDefinition,
+  createTag,
+  updateTag,
+  refreshTag,
+  createIdTag,
+  updateIdTag,
+  deleteTag
+];
+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
+};