@modyo/mcp 0.1.0

package/build/tools/content/jobs/JobStatus.d.ts

@@ -0,0 +1,110 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+/**
+ * Parameter schema for checking job status
+ */
+export declare const ParamsSchema: z.ZodObject<{
+    action: z.ZodDefault<z.ZodEnum<{
+        get: "get";
+        list: "list";
+    }>>;
+    jobId: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        pending: "pending";
+        processing: "processing";
+        completed: "completed";
+    }>>;
+}, z.core.$strip>;
+export type Params = z.infer<typeof ParamsSchema>;
+/**
+ * Tool for checking async job status
+ *
+ * **Actions:**
+ * - `get`: Get status of a specific job
+ * - `list`: List all jobs with optional filters
+ *
+ * **Job Lifecycle:**
+ * 1. `pending` - Job created, waiting to start
+ * 2. `processing` - Job is running
+ * 3. `completed` - Job finished successfully (has result)
+ * 4. `failed` - Job failed (has error)
+ *
+ * **Examples:**
+ *
+ * Get job status:
+ * ```json
+ * {
+ *   "action": "get",
+ *   "jobId": "550e8400-e29b-41d4-a716-446655440000"
+ * }
+ * ```
+ *
+ * Returns:
+ * ```json
+ * {
+ *   "id": "550e8400-e29b-41d4-a716-446655440000",
+ *   "type": "space-copy",
+ *   "status": "processing",
+ *   "progress": {
+ *     "current": 150,
+ *     "total": 500,
+ *     "percentage": 30,
+ *     "message": "Copying entries..."
+ *   },
+ *   "createdAt": "2025-12-12T15:30:00.000Z",
+ *   "updatedAt": "2025-12-12T15:32:00.000Z"
+ * }
+ * ```
+ *
+ * List all jobs:
+ * ```json
+ * {
+ *   "action": "list",
+ *   "type": "space-copy",
+ *   "status": "completed"
+ * }
+ * ```
+ *
+ * Returns:
+ * ```json
+ * {
+ *   "jobs": [
+ *     {
+ *       "id": "...",
+ *       "type": "space-copy",
+ *       "status": "completed",
+ *       "result": { ... },
+ *       "createdAt": "...",
+ *       "updatedAt": "..."
+ *     }
+ *   ],
+ *   "total": 1
+ * }
+ * ```
+ */
+export declare class JobStatusTool extends ToolBase<Params> {
+    protected config: {
+        name: string;
+        description: string;
+        isPublic: boolean;
+    };
+    protected getParamsSchema(): z.ZodObject<{
+        action: z.ZodDefault<z.ZodEnum<{
+            get: "get";
+            list: "list";
+        }>>;
+        jobId: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            failed: "failed";
+            pending: "pending";
+            processing: "processing";
+            completed: "completed";
+        }>>;
+    }, z.core.$strip>;
+    protected execute(params: Params): Promise<CallToolResult>;
+}
+//# sourceMappingURL=JobStatus.d.ts.map

package/build/tools/content/jobs/JobStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobStatus.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/jobs/JobStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAc,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;iBAkCvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,qBAAa,aAAc,SAAQ,QAAQ,CAAC,MAAM,CAAC;IACjD,SAAS,CAAC,MAAM;;;;MAId;IAEF,SAAS,CAAC,eAAe;;;;;;;;;;;;;;cAIT,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAkCjE"}

package/build/tools/content/jobs/JobStatus.js

@@ -0,0 +1,139 @@
+import { jobManager, ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+/**
+ * Parameter schema for checking job status
+ */
+export const ParamsSchema = z.object({
+    /**
+     * Action to perform
+     */
+    action: z
+        .enum([
+        "get",
+        "list",
+    ])
+        .default("get")
+        .describe("get = single job, list = all jobs"),
+    /**
+     * Job ID (required for 'get' action)
+     */
+    jobId: z.string().uuid().optional().describe("Required for 'get' action"),
+    /**
+     * Filter by job type (optional for 'list' action)
+     */
+    type: z.string().optional().describe("Filter by type (e.g., 'space-copy')"),
+    /**
+     * Filter by status (optional for 'list' action)
+     */
+    status: z
+        .enum([
+        "pending",
+        "processing",
+        "completed",
+        "failed",
+    ])
+        .optional()
+        .describe("Filter by status"),
+});
+/**
+ * Tool for checking async job status
+ *
+ * **Actions:**
+ * - `get`: Get status of a specific job
+ * - `list`: List all jobs with optional filters
+ *
+ * **Job Lifecycle:**
+ * 1. `pending` - Job created, waiting to start
+ * 2. `processing` - Job is running
+ * 3. `completed` - Job finished successfully (has result)
+ * 4. `failed` - Job failed (has error)
+ *
+ * **Examples:**
+ *
+ * Get job status:
+ * ```json
+ * {
+ *   "action": "get",
+ *   "jobId": "550e8400-e29b-41d4-a716-446655440000"
+ * }
+ * ```
+ *
+ * Returns:
+ * ```json
+ * {
+ *   "id": "550e8400-e29b-41d4-a716-446655440000",
+ *   "type": "space-copy",
+ *   "status": "processing",
+ *   "progress": {
+ *     "current": 150,
+ *     "total": 500,
+ *     "percentage": 30,
+ *     "message": "Copying entries..."
+ *   },
+ *   "createdAt": "2025-12-12T15:30:00.000Z",
+ *   "updatedAt": "2025-12-12T15:32:00.000Z"
+ * }
+ * ```
+ *
+ * List all jobs:
+ * ```json
+ * {
+ *   "action": "list",
+ *   "type": "space-copy",
+ *   "status": "completed"
+ * }
+ * ```
+ *
+ * Returns:
+ * ```json
+ * {
+ *   "jobs": [
+ *     {
+ *       "id": "...",
+ *       "type": "space-copy",
+ *       "status": "completed",
+ *       "result": { ... },
+ *       "createdAt": "...",
+ *       "updatedAt": "..."
+ *     }
+ *   ],
+ *   "total": 1
+ * }
+ * ```
+ */
+export class JobStatusTool extends ToolBase {
+    config = {
+        name: "content-jobs-manage",
+        description: `Check status of async jobs (space-copy, bulk operations). Use content-spaces-copy to start jobs. 📚 modyo://docs/tools/content-jobs-manage`,
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return ParamsSchema;
+    }
+    async execute(params) {
+        if (params.action === "get") {
+            if (!params.jobId) {
+                return this.errorResponse(new Error("jobId is required for 'get' action"));
+            }
+            const job = jobManager.getJob(params.jobId);
+            if (!job) {
+                return this.errorResponse(new Error(`Job not found: ${params.jobId}`));
+            }
+            return this.success(job);
+        }
+        // List action - build filter options
+        const filter = {};
+        if (params.type !== undefined) {
+            filter.type = params.type;
+        }
+        if (params.status !== undefined) {
+            filter.status = params.status;
+        }
+        const jobs = jobManager.getJobs(filter);
+        return this.success({
+            jobs,
+            total: jobs.length,
+        });
+    }
+}
+//# sourceMappingURL=JobStatus.js.map

package/build/tools/content/jobs/JobStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobStatus.js","sourceRoot":"","sources":["../../../../src/tools/content/jobs/JobStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC;;OAEG;IACH,MAAM,EAAE,CAAC;SACN,IAAI,CAAC;QACJ,KAAK;QACL,MAAM;KACP,CAAC;SACD,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,mCAAmC,CAAC;IAEhD;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAEzE;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAE3E;;OAEG;IACH,MAAM,EAAE,CAAC;SACN,IAAI,CAAC;QACJ,SAAS;QACT,YAAY;QACZ,WAAW;QACX,QAAQ;KACT,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,kBAAkB,CAAC;CAChC,CAAC,CAAC;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAgB;IACvC,MAAM,GAAG;QACjB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,4IAA4I;QACzJ,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEQ,eAAe;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,MAAc;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,aAAa,CACvB,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAChD,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACzE,CAAC;YAED,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAED,qCAAqC;QACrC,MAAM,MAAM,GAGR,EAAE,CAAC;QACP,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAExC,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;IACL,CAAC;CACF"}

package/build/tools/content/jobs/JobsTools.d.ts

@@ -0,0 +1,2 @@
+export declare const JobsTools: Tool[];
+//# sourceMappingURL=JobsTools.d.ts.map

package/build/tools/content/jobs/JobsTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobsTools.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/jobs/JobsTools.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,SAAS,EAAE,IAAI,EAE3B,CAAC"}

package/build/tools/content/jobs/JobsTools.js

@@ -0,0 +1,7 @@
+import { JobStatusTool } from "./JobStatus.js";
+// Export instance for use in tool registration
+const jobStatus = new JobStatusTool();
+export const JobsTools = [
+    jobStatus,
+];
+//# sourceMappingURL=JobsTools.js.map

package/build/tools/content/jobs/JobsTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobsTools.js","sourceRoot":"","sources":["../../../../src/tools/content/jobs/JobsTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,+CAA+C;AAC/C,MAAM,SAAS,GAAG,IAAI,aAAa,EAAE,CAAC;AAEtC,MAAM,CAAC,MAAM,SAAS,GAAW;IAC/B,SAAS;CACV,CAAC"}

package/build/tools/content/spaces/Copy.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    sourceSpaceId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    newName: z.ZodOptional<z.ZodString>;
+    newUid: z.ZodOptional<z.ZodString>;
+    copyTypes: z.ZodDefault<z.ZodBoolean>;
+    copyCategories: z.ZodDefault<z.ZodBoolean>;
+    copyEntries: z.ZodDefault<z.ZodBoolean>;
+    copyAssets: z.ZodDefault<z.ZodBoolean>;
+    entryLimit: z.ZodOptional<z.ZodNumber>;
+    asyncThreshold: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const Copy: Tool;
+export {};
+//# sourceMappingURL=Copy.d.ts.map

package/build/tools/content/spaces/Copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Copy.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/spaces/Copy.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,YAAY;;;;;;;;;;iBAmDhB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AA2/BxD,eAAO,MAAM,IAAI,EAAE,IAA0B,CAAC"}