@carrierllc/mcp 0.1.0 → 0.2.0

package/dist/manus-schedule.js

@@ -0,0 +1,213 @@
+/**
+ * Manus Schedule API v2 client.
+ *
+ * Endpoints (Manus open.manus.ai/docs/v2 dot-notation pattern):
+ *   POST /v2/schedule.create  — create a recurring scheduled agent run
+ *   GET  /v2/schedule.list    — list all schedules for this API key
+ *   POST /v2/schedule.delete  — delete a schedule by ID
+ *   POST /v2/schedule.pause   — pause a schedule
+ *   POST /v2/schedule.resume  — resume a paused schedule
+ *
+ * Auth: `x-manus-api-key` header (same pattern as task.create).
+ */
+import { MANUS_API_BASE } from "./manus-common.js";
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+export class ManusScheduleError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "ManusScheduleError";
+    }
+}
+// ---------------------------------------------------------------------------
+// Cron validation
+// Minimum interval: 5 minutes. Expands the minute field (lists, ranges,
+// steps, */N) and rejects if any adjacent firing gap (including wrap) is < 5.
+// ---------------------------------------------------------------------------
+/**
+ * Expands the minute field into sorted unique minutes 0–59, or null if unsupported.
+ */
+function expandCronMinuteField(minuteField) {
+    if (minuteField === "*" || minuteField.includes(" ")) {
+        return null;
+    }
+    const tokens = minuteField.split(",").map((t) => t.trim()).filter(Boolean);
+    const set = new Set();
+    for (const token of tokens) {
+        const stepWildcard = /^[*]\/(\d+)$/.exec(token);
+        if (stepWildcard) {
+            const step = parseInt(stepWildcard[1] ?? "0", 10);
+            if (step < 1)
+                return null;
+            for (let m = 0; m < 60; m += step)
+                set.add(m);
+            continue;
+        }
+        const rangeWithStep = /^(\d+)-(\d+)\/(\d+)$/.exec(token);
+        if (rangeWithStep) {
+            const start = parseInt(rangeWithStep[1] ?? "0", 10);
+            const end = parseInt(rangeWithStep[2] ?? "0", 10);
+            const step = parseInt(rangeWithStep[3] ?? "0", 10);
+            if (step < 1 || start > end)
+                return null;
+            for (let m = start; m <= end; m += step)
+                set.add(m);
+            continue;
+        }
+        const rangeOnly = /^(\d+)-(\d+)$/.exec(token);
+        if (rangeOnly) {
+            const start = parseInt(rangeOnly[1] ?? "0", 10);
+            const end = parseInt(rangeOnly[2] ?? "0", 10);
+            if (start > end)
+                return null;
+            for (let m = start; m <= end; m++)
+                set.add(m);
+            continue;
+        }
+        const single = /^(\d+)$/.exec(token);
+        if (single) {
+            set.add(parseInt(single[1] ?? "0", 10));
+            continue;
+        }
+        return null;
+    }
+    const arr = Array.from(set).sort((a, b) => a - b);
+    for (const v of arr) {
+        if (v < 0 || v > 59)
+            return null;
+    }
+    return arr;
+}
+function minuteFieldViolatesFiveMinuteRule(minuteField, fullCron) {
+    const minutes = expandCronMinuteField(minuteField);
+    if (minutes === null) {
+        return (`Cron expression rejected: unrecognized or unsupported minute field '${minuteField}'. ` +
+            "Minimum interval is 5 minutes; use lists, ranges with step ≥ 5, or */5 or higher.");
+    }
+    if (minutes.length === 0) {
+        return `Cron expression rejected: minute field '${minuteField}' expands to no valid minutes.`;
+    }
+    if (minutes.length === 1) {
+        return null;
+    }
+    for (let i = 1; i < minutes.length; i++) {
+        const gap = (minutes[i] ?? 0) - (minutes[i - 1] ?? 0);
+        if (gap < 5) {
+            return (`Cron expression rejected: '${fullCron}' implies a ${gap}-minute gap in the minute field. ` +
+                "Minimum allowed interval is 5 minutes.");
+        }
+    }
+    const wrapGap = 60 - (minutes[minutes.length - 1] ?? 0) + (minutes[0] ?? 0);
+    if (wrapGap < 5) {
+        return (`Cron expression rejected: '${fullCron}' implies a ${wrapGap}-minute wraparound gap in the minute field. ` +
+            "Minimum allowed interval is 5 minutes.");
+    }
+    return null;
+}
+/**
+ * Returns an error string if the cron expression is invalid or too frequent,
+ * or null if it's acceptable.
+ *
+ * Rules:
+ *   - Must have exactly 5 fields (standard cron, no seconds).
+ *   - Minute field must not be `*` (would run every minute).
+ *   - The minute field is expanded (including star/N steps, a-b ranges, a-b/c
+ *     range-steps, and comma unions); every gap between consecutive runs within
+ *     the hour, and the wrap gap to the next hour, must be at least 5 minutes.
+ */
+export function validateCron(cron) {
+    const parts = cron.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        return `Invalid cron expression: expected 5 fields (minute hour day month weekday), got ${parts.length}.`;
+    }
+    const [minuteField] = parts;
+    if (minuteField === "*") {
+        return "Cron expression rejected: '* * * * *' runs every minute. Minimum allowed interval is 5 minutes.";
+    }
+    return minuteFieldViolatesFiveMinuteRule(minuteField ?? "", cron);
+}
+// ---------------------------------------------------------------------------
+// API functions
+// ---------------------------------------------------------------------------
+export async function createSchedule(apiKey, params) {
+    const body = {
+        name: params.name,
+        cron: params.cron,
+        prompt_template: params.prompt_template,
+        agent_profile: params.agent_profile ?? "manus-1.6-lite",
+        interactive_mode: false,
+        hide_in_task_list: false,
+    };
+    const res = await fetch(`${MANUS_API_BASE}/schedule.create`, {
+        method: "POST",
+        headers: {
+            "x-manus-api-key": apiKey,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        throw new ManusScheduleError(`schedule.create failed: HTTP ${res.status}`, res.status);
+    }
+    return (await res.json());
+}
+export async function listSchedules(apiKey) {
+    const res = await fetch(`${MANUS_API_BASE}/schedule.list`, {
+        headers: { "x-manus-api-key": apiKey },
+    });
+    if (!res.ok) {
+        throw new ManusScheduleError(`schedule.list failed: HTTP ${res.status}`, res.status);
+    }
+    const data = (await res.json());
+    // Manus may return a bare array or a wrapped object
+    if (Array.isArray(data)) {
+        return { ok: true, schedules: data };
+    }
+    return data;
+}
+export async function deleteSchedule(apiKey, scheduleId) {
+    const res = await fetch(`${MANUS_API_BASE}/schedule.delete`, {
+        method: "POST",
+        headers: {
+            "x-manus-api-key": apiKey,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ schedule_id: scheduleId }),
+    });
+    if (!res.ok) {
+        throw new ManusScheduleError(`schedule.delete failed: HTTP ${res.status}`, res.status);
+    }
+    return (await res.json());
+}
+export async function pauseSchedule(apiKey, scheduleId) {
+    const res = await fetch(`${MANUS_API_BASE}/schedule.pause`, {
+        method: "POST",
+        headers: {
+            "x-manus-api-key": apiKey,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ schedule_id: scheduleId }),
+    });
+    if (!res.ok) {
+        throw new ManusScheduleError(`schedule.pause failed: HTTP ${res.status}`, res.status);
+    }
+    return (await res.json());
+}
+export async function resumeSchedule(apiKey, scheduleId) {
+    const res = await fetch(`${MANUS_API_BASE}/schedule.resume`, {
+        method: "POST",
+        headers: {
+            "x-manus-api-key": apiKey,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ schedule_id: scheduleId }),
+    });
+    if (!res.ok) {
+        throw new ManusScheduleError(`schedule.resume failed: HTTP ${res.status}`, res.status);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=manus-schedule.js.map

package/dist/manus-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manus-schedule.js","sourceRoot":"","sources":["../src/manus-schedule.ts"],"names":[],"mappings":"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"}

package/dist/manus-usage.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Manus Usage/Credits API v2 client.
+ *
+ * Endpoints (open.manus.ai/docs/v2 dot-notation pattern):
+ *   GET /v2/usage.get    — current month's task count + credit spend
+ *   GET /v2/credits.get  — remaining credit balance
+ *
+ * KV cache key: `manus_usage_cache` — 60-second TTL.
+ *
+ * Threshold events emitted to Analytics Engine (AUDIT_LOG):
+ *   remaining_credits < 1000 → warning
+ *   remaining_credits < 100  → critical
+ */
+import type { Env } from "./types.js";
+export declare class ManusUsageError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+export interface ManusUsageData {
+    month: string;
+    spent_credits: number;
+    remaining_credits: number;
+    task_count: number;
+}
+export declare const USAGE_THRESHOLD_WARNING = 1000;
+export declare const USAGE_THRESHOLD_CRITICAL = 100;
+export declare function getUsage(apiKey: string, env: Env): Promise<{
+    data: ManusUsageData;
+    from_cache: boolean;
+}>;
+export declare function emitUsageThresholdIfNeeded(env: Env, data: ManusUsageData): void;
+//# sourceMappingURL=manus-usage.d.ts.map

package/dist/manus-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manus-usage.d.ts","sourceRoot":"","sources":["../src/manus-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC;AAMD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAsCD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AA4D5C,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,GACP,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBxD;AAMD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,cAAc,GACnB,IAAI,CAQN"}

package/dist/manus-usage.js

@@ -0,0 +1,120 @@
+/**
+ * Manus Usage/Credits API v2 client.
+ *
+ * Endpoints (open.manus.ai/docs/v2 dot-notation pattern):
+ *   GET /v2/usage.get    — current month's task count + credit spend
+ *   GET /v2/credits.get  — remaining credit balance
+ *
+ * KV cache key: `manus_usage_cache` — 60-second TTL.
+ *
+ * Threshold events emitted to Analytics Engine (AUDIT_LOG):
+ *   remaining_credits < 1000 → warning
+ *   remaining_credits < 100  → critical
+ */
+import { MANUS_API_BASE } from "./manus-common.js";
+export class ManusUsageError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "ManusUsageError";
+    }
+}
+// ---------------------------------------------------------------------------
+// KV cache
+// ---------------------------------------------------------------------------
+const CACHE_KEY = "manus_usage_cache";
+const CACHE_TTL_SECONDS = 60;
+// ---------------------------------------------------------------------------
+// Threshold constants
+// ---------------------------------------------------------------------------
+export const USAGE_THRESHOLD_WARNING = 1000;
+export const USAGE_THRESHOLD_CRITICAL = 100;
+// ---------------------------------------------------------------------------
+// Fetch from Manus API
+// ---------------------------------------------------------------------------
+async function fetchUsageFromApi(apiKey) {
+    const now = new Date();
+    const month = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, "0")}`;
+    // Fetch usage + credits in parallel
+    const [usageRes, creditsRes] = await Promise.all([
+        fetch(`${MANUS_API_BASE}/usage.get`, {
+            headers: { "x-manus-api-key": apiKey },
+        }),
+        fetch(`${MANUS_API_BASE}/credits.get`, {
+            headers: { "x-manus-api-key": apiKey },
+        }),
+    ]);
+    if (!usageRes.ok && !creditsRes.ok) {
+        throw new ManusUsageError(`Manus usage APIs failed: usage.get HTTP ${usageRes.status}, credits.get HTTP ${creditsRes.status}`, Math.max(usageRes.status, creditsRes.status));
+    }
+    let spentCredits = 0;
+    let remainingCredits = 0;
+    let taskCount = 0;
+    if (usageRes.ok) {
+        const usageData = (await usageRes.json());
+        spentCredits = usageData.spent_credits ?? usageData.credits_used ?? 0;
+        taskCount = usageData.task_count ?? usageData.tasks_run ?? 0;
+        // usage.get may also return remaining_credits
+        if (usageData.remaining_credits !== undefined || usageData.credits_remaining !== undefined) {
+            remainingCredits = usageData.remaining_credits ?? usageData.credits_remaining ?? 0;
+        }
+    }
+    if (creditsRes.ok) {
+        const creditsData = (await creditsRes.json());
+        // credits.get is the authoritative source for remaining balance
+        const fromCreditsApi = creditsData.remaining_credits ??
+            creditsData.credits_remaining ??
+            creditsData.balance;
+        if (fromCreditsApi !== undefined) {
+            remainingCredits = fromCreditsApi;
+        }
+    }
+    return { month, spent_credits: spentCredits, remaining_credits: remainingCredits, task_count: taskCount };
+}
+// ---------------------------------------------------------------------------
+// Public: getUsage — with KV cache
+// ---------------------------------------------------------------------------
+export async function getUsage(apiKey, env) {
+    // Check KV cache
+    const cached = await env.CARRIER_USERS.get(CACHE_KEY, "json");
+    const nowMs = Date.now();
+    if (cached && nowMs - cached.fetched_at < CACHE_TTL_SECONDS * 1000) {
+        return { data: cached.data, from_cache: true };
+    }
+    // Fetch fresh data
+    const data = await fetchUsageFromApi(apiKey);
+    // Write to KV with TTL
+    await env.CARRIER_USERS.put(CACHE_KEY, JSON.stringify({ data, fetched_at: nowMs }), { expirationTtl: CACHE_TTL_SECONDS });
+    return { data, from_cache: false };
+}
+// ---------------------------------------------------------------------------
+// Threshold check — emits AE events on warning/critical
+// ---------------------------------------------------------------------------
+export function emitUsageThresholdIfNeeded(env, data) {
+    const { remaining_credits, month, task_count } = data;
+    if (remaining_credits < USAGE_THRESHOLD_CRITICAL) {
+        writeUsageThresholdAudit(env, "critical", remaining_credits, month, task_count);
+    }
+    else if (remaining_credits < USAGE_THRESHOLD_WARNING) {
+        writeUsageThresholdAudit(env, "warning", remaining_credits, month, task_count);
+    }
+}
+function writeUsageThresholdAudit(env, severity, remainingCredits, month, taskCount) {
+    try {
+        env.AUDIT_LOG.writeDataPoint({
+            blobs: [
+                "manus_usage_threshold",
+                severity,
+                month,
+                String(taskCount),
+            ],
+            doubles: [remainingCredits],
+            indexes: ["manus_usage"],
+        });
+    }
+    catch (err) {
+        console.error(`[manus-usage] threshold audit write failed: ${err.message}`);
+    }
+}
+//# sourceMappingURL=manus-usage.js.map

package/dist/manus-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manus-usage.js","sourceRoot":"","sources":["../src/manus-usage.ts"],"names":[],"mappings":"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"}

package/dist/manus-webhook.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Manus webhook receiver.
+ *
+ * Receives push notifications from Manus for UI-agent tasks dispatched by
+ * tools-ui-agent.ts. Eliminates the need for client-side polling.
+ *
+ * ROUTE
+ * -----
+ * POST /manus-webhook
+ *
+ * AUTHENTICATION
+ * --------------
+ * Header: X-Manus-Signature: <hex>
+ * Payload: HMAC-SHA256(key=MANUS_WEBHOOK_SECRET, message=raw_request_body)
+ * Format: raw hex string (no "sha256=" prefix — per Manus docs).
+ *
+ * IDEMPOTENCY
+ * -----------
+ * event_id stored in CARRIER_USERS KV under key `manus_event:{event_id}` with
+ * 7-day TTL. Replayed events return 200+deduplicated without re-processing.
+ *
+ * EVENT TYPES
+ * -----------
+ * task_created  — fires immediately after task.create; logged only.
+ * task_stopped  — fires on completion or ask; updates audit log + AE.
+ *   stop_reason:
+ *     "finish" — task completed; attachment URLs logged if present.
+ *                Clears any pending-ask KV entry for this task.
+ *     "ask"    — task paused, waiting for user input.
+ *                Writes manus_pending_ask:{task_id} to CARRIER_USERS KV (24h TTL).
+ *                Emits ui_agent_needs_input AE event with truncated question.
+ *
+ * PENDING-ASK KV SCHEMA
+ * ---------------------
+ * Key:   manus_pending_ask:{task_id}
+ * Value: JSON { task_id, question, task_url, asked_at }
+ * TTL:   24 hours (86400 seconds)
+ *
+ * AUDIT LOG SCHEMA (Analytics Engine blobs[]):
+ *   blobs[0] = "manus_webhook"
+ *   blobs[1] = event_type  ("task_created" | "task_stopped")
+ *   blobs[2] = stop_reason ("finish" | "ask" | "ui_agent_awaiting_input" | "")
+ *   blobs[3] = task_id
+ *   blobs[4] = attachment_count (stringified number) or truncated question for ask events
+ *   doubles[0] = latency_ms  (0 for task_created)
+ *   indexes[0] = task_id
+ */
+import type { Env } from "./types.js";
+export interface ManusPendingAsk {
+    task_id: string;
+    question: string;
+    task_url: string;
+    asked_at: string;
+}
+/** 24-hour TTL for pending-ask entries. */
+export declare const PENDING_ASK_TTL_SECONDS: number;
+/** KV key prefix for pending-ask entries. */
+export declare const PENDING_ASK_PREFIX = "manus_pending_ask:";
+export declare function handleManusWebhook(request: Request, env: Env): Promise<Response>;
+//# sourceMappingURL=manus-webhook.d.ts.map

package/dist/manus-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manus-webhook.d.ts","sourceRoot":"","sources":["../src/manus-webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAkDtC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,QAAY,CAAC;AACjD,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAQvD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,QAAQ,CAAC,CAyEnB"}