@tier0/sdk-v2 0.6.2 → 0.7.2

package/dist/cjs/openapi/types.generated.d.ts

@@ -335,7 +335,7 @@ export interface paths {
         put?: never;
         /**
          * 发现当前 Workspace 的公开能力与版本合同
-         * @description 需要有效 Workspace API Key，Body 仅接受空 JSON 对象，最大 4KiB UTF-8 字节，不接受查询参数或 Workspace 覆盖。成功响应直接为 CapabilityDiscoverResp，不包裹 code/msg/data。能力由默认关闭的公开发布开关、Workspace FeatureGate、Key 显式授权共同裁决；Control 能力仅报告当前发布与授权，运行可用性保持 readiness_unknown，不触发运行时探针。实际操作由后端执行安全检查，失败返回真实错误。响应允许客户端忽略未知扩展字段；版本标签不表示设备 ACK 或 npm 包版本。错误直接返回 CapabilityErrorResp 和真实 HTTP 状态，不泄漏内部异常。
+         * @description 需要有效 Workspace API Key，Body 仅接受空 JSON 对象，最大 4KiB UTF-8 字节，不接受查询参数或 Workspace 覆盖。成功响应直接为 CapabilityDiscoverResp，不包裹 code/msg/data。能力由默认关闭的公开发布开关、Workspace FeatureGate、Key 显式授权共同裁决；Stream request 能力仅报告当前发布与授权，运行可用性保持 readiness_unknown，不触发运行时探针。实际操作由后端执行安全检查，失败返回真实错误。响应允许客户端忽略未知扩展字段；版本标签不表示设备 ACK 或 npm 包版本。错误直接返回 CapabilityErrorResp 和真实 HTTP 状态，不泄漏内部异常。
          */
         post: operations["PlatformV2CapabilityDiscover"];
         delete?: never;
@@ -868,257 +868,464 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
-        AgentAnalysisDispatchReq: {
-            canvasId?: string;
-            cardId?: string;
-            kind: string;
-            operationId: string;
-            resultId?: string;
-            task: unknown;
+        InfoResp: {
+            capabilities: string[];
+            mqttBroker: string;
+            name: string;
+            /** @description API version of the requested HTTP entry point */
+            version: string;
         };
-        AgentAnalysisDispatchResp: {
-            dispatchState: string;
-            errorCode: string;
-            errorMessage: string;
-            runId: string;
+        AuthWhoamiResp: {
+            apiKeyName: string;
+            email: string;
+            keyPrefix: string;
+            keyType: string;
+            permissions: string[];
+            roles: string[];
+            userID: number | bigint;
+            userName: string;
+            workspaceID: number | bigint;
+            workspaceName: string;
         };
-        AgentAnalysisGetReq: {
-            runId: string;
+        AssetFileUploadReq: {
+            appInstanceId?: string;
+            business?: string;
+            contentType?: string;
+            fileName: string;
+            sessionId?: string;
+            size: number | bigint;
+            useBy?: string;
+            visibility?: string;
         };
-        AgentAnalysisGetResp: {
-            run: components["schemas"]["AgentJobRunRecord"];
+        AssetFileUploadResp: {
+            expiresAt?: number | bigint;
+            fileId?: number | bigint;
+            filePath: string;
+            fileUrl?: string;
+            /** @description 先写入全部签名字段，再追加 file；policy 约束 key 和大小 */
+            postFields: {
+                [key: string]: string;
+            };
+            /** @description 预签名 POST 地址；multipart/form-data 上传 */
+            postUrl: string;
         };
-        AgentCanvasListReq: {
-            page: number | bigint;
+        AssetFileUrlResp: {
+            expiresAt?: number | bigint;
+            fileUrl: string;
+        };
+        AssetFileDeleteReq: {
+            filePath: string;
+        };
+        AssetFileDeleteResp: {
+            deleted: boolean;
+        };
+        AssetFileMultipartInitReq: {
+            appInstanceId?: string;
+            bizId?: string;
+            business?: string;
+            contentType?: string;
+            fileName: string;
+            partSize?: number | bigint;
             sessionId?: string;
             size: number | bigint;
+            useBy?: string;
+            visibility?: string;
         };
-        AgentCanvasListResp: {
-            list: components["schemas"]["AgentCanvasRecord"][];
-            page: number | bigint;
-            size: number | bigint;
-            total: number | bigint;
+        AssetFileMultipartInitResp: {
+            expiresAt: number | bigint;
+            fileKey: string;
+            filePath: string;
+            partCount: number | bigint;
+            partSize: number | bigint;
+            uploadId: string;
         };
-        AgentCanvasRecord: {
-            canvasId: string;
-            createdAt: number | bigint;
-            name: string;
-            sessionId: string;
-            updatedAt: number | bigint;
+        AssetFileMultipartPartUrlsReq: {
+            fileKey: string;
+            partNumbers: (number | bigint)[];
+            uploadId: string;
         };
-        AgentCardDeleteReq: {
-            canvasId: string;
-            cardId: string;
-            expectedCardSpec: unknown;
+        AssetFileMultipartPartUrlsResp: {
+            partUrls: components["schemas"]["AssetFileMultipartPartUrl"][];
         };
-        AgentCardDeleteResp: {
-            cardId: string;
+        AssetFileMultipartPartUrl: {
+            expiresAt: number | bigint;
+            partNumber: number | bigint;
+            url: string;
         };
-        AgentCardGetReq: {
-            canvasId: string;
-            cardId: string;
+        AssetFileMultipartCompleteReq: {
+            fileKey: string;
+            parts: components["schemas"]["AssetFileMultipartPart"][];
+            uploadId: string;
         };
-        AgentCardGetResp: {
-            canvasId: string;
-            cardId: string;
-            cardKey: string;
-            cardSpec: unknown;
-            updatedAt: number | bigint;
+        AssetFileMultipartPart: {
+            etag: string;
+            partNumber: number | bigint;
         };
-        AgentCardListReq: {
-            canvasId: string;
-            page: number | bigint;
-            size: number | bigint;
+        AssetFileMultipartCompleteResp: {
+            expiresAt?: number | bigint;
+            filePath: string;
+            fileUrl?: string;
+            sizeBytes: number | bigint;
         };
-        AgentCardListResp: {
-            list: components["schemas"]["AgentCardGetResp"][];
-            page: number | bigint;
-            size: number | bigint;
-            total: number | bigint;
+        AssetFileMultipartAbortReq: {
+            fileKey: string;
+            uploadId: string;
         };
-        AgentCardUpdateReq: {
-            canvasId?: string;
-            cardId: string;
-            cardSpec: unknown;
-            /** @description 读取到的完整原卡内容，变化时返回HTTP409 */
-            expectedCardSpec: unknown;
-            /** @description 画布内顺序：不传 = 不改（转调 unssvr 时补 -1），传了原样透传；用指针区分「没传」和「传 0」 */
-            ord?: number | bigint;
-            position?: unknown;
+        AssetFileMultipartAbortResp: {
+            aborted: number | bigint;
         };
-        AgentCardUpdateResp: {
-            cardId: string;
+        AssetUploadReq: {
+            business?: string;
+            contentType?: string;
+            fileName: string;
+            isPublic?: boolean;
+            sha256?: string;
+            size?: number | bigint;
+            sizeBytes: number | bigint;
+            storageKey?: string;
+            useBy?: string;
         };
-        AgentJobCreateReq: {
-            cardId?: string;
-            cronExpr?: string;
-            expiresAt?: number | bigint;
-            intervalSeconds?: number | bigint;
-            name: string;
-            notify?: unknown;
-            scheduleKind: string;
-            sessionId: string;
-            sourceBlockId?: string;
-            sourceId?: string;
-            sourceName?: string;
-            sourceType: string;
-            task: unknown;
-            type?: string;
+        AssetUploadResp: {
+            filePath: string;
+            fileUrl?: string;
+            /** @description 先写入全部签名字段，再追加 file；policy 约束 key 和大小 */
+            postFields: {
+                [key: string]: string;
+            };
+            /** @description 预签名 POST 地址；multipart/form-data 上传 */
+            postUrl: string;
         };
-        AgentJobGetResp: {
-            job: components["schemas"]["AgentJobRecord"];
+        SendNotificationReq: {
+            channels?: ("web" | "mobile")[];
+            content: string;
+            idempotencyKey: string;
+            link?: string;
+            mode?: string;
+            recipientUserId: string;
+            sender?: components["schemas"]["NotificationSender"];
+            /** @description 已废弃：过渡期作 sender.name 别名（sender.name 优先），后续移除 */
+            source?: string;
+            title: string;
+            type: string;
         };
-        AgentJobIDReq: {
-            jobId: string;
+        NotificationSender: {
+            /** @description app 必填=appId（agent-platform UUID）；other 可选；system 可选；字符集 [0-9a-zA-Z-]{1,128} */
+            id?: string;
+            /** @description 类型专属附加信息，序列化后≤500字节 */
+            meta?: {
+                [key: string]: string;
+            };
+            /** @description 人读显示名（接替废弃的 source），≤100字符 */
+            name?: string;
+            /**
+             * @description 枚举 app/other/system，缺省 other；system=平台内部服务，仅 usage_type=internal 的 API key 可用（否则 400），建信归 workspace 分组（System tab）
+             * @default other
+             * @enum {string}
+             */
+            type?: "app" | "other" | "system";
         };
-        AgentJobListReq: {
-            cardId?: string;
-            page: number | bigint;
-            search?: string;
-            size: number | bigint;
-            sourceId?: string;
-            sourceType?: string;
-            status?: string;
-            type?: string;
+        SendNotificationResp: {
+            createdAt: string;
+            messageId: string;
+            status: string;
         };
-        AgentJobListResp: {
-            list: components["schemas"]["AgentJobRecord"][];
-            page: number | bigint;
-            size: number | bigint;
-            total: number | bigint;
+        NotificationError: {
+            errorCode: string;
+            message: string;
         };
-        AgentJobMutationResp: {
-            jobId: string;
+        GetNotificationReq: {
+            messageId: string;
         };
-        AgentJobRecord: {
-            attentionReason: string;
-            cardId: string;
-            createdAt: number | bigint;
-            cronExpr: string;
-            expiresAt: number | bigint;
-            intervalSeconds: number | bigint;
-            jobId: string;
-            lastFiredAt: number | bigint;
-            name: string;
-            nextRunAt: number | bigint;
-            notify?: unknown;
-            orphanedAt: number | bigint;
-            scheduleKind: string;
-            sessionId: string;
-            sourceBlockId: string;
-            sourceId: string;
-            sourceName: string;
-            sourceType: string;
+        GetNotificationResp: {
+            completedAt?: string;
+            createdAt: string;
+            errorCode?: string;
+            message?: string;
+            messageId: string;
             status: string;
-            task: unknown;
             type: string;
-            updatedAt: number | bigint;
         };
-        AgentJobRunGetReq: {
-            jobId: string;
-            jobRunId: string;
-        };
-        AgentJobRunGetResp: {
-            run: components["schemas"]["AgentJobRunRecord"];
+        PlatformGetMembersReq: {
+            keyword?: string;
+            page?: number | bigint;
+            roleKey?: string;
+            roles?: string[];
+            size?: number | bigint;
+            statuses?: string[];
+            updatedAtEnd?: string;
+            updatedAtStart?: string;
         };
-        AgentJobRunListReq: {
-            jobId: string;
+        PlatformMembersResp: {
+            list: components["schemas"]["PlatformMemberResp"][];
             page: number | bigint;
             size: number | bigint;
-            status?: string;
+            total: number | bigint;
         };
-        AgentJobRunListResp: {
-            list: components["schemas"]["AgentJobRunRecord"][];
+        PlatformMemberResp: {
+            email?: string;
+            nickName?: string;
+            roles: components["schemas"]["PlatformMemberRoleResp"][];
+            status: string;
+            updatedAt: string;
+            userId: string;
+            userName?: string;
+        };
+        PlatformMemberRoleResp: {
+            description?: string;
+            roleId: string;
+            roleKey: string;
+            roleName?: string;
+        };
+        AppAccessMembersListReq: {
+            appId: string;
+            /** @description 毫秒，闭区间，精度为秒 */
+            grantedAtEnd?: number | bigint;
+            /** @description 毫秒，闭区间，精度为秒 */
+            grantedAtStart?: number | bigint;
+            page?: number | bigint;
+            /** @description 任一命中即可，大小写不敏感 */
+            roleKeys?: string[];
+            size?: number | bigint;
+        };
+        AppAccessMembersListResp: {
+            /** @description 1:所有 active 成员都可访问 2:按角色授权 */
+            allActiveMembers: number | bigint;
+            appId: string;
+            list: components["schemas"]["AppAccessMemberResp"][];
             page: number | bigint;
+            productionVersionId?: string;
+            /** @description 1:已发布 2:未发布 */
+            published: number | bigint;
+            roles: components["schemas"]["AppAccessRoleResp"][];
             size: number | bigint;
             total: number | bigint;
         };
-        AgentJobRunRecord: {
-            dispatchState: string;
-            errorCode?: string;
-            errorMessage?: string;
-            finishedAt?: number | bigint;
-            firedAt: number | bigint;
-            jobId: string;
-            jobRunId: string;
-            resultId?: string;
-            resultSummary?: unknown;
-            severity?: string;
-            status: string;
-            trigger?: string;
-        };
-        AgentJobTriggerResp: {
-            dispatchState: string;
-            jobId: string;
-            jobRunId: string;
+        AppAccessMemberResp: {
+            email?: string;
+            /** @description 毫秒 */
+            grantedAt: number | bigint;
+            roles: components["schemas"]["AppAccessMemberRoleResp"][];
+            userId: string;
+            userName?: string;
         };
-        AgentJobUpdateReq: {
-            cardId?: string;
-            cronExpr?: string;
-            expiresAt?: number | bigint;
-            intervalSeconds?: number | bigint;
-            jobId: string;
-            name?: string;
-            notify?: unknown;
-            /** @description 省略沿用原通知，1必须提供notify对象，2关闭通知且不提供notify */
-            notifyEnabled?: number | bigint;
-            scheduleKind?: string;
-            sessionId?: string;
-            sourceBlockId?: string;
-            sourceId?: string;
-            sourceName?: string;
-            sourceType?: string;
-            task?: unknown;
-            type?: string;
+        AppAccessMemberRoleResp: {
+            roleId: string;
+            roleKey: string;
+            roleName: string;
+            sources: components["schemas"]["AppAccessRoleSourceResp"][];
         };
-        AgentLibraryCreateReq: {
-            cardKey: string;
-            cardSpec: unknown;
-            sourceSessionId?: string;
-            tags?: string[];
+        AppAccessRoleSourceResp: {
+            groupId?: string;
+            groupName?: string;
+            /** @description direct / group */
+            type: string;
         };
-        AgentLibraryGetReq: {
-            libraryItemId: string;
+        AppAccessRoleResp: {
+            description?: string;
+            memberCount: number | bigint;
+            roleId: string;
+            roleKey: string;
+            roleName: string;
+            /** @description active / retired */
+            status: string;
         };
-        AgentLibraryGetResp: {
-            item: components["schemas"]["AgentLibraryItem"];
+        MqttAuthCreateReq: {
+            clientIDRandomSuffixEnabled?: boolean;
+            description?: string;
+            name: string;
         };
-        AgentLibraryItem: {
-            cardKey: string;
-            cardSpec: unknown;
-            createdAt: number | bigint;
-            libraryItemId: string;
-            sourceSessionId: string;
-            tags: string[];
-            updatedAt: number | bigint;
+        MqttAuthCreateResp: {
+            clientID: string;
+            clientIDRandomSuffixEnabled: boolean;
+            id: number | bigint;
+            name: string;
+            password: string;
+            username: string;
         };
-        AgentLibraryListReq: {
-            page: number | bigint;
-            search?: string;
-            size: number | bigint;
-            tags?: string[];
+        MqttAuthDeleteReq: {
+            id: number | bigint;
         };
-        AgentLibraryListResp: {
-            list: components["schemas"]["AgentLibraryItem"][];
-            page: number | bigint;
-            size: number | bigint;
-            total: number | bigint;
+        MqttAuthDeleteResp: {
+            success: boolean;
         };
-        AgentLibraryMutationResp: {
-            libraryItemId: string;
+        /**
+         * Tier0 capability discovery
+         * @description OpenAPI 3.0 wire schema. Array contains/cardinality annotations and cross-field proof ordering require the shared JSON Schema plus SDK semantic checks; this projection alone is not full contract acceptance.
+         */
+        CapabilityDiscoverV2Resp: {
+            /** @enum {unknown} */
+            product: "cloud" | "enterprise";
+            productVersion?: string;
+            /** @enum {unknown} */
+            contractVersion: "1.0";
+            apiContractVersions: string[];
+            sdkContractVersions: string[];
+            capabilities: components["schemas"]["CapabilityDiscoverycapability"][] & (unknown & unknown & unknown & unknown & unknown);
+            deprecations: {
+                contract: string;
+                replacement?: string;
+                sunsetAt?: string;
+            }[];
+        } & (unknown | {
+            apiContractVersions?: unknown[];
+        });
+        /** @description Unknown capability codes are ignored; only recognized codes use the frozen assessment contract. */
+        CapabilityDiscoverycapability: {
+            code: string;
+        } & (unknown | components["schemas"]["CapabilityDiscoveryknownCapability"]);
+        CapabilityDiscoveryknownCapability: {
+            releaseEnabled: boolean;
+            enabled: boolean;
+            allowed: boolean;
+            /** @enum {unknown} */
+            state: "disabled" | "not_supported" | "unavailable" | "readiness_unknown" | "ready";
+            /** @enum {unknown} */
+            availability: "unavailable" | "unknown" | "available";
+            reasonCode?: string;
+            /** Format: date-time */
+            checkedAt?: string;
+            /**
+             * Format: date-time
+             * @description Proof expiry must follow checkedAt. Cross-field chronological ordering is a semantic constraint checked by consumers in addition to this structural JSON Schema.
+             */
+            validUntil?: string;
+            retryAfterMs?: number | bigint;
+            code: string;
+            contractVersions: string[];
+            operations?: components["schemas"]["CapabilityDiscoveryoperation"][];
+        } & (((unknown | {
+            /** @enum {unknown} */
+            enabled?: true;
+            /** @enum {unknown} */
+            releaseEnabled?: true;
+            /** @enum {unknown} */
+            allowed?: true;
+            /** @enum {unknown} */
+            availability?: "available";
+        }) & ({
+            /** @enum {unknown} */
+            state?: "ready";
+        } | {
+            /** @enum {unknown} */
+            enabled?: false;
+        })) & ((unknown | {
+            /** @enum {unknown} */
+            releaseEnabled?: false;
+        }) & ({
+            /** @enum {unknown} */
+            state?: "disabled";
+        } | {
+            /** @enum {unknown} */
+            releaseEnabled?: true;
+        })) & (unknown | {
+            /** @enum {unknown} */
+            availability?: "unknown";
+        }) & (unknown | {
+            /** @enum {unknown} */
+            availability?: "unavailable";
+        }) & (unknown | {
+            /** @enum {unknown} */
+            state?: "ready";
+            checkedAt: unknown;
+        }) & (unknown | ({
+            operations?: ((unknown | components["schemas"]["CapabilityDiscoveryknownOperation"]) & (unknown | {
+                /** @enum {unknown} */
+                requiresResourceCheck?: true;
+            }))[] & (unknown & unknown & unknown & unknown & unknown & unknown);
+        } & (unknown | {
+            operations?: (unknown | {
+                /** @enum {unknown} */
+                releaseEnabled?: false;
+            })[];
+        }))) & (unknown | ({
+            operations?: ((unknown | components["schemas"]["CapabilityDiscoveryknownOperation"]) & (unknown | {
+                /** @enum {unknown} */
+                requiresResourceCheck?: true;
+            }))[] & (unknown & unknown & unknown & unknown & unknown & unknown);
+        } & (unknown | {
+            operations?: (unknown | {
+                /** @enum {unknown} */
+                releaseEnabled?: false;
+            })[];
+        }))) & (unknown | {
+            contractVersions?: unknown[];
+        }) & (unknown | {
+            contractVersions?: unknown[] & (unknown & unknown);
+        }));
+        /** @description Unknown operation names are ignored within their parent capability; known names are validated by that capability. */
+        CapabilityDiscoveryoperation: {
+            operation: string;
+        };
+        CapabilityDiscoveryknownOperation: {
+            releaseEnabled: boolean;
+            enabled: boolean;
+            allowed: boolean;
+            /** @enum {unknown} */
+            state: "disabled" | "not_supported" | "unavailable" | "readiness_unknown" | "ready";
+            /** @enum {unknown} */
+            availability: "unavailable" | "unknown" | "available";
+            reasonCode?: string;
+            /** Format: date-time */
+            checkedAt?: string;
+            /**
+             * Format: date-time
+             * @description Proof expiry must follow checkedAt. Cross-field chronological ordering is a semantic constraint checked by consumers in addition to this structural JSON Schema.
+             */
+            validUntil?: string;
+            retryAfterMs?: number | bigint;
+            operation: string;
+            requiresResourceCheck: boolean;
+        } & (((unknown | {
+            /** @enum {unknown} */
+            enabled?: true;
+            /** @enum {unknown} */
+            releaseEnabled?: true;
+            /** @enum {unknown} */
+            allowed?: true;
+            /** @enum {unknown} */
+            availability?: "available";
+        }) & ({
+            /** @enum {unknown} */
+            state?: "ready";
+        } | {
+            /** @enum {unknown} */
+            enabled?: false;
+        })) & ((unknown | {
+            /** @enum {unknown} */
+            releaseEnabled?: false;
+        }) & ({
+            /** @enum {unknown} */
+            state?: "disabled";
+        } | {
+            /** @enum {unknown} */
+            releaseEnabled?: true;
+        })) & (unknown | {
+            /** @enum {unknown} */
+            availability?: "unknown";
+        }) & (unknown | {
+            /** @enum {unknown} */
+            availability?: "unavailable";
+        }) & (unknown | {
+            /** @enum {unknown} */
+            state?: "ready";
+            checkedAt: unknown;
+        }));
+        CapabilityErrorResp: {
+            /** @description INVALID_CREDENTIAL / CAPABILITY_INVALID_REQUEST / CAPABILITY_FORBIDDEN / CAPABILITY_UNAVAILABLE / CAPABILITY_INTERNAL_ERROR */
+            errorCode: string;
+            /** @description 固定公开消息，不透传内部异常 */
+            message: string;
         };
-        AgentLibrarySnapshot: {
-            cardKey: string;
-            cardSpec: unknown;
-            sourceSessionId: string;
-            tags: string[];
+        AgentCardGetReq: {
+            canvasId: string;
+            cardId: string;
         };
-        AgentLibraryUpdateReq: {
+        AgentCardGetResp: {
+            canvasId: string;
+            cardId: string;
+            cardKey: string;
             cardSpec: unknown;
-            expectedItem: components["schemas"]["AgentLibrarySnapshot"];
-            libraryItemId: string;
-            sourceSessionId?: string;
-            tags?: string[];
+            updatedAt: number | bigint;
         };
         AgentResultCreateReq: {
             cardSpec?: unknown;
@@ -1134,6 +1341,13 @@ export interface components {
             title: string;
             warnings?: string[];
         };
+        AgentResultSource: {
+            agentId: string;
+            platformRunId?: string;
+            platformSessionId: string;
+            platformUserId?: string;
+            skillVersion?: string;
+        };
         AgentResultCreateResp: {
             jobRunId: string;
             resultId: string;
@@ -1146,32 +1360,6 @@ export interface components {
         AgentResultGetResp: {
             result: components["schemas"]["AgentStoredResult"];
         };
-        AgentResultListReq: {
-            page: number | bigint;
-            platformSessionId?: string;
-            size: number | bigint;
-        };
-        AgentResultListResp: {
-            list: components["schemas"]["AgentStoredResult"][];
-            page: number | bigint;
-            size: number | bigint;
-            total: number | bigint;
-        };
-        AgentResultPinReq: {
-            canvasId: string;
-            position?: unknown;
-            resultId: string;
-        };
-        AgentResultPinResp: {
-            cardId: string;
-        };
-        AgentResultSource: {
-            agentId: string;
-            platformRunId?: string;
-            platformSessionId: string;
-            platformUserId?: string;
-            skillVersion?: string;
-        };
         AgentStoredResult: {
             agentId: string;
             byteSize: number | bigint;
@@ -1185,324 +1373,266 @@ export interface components {
             skillVersion: string;
             sourceKind: string;
         };
-        AppAccessMemberResp: {
-            email?: string;
-            /** @description 毫秒 */
-            grantedAt: number | bigint;
-            roles: components["schemas"]["AppAccessMemberRoleResp"][];
-            userId: string;
-            userName?: string;
-        };
-        AppAccessMemberRoleResp: {
-            roleId: string;
-            roleKey: string;
-            roleName: string;
-            sources: components["schemas"]["AppAccessRoleSourceResp"][];
-        };
-        AppAccessMembersListReq: {
-            appId: string;
-            /** @description 毫秒，闭区间，精度为秒 */
-            grantedAtEnd?: number | bigint;
-            /** @description 毫秒，闭区间，精度为秒 */
-            grantedAtStart?: number | bigint;
-            page?: number | bigint;
-            /** @description 任一命中即可，大小写不敏感 */
-            roleKeys?: string[];
-            size?: number | bigint;
+        AgentResultListReq: {
+            page: number | bigint;
+            platformSessionId?: string;
+            size: number | bigint;
         };
-        AppAccessMembersListResp: {
-            /** @description 1:所有 active 成员都可访问 2:按角色授权 */
-            allActiveMembers: number | bigint;
-            appId: string;
-            list: components["schemas"]["AppAccessMemberResp"][];
+        AgentResultListResp: {
+            list: components["schemas"]["AgentStoredResult"][];
             page: number | bigint;
-            productionVersionId?: string;
-            /** @description 1:已发布 2:未发布 */
-            published: number | bigint;
-            roles: components["schemas"]["AppAccessRoleResp"][];
             size: number | bigint;
             total: number | bigint;
         };
-        AppAccessRoleResp: {
-            description?: string;
-            memberCount: number | bigint;
-            roleId: string;
-            roleKey: string;
-            roleName: string;
-            /** @description active / retired */
-            status: string;
-        };
-        AppAccessRoleSourceResp: {
-            groupId?: string;
-            groupName?: string;
-            /** @description direct / group */
-            type: string;
+        AgentCardUpdateReq: {
+            canvasId?: string;
+            cardId: string;
+            cardSpec: unknown;
+            /** @description 读取到的完整原卡内容，变化时返回HTTP409 */
+            expectedCardSpec: unknown;
+            /** @description 画布内顺序：不传 = 不改（转调 unssvr 时补 -1），传了原样透传；用指针区分「没传」和「传 0」 */
+            ord?: number | bigint;
+            position?: unknown;
         };
-        AssetFileDeleteReq: {
-            filePath: string;
+        AgentCardUpdateResp: {
+            cardId: string;
         };
-        AssetFileDeleteResp: {
-            deleted: boolean;
+        AgentCardListReq: {
+            canvasId: string;
+            page: number | bigint;
+            size: number | bigint;
         };
-        AssetFileMultipartAbortReq: {
-            fileKey: string;
-            uploadId: string;
+        AgentCardListResp: {
+            list: components["schemas"]["AgentCardGetResp"][];
+            page: number | bigint;
+            size: number | bigint;
+            total: number | bigint;
         };
-        AssetFileMultipartAbortResp: {
-            aborted: number | bigint;
+        AgentResultPinReq: {
+            canvasId: string;
+            position?: unknown;
+            resultId: string;
         };
-        AssetFileMultipartCompleteReq: {
-            fileKey: string;
-            parts: components["schemas"]["AssetFileMultipartPart"][];
-            uploadId: string;
+        AgentResultPinResp: {
+            cardId: string;
         };
-        AssetFileMultipartCompleteResp: {
+        AgentJobCreateReq: {
+            cardId?: string;
+            cronExpr?: string;
             expiresAt?: number | bigint;
-            filePath: string;
-            fileUrl?: string;
-            sizeBytes: number | bigint;
+            intervalSeconds?: number | bigint;
+            name: string;
+            notify?: unknown;
+            scheduleKind: string;
+            sessionId: string;
+            sourceBlockId?: string;
+            sourceId?: string;
+            sourceName?: string;
+            sourceType: string;
+            task: unknown;
+            type?: string;
         };
-        AssetFileMultipartInitReq: {
-            appInstanceId?: string;
-            bizId?: string;
-            business?: string;
-            contentType?: string;
-            fileName: string;
-            partSize?: number | bigint;
+        AgentJobMutationResp: {
+            jobId: string;
+        };
+        AgentJobUpdateReq: {
+            cardId?: string;
+            cronExpr?: string;
+            expiresAt?: number | bigint;
+            intervalSeconds?: number | bigint;
+            jobId: string;
+            name?: string;
+            notify?: unknown;
+            /** @description 省略沿用原通知，1必须提供notify对象，2关闭通知且不提供notify */
+            notifyEnabled?: number | bigint;
+            scheduleKind?: string;
             sessionId?: string;
-            size: number | bigint;
-            useBy?: string;
-            visibility?: string;
+            sourceBlockId?: string;
+            sourceId?: string;
+            sourceName?: string;
+            sourceType?: string;
+            task?: unknown;
+            type?: string;
         };
-        AssetFileMultipartInitResp: {
-            expiresAt: number | bigint;
-            fileKey: string;
-            filePath: string;
-            partCount: number | bigint;
-            partSize: number | bigint;
-            uploadId: string;
+        AgentJobIDReq: {
+            jobId: string;
         };
-        AssetFileMultipartPart: {
-            etag: string;
-            partNumber: number | bigint;
+        AgentJobGetResp: {
+            job: components["schemas"]["AgentJobRecord"];
         };
-        AssetFileMultipartPartUrl: {
+        AgentJobRecord: {
+            attentionReason: string;
+            cardId: string;
+            createdAt: number | bigint;
+            cronExpr: string;
             expiresAt: number | bigint;
-            partNumber: number | bigint;
-            url: string;
-        };
-        AssetFileMultipartPartUrlsReq: {
-            fileKey: string;
-            partNumbers: (number | bigint)[];
-            uploadId: string;
-        };
-        AssetFileMultipartPartUrlsResp: {
-            partUrls: components["schemas"]["AssetFileMultipartPartUrl"][];
-        };
-        AssetFileUploadReq: {
-            appInstanceId?: string;
-            business?: string;
-            contentType?: string;
-            fileName: string;
-            sessionId?: string;
-            size: number | bigint;
-            useBy?: string;
-            visibility?: string;
+            intervalSeconds: number | bigint;
+            jobId: string;
+            lastFiredAt: number | bigint;
+            name: string;
+            nextRunAt: number | bigint;
+            notify?: unknown;
+            orphanedAt: number | bigint;
+            scheduleKind: string;
+            sessionId: string;
+            sourceBlockId: string;
+            sourceId: string;
+            sourceName: string;
+            sourceType: string;
+            status: string;
+            task: unknown;
+            type: string;
+            updatedAt: number | bigint;
         };
-        AssetFileUploadResp: {
-            expiresAt?: number | bigint;
-            fileId?: number | bigint;
-            filePath: string;
-            fileUrl?: string;
-            /** @description 先写入全部签名字段，再追加 file；policy 约束 key 和大小 */
-            postFields: {
-                [key: string]: string;
-            };
-            /** @description 预签名 POST 地址；multipart/form-data 上传 */
-            postUrl: string;
+        AgentJobListReq: {
+            cardId?: string;
+            page: number | bigint;
+            search?: string;
+            size: number | bigint;
+            sourceId?: string;
+            sourceType?: string;
+            /** @description active / paused / needs_attention / expired */
+            status?: string;
+            type?: string;
         };
-        AssetFileUrlResp: {
-            expiresAt?: number | bigint;
-            fileUrl: string;
+        AgentJobListResp: {
+            list: components["schemas"]["AgentJobRecord"][];
+            page: number | bigint;
+            size: number | bigint;
+            total: number | bigint;
         };
-        AssetUploadReq: {
-            business?: string;
-            contentType?: string;
-            fileName: string;
-            isPublic?: boolean;
-            sha256?: string;
-            size?: number | bigint;
-            sizeBytes: number | bigint;
-            storageKey?: string;
-            useBy?: string;
+        AgentJobRunGetReq: {
+            jobId: string;
+            jobRunId: string;
         };
-        AssetUploadResp: {
-            filePath: string;
-            fileUrl?: string;
-            /** @description 先写入全部签名字段，再追加 file；policy 约束 key 和大小 */
-            postFields: {
-                [key: string]: string;
-            };
-            /** @description 预签名 POST 地址；multipart/form-data 上传 */
-            postUrl: string;
+        AgentJobRunGetResp: {
+            run: components["schemas"]["AgentJobRunRecord"];
         };
-        AuthWhoamiResp: {
-            apiKeyName: string;
-            email: string;
-            keyPrefix: string;
-            keyType: string;
-            permissions: string[];
-            roles: string[];
-            userID: number | bigint;
-            userName: string;
-            workspaceID: number | bigint;
-            workspaceName: string;
+        AgentJobRunRecord: {
+            dispatchState: string;
+            errorCode?: string;
+            errorMessage?: string;
+            finishedAt?: number | bigint;
+            firedAt: number | bigint;
+            jobId: string;
+            jobRunId: string;
+            resultId?: string;
+            resultSummary?: unknown;
+            severity?: string;
+            status: string;
+            trigger?: string;
         };
-        CapabilityDeprecation: {
-            contract: string;
-            replacement?: string;
-            sunsetAt?: string;
+        AgentJobRunListReq: {
+            jobId: string;
+            page: number | bigint;
+            size: number | bigint;
+            status?: string;
         };
-        CapabilityDiscoverResp: {
-            /** @description openapi/v1 */
-            apiContractVersions: string[];
-            /** @description 只返回当前 Key 有授权摘要的已知能力，关闭的能力仍返回状态 */
-            capabilities: components["schemas"]["PublicCapability"][];
-            /** @description 本发现响应合同版本，与单个 Control 的冻结合同版本独立 */
-            contractVersion: string;
-            deprecations: components["schemas"]["CapabilityDeprecation"][];
-            product: string;
-            /** @description 仅返回显式配置的可信产品发布版本，未配置时省略 */
-            productVersion?: string;
-            /** @description control/v1 公共 SDK 合同，不是 npm 版本 */
-            sdkContractVersions: string[];
+        AgentJobRunListResp: {
+            list: components["schemas"]["AgentJobRunRecord"][];
+            page: number | bigint;
+            size: number | bigint;
+            total: number | bigint;
         };
-        CapabilityErrorResp: {
-            /** @description INVALID_CREDENTIAL / CAPABILITY_INVALID_REQUEST / CAPABILITY_FORBIDDEN / CAPABILITY_UNAVAILABLE / CAPABILITY_INTERNAL_ERROR */
-            errorCode: string;
-            /** @description 固定公开消息，不透传内部异常 */
-            message: string;
+        AgentJobTriggerResp: {
+            dispatchState: string;
+            jobId: string;
+            jobRunId: string;
         };
-        GetNotificationReq: {
-            messageId: string;
+        AgentCanvasListReq: {
+            page: number | bigint;
+            sessionId?: string;
+            size: number | bigint;
         };
-        GetNotificationResp: {
-            completedAt?: string;
-            createdAt: string;
-            errorCode?: string;
-            message?: string;
-            messageId: string;
-            status: string;
-            type: string;
+        AgentCanvasListResp: {
+            list: components["schemas"]["AgentCanvasRecord"][];
+            page: number | bigint;
+            size: number | bigint;
+            total: number | bigint;
         };
-        InfoResp: {
-            capabilities: string[];
-            mqttBroker: string;
+        AgentCanvasRecord: {
+            canvasId: string;
+            createdAt: number | bigint;
             name: string;
-            /** @description API version of the requested HTTP entry point */
-            version: string;
+            sessionId: string;
+            updatedAt: number | bigint;
         };
-        MqttAuthCreateReq: {
-            clientIDRandomSuffixEnabled?: boolean;
-            description?: string;
-            name: string;
+        AgentLibraryListReq: {
+            page: number | bigint;
+            search?: string;
+            size: number | bigint;
+            tags?: string[];
         };
-        MqttAuthCreateResp: {
-            clientID: string;
-            clientIDRandomSuffixEnabled: boolean;
-            id: number | bigint;
-            name: string;
-            password: string;
-            username: string;
+        AgentLibraryListResp: {
+            list: components["schemas"]["AgentLibraryItem"][];
+            page: number | bigint;
+            size: number | bigint;
+            total: number | bigint;
         };
-        MqttAuthDeleteReq: {
-            id: number | bigint;
+        AgentLibraryItem: {
+            cardKey: string;
+            cardSpec: unknown;
+            createdAt: number | bigint;
+            libraryItemId: string;
+            sourceSessionId: string;
+            tags: string[];
+            updatedAt: number | bigint;
         };
-        MqttAuthDeleteResp: {
-            success: boolean;
+        AgentLibraryGetReq: {
+            libraryItemId: string;
         };
-        NotificationSender: {
-            /** @description app 必填=appId（agent-platform UUID）；other 可选；system 可选；字符集 [0-9a-zA-Z-]{1,128} */
-            id?: string;
-            /** @description 类型专属附加信息，序列化后≤500字节 */
-            meta?: {
-                [key: string]: string;
-            };
-            /** @description 人读显示名（接替废弃的 source），≤100字符 */
-            name?: string;
-            /**
-             * @description 枚举 app/other/system，缺省 other；system=平台内部服务，仅 usage_type=internal 的 API key 可用（否则 400），建信归 workspace 分组（System tab）
-             * @default other
-             * @enum {string}
-             */
-            type?: "app" | "other" | "system";
+        AgentLibraryGetResp: {
+            item: components["schemas"]["AgentLibraryItem"];
         };
-        PlatformGetMembersReq: {
-            keyword?: string;
-            page?: number | bigint;
-            roleKey?: string;
-            roles?: string[];
-            size?: number | bigint;
-            statuses?: string[];
-            updatedAtEnd?: string;
-            updatedAtStart?: string;
+        AgentLibraryCreateReq: {
+            cardKey: string;
+            cardSpec: unknown;
+            sourceSessionId?: string;
+            tags?: string[];
         };
-        PlatformMemberResp: {
-            email?: string;
-            nickName?: string;
-            roles: components["schemas"]["PlatformMemberRoleResp"][];
-            status: string;
-            updatedAt: string;
-            userId: string;
-            userName?: string;
+        AgentLibraryMutationResp: {
+            libraryItemId: string;
         };
-        PlatformMemberRoleResp: {
-            description?: string;
-            roleId: string;
-            roleKey: string;
-            roleName?: string;
+        AgentLibraryUpdateReq: {
+            cardSpec: unknown;
+            expectedItem: components["schemas"]["AgentLibrarySnapshot"];
+            libraryItemId: string;
+            sourceSessionId?: string;
+            tags?: string[];
         };
-        PlatformMembersResp: {
-            list: components["schemas"]["PlatformMemberResp"][];
-            page: number | bigint;
-            size: number | bigint;
-            total: number | bigint;
+        AgentLibrarySnapshot: {
+            cardKey: string;
+            cardSpec: unknown;
+            sourceSessionId: string;
+            tags: string[];
         };
-        PublicCapability: {
-            /** @description 当前 Key 的能力授权摘要，不替代具体 Control code 与读写权限检查 */
-            allowed: boolean;
-            /** @description unavailable / unknown / available；不是设备在线或执行成功证明 */
-            availability: string;
-            code: string;
-            contractVersions: string[];
-            /** @description 仅发布、实现和 readiness 均满足时为 true */
-            enabled: boolean;
-            /** @description 公开发布开关与当前 Workspace 灰度的交集，不表示 runtime 就绪 */
-            releaseEnabled: boolean;
-            /** @description disabled / not_supported / unavailable / readiness_unknown / ready */
-            state: string;
+        AgentCardDeleteReq: {
+            canvasId: string;
+            cardId: string;
+            expectedCardSpec: unknown;
         };
-        SendNotificationReq: {
-            channels?: ("web" | "mobile")[];
-            content: string;
-            idempotencyKey: string;
-            link?: string;
-            mode?: string;
-            recipientUserId: string;
-            sender?: components["schemas"]["NotificationSender"];
-            /** @description 已废弃：过渡期作 sender.name 别名（sender.name 优先），后续移除 */
-            source?: string;
-            title: string;
-            type: string;
+        AgentCardDeleteResp: {
+            cardId: string;
         };
-        SendNotificationResp: {
-            createdAt: string;
-            messageId: string;
-            status: string;
+        AgentAnalysisDispatchReq: {
+            canvasId?: string;
+            cardId?: string;
+            kind: string;
+            operationId: string;
+            resultId?: string;
+            task: unknown;
         };
-        NotificationError: {
+        AgentAnalysisDispatchResp: {
+            dispatchState: string;
             errorCode: string;
-            message: string;
+            errorMessage: string;
+            runId: string;
+        };
+        AgentAnalysisGetReq: {
+            runId: string;
+        };
+        AgentAnalysisGetResp: {
+            run: components["schemas"]["AgentJobRunRecord"];
         };
         SdksystemInfoData: components["schemas"]["InfoResp"];
         SdksystemInfoWire: {
@@ -1615,7 +1745,7 @@ export interface components {
             msg: string;
             data: components["schemas"]["SdkmqttAuthDeleteData"];
         };
-        SdkcapabilitiesDiscoverData: components["schemas"]["CapabilityDiscoverResp"];
+        SdkcapabilitiesDiscoverData: components["schemas"]["CapabilityDiscoverV2Resp"];
         SdkcapabilitiesDiscoverWire: components["schemas"]["SdkcapabilitiesDiscoverData"];
         SdkagentCardsGetRequest: components["schemas"]["AgentCardGetReq"];
         SdkagentCardsGetData: components["schemas"]["AgentCardGetResp"];