@reachv2/sdk 0.3.1 → 0.3.2

package/README.md

@@ -1,6 +1,6 @@
 # @reachv2/sdk
 
-Reach（reach.codes）统一平台的官方 TypeScript SDK —— 由 aiservicer SDK（crm 域，18 资源）与 aiops-saas SDK（social 域，5 资源）合并而来（P2.4），现统一为 **27 个资源类 / 203 个资源方法**。一个客户端覆盖客服 / 销售引导、社群维护与社媒运营全部资源（含效果追踪、SEO/GEO、内容规则与数据源）。
+Reach（reach.codes）统一平台的官方 TypeScript SDK —— 由 aiservicer SDK（crm 域，18 资源）与 aiops-saas SDK（social 域，5 资源）合并而来（P2.4），现统一为 **31 个资源类 / 210 个资源方法**。一个客户端覆盖客服 / 销售引导、社群维护与社媒运营全部资源（含效果追踪、SEO/GEO、内容规则与数据源）。
 
 - 运行时：Node.js >= 18（ESM）
 - 类型：完整 TypeScript 类型定义（自带 `dist/index.d.ts`）
@@ -82,7 +82,7 @@ Reach 将自身能力以 **MCP（Model Context Protocol）** 形式对外开放
 - 权限（读 / 写门禁）：只读 Key（scope 不含 `write` / `all` / `*`）**只能调用读工具**（工具名按 `_` 分词命中
   `list` / `get` / `status` / `query` / `summary` / `check` / `history` / `usage` … 即视为读，未命中一律按写拒绝）；
   写工具需 `write` / `all` / `*` scope，否则 `tools/call` 返回 JSON-RPC `-32001 requires a write-scoped API key`
-- 工具规模：**269**（crm 87 + social 182），按域白名单裁剪（当前 `crm` / `social`），`tools/list` 返回实际可用集合
+- 工具规模：**255**（crm 87 + social 168），按域白名单裁剪（当前 `crm` / `social`），`tools/list` 返回实际可用集合
 
 会话按 MCP Streamable HTTP 规范：先 `initialize` 取得 `mcp-session-id`，
 再发 `notifications/initialized`，之后 `tools/call`，结束时 `DELETE` 会话。
@@ -163,6 +163,10 @@ const client = new ReachClient({
 | `client.content` | 社媒文案生成（generate/list/platforms/styles/get/update/delete） | Server |
 | `client.tts` | 文本转语音（synthesize/voices/history） | Server |
 | `client.accounts` | 社媒账号矩阵（list/connect） | Server |
+| `client.contentPlans` | **内容计划（ContentPlansResource）**：计划名 + 主题时间轴（list/create） | Server |
+| `client.publishPlans` | **发布计划（PublishPlansResource）**：多站点分步编排，get 返回每步待审草稿（list/get） | Server |
+| `client.browserTemplates` | **浏览器操作模板（BrowserTemplatesResource）**：流程编排模板（list/update） | Server |
+| `client.aiMedia` | **AI 媒体（AiMediaResource）**：视频脚本生成（script） | Server |
 
 ### social 域 — P-REACH（效果 / SEO-GEO / 内容规则 / 数据源，v0.3.0 新增）
 

package/dist/client.d.ts

@@ -20,6 +20,10 @@ import { TtsResource } from "./resources/tts.js";
 import { AccountsResource } from "./resources/accounts.js";
 import { EffectResource } from "./resources/effect.js";
 import { SeoGeoResource } from "./resources/seo-geo.js";
+import { ContentPlansResource } from "./resources/content-plans.js";
+import { PublishPlansResource } from "./resources/publish-plans.js";
+import { BrowserTemplatesResource } from "./resources/browser-templates.js";
+import { AiMediaResource } from "./resources/ai-media.js";
 import { ContentRulesResource } from "./resources/content-rules.js";
 import { DataSourcesResource } from "./resources/data-sources.js";
 import { DashboardApi } from "./resources/dashboard-api.js";
@@ -52,6 +56,10 @@ export declare class ReachClient {
     content: ContentResource;
     tts: TtsResource;
     accounts: AccountsResource;
+    contentPlans: ContentPlansResource;
+    publishPlans: PublishPlansResource;
+    browserTemplates: BrowserTemplatesResource;
+    aiMedia: AiMediaResource;
     effect: EffectResource;
     seoGeo: SeoGeoResource;
     contentRules: ContentRulesResource;

package/dist/client.js

@@ -20,6 +20,10 @@ import { TtsResource } from "./resources/tts.js";
 import { AccountsResource } from "./resources/accounts.js";
 import { EffectResource } from "./resources/effect.js";
 import { SeoGeoResource } from "./resources/seo-geo.js";
+import { ContentPlansResource } from "./resources/content-plans.js";
+import { PublishPlansResource } from "./resources/publish-plans.js";
+import { BrowserTemplatesResource } from "./resources/browser-templates.js";
+import { AiMediaResource } from "./resources/ai-media.js";
 import { ContentRulesResource } from "./resources/content-rules.js";
 import { DataSourcesResource } from "./resources/data-sources.js";
 import { DashboardApi } from "./resources/dashboard-api.js";
@@ -57,6 +61,10 @@ export class ReachClient {
         this.content = new ContentResource(this.requestServer.bind(this));
         this.tts = new TtsResource(this.requestServer.bind(this));
         this.accounts = new AccountsResource(this.requestServer.bind(this));
+        this.contentPlans = new ContentPlansResource(this.requestServer.bind(this));
+        this.publishPlans = new PublishPlansResource(this.requestServer.bind(this));
+        this.browserTemplates = new BrowserTemplatesResource(this.requestServer.bind(this));
+        this.aiMedia = new AiMediaResource(this.requestServer.bind(this));
         this.effect = new EffectResource(this.requestServer.bind(this));
         this.seoGeo = new SeoGeoResource(this.requestServer.bind(this));
         this.contentRules = new ContentRulesResource(this.requestServer.bind(this));

package/dist/index.d.ts

@@ -22,6 +22,10 @@ export { TtsResource } from "./resources/tts.js";
 export { AccountsResource } from "./resources/accounts.js";
 export { EffectResource } from "./resources/effect.js";
 export { SeoGeoResource } from "./resources/seo-geo.js";
+export { ContentPlansResource } from "./resources/content-plans.js";
+export { PublishPlansResource } from "./resources/publish-plans.js";
+export { BrowserTemplatesResource } from "./resources/browser-templates.js";
+export { AiMediaResource } from "./resources/ai-media.js";
 export { ContentRulesResource } from "./resources/content-rules.js";
 export { DataSourcesResource } from "./resources/data-sources.js";
 export { HealthResource } from "./resources/health.js";

package/dist/index.js

@@ -22,6 +22,10 @@ export { TtsResource } from "./resources/tts.js";
 export { AccountsResource } from "./resources/accounts.js";
 export { EffectResource } from "./resources/effect.js";
 export { SeoGeoResource } from "./resources/seo-geo.js";
+export { ContentPlansResource } from "./resources/content-plans.js";
+export { PublishPlansResource } from "./resources/publish-plans.js";
+export { BrowserTemplatesResource } from "./resources/browser-templates.js";
+export { AiMediaResource } from "./resources/ai-media.js";
 export { ContentRulesResource } from "./resources/content-rules.js";
 export { DataSourcesResource } from "./resources/data-sources.js";
 export { HealthResource } from "./resources/health.js";

package/dist/resources/ai-media.d.ts

@@ -0,0 +1,17 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * AiMedia 资源 — AI 视频（脚本生成）。
+ * 端点走 Server API（/api/ai-media/*）。
+ * 与社媒域 MCP 工具 video_script_generate 同源。
+ */
+export declare class AiMediaResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 生成视频脚本（提示词）：主题必填，可指定语言与时长 */
+    script(subject: string, opts?: {
+        language?: string;
+        duration?: number;
+    }): Promise<any>;
+}
+export {};

package/dist/resources/ai-media.js

@@ -0,0 +1,17 @@
+/**
+ * AiMedia 资源 — AI 视频（脚本生成）。
+ * 端点走 Server API（/api/ai-media/*）。
+ * 与社媒域 MCP 工具 video_script_generate 同源。
+ */
+export class AiMediaResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 生成视频脚本（提示词）：主题必填，可指定语言与时长 */
+    script(subject, opts = {}) {
+        return this.request("POST", "/api/ai-media/video/script", {
+            subject,
+            ...opts,
+        });
+    }
+}

package/dist/resources/browser-templates.d.ts

@@ -0,0 +1,16 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * BrowserTemplates 资源 — 浏览器操作模板（流程编排：navigate/click/type/extract …）。
+ * 端点走 Server API（/api/browser-templates/*）。
+ * 与社媒域 MCP 工具 browser_templates_list / browser_templates_update 同源。
+ */
+export declare class BrowserTemplatesResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 模板列表 */
+    list(): Promise<any>;
+    /** 更新模板（部分更新；改 steps 会提升模板版本） */
+    update(templateId: string, data: Record<string, unknown>): Promise<any>;
+}
+export {};

package/dist/resources/browser-templates.js

@@ -0,0 +1,18 @@
+/**
+ * BrowserTemplates 资源 — 浏览器操作模板（流程编排：navigate/click/type/extract …）。
+ * 端点走 Server API（/api/browser-templates/*）。
+ * 与社媒域 MCP 工具 browser_templates_list / browser_templates_update 同源。
+ */
+export class BrowserTemplatesResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 模板列表 */
+    list() {
+        return this.request("GET", "/api/browser-templates");
+    }
+    /** 更新模板（部分更新；改 steps 会提升模板版本） */
+    update(templateId, data) {
+        return this.request("PUT", `/api/browser-templates/${templateId}`, data);
+    }
+}

package/dist/resources/content-plans.d.ts

@@ -0,0 +1,20 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * ContentPlans 资源 — 内容计划（计划名 + 主题时间轴，媒体运营 campaign）。
+ * 端点走 Server API（/api/media-ops/*）。
+ * 与社媒域 MCP 工具 content_plans_list / content_plans_create 同源。
+ */
+export declare class ContentPlansResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 内容计划列表（按租户 + 创建时间倒序） */
+    list(): Promise<any>;
+    /** 创建内容计划：计划名 + 主题列表 + 时间范围 + 风格 */
+    create(name: string, topics: string[], opts?: {
+        startDate?: string;
+        endDate?: string;
+        strategy?: string;
+    }): Promise<any>;
+}
+export {};

package/dist/resources/content-plans.js

@@ -0,0 +1,22 @@
+/**
+ * ContentPlans 资源 — 内容计划（计划名 + 主题时间轴，媒体运营 campaign）。
+ * 端点走 Server API（/api/media-ops/*）。
+ * 与社媒域 MCP 工具 content_plans_list / content_plans_create 同源。
+ */
+export class ContentPlansResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 内容计划列表（按租户 + 创建时间倒序） */
+    list() {
+        return this.request("GET", "/api/media-ops");
+    }
+    /** 创建内容计划：计划名 + 主题列表 + 时间范围 + 风格 */
+    create(name, topics, opts = {}) {
+        return this.request("POST", "/api/media-ops", {
+            name,
+            topics,
+            ...opts,
+        });
+    }
+}

package/dist/resources/publish-plans.d.ts

@@ -0,0 +1,16 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * PublishPlans 资源 — 发布计划（多站点分步编排 + 每步待审草稿）。
+ * 端点走 Server API（/api/publish-plans/*）。
+ * 与社媒域 MCP 工具 publish_plans_list / publish_plans_get 同源。
+ */
+export declare class PublishPlansResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 发布计划列表（含每步状态汇总） */
+    list(): Promise<any>;
+    /** 发布计划详情：每步的生成文案（draftText）与状态 — 用于审批前展示内容 */
+    get(planId: string): Promise<any>;
+}
+export {};

package/dist/resources/publish-plans.js

@@ -0,0 +1,18 @@
+/**
+ * PublishPlans 资源 — 发布计划（多站点分步编排 + 每步待审草稿）。
+ * 端点走 Server API（/api/publish-plans/*）。
+ * 与社媒域 MCP 工具 publish_plans_list / publish_plans_get 同源。
+ */
+export class PublishPlansResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 发布计划列表（含每步状态汇总） */
+    list() {
+        return this.request("GET", "/api/publish-plans");
+    }
+    /** 发布计划详情：每步的生成文案（draftText）与状态 — 用于审批前展示内容 */
+    get(planId) {
+        return this.request("GET", `/api/publish-plans/${planId}`);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@reachv2/sdk",
-  "version": "0.3.1",
-  "description": "Reach unified REST API client library for TypeScript — crm 域（AgentApi/Project/Bot/Knowledge/Channel/Conversation/Transaction/Auth/Chat/ApiKey/LightRAG/Orchestration/ScheduledTasks/Internal/Abis/Admin）+ social 域（Content/Tts/Accounts/Effect 效果追踪/SeoGeo SEO-GEO 矩阵/ContentRules 内容规则引擎/DataSources 数据源）+ 统一 DashboardApi（crm/social 看板）+ 统一租户成员模型（Tenants/Team/Health，G-1~G-3）",
+  "version": "0.3.2",
+  "description": "Reach unified REST API client library for TypeScript — crm 域（AgentApi/Project/Bot/Knowledge/Channel/Conversation/Transaction/Auth/Chat/ApiKey/LightRAG/Orchestration/ScheduledTasks/Internal/Abis/Admin）+ social 域（Content/Tts/Accounts/ContentPlans 内容计划/PublishPlans 发布计划/BrowserTemplates 流程模板/AiMedia 视频脚本/Effect 效果追踪/SeoGeo SEO-GEO 矩阵/ContentRules 内容规则引擎/DataSources 数据源）+ 统一 DashboardApi（crm/social 看板）+ 统一租户成员模型（Tenants/Team/Health，G-1~G-3）",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",