AppBundle

이 콘텐츠는 아직 번역되지 않았습니다.

bundle-for-app 的 SDK 消费子集

属性

adjudicator

adjudicator: AppBundleAdjudicator | null;

生效裁决人档(adjudicators[0] ?? adjudicator)。平台底档恒在(两级皆空回落平台内置缺省档),故正常 bundle 恒非 null;null = 段缺席 / 坏形状(旧平台)→ 令牌档无裁决人,权限行为维持现状(default 模式, 无分类器路径)——朝严方向,无安全回退面。

aliases

aliases: Record<string, string>;

app

app: AppBundleIdentity;

应用身份(应用协议 <app> 段)——name 现行键,purpose 可选键

capabilities

capabilities: AppCapabilities;

App 能力位(平台控制台按 App 配置的工具位 / 平台位)。段缺席 = 进程内缺省档 DEFAULT_APP_CAPABILITIES (旧平台 / 装置键径);整段坏形 = 零能力档 zeroAppCapabilities(platform)(真 fail-closed,此时 capabilitiesIssues 非 null)。

capabilitiesIssues

capabilitiesIssues: ZodIssue[] | null;

capabilities 段整段坏形时的 zod 问题清单(段在场却解析失败——位非 boolean / 段非对象);null = 段解析成功或段缺席。装配期(assemblePlatformModel)据此经 onWarn 通报 capabilities_unparsed{ detail.issues } (随 bundle 缓存,每次装配都通报,每会话可见)。段内未知键被剥除不算坏形。

contextScheme

contextScheme: AppBundleContextScheme | null;

上下文方案段(bundle 顶层 contextScheme,平台必填 nullable)。null = 平台未配 / 令牌径中性 null / 旧平台 / 坏形。在场即透传宿主:serve 平台内置形以 kernel contextSchemeToSchemeOptions 化为压缩方案选项;SDK 自身恒不映射方案键。

governance

governance: AppBundleGovernance;

组织治理段 SDK 子集(bundle 顶层 governance,owner 径)。恒为对象:sessionRetentionDays 在场且为正整数才落键;段缺席(令牌径剥段 / 旧平台 / 组织未配)/ 坏形 = {}。透传宿主(serve 会话保留期), SDK 自身零消费。

models

models: AppBundleModel[];

plan

plan: AppBundlePlan | null;

owner 生效套餐投影(bundle 顶层 plan 键)。null = 键缺席(个人无套餐 / 旧平台)或坏形状(任一字段类型 / 枚举不符即整段 null,恒不臆造档位)。纯呈现 / 开发者面语境位:并发 / 应用数等硬限制恒在服务端执行(429 / 400 信封),SDK 恒不据此本地判限。

platform

platform: "desktop" | "mobile" | "server" | null;

应用平台类型(bundle app.platform)。消费方据此判自身装配形态是否与拓扑相符(不符只提示不拒—— 能力位已按拓扑归一,安全由位保证)。缺席(旧平台 / 装置绑定键径恒缺键)或词表外 = null(未知,恒不臆造)。

platformModels

platformModels: AppBundlePlatformModels;

授权媒体模型集(四键 imageGen / videoGen / speechToText / textToSpeech):工具描述与装配 system 段的自取数据源——集成方恒不手配模型名。旧 bundle 无段 / 无键 = 空集如实(缺席恒不臆造)。

systemPrompt?

optional systemPrompt?: string;

应用业务提示词；与 SDK system 的选择／拼接由 systemPromptPolicy 决定。

systemPromptPolicy?

optional systemPromptPolicy?: SystemPromptPolicy;