LoadedConfig

loadConfig 顶层产物:合并配置 + 按层保留的 permissions + 装配后的 hooks。契约的原始 permissions / hooks / mcpServers / policy / workspaceTrust 段 (contract-v0.6/v0.3/v0.4/v0.8)、http 段与 sandbox / update 段在合并前被逐层抽取(段策略表 section-policy.ts),从不进入合并产物——此处以装配产物顶替同名键 (Omit 隔离两形态)。

继承

Omit<MergedTansrConfig, | "permissions" | "hooks" | "mcpServers" | "policy" | "workspaceTrust" | "http" | "sandbox" | "update">

属性

$schemaVersion

$schemaVersion: 1;

继承自

Omit.$schemaVersion

audit?

optional audit?: {
  dir?: string;
  enabled?: boolean;
};

dir?

optional dir?: string;

enabled?

optional enabled?: boolean;

继承自

Omit.audit

budget?

optional budget?: {
  maxTotalTokens?: number;
  maxUsd?: number;
  onExceeded: "block" | "warn";
};

maxTotalTokens?

optional maxTotalTokens?: number;

maxUsd?

optional maxUsd?: number;

onExceeded

onExceeded: "block" | "warn";

继承自

Omit.budget

context?

optional context?: {
  activeScheme?: string;
  schemes?: Record<string, {
     displayName?: string;
     origin?: string;
     params?: Record<string, unknown>;
     parentId?: string;
     stage?: "test" | "production" | "experimental";
  }>;
};

activeScheme?

optional activeScheme?: string;

schemes?

optional schemes?: Record<string, {
  displayName?: string;
  origin?: string;
  params?: Record<string, unknown>;
  parentId?: string;
  stage?: "test" | "production" | "experimental";
}>;

继承自

Omit.context

effort?

optional effort?: "low" | "medium" | "high" | "max";

继承自

Omit.effort

fallbacks

fallbacks: Record<string, string[]>;

继承自

Omit.fallbacks

hooks

hooks: LoadedHooks;

hooks 段分层抽取产物(可直接喂 HookEngineOptions.hooks)

http

http: LoadedHttpSection;

http 段分层抽取产物(user/managed 被尊重,项目层忽略,远程 org 可下发,见 http-section.ts)

locale?

optional locale?: string;

继承自

Omit.locale

mcpServers

mcpServers: McpServerEntry[];

mcpServers 段分层抽取产物(可直接喂 attachMcpTools)

memory

memory: LoadedMemorySection;

memory 段分层抽取产物(TMEM/1;user/managed 被尊重,项目层忽略,见 memory-section.ts)

model?

optional model?: {
  selected?: string;
};

selected?

optional selected?: string;

继承自

Omit.model

modelAliases

modelAliases: {
  fast?: string;
  main?: string;
  reasoning?: string;
};

fast?

optional fast?: string;

main?

optional main?: string;

reasoning?

optional reasoning?: string;

继承自

Omit.modelAliases

network?

optional network?: {
  twpIdleTimeoutMs?: number;
};

twpIdleTimeoutMs?

optional twpIdleTimeoutMs?: number;

继承自

Omit.network

outputStyle?

optional outputStyle?: string;

继承自

Omit.outputStyle

permissions

permissions: LoadedPermissions;

policy

policy: LoadedPolicySection;

policy 段分层抽取产物(contract-v0.8;仅 managed 层被尊重,见 managed-sections.ts)

providers

providers: Record<string, {
  auth?: {
     env: string;
  };
  baseUrl: string;
  capability?: {
     background?: boolean;
     defaultContextWithoutModifier?: number;
     effectiveContext?: number;
     hostedTools?: string[];
     inputModalities?: {
        document?: "supported" | "rejected" | "silently_dropped";
        image?: "supported" | "rejected" | "silently_dropped";
     };
     maxContext?: number;
     maxOutput?: number;
     modelModifiers?: string[];
     promptCaching?: {
        maxBreakpoints?: number;
        minCacheableTokens?: number;
        mode?: "explicit" | "implicit" | "ignored";
        ttlSeconds?: number;
     };
     quirks?: {
        claudeModelNameMapping?: boolean;
        countTokensEndpoint?: boolean;
        maxTokensExcludesReasoning?: boolean;
        minTimeoutMs?: number;
        modelsEndpoint?: boolean;
        stopSequences?: "ignored" | "honored" | "misreported_end_turn";
        streamUsageLocation?: "message_start" | "message_delta" | "both";
        systemRoleInMessages?: boolean;
        unknownModelFallback?: boolean;
     };
     reasoning?: boolean;
     sampling?: {
        temperature?: {
           clampEpsilon?: number;
           max?: number;
           maxExclusive?: boolean;
           min?: number;
           minExclusive?: boolean;
        };
        temperatureFixed?: number;
        temperatureRange?: [number, number];
     };
     thinking?: {
        budgetTokens?: "ignored" | "honored";
        cannotDisable?: boolean;
        effortParam?: string;
        mustEchoBack?: boolean;
        signatureShape?: "opaque" | "always_empty" | "absent";
        toggleValues?: string[];
     };
     thinkingOptional?: boolean;
     toolChoice?: boolean;
     vision?: boolean;
  };
  models: Record<string, string>;
  pricing?: Record<string, {
     cachedInputPerMillion?: number;
     inputPerMillion: number;
     outputPerMillion: number;
     peakMultiplier?: number;
     tiers?: {
        cachedInputPerMillion?: number;
        inputPerMillion: number;
        outputPerMillion: number;
        upToInputTokens?: number;
     }[];
  }>;
  protocol: "anthropic" | "openai" | "openai-responses" | "twp";
}>;

继承自

Omit.providers

sandbox

sandbox: LoadedSandboxSection;

sandbox 段分层抽取产物(user/managed 被尊重,项目层忽略,env 对 managed 只收紧,见 sandbox-section.ts)

semanticIndex?

optional semanticIndex?: {
  branch?: string;
  repoId?: string;
  timeoutMs?: number;
  topK?: number;
  url?: string;
};

branch?

optional branch?: string;

repoId?

optional repoId?: string;

timeoutMs?

optional timeoutMs?: number;

topK?

optional topK?: number;

url?

optional url?: string;

继承自

Omit.semanticIndex

storage?

optional storage?: {
  autoCheckpointBeforeCompact?: boolean;
  checkpoints?: {
     max?: number;
     maxAgeDays?: number;
  };
  checkpointsDir?: string;
  segmentation?: {
     enabled?: boolean;
     maxBytes?: number;
     maxRecords?: number;
  };
  sessionsDir?: string;
};

autoCheckpointBeforeCompact?

optional autoCheckpointBeforeCompact?: boolean;

checkpoints?

optional checkpoints?: {
  max?: number;
  maxAgeDays?: number;
};

checkpoints.max?

optional max?: number;

checkpoints.maxAgeDays?

optional maxAgeDays?: number;

checkpointsDir?

optional checkpointsDir?: string;

segmentation?

optional segmentation?: {
  enabled?: boolean;
  maxBytes?: number;
  maxRecords?: number;
};

segmentation.enabled?

optional enabled?: boolean;

segmentation.maxBytes?

optional maxBytes?: number;

segmentation.maxRecords?

optional maxRecords?: number;

sessionsDir?

optional sessionsDir?: string;

继承自

Omit.storage

telemetry

telemetry: {
  enabled: boolean;
};

enabled

enabled: boolean;

继承自

Omit.telemetry

ui?

optional ui?: {
  theme?: "dark" | "light" | "high-contrast" | "colorblind";
};

theme?

optional theme?: "dark" | "light" | "high-contrast" | "colorblind";

继承自

Omit.ui

update

update: LoadedUpdateSection;

update 段分层抽取产物(user/managed 被尊重,项目层忽略,见 update-section.ts)

usageReporting?

optional usageReporting?: {
  enabled?: boolean;
};

enabled?

optional enabled?: boolean;

继承自

Omit.usageReporting

verify?

optional verify?: {
  command?: string;
  timeoutMs?: number;
};

command?

optional command?: string;

timeoutMs?

optional timeoutMs?: number;

继承自

Omit.verify

window?

optional window?: {
  byModel?: Record<string, number>;
};

byModel?

optional byModel?: Record<string, number>;

继承自

Omit.window

workspaceTrust

workspaceTrust: LoadedWorkspaceTrust;

workspaceTrust 段分层抽取产物(contract-v0.8;仅 managed 层被尊重)