Release agent kit 0.2.3

Author: taisly

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "taisly-agent-kit",
   "description": "Publish short-form videos to TikTok, Instagram Reels, YouTube Shorts, X, and Facebook from Claude Code through Taisly.",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "author": {
     "name": "Taisly"
   },

README.md

@@ -111,6 +111,17 @@ taisly auth:status
 taisly platforms:list
 ```
 
+Connect a social account from an AI-agent flow:
+
+```bash
+taisly platforms:connect:start --platform instagram
+# Open the returned connectUrl and finish authorization in the browser.
+taisly platforms:connect:check --platform instagram
+taisly platforms:list
+```
+
+Supported connect slugs: `instagram`, `tiktok`, `youtube`, `x`, `facebook`.
+
 Validate a local video before publishing:
 
 ```bash
@@ -194,6 +205,8 @@ Available MCP tools:
 - `taisly_auth_status`
 - `taisly_platforms_list`
 - `taisly_platform_schema`
+- `taisly_platform_connect_start`
+- `taisly_platform_connect_check`
 - `taisly_posts_validate`
 - `taisly_posts_create`
 - `taisly_posts_status`

SKILL.md

@@ -74,6 +74,8 @@ When the MCP server is connected, use these tools instead of shell commands:
 - `taisly_auth_status`
 - `taisly_platforms_list`
 - `taisly_platform_schema`
+- `taisly_platform_connect_start`
+- `taisly_platform_connect_check`
 - `taisly_posts_validate`
 - `taisly_posts_create`
 - `taisly_posts_status`
@@ -87,14 +89,15 @@ When the MCP server is connected, use these tools instead of shell commands:
 2. Wait for the user to finish browser login, then run `taisly_agent_checkin` or `taisly checkin --agent <agent-slug>`.
 3. Run `taisly auth:status`.
 4. Run `taisly platforms:list`.
-5. Match the user's requested platforms to connected platform IDs.
-6. Run `taisly platforms:schema --platform <name>` for constraints.
-7. Run `taisly posts:validate`.
-8. Confirm destination accounts and caption with the user.
-9. Run `taisly posts:create`.
-10. Report the returned `historyId`, scheduled date, and per-platform initial statuses.
-
-For MCP, follow the same sequence with `taisly_auth_status`, `taisly_platforms_list`, `taisly_platform_schema`, `taisly_posts_validate`, `taisly_posts_create`, and `taisly_posts_status`.
+5. If a requested platform is missing and a connect tool is available, run `taisly platforms:connect:start --platform <name>`, give the user the returned `connectUrl`, wait for browser approval, then run `taisly platforms:connect:check --platform <name>`. Supported connect slugs are `instagram`, `tiktok`, `youtube`, `x`, and `facebook`.
+6. Match the user's requested platforms to connected platform IDs.
+7. Run `taisly platforms:schema --platform <name>` for constraints.
+8. Run `taisly posts:validate`.
+9. Confirm destination accounts and caption with the user.
+10. Run `taisly posts:create`.
+11. Report the returned `historyId`, scheduled date, and per-platform initial statuses.
+
+For MCP, follow the same sequence with `taisly_auth_status`, `taisly_platforms_list`, `taisly_platform_connect_start`, `taisly_platform_connect_check`, `taisly_platform_schema`, `taisly_posts_validate`, `taisly_posts_create`, and `taisly_posts_status`.
 
 ## Error Handling
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taisly/agent",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "AI agent social media posting SDK, CLI, Skill, and MCP server for publishing videos to TikTok, Instagram Reels, YouTube Shorts, X, and Facebook through Taisly.",
   "type": "module",
   "main": "src/index.js",

server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/taisly/agent",
     "source": "github"
   },
-  "version": "0.2.1",
+  "version": "0.2.3",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@taisly/agent",
-      "version": "0.2.1",
+      "version": "0.2.3",
       "transport": {
         "type": "stdio"
       },

src/cli.js

@@ -57,6 +57,18 @@ async function run(commandName, options) {
     case "integrations:settings":
       return client.platforms.schema(options.platform || options._[0]);
 
+    case "platforms:connect:start":
+    case "integrations:connect:start":
+      return client.platforms.connectStart({
+        platform: options.platform || options._[0],
+      });
+
+    case "platforms:connect:check":
+    case "integrations:connect:check":
+      return client.platforms.connectCheck({
+        platform: options.platform || options._[0],
+      });
+
     case "posts:validate":
       return client.posts.validate({
         video: options.video,
@@ -115,6 +127,9 @@ function help() {
       "platforms:list",
       "integrations:list",
       "platforms:schema --platform TikTok",
+      "platforms:connect:start --platform instagram",
+      "platforms:connect:check --platform instagram",
+      "Supported connect slugs: instagram, tiktok, youtube, x, facebook",
       "posts:validate --video ./launch.mp4 --platforms <id,id> --description 'Launch day'",
       "posts:create --video ./launch.mp4 --platforms <id,id> --description 'Launch day' --scheduled 2026-06-14T09:00:00+07:00",
       "posts:create --json campaign.json",

src/index.js

@@ -86,6 +86,34 @@ export class Taisly {
       success: true,
       data: getPlatformSchema(platform),
     }),
+
+    connectStart: async ({ platform }) => {
+      const platformKey = normalizeConnectPlatform(platform);
+      const response = await this.request(
+        `/agent/platform/connect/start?platform=${encodeURIComponent(
+          platformKey,
+        )}`,
+      );
+
+      return {
+        success: true,
+        ...(response.data || {}),
+      };
+    },
+
+    connectCheck: async ({ platform }) => {
+      const platformKey = normalizeConnectPlatform(platform);
+      const response = await this.request(
+        `/agent/platform/connect/check?platform=${encodeURIComponent(
+          platformKey,
+        )}`,
+      );
+
+      return {
+        success: true,
+        ...(response.data || {}),
+      };
+    },
   };
 
   posts = {
@@ -310,6 +338,18 @@ export function normalizePlatformIds(platforms) {
     .filter(Boolean);
 }
 
+function normalizeConnectPlatform(platform) {
+  const value = String(platform || "")
+    .trim()
+    .toLowerCase();
+
+  if (!value) {
+    throw new TaislyError("PLATFORM_REQUIRED", "Pass --platform.");
+  }
+
+  return value;
+}
+
 export function normalizeScheduled(value) {
   if (!value) return "";
   if (/^\d+$/.test(String(value))) return String(value);

src/mcp.js

@@ -10,7 +10,7 @@ const SUPPORTED_PROTOCOL_VERSIONS = new Set([
 ]);
 const SERVER_NAME = "taisly-agent-kit";
 const SERVER_TITLE = "Taisly Agent Kit";
-const SERVER_VERSION = "0.2.1";
+const SERVER_VERSION = "0.2.3";
 
 const JSON_OBJECT_SCHEMA = {
   type: "object",
@@ -96,6 +96,42 @@ const TOOLS = [
       additionalProperties: false,
     },
   },
+  {
+    name: "taisly_platform_connect_start",
+    title: "Start Social Account Connection",
+    description:
+      "Start browser-based connection for a social account. Returns a connectUrl that the user must open and approve in the browser.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        platform: {
+          type: "string",
+          description:
+            "Platform to connect. Supported: instagram, tiktok, youtube, x, facebook.",
+        },
+      },
+      required: ["platform"],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: "taisly_platform_connect_check",
+    title: "Check Social Account Connection",
+    description:
+      "Check whether a social account connection started by taisly_platform_connect_start has appeared in Taisly.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        platform: {
+          type: "string",
+          description:
+            "Platform to check. Supported: instagram, tiktok, youtube, x, facebook.",
+        },
+      },
+      required: ["platform"],
+      additionalProperties: false,
+    },
+  },
   {
     name: "taisly_posts_validate",
     title: "Validate Taisly Post",
@@ -249,6 +285,10 @@ const TOOL_HANDLERS = {
   taisly_auth_status: (client) => client.auth.status(),
   taisly_platforms_list: (client) => client.platforms.list(),
   taisly_platform_schema: (client, args) => client.platforms.schema(args.platform),
+  taisly_platform_connect_start: (client, args) =>
+    client.platforms.connectStart({ platform: args.platform }),
+  taisly_platform_connect_check: (client, args) =>
+    client.platforms.connectCheck({ platform: args.platform }),
   taisly_posts_validate: (client, args) =>
     client.posts.validate({
       video: args.video,
@@ -392,7 +432,7 @@ class TaislyMcpServer {
         version: SERVER_VERSION,
       },
       instructions:
-        "If Taisly is not connected yet, use taisly_agent_setup_start, send the user the returned loginUrl, wait for browser approval, then use taisly_agent_checkin. After setup, discover connected social accounts, validate posts, ask for explicit user confirmation, then create and monitor posts.",
+        "If Taisly is not connected yet, use taisly_agent_setup_start, send the user the returned loginUrl, wait for browser approval, then use taisly_agent_checkin. If a requested social account is missing, use taisly_platform_connect_start, send the user the returned connectUrl, wait for browser approval, then use taisly_platform_connect_check. After setup, discover connected social accounts, validate posts, ask for explicit user confirmation, then create and monitor posts.",
     };
   }