@hasna/skills 0.1.46 → 0.1.47

package/bin/mcp.js

@@ -6625,7 +6625,8 @@ var init_skill_aliases = __esm(() => {
     "pdf-reader": "read-pdf",
     "generate-image": "image",
     "image-generator": "image",
-    "create-blog-article": "blog-article"
+    "create-blog-article": "blog-article",
+    "skill-diff": "diff-viewer"
   };
 });
 
@@ -7042,7 +7043,7 @@ var init_pricing = __esm(() => {
     { slug: "brand-kit", displayName: "Brand Kit", tier: "premium", costCents: 400, providers: ["hosted"], description: "Hosted brand kit with logo usage, palette, typography, brand voice, sample applications, Markdown guide, PDF guide, and SVG assets" },
     { slug: "generate-book-cover", displayName: "Book Cover", tier: "premium", costCents: 20, providers: ["gpt-image-2"], description: "Professional book cover design from title and genre" },
     { slug: "remove-background", displayName: "Remove Background", tier: "premium", costCents: 10, providers: ["gemini-3-pro"], description: "AI-powered background removal from images" },
-    { slug: "transcript", displayName: "Transcript", tier: "premium", costCents: 10, providers: ["whisper"], description: "Audio/video transcription with timestamps" },
+    { slug: "transcript", displayName: "Transcript", tier: "premium", costCents: 10, providers: ["openai", "elevenlabs", "deepgram", "hosted"], description: "Audio/video transcription with timestamps, diarization, and URL support" },
     { slug: "webcrawling", displayName: "Web Crawling", tier: "premium", costCents: 5, providers: ["firecrawl"], description: "Structured web page crawling and extraction" },
     { slug: "browse", displayName: "Browse", tier: "premium", costCents: 5, providers: ["browser"], description: "Web browsing and page interaction" },
     { slug: "read-pdf", displayName: "Read PDF", tier: "premium", costCents: 5, providers: ["cerebras"], description: "Hosted PDF extraction and structured content analysis" },
@@ -18269,7 +18270,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {}
+  } else if (ctx.target === "openapi-3.0") {} else {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema)?.id;
     if (!id)
@@ -18517,7 +18518,7 @@ var literalProcessor = (schema, ctx, json, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      }
+      } else {}
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -21797,7 +21798,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.46",
+  version: "0.1.47",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -21866,7 +21867,7 @@ var package_default = {
     typescript: "^5"
   },
   dependencies: {
-    "@hasna/events": "^0.1.3",
+    "@hasna/events": "^0.1.7",
     "@modelcontextprotocol/sdk": "^1.26.0",
     chalk: "^5.3.0",
     commander: "^12.1.0",
@@ -31601,9 +31602,9 @@ var MEDIA_PROCESSING_SKILLS = [
   {
     name: "transcript",
     displayName: "Transcript",
-    description: "Generate transcripts from audio and video files with timestamps",
+    description: "Transcribe audio, video, and media URLs with OpenAI GPT-4o, ElevenLabs Scribe v2, DeepGram, or hosted runtime",
     category: "Media Processing",
-    tags: ["transcript", "audio", "video", "speech-to-text"]
+    tags: ["transcript", "audio", "video", "speech-to-text", "diarization", "youtube"]
   },
   {
     name: "video-cut-suggester",
@@ -33047,18 +33048,29 @@ var runOutputSchema = objectSchema({
   exitCode: { type: "number", description: "Process exit code for local runs." },
   skill: stringSchema("Canonical skill slug."),
   remote: { type: "boolean", description: "Whether the skill was submitted to the hosted runtime." },
-  stdout: stringSchema("Captured stdout for local runs."),
-  stderr: stringSchema("Captured stderr for local runs."),
+  stdoutPreview: objectSchema({
+    text: stringSchema("Truncated stdout preview."),
+    length: { type: "number" },
+    truncated: { type: "boolean" }
+  }, [], "Default compact stdout preview."),
+  stderrPreview: objectSchema({
+    text: stringSchema("Truncated stderr preview."),
+    length: { type: "number" },
+    truncated: { type: "boolean" }
+  }, [], "Default compact stderr preview."),
+  stdout: stringSchema("Captured stdout for local runs when detail:true is requested."),
+  stderr: stringSchema("Captured stderr for local runs when detail:true is requested."),
   id: stringSchema("Remote run id when submitted remotely."),
   localRunId: stringSchema("Local run metadata id."),
   status: stringSchema("Run lifecycle status."),
   pricing: pricingSchema,
-  remoteRun: objectSchema({}, [], "Normalized hosted remote run contract.", true),
-  run: objectSchema({}, [], "Local run metadata.", true),
+  remoteRun: objectSchema({}, [], "Compact hosted remote run summary by default; full contract when detail:true is requested.", true),
+  run: objectSchema({}, [], "Compact local run metadata by default; full metadata when detail:true is requested.", true),
   nextActions: objectSchema({
     poll: stringSchema("Command to poll run status."),
     download: stringSchema("Command to download artifacts.")
-  })
+  }),
+  detailHint: stringSchema("How to request the complete payload.")
 }, [], "Skill run result.");
 var toolContracts = [
   {
@@ -33106,7 +33118,7 @@ var toolContracts = [
   {
     name: "list_skills",
     title: "List Skills",
-    description: "List skills from the basic or full registry profile.",
+    description: "List skills from the basic or full registry profile. Returns a compact paged envelope by default.",
     params: ["category?", "profile?", "detail?", "limit?", "offset?"],
     category: "discovery",
     sideEffects: "none",
@@ -33122,7 +33134,11 @@ var toolContracts = [
       skills: arraySchema(skillSummarySchema),
       total: { type: "number" },
       offset: { type: "number" },
-      limit: { type: "number" }
+      limit: { type: "number" },
+      nextOffset: { type: "number" },
+      hasMore: { type: "boolean" },
+      nextArguments: objectSchema({}, [], "Arguments for the next page.", true),
+      detailHint: stringSchema("How to request fuller skill objects.")
     })
   },
   {
@@ -33143,7 +33159,7 @@ var toolContracts = [
   {
     name: "search_skills",
     title: "Search Skills",
-    description: "Search skills by name, description, or tags.",
+    description: "Search skills by name, description, or tags. Returns a compact paged envelope by default.",
     params: ["query", "profile?", "detail?", "limit?", "offset?"],
     category: "discovery",
     sideEffects: "none",
@@ -33155,7 +33171,16 @@ var toolContracts = [
       limit: { type: "number", minimum: 0 },
       offset: { type: "number", minimum: 0 }
     }, ["query"]),
-    outputSchema: objectSchema({ skills: arraySchema(skillSummarySchema) })
+    outputSchema: objectSchema({
+      skills: arraySchema(skillSummarySchema),
+      total: { type: "number" },
+      offset: { type: "number" },
+      limit: { type: "number" },
+      nextOffset: { type: "number" },
+      hasMore: { type: "boolean" },
+      nextArguments: objectSchema({}, [], "Arguments for the next page.", true),
+      detailHint: stringSchema("How to request fuller skill objects.")
+    })
   },
   {
     name: "get_skill_info",
@@ -33272,8 +33297,8 @@ var toolContracts = [
   {
     name: "run_skill",
     title: "Run Skill",
-    description: "Run a skill locally or through a configured remote runner.",
-    params: ["name", "input?", "args?", "approved?"],
+    description: "Run a skill locally or through a configured remote runner. Returns compact stdout/stderr previews and run summaries by default; pass detail:true for full records.",
+    params: ["name", "input?", "args?", "approved?", "detail?"],
     category: "execution",
     sideEffects: "local-process-or-remote-run",
     stable: true,
@@ -33281,28 +33306,33 @@ var toolContracts = [
       name: skillNameInput,
       input: runInputSchema,
       args: runArgsSchema,
-      approved: paidRunApprovalSchema
+      approved: paidRunApprovalSchema,
+      detail: { type: "boolean", default: false, description: "Return full stdout/stderr, remote run, and local run metadata." }
     }, ["name"]),
     outputSchema: runOutputSchema
   },
   {
     name: "get_run_status",
     title: "Get Run Status",
-    description: "Fetch remote run status and next actions.",
-    params: ["run_id"],
+    description: "Fetch remote run status and next actions. Returns a compact status summary by default; pass detail:true for the complete remote run payload.",
+    params: ["run_id", "detail?"],
     category: "execution",
     sideEffects: "none",
     stable: true,
-    inputSchema: objectSchema({ run_id: stringSchema("Remote or local run id.") }, ["run_id"]),
+    inputSchema: objectSchema({
+      run_id: stringSchema("Remote or local run id."),
+      detail: { type: "boolean", default: false, description: "Return the complete remote run payload." }
+    }, ["run_id"]),
     outputSchema: objectSchema({
       contractVersion: { type: "number", description: "Remote run payload contract version." },
       runId: stringSchema("Remote run id."),
       localRunId: stringSchema("Local run id."),
-      run: objectSchema({}, [], "Normalized remote run status.", true),
+      run: objectSchema({}, [], "Compact remote run status by default; full status when detail:true is requested.", true),
       nextActions: objectSchema({
         poll: stringSchema("Command to poll run status."),
         download: stringSchema("Command to download artifacts.")
-      })
+      }),
+      detailHint: stringSchema("How to request the complete payload.")
     })
   },
   {
@@ -33397,13 +33427,25 @@ var toolContracts = [
   {
     name: "list_schedules",
     title: "List Schedules",
-    description: "List scheduled skill runs.",
-    params: [],
+    description: "List scheduled skill runs as a compact paged envelope.",
+    params: ["limit?", "offset?"],
     category: "scheduling",
     sideEffects: "none",
     stable: true,
-    inputSchema: objectSchema(),
-    outputSchema: arraySchema(objectSchema({}, [], "Schedule record.", true))
+    inputSchema: objectSchema({
+      limit: { type: "number", minimum: 0 },
+      offset: { type: "number", minimum: 0 }
+    }),
+    outputSchema: objectSchema({
+      schedules: arraySchema(objectSchema({}, [], "Compact schedule record.", true)),
+      total: { type: "number" },
+      offset: { type: "number" },
+      limit: { type: "number" },
+      nextOffset: { type: "number" },
+      hasMore: { type: "boolean" },
+      nextArguments: objectSchema({}, [], "Arguments for the next page.", true),
+      detailHint: stringSchema("How to request complete schedule details.")
+    })
   },
   {
     name: "remove_schedule",
@@ -33810,6 +33852,90 @@ function resolveDiscoveryPricing(skill) {
   return skill.pricing && typeof skill.pricing.formattedCost === "string" ? skill.pricing : getPublicSkillPricing(skill.name);
 }
 
+// src/lib/compact-output.ts
+var DEFAULT_MCP_LIMIT = 25;
+var MAX_PAGE_LIMIT = 200;
+var DEFAULT_PREVIEW_CHARS = 600;
+function truncateText(value, maxChars = 96) {
+  const text = String(value ?? "").replace(/\s+/g, " ").trim();
+  if (text.length <= maxChars)
+    return text;
+  return `${text.slice(0, Math.max(0, maxChars - 3)).trimEnd()}...`;
+}
+function previewText(value, maxChars = DEFAULT_PREVIEW_CHARS) {
+  const text = String(value ?? "");
+  return {
+    text: text.length > maxChars ? `${text.slice(0, Math.max(0, maxChars - 3))}...` : text,
+    length: text.length,
+    truncated: text.length > maxChars
+  };
+}
+function parsePageLimit(value, fallback, options = {}) {
+  const max = options.max ?? MAX_PAGE_LIMIT;
+  if (typeof value === "string" && options.allowAll && value.trim().toLowerCase() === "all") {
+    return Number.POSITIVE_INFINITY;
+  }
+  const parsed = typeof value === "number" ? value : Number.parseInt(value ?? "", 10);
+  if (!Number.isFinite(parsed))
+    return fallback;
+  if (options.allowAll && parsed === 0)
+    return Number.POSITIVE_INFINITY;
+  if (parsed <= 0)
+    return fallback;
+  return Math.min(parsed, max);
+}
+function parsePageOffset(value, fallback = 0) {
+  const parsed = typeof value === "number" ? value : Number.parseInt(value ?? "", 10);
+  if (!Number.isFinite(parsed) || parsed < 0)
+    return fallback;
+  return parsed;
+}
+function paginate(items, options) {
+  const offset = Math.min(parsePageOffset(options.offset), items.length);
+  const effectiveLimit = Number.isFinite(options.limit) ? Math.max(0, Math.min(options.limit, MAX_PAGE_LIMIT)) : Math.max(0, items.length - offset);
+  const pageItems = items.slice(offset, offset + effectiveLimit);
+  const nextOffset = offset + pageItems.length < items.length ? offset + pageItems.length : null;
+  return {
+    items: pageItems,
+    total: items.length,
+    offset,
+    limit: effectiveLimit,
+    hasMore: nextOffset !== null,
+    nextOffset
+  };
+}
+function compactRunRecord(run) {
+  if (!run || typeof run !== "object")
+    return {};
+  return {
+    id: run.id,
+    skill: run.skill,
+    status: run.status,
+    startedAt: run.startedAt,
+    ...run.completedAt ? { completedAt: run.completedAt } : {},
+    ...run.remoteRunId ? { remoteRunId: run.remoteRunId } : {},
+    ...run.costCents !== undefined ? { costCents: run.costCents } : {},
+    ...run.error ? { error: truncateText(run.error, 240) } : {},
+    artifactCount: Array.isArray(run.artifacts) ? run.artifacts.length : 0,
+    paths: run.paths
+  };
+}
+function compactRemoteRun(run) {
+  if (!run || typeof run !== "object")
+    return {};
+  return {
+    ...run.contractVersion !== undefined ? { contractVersion: run.contractVersion } : {},
+    id: run.id,
+    skill: run.skill ?? run.requestedSlug,
+    status: run.status,
+    ...run.correlationId ? { correlationId: run.correlationId } : {},
+    ...run.createdAt ? { createdAt: run.createdAt } : {},
+    ...run.startedAt ? { startedAt: run.startedAt } : {},
+    ...run.completedAt ? { completedAt: run.completedAt } : {},
+    ...run.error || run.errorMessage ? { error: truncateText(run.error ?? run.errorMessage, 240) } : {}
+  };
+}
+
 // src/mcp/helpers.ts
 function stripNulls(obj) {
   return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== null && v !== undefined && !(Array.isArray(v) && v.length === 0)));
@@ -33858,7 +33984,7 @@ var TOOL_DESCRIPTIONS = getMcpToolDescriptions();
 function registerDiscoveryTools(server) {
   server.registerTool("list_skills", {
     title: "List Skills",
-    description: "List skills with public pricing. Defaults to the clean basic profile to avoid context overflow. Set profile:'all' for the full registry. Returns {name,category,pricing} by default; detail:true for full public objects. Supports limit/offset pagination.",
+    description: "List skills with public pricing. Defaults to a compact paged response from the basic profile to avoid context overflow. Set profile:'all' for the full registry, detail:true for full public objects, and use limit/offset to page.",
     inputSchema: {
       category: exports_external.string().optional(),
       profile: exports_external.enum(["basic", "all"]).optional(),
@@ -33870,16 +33996,20 @@ function registerDiscoveryTools(server) {
     const selectedProfile = profile || "basic";
     const skills = category ? loadRegistryProfile(selectedProfile).filter((s) => s.category === category) : loadRegistryProfile(selectedProfile);
     const mapped = detail ? skills.map(getPublicSkillDiscovery) : skills.map(getCompactSkillDiscovery);
-    if (limit !== undefined || offset !== undefined) {
-      const start = offset || 0;
-      const sliced = limit !== undefined ? mapped.slice(start, start + limit) : mapped.slice(start);
-      return {
-        content: [{ type: "text", text: JSON.stringify({ skills: sliced, total: mapped.length, offset: start, limit: limit ?? null }) }]
-      };
-    }
-    return {
-      content: [{ type: "text", text: JSON.stringify(mapped) }]
-    };
+    const page = paginate(mapped, {
+      limit: parsePageLimit(limit, DEFAULT_MCP_LIMIT, { max: 100 }),
+      offset: parsePageOffset(offset)
+    });
+    return mcpJson({
+      skills: page.items,
+      total: page.total,
+      offset: page.offset,
+      limit: page.limit,
+      nextOffset: page.nextOffset,
+      hasMore: page.hasMore,
+      nextArguments: page.hasMore ? { profile: selectedProfile, category, detail: Boolean(detail), limit: page.limit, offset: page.nextOffset } : null,
+      detailHint: detail ? undefined : "Set detail:true for full public skill objects, or call get_skill_info for one skill."
+    });
   });
   server.registerTool("list_pinned_skills", {
     title: "List Pinned Skills",
@@ -33896,7 +34026,7 @@ function registerDiscoveryTools(server) {
   });
   server.registerTool("search_skills", {
     title: "Search Skills",
-    description: "Search skills by name, description, or tags. Defaults to the clean basic profile; set profile:'all' for the full registry. Returns compact list with pricing by default. Supports limit/offset pagination.",
+    description: "Search skills by name, description, or tags. Defaults to a compact paged response from the basic profile; set profile:'all' for the full registry and detail:true for full public objects.",
     inputSchema: {
       query: exports_external.string(),
       profile: exports_external.enum(["basic", "all"]).optional(),
@@ -33912,16 +34042,20 @@ function registerDiscoveryTools(server) {
     if (!cached2)
       cacheSet(cacheKey, results);
     const out = detail ? results.map(getPublicSkillDiscovery) : results.map(getCompactSkillDiscovery);
-    if (limit !== undefined || offset !== undefined) {
-      const start = offset || 0;
-      const sliced = limit !== undefined ? out.slice(start, start + limit) : out.slice(start);
-      return {
-        content: [{ type: "text", text: JSON.stringify({ skills: sliced, total: out.length, offset: start, limit: limit ?? null }) }]
-      };
-    }
-    return {
-      content: [{ type: "text", text: JSON.stringify(out) }]
-    };
+    const page = paginate(out, {
+      limit: parsePageLimit(limit, DEFAULT_MCP_LIMIT, { max: 100 }),
+      offset: parsePageOffset(offset)
+    });
+    return mcpJson({
+      skills: page.items,
+      total: page.total,
+      offset: page.offset,
+      limit: page.limit,
+      nextOffset: page.nextOffset,
+      hasMore: page.hasMore,
+      nextArguments: page.hasMore ? { query, profile: selectedProfile, detail: Boolean(detail), limit: page.limit, offset: page.nextOffset } : null,
+      detailHint: detail ? undefined : "Set detail:true for full public skill objects, or call get_skill_info for one skill."
+    });
   });
   server.registerTool("get_skill_info", {
     title: "Get Skill Info",
@@ -34362,9 +34496,10 @@ function registerOperationTools(server) {
       name: exports_external.string(),
       input: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
       args: exports_external.array(exports_external.string()).optional(),
-      approved: exports_external.boolean().optional()
+      approved: exports_external.boolean().optional(),
+      detail: exports_external.boolean().optional()
     }
-  }, async ({ name, input, args, approved }) => {
+  }, async ({ name, input, args, approved, detail }) => {
     const skill = getSkill(name);
     if (!skill) {
       return mcpError("SKILL_NOT_FOUND", `Skill '${name}' not found`, findSimilarSkills(name));
@@ -34430,7 +34565,7 @@ function registerOperationTools(server) {
         });
         writeRunLogs(runContext, "", "");
         const remoteRunId = typeof run.id === "string" ? run.id : undefined;
-        return mcpJson({
+        const payload2 = {
           contractVersion: REMOTE_SKILL_RUN_CONTRACT_VERSION,
           id: run.id,
           localRunId: localRun2.id,
@@ -34441,7 +34576,8 @@ function registerOperationTools(server) {
           remoteRun: run,
           run: localRun2,
           nextActions: remoteRunNextActions(remoteRunId)
-        });
+        };
+        return mcpJson(detail ? payload2 : compactRunToolPayload(payload2, "Call run_skill again with detail:true for full remote/local run records."));
       } catch (err) {
         const error48 = `Hosted skill ${skillName} requires hosted access: ${err.message}`;
         writeRunLogs(runContext, "", error48 + `
@@ -34463,23 +34599,23 @@ function registerOperationTools(server) {
       status: result.exitCode === 0 ? "completed" : "failed",
       error: result.error
     });
+    const payload = { exitCode: result.exitCode, skill: skillName, stdout: result.stdout, stderr: result.stderr, run: localRun };
     if (result.error) {
       return {
-        content: [{ type: "text", text: JSON.stringify({ exitCode: result.exitCode, error: result.error, run: localRun }, null, 2) }],
+        content: [{ type: "text", text: JSON.stringify(detail ? { ...payload, error: result.error } : compactRunToolPayload({ ...payload, error: result.error }, "Call run_skill again with detail:true for full stdout/stderr and run metadata.")) }],
         isError: true
       };
     }
-    return {
-      content: [{ type: "text", text: JSON.stringify({ exitCode: result.exitCode, skill: skillName, stdout: result.stdout, stderr: result.stderr, run: localRun }, null, 2) }]
-    };
+    return mcpJson(detail ? payload : compactRunToolPayload(payload, "Call run_skill again with detail:true for full stdout/stderr and run metadata."));
   });
   server.registerTool("get_run_status", {
     title: "Get Run Status",
     description: "Fetch remote run status. Accepts a remote run id or a local run id linked to a remote run.",
     inputSchema: {
-      run_id: exports_external.string()
+      run_id: exports_external.string(),
+      detail: exports_external.boolean().optional()
     }
-  }, async ({ run_id }) => {
+  }, async ({ run_id, detail }) => {
     const { getApiKey: getApiKey2 } = await Promise.resolve().then(() => (init_auth_store(), exports_auth_store));
     const apiKey = getApiKey2();
     if (!apiKey) {
@@ -34496,12 +34632,20 @@ function registerOperationTools(server) {
       const run = await client.getRun(remoteRunId);
       if (!run)
         return mcpError("RUN_NOT_FOUND", `Remote run '${remoteRunId}' not found`);
-      return mcpJson({
+      const payload = {
         contractVersion: REMOTE_SKILL_RUN_CONTRACT_VERSION,
         runId: remoteRunId,
         ...localRun ? { localRunId: localRun.id } : {},
         run,
         nextActions: remoteRunNextActions(remoteRunId)
+      };
+      return mcpJson(detail ? payload : {
+        contractVersion: payload.contractVersion,
+        runId: payload.runId,
+        ...localRun ? { localRunId: localRun.id } : {},
+        run: compactRemoteRun(run),
+        nextActions: payload.nextActions,
+        detailHint: "Call get_run_status with detail:true for the complete remote run payload."
       });
     } catch (err) {
       return mcpError("SKILLS_MD_ERROR", err.message);
@@ -34593,6 +34737,32 @@ function registerOperationTools(server) {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
 }
+function compactRunToolPayload(payload, detailHint) {
+  const stdout = previewText(payload.stdout ?? "");
+  const stderr = previewText(payload.stderr ?? "");
+  return {
+    ...payload.contractVersion !== undefined ? { contractVersion: payload.contractVersion } : {},
+    ...payload.id !== undefined ? { id: payload.id } : {},
+    ...payload.localRunId !== undefined ? { localRunId: payload.localRunId } : {},
+    ...payload.exitCode !== undefined ? { exitCode: payload.exitCode } : {},
+    skill: payload.skill,
+    ...payload.status !== undefined ? { status: payload.status } : {},
+    ...payload.remote !== undefined ? { remote: payload.remote } : {},
+    ...payload.correlationId !== undefined ? { correlationId: payload.correlationId } : {},
+    ...payload.pricing !== undefined ? { pricing: payload.pricing } : {},
+    ...payload.error !== undefined ? { error: payload.error } : {},
+    ...payload.remoteRun !== undefined ? { remoteRun: compactRemoteRun(payload.remoteRun) } : {},
+    run: compactRunRecord(payload.run),
+    stdoutPreview: stdout,
+    stderrPreview: stderr,
+    stdoutChars: stdout.length,
+    stderrChars: stderr.length,
+    stdoutTruncated: stdout.truncated,
+    stderrTruncated: stderr.truncated,
+    ...payload.nextActions !== undefined ? { nextActions: payload.nextActions } : {},
+    detailHint
+  };
+}
 
 // src/lib/feedback.ts
 import { existsSync as existsSync11, mkdirSync as mkdirSync6 } from "fs";
@@ -34951,11 +35121,37 @@ function registerScheduleTools(server) {
   });
   server.registerTool("list_schedules", {
     title: "List Schedules",
-    description: "List all scheduled skill runs.",
-    inputSchema: {}
-  }, async () => {
+    description: "List scheduled skill runs as a compact paged response. Use limit/offset for pagination.",
+    inputSchema: {
+      limit: exports_external.number().optional(),
+      offset: exports_external.number().optional()
+    }
+  }, async ({ limit, offset }) => {
     const schedules = listSchedules();
-    return { content: [{ type: "text", text: JSON.stringify(schedules, null, 2) }] };
+    const page = paginate(schedules, {
+      limit: parsePageLimit(limit, DEFAULT_MCP_LIMIT, { max: 100 }),
+      offset: parsePageOffset(offset)
+    });
+    return mcpJson({
+      schedules: page.items.map((schedule) => ({
+        id: schedule.id,
+        name: schedule.name,
+        skill: schedule.skill,
+        cron: schedule.cron,
+        enabled: schedule.enabled,
+        lastRun: schedule.lastRun,
+        lastRunStatus: schedule.lastRunStatus,
+        nextRun: schedule.nextRun,
+        argCount: schedule.args?.length ?? 0
+      })),
+      total: page.total,
+      offset: page.offset,
+      limit: page.limit,
+      nextOffset: page.nextOffset,
+      hasMore: page.hasMore,
+      nextArguments: page.hasMore ? { limit: page.limit, offset: page.nextOffset } : null,
+      detailHint: "Use schedule state files or future schedule detail commands for complete schedule records."
+    });
   });
   server.registerTool("remove_schedule", {
     title: "Remove Schedule",