@geoly-ai/social-hub-sdk 0.1.16 → 0.1.18

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import type { ConfirmSubredditRestrictionInput, CreateSubredditRestrictionInput, ListSubredditRestrictionsParams, ListSubredditRestrictionsResponse, OpsBlockedJobAck, OpsBlockedReceipt, ReportSubredditRestrictionInput, ReportSubredditRestrictionResponse, RevokeSubredditRestrictionInput, SubredditRestriction, SubredditRestrictionCheckResult, SubredditRestrictionFanoutParams, SubredditRestrictionFanoutResponse } from "./subreddit-restrictions.js";
+export * from "./subreddit-restrictions.js";
 /**
  * 「返回了不完整结果、但看起来像完整的」这一族缺陷的统一探针。
  *
@@ -196,6 +198,8 @@ export type ListRedditPostSnapshotsParams = {
     draftStatus?: string;
     postType?: string;
     repostType?: string;
+    /** 账号类型:`internal` / `external`,可逗号分隔;proxy / 海外兼职 / 未知 / 空值在选了任一项时不命中。 */
+    accountType?: string;
     containsBrandKeyword?: "true" | "false" | "unset";
     primaryProduct?: string;
     /**
@@ -221,6 +225,8 @@ export type RedditPostSnapshotStatsParams = {
     draftStatus?: string;
     postType?: string;
     repostType?: string;
+    /** 账号类型:`internal` / `external`,可逗号分隔;proxy / 海外兼职 / 未知 / 空值在选了任一项时不命中。 */
+    accountType?: string;
     containsBrandKeyword?: "true" | "false" | "unset";
     primaryProduct?: string;
     /** 序列号闭区间(与列表同口径)。 */
@@ -267,6 +273,15 @@ export type AccountPoolsResponse = {
     personaPools?: unknown;
     systemPools?: unknown;
     fallback?: unknown;
+    /**
+     * 分页方案 B8b:本次生效的 limit / 返回条数 / 是否被截断(配额、limit 或单 key 行数上限)。
+     * 该端点没有 offset。配额 / limit 截断可调大 limit 或收窄 industry/tier;单 key 行数上限是
+     * 上游固定帽,调 limit 补不全,只能收窄 industry 或人工处理。
+     * 旧服务端不返回这三个字段。
+     */
+    selectionLimit?: number;
+    returned?: number;
+    truncated?: boolean;
 };
 export type DeviceCodeResponse = {
     device_code: string;
@@ -382,6 +397,113 @@ export type ContentReviewRequestInput = {
     /** 第几次送审;服务端强制上限 2(防重写循环)。 */
     attempt?: 1 | 2;
     traceId?: string;
+} & ReviewScopeDeclaration;
+/**
+ * ── Aporro Native Copy:四象限声明 / 逐稿 Card / acceptance 回执(手抄镜像)──
+ *
+ * 🔴 SDK **不能** re-export contracts(contracts 是 `private: true`,直接引用会生成
+ * 消费者装不上的 `.d.ts`),所以这组类型是手抄的,真源在
+ * `packages/contracts/src/review-scope.ts` 与 `knowledge-boundary.ts`。
+ * 手抄就会漂移 —— `index.test.ts` 里有对应的 `expectTypeOf` 编译期锁。
+ *
+ * 线上请求体一直是**原样透传**的(服务端 zod 校验);补这组类型之前,TS 调用方
+ * 传这几个字段会在编译期就被 SDK 自己的类型拦下 —— 能力在服务端,SDK 这层把门关上了。
+ */
+export type ReviewAccountBinding = "account_bound" | "persona_less";
+export type ReviewBrandTreatment = "managed_brand" | "organic";
+export type ReviewScopeSource = "declared" | "legacy_derived";
+export type ReviewBrandResolutionStatus = "resolved" | "none" | "unresolved";
+export type ReviewAcceptanceProfile = "default" | "native_copy";
+/** 调用方**声明**的象限(意图,不是事实)。 */
+export type ReviewRequestedScope = {
+    accountBinding: ReviewAccountBinding;
+    brandTreatment: ReviewBrandTreatment;
+};
+/** 服务端解析后的权威象限 + 可用性事实。 */
+export type ReviewResolvedScope = {
+    accountBinding: ReviewAccountBinding;
+    brandTreatment: ReviewBrandTreatment;
+    /** ⚠️ `legacy_derived` 不满足 Native Copy profile,也不满足发布 gate。 */
+    scopeSource: ReviewScopeSource;
+    /** `unresolved` 是覆盖态:声明 organic 却识别到已登记品牌 → 转人工,不豁免。 */
+    brandResolutionStatus: ReviewBrandResolutionStatus;
+    brandResolutionDetail: {
+        detectedBrandId: string | null;
+        detectedBrandKey: string | null;
+        reason: string;
+        resolverVersion: string;
+    } | null;
+    personaVoiceEvidenceAvailable: boolean;
+    knowledgeContextAvailable: boolean;
+    rulesEvidenceAvailable: boolean;
+    styleProfileAvailable: boolean;
+};
+/**
+ * 逐稿知识边界(Persona Card)。服务端内容寻址后固化,worker 发布前复审时完整恢复。
+ * ⚠️ 当前 **不影响 verdict**:`knowledge_boundary_consistency` 维度尚未激活
+ * (方案块 2a 口径下的 v5 原子提交),本字段现阶段只留痕、只决定 Gate 0 是否齐备。
+ */
+export type KnowledgeBoundaryContextInput = {
+    schemaVersion: 1;
+    knowledgeAccess: "research" | "owned" | "used" | "observed" | "supplied_by_brand";
+    /** 最多 4 项。 */
+    permittedExperienceClaims: Array<"ownership" | "delivery" | "wear" | "service">;
+    postingWhy: string;
+    knows: string[];
+    doesNotKnow: string[];
+    attentionFocus?: string;
+    questionIntent?: string;
+    permittedFactVersionIds?: string[];
+    archetypeLabels?: string[];
+};
+export type KnowledgeContextRef = {
+    id: string;
+    hash: string;
+    schemaVersion: number;
+};
+/** 本次生效的 acceptance profile(可能被降级,原因在 downgradedReason)。 */
+export type ResolvedAcceptanceProfile = {
+    profile: ReviewAcceptanceProfile;
+    policyVersion: string;
+    /** 非 null = 请求了 native_copy 但被降级(`legacy_derived_scope` / `incomplete_gate0`)。 */
+    downgradedReason: string | null;
+};
+export type ReviewProfileVerdictDetail = {
+    profile: ReviewAcceptanceProfile;
+    policyVersion: string;
+    verdict: "pass" | "revise" | "block" | "required_missing" | "not_applicable";
+    findings: Array<{
+        rule: string;
+        dimension: string | null;
+        threshold: number | null;
+        actual: number | null;
+        detail: string | null;
+    }>;
+    missingGateItems: string[];
+};
+/**
+ * 审核响应里的 Aporro 回执(帖/评共用)。全部可选:旧 pod / 旧 engine 下服务端会
+ * fail-closed **省略**它们,调用方应把「字段不在」读成「没有这项能力」,⛔ 不是「通过」。
+ */
+export type ReviewScopeReceipt = {
+    resolvedScope?: ReviewResolvedScope;
+    capabilities?: string[];
+    knowledgeContextRef?: KnowledgeContextRef | null;
+    resolvedAcceptanceProfile?: ResolvedAcceptanceProfile;
+    profileVerdictDetail?: ReviewProfileVerdictDetail | null;
+};
+/** 审核请求里的 Aporro 声明字段(帖/评共用)。 */
+export type ReviewScopeDeclaration = {
+    requestedScope?: ReviewRequestedScope;
+    /**
+     * ⚠️ 两类入口约束**不同**(Codex 块 5 P1 纠正了我原来写的「需同时声明」):
+     * - 同步 `postReview` / `contentReview`:三个字段各自可选,不要求成对;只传 Card
+     *   不传 requestedScope 时服务端照收,按 `legacy_derived` 象限审(不满足 native_copy)。
+     * - 异步 `createReviewTarget`:Card 与 requestedAcceptanceProfile **必须**伴随
+     *   requestedScope,否则 400 —— 因为只有声明分支会被固化,不拦就是「接受后丢数据」。
+     */
+    knowledgeContext?: KnowledgeBoundaryContextInput;
+    requestedAcceptanceProfile?: ReviewAcceptanceProfile;
 };
 export type ContentReviewResponse = {
     reviewId: string;
@@ -406,7 +528,7 @@ export type ContentReviewResponse = {
     thresholdSnapshot: Record<string, unknown>;
     latencyMs: number;
     degradedReason: string | null;
-};
+} & ReviewScopeReceipt;
 /** 审核目标状态(mirrors contracts REVIEW_TARGET_STATUSES;SDK 不 hard-dep contracts)。 */
 export type ReviewTargetStatusLike = "pending" | "running" | "passed" | "needs_revision" | "blocked" | "degraded" | "superseded";
 /**
@@ -459,10 +581,11 @@ export type CreateReviewTargetBody = {
     subject: {
         title?: string;
         body: string;
+        /** ⚠️ Gate 0 的版规证据读的是这里的 `subredditRules`(worker 重建请求也读这个位置)。 */
         threadContext?: Record<string, unknown>;
         subreddit?: string;
     };
-};
+} & ReviewScopeDeclaration;
 export type CommentDraftStatusLike = "draft" | "scheduled" | "approved" | "archived" | "published";
 /**
  * 评论审核语境快照(mirrors contracts commentDraftThreadContextSchema;严格对象——
@@ -1071,6 +1194,188 @@ export type EnableSubredditMonitorBody = {
     watchlistId: string;
     fetchLimit?: number;
 };
+/**
+ * 监听配置更新 body。
+ *
+ * 🔴 **没有 `enabled`,也不许加**:改配置绝不隐式改启停 —— 启停走
+ * `enableSubredditMonitor`(启用)与 `disableSubredditMonitor`(软停)两个显式入口。
+ * 🔴 **没有 `sort`**:DDL 的 CHECK 只允许 `'new'` 一个值,加了就是「改了就 400」的面。
+ */
+export type UpdateSubredditMonitorConfigBody = {
+    /**
+     * 单页抓取条数上限,1–100(与 `EnableSubredditMonitorBody` 同一套边界)。
+     *
+     * 🔴 **必填,⛔ 不要写成可选。** 服务端 schema 要求「至少给一个可更新字段」,
+     * 而当前可更新字段只有它一个 —— 声明成可选会让 `updateSubredditMonitorConfig(id, {})`
+     * 通过类型检查、运行时必然 400。将来真的加了第二个可更新字段,再把这里
+     * 改成「二选一」的联合类型。
+     */
+    fetchLimit: number;
+};
+/** 公开库端点前缀(供应商无关)。 */
+export declare const PUBLIC_REDDIT_BASE_PATH = "/v1/system/public-reddit";
+export declare const PUBLIC_REDDIT_PATHS: {
+    readonly communities: "/v1/system/public-reddit/communities";
+    readonly posts: "/v1/system/public-reddit/posts";
+    readonly postCounts: "/v1/system/public-reddit/post-counts";
+    readonly status: "/v1/system/public-reddit/status";
+};
+/**
+ * 公开库错误码(服务端 `error.code`)。🔴 `DISABLED` / `POLICY_DENIED` / `AUTH_FAILED` 等
+ * 都是「读不到」而**不是**「没有数据」,调用方绝不能把它们当成空结果。
+ */
+export declare const PUBLIC_REDDIT_ERROR_CODES: {
+    readonly DISABLED: "PUBLIC_REDDIT_DISABLED";
+    readonly BUDGET_EXHAUSTED: "PUBLIC_REDDIT_BUDGET_EXHAUSTED";
+    readonly DEGRADED: "PUBLIC_REDDIT_DEGRADED";
+    readonly COUNT_TIMEOUT: "PUBLIC_REDDIT_COUNT_TIMEOUT";
+    readonly RATE_LIMITED: "PUBLIC_REDDIT_RATE_LIMITED";
+    readonly AUTH_FAILED: "PUBLIC_REDDIT_AUTH_FAILED";
+    readonly POLICY_DENIED: "PUBLIC_REDDIT_POLICY_DENIED";
+    readonly COMMUNITY_NOT_AVAILABLE: "PUBLIC_REDDIT_COMMUNITY_NOT_AVAILABLE";
+    readonly SCOPE_TOO_LARGE: "PUBLIC_REDDIT_SCOPE_TOO_LARGE";
+    readonly QUERY_REQUIRED: "PUBLIC_REDDIT_QUERY_REQUIRED";
+    readonly INVALID_REQUEST: "PUBLIC_REDDIT_INVALID_REQUEST";
+    readonly INVALID_WINDOW: "PUBLIC_REDDIT_INVALID_WINDOW";
+    readonly INVALID_COMMUNITY: "PUBLIC_REDDIT_INVALID_COMMUNITY";
+    readonly CURSOR_MISMATCH: "PUBLIC_REDDIT_CURSOR_MISMATCH";
+    readonly CURSOR_RESET: "PUBLIC_REDDIT_CURSOR_RESET";
+    readonly UNAVAILABLE: "PUBLIC_REDDIT_UNAVAILABLE";
+    readonly BAD_UPSTREAM_RESPONSE: "PUBLIC_REDDIT_BAD_UPSTREAM_RESPONSE";
+};
+export type PublicRedditNamedWindow = "day" | "week" | "month" | "last_90d" | "last_360d" | "last_full_week";
+/** 窗口:命名窗口与显式 [from,to) 二选一(服务端校验互斥)。 */
+export type PublicRedditWindowParams = {
+    window?: PublicRedditNamedWindow;
+    from?: string;
+    to?: string;
+};
+export type ListPublicRedditCommunitiesParams = {
+    /** 数组按逗号拼接(与服务端 csv 形状一致)。 */
+    industryKey?: string | string[];
+    tierKey?: string | string[];
+    poolKind?: string | string[];
+    hasProfile?: boolean;
+    limit?: number;
+    /** Hub 令牌:原样回传上一页的 nextCursor。 */
+    cursor?: string;
+};
+export type SearchPublicRedditPostsParams = PublicRedditWindowParams & {
+    /** 必填、≤20 个;数组按逗号拼接。 */
+    subreddit: string | string[];
+    /** ⚠️ 会发往外部数据服务。 */
+    query?: string;
+    sort?: "created_at_desc";
+    limit?: number;
+    cursor?: string;
+    includeBody?: boolean;
+};
+export type CountPublicRedditPostsBody = PublicRedditWindowParams & {
+    subreddits: string[];
+    /** 必填;⚠️ 会发往外部数据服务。 */
+    query: string;
+    artifactType?: "post" | "comment";
+};
+export type PublicRedditSourceMeta = {
+    provider: "cyberredd";
+    mode: "off" | "shadow" | "on";
+    dataCutoff: string | null;
+    resolvedWindow: {
+        from: string;
+        to: string;
+        name: string | null;
+    } | null;
+    fetchedAt: string;
+    cached: boolean;
+    excludedCommunities: Array<{
+        communityId: string;
+        reason: string;
+    }>;
+    warnings: Array<{
+        code: string;
+        message?: string;
+    }>;
+};
+export type PublicRedditCommunity = {
+    communityId: string;
+    name: string | null;
+    url: string | null;
+    industryKeys: string[] | null;
+    tierKey: string | null;
+    poolKind: string | null;
+    hasProfile: boolean | null;
+    dataCutoff: string | null;
+};
+export type PublicRedditPost = {
+    upstreamId: string;
+    redditPostId: string | null;
+    communityId: string;
+    title: string | null;
+    bodyExcerpt: string | null;
+    body?: string | null;
+    authorName: string | null;
+    createdAt: string | null;
+    url: string | null;
+    contentState: string | null;
+    observationStatus: string | null;
+    intent: string | null;
+    sentiment: string | null;
+    labelVocabulary: "cyberredd_v1";
+};
+export type ListPublicRedditCommunitiesResponse = {
+    items: PublicRedditCommunity[];
+    nextCursor: string | null;
+    source: PublicRedditSourceMeta;
+};
+export type SearchPublicRedditPostsResponse = {
+    items: PublicRedditPost[];
+    nextCursor: string | null;
+    source: PublicRedditSourceMeta;
+};
+export type CountPublicRedditPostsResponse = {
+    artifactType: "post" | "comment";
+    window: {
+        from: string;
+        to: string;
+        name: string | null;
+    };
+    exact: boolean;
+    /** exact=false 时为 null,绝不是部分和。 */
+    total: number | null;
+    communities: Array<{
+        communityId: string;
+        status: string;
+        count: number | null;
+        dataCutoff: string | null;
+        windowCovered: boolean | null;
+    }>;
+    source: PublicRedditSourceMeta;
+};
+export type PublicRedditStatus = {
+    mode: "off" | "shadow" | "on";
+    capabilities: Array<"catalog" | "post_search" | "post_count">;
+    configured: boolean;
+    keyFingerprint: string | null;
+    keyExpiresAt: string | null;
+    credential: Record<string, unknown>;
+    breaker: {
+        state: string;
+        openedAt: string | null;
+    };
+    budget: {
+        windowSeconds: number;
+        limit: number;
+        used: number;
+    };
+    catalogIndex: {
+        size: number | null;
+        refreshedAt: string | null;
+    };
+    lastError: {
+        code: string;
+        at: string;
+    } | null;
+};
 export type ListHotPostsParams = {
     limit?: number;
     offset?: number;
@@ -2595,6 +2900,9 @@ export declare class SocialHubClient {
         items: unknown[];
         total: number;
     }>;
+    /**
+     * 评论样本列表。⚠️ 只含 Hub 内现有评论样本(非归档,约 5.7 万条);历史/归档评论已迁至 CyberRedd。
+     */
     listRedditCommentSamples(params?: {
         postId?: string;
         subreddit?: string;
@@ -2624,6 +2932,7 @@ export declare class SocialHubClient {
      * (totalRelation=unavailable)。
      * ⚠️ 无过滤时是全表精确 count,属昂贵读——基线用途,**禁止轮询**。
      * 口径是库内 reddit_comment_samples 行数,不是 Reddit 线程真实评论总数。
+     * ⚠️ 只含 Hub 内现有评论样本(非归档,约 5.7 万条);历史/归档评论已迁至 CyberRedd。
      */
     countRedditCommentSamples(params?: {
         postId?: string;
@@ -2784,6 +3093,17 @@ export declare class SocialHubClient {
      * observation ledger 因此保留,重启后已报告过的帖子不会重复报告。
      */
     enableSubredditMonitor(body: EnableSubredditMonitorBody): Promise<SubredditMonitorConfig>;
+    /**
+     * **只改监听配置,⛔ 不碰启停。**
+     *
+     * 🔴 与 {@link SocialOpsHubClient.enableSubredditMonitor} 的区别就是全部要点:
+     * 那个 `POST` 是 upsert,`DO UPDATE` 里写死 `enabled = true`,所以在一个**被软停**的
+     * 监听上用它改 `fetchLimit` 会把监听静默重新启用。本方法背后的 SQL 里不出现
+     * `enabled` 列,改完启停状态原样不动。
+     *
+     * ⚠️ **不 upsert**:该 watchlist 没配置过监听 -> 404(不会被悄悄创建成监听)。
+     */
+    updateSubredditMonitorConfig(watchlistId: string, body: UpdateSubredditMonitorConfigBody): Promise<SubredditMonitorConfig>;
     /**
      * 停止监听:DELETE 语义但服务端做**软停**(enabled=false),不删 observation ledger。
      * 幂等 —— 本来就没在监听时返回 `{ ok: true, updated: false }`,不是 404。
@@ -3043,6 +3363,17 @@ export declare class SocialHubClient {
         }>;
     }>;
     exportHotPostsCsv(params?: ListHotPostsParams): Promise<string>;
+    /** GET /v1/system/public-reddit/communities — 公开库社区目录(只读;系统级,无 team 前缀)。 */
+    listPublicRedditCommunities(params?: ListPublicRedditCommunitiesParams): Promise<ListPublicRedditCommunitiesResponse>;
+    /** GET /v1/system/public-reddit/posts — 公开库帖子检索(必须带板块;query 会发往外部数据服务)。 */
+    searchPublicRedditPosts(params: SearchPublicRedditPostsParams): Promise<SearchPublicRedditPostsResponse>;
+    /**
+     * POST /v1/system/public-reddit/post-counts — 公开库计数。
+     * ⚠️ 昂贵读,禁止轮询;必须带 query;query 会发往外部数据服务。
+     */
+    countPublicRedditPosts(body: CountPublicRedditPostsBody): Promise<CountPublicRedditPostsResponse>;
+    /** GET /v1/system/public-reddit/status — 开关/熔断/预算(仅 unrestricted admin)。 */
+    getPublicRedditStatus(): Promise<PublicRedditStatus>;
     listKolIntents(params?: ListKolIntentsParams): Promise<{
         items: unknown[];
         total: number;
@@ -3276,6 +3607,9 @@ export declare class SocialHubClient {
         calendarEntryId?: string;
         redditPostSnapshotId?: string;
         payload?: Record<string, unknown>;
+        /** execution fencing token pair(认领时拿到的;两者须同时给出或同时省略)。 */
+        executionGeneration?: number;
+        executionId?: string;
     }): Promise<{
         ok: boolean;
         jobId: string;
@@ -3284,33 +3618,39 @@ export declare class SocialHubClient {
         alreadyCompleted?: boolean;
         trace: Record<string, unknown>;
         updated: Record<string, unknown>;
-    }>;
+    } | OpsBlockedReceipt>;
     opsFail(teamId: string, body: {
         agentId: string;
         jobId: string;
         reason: string;
         message?: string;
         payload?: Record<string, unknown>;
+        /** execution fencing token pair(认领时拿到的;两者须同时给出或同时省略)。 */
+        executionGeneration?: number;
+        executionId?: string;
     }): Promise<{
         ok: boolean;
         jobId: string;
         status: string;
         /** True when the job was already in this terminal — idempotent retry. */
         alreadyTerminal?: boolean;
-    }>;
+    } | OpsBlockedJobAck>;
     opsSkip(teamId: string, body: {
         agentId: string;
         jobId: string;
         reason: string;
         message?: string;
         payload?: Record<string, unknown>;
+        /** execution fencing token pair(认领时拿到的;两者须同时给出或同时省略)。 */
+        executionGeneration?: number;
+        executionId?: string;
     }): Promise<{
         ok: boolean;
         jobId: string;
         status: string;
         /** True when the job was already in this terminal — idempotent retry. */
         alreadyTerminal?: boolean;
-    }>;
+    } | OpsBlockedJobAck>;
     /**
      * 评论内容复审:独立 LLM 六维评审+服务端权威计分。
      * executionStatus=degraded 时 verdict 不可作为权威判定,调用方应降级本地自审。
@@ -3342,7 +3682,7 @@ export declare class SocialHubClient {
         thresholdSnapshot: Record<string, unknown>;
         latencyMs: number;
         degradedReason: string | null;
-    }>;
+    } & ReviewScopeReceipt>;
     /** 互动时序 P2:批量调度上下文(team 级,best_effort 一致性,keyset 分页)。 */
     getInteractionScheduleContext(teamId: string, params?: {
         limit?: number;
@@ -3373,6 +3713,16 @@ export declare class SocialHubClient {
         systemPools?: unknown;
         fallback?: unknown;
         exhaustion?: SubredditCandidatesExhaustion;
+        /**
+         * 分页方案 B8b:本次生效的 limit / 返回条数 / 是否被截断(配额、limit 或单 key 行数上限)。
+         * 该端点没有 offset。配额 / limit 截断可调大 limit 或收窄 industry/tier;单 key 行数上限是
+         * 上游固定帽,调 limit 补不全,只能收窄 industry 或人工处理。评论动作下配额阶段尚未过冷却 /
+         * affinity,`truncated: true` 可能偏多报;`false` 是精确的「没被截」。
+         * 旧服务端不返回这三个字段。
+         */
+        selectionLimit?: number;
+        returned?: number;
+        truncated?: boolean;
     }>;
     listSubredditPostAnnotations(teamId: string, params?: {
         subreddit?: string;
@@ -3896,7 +4246,20 @@ export declare class SocialHubClient {
     }): Promise<{
         purpose: string;
         activeSpecId: string | null;
+        /**
+         * ⚠️ 本页条数,**不是总数**。保留仅为兼容,与 `returned` 恒相等;新代码读 `returned`。
+         * @deprecated 用 `returned`。
+         */
         count: number;
+        /** 本页实际返回的条数。 */
+        returned: number;
+        /** 本次生效的条数上限(请求的 limit,缺省 20)。 */
+        selectionLimit: number;
+        /**
+         * 是否还有更多未返回的 run(服务端多取一条哨兵判定,精确)。
+         * 这是 recent 投影,**没有分页** —— 为 true 时请调大 limit 或改用精确查询,⛔ 不要自拼 offset。
+         */
+        truncated: boolean;
         runs: unknown[];
     }>;
     /**
@@ -4373,6 +4736,40 @@ export declare class SocialHubClient {
         availability: string;
         availabilityCheckedAt: string;
     }>;
+    /** GET /v1/system/subreddit-restrictions — 列表(state 多值、updatedSince 增量拉取)。 */
+    listSubredditRestrictions(params?: ListSubredditRestrictionsParams): Promise<ListSubredditRestrictionsResponse>;
+    /** GET /v1/system/subreddit-restrictions/:id — 单条(含全量 evidence)。 */
+    getSubredditRestriction(id: string): Promise<SubredditRestriction>;
+    /** POST /v1/system/subreddit-restrictions — 新建(已有活跃限制 → 409 RESTRICTION_EXISTS)。 */
+    createSubredditRestriction(body: CreateSubredditRestrictionInput): Promise<SubredditRestriction>;
+    /** POST .../:id/confirm — provisional / verification_overdue → confirmed(409 VERSION_MISMATCH / INVALID_STATE)。 */
+    confirmSubredditRestriction(id: string, body?: ConfirmSubredditRestrictionInput): Promise<SubredditRestriction>;
+    /** POST .../:id/revoke — 解封(唯一的解封路径)。 */
+    revokeSubredditRestriction(id: string, body: RevokeSubredditRestrictionInput): Promise<SubredditRestriction>;
+    /** GET .../:id/fanout — 扇出汇总 + 回执明细(阶段 B 之前为空、complete=false)。 */
+    getSubredditRestrictionFanout(id: string, params?: SubredditRestrictionFanoutParams): Promise<SubredditRestrictionFanoutResponse>;
+    /**
+     * GET /v1/teams/:teamId/subreddit-restrictions — team 级只读列表(`compliance:read`,manager 可用)。
+     * 过滤参数与系统级 list 相同,只回证据摘要。运营侧 agent 拉取状态走这个,不走系统级 admin 面。
+     */
+    listTeamSubredditRestrictions(teamId: string, params?: ListSubredditRestrictionsParams): Promise<ListSubredditRestrictionsResponse>;
+    /**
+     * GET /v1/teams/:teamId/subreddit-restrictions/:id/fanout — 只统计、只返回**本 team** 的回执;
+     * outbox 的 summary / lastError 为 null(跨 team 信息)。complete 仍按全局 outbox 判断。
+     */
+    getTeamSubredditRestrictionFanout(teamId: string, id: string, params?: Omit<SubredditRestrictionFanoutParams, "teamId">): Promise<SubredditRestrictionFanoutResponse>;
+    /** POST /v1/teams/:teamId/subreddit-restrictions/report — runner 上报(只写 provisional 或 sanction)。 */
+    reportSubredditRestriction(teamId: string, body: ReportSubredditRestrictionInput): Promise<ReportSubredditRestrictionResponse>;
+    /**
+     * GET /v1/teams/:teamId/subreddit-restrictions/check — runner 动手前自查。
+     * 账号可以用 `socialAccountId`(与 contracts 同名)或 `account`(CLI flag 同名)给;两者都给且不同
+     * → 直接抛错,绝不静默丢掉其中一个 —— 丢了账号就只判系统级,会得到假的 `allowed:true`。
+     */
+    checkSubredditRestriction(teamId: string, params: {
+        subreddit: string;
+        socialAccountId?: string;
+        account?: string;
+    }): Promise<SubredditRestrictionCheckResult>;
 }
 export type NotificationSubscriptionStatus = "active" | "paused"
 /** 游标落后于保留 floor,已无法保证不漏；需人工确认后 reset。 */
@@ -4978,5 +5375,4 @@ export type CalendarEntryStatus = "draft" | "scheduled" | "exported" | "running"
 export type ReviewTargetStatus = "pending" | "running" | "passed" | "needs_revision" | "blocked" | "degraded" | "superseded";
 /** 契约 `reviewGateStateSchema` 的镜像（日历条目上的审核门投影）。 */
 export type ReviewGateState = "passed" | "waiting" | "revision_required" | "blocked" | "stale" | "untracked";
-export {};
 //# sourceMappingURL=index.d.ts.map