@hasnatools/skills 0.1.37 → 0.1.38

package/dist/index.js

@@ -20793,6 +20793,52 @@ async function makeApiRequest(path6, options = {}) {
     headers
   });
 }
+async function listSchedules(options) {
+  const params = new URLSearchParams;
+  if (options?.status)
+    params.set("status", options.status);
+  if (options?.skill)
+    params.set("skill", options.skill);
+  if (options?.search)
+    params.set("search", options.search);
+  if (options?.limit)
+    params.set("limit", options.limit.toString());
+  if (options?.offset)
+    params.set("offset", options.offset.toString());
+  const query = params.toString();
+  return apiRequest(`/schedules${query ? `?${query}` : ""}`);
+}
+async function getSchedule(id) {
+  return apiRequest(`/schedules/${id}`);
+}
+async function createSchedule(input) {
+  return apiRequest("/schedules", {
+    method: "POST",
+    body: JSON.stringify(input)
+  });
+}
+async function updateSchedule(id, input) {
+  return apiRequest(`/schedules/${id}`, {
+    method: "PATCH",
+    body: JSON.stringify(input)
+  });
+}
+async function deleteSchedule(id) {
+  return apiRequest(`/schedules/${id}`, {
+    method: "DELETE"
+  });
+}
+async function getScheduleRuns(id, options) {
+  const params = new URLSearchParams;
+  if (options?.status)
+    params.set("status", options.status);
+  if (options?.limit)
+    params.set("limit", options.limit.toString());
+  if (options?.offset)
+    params.set("offset", options.offset.toString());
+  const query = params.toString();
+  return apiRequest(`/schedules/${id}/runs${query ? `?${query}` : ""}`);
+}
 
 // src/commands/login.ts
 async function loginCommand(options = {}) {
@@ -23739,10 +23785,383 @@ async function setupCommand(promptArg, options = {}) {
   console.log(`  ${command("skills list")}`);
 }
 
+// src/commands/schedule.ts
+var indigo12 = source_default.hex("#6366f1");
+async function scheduleCreateCommand(skill, scheduleInput, options) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  let scheduleConfig = {};
+  if (options.cron) {
+    scheduleConfig.cronExpression = options.cron;
+  } else if (options.at) {
+    scheduleConfig.scheduledAt = options.at;
+  } else if (scheduleInput) {
+    scheduleConfig.schedule = scheduleInput;
+  } else {
+    console.log(source_default.red("Please provide a schedule"));
+    console.log(source_default.dim("Examples:"));
+    console.log(source_default.dim('  skills schedule <skill> "every Monday at 9am"'));
+    console.log(source_default.dim('  skills schedule <skill> --cron "0 9 * * 1"'));
+    console.log(source_default.dim('  skills schedule <skill> --at "2025-01-15T09:00:00"'));
+    return;
+  }
+  const spinner = ora("Creating schedule...").start();
+  try {
+    const result = await createSchedule({
+      skillSlug: skill,
+      name: options.name || `${skill} schedule`,
+      ...scheduleConfig,
+      command: options.command,
+      timezone: options.timezone || "UTC",
+      maxRuns: options.maxRuns
+    });
+    if (result.error) {
+      spinner.fail("Failed to create schedule");
+      console.log(source_default.red(result.error));
+      return;
+    }
+    spinner.succeed("Schedule created successfully");
+    console.log();
+    const schedule = result.data?.schedule;
+    if (schedule) {
+      printScheduleDetails(schedule);
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleListCommand(options = {}) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Fetching schedules...").start();
+  try {
+    const result = await listSchedules({
+      status: options.status,
+      skill: options.skill,
+      limit: options.limit || 20
+    });
+    spinner.stop();
+    if (result.error) {
+      console.log(source_default.red(result.error));
+      return;
+    }
+    const { schedules, stats } = result.data || { schedules: [], stats: { total: 0, active: 0, paused: 0, completed: 0, failed: 0, cancelled: 0 } };
+    console.log();
+    console.log(indigo12.bold("Scheduled Jobs"));
+    console.log(source_default.dim(`Total: ${stats.total} | Active: ${stats.active} | Paused: ${stats.paused} | Completed: ${stats.completed} | Failed: ${stats.failed}`));
+    console.log();
+    if (schedules.length === 0) {
+      console.log(source_default.dim("No schedules found"));
+      console.log(source_default.dim('Create one with: skills schedule <skill> "every day at 9am"'));
+      return;
+    }
+    for (const schedule of schedules) {
+      printScheduleSummary(schedule);
+    }
+    console.log();
+    console.log(source_default.dim("View all at: https://skills.md/dashboard/schedules"));
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleGetCommand(id) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Fetching schedule...").start();
+  try {
+    const result = await getSchedule(id);
+    spinner.stop();
+    if (result.error) {
+      console.log(source_default.red(result.error));
+      return;
+    }
+    const { schedule, recentRuns, stats } = result.data || {};
+    if (!schedule) {
+      console.log(source_default.red("Schedule not found"));
+      return;
+    }
+    console.log();
+    printScheduleDetails(schedule);
+    if (stats) {
+      console.log();
+      console.log(indigo12.bold("Run Statistics"));
+      console.log(`  ${source_default.dim("Total Runs:")} ${stats.totalRuns}`);
+      console.log(`  ${source_default.dim("Successful:")} ${source_default.green(String(stats.successfulRuns))}`);
+      console.log(`  ${source_default.dim("Failed:")} ${source_default.red(String(stats.failedRuns))}`);
+      console.log(`  ${source_default.dim("Credits Used:")} ${indigo12(String(stats.totalCredits))}`);
+      if (stats.avgDurationMs) {
+        console.log(`  ${source_default.dim("Avg Duration:")} ${formatDuration3(stats.avgDurationMs)}`);
+      }
+    }
+    if (recentRuns && recentRuns.length > 0) {
+      console.log();
+      console.log(indigo12.bold("Recent Runs"));
+      for (const run of recentRuns.slice(0, 5)) {
+        printRunSummary(run);
+      }
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function schedulePauseCommand(id) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Pausing schedule...").start();
+  try {
+    const result = await updateSchedule(id, { status: "paused" });
+    if (result.error) {
+      spinner.fail("Failed to pause schedule");
+      console.log(source_default.red(result.error));
+      return;
+    }
+    spinner.succeed("Schedule paused successfully");
+    const schedule = result.data?.schedule;
+    if (schedule) {
+      console.log();
+      console.log(`  ${source_default.dim("Name:")} ${schedule.name}`);
+      console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleResumeCommand(id) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Resuming schedule...").start();
+  try {
+    const result = await updateSchedule(id, { status: "active" });
+    if (result.error) {
+      spinner.fail("Failed to resume schedule");
+      console.log(source_default.red(result.error));
+      return;
+    }
+    spinner.succeed("Schedule resumed successfully");
+    const schedule = result.data?.schedule;
+    if (schedule) {
+      console.log();
+      console.log(`  ${source_default.dim("Name:")} ${schedule.name}`);
+      console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+      if (schedule.nextRunAt) {
+        console.log(`  ${source_default.dim("Next Run:")} ${formatDate(schedule.nextRunAt)}`);
+      }
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleCancelCommand(id) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Cancelling schedule...").start();
+  try {
+    const result = await deleteSchedule(id);
+    if (result.error) {
+      spinner.fail("Failed to cancel schedule");
+      console.log(source_default.red(result.error));
+      return;
+    }
+    spinner.succeed("Schedule cancelled successfully");
+    const schedule = result.data?.schedule;
+    if (schedule) {
+      console.log();
+      console.log(`  ${source_default.dim("Name:")} ${schedule.name}`);
+      console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleHistoryCommand(id, options = {}) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Fetching run history...").start();
+  try {
+    const result = await getScheduleRuns(id, {
+      status: options.status,
+      limit: options.limit || 20
+    });
+    spinner.stop();
+    if (result.error) {
+      console.log(source_default.red(result.error));
+      return;
+    }
+    const { schedule, runs, stats } = result.data || {};
+    if (!schedule) {
+      console.log(source_default.red("Schedule not found"));
+      return;
+    }
+    console.log();
+    console.log(indigo12.bold(`Run History: ${schedule.name}`));
+    console.log(source_default.dim(`Skill: ${schedule.skillSlug}`));
+    console.log(source_default.dim(`Total: ${stats?.totalRuns || 0} | Success: ${stats?.successfulRuns || 0} | Failed: ${stats?.failedRuns || 0} | Success Rate: ${stats?.successRate || 0}%`));
+    console.log();
+    if (!runs || runs.length === 0) {
+      console.log(source_default.dim("No runs yet"));
+      return;
+    }
+    for (const run of runs) {
+      printRunSummary(run);
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+function printScheduleSummary(schedule) {
+  const statusIcon = getStatusIcon2(schedule.status);
+  const nextRun = schedule.nextRunAt ? formatRelativeTime(schedule.nextRunAt) : "-";
+  console.log(`${statusIcon} ${source_default.bold(schedule.name)} ${source_default.dim(`(${schedule.skillSlug})`)}`);
+  console.log(`  ${source_default.dim("ID:")} ${schedule.id.slice(0, 8)}...`);
+  console.log(`  ${source_default.dim("Schedule:")} ${schedule.scheduleDescription || schedule.cronExpression || "One-time"}`);
+  console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+  console.log(`  ${source_default.dim("Next Run:")} ${nextRun}`);
+  console.log(`  ${source_default.dim("Runs:")} ${schedule.runCount}${schedule.maxRuns ? `/${schedule.maxRuns}` : ""}`);
+  console.log();
+}
+function printScheduleDetails(schedule) {
+  console.log(indigo12.bold("Schedule Details"));
+  console.log(`  ${source_default.dim("ID:")} ${schedule.id}`);
+  console.log(`  ${source_default.dim("Name:")} ${schedule.name}`);
+  console.log(`  ${source_default.dim("Skill:")} ${schedule.skillSlug}`);
+  console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+  console.log(`  ${source_default.dim("Type:")} ${schedule.scheduleType === "cron" ? "Recurring" : "One-time"}`);
+  console.log(`  ${source_default.dim("Schedule:")} ${schedule.scheduleDescription || schedule.cronExpression || formatDate(schedule.scheduledAt)}`);
+  console.log(`  ${source_default.dim("Timezone:")} ${schedule.timezone}`);
+  if (schedule.command) {
+    console.log(`  ${source_default.dim("Command:")} ${schedule.command}`);
+  }
+  console.log(`  ${source_default.dim("Runs:")} ${schedule.runCount}${schedule.maxRuns ? `/${schedule.maxRuns}` : ""}`);
+  if (schedule.nextRunAt) {
+    console.log(`  ${source_default.dim("Next Run:")} ${formatDate(schedule.nextRunAt)} (${formatRelativeTime(schedule.nextRunAt)})`);
+  }
+  if (schedule.lastRunAt) {
+    console.log(`  ${source_default.dim("Last Run:")} ${formatDate(schedule.lastRunAt)} - ${formatStatus3(schedule.lastRunStatus || "unknown")}`);
+  }
+  console.log(`  ${source_default.dim("Created:")} ${formatDate(schedule.createdAt)}`);
+}
+function printRunSummary(run) {
+  const statusIcon = run.status === "completed" ? source_default.green("✓") : source_default.red("✗");
+  const duration = run.durationMs ? formatDuration3(run.durationMs) : "-";
+  console.log(`  ${statusIcon} Run #${run.runNumber} - ${formatStatus3(run.status)}`);
+  console.log(`    ${source_default.dim("Time:")} ${formatDate(run.createdAt)}`);
+  console.log(`    ${source_default.dim("Duration:")} ${duration}`);
+  if (run.creditsUsed) {
+    console.log(`    ${source_default.dim("Credits:")} ${run.creditsUsed}`);
+  }
+  if (run.errorMessage) {
+    console.log(`    ${source_default.dim("Error:")} ${source_default.red(run.errorMessage)}`);
+  }
+}
+function getStatusIcon2(status) {
+  switch (status) {
+    case "active":
+      return source_default.green("●");
+    case "paused":
+      return source_default.yellow("◐");
+    case "completed":
+      return source_default.blue("✓");
+    case "failed":
+      return source_default.red("✗");
+    case "cancelled":
+      return source_default.dim("○");
+    default:
+      return source_default.dim("○");
+  }
+}
+function formatStatus3(status) {
+  switch (status) {
+    case "active":
+      return source_default.green("active");
+    case "paused":
+      return source_default.yellow("paused");
+    case "completed":
+      return source_default.blue("completed");
+    case "failed":
+      return source_default.red("failed");
+    case "cancelled":
+      return source_default.dim("cancelled");
+    default:
+      return source_default.dim(status || "unknown");
+  }
+}
+function formatDate(dateString) {
+  if (!dateString)
+    return "-";
+  const date = new Date(dateString);
+  return date.toLocaleString();
+}
+function formatRelativeTime(dateString) {
+  const date = new Date(dateString);
+  const now = new Date;
+  const diffMs = date.getTime() - now.getTime();
+  const diffMins = Math.round(diffMs / 60000);
+  const diffHours = Math.round(diffMs / 3600000);
+  const diffDays = Math.round(diffMs / 86400000);
+  if (diffMins < 0) {
+    if (diffMins > -60)
+      return `${Math.abs(diffMins)}m ago`;
+    if (diffHours > -24)
+      return `${Math.abs(diffHours)}h ago`;
+    return `${Math.abs(diffDays)}d ago`;
+  }
+  if (diffMins < 60)
+    return `in ${diffMins}m`;
+  if (diffHours < 24)
+    return `in ${diffHours}h`;
+  return `in ${diffDays}d`;
+}
+function formatDuration3(ms) {
+  if (ms < 1000) {
+    return `${ms}ms`;
+  } else if (ms < 60000) {
+    return `${(ms / 1000).toFixed(1)}s`;
+  } else {
+    const minutes = Math.floor(ms / 60000);
+    const seconds = Math.floor(ms % 60000 / 1000);
+    return `${minutes}m ${seconds}s`;
+  }
+}
+
 // src/index.ts
-var indigo12 = colors.primary;
+var indigo13 = colors.primary;
 var program2 = new Command;
-program2.name("skills").description("CLI for skills.md - AI Agent Skills Marketplace").version("0.1.37");
+program2.name("skills").description("CLI for skills.md - AI Agent Skills Marketplace").version("0.1.38");
 program2.command("init").description("Initialize skills.md in current project").option("-f, --force", "Force re-initialization (removes existing .skills/)").action((options) => {
   initCommand({ force: options.force });
 });
@@ -23847,8 +24266,36 @@ program2.command("update [skill]").description("Update installed skills (refresh
 });
 program2.command("upgrade").description("Upgrade the Skills CLI to the latest version").action(upgradeCommand);
 program2.command("doctor").description("Check your environment and diagnose issues").action(doctorCommand);
+var scheduleCmd = program2.command("schedule").description("Schedule skills to run automatically");
+scheduleCmd.command("create <skill> [schedule]").description("Create a new schedule (use natural language or --cron/--at)").option("-c, --cron <expression>", "Cron expression (e.g., '0 9 * * 1' for every Monday at 9am)").option("-a, --at <datetime>", "One-time schedule (ISO 8601 format)").option("--command <command>", "Skill command to run").option("-t, --timezone <timezone>", "Timezone (default: UTC)").option("-m, --max-runs <number>", "Maximum number of runs").option("-n, --name <name>", "Schedule name").action((skill, schedule, options) => {
+  scheduleCreateCommand(skill, schedule, {
+    cron: options.cron,
+    at: options.at,
+    command: options.command,
+    timezone: options.timezone,
+    maxRuns: options.maxRuns ? parseInt(options.maxRuns, 10) : undefined,
+    name: options.name
+  });
+});
+scheduleCmd.command("list").alias("ls").description("List all schedules").option("-s, --status <status>", "Filter by status (active, paused, completed, failed, cancelled)").option("-k, --skill <skill>", "Filter by skill slug").option("-n, --limit <number>", "Limit number of results").action((options) => {
+  scheduleListCommand({
+    status: options.status,
+    skill: options.skill,
+    limit: options.limit ? parseInt(options.limit, 10) : undefined
+  });
+});
+scheduleCmd.command("get <id>").description("Get schedule details").action(scheduleGetCommand);
+scheduleCmd.command("pause <id>").description("Pause a schedule").action(schedulePauseCommand);
+scheduleCmd.command("resume <id>").description("Resume a paused schedule").action(scheduleResumeCommand);
+scheduleCmd.command("cancel <id>").description("Cancel a schedule").action(scheduleCancelCommand);
+scheduleCmd.command("history <id>").description("View run history for a schedule").option("-s, --status <status>", "Filter by run status").option("-n, --limit <number>", "Limit number of results").action((id, options) => {
+  scheduleHistoryCommand(id, {
+    status: options.status,
+    limit: options.limit ? parseInt(options.limit, 10) : undefined
+  });
+});
 program2.addHelpText("after", `
-${indigo12.bold("Examples:")}
+${indigo13.bold("Examples:")}
   ${source_default.dim("# Initialize in current project")}
   $ skills init
 
@@ -23913,7 +24360,23 @@ ${indigo12.bold("Examples:")}
   ${source_default.dim("# Check environment")}
   $ skills doctor
 
-${indigo12.bold("Documentation:")}
-  ${indigo12("https://skills.md/docs")}
+  ${source_default.dim("# Schedule a skill (natural language)")}
+  $ skills schedule create calendar-events "every Monday at 9am" --command list
+  $ skills schedule create linear-issues "daily at midnight" --command sync
+
+  ${source_default.dim("# Schedule a skill (cron expression)")}
+  $ skills schedule create calendar-events --cron "0 9 * * 1-5" --command list
+
+  ${source_default.dim("# Schedule a one-time run")}
+  $ skills schedule create compose-gmail --at "2025-01-15T09:00:00"
+
+  ${source_default.dim("# Manage schedules")}
+  $ skills schedule list
+  $ skills schedule pause <id>
+  $ skills schedule resume <id>
+  $ skills schedule history <id>
+
+${indigo13.bold("Documentation:")}
+  ${indigo13("https://skills.md/docs")}
 `);
 program2.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasnatools/skills",
-  "version": "0.1.37",
+  "version": "0.1.38",
   "description": "CLI for skills.md - AI Agent Skills Marketplace",
   "type": "module",
   "bin": {