trakt-tools 1.6.1 → 1.8.0

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trakt-tools",
-  "version": "1.6.1",
+  "version": "1.8.0",
   "description": "OpenClaw plugin for Trakt.tv - track movies and TV shows",
   "type": "module",
   "openclaw": {

package/src/index.ts

@@ -81,6 +81,24 @@ const TOOLS: ToolDef[] = [
 			),
 		}),
 	},
+	{
+		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',
@@ -96,6 +114,61 @@ const TOOLS: ToolDef[] = [
 			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 — 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',
@@ -208,6 +281,26 @@ function buildCliArgs(
 		}
 	}
 
+	// Title-array commands (watchlist add/remove, history remove) all share
+	// the same shape: search by title, POST the matches. Only `history add`
+	// needs special handling for --watched-at.
+	const titleArrayCommands: Array<[string, string]> = [
+		['watchlist', 'add'],
+		['watchlist', 'remove'],
+		['history', 'remove'],
+	];
+	if (titleArrayCommands.some(([c, s]) => c === command && s === subcommand)) {
+		const titles = params.titles as string[] | undefined;
+		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 = new Set(['query', 'titles']);
 	for (const [key, value] of Object.entries(params)) {
 		if (skipKeys.has(key) || value === undefined || value === null || value === false) continue;