@wave-ai-os/wave-cli 0.1.67 → 0.1.70

package/dist/index.js

@@ -14778,6 +14778,33 @@ var idSchema14 = z19.string().trim().min(1);
 var idempotencyKeySchema = z19.string().min(1).refine((value) => value.trim() === value, "Idempotency key must not have leading or trailing whitespace.");
 var skillScopeSchema = z19.enum(["ADMIN_GLOBAL", "MEMBER_PERSONAL"]);
 var isoDateSchema = z19.iso.date();
+var nonEmptyStringSchema = z19.string().trim().min(1);
+var agentToolAccessSchema = z19.array(
+  z19.object({
+    tool_key: nonEmptyStringSchema,
+    scope_value: nonEmptyStringSchema
+  }).strict()
+).min(1);
+var agentPluginConnectionsSchema = z19.array(
+  z19.object({
+    external_tool_connection_id: nonEmptyStringSchema,
+    tool_key: nonEmptyStringSchema,
+    scope_value: nonEmptyStringSchema.optional(),
+    allowed_tools: z19.array(nonEmptyStringSchema).optional(),
+    allowed_scopes: z19.array(nonEmptyStringSchema).optional(),
+    requires_confirmation: z19.boolean().optional(),
+    enabled: z19.boolean().optional()
+  }).strict()
+).min(1);
+var agentTriggerSchema = z19.object({
+  trigger_type: z19.literal("cron"),
+  cron_expression: nonEmptyStringSchema,
+  timezone: nonEmptyStringSchema,
+  starts_at: z19.iso.datetime({ offset: true }).nullable().optional(),
+  ends_at: z19.iso.datetime({ offset: true }).nullable().optional(),
+  max_runs: z19.number().int().positive().nullable().optional(),
+  enabled: z19.boolean().optional()
+}).strict();
 var AGENT_SELECTION = `{
   id
   type
@@ -14790,11 +14817,51 @@ var AGENT_SELECTION = `{
   model
   runWhenMentioned
   webAccessEnabled
+  trustedUrls
+  toolAccess
+  agentToolConnections {
+    id
+    type
+    attributes {
+      agentId
+      externalToolConnectionId
+      toolKey
+      scopeValue
+      allowedTools
+      allowedScopes
+      requiresConfirmation
+      enabled
+      provider
+      service
+    }
+  }
+  triggers {
+    id
+    triggerType
+    cronExpression
+    timezone
+    startsAt
+    endsAt
+    maxRuns
+    enabled
+    nextOccurrenceAt
+  }
   organizationId
   memberId
   createdAt
   updatedAt
 }`;
+var AGENT_PLUGIN_CATALOG_SELECTION = `{
+  externalToolConnectionId
+  provider
+  service
+  toolKey
+  displayName
+  requiredScopes
+  defaultConfirmationPolicy
+  connectionState
+  status
+}`;
 var AUTOMATION_SELECTION = `{
   id
   type
@@ -14855,6 +14922,10 @@ function parseJson(value, optionName) {
     });
   }
 }
+function parseJsonOption(value, optionName, schema) {
+  if (value === void 0) return void 0;
+  return schema.parse(parseJson(String(value), optionName));
+}
 function normalizePersistedCreatePayload(payload) {
   const mutation = asRecord8(payload);
   const mutationData = asRecord8(mutation?.data);
@@ -14892,11 +14963,25 @@ function normalizePersistedCreatePayload(payload) {
 }
 function registerAtlasAuthoringCommands(program) {
   const agents = program.command("agents").description("Bounded Agent authoring operations");
-  agents.command("create").description("Create an Agent through the API-owned createAgent contract").requiredOption("--idempotency-key <key>", "Required create idempotency key").option("--name <name>").option("--description <description>").option("--notes <notes>").option("--member-id <memberId>").option("--status <status>").option("--visibility <visibility>").option("--model <model>").option("--run-when-mentioned <boolean>", "true or false").option("--web-access-enabled <boolean>", "true or false").option("--trusted-urls <urls>", "Comma-separated trusted URLs").action(async (opts, cmd) => {
+  agents.command("create").description("Create an Agent through the API-owned createAgent contract").requiredOption("--idempotency-key <key>", "Required create idempotency key").option("--name <name>").option("--description <description>").option("--notes <notes>").option("--member-id <memberId>").option("--status <status>").option("--visibility <visibility>").option("--model <model>").option("--run-when-mentioned <boolean>", "true or false").option("--web-access-enabled <boolean>", "true or false").option("--trusted-urls <urls>", "Comma-separated trusted URLs").option("--tool-access <json>", "JSON array of canonical native Agent tool scopes").option(
+    "--plugin-connections <json>",
+    "JSON array of persisted Agent connector grants"
+  ).option("--trigger <json>", "Canonical cron Agent trigger JSON").action(async (opts, cmd) => {
     const idempotencyKey = idempotencyKeySchema.parse(opts.idempotencyKey);
     const runWhenMentioned = parseBooleanOption(opts.runWhenMentioned, "--run-when-mentioned");
     const webAccessEnabled = parseBooleanOption(opts.webAccessEnabled, "--web-access-enabled");
     const trustedUrls = parseCommaSeparatedStrings(opts.trustedUrls);
+    const toolAccess = parseJsonOption(
+      opts.toolAccess,
+      "--tool-access",
+      agentToolAccessSchema
+    );
+    const pluginConnections = parseJsonOption(
+      opts.pluginConnections,
+      "--plugin-connections",
+      agentPluginConnectionsSchema
+    );
+    const trigger = parseJsonOption(opts.trigger, "--trigger", agentTriggerSchema);
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     await runGraphqlMutationCommand({
@@ -14922,7 +15007,10 @@ function registerAtlasAuthoringCommands(program) {
             ...opts.model !== void 0 ? { model: String(opts.model) } : {},
             ...runWhenMentioned !== void 0 ? { run_when_mentioned: runWhenMentioned } : {},
             ...webAccessEnabled !== void 0 ? { web_access_enabled: webAccessEnabled } : {},
-            ...trustedUrls !== void 0 ? { trusted_urls: trustedUrls } : {}
+            ...trustedUrls !== void 0 ? { trusted_urls: trustedUrls } : {},
+            ...toolAccess !== void 0 ? { tool_access: toolAccess } : {},
+            ...pluginConnections !== void 0 ? { agent_tool_connections_attributes: pluginConnections } : {},
+            ...trigger !== void 0 ? { trigger_attributes: trigger } : {}
           }
         },
         idempotency_key: idempotencyKey
@@ -14945,6 +15033,23 @@ function registerAtlasAuthoringCommands(program) {
       isShow: true
     });
   });
+  agents.command("plugin-catalog").description("Read connected Agent plugin capabilities for one supported service").requiredOption(
+    "--service <service>",
+    "Supported service: gmail, calendar, slack, or stripe"
+  ).action(async (opts, cmd) => {
+    const service = z19.enum(["gmail", "calendar", "slack", "stripe"]).parse(opts.service);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlQueryCommand({
+      command: "agents.plugin-catalog",
+      operationName: "AgentsPluginCatalog",
+      runtimeOptions: context.runtimeOptions,
+      field: "external_tool_catalog",
+      variables: { organization_id: organizationId, service },
+      variableTypes: { organization_id: "ID!", service: "String!" },
+      selectionSet: AGENT_PLUGIN_CATALOG_SELECTION
+    });
+  });
   const automations = program.command("automations").description("Bounded Automation authoring operations");
   automations.command("create").description("Create an Automation through the API-owned createAutomation contract").requiredOption("--summary <summary>").requiredOption("--ai-task-config <json>", "Valid JSON for the API-owned ai_task_config field").requiredOption("--idempotency-key <key>", "Required create idempotency key").option("--description <description>").option("--notes <notes>").option("--member-id <memberId>").option("--agent-id <agentId>", "Optional executor Agent id for a repeat Automation").option("--status <status>").option("--priority <priority>").option("--due-date <date>", "ISO-8601 date (YYYY-MM-DD)").action(async (opts, cmd) => {
     const idempotencyKey = idempotencyKeySchema.parse(opts.idempotencyKey);
@@ -15029,6 +15134,650 @@ function registerAtlasAuthoringCommands(program) {
 // src/commands/discovery.ts
 import { existsSync as existsSync3, readFileSync } from "fs";
 import { join as join3 } from "path";
+
+// src/operationManifest.ts
+import { createHash } from "crypto";
+
+// src/version.ts
+var CLI_VERSION = "0.1.70";
+
+// src/operationMetadata.ts
+var DISCOVERY_OPERATION_IDS = [
+  "accountability.examples",
+  "accountability.schema",
+  "agents.examples",
+  "agents.schema",
+  "api.examples",
+  "api.ls",
+  "api.schema",
+  "auth.examples",
+  "auth.schema",
+  "automations.examples",
+  "automations.schema",
+  "broadcast.examples",
+  "broadcast.schema",
+  "capabilities.examples",
+  "capabilities.list",
+  "capabilities.schema",
+  "capabilities.tools",
+  "contacts.examples",
+  "contacts.schema",
+  "content.examples",
+  "content.schema",
+  "customers.examples",
+  "customers.schema",
+  "datasheets.examples",
+  "datasheets.schema",
+  "doctor",
+  "doctor.examples",
+  "doctor.schema",
+  "feedbacks.examples",
+  "feedbacks.schema",
+  "foundation.examples",
+  "foundation.schema",
+  "issue-groups.examples",
+  "issue-groups.schema",
+  "issues.examples",
+  "issues.schema",
+  "knowledge.examples",
+  "knowledge.schema",
+  "kpis.examples",
+  "kpis.schema",
+  "list-items.examples",
+  "list-items.schema",
+  "lists.examples",
+  "lists.schema",
+  "mail.examples",
+  "mail.schema",
+  "markdown-tree.examples",
+  "markdown-tree.schema",
+  "meetings.examples",
+  "meetings.schema",
+  "members.examples",
+  "members.schema",
+  "milestones.examples",
+  "milestones.schema",
+  "news.examples",
+  "news.schema",
+  "organizations.examples",
+  "organizations.schema",
+  "osmd.examples",
+  "osmd.schema",
+  "planner.examples",
+  "planner.schema",
+  "project-content.examples",
+  "project-content.schema",
+  "projects.examples",
+  "projects.schema",
+  "pulse.examples",
+  "pulse.schema",
+  "questions.examples",
+  "questions.schema",
+  "recognition.examples",
+  "recognition.schema",
+  "rock-collections.examples",
+  "rock-collections.schema",
+  "rocks.examples",
+  "rocks.schema",
+  "scorecard-groups.examples",
+  "scorecard-groups.schema",
+  "scorecards.examples",
+  "scorecards.schema",
+  "skills.examples",
+  "skills.schema",
+  "stand-ups.examples",
+  "stand-ups.schema",
+  "subissues.examples",
+  "subissues.schema",
+  "subitems.examples",
+  "subitems.schema",
+  "subtasks.examples",
+  "subtasks.schema",
+  "subtodos.examples",
+  "subtodos.schema",
+  "support.examples",
+  "support.schema",
+  "surveys.examples",
+  "surveys.schema",
+  "talking-points.examples",
+  "talking-points.schema",
+  "tasks.examples",
+  "tasks.schema",
+  "teams.examples",
+  "teams.schema",
+  "time-tracking.examples",
+  "time-tracking.schema",
+  "todo-groups.examples",
+  "todo-groups.schema",
+  "todos.examples",
+  "todos.schema",
+  "whiteboards.examples",
+  "whiteboards.schema"
+];
+var READ_OPERATION_IDS = [
+  "accountability.list",
+  "accountability.search",
+  "accountability.show",
+  "agents.plugin-catalog",
+  "agents.show",
+  "auth.status",
+  "automations.show",
+  "broadcast.community",
+  "broadcast.list",
+  "broadcast.open",
+  "broadcast.workspace",
+  "cat",
+  "contacts.list",
+  "contacts.search",
+  "contacts.show",
+  "content.list",
+  "content.show",
+  "customers.list",
+  "customers.search",
+  "customers.show",
+  "datasheets.list",
+  "datasheets.open",
+  "datasheets.show",
+  "feedbacks.list",
+  "feedbacks.search",
+  "feedbacks.show",
+  "find",
+  "foundation.annual-objectives.list",
+  "foundation.annual-objectives.search",
+  "foundation.annual-objectives.show",
+  "foundation.quarterly-objectives.list",
+  "foundation.quarterly-objectives.search",
+  "foundation.quarterly-objectives.show",
+  "foundation.strategic-objectives.show",
+  "foundation.strategic-plans.show",
+  "issue-groups.list",
+  "issue-groups.search",
+  "issue-groups.show",
+  "issues.list",
+  "issues.search",
+  "issues.show",
+  "knowledge.list",
+  "knowledge.search",
+  "knowledge.show",
+  "kpis.list",
+  "kpis.search",
+  "kpis.show",
+  "list-items.list",
+  "list-items.search",
+  "list-items.show",
+  "lists.list",
+  "lists.search",
+  "lists.show",
+  "ls",
+  "mail.accounts",
+  "mail.conversation",
+  "mail.conversations",
+  "mail.labels",
+  "mail.message",
+  "mail.messages",
+  "mail.open",
+  "mail.settings",
+  "mail.snippets",
+  "mail.sync-status",
+  "mail.unread-count",
+  "mail.validate-provider",
+  "mail.workspace",
+  "markdown-tree.children",
+  "markdown-tree.resolve",
+  "markdown-tree.root",
+  "markdown-tree.subtree",
+  "meetings.list",
+  "meetings.search",
+  "meetings.show",
+  "members.list",
+  "members.meta-profile",
+  "members.search",
+  "members.show",
+  "milestones.list",
+  "milestones.search",
+  "news.list",
+  "news.search",
+  "news.show",
+  "open",
+  "organizations.key-metric-meta-profile.show",
+  "organizations.meta-profile.show",
+  "organizations.show",
+  "osmd.agent.children",
+  "osmd.agent.read",
+  "osmd.agent.status",
+  "osmd.children",
+  "osmd.lint",
+  "osmd.memory-quality",
+  "osmd.read",
+  "osmd.search",
+  "osmd.status",
+  "osmd.tree",
+  "osmd.wiki.read",
+  "osmd.wiki.status",
+  "phantom.apply-operation",
+  "phantom.apply-operations",
+  "phantom.candidate",
+  "phantom.candidates",
+  "phantom.evidence",
+  "phantom.evidences",
+  "phantom.inventory",
+  "phantom.observation",
+  "phantom.observations",
+  "phantom.report",
+  "phantom.validation",
+  "phantom.validations",
+  "planner.booking-links",
+  "planner.events",
+  "planner.open",
+  "planner.preferences",
+  "planner.public-booking-link",
+  "planner.state",
+  "projects.list",
+  "projects.search",
+  "projects.show",
+  "pulse.list",
+  "pulse.search",
+  "pulse.show",
+  "questions.list",
+  "questions.search",
+  "questions.show",
+  "recognition.list",
+  "recognition.open",
+  "recognition.point-balance",
+  "recognition.show",
+  "recognition.top-value",
+  "rock-collections.list",
+  "rock-collections.search",
+  "rock-collections.show",
+  "rocks.list",
+  "rocks.search",
+  "rocks.show",
+  "scorecard-groups.list",
+  "scorecard-groups.search",
+  "scorecard-groups.show",
+  "scorecards.list",
+  "scorecards.search",
+  "scorecards.show",
+  "skills.list",
+  "skills.show",
+  "stand-ups.list",
+  "stand-ups.search",
+  "stand-ups.show",
+  "subissues.list",
+  "subissues.search",
+  "subitems.list",
+  "subitems.search",
+  "subtasks.list",
+  "subtasks.search",
+  "subtodos.list",
+  "subtodos.search",
+  "support.counts",
+  "support.inbox",
+  "support.knowledge-articles",
+  "support.knowledge-collections",
+  "support.labels",
+  "support.open",
+  "support.settings",
+  "support.ticket-counts",
+  "support.tickets",
+  "surveys.list",
+  "surveys.search",
+  "surveys.show",
+  "talking-points.list",
+  "talking-points.search",
+  "tasks.list",
+  "tasks.search",
+  "tasks.show",
+  "teams.list",
+  "teams.show",
+  "time-tracking.entries",
+  "time-tracking.open",
+  "time-tracking.projects",
+  "time-tracking.report",
+  "time-tracking.show",
+  "time-tracking.timer",
+  "time-tracking.timesheet",
+  "todo-groups.list",
+  "todo-groups.search",
+  "todo-groups.show",
+  "todos.list",
+  "todos.search",
+  "todos.show",
+  "tree",
+  "whiteboards.list",
+  "whiteboards.open",
+  "whiteboards.show"
+];
+var WRITE_OPERATION_IDS = [
+  "accountability.create",
+  "accountability.update",
+  "agents.create",
+  "automations.create",
+  "contacts.create",
+  "contacts.update",
+  "content.create-contact",
+  "content.create-customer",
+  "content.create-manager",
+  "content.create-member",
+  "content.create-project",
+  "content.create-team",
+  "content.destroy",
+  "content.update",
+  "customers.create",
+  "customers.update",
+  "datasheets.archive",
+  "datasheets.cell.upsert",
+  "datasheets.column.archive",
+  "datasheets.column.create",
+  "datasheets.column.delete",
+  "datasheets.column.reorder",
+  "datasheets.column.update",
+  "datasheets.create",
+  "datasheets.export.create",
+  "datasheets.favorite",
+  "datasheets.form.archive",
+  "datasheets.form.close",
+  "datasheets.form.create",
+  "datasheets.form.delete",
+  "datasheets.form.publish",
+  "datasheets.form.submit",
+  "datasheets.form.update",
+  "datasheets.import.commit",
+  "datasheets.row.archive",
+  "datasheets.row.create",
+  "datasheets.row.delete",
+  "datasheets.row.reorder",
+  "datasheets.row.update",
+  "datasheets.update",
+  "datasheets.view.archive",
+  "datasheets.view.create",
+  "datasheets.view.delete",
+  "datasheets.view.reorder",
+  "datasheets.view.update",
+  "feedbacks.create",
+  "feedbacks.update",
+  "foundation.annual-objectives.create",
+  "foundation.annual-objectives.update",
+  "foundation.quarterly-objectives.create",
+  "foundation.quarterly-objectives.update",
+  "foundation.strategic-objectives.update",
+  "foundation.strategic-plans.update",
+  "issue-groups.create",
+  "issue-groups.update",
+  "issues.create",
+  "issues.update",
+  "knowledge.create",
+  "knowledge.update",
+  "kpis.create",
+  "kpis.update",
+  "list-items.create",
+  "list-items.update",
+  "lists.create",
+  "lists.update",
+  "meetings.create",
+  "meetings.notes",
+  "meetings.update",
+  "members.create",
+  "members.update",
+  "milestones.create",
+  "milestones.destroy",
+  "milestones.update",
+  "news.create",
+  "news.update",
+  "organizations.key-metric-meta-profile.update",
+  "organizations.meta-profile.update",
+  "organizations.update",
+  "osmd.agent.create",
+  "osmd.agent.init",
+  "osmd.agent.update",
+  "osmd.ingest.file",
+  "osmd.ingest.text",
+  "osmd.ingest.transcript",
+  "osmd.ingest.url",
+  "osmd.phantom.run",
+  "osmd.wiki.append-log",
+  "osmd.wiki.create",
+  "osmd.wiki.index-upsert",
+  "osmd.wiki.update",
+  "project-content.create",
+  "project-content.destroy",
+  "project-content.update",
+  "projects.create",
+  "projects.update",
+  "pulse.create",
+  "pulse.update",
+  "questions.create",
+  "questions.update",
+  "rock-collections.create",
+  "rock-collections.update",
+  "rocks.create",
+  "rocks.update",
+  "rocks.update-status",
+  "scorecard-groups.create",
+  "scorecard-groups.update",
+  "scorecards.create",
+  "scorecards.update",
+  "skills.create",
+  "smart-kpi-views.create",
+  "stand-ups.create",
+  "stand-ups.update",
+  "subissues.create",
+  "subissues.destroy",
+  "subissues.update",
+  "subitems.create",
+  "subitems.destroy",
+  "subitems.update",
+  "subtasks.create",
+  "subtasks.destroy",
+  "subtasks.update",
+  "subtodos.create",
+  "subtodos.destroy",
+  "subtodos.update",
+  "surveys.create",
+  "surveys.update",
+  "talking-points.create",
+  "talking-points.destroy",
+  "talking-points.update",
+  "tasks.create",
+  "tasks.destroy",
+  "tasks.update",
+  "teams.create",
+  "teams.update",
+  "todo-groups.create",
+  "todo-groups.update",
+  "todos.create",
+  "todos.update"
+];
+var AUTH_OPERATION_IDS = ["login", "logout"];
+var DESTRUCTIVE_OPERATION_IDS = /* @__PURE__ */ new Set([
+  "content.destroy",
+  "datasheets.archive",
+  "datasheets.column.archive",
+  "datasheets.column.delete",
+  "datasheets.form.archive",
+  "datasheets.form.close",
+  "datasheets.form.delete",
+  "datasheets.form.publish",
+  "datasheets.form.submit",
+  "datasheets.import.commit",
+  "datasheets.row.archive",
+  "datasheets.row.delete",
+  "datasheets.view.archive",
+  "datasheets.view.delete",
+  "milestones.destroy",
+  "project-content.destroy",
+  "subissues.destroy",
+  "subitems.destroy",
+  "subtasks.destroy",
+  "subtodos.destroy",
+  "talking-points.destroy",
+  "tasks.destroy"
+]);
+var OPERATION_IDS_BY_CLASSIFICATION = {
+  discovery: DISCOVERY_OPERATION_IDS,
+  read: READ_OPERATION_IDS,
+  write: WRITE_OPERATION_IDS,
+  auth: AUTH_OPERATION_IDS
+};
+var metadataByOperationId = /* @__PURE__ */ new Map();
+for (const [classification, operationIds] of Object.entries(OPERATION_IDS_BY_CLASSIFICATION)) {
+  for (const id of operationIds) {
+    if (metadataByOperationId.has(id)) {
+      throw new Error(`Duplicate Wave CLI operation metadata: ${id}`);
+    }
+    const atlasSafetyClass = classification === "discovery" ? "discovery" : classification === "read" ? "read_only" : classification === "auth" ? "auth" : DESTRUCTIVE_OPERATION_IDS.has(id) ? "destructive" : "mutation";
+    if (DESTRUCTIVE_OPERATION_IDS.has(id) && classification !== "write") {
+      throw new Error(`Destructive Wave CLI operation must be a write: ${id}`);
+    }
+    metadataByOperationId.set(id, {
+      classification,
+      requiresApproval: classification === "write",
+      atlasSafetyClass,
+      machine: {
+        supportsValidate: true,
+        supportsPreview: classification === "write",
+        supportsExecute: true,
+        executionMode: "sync"
+      }
+    });
+  }
+}
+function registeredOperationMetadata(id) {
+  return metadataByOperationId.get(id);
+}
+
+// src/operationManifest.ts
+var MACHINE_PRESENTATION_OPTIONS = /* @__PURE__ */ new Set(["json", "readable"]);
+function hasAction(command) {
+  return Boolean(command._actionHandler);
+}
+function commandPath(command) {
+  const path = [];
+  let current = command;
+  while (current) {
+    const name = current.name();
+    if (name) path.unshift(name);
+    current = current.parent ?? null;
+  }
+  return path;
+}
+function operationId(path) {
+  return path.slice(1).join(".");
+}
+function inputKeyForArgument(argument) {
+  return argument.name().replace(/<|>|\[|\]|\.\.\./g, "");
+}
+function inputSchemaFor(command) {
+  const properties = {};
+  const required = [];
+  for (const argument of command.registeredArguments) {
+    const key = inputKeyForArgument(argument);
+    properties[key] = {
+      type: argument.variadic ? "array" : "string",
+      ...argument.description ? { description: argument.description } : {}
+    };
+    if (argument.required) required.push(key);
+  }
+  for (const option of command.options) {
+    const key = option.attributeName();
+    if (MACHINE_PRESENTATION_OPTIONS.has(key)) continue;
+    properties[key] = {
+      type: option.required ? "string" : option.optional ? ["boolean", "string"] : "boolean",
+      ...option.description ? { description: option.description } : {}
+    };
+    if (option.mandatory) required.push(key);
+  }
+  return {
+    type: "object",
+    additionalProperties: false,
+    properties,
+    required: required.sort()
+  };
+}
+function exampleFor(inputSchema) {
+  const input = {};
+  for (const key of inputSchema.required) {
+    const propertyType = inputSchema.properties[key]?.type;
+    const types = Array.isArray(propertyType) ? propertyType : [propertyType];
+    input[key] = types.includes("array") ? ["example"] : types.includes("boolean") ? true : "example";
+  }
+  return [{ name: "minimal valid input", input }];
+}
+function outputSchema() {
+  return {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      ok: { type: "boolean" },
+      command: { type: "string" },
+      status: { type: "number" },
+      data: { type: ["object", "array", "string", "number", "boolean", "null"] },
+      error: { type: ["object", "null"] },
+      meta: { type: "object" }
+    },
+    required: ["ok", "command", "status", "data", "error", "meta"]
+  };
+}
+function listInvocableCommands(program) {
+  const result = [];
+  const visit = (command) => {
+    if (command.name() !== "help" && hasAction(command)) result.push(command);
+    for (const child of command.commands) visit(child);
+  };
+  for (const command of program.commands) visit(command);
+  return result;
+}
+function entryFor(command, metadata) {
+  const path = commandPath(command);
+  const inputSchema = inputSchemaFor(command);
+  const summary = command.description() || `Run ${path.join(" ")}.`;
+  return {
+    id: operationId(path),
+    path,
+    command: path.join(" "),
+    summary,
+    description: summary,
+    classification: metadata.classification,
+    requiresApproval: metadata.requiresApproval,
+    atlasSafetyClass: metadata.atlasSafetyClass,
+    inputSchema,
+    outputSchema: outputSchema(),
+    examples: exampleFor(inputSchema),
+    machine: metadata.machine
+  };
+}
+function digestFor(operations) {
+  const canonical = JSON.stringify(operations);
+  return `sha256:${createHash("sha256").update(canonical).digest("hex")}`;
+}
+function buildOperationManifest(program) {
+  const operations = listInvocableCommands(program).map((command) => {
+    const path = commandPath(command);
+    const id = operationId(path);
+    const metadata = registeredOperationMetadata(id);
+    if (!metadata) {
+      throw new Error(`Missing explicit Wave CLI operation metadata: ${id}`);
+    }
+    return entryFor(command, metadata);
+  }).sort((left, right) => left.id.localeCompare(right.id));
+  const seen = /* @__PURE__ */ new Set();
+  for (const operation of operations) {
+    if (seen.has(operation.id)) {
+      throw new Error(`Duplicate Wave CLI operation id: ${operation.id}`);
+    }
+    seen.add(operation.id);
+  }
+  return {
+    manifestVersion: "1",
+    cli: { package: "@wave-ai-os/wave-cli", version: CLI_VERSION },
+    registryDigest: digestFor(operations),
+    operationCount: operations.length,
+    operations
+  };
+}
+
+// src/commands/discovery.ts
 var PRIMARY_NAMESPACES = [
   "osmd",
   "broadcast",
@@ -15185,6 +15934,7 @@ var NAMESPACE_DOCS = {
     description: "Bounded Agent create and persisted readback operations.",
     examples: [
       'wave agents create --name "Planning helper" --idempotency-key agent-create-001',
+      `wave agents create --name "Project summary" --notes "Summarize my projects." --tool-access '[{"tool_key":"projects","scope_value":"all"}]' --trigger '{"trigger_type":"cron","cron_expression":"0 14 * * 2","timezone":"America/Phoenix","enabled":true}' --idempotency-key agent-create-002`,
       "wave agents show --id 123"
     ],
     schema: {
@@ -15193,6 +15943,8 @@ var NAMESPACE_DOCS = {
       safety: [
         "Create calls only createAgent with an explicit idempotency key.",
         "Create preserves API-owned defaults by sending only supplied typed Agent fields.",
+        "Native tools, plugin connector grants, and the cron trigger use strict canonical JSON shapes.",
+        "Outlook Calendar and Outlook Mail are not supported Agent plugin families in this release.",
         "Show uses the API-owned agent query by id; no slug fallback is implemented."
       ],
       commands: ["create", "show"]
@@ -15637,13 +16389,6 @@ function readableToolSupport(key) {
     ].join("\n");
   }).join("\n\n");
 }
-function commandPaths(command, prefix = command.name()) {
-  const children = command.commands.filter((child) => !child.name().startsWith("help"));
-  if (children.length === 0) {
-    return [prefix];
-  }
-  return children.flatMap((child) => commandPaths(child, `${prefix} ${child.name()}`));
-}
 function commandSummary(command) {
   return {
     name: command.name(),
@@ -15888,12 +16633,16 @@ function registerDiscoveryCommands(program) {
   });
   const api = program.command("api").description("Discover Wave API-backed CLI operations");
   api.command("ls").description("List scriptable command paths").option("--readable", "Print command paths as plain lines").option("--json", "Emit the stable JSON envelope").action((opts) => {
-    const paths = commandPaths(program).filter((path) => path !== "wave");
+    const manifest = buildOperationManifest(program);
+    const paths = manifest.operations.map((operation) => operation.command);
     if (opts.readable && !opts.json) {
       return printTextAndExit({ text: paths.join("\n") });
     }
     return printEnvelopeAndExit({
       envelope: buildEnvelope2("api.ls", {
+        ...manifest,
+        // Retained as a derived compatibility projection for existing CLI
+        // callers. The manifest above is the sole inventory source.
         commands: paths,
         examples: ["wave api ls --json"]
       })
@@ -15990,9 +16739,6 @@ function attachDiscoveryHelp(program) {
   }
 }
 
-// src/version.ts
-var CLI_VERSION = "0.1.67";
-
 // src/cli.ts
 function buildCli(options) {
   const program = new Command();
@@ -16074,6 +16820,371 @@ function buildCli(options) {
   return program;
 }
 
+// src/machine.ts
+import { createHash as createHash2 } from "crypto";
+var MACHINE_FLAGS = /* @__PURE__ */ new Set([
+  "--machine",
+  "--operation",
+  "--phase",
+  "--input-json"
+]);
+function machineEnvelope(params) {
+  return {
+    ok: params.ok,
+    command: params.command,
+    status: params.status,
+    data: params.data ?? null,
+    error: params.error ?? null,
+    meta: { requestId: "machine" }
+  };
+}
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function hasAction2(command) {
+  return Boolean(command._actionHandler);
+}
+function commandId(command) {
+  const path = [];
+  let current = command;
+  while (current) {
+    if (current.name()) path.unshift(current.name());
+    current = current.parent;
+  }
+  return path.slice(1).join(".");
+}
+function parseMachineArgs(argv) {
+  const values = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const flag = argv[index];
+    if (!MACHINE_FLAGS.has(flag)) {
+      return { error: `Unsupported machine flag: ${flag}` };
+    }
+    const value = argv[index + 1];
+    if (!value || value.startsWith("--")) {
+      return { error: `Missing value for ${flag}` };
+    }
+    if (flag in values) return { error: `Machine flag may be supplied only once: ${flag}` };
+    values[flag] = value;
+    index += 1;
+  }
+  if (values["--machine"] !== "execute") {
+    return { error: '--machine must be "execute".' };
+  }
+  return {
+    operation: values["--operation"],
+    phase: values["--phase"],
+    inputJson: values["--input-json"]
+  };
+}
+async function readMachineInput(location) {
+  if (location !== "-") {
+    throw new Error('Machine input must be supplied with "--input-json -".');
+  }
+  let raw = "";
+  process.stdin.setEncoding("utf8");
+  for await (const chunk of process.stdin) raw += chunk;
+  if (!raw.trim()) throw new Error("Machine input JSON is required.");
+  const parsed = JSON.parse(raw);
+  if (!isPlainObject(parsed)) throw new Error("Machine input must be a JSON object.");
+  return parsed;
+}
+function inputDigest(input) {
+  return `sha256:${createHash2("sha256").update(canonicalJson(input)).digest("hex")}`;
+}
+function canonicalJson(value) {
+  if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
+  if (isPlainObject(value)) {
+    return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key])}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+function normalizeInput(input) {
+  return Object.fromEntries(
+    Object.keys(input).sort().map((key) => [key, input[key]])
+  );
+}
+function parseTrustedJson(name, predicate) {
+  const raw = process.env[name];
+  if (!raw) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    return predicate(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function isTrustedAuth(value) {
+  return isPlainObject(value) && typeof value.token === "string" && value.token.trim() !== "" && typeof value.baseUrl === "string" && value.baseUrl.trim() !== "" && typeof value.organizationId === "string" && value.organizationId.trim() !== "" && typeof value.actorId === "string" && value.actorId.trim() !== "";
+}
+function isTrustedApproval(value) {
+  return isPlainObject(value) && typeof value.operation === "string" && typeof value.inputDigest === "string" && typeof value.cliVersion === "string" && typeof value.registryDigest === "string" && typeof value.organizationId === "string" && value.organizationId.trim() !== "" && typeof value.actorId === "string" && value.actorId.trim() !== "";
+}
+function operationCommand(program, id) {
+  return listInvocableCommands(program).find((command) => commandId(command) === id);
+}
+function typeMatches(value, type) {
+  if (type === "array") return Array.isArray(value);
+  if (type === "null") return value === null;
+  if (type === "object") return isPlainObject(value);
+  return typeof value === type;
+}
+function validateInput(operation, input) {
+  const allowed = new Set(Object.keys(operation.inputSchema.properties));
+  const unknown = Object.keys(input).filter((key) => !allowed.has(key));
+  const missing = operation.inputSchema.required.filter(
+    (key) => input[key] === void 0 || input[key] === null || input[key] === ""
+  );
+  const typeErrors = Object.entries(input).flatMap(([key, value]) => {
+    const property = operation.inputSchema.properties[key];
+    if (!property) return [];
+    const types = Array.isArray(property.type) ? property.type : [property.type];
+    return types.some((type) => typeMatches(value, type)) ? [] : [`Invalid input type for ${key}: expected ${types.join(" or ")}.`];
+  });
+  return [
+    ...unknown.map((key) => `Unknown input property: ${key}`),
+    ...missing.map((key) => `Missing required input property: ${key}`),
+    ...typeErrors
+  ];
+}
+function optionValue(value) {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function commandArgs(command, input) {
+  const path = [];
+  let current = command;
+  while (current) {
+    if (current.name()) path.unshift(current.name());
+    current = current.parent;
+  }
+  const args = path.slice(1);
+  for (const argument of command.registeredArguments) {
+    const key = argument.name().replace(/<|>|\[|\]|\.\.\./g, "");
+    const value = input[key];
+    if (value === void 0) continue;
+    if (Array.isArray(value)) args.push(...value.map(optionValue));
+    else args.push(optionValue(value));
+  }
+  for (const option of command.options) {
+    const key = option.attributeName();
+    const value = input[key];
+    if (value === void 0 || value === false) continue;
+    const long = option.long;
+    if (!long) continue;
+    if (value === true) args.push(long);
+    else args.push(long, optionValue(value));
+  }
+  return args;
+}
+function withTrustedMachineAuth(auth, callback) {
+  const previousWaveEnvironment = Object.fromEntries(
+    Object.entries(process.env).filter(([key]) => key.startsWith("WAVE_"))
+  );
+  for (const key of Object.keys(process.env)) {
+    if (key.startsWith("WAVE_")) delete process.env[key];
+  }
+  if (auth) {
+    process.env.WAVE_API_TOKEN = auth.token;
+    process.env.WAVE_API_BASE_URL = auth.baseUrl;
+  }
+  process.env.WAVE_CLI_AUTH_STORAGE = "disabled";
+  process.env.WAVE_CLI_HOME = "/dev/null";
+  return callback().finally(() => {
+    for (const key of Object.keys(process.env)) {
+      if (key.startsWith("WAVE_")) delete process.env[key];
+    }
+    Object.assign(process.env, previousWaveEnvironment);
+  });
+}
+function needsTrustedAuth(operation) {
+  return operation.classification === "read" || operation.classification === "write" || operation.classification === "auth";
+}
+function resolveMachineOperation(program, id) {
+  const manifest = buildOperationManifest(program);
+  const operation = manifest.operations.find((candidate) => candidate.id === id);
+  const command = operation ? operationCommand(program, id) : void 0;
+  return operation && command && hasAction2(command) ? { operation, command } : null;
+}
+async function maybeRunMachineExecute(argv, program) {
+  if (argv[0] !== "--machine") return false;
+  const parsed = parseMachineArgs(argv);
+  if (parsed.error || !parsed.operation || !parsed.phase) {
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: false,
+        status: 400,
+        command: "machine.execute",
+        error: { code: "invalid_args", message: parsed.error ?? "operation and phase are required." }
+      }),
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+  if (!["validate", "preview", "execute"].includes(parsed.phase)) {
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: false,
+        status: 400,
+        command: "machine.execute",
+        error: { code: "invalid_phase", message: `Unsupported machine phase: ${parsed.phase}` }
+      }),
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+  let input;
+  try {
+    input = await readMachineInput(parsed.inputJson);
+  } catch (error) {
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: false,
+        status: 400,
+        command: "machine.execute",
+        error: { code: "invalid_input", message: error instanceof Error ? error.message : "Invalid machine input." }
+      }),
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+  const resolved = resolveMachineOperation(program, parsed.operation);
+  if (!resolved) {
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: false,
+        status: 404,
+        command: "machine.execute",
+        error: { code: "unknown_operation", message: `Unknown operation: ${parsed.operation}` }
+      }),
+      exitCode: EXIT_CODES.notFound
+    });
+  }
+  const normalizedInput = normalizeInput(input);
+  const errors = validateInput(resolved.operation, normalizedInput);
+  const digest = inputDigest(normalizedInput);
+  if (errors.length > 0) {
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: false,
+        status: 400,
+        command: "machine.execute",
+        error: { code: "invalid_input", message: "Machine input did not match the operation schema.", details: { errors } },
+        data: {
+          operation: resolved.operation.id,
+          normalizedInput,
+          inputDigest: digest
+        }
+      }),
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+  const manifest = buildOperationManifest(program);
+  if (parsed.phase === "validate") {
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: true,
+        status: 200,
+        command: "machine.execute",
+        data: {
+          status: "validated",
+          operation: resolved.operation.id,
+          normalizedInput,
+          inputDigest: digest,
+          cliVersion: manifest.cli.version,
+          registryDigest: manifest.registryDigest
+        }
+      })
+    });
+  }
+  if (parsed.phase === "preview") {
+    if (resolved.operation.classification !== "write") {
+      return printEnvelopeAndExit({
+        envelope: machineEnvelope({
+          ok: false,
+          status: 400,
+          command: "machine.execute",
+          error: { code: "preview_not_supported", message: `${resolved.operation.id} is not a write operation.` }
+        }),
+        exitCode: EXIT_CODES.invalidArgs
+      });
+    }
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: true,
+        status: 200,
+        command: "machine.execute",
+        data: {
+          status: "preview",
+          operation: resolved.operation.id,
+          normalizedInput,
+          preview: {
+            title: resolved.operation.summary,
+            command: resolved.operation.command,
+            requestedInput: normalizedInput,
+            summary: `Execute ${resolved.operation.command} with the validated input.`
+          },
+          inputDigest: digest,
+          cliVersion: manifest.cli.version,
+          registryDigest: manifest.registryDigest
+        }
+      })
+    });
+  }
+  if (resolved.operation.classification === "auth") {
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: true,
+        status: 202,
+        command: "machine.execute",
+        data: {
+          status: "continuation_required",
+          operation: resolved.operation.id,
+          message: "Interactive authentication is not run in machine mode. Continue through the MCP OAuth flow."
+        }
+      })
+    });
+  }
+  const auth = parseTrustedJson("WAVE_MACHINE_AUTH_JSON", isTrustedAuth);
+  if (needsTrustedAuth(resolved.operation) && !auth) {
+    return printEnvelopeAndExit({
+      envelope: machineEnvelope({
+        ok: false,
+        status: 401,
+        command: "machine.execute",
+        error: {
+          code: "missing_machine_auth",
+          message: "Machine execution requires trusted OAuth-bound auth context."
+        }
+      }),
+      exitCode: EXIT_CODES.missingOrInvalidAuth
+    });
+  }
+  if (resolved.operation.classification === "write") {
+    const approval = parseTrustedJson("WAVE_MACHINE_APPROVAL_JSON", isTrustedApproval);
+    if (!approval || approval.operation !== resolved.operation.id || approval.inputDigest !== digest || approval.cliVersion !== manifest.cli.version || approval.registryDigest !== manifest.registryDigest || approval.organizationId !== auth?.organizationId || approval.actorId !== auth?.actorId) {
+      return printEnvelopeAndExit({
+        envelope: machineEnvelope({
+          ok: false,
+          status: 403,
+          command: "machine.execute",
+          error: {
+            code: "approval_required",
+            message: "A matching server-managed approval is required before write execution.",
+            details: { operation: resolved.operation.id, inputDigest: digest }
+          }
+        }),
+        exitCode: EXIT_CODES.forbidden
+      });
+    }
+  }
+  try {
+    await withTrustedMachineAuth(auth, async () => {
+      await program.parseAsync([process.execPath, "wave", ...commandArgs(resolved.command, normalizedInput)]);
+    });
+  } catch (error) {
+    if (isEnvelopeEmittedSignal(error)) return true;
+    throw error;
+  }
+  return true;
+}
+
 // src/index.ts
 function printCliFailure(params) {
   printEnvelope({
@@ -16095,6 +17206,7 @@ function printCliFailure(params) {
 }
 async function main() {
   const program = buildCli();
+  if (await maybeRunMachineExecute(process.argv.slice(2), program)) return;
   await program.parseAsync(process.argv);
 }
 main().catch((error) => {