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

package/dist/index.cjs

@@ -14779,6 +14779,33 @@ var idSchema14 = import_zod19.z.string().trim().min(1);
 var idempotencyKeySchema = import_zod19.z.string().min(1).refine((value) => value.trim() === value, "Idempotency key must not have leading or trailing whitespace.");
 var skillScopeSchema = import_zod19.z.enum(["ADMIN_GLOBAL", "MEMBER_PERSONAL"]);
 var isoDateSchema = import_zod19.z.iso.date();
+var nonEmptyStringSchema = import_zod19.z.string().trim().min(1);
+var agentToolAccessSchema = import_zod19.z.array(
+  import_zod19.z.object({
+    tool_key: nonEmptyStringSchema,
+    scope_value: nonEmptyStringSchema
+  }).strict()
+).min(1);
+var agentPluginConnectionsSchema = import_zod19.z.array(
+  import_zod19.z.object({
+    external_tool_connection_id: nonEmptyStringSchema,
+    tool_key: nonEmptyStringSchema,
+    scope_value: nonEmptyStringSchema.optional(),
+    allowed_tools: import_zod19.z.array(nonEmptyStringSchema).optional(),
+    allowed_scopes: import_zod19.z.array(nonEmptyStringSchema).optional(),
+    requires_confirmation: import_zod19.z.boolean().optional(),
+    enabled: import_zod19.z.boolean().optional()
+  }).strict()
+).min(1);
+var agentTriggerSchema = import_zod19.z.object({
+  trigger_type: import_zod19.z.literal("cron"),
+  cron_expression: nonEmptyStringSchema,
+  timezone: nonEmptyStringSchema,
+  starts_at: import_zod19.z.iso.datetime({ offset: true }).nullable().optional(),
+  ends_at: import_zod19.z.iso.datetime({ offset: true }).nullable().optional(),
+  max_runs: import_zod19.z.number().int().positive().nullable().optional(),
+  enabled: import_zod19.z.boolean().optional()
+}).strict();
 var AGENT_SELECTION = `{
   id
   type
@@ -14791,11 +14818,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
@@ -14856,6 +14923,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);
@@ -14893,11 +14964,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({
@@ -14923,7 +15008,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
@@ -14946,6 +15034,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 = import_zod19.z.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);
@@ -15035,7 +15140,7 @@ var import_node_path4 = require("path");
 var import_node_crypto3 = require("crypto");
 
 // src/version.ts
-var CLI_VERSION = "0.1.68";
+var CLI_VERSION = "0.1.70";
 
 // src/operationMetadata.ts
 var DISCOVERY_OPERATION_IDS = [
@@ -15154,6 +15259,7 @@ var READ_OPERATION_IDS = [
   "accountability.list",
   "accountability.search",
   "accountability.show",
+  "agents.plugin-catalog",
   "agents.show",
   "auth.status",
   "automations.show",
@@ -15829,6 +15935,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: {
@@ -15837,6 +15944,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"]

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);
@@ -15034,7 +15139,7 @@ import { join as join3 } from "path";
 import { createHash } from "crypto";
 
 // src/version.ts
-var CLI_VERSION = "0.1.68";
+var CLI_VERSION = "0.1.70";
 
 // src/operationMetadata.ts
 var DISCOVERY_OPERATION_IDS = [
@@ -15153,6 +15258,7 @@ var READ_OPERATION_IDS = [
   "accountability.list",
   "accountability.search",
   "accountability.show",
+  "agents.plugin-catalog",
   "agents.show",
   "auth.status",
   "automations.show",
@@ -15828,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: {
@@ -15836,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"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wave-ai-os/wave-cli",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "type": "module",
   "bin": {
     "wave": "dist/index.js"