trakt-tools 1.8.5 → 1.8.10

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import * as openclaw_plugin_sdk_core from 'openclaw/plugin-sdk/core';
+import * as openclaw_plugin_sdk from 'openclaw/plugin-sdk';
+
+/**
+ * OpenClaw plugin entry for trakt-cli.
+ *
+ * Registers tools that shell out to the `trakt-cli` binary.
+ * Each tool maps to a CLI subcommand (search, history, watchlist, progress).
+ */
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: openclaw_plugin_sdk.OpenClawPluginConfigSchema;
+    register: NonNullable<openclaw_plugin_sdk_core.OpenClawPluginDefinition["register"]>;
+} & Pick<openclaw_plugin_sdk_core.OpenClawPluginDefinition, "kind">;
+
+export { _default as default };

package/dist/index.js

@@ -0,0 +1,342 @@
+// src/index.ts
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { Type } from "@sinclair/typebox";
+import { execFileSync, execFile } from "child_process";
+import { promisify } from "util";
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var execFileAsync = promisify(execFile);
+var TOOLS = [
+  {
+    name: "trakt_search",
+    command: "search",
+    description: "Search Trakt.tv for movies and TV shows. Returns title, year, trakt_id, and imdb.",
+    parameters: Type.Object({
+      query: Type.String({ description: "Search query (movie or show title)" }),
+      type: Type.Optional(
+        Type.Union(
+          [Type.Literal("movie"), Type.Literal("show"), Type.Literal("movie,show")],
+          { description: "Filter by type (default: movie,show)" }
+        )
+      )
+    })
+  },
+  {
+    name: "trakt_history",
+    command: "history",
+    description: "View Trakt.tv watch history. Returns recently watched movies and episodes with timestamps.",
+    parameters: Type.Object({
+      type: Type.Optional(
+        Type.Union([Type.Literal("movies"), Type.Literal("shows")], {
+          description: "Filter by type"
+        })
+      ),
+      limit: Type.Optional(Type.Number({ description: "Items per page (default 10)" })),
+      page: Type.Optional(Type.Number({ description: "Page number" }))
+    })
+  },
+  {
+    name: "trakt_history_add",
+    command: "history",
+    subcommand: "add",
+    description: "Mark movies or shows as watched on Trakt.tv. Searches by title and adds to history. Accepts multiple titles.",
+    parameters: Type.Object({
+      titles: Type.Array(Type.String(), { description: "Title(s) to mark as watched" }),
+      type: Type.Optional(
+        Type.Union([Type.Literal("movie"), Type.Literal("show")], {
+          description: "Content type (default: show)"
+        })
+      ),
+      watched_at: Type.Optional(
+        Type.String({
+          description: "When watched (YYYY-MM-DD or RFC3339, defaults to now)"
+        })
+      )
+    })
+  },
+  {
+    name: "trakt_history_remove",
+    command: "history",
+    subcommand: "remove",
+    description: "Remove movies or shows from Trakt.tv watch history (undo a mark-as-watched). Searches by title; removing a show wipes ALL its episode plays, removing a movie wipes all its watches. There is no per-watch granular removal.",
+    parameters: Type.Object({
+      titles: Type.Array(Type.String(), {
+        description: "Title(s) to remove from history",
+        minItems: 1
+      }),
+      type: Type.Optional(
+        Type.Union([Type.Literal("movie"), Type.Literal("show")], {
+          description: "Content type (default: show)"
+        })
+      )
+    })
+  },
+  {
+    name: "trakt_watchlist",
+    command: "watchlist",
+    description: "View Trakt.tv watchlist. Returns items the user wants to watch, with type, title, year, and added date.",
+    parameters: Type.Object({
+      type: Type.Optional(
+        Type.Union([Type.Literal("movies"), Type.Literal("shows")], {
+          description: "Filter by type"
+        })
+      ),
+      limit: Type.Optional(Type.Number({ description: "Items per page (default 10)" })),
+      page: Type.Optional(Type.Number({ description: "Page number" }))
+    })
+  },
+  {
+    name: "trakt_watchlist_add",
+    command: "watchlist",
+    subcommand: "add",
+    description: "Add movies or shows to the Trakt.tv watchlist. Searches by title and queues matches in one sync call. Accepts multiple titles. Items already on the list are reported under `existing_*` counts.",
+    parameters: Type.Object({
+      titles: Type.Array(Type.String(), {
+        description: "Title(s) to add to the watchlist",
+        minItems: 1
+      }),
+      type: Type.Optional(
+        Type.Union([Type.Literal("movie"), Type.Literal("show")], {
+          description: "Content type (default: show)"
+        })
+      )
+    })
+  },
+  {
+    name: "trakt_watchlist_remove",
+    command: "watchlist",
+    subcommand: "remove",
+    description: "Remove movies or shows from the Trakt.tv watchlist. Searches by title and removes matches in one sync call. Accepts multiple titles. Items that were not on the list are silent no-ops (deleted_*=0).",
+    parameters: Type.Object({
+      titles: Type.Array(Type.String(), {
+        description: "Title(s) to remove from the watchlist",
+        minItems: 1
+      }),
+      type: Type.Optional(
+        Type.Union([Type.Literal("movie"), Type.Literal("show")], {
+          description: "Content type (default: show)"
+        })
+      )
+    })
+  },
+  {
+    name: "trakt_calendar",
+    command: "calendar",
+    description: 'Show upcoming episodes of shows you watch. Returns forward-looking airings within a date window. Use for proactive "what airs next?" workflows \u2014 this is the only trakt tool that returns future data.',
+    parameters: Type.Object({
+      days: Type.Optional(
+        Type.Number({ description: "Number of days to look ahead (default 7)" })
+      ),
+      start: Type.Optional(
+        Type.String({ description: "Start date YYYY-MM-DD (defaults to today)" })
+      ),
+      new: Type.Optional(
+        Type.Boolean({
+          description: "Only return series premieres (S01E01 airings)"
+        })
+      )
+    })
+  },
+  {
+    name: "trakt_progress",
+    command: "progress",
+    description: "Show progress of watchlist TV shows. Returns in-progress shows with episode counts, percentage, and next episode to watch.",
+    parameters: Type.Object({
+      all: Type.Optional(
+        Type.Boolean({
+          description: "Include not_started and completed shows (default: in-progress only)"
+        })
+      )
+    })
+  },
+  {
+    name: "trakt_auth",
+    command: "auth",
+    description: "Set up Trakt.tv authentication. Initiates OAuth device flow using configured client credentials. Only needed for initial setup.",
+    parameters: Type.Object({})
+  }
+];
+function toolResult(text) {
+  return {
+    content: [{ type: "text", text }],
+    details: void 0
+  };
+}
+function whichBinary(name) {
+  const cmd = process.platform === "win32" ? "where.exe" : "which";
+  try {
+    const result = execFileSync(cmd, [name], { encoding: "utf8" }).trim();
+    const first = result.split("\n")[0]?.trim();
+    return first || null;
+  } catch {
+    return null;
+  }
+}
+function resolveCliPath(config) {
+  if (config?.cliPath && existsSync(config.cliPath)) {
+    return config.cliPath;
+  }
+  const envPath = process.env.TRAKT_CLI_PATH;
+  if (envPath && existsSync(envPath)) {
+    return envPath;
+  }
+  for (const name of ["trakt-cli", "trakt-plugin"]) {
+    const found = whichBinary(name);
+    if (found) return found;
+  }
+  throw new Error(
+    "trakt-cli not found. Install with: go install github.com/omarshahine/trakt-plugin@latest\nOr set TRAKT_CLI_PATH or configure cliPath in plugin settings."
+  );
+}
+function isAuthConfigured() {
+  return existsSync(join(homedir(), ".trakt.yaml"));
+}
+function buildCliArgs(command, subcommand, params, config) {
+  const args = [command];
+  if (command === "auth") {
+    if (config?.clientId) args.push("--client-id", config.clientId);
+    if (config?.clientSecret) args.push("--client-secret", config.clientSecret);
+    return args;
+  }
+  if (subcommand) args.push(subcommand);
+  if (command === "search") {
+    if (params.query) args.push(String(params.query));
+  }
+  if (command === "history" && subcommand === "add") {
+    const titles = params.titles;
+    if (titles) {
+      if (params.type) args.push("--type", String(params.type));
+      if (params.watched_at) args.push("--watched-at", String(params.watched_at));
+      for (const title of titles) {
+        args.push(title);
+      }
+      args.push("--json");
+      return args;
+    }
+  }
+  const titleArrayCommands = [
+    ["watchlist", "add"],
+    ["watchlist", "remove"],
+    ["history", "remove"]
+  ];
+  if (titleArrayCommands.some(([c, s]) => c === command && s === subcommand)) {
+    const titles = params.titles;
+    if (titles) {
+      if (params.type) args.push("--type", String(params.type));
+      for (const title of titles) {
+        args.push(title);
+      }
+      args.push("--json");
+      return args;
+    }
+  }
+  const skipKeys = /* @__PURE__ */ new Set(["query", "titles"]);
+  for (const [key, value] of Object.entries(params)) {
+    if (skipKeys.has(key) || value === void 0 || value === null || value === false) continue;
+    const flag = `--${key.replace(/_/g, "-")}`;
+    if (typeof value === "boolean") {
+      args.push(flag);
+    } else {
+      args.push(flag, String(value));
+    }
+  }
+  args.push("--json");
+  return args;
+}
+var index_default = definePluginEntry({
+  id: "trakt-tools",
+  name: "Trakt",
+  description: "Track movies and TV shows using trakt.tv",
+  register(api) {
+    const config = api.pluginConfig;
+    let cliPath;
+    try {
+      cliPath = resolveCliPath(config);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      for (const tool of TOOLS) {
+        api.registerTool({
+          name: tool.name,
+          label: tool.name,
+          description: tool.description,
+          parameters: tool.parameters,
+          async execute() {
+            return toolResult(
+              JSON.stringify({ success: false, error: errorMessage }, null, 2)
+            );
+          }
+        });
+      }
+      return;
+    }
+    for (const tool of TOOLS) {
+      api.registerTool({
+        name: tool.name,
+        label: tool.name,
+        description: tool.description,
+        parameters: tool.parameters,
+        async execute(_id, params) {
+          if (tool.command !== "auth" && !isAuthConfigured()) {
+            return toolResult(
+              JSON.stringify(
+                {
+                  success: false,
+                  error: "Trakt auth not configured. Run trakt_auth first, or manually: trakt-cli auth --client-id X --client-secret Y"
+                },
+                null,
+                2
+              )
+            );
+          }
+          try {
+            const args = buildCliArgs(tool.command, tool.subcommand, params, config);
+            const { stdout } = await execFileAsync(cliPath, args, {
+              encoding: "utf8",
+              timeout: 12e4,
+              maxBuffer: 4 * 1024 * 1024
+            });
+            let result;
+            try {
+              result = JSON.parse(stdout);
+            } catch {
+              result = { output: stdout.trim() };
+            }
+            return toolResult(JSON.stringify(result, null, 2));
+          } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const stderr = error && typeof error === "object" && "stderr" in error ? String(error.stderr).trim() : "";
+            const errorOutput = stderr ? `${message}
+
+stderr: ${stderr}` : message;
+            const rateLimitMatch = errorOutput.match(
+              /rate limited by trakt api[^\n]*?retry_after=(\d+)/i
+            ) || errorOutput.match(/rate limited by trakt api/i);
+            if (rateLimitMatch) {
+              const retryAfter = rateLimitMatch[1] ? parseInt(rateLimitMatch[1], 10) : null;
+              return toolResult(
+                JSON.stringify(
+                  {
+                    success: false,
+                    rate_limited: true,
+                    retry_after_seconds: retryAfter,
+                    error: "Trakt API rate-limited this request" + (retryAfter != null ? ` (retry after ~${retryAfter}s)` : "") + ". Do NOT retry immediately \u2014 wait out the window before calling any trakt_* tool again, and avoid falling back to other trakt tools (they share the same rate limit bucket).",
+                    raw: errorOutput
+                  },
+                  null,
+                  2
+                )
+              );
+            }
+            return toolResult(
+              JSON.stringify({ success: false, error: errorOutput }, null, 2)
+            );
+          }
+        }
+      });
+    }
+  }
+});
+export {
+  index_default as default
+};

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "trakt-tools",
   "name": "Trakt",
   "description": "Track movies and TV shows using trakt.tv",
-  "version": "1.8.5",
+  "version": "1.8.10",
   "configSchema": {
     "type": "object",
     "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trakt-tools",
-  "version": "1.8.5",
+  "version": "1.8.10",
   "description": "OpenClaw plugin for Trakt.tv - track movies and TV shows",
   "type": "module",
   "openclaw": {
@@ -15,9 +15,10 @@
     }
   },
   "files": [
-    "src/",
+    "dist/",
+    "openclaw.plugin.json",
     "skills/",
-    "openclaw.plugin.json"
+    "src/"
   ],
   "keywords": [
     "openclaw",
@@ -49,10 +50,13 @@
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "tsup": "^8.5.0"
   },
   "scripts": {
     "plugin:check": "npx --yes @openclaw/plugin-inspector inspect --no-openclaw",
-    "plugin:ci": "npx --yes @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute"
-  }
+    "plugin:ci": "npx --yes @openclaw/plugin-inspector ci --no-openclaw --runtime --mock-sdk --allow-execute",
+    "build": "tsup src/index.ts --format esm --out-dir dist --dts --clean --target node20"
+  },
+  "main": "./dist/index.js"
 }