@fa-software/semi2-dsh 0.0.10-preview.20260920042705

package/lib/types/configuration/generated/schema.d.ts

@@ -0,0 +1,1003 @@
+export type Maybe<T> = T | null;
+export type InputMaybe<T> = Maybe<T>;
+/** All built-in and custom scalars, mapped to their actual values */
+export type Scalars = {
+    ID: {
+        input: string;
+        output: string;
+    };
+    String: {
+        input: string;
+        output: string;
+    };
+    Boolean: {
+        input: boolean;
+        output: boolean;
+    };
+    Int: {
+        input: number;
+        output: number;
+    };
+    Float: {
+        input: number;
+        output: number;
+    };
+    DateTime: {
+        input: string;
+        output: string;
+    };
+};
+export type Activation = {
+    __typename?: 'Activation';
+    expiresAt: Scalars['DateTime']['output'];
+    url: Scalars['String']['output'];
+};
+export type AddCnbUsersInput = {
+    /** 要预建账户的上游成员 CNB 用户 ID；本轮上游没返回的会被跳过。 */
+    externalUserIds: Array<Scalars['String']['input']>;
+};
+/** CNB 接入密钥（Hub 生成、经 secret import 注入 CNB 环境；服务端只存摘要）。 */
+export type CnbAccessKey = {
+    __typename?: 'CnbAccessKey';
+    createdAt: Scalars['DateTime']['output'];
+    /** 明文前缀提示；完整明文只在创建 / 刷新时返回一次。 */
+    hint: Scalars['String']['output'];
+    id: Scalars['ID']['output'];
+    lastUsedAt?: Maybe<Scalars['DateTime']['output']>;
+    name: Scalars['String']['output'];
+    rotatedAt?: Maybe<Scalars['DateTime']['output']>;
+};
+/** 创建 / 刷新接入密钥的结果：明文只此一次返回。 */
+export type CnbAccessKeyCreated = {
+    __typename?: 'CnbAccessKeyCreated';
+    /** 注入 CNB 环境 SEMI2_ACCESS_TOKEN 的明文密钥；关闭后无法再次查看。 */
+    key: Scalars['String']['output'];
+    record: CnbAccessKey;
+};
+/** 账户自己的 CNB 身份；个人令牌密文永不出库，未绑定令牌时两个校验时间为空。 */
+export type CnbAccount = {
+    __typename?: 'CnbAccount';
+    avatar?: Maybe<Scalars['String']['output']>;
+    externalUserId: Scalars['String']['output'];
+    membershipVerifiedAt?: Maybe<Scalars['DateTime']['output']>;
+    nickname?: Maybe<Scalars['String']['output']>;
+    organizationPath: Scalars['String']['output'];
+    state: CnbConnectionState;
+    username: Scalars['String']['output'];
+    verifiedAt?: Maybe<Scalars['DateTime']['output']>;
+};
+/** 账户的 CNB 连接态。AWAITING_BINDING = 账户由上游目录预建，还没绑定本人令牌。 */
+export declare enum CnbConnectionState {
+    AwaitingBinding = "AWAITING_BINDING",
+    Connected = "CONNECTED",
+    ReconnectRequired = "RECONNECT_REQUIRED"
+}
+/** 同步动作的真实统计；total 是本次上游看到的条目数。 */
+export type CnbSyncResult = {
+    __typename?: 'CnbSyncResult';
+    added: Scalars['Int']['output'];
+    removed: Scalars['Int']['output'];
+    total: Scalars['Int']['output'];
+    updated: Scalars['Int']['output'];
+};
+/** 按勾选预建账户的结果；skipped = 勾选里已注册或本次上游没返回的。 */
+export type CnbUserAddResult = {
+    __typename?: 'CnbUserAddResult';
+    added: Scalars['Int']['output'];
+    skipped: Scalars['Int']['output'];
+    total: Scalars['Int']['output'];
+};
+/** 一次运行面配置读取的记账行：读取者就是记账者本人，没有代表关系。 */
+export type ConfigurationRead = {
+    __typename?: 'ConfigurationRead';
+    actorDisplayName?: Maybe<Scalars['String']['output']>;
+    actorId?: Maybe<Scalars['ID']['output']>;
+    actorUsername?: Maybe<Scalars['String']['output']>;
+    /** 记账码，'READ' 表示读取成功。 */
+    code: Scalars['String']['output'];
+    id: Scalars['ID']['output'];
+    readAt: Scalars['DateTime']['output'];
+};
+/** 条件：userId 匹配读取者；from/to 为闭区间。 */
+export type ConfigurationReadFilter = {
+    code?: InputMaybe<Scalars['String']['input']>;
+    from?: InputMaybe<Scalars['DateTime']['input']>;
+    to?: InputMaybe<Scalars['DateTime']['input']>;
+    userId?: InputMaybe<Scalars['ID']['input']>;
+};
+export type ConfigurationReadPage = {
+    __typename?: 'ConfigurationReadPage';
+    items: Array<ConfigurationRead>;
+    nextCursor?: Maybe<Scalars['String']['output']>;
+};
+export type CreateCnbAccessKeyInput = {
+    /** 省略 = 默认名「CNB 接入密钥」。 */
+    name?: InputMaybe<Scalars['String']['input']>;
+};
+export type CreateProjectInput = {
+    name: Scalars['String']['input'];
+    slug: Scalars['String']['input'];
+};
+export type CreateSkillInput = {
+    /** 完整 SKILL.md；frontmatter 未知键与超限一律 SKILL_INVALID。 */
+    content: Scalars['String']['input'];
+    /** 可选：一次带附件建库（避免「新建即 v2」）。 */
+    files?: InputMaybe<Array<SkillFileInput>>;
+    /** 省略或显式 null = 全局技能。 */
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+};
+export type CreateUserInput = {
+    cnbToken: Scalars['String']['input'];
+    /** 从组织目录创建时传入，防止粘贴了另一人的 token。 */
+    expectedExternalUserId?: InputMaybe<Scalars['String']['input']>;
+    roles?: InputMaybe<Array<Role>>;
+};
+export declare enum DiscoveryErrorCode {
+    CredentialsNotConfigured = "CREDENTIALS_NOT_CONFIGURED",
+    DiscoveryUnsupported = "DISCOVERY_UNSUPPORTED",
+    InvalidModelCatalog = "INVALID_MODEL_CATALOG",
+    InvalidModelUrl = "INVALID_MODEL_URL",
+    ModelCatalogTooLarge = "MODEL_CATALOG_TOO_LARGE",
+    ModelUrlForbidden = "MODEL_URL_FORBIDDEN",
+    UpstreamCredentialsRejected = "UPSTREAM_CREDENTIALS_REJECTED",
+    UpstreamPaginationError = "UPSTREAM_PAGINATION_ERROR",
+    UpstreamRedirectForbidden = "UPSTREAM_REDIRECT_FORBIDDEN",
+    UpstreamResponseTooLarge = "UPSTREAM_RESPONSE_TOO_LARGE",
+    UpstreamTimeout = "UPSTREAM_TIMEOUT",
+    UpstreamUnavailable = "UPSTREAM_UNAVAILABLE"
+}
+export declare enum DiscoveryStatus {
+    Failed = "FAILED",
+    Never = "NEVER",
+    Stale = "STALE",
+    Success = "SUCCESS"
+}
+/** global_configuration 一行的领域读模型。 */
+export type GlobalConfiguration = {
+    __typename?: 'GlobalConfiguration';
+    preferences: Preferences;
+    revision: Scalars['Int']['output'];
+};
+export type ImportBuiltinModelsInput = {
+    connectionId: Scalars['ID']['input'];
+    expectedRevision: Scalars['Int']['input'];
+    /** 要接入的内置目录模型 ID；未勾选的不新增，已在目录中的行只刷新目录元数据。 */
+    upstreamIds: Array<Scalars['String']['input']>;
+};
+export declare enum InputModality {
+    Image = "IMAGE",
+    Text = "TEXT"
+}
+export type IssueActivationInput = {
+    userId: Scalars['ID']['input'];
+};
+export type MetadataEntry = {
+    __typename?: 'MetadataEntry';
+    field: MetadataField;
+    source: MetadataSource;
+};
+export declare enum MetadataField {
+    ContextWindow = "CONTEXT_WINDOW",
+    Input = "INPUT",
+    MaxTokens = "MAX_TOKENS",
+    ReasoningLevels = "REASONING_LEVELS"
+}
+/** 显式 null = 清除该项；省略 = 不改动。 */
+export type MetadataInput = {
+    contextWindow?: InputMaybe<Scalars['Int']['input']>;
+    input?: InputMaybe<Array<InputModality>>;
+    maxTokens?: InputMaybe<Scalars['Int']['input']>;
+    reasoningLevels?: InputMaybe<Array<ReasoningLevel>>;
+};
+/** 模型元数据来源的优先级：手工 > 目录（内置或上游发现）> dsh 默认。 */
+export declare enum MetadataSource {
+    Builtin = "BUILTIN",
+    Discovered = "DISCOVERED",
+    DshDefault = "DSH_DEFAULT",
+    Manual = "MANUAL"
+}
+/** 一条模型的完整事实：原始两层元数据 + 合并后的生效元数据。 */
+export type Model = {
+    __typename?: 'Model';
+    /** 行来自预设的内置目录；上游确认过就清掉它（存在性以 present 为准）。 */
+    builtin: Scalars['Boolean']['output'];
+    connection: ModelConnection;
+    discoveredMetadata: ModelMetadata;
+    displayName?: Maybe<Scalars['String']['output']>;
+    enabled: Scalars['Boolean']['output'];
+    id: Scalars['ID']['output'];
+    manual: Scalars['Boolean']['output'];
+    /** 按「手工 > 目录（内置或上游发现）> dsh 默认」合并后的生效元数据。 */
+    metadata: ModelMetadata;
+    metadataSources: Array<MetadataEntry>;
+    overrides: ModelMetadata;
+    present: Scalars['Boolean']['output'];
+    revision: Scalars['Int']['output'];
+    upstreamId: Scalars['String']['output'];
+};
+export type ModelConnection = {
+    __typename?: 'ModelConnection';
+    baseUrl: Scalars['String']['output'];
+    credentialRevision: Scalars['Int']['output'];
+    discoveryStatus: DiscoveryStatus;
+    displayName: Scalars['String']['output'];
+    enabled: Scalars['Boolean']['output'];
+    id: Scalars['ID']['output'];
+    /** 密钥是否已配置；密文永不出库。 */
+    keyConfigured: Scalars['Boolean']['output'];
+    lastDiscoveryAt?: Maybe<Scalars['DateTime']['output']>;
+    lastDiscoveryError?: Maybe<DiscoveryErrorCode>;
+    protocol: ModelProtocol;
+    /**
+     * 预设 id（= dsh 的提供方路由 id）；null = 自定义连接。
+     * 预设限定协议与默认地址，且模型只能来自内置目录或上游同步（保证运行面必然认得每个模型 id）。
+     */
+    provider?: Maybe<Scalars['String']['output']>;
+    revision: Scalars['Int']['output'];
+};
+export type ModelConnectionPage = {
+    __typename?: 'ModelConnectionPage';
+    items: Array<ModelConnection>;
+    nextCursor?: Maybe<Scalars['String']['output']>;
+};
+export type ModelCredentialInput = {
+    apiKey?: InputMaybe<SecretInput>;
+    connectionId: Scalars['ID']['input'];
+};
+/** user_model_credentials 一行的引用；不含密钥值。 */
+export type ModelCredentialRef = {
+    __typename?: 'ModelCredentialRef';
+    connectionId: Scalars['ID']['output'];
+    revision: Scalars['Int']['output'];
+};
+/** 条件：connectionId 限定某连接的目录；protocol 按所属连接的协议过滤。 */
+export type ModelFilter = {
+    connectionId?: InputMaybe<Scalars['ID']['input']>;
+    discoveryStatus?: InputMaybe<DiscoveryStatus>;
+    enabled?: InputMaybe<Scalars['Boolean']['input']>;
+    protocol?: InputMaybe<ModelProtocol>;
+};
+export type ModelMetadata = {
+    __typename?: 'ModelMetadata';
+    contextWindow?: Maybe<Scalars['Int']['output']>;
+    input?: Maybe<Array<InputModality>>;
+    maxTokens?: Maybe<Scalars['Int']['output']>;
+    reasoningLevels?: Maybe<Array<ReasoningLevel>>;
+};
+export type ModelPage = {
+    __typename?: 'ModelPage';
+    items: Array<Model>;
+    nextCursor?: Maybe<Scalars['String']['output']>;
+};
+export declare enum ModelProtocol {
+    Anthropic = "ANTHROPIC",
+    Deepseek = "DEEPSEEK",
+    OpenaiChat = "OPENAI_CHAT",
+    OpenaiResponses = "OPENAI_RESPONSES"
+}
+/** 一条可选用的提供方预设（对齐 dsh 的模型设置清单）。模型清单走 builtinModelCatalog。 */
+export type ModelProviderPreset = {
+    __typename?: 'ModelProviderPreset';
+    baseUrl: Scalars['String']['output'];
+    displayName: Scalars['String']['output'];
+    id: Scalars['ID']['output'];
+    /** 该预设在内置目录里可接入的模型条数（目录本身按需查询）。 */
+    modelCount: Scalars['Int']['output'];
+    protocol: ModelProtocol;
+};
+export type Mutation = {
+    __typename?: 'Mutation';
+    /** 按勾选把上游组织成员预建为待激活账户；账户仍需成员本人令牌激活后才有连接。 */
+    addCnbUsers: CnbUserAddResult;
+    /** 生成一枚 CNB 环境接入密钥；明文只此一次返回。 */
+    createCnbAccessKey: CnbAccessKeyCreated;
+    createProject: Project;
+    /** 新建技能（版本 1 = head）；作用域内重名即 SKILL_NAME_CONFLICT。 */
+    createSkill: Skill;
+    createUser: User;
+    /** 按勾选把内置目录的模型写进本地目录（导入即启用）；不读上游、不需要密钥。 */
+    importBuiltinModels: ModelConnection;
+    issueActivation: Activation;
+    /** 刷新（轮换）接入密钥；旧密钥立即失效，新明文只此一次返回。 */
+    refreshCnbAccessKey: CnbAccessKeyCreated;
+    /** 用已存 token 重新校验组织资格并刷新 CNB 资料。 */
+    refreshCnbAccount: CnbAccount;
+    /** 删附件（追加版本）；只删该版本清单里存在的 path。 */
+    removeSkillFiles: Skill;
+    /** 吊销接入密钥。 */
+    revokeCnbAccessKey: Scalars['ID']['output'];
+    saveGlobalConfiguration: GlobalConfiguration;
+    saveModel: Model;
+    saveModelConnection: ModelConnection;
+    saveProjectDetails: Project;
+    saveProjectHeadlessModels: Project;
+    /** 整份内容提交；同内容幂等不涨版本，expectedVersion 过期即 SKILL_VERSION_CONFLICT。 */
+    saveSkill: Skill;
+    saveUserConfiguration: UserConfiguration;
+    setModelEnabled: Model;
+    setProjectAccess: Project;
+    /** 归档 / 恢复：追加版本行；归档释放作用域内名称，恢复可能撞名。 */
+    setSkillArchived: Skill;
+    setUserRoles: User;
+    setUserStatus: User;
+    /** 按勾选拉当前管理员 token 可见仓库写本地；既有可见项目照常刷新，不可见项目保持原状。 */
+    syncCnbProjects: CnbSyncResult;
+    /** 读上游目录并按勾选写本地目录；返回刷新后的连接，发现结果读它的 discoveryStatus / lastDiscoveryError。 */
+    syncModelCatalog: ModelConnection;
+    /** 替换本人或指定用户的 CNB token；指定他人要求 ADMIN，且不得换绑 CNB 身份。 */
+    updateCnbToken: CnbAccount;
+    /** 本人写自己的用户层配置（个人模型密钥覆盖）。 */
+    updateMyConfiguration: UserConfiguration;
+    /** 增 / 改附件（追加版本）；单文件 / 单次 / 整技能超限即拒绝。 */
+    writeSkillFiles: Skill;
+};
+export type MutationAddCnbUsersArgs = {
+    input: AddCnbUsersInput;
+};
+export type MutationCreateCnbAccessKeyArgs = {
+    input: CreateCnbAccessKeyInput;
+};
+export type MutationCreateProjectArgs = {
+    input: CreateProjectInput;
+};
+export type MutationCreateSkillArgs = {
+    input: CreateSkillInput;
+};
+export type MutationCreateUserArgs = {
+    input: CreateUserInput;
+};
+export type MutationImportBuiltinModelsArgs = {
+    input: ImportBuiltinModelsInput;
+};
+export type MutationIssueActivationArgs = {
+    input: IssueActivationInput;
+};
+export type MutationRefreshCnbAccessKeyArgs = {
+    id: Scalars['ID']['input'];
+};
+export type MutationRefreshCnbAccountArgs = {
+    input: RefreshCnbAccountInput;
+};
+export type MutationRemoveSkillFilesArgs = {
+    input: RemoveSkillFilesInput;
+};
+export type MutationRevokeCnbAccessKeyArgs = {
+    id: Scalars['ID']['input'];
+};
+export type MutationSaveGlobalConfigurationArgs = {
+    input: SaveGlobalInput;
+};
+export type MutationSaveModelArgs = {
+    input: SaveModelInput;
+};
+export type MutationSaveModelConnectionArgs = {
+    input: SaveModelConnectionInput;
+};
+export type MutationSaveProjectDetailsArgs = {
+    input: SaveProjectDetailsInput;
+};
+export type MutationSaveProjectHeadlessModelsArgs = {
+    input: SaveProjectHeadlessModelsInput;
+};
+export type MutationSaveSkillArgs = {
+    input: SaveSkillInput;
+};
+export type MutationSaveUserConfigurationArgs = {
+    input: SaveUserInput;
+};
+export type MutationSetModelEnabledArgs = {
+    input: SetModelEnabledInput;
+};
+export type MutationSetProjectAccessArgs = {
+    input: SetProjectAccessInput;
+};
+export type MutationSetSkillArchivedArgs = {
+    input: SetSkillArchivedInput;
+};
+export type MutationSetUserRolesArgs = {
+    input: SetUserRolesInput;
+};
+export type MutationSetUserStatusArgs = {
+    input: SetUserStatusInput;
+};
+export type MutationSyncCnbProjectsArgs = {
+    input: SyncCnbProjectsInput;
+};
+export type MutationSyncModelCatalogArgs = {
+    input: SyncModelCatalogInput;
+};
+export type MutationUpdateCnbTokenArgs = {
+    input: UpdateCnbTokenInput;
+};
+export type MutationUpdateMyConfigurationArgs = {
+    input: UpdateMyConfigurationInput;
+};
+export type MutationWriteSkillFilesArgs = {
+    input: WriteSkillFilesInput;
+};
+export type Preferences = {
+    __typename?: 'Preferences';
+    defaultModelId?: Maybe<Scalars['ID']['output']>;
+};
+export type PreferencesInput = {
+    /** 省略 = 不改；null = 清除。 */
+    defaultModelId?: InputMaybe<Scalars['ID']['input']>;
+};
+/**
+ * 项目本体 + 它的 CNB 配置表事实。模型引用为**存储值**，可能失效——
+ * 管理面展示「配了什么」，可用性判定在 client（拿 models 比对）。
+ */
+export type Project = {
+    __typename?: 'Project';
+    createdAt: Scalars['DateTime']['output'];
+    enabled: Scalars['Boolean']['output'];
+    executeModelId?: Maybe<Scalars['ID']['output']>;
+    /** project_cnb_configuration 行的 revision；无行时为 0，saveProjectHeadlessModels 的 CAS 取它。 */
+    headlessModelsRevision: Scalars['Int']['output'];
+    id: Scalars['ID']['output'];
+    kind: ProjectKind;
+    /** 仅管理员查询有值；client 与 users 连接得到成员详情。 */
+    members?: Maybe<Array<ProjectMember>>;
+    name: Scalars['String']['output'];
+    /** project_cnb_configuration：headless 计划 / 执行模型引用（存储值）。 */
+    planModelId?: Maybe<Scalars['ID']['output']>;
+    /** projects 行的 revision；saveProjectDetails / setProjectAccess 的 CAS 取它。 */
+    revision: Scalars['Int']['output'];
+    /** 服务端聚合：已撤销访问的账户数；仅管理员查询有值。 */
+    revokedCount?: Maybe<Scalars['Int']['output']>;
+    slug: Scalars['String']['output'];
+    upstreamStatus: UpstreamStatus;
+    webUrl?: Maybe<Scalars['String']['output']>;
+};
+/** 条件：search 匹配 slug / name；accessibleBy 限定某用户没被撤销访问的项目。 */
+export type ProjectFilter = {
+    accessibleBy?: InputMaybe<Scalars['ID']['input']>;
+    enabled?: InputMaybe<Scalars['Boolean']['input']>;
+    kind?: InputMaybe<ProjectKind>;
+    search?: InputMaybe<Scalars['String']['input']>;
+    upstreamStatus?: InputMaybe<UpstreamStatus>;
+};
+export declare enum ProjectKind {
+    Cnb = "CNB",
+    Local = "LOCAL"
+}
+export type ProjectMember = {
+    __typename?: 'ProjectMember';
+    /** false = 该账户的访问被撤销；true = 表里留存的显式放开行（等价于默认权限）。 */
+    present: Scalars['Boolean']['output'];
+    userId: Scalars['ID']['output'];
+};
+export type ProjectPage = {
+    __typename?: 'ProjectPage';
+    items: Array<Project>;
+    nextCursor?: Maybe<Scalars['String']['output']>;
+};
+export type Query = {
+    __typename?: 'Query';
+    /** 该用户可用模型（连接启用 + 模型启用 + 存在性 + 密钥齐备）。 */
+    availableModels: Array<Model>;
+    /** 该连接的内置目录模型清单；不需要密钥，上游读不到时的出路。 */
+    builtinModelCatalog: Array<UpstreamModel>;
+    /** 全部 CNB 环境接入密钥（明文不回读）。密钥不绑用户，属部署级环境凭据。 */
+    cnbAccessKeys: Array<CnbAccessKey>;
+    /** 当前登录账户自己的 CNB 连接。 */
+    cnbConnection: CnbAccount;
+    configurationReads: ConfigurationReadPage;
+    /** 该用户生效默认模型 id；未配置或不在可用目录内为 null。 */
+    effectiveDefaultModelId?: Maybe<Scalars['ID']['output']>;
+    globalConfiguration: GlobalConfiguration;
+    modelConnection: ModelConnection;
+    modelConnections: ModelConnectionPage;
+    models: ModelPage;
+    /** 登录者本人可访问的项目。 */
+    myProjects: ProjectPage;
+    /** 单项目详情；无访问权即 ACCESS_DENIED。 */
+    project: Project;
+    /** 全部项目；成员视角用 myProjects。 */
+    projects: ProjectPage;
+    /** 可选用的提供方预设（清单内置，随 dsh 升级重新生成）。 */
+    providerPresets: Array<ModelProviderPreset>;
+    roles: Array<RoleDefinition>;
+    /** 此刻生效的默认模型 id；未配置、失效或本次读取失败为 null。 */
+    runtimeDefaultModelId?: Maybe<Scalars['ID']['output']>;
+    /** 连接级密钥；connectionIds 省略即返回可用目录涉及的全部连接；失败为 null。 */
+    runtimeModelCredentials?: Maybe<Array<RuntimeModelCredential>>;
+    /** 此刻生效的可用模型目录；本次读取失败为 null。 */
+    runtimeModels?: Maybe<Array<RuntimeModel>>;
+    /**
+     * 本次可读项目及其生效绑定；失败为 null。slugs 省略 = 全部可读项目；给定 = 只返回
+     * 其中 slug 命中者（大小写不敏感），空数组 = 明确不要任何项目 —— 运行面按自己已登记的
+     * 工作区逐个项目要，不必把整个项目表拉回本地。
+     */
+    runtimeProjects?: Maybe<Array<RuntimeProject>>;
+    /**
+     * 某技能 head 版本的附件内容（运行面物化用）；读取者对该技能不可见时返回空数组。
+     * 字节不回填进 boot 文档，只在真正加载技能时按需取。
+     */
+    runtimeSkillFiles?: Maybe<Array<RuntimeSkillFileContent>>;
+    /**
+     * 此刻对读取者生效的技能目录（全局 + 可访问项目的未归档 head）；失败为 null。
+     * 「哪些目录算已登记工作区」是 client 侧事实，服务端只表达可访问性，不下发生效范围。
+     */
+    runtimeSkills?: Maybe<Array<RuntimeSkill>>;
+    /** 本次读取者（服务器里当前用户）；失败为 null。 */
+    runtimeViewer?: Maybe<RuntimeViewer>;
+    /** 单个技能详情（含已归档；没给 version 就是 head，给了就取该历史版本）；不存在即 SKILL_NOT_FOUND。 */
+    skill: Skill;
+    /** 某版本（缺省 head）的全部附件内容；导出 / 编辑回填 / 下载按需取。 */
+    skillFiles: Array<SkillFileContent>;
+    /** 该技能的全部历史快照（新在前，有界不 paginate，同 cnbAccessKeys 口径）。 */
+    skillVersions: Array<SkillVersion>;
+    /** 技能头版本列表；filter 决定作用域与状态。 */
+    skills: SkillPage;
+    /** 读令牌可见的 CNB 组织成员但不写库：返回列表供同步勾选；失败按 DomainError 码回。 */
+    upstreamCnbMembers: Array<UpstreamCnbMember>;
+    /** 读令牌可见的 CNB 仓库但不写库：返回列表供同步勾选；失败按 DomainError 码回。 */
+    upstreamCnbRepositories: Array<UpstreamCnbRepository>;
+    /** 读上游目录但不写本地目录：返回列表供同步勾选；失败按 DomainError 码回。 */
+    upstreamModelCatalog: Array<UpstreamModel>;
+    user: User;
+    /** 用户层配置：本人或管理员。 */
+    userConfiguration: UserConfiguration;
+    /** 本人或管理员；个人按连接覆盖的密钥引用（不含密钥值）。 */
+    userModelCredentials: Array<ModelCredentialRef>;
+    /** 全部账户；role 过滤匹配拥有该角色的账户。 */
+    users: UserPage;
+    viewer: User;
+};
+export type QueryAvailableModelsArgs = {
+    userId?: InputMaybe<Scalars['ID']['input']>;
+};
+export type QueryBuiltinModelCatalogArgs = {
+    connectionId: Scalars['ID']['input'];
+};
+export type QueryConfigurationReadsArgs = {
+    after?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<ConfigurationReadFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QueryEffectiveDefaultModelIdArgs = {
+    userId?: InputMaybe<Scalars['ID']['input']>;
+};
+export type QueryModelConnectionArgs = {
+    id: Scalars['ID']['input'];
+};
+export type QueryModelConnectionsArgs = {
+    after?: InputMaybe<Scalars['String']['input']>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QueryModelsArgs = {
+    after?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<ModelFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QueryMyProjectsArgs = {
+    after?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<ProjectFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QueryProjectArgs = {
+    id: Scalars['ID']['input'];
+};
+export type QueryProjectsArgs = {
+    after?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<ProjectFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QueryRuntimeModelCredentialsArgs = {
+    connectionIds?: InputMaybe<Array<Scalars['ID']['input']>>;
+};
+export type QueryRuntimeProjectsArgs = {
+    slugs?: InputMaybe<Array<Scalars['String']['input']>>;
+};
+export type QueryRuntimeSkillFilesArgs = {
+    skillId: Scalars['ID']['input'];
+};
+export type QuerySkillArgs = {
+    id: Scalars['ID']['input'];
+    version?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QuerySkillFilesArgs = {
+    id: Scalars['ID']['input'];
+    version?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QuerySkillVersionsArgs = {
+    skillId: Scalars['ID']['input'];
+};
+export type QuerySkillsArgs = {
+    after?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<SkillFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+};
+export type QueryUpstreamModelCatalogArgs = {
+    connectionId: Scalars['ID']['input'];
+};
+export type QueryUserArgs = {
+    id: Scalars['ID']['input'];
+};
+export type QueryUserConfigurationArgs = {
+    userId: Scalars['ID']['input'];
+};
+export type QueryUserModelCredentialsArgs = {
+    userId: Scalars['ID']['input'];
+};
+export type QueryUsersArgs = {
+    after?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<UserFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+};
+export declare enum ReasoningLevel {
+    High = "HIGH",
+    Low = "LOW",
+    Max = "MAX",
+    Medium = "MEDIUM",
+    Minimal = "MINIMAL",
+    Off = "OFF",
+    Xhigh = "XHIGH"
+}
+export type RefreshCnbAccountInput = {
+    /** 省略 = 刷新自己；给出 = ADMIN 代刷新。 */
+    userId?: InputMaybe<Scalars['ID']['input']>;
+};
+/** 删附件：同样追加版本；不存在的 path 会被忽略（全被忽略即幂等）。 */
+export type RemoveSkillFilesInput = {
+    expectedVersion: Scalars['Int']['input'];
+    id: Scalars['ID']['input'];
+    paths: Array<Scalars['String']['input']>;
+};
+export declare enum Role {
+    Admin = "ADMIN",
+    User = "USER"
+}
+export type RoleDefinition = {
+    __typename?: 'RoleDefinition';
+    code: Role;
+    name: Scalars['String']['output'];
+};
+/** 运行面看到的模型连接事实；路由名与 apiKeyEnv 由 client 自铸。 */
+export type RuntimeConnection = {
+    __typename?: 'RuntimeConnection';
+    baseUrl: Scalars['String']['output'];
+    id: Scalars['ID']['output'];
+    protocol: ModelProtocol;
+    /**
+     * 预设 id（= dsh 的提供方路由 id），自定义连接为 null。
+     * 是「这条连接代表哪个提供方」的领域事实，client 据此决定路由命名与是否复用目录提供方。
+     */
+    provider?: Maybe<Scalars['String']['output']>;
+};
+/** 生效可用目录的一条：已通过连接启用、模型启用、存在性、密钥可用四道判定。 */
+export type RuntimeModel = {
+    __typename?: 'RuntimeModel';
+    connection: RuntimeConnection;
+    displayName?: Maybe<Scalars['String']['output']>;
+    id: Scalars['ID']['output'];
+    metadata: ModelMetadata;
+    upstreamId: Scalars['String']['output'];
+};
+/** 连接级密钥（用户覆盖优先后的最终值）；env 变量名由 client 自铸。 */
+export type RuntimeModelCredential = {
+    __typename?: 'RuntimeModelCredential';
+    connectionId: Scalars['ID']['output'];
+    value: Scalars['String']['output'];
+};
+/** 本次可读项目 + 其生效绑定。模型引用已按可用目录校验，失效即 null。 */
+export type RuntimeProject = {
+    __typename?: 'RuntimeProject';
+    enabled: Scalars['Boolean']['output'];
+    executeModelId?: Maybe<Scalars['ID']['output']>;
+    id: Scalars['ID']['output'];
+    name: Scalars['String']['output'];
+    /** 已校验：不在可用目录内则为 null（client 据此回落默认模型）。 */
+    planModelId?: Maybe<Scalars['ID']['output']>;
+    slug: Scalars['String']['output'];
+};
+/** 运行面技能目录条目：此刻对读取者生效的未归档 head。 */
+export type RuntimeSkill = {
+    __typename?: 'RuntimeSkill';
+    /** 正文（frontmatter 已剥）：dsh 的 SkillDefinition.content 就是这个形态。 */
+    content: Scalars['String']['output'];
+    description: Scalars['String']['output'];
+    fileCount: Scalars['Int']['output'];
+    /** 附件清单（字节走 runtimeSkillFiles 按需取，避免 boot 文档膨胀）。 */
+    files: Array<RuntimeSkillFile>;
+    filesBytes: Scalars['Int']['output'];
+    /** 逻辑技能 id（provider 的 locator，跨版本稳定）。 */
+    id: Scalars['ID']['output'];
+    name: Scalars['String']['output'];
+    /** null = 全局技能；是否对本 cwd 生效由 client 按已登记工作区裁定。 */
+    projectId?: Maybe<Scalars['ID']['output']>;
+    version: Scalars['Int']['output'];
+    whenToUse?: Maybe<Scalars['String']['output']>;
+};
+/** 运行面看到的附件清单条目（不含字节）。 */
+export type RuntimeSkillFile = {
+    __typename?: 'RuntimeSkillFile';
+    isExecutable: Scalars['Boolean']['output'];
+    mimeType: Scalars['String']['output'];
+    path: Scalars['String']['output'];
+    sizeBytes: Scalars['Int']['output'];
+};
+/** 运行面按需读取的附件内容：文本 utf-8、其余 base64。 */
+export type RuntimeSkillFileContent = {
+    __typename?: 'RuntimeSkillFileContent';
+    content: Scalars['String']['output'];
+    encoding: SkillFileEncoding;
+    isExecutable: Scalars['Boolean']['output'];
+    mimeType: Scalars['String']['output'];
+    path: Scalars['String']['output'];
+    sizeBytes: Scalars['Int']['output'];
+};
+/** 运行面当前读取者：任何环境（密码登录 / CNB 接入）都返回 hub 里当前用户。 */
+export type RuntimeViewer = {
+    __typename?: 'RuntimeViewer';
+    displayName: Scalars['String']['output'];
+    id: Scalars['ID']['output'];
+    username: Scalars['String']['output'];
+};
+export type SaveGlobalInput = {
+    expectedRevision: Scalars['Int']['input'];
+    preferences?: InputMaybe<PreferencesInput>;
+};
+export type SaveModelConnectionInput = {
+    apiKey?: InputMaybe<SecretInput>;
+    baseUrl?: InputMaybe<Scalars['String']['input']>;
+    displayName: Scalars['String']['input'];
+    enabled?: InputMaybe<Scalars['Boolean']['input']>;
+    expectedRevision: Scalars['Int']['input'];
+    /** 省略 = 新建。 */
+    id?: InputMaybe<Scalars['ID']['input']>;
+    protocol: ModelProtocol;
+    /** 预设 id；显式 null = 改成自定义连接。预设锁定 protocol。 */
+    provider?: InputMaybe<Scalars['String']['input']>;
+};
+export type SaveModelInput = {
+    connectionId: Scalars['ID']['input'];
+    /** 显式 null = 清除显示名。 */
+    displayName?: InputMaybe<Scalars['String']['input']>;
+    enabled?: InputMaybe<Scalars['Boolean']['input']>;
+    expectedRevision: Scalars['Int']['input'];
+    /** 省略 = 新建。 */
+    id?: InputMaybe<Scalars['ID']['input']>;
+    overrides?: InputMaybe<MetadataInput>;
+    retainMissing?: InputMaybe<Scalars['Boolean']['input']>;
+    upstreamId?: InputMaybe<Scalars['String']['input']>;
+};
+export type SaveProjectDetailsInput = {
+    enabled?: InputMaybe<Scalars['Boolean']['input']>;
+    expectedRevision: Scalars['Int']['input'];
+    name?: InputMaybe<Scalars['String']['input']>;
+    projectId: Scalars['ID']['input'];
+};
+export type SaveProjectHeadlessModelsInput = {
+    executeModelId?: InputMaybe<Scalars['ID']['input']>;
+    expectedRevision: Scalars['Int']['input'];
+    planModelId?: InputMaybe<Scalars['ID']['input']>;
+    projectId: Scalars['ID']['input'];
+};
+export type SaveSkillInput = {
+    content: Scalars['String']['input'];
+    /** 当前头版本号；过期即 SKILL_VERSION_CONFLICT（同内容重复提交不消耗它）。 */
+    expectedVersion: Scalars['Int']['input'];
+    id: Scalars['ID']['input'];
+};
+export type SaveUserInput = {
+    expectedRevision: Scalars['Int']['input'];
+    modelCredentials?: InputMaybe<Array<ModelCredentialInput>>;
+    userId: Scalars['ID']['input'];
+};
+/** value / clear / reuse 严格三选一。reuse 仅连接密钥场景有意义。 */
+export type SecretInput = {
+    clear?: InputMaybe<Scalars['Boolean']['input']>;
+    reuse?: InputMaybe<Scalars['Boolean']['input']>;
+    value?: InputMaybe<Scalars['String']['input']>;
+};
+export type SetModelEnabledInput = {
+    enabled: Scalars['Boolean']['input'];
+    expectedRevision: Scalars['Int']['input'];
+    id: Scalars['ID']['input'];
+    retainMissing?: InputMaybe<Scalars['Boolean']['input']>;
+};
+/** 项目访问是例外名单：present=false 撤销该账户的访问，present=true 恢复（删不掉行只为留痕）。 */
+export type SetProjectAccessInput = {
+    expectedRevision: Scalars['Int']['input'];
+    present: Scalars['Boolean']['input'];
+    projectId: Scalars['ID']['input'];
+    userId: Scalars['ID']['input'];
+};
+export type SetSkillArchivedInput = {
+    archived: Scalars['Boolean']['input'];
+    expectedVersion: Scalars['Int']['input'];
+    id: Scalars['ID']['input'];
+};
+export type SetUserRolesInput = {
+    expectedRevision: Scalars['Int']['input'];
+    roles: Array<Role>;
+    userId: Scalars['ID']['input'];
+};
+export type SetUserStatusInput = {
+    expectedRevision: Scalars['Int']['input'];
+    status: UserStatus;
+    userId: Scalars['ID']['input'];
+};
+/** 一条技能的头版本事实。content 为完整 SKILL.md（frontmatter + 正文），供编辑器 round-trip。 */
+export type Skill = {
+    __typename?: 'Skill';
+    archived: Scalars['Boolean']['output'];
+    content: Scalars['String']['output'];
+    description: Scalars['String']['output'];
+    fileCount: Scalars['Int']['output'];
+    /** 该版本的附件清单（随版本快照，由 skill_files 聚合）。 */
+    files: Array<SkillFile>;
+    filesBytes: Scalars['Int']['output'];
+    /** 逻辑 id（跨版本稳定，即 skills.skill_id）。 */
+    id: Scalars['ID']['output'];
+    name: Scalars['String']['output'];
+    /** null = 全局技能；文本工具与运行面按它分作用域。 */
+    projectId?: Maybe<Scalars['ID']['output']>;
+    /** head 行的 createdAt。 */
+    updatedAt: Scalars['DateTime']['output'];
+    /** 当前头版本号；保存时用 expectedVersion 做 CAS。 */
+    version: Scalars['Int']['output'];
+    whenToUse?: Maybe<Scalars['String']['output']>;
+};
+/** 技能附件清单条目（不含字节）。 */
+export type SkillFile = {
+    __typename?: 'SkillFile';
+    isExecutable: Scalars['Boolean']['output'];
+    mimeType: Scalars['String']['output'];
+    /** 相对 files/ 的 UNIX 风格路径，例 scripts/run.sh。 */
+    path: Scalars['String']['output'];
+    sizeBytes: Scalars['Int']['output'];
+};
+/** 按需读取的附件内容：文本 utf-8、其余 base64（编码见 encoding）。 */
+export type SkillFileContent = {
+    __typename?: 'SkillFileContent';
+    content: Scalars['String']['output'];
+    encoding: SkillFileEncoding;
+    isExecutable: Scalars['Boolean']['output'];
+    mimeType: Scalars['String']['output'];
+    path: Scalars['String']['output'];
+    sizeBytes: Scalars['Int']['output'];
+};
+/** 技能附件内容的编码：文本类用 UTF8，其余（图片 / 二进制）用 BASE64。 */
+export declare enum SkillFileEncoding {
+    Base64 = "BASE64",
+    Utf8 = "UTF8"
+}
+/** 写入一个附件：content 按 encoding 解释（缺省 utf-8）；单文件、单次与整技能都有上限。 */
+export type SkillFileInput = {
+    content: Scalars['String']['input'];
+    /** 省略 = UTF8。 */
+    encoding?: InputMaybe<SkillFileEncoding>;
+    /** 落盘后可执行位（仅运行面物化时使用）。 */
+    isExecutable?: InputMaybe<Scalars['Boolean']['input']>;
+    path: Scalars['String']['input'];
+};
+/** 条件：projectId 省略 = 不过滤；显式 null = 仅全局；给定 id = 该项目。search 匹配 name/description（不区分大小写子串）；archived 省略 = 全部。 */
+export type SkillFilter = {
+    archived?: InputMaybe<Scalars['Boolean']['input']>;
+    projectId?: InputMaybe<Scalars['ID']['input']>;
+    search?: InputMaybe<Scalars['String']['input']>;
+};
+export type SkillPage = {
+    __typename?: 'SkillPage';
+    items: Array<Skill>;
+    nextCursor?: Maybe<Scalars['String']['output']>;
+};
+/** 一个不可变历史快照。作者用扁平字段（同 ConfigurationRead 口径），不构造完整 User。 */
+export type SkillVersion = {
+    __typename?: 'SkillVersion';
+    archived: Scalars['Boolean']['output'];
+    content: Scalars['String']['output'];
+    createdAt: Scalars['DateTime']['output'];
+    createdBy: Scalars['ID']['output'];
+    createdByDisplayName?: Maybe<Scalars['String']['output']>;
+    createdByUsername?: Maybe<Scalars['String']['output']>;
+    version: Scalars['Int']['output'];
+};
+export type SyncCnbProjectsInput = {
+    /** 要接入的上游仓库 ID；未勾选的不新增（既有项目行不因此改变）。 */
+    repositoryIds: Array<Scalars['String']['input']>;
+};
+export type SyncModelCatalogInput = {
+    connectionId: Scalars['ID']['input'];
+    expectedRevision: Scalars['Int']['input'];
+    /** 要接入目录的上游模型 ID；未勾选的不新增（已在目录中的行不因此改变）。 */
+    upstreamIds: Array<Scalars['String']['input']>;
+};
+export type UpdateCnbTokenInput = {
+    token: Scalars['String']['input'];
+    /** 省略 = 改自己；给出 = ADMIN 代改。 */
+    userId?: InputMaybe<Scalars['ID']['input']>;
+};
+export type UpdateMyConfigurationInput = {
+    expectedRevision: Scalars['Int']['input'];
+    modelCredentials?: InputMaybe<Array<ModelCredentialInput>>;
+};
+/** 令牌可见组织树里的一个成员：只读快照，不落库，供同步弹层勾选要添加的用户。 */
+export type UpstreamCnbMember = {
+    __typename?: 'UpstreamCnbMember';
+    avatar?: Maybe<Scalars['String']['output']>;
+    externalUserId: Scalars['String']['output'];
+    nickname?: Maybe<Scalars['String']['output']>;
+    /** 命中该成员的第一个组织路径（含子组织，按组织路径升序读取）。 */
+    organizationPath: Scalars['String']['output'];
+    /** 该 CNB 身份是否已有 Hub 账户（已连接或待绑定令牌）。 */
+    registered: Scalars['Boolean']['output'];
+    username: Scalars['String']['output'];
+};
+/** 令牌可见的一个 CNB 仓库：只读快照，不落库，供同步弹层勾选要接入的项目。 */
+export type UpstreamCnbRepository = {
+    __typename?: 'UpstreamCnbRepository';
+    externalRepoId: Scalars['String']['output'];
+    frozen: Scalars['Boolean']['output'];
+    /** 已存在同 externalRepoId 的项目行；同步时勾选与否不改变它。 */
+    imported: Scalars['Boolean']['output'];
+    name: Scalars['String']['output'];
+    path: Scalars['String']['output'];
+    /** 上游仓库状态原始值（active / archived / forking）；不进 UpstreamStatus 闭集，避免上游新增值炸序列化。 */
+    status: Scalars['String']['output'];
+    visibility?: Maybe<Scalars['String']['output']>;
+    webUrl?: Maybe<Scalars['String']['output']>;
+};
+/** 上游目录里的一条模型：只读快照，不落库，供同步时挑选要接入的模型。 */
+export type UpstreamModel = {
+    __typename?: 'UpstreamModel';
+    displayName?: Maybe<Scalars['String']['output']>;
+    metadata: ModelMetadata;
+    upstreamId: Scalars['String']['output'];
+};
+export declare enum UpstreamStatus {
+    Active = "ACTIVE",
+    Archived = "ARCHIVED",
+    Forking = "FORKING",
+    Unavailable = "UNAVAILABLE"
+}
+export type User = {
+    __typename?: 'User';
+    /** 该账户自己的、已验证的 CNB 身份与连接状态。 */
+    cnbAccount: CnbAccount;
+    createdAt: Scalars['DateTime']['output'];
+    displayName: Scalars['String']['output'];
+    id: Scalars['ID']['output'];
+    lastReadAt?: Maybe<Scalars['DateTime']['output']>;
+    /** users 行 revision；状态与角色集合修改都用它做 CAS。 */
+    revision: Scalars['Int']['output'];
+    /** 服务端聚合（计数 / 最近时间）；仅管理员查询有值。 */
+    revokedProjectCount?: Maybe<Scalars['Int']['output']>;
+    /** 账户拥有的角色。USER 是基础角色，ADMIN 是可叠加的管理权限。 */
+    roles: Array<Role>;
+    status: UserStatus;
+    /** 稳定的本地登录名；创建时从 CNB username 派生，CNB 改名不自动改它。 */
+    username: Scalars['String']['output'];
+};
+/** user_configuration 一行的领域读模型。 */
+export type UserConfiguration = {
+    __typename?: 'UserConfiguration';
+    revision: Scalars['Int']['output'];
+    userId: Scalars['ID']['output'];
+};
+/** 条件：search 匹配本地用户名 / 显示名 / CNB 用户名（不区分大小写子串）；cnbState 精确匹配连接态。 */
+export type UserFilter = {
+    cnbState?: InputMaybe<CnbConnectionState>;
+    role?: InputMaybe<Role>;
+    search?: InputMaybe<Scalars['String']['input']>;
+    status?: InputMaybe<UserStatus>;
+};
+export type UserPage = {
+    __typename?: 'UserPage';
+    items: Array<User>;
+    nextCursor?: Maybe<Scalars['String']['output']>;
+};
+export declare enum UserStatus {
+    Active = "ACTIVE",
+    Disabled = "DISABLED",
+    Pending = "PENDING"
+}
+/** 增 / 改附件：不动 SKILL.md，但同样追加版本（附件随版本快照）。 */
+export type WriteSkillFilesInput = {
+    expectedVersion: Scalars['Int']['input'];
+    files: Array<SkillFileInput>;
+    id: Scalars['ID']['input'];
+};