@wave-ai-os/wave-cli 0.1.74 → 0.1.75

package/dist/index.cjs

@@ -14883,6 +14883,7 @@ var idempotencyKeySchema = import_zod19.z.string().min(1).refine((value) => valu
 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 AUTOMATION_RUN_HTTP_TIMEOUT_MS = 6e4;
 var agentToolAccessSchema = import_zod19.z.array(
   import_zod19.z.object({
     tool_key: nonEmptyStringSchema,
@@ -15018,10 +15019,33 @@ var AUTOMATION_SELECTION = `{
   aiTaskConfig
   organizationId
   memberId
+  agentId
   createdAt
   updatedAt
   updateVersion
 }`;
+var AUTOMATION_RUN_SELECTION = `{
+  id
+  type
+  attributes {
+    id
+    title
+    status
+    errorMessage
+    usedAt
+    agentTriggerId
+    executionId
+    executionSlug
+    traceId
+    outputContentId
+    outputContentSlug
+    outputContent {
+      id
+      slug
+    }
+    targetId
+  }
+}`;
 function asRecord7(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -15129,12 +15153,92 @@ function normalizePersistedUpdatePayload(payload) {
     persisted: { id, slug, update_version: updateVersion }
   };
 }
+function normalizeAutomationRunPayload(payload) {
+  const mutation = asRecord7(payload);
+  if (!mutation) {
+    throw new CliError({
+      message: "Automation run response did not include a mutation payload.",
+      kind: "malformed_response",
+      status: 502,
+      exitCode: EXIT_CODES.networkOrUpstream
+    });
+  }
+  if (mutation.ok !== true) {
+    return {
+      ok: mutation.ok,
+      status: mutation.status,
+      errorCode: mutation.errorCode ?? null,
+      errors: mutation.errors ?? null,
+      data: mutation.data ?? null
+    };
+  }
+  const data = asRecord7(mutation.data);
+  const automationTaskId = asRequiredString(data?.automation_task_id);
+  const automationTaskSlug = asRequiredString(data?.automation_task_slug);
+  const agentId = asRequiredString(data?.agent_id);
+  const agentSlug = asRequiredString(data?.agent_slug);
+  const agentTriggerId = asRequiredString(data?.agent_trigger_id);
+  const executionId = asRequiredString(data?.execution_id);
+  const executionSlug = asRequiredString(data?.execution_slug);
+  const executionStatus = asRequiredString(data?.execution_status);
+  const traceId = asRequiredString(data?.trace_id);
+  if (!data || !automationTaskId || !automationTaskSlug || !agentId || !agentSlug || !agentTriggerId || !executionId || !executionSlug || !executionStatus || !traceId) {
+    throw new CliError({
+      message: "Automation run response did not include automation, execution, and trace evidence.",
+      kind: "malformed_response",
+      status: 502,
+      exitCode: EXIT_CODES.networkOrUpstream
+    });
+  }
+  return {
+    ok: mutation.ok,
+    status: mutation.status,
+    errorCode: mutation.errorCode ?? null,
+    errors: mutation.errors ?? null,
+    run: {
+      executed: data.executed === true,
+      skipped_reason: asRequiredString(data.skipped_reason),
+      automation: {
+        id: automationTaskId,
+        slug: automationTaskSlug
+      },
+      agent: {
+        id: agentId,
+        slug: agentSlug
+      },
+      trigger: {
+        id: agentTriggerId,
+        type: asRequiredString(data.trigger_type)
+      },
+      execution: {
+        id: executionId,
+        slug: executionSlug,
+        status: executionStatus
+      },
+      output_content: {
+        id: asRequiredString(data.output_content_id),
+        slug: asRequiredString(data.output_content_slug)
+      },
+      trace_id: traceId,
+      correlation_id: asRequiredString(data.correlation_id),
+      readback_command: `wave automations run-show --agent-id ${agentSlug} --execution-slug ${executionSlug}`
+    }
+  };
+}
 function parseAutomationConfig(value) {
   return automationConfigSchema.parse(parseJson(String(value), "--ai-task-config"));
 }
 function parseExpectedUpdateVersion(value) {
   return nonEmptyStringSchema.parse(String(value));
 }
+function withAutomationRunTimeout(runtimeOptions) {
+  const configuredTimeoutMs = Number(runtimeOptions.timeoutMs);
+  const timeoutMs = Number.isFinite(configuredTimeoutMs) && configuredTimeoutMs > AUTOMATION_RUN_HTTP_TIMEOUT_MS ? configuredTimeoutMs : AUTOMATION_RUN_HTTP_TIMEOUT_MS;
+  return {
+    ...runtimeOptions,
+    timeoutMs
+  };
+}
 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("--web-fetch-enabled <boolean>", "true or false").option("--search-past-conversations-enabled <boolean>", "true or false").option("--app-rules-creation-enabled <boolean>", "true or false").option("--tool-discovery-enabled <boolean>", "true or false").option("--self-updates-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(
@@ -15367,7 +15471,7 @@ function registerAtlasAuthoringCommands(program) {
           ...opts.description !== void 0 ? { description: String(opts.description) } : {},
           ...opts.notes !== void 0 ? { notes: String(opts.notes) } : {},
           ...opts.memberId !== void 0 ? { member_id: idSchema14.parse(opts.memberId) } : {},
-          ...opts.agentId !== void 0 ? { agentId: idSchema14.parse(opts.agentId) } : {},
+          ...opts.agentId !== void 0 ? { agent_id: idSchema14.parse(opts.agentId) } : {},
           ...opts.priority !== void 0 ? { priority: String(opts.priority) } : {},
           ...opts.dueDate !== void 0 ? { due_date: isoDateSchema.parse(opts.dueDate) } : {}
         },
@@ -15391,6 +15495,44 @@ function registerAtlasAuthoringCommands(program) {
       isShow: true
     });
   });
+  automations.command("run").description("Run one scheduled Automation by id or slug and return execution trace evidence").requiredOption("--id <idOrSlug>", "Automation id or slug").action(async (opts, cmd) => {
+    const automationId = idSchema14.parse(opts.id);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlMutationCommand({
+      command: "automations.run",
+      operationName: "AutomationsRunNow",
+      runtimeOptions: withAutomationRunTimeout(context.runtimeOptions),
+      field: "run_automation_now",
+      variableTypes: { organization_id: "ID!", automation_id: "ID!" },
+      variables: { organization_id: organizationId, automation_id: automationId },
+      transformMutationPayload: normalizeAutomationRunPayload
+    });
+  });
+  automations.command("run-show").description("Read one Automation run artifact by Agent id and execution slug").requiredOption("--agent-id <agentIdOrSlug>", "Agent id or slug").requiredOption("--execution-slug <executionSlug>", "Execution slug returned by automations run").action(async (opts, cmd) => {
+    const agentId = idSchema14.parse(opts.agentId);
+    const executionSlug = idSchema14.parse(opts.executionSlug);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlQueryCommand({
+      command: "automations.run-show",
+      operationName: "AutomationsRunShow",
+      runtimeOptions: context.runtimeOptions,
+      field: "agent_automation_run",
+      variables: {
+        organization_id: organizationId,
+        agent_id: agentId,
+        automation_id: executionSlug
+      },
+      variableTypes: {
+        organization_id: "ID!",
+        agent_id: "ID!",
+        automation_id: "ID!"
+      },
+      selectionSet: AUTOMATION_RUN_SELECTION,
+      isShow: true
+    });
+  });
   automations.command("update").description("Update one task-backed Automation without changing its system-managed status").requiredOption("--id <idOrSlug>", "Automation id or slug").requiredOption(
     "--expected-update-version <version>",
     "Exact opaque updateVersion value from automations show; rejects stale writes"
@@ -15654,6 +15796,7 @@ var READ_OPERATION_IDS = [
   "agents.plugin-catalog",
   "agents.show",
   "auth.status",
+  "automations.run-show",
   "automations.show",
   "broadcast.community",
   "broadcast.list",
@@ -15852,6 +15995,7 @@ var WRITE_OPERATION_IDS = [
   "agents.create",
   "agents.update",
   "automations.create",
+  "automations.run",
   "automations.update",
   "contacts.create",
   "contacts.update",
@@ -16362,6 +16506,8 @@ var NAMESPACE_DOCS = {
     examples: [
       `wave automations create --summary "Weekly review" --agent-id 123 --ai-task-config '{"cycle":"repeat","repeatSchedule":{"interval":1,"frequency":"week","weekdays":[1,3],"at":"2:30 PM","starting":"2026-07-20T00:00:00.000Z","ending":"never","endingRuns":1,"endingDate":null,"timezone":"America/Phoenix"}}' --idempotency-key automation-create-001`,
       "wave automations show --id ATK-01",
+      "wave automations run --id ATK-01",
+      "wave automations run-show --agent-id AGT-01 --execution-slug ART-1234567890",
       'wave automations update --id ATK-01 --expected-update-version 2026-07-17T12:00:00.123456Z --summary "Weekly project review"'
     ],
     schema: {
@@ -16373,10 +16519,11 @@ var NAMESPACE_DOCS = {
         "Only the API-defined ai_task_config field accepts validated JSON.",
         "Optional executor Agent linkage is sent only through the API-defined top-level agentId input.",
         "Update calls only updateTask with an exact opaque updateVersion token; it cannot change status, task type, ownership, or project linkage.",
-        "Does not create a project Task, run an Automation, or invoke AI OS actions.",
+        "Run calls only runAutomationNow for an existing scheduled Automation and returns execution/trace evidence.",
+        "Run-show reads the persisted Automation run artifact through agentAutomationRun by Agent id and execution slug.",
         "Show uses the API-owned automation query by id; no slug fallback is implemented."
       ],
-      commands: ["create", "show", "update"]
+      commands: ["create", "show", "run", "run-show", "update"]
     }
   },
   broadcast: {
@@ -16856,10 +17003,14 @@ async function resolveDoctorAuthOrganization(params) {
     }
     const id = organization.id;
     const slug = organization.slug;
-    return {
-      id: typeof id === "string" && id.trim() !== "" ? id : void 0,
-      slug: typeof slug === "string" && slug.trim() !== "" ? slug : void 0
-    };
+    const result = {};
+    if (typeof id === "string" && id.trim() !== "") {
+      result.id = id;
+    }
+    if (typeof slug === "string" && slug.trim() !== "") {
+      result.slug = slug;
+    }
+    return result;
   } catch {
     return null;
   }
@@ -16872,7 +17023,14 @@ async function runDoctor(cmd, opts) {
   const tokenSource = runtime.tokenSource ?? "none";
   const organizationId = context.organizationId;
   const authStorage = await getAuthStorageInfo(baseUrl);
-  const authOrganization = organizationId ? null : await resolveDoctorAuthOrganization({ baseUrl, token });
+  const authOptions = {};
+  if (baseUrl) {
+    authOptions.baseUrl = baseUrl;
+  }
+  if (token) {
+    authOptions.token = token;
+  }
+  const authOrganization = organizationId ? null : await resolveDoctorAuthOrganization(authOptions);
   const checks = [
     {
       name: "auth_token",

package/dist/index.js

@@ -14882,6 +14882,7 @@ var idempotencyKeySchema = z19.string().min(1).refine((value) => value.trim() ==
 var skillScopeSchema = z19.enum(["ADMIN_GLOBAL", "MEMBER_PERSONAL"]);
 var isoDateSchema = z19.iso.date();
 var nonEmptyStringSchema = z19.string().trim().min(1);
+var AUTOMATION_RUN_HTTP_TIMEOUT_MS = 6e4;
 var agentToolAccessSchema = z19.array(
   z19.object({
     tool_key: nonEmptyStringSchema,
@@ -15017,10 +15018,33 @@ var AUTOMATION_SELECTION = `{
   aiTaskConfig
   organizationId
   memberId
+  agentId
   createdAt
   updatedAt
   updateVersion
 }`;
+var AUTOMATION_RUN_SELECTION = `{
+  id
+  type
+  attributes {
+    id
+    title
+    status
+    errorMessage
+    usedAt
+    agentTriggerId
+    executionId
+    executionSlug
+    traceId
+    outputContentId
+    outputContentSlug
+    outputContent {
+      id
+      slug
+    }
+    targetId
+  }
+}`;
 function asRecord7(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -15128,12 +15152,92 @@ function normalizePersistedUpdatePayload(payload) {
     persisted: { id, slug, update_version: updateVersion }
   };
 }
+function normalizeAutomationRunPayload(payload) {
+  const mutation = asRecord7(payload);
+  if (!mutation) {
+    throw new CliError({
+      message: "Automation run response did not include a mutation payload.",
+      kind: "malformed_response",
+      status: 502,
+      exitCode: EXIT_CODES.networkOrUpstream
+    });
+  }
+  if (mutation.ok !== true) {
+    return {
+      ok: mutation.ok,
+      status: mutation.status,
+      errorCode: mutation.errorCode ?? null,
+      errors: mutation.errors ?? null,
+      data: mutation.data ?? null
+    };
+  }
+  const data = asRecord7(mutation.data);
+  const automationTaskId = asRequiredString(data?.automation_task_id);
+  const automationTaskSlug = asRequiredString(data?.automation_task_slug);
+  const agentId = asRequiredString(data?.agent_id);
+  const agentSlug = asRequiredString(data?.agent_slug);
+  const agentTriggerId = asRequiredString(data?.agent_trigger_id);
+  const executionId = asRequiredString(data?.execution_id);
+  const executionSlug = asRequiredString(data?.execution_slug);
+  const executionStatus = asRequiredString(data?.execution_status);
+  const traceId = asRequiredString(data?.trace_id);
+  if (!data || !automationTaskId || !automationTaskSlug || !agentId || !agentSlug || !agentTriggerId || !executionId || !executionSlug || !executionStatus || !traceId) {
+    throw new CliError({
+      message: "Automation run response did not include automation, execution, and trace evidence.",
+      kind: "malformed_response",
+      status: 502,
+      exitCode: EXIT_CODES.networkOrUpstream
+    });
+  }
+  return {
+    ok: mutation.ok,
+    status: mutation.status,
+    errorCode: mutation.errorCode ?? null,
+    errors: mutation.errors ?? null,
+    run: {
+      executed: data.executed === true,
+      skipped_reason: asRequiredString(data.skipped_reason),
+      automation: {
+        id: automationTaskId,
+        slug: automationTaskSlug
+      },
+      agent: {
+        id: agentId,
+        slug: agentSlug
+      },
+      trigger: {
+        id: agentTriggerId,
+        type: asRequiredString(data.trigger_type)
+      },
+      execution: {
+        id: executionId,
+        slug: executionSlug,
+        status: executionStatus
+      },
+      output_content: {
+        id: asRequiredString(data.output_content_id),
+        slug: asRequiredString(data.output_content_slug)
+      },
+      trace_id: traceId,
+      correlation_id: asRequiredString(data.correlation_id),
+      readback_command: `wave automations run-show --agent-id ${agentSlug} --execution-slug ${executionSlug}`
+    }
+  };
+}
 function parseAutomationConfig(value) {
   return automationConfigSchema.parse(parseJson(String(value), "--ai-task-config"));
 }
 function parseExpectedUpdateVersion(value) {
   return nonEmptyStringSchema.parse(String(value));
 }
+function withAutomationRunTimeout(runtimeOptions) {
+  const configuredTimeoutMs = Number(runtimeOptions.timeoutMs);
+  const timeoutMs = Number.isFinite(configuredTimeoutMs) && configuredTimeoutMs > AUTOMATION_RUN_HTTP_TIMEOUT_MS ? configuredTimeoutMs : AUTOMATION_RUN_HTTP_TIMEOUT_MS;
+  return {
+    ...runtimeOptions,
+    timeoutMs
+  };
+}
 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("--web-fetch-enabled <boolean>", "true or false").option("--search-past-conversations-enabled <boolean>", "true or false").option("--app-rules-creation-enabled <boolean>", "true or false").option("--tool-discovery-enabled <boolean>", "true or false").option("--self-updates-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(
@@ -15366,7 +15470,7 @@ function registerAtlasAuthoringCommands(program) {
           ...opts.description !== void 0 ? { description: String(opts.description) } : {},
           ...opts.notes !== void 0 ? { notes: String(opts.notes) } : {},
           ...opts.memberId !== void 0 ? { member_id: idSchema14.parse(opts.memberId) } : {},
-          ...opts.agentId !== void 0 ? { agentId: idSchema14.parse(opts.agentId) } : {},
+          ...opts.agentId !== void 0 ? { agent_id: idSchema14.parse(opts.agentId) } : {},
           ...opts.priority !== void 0 ? { priority: String(opts.priority) } : {},
           ...opts.dueDate !== void 0 ? { due_date: isoDateSchema.parse(opts.dueDate) } : {}
         },
@@ -15390,6 +15494,44 @@ function registerAtlasAuthoringCommands(program) {
       isShow: true
     });
   });
+  automations.command("run").description("Run one scheduled Automation by id or slug and return execution trace evidence").requiredOption("--id <idOrSlug>", "Automation id or slug").action(async (opts, cmd) => {
+    const automationId = idSchema14.parse(opts.id);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlMutationCommand({
+      command: "automations.run",
+      operationName: "AutomationsRunNow",
+      runtimeOptions: withAutomationRunTimeout(context.runtimeOptions),
+      field: "run_automation_now",
+      variableTypes: { organization_id: "ID!", automation_id: "ID!" },
+      variables: { organization_id: organizationId, automation_id: automationId },
+      transformMutationPayload: normalizeAutomationRunPayload
+    });
+  });
+  automations.command("run-show").description("Read one Automation run artifact by Agent id and execution slug").requiredOption("--agent-id <agentIdOrSlug>", "Agent id or slug").requiredOption("--execution-slug <executionSlug>", "Execution slug returned by automations run").action(async (opts, cmd) => {
+    const agentId = idSchema14.parse(opts.agentId);
+    const executionSlug = idSchema14.parse(opts.executionSlug);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlQueryCommand({
+      command: "automations.run-show",
+      operationName: "AutomationsRunShow",
+      runtimeOptions: context.runtimeOptions,
+      field: "agent_automation_run",
+      variables: {
+        organization_id: organizationId,
+        agent_id: agentId,
+        automation_id: executionSlug
+      },
+      variableTypes: {
+        organization_id: "ID!",
+        agent_id: "ID!",
+        automation_id: "ID!"
+      },
+      selectionSet: AUTOMATION_RUN_SELECTION,
+      isShow: true
+    });
+  });
   automations.command("update").description("Update one task-backed Automation without changing its system-managed status").requiredOption("--id <idOrSlug>", "Automation id or slug").requiredOption(
     "--expected-update-version <version>",
     "Exact opaque updateVersion value from automations show; rejects stale writes"
@@ -15653,6 +15795,7 @@ var READ_OPERATION_IDS = [
   "agents.plugin-catalog",
   "agents.show",
   "auth.status",
+  "automations.run-show",
   "automations.show",
   "broadcast.community",
   "broadcast.list",
@@ -15851,6 +15994,7 @@ var WRITE_OPERATION_IDS = [
   "agents.create",
   "agents.update",
   "automations.create",
+  "automations.run",
   "automations.update",
   "contacts.create",
   "contacts.update",
@@ -16361,6 +16505,8 @@ var NAMESPACE_DOCS = {
     examples: [
       `wave automations create --summary "Weekly review" --agent-id 123 --ai-task-config '{"cycle":"repeat","repeatSchedule":{"interval":1,"frequency":"week","weekdays":[1,3],"at":"2:30 PM","starting":"2026-07-20T00:00:00.000Z","ending":"never","endingRuns":1,"endingDate":null,"timezone":"America/Phoenix"}}' --idempotency-key automation-create-001`,
       "wave automations show --id ATK-01",
+      "wave automations run --id ATK-01",
+      "wave automations run-show --agent-id AGT-01 --execution-slug ART-1234567890",
       'wave automations update --id ATK-01 --expected-update-version 2026-07-17T12:00:00.123456Z --summary "Weekly project review"'
     ],
     schema: {
@@ -16372,10 +16518,11 @@ var NAMESPACE_DOCS = {
         "Only the API-defined ai_task_config field accepts validated JSON.",
         "Optional executor Agent linkage is sent only through the API-defined top-level agentId input.",
         "Update calls only updateTask with an exact opaque updateVersion token; it cannot change status, task type, ownership, or project linkage.",
-        "Does not create a project Task, run an Automation, or invoke AI OS actions.",
+        "Run calls only runAutomationNow for an existing scheduled Automation and returns execution/trace evidence.",
+        "Run-show reads the persisted Automation run artifact through agentAutomationRun by Agent id and execution slug.",
         "Show uses the API-owned automation query by id; no slug fallback is implemented."
       ],
-      commands: ["create", "show", "update"]
+      commands: ["create", "show", "run", "run-show", "update"]
     }
   },
   broadcast: {
@@ -16855,10 +17002,14 @@ async function resolveDoctorAuthOrganization(params) {
     }
     const id = organization.id;
     const slug = organization.slug;
-    return {
-      id: typeof id === "string" && id.trim() !== "" ? id : void 0,
-      slug: typeof slug === "string" && slug.trim() !== "" ? slug : void 0
-    };
+    const result = {};
+    if (typeof id === "string" && id.trim() !== "") {
+      result.id = id;
+    }
+    if (typeof slug === "string" && slug.trim() !== "") {
+      result.slug = slug;
+    }
+    return result;
   } catch {
     return null;
   }
@@ -16871,7 +17022,14 @@ async function runDoctor(cmd, opts) {
   const tokenSource = runtime.tokenSource ?? "none";
   const organizationId = context.organizationId;
   const authStorage = await getAuthStorageInfo(baseUrl);
-  const authOrganization = organizationId ? null : await resolveDoctorAuthOrganization({ baseUrl, token });
+  const authOptions = {};
+  if (baseUrl) {
+    authOptions.baseUrl = baseUrl;
+  }
+  if (token) {
+    authOptions.token = token;
+  }
+  const authOrganization = organizationId ? null : await resolveDoctorAuthOrganization(authOptions);
   const checks = [
     {
       name: "auth_token",

package/package.json

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