@ai-agent-forge/agent-forge 0.85.0

package/dist/profiles/builtin-suites.js

@@ -0,0 +1,395 @@
+/**
+ * Builtin suite (方案) declarations and suite.json (schemaVersion 1)
+ * serialization, parsing, and validation — 方案系统设计.md v2 §5/§6/§9, M1a.
+ *
+ * Suites are pure data plus default policy: both builtin suites share the same
+ * unrestricted tool surface and differ only in orientation and memory strategy
+ * (the orientation persona text is injected into the system prompt, M2).
+ * Nothing here touches the packages/agent kernel; association resolution is
+ * declaration-only until M1b.
+ */
+export const SUITE_SCHEMA_VERSION = 1;
+/**
+ * Factory contents revision (M4): the revision of the factory builtin
+ * declarations, independent of SUITE_SCHEMA_VERSION. Bump it (and update both
+ * builtin declarations' `factoryRevision`) whenever the factory contents
+ * change; the registry upgrade proposal then offers `--suite-reset` for
+ * workspaces still on an older revision. Suite schema evolution keeps using
+ * SUITE_SCHEMA_VERSION.
+ *
+ * Revision 2 (统一修复轮集成收口, 2026-09-08): assistant and coding now share
+ * the same active 8-tool surface in full-control — the sdk `suiteToolOverride`
+ * DEFAULT_SUITE_ID exemption was removed (方案设计 §5 + user decision). Existing
+ * workspaces provisioned at revision 1 receive the upgrade-proposal diagnostic
+ * and adopt via `--suite-reset`.
+ *
+ * Revision 3 (2026-09-18): `builtin.session-share` joins both builtin suites
+ * (开发计划 §216: session-share productized from the example plugin into a
+ * first-party default-distributed capability) once the agent-dir config
+ * channel for embedded capabilities landed
+ * (`<agentDir>/capabilities/<short-id>.json`, see capabilities/builtin.ts).
+ * Existing workspaces provisioned at revision 2 receive the upgrade-proposal
+ * diagnostic and adopt via `--suite-reset`.
+ *
+ * Revision 4 (2026-09-18): `builtin.subagent-delegate` joins both builtin
+ * suites — the first-party subagent delegation tool (`subagent_run`) now ships
+ * by default in shared mode (zero extra processes; pooled runner processes stay
+ * opt-in through the capability config channel). Existing workspaces
+ * provisioned at revision 3 receive the upgrade-proposal diagnostic and adopt
+ * via `--suite-reset`.
+ */
+export const FACTORY_CONTENTS_VERSION = 5;
+/** Factory default suite used when no suite is configured anywhere (设计 §9). */
+export const DEFAULT_SUITE_ID = "assistant";
+/** Suite ids become directory names: lowercase letters, digits, hyphens (设计 §9). */
+export const SUITE_ID_MAX_LENGTH = 64;
+/** The single unrestricted tool surface shared by both builtin suites (设计 §5/§6). */
+export const BUILTIN_SUITE_TOOLS = [
+    "read",
+    "write",
+    "edit",
+    "bash",
+    "ls",
+    "find",
+    "grep",
+    "powershell",
+];
+/**
+ * Builtin capability plugins associated with both suites. Declaration-only
+ * data in M1a; the actual plugin wiring is delivered in M3. `builtin.memory`
+ * joins in the 统一修复轮 A 路 (方案系统设计 §6.1: both suites share the same
+ * memory tool surface; the strategy difference lives in the suiteId domain
+ * isolation and the assistant preference card). `builtin.session-share` joins
+ * in the session-share productization slice (开发计划 §216); its
+ * target/gateway/viewerUrl are configured through the agent-dir config
+ * channel (`<agentDir>/capabilities/builtin.session-share.json`), and the
+ * unconfigured default answers `/share` with the explicit configuration
+ * prompt — never an implicit Radius/Gist fallback.
+ */
+export const BUILTIN_SUITE_CAPABILITIES = [
+    "builtin.goal",
+    "builtin.plan",
+    "builtin.todo-set",
+    "builtin.memory",
+    "builtin.session-share",
+    "builtin.subagent-delegate",
+];
+/**
+ * Orientation persona texts injected into the system prompt (设计 §6.2, M2).
+ * The strings are verbatim from the design spec: the assistant persona is the
+ * companion style, the coding persona is the rigor-first style. Both are
+ * session-nature declarations, so they ride every system prompt branch
+ * (default and customPrompt).
+ */
+export const ORIENTATION_PROMPTS = {
+    assistant: `You are the user's thoughtful companion — warm, patient, and helpful.
+- Understand the intent behind the question, including the unspoken parts; when something that matters is ambiguous, ask one short clarifying question instead of assuming.
+- Pay attention to detail: notice what the user might have missed and gently point it out.
+- Be proactive and divergent: after answering, offer next steps, related ideas, or creative alternatives — without being pushy.
+- Adapt tone to the user; stay natural and flexible, never robotic or formulaic.
+- When you can help by doing, act through tools autonomously (minimal interruption).
+- Structure longer answers clearly: short paragraphs, lists where they help, and a concrete "what you can do next" at the end.`,
+    coding: `You are an autonomous software engineering agent with a rigor-first mindset.
+- Never guess. Ground every claim in code you have read, commands you have run, or documented evidence; cite file paths and line numbers. If the evidence is insufficient, investigate, and report what is unverified — or "unknown" — instead of a plausible invention.
+- First principles: trace problems to the earliest reasonable root cause and fix that; do not patch symptoms.
+- No over-engineering: add no abstraction, options, or defensive handling for imagined future needs; generalise only when a second concrete case demands it.
+- Tests first: pin expected behavior with a failing or updated test before or alongside the fix, then run the smallest sufficient relevant checks; the work is not done until they pass.
+- Reproducible: prefer deterministic tests and mocks over ad-hoc verification, and report the exact commands and results so others can re-run them.
+- Docs as code: repository documentation is part of the change — keep design docs, READMEs, and changelogs consistent with the behavior they describe.
+- Self-review before finishing: re-check your changes for correctness, edge cases, regressions, and missing tests; prefer a second review pass over shipping the first draft.
+- Cautious: weigh side effects, compatibility, and failure modes; when in doubt, take the safer path.`,
+};
+const EMPTY_ASSOCIATIONS = { skills: [], mcp: [], plugins: [], roles: [] };
+/**
+ * 默认方案关联的子代理角色（开箱即用）：这两个 id 对应工厂种子落盘的两个普通角色文件
+ * （`<agentDir>/roles/{explore,reviewer}.json`，用户可改可删）。工厂不在运行期回退到任何
+ * 编译内的角色定义；删掉文件只会让该关联成为 dangling 诊断。
+ */
+export const DEFAULT_ROLE_ASSOCIATIONS = ["explore", "reviewer"];
+const assistantSuite = {
+    schemaVersion: SUITE_SCHEMA_VERSION,
+    id: "assistant",
+    name: "Assistant",
+    builtin: true,
+    tools: BUILTIN_SUITE_TOOLS,
+    capabilities: BUILTIN_SUITE_CAPABILITIES,
+    associations: { ...EMPTY_ASSOCIATIONS, roles: DEFAULT_ROLE_ASSOCIATIONS },
+    inheritSystemAgentsMd: false,
+    memory: "assistant",
+    orientation: "assistant",
+    model: null,
+    thinking: null,
+    clonedFrom: null,
+    factoryRevision: FACTORY_CONTENTS_VERSION,
+};
+const codingSuite = {
+    schemaVersion: SUITE_SCHEMA_VERSION,
+    id: "coding",
+    name: "Coding",
+    builtin: true,
+    tools: BUILTIN_SUITE_TOOLS,
+    capabilities: BUILTIN_SUITE_CAPABILITIES,
+    associations: { ...EMPTY_ASSOCIATIONS, roles: DEFAULT_ROLE_ASSOCIATIONS },
+    inheritSystemAgentsMd: false,
+    memory: "code",
+    orientation: "coding",
+    model: null,
+    thinking: null,
+    clonedFrom: null,
+    factoryRevision: FACTORY_CONTENTS_VERSION,
+};
+/** The factory builtin pair: assistant (fallback default) and coding (尖刀). */
+export const BUILTIN_SUITES = [assistantSuite, codingSuite];
+export function getBuiltinSuite(id) {
+    return BUILTIN_SUITES.find((suite) => suite.id === id);
+}
+export function isBuiltinSuiteId(id) {
+    return BUILTIN_SUITES.some((suite) => suite.id === id);
+}
+const WINDOWS_RESERVED_IDS = new Set([
+    "con",
+    "prn",
+    "aux",
+    "nul",
+    "com1",
+    "com2",
+    "com3",
+    "com4",
+    "com5",
+    "com6",
+    "com7",
+    "com8",
+    "com9",
+    "lpt1",
+    "lpt2",
+    "lpt3",
+    "lpt4",
+    "lpt5",
+    "lpt6",
+    "lpt7",
+    "lpt8",
+    "lpt9",
+    "conin$",
+    "conout$",
+]);
+/** Suite id rule (设计 §9): `a-z0-9-`, no leading/trailing hyphen, no Windows reserved names. */
+export function isValidSuiteId(id) {
+    if (id.length === 0 || id.length > SUITE_ID_MAX_LENGTH)
+        return false;
+    if (!/^[a-z0-9-]+$/.test(id))
+        return false;
+    if (id.startsWith("-") || id.endsWith("-"))
+        return false;
+    if (WINDOWS_RESERVED_IDS.has(id))
+        return false;
+    return true;
+}
+/** Serializes a suite to the canonical suite.json text (stable field order, trailing newline). */
+export function serializeSuiteJson(suite) {
+    const ordered = {
+        schemaVersion: suite.schemaVersion,
+        id: suite.id,
+        name: suite.name,
+        builtin: suite.builtin,
+        tools: [...suite.tools],
+        capabilities: [...suite.capabilities],
+        associations: {
+            skills: [...suite.associations.skills],
+            mcp: [...suite.associations.mcp],
+            plugins: [...suite.associations.plugins],
+            roles: [...suite.associations.roles],
+        },
+        inheritSystemAgentsMd: suite.inheritSystemAgentsMd,
+        memory: suite.memory,
+        orientation: suite.orientation,
+        model: suite.model,
+        thinking: suite.thinking,
+        clonedFrom: suite.clonedFrom
+            ? { id: suite.clonedFrom.id, digest: suite.clonedFrom.digest, at: suite.clonedFrom.at }
+            : null,
+        factoryRevision: suite.factoryRevision,
+    };
+    return `${JSON.stringify(ordered, null, 2)}\n`;
+}
+/**
+ * Parses suite.json text. Never throws: an invalid result carries every
+ * validation error so callers can apply the corruption policy (设计 §9) —
+ * builtin suites fall back to factory content, user suites fail fast.
+ */
+export function parseSuiteJson(raw, options) {
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch (error) {
+        return {
+            valid: false,
+            errors: [`invalid JSON: ${error instanceof Error ? error.message : String(error)}`],
+        };
+    }
+    return validateSuiteJson(value, options);
+}
+export function validateSuiteJson(value, options = {}) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return { valid: false, errors: ["suite.json must be a JSON object"] };
+    }
+    const record = value;
+    const errors = [];
+    if (record.schemaVersion !== SUITE_SCHEMA_VERSION) {
+        errors.push(`schemaVersion must be ${SUITE_SCHEMA_VERSION}, found ${JSON.stringify(record.schemaVersion)}`);
+    }
+    // Each field keeps a typed local: valid values land here, invalid ones only
+    // contribute errors. The suite below is constructed exclusively when
+    // `errors` is empty, so the fallbacks/coercions at that point are dead.
+    const idValue = record.id;
+    const id = typeof idValue === "string" && isValidSuiteId(idValue) ? idValue : undefined;
+    if (id === undefined) {
+        errors.push(`id must be a suite id (^[a-z0-9-]+$, no leading/trailing hyphen, Windows reserved names rejected), found ${JSON.stringify(idValue)}`);
+    }
+    else if (options.expectedId !== undefined && id !== options.expectedId) {
+        errors.push(`id "${id}" does not match the suite workspace directory id "${options.expectedId}"`);
+    }
+    const nameValue = record.name;
+    const name = typeof nameValue === "string" && nameValue.trim().length > 0 ? nameValue : undefined;
+    if (name === undefined) {
+        errors.push(`name must be a non-empty string, found ${JSON.stringify(nameValue)}`);
+    }
+    const builtinValue = record.builtin;
+    const builtin = typeof builtinValue === "boolean" ? builtinValue : undefined;
+    if (builtin === undefined) {
+        errors.push(`builtin must be a boolean, found ${JSON.stringify(builtinValue)}`);
+    }
+    else if (options.expectedBuiltin === true && builtin !== true) {
+        errors.push(`builtin must be true for a builtin suite workspace, found ${builtin}`);
+    }
+    const tools = readStringArray(record, "tools", errors);
+    const capabilities = readStringArray(record, "capabilities", errors);
+    const associations = readAssociations(record.associations, errors);
+    const inheritValue = record.inheritSystemAgentsMd;
+    const inheritSystemAgentsMd = typeof inheritValue === "boolean" ? inheritValue : undefined;
+    if (inheritSystemAgentsMd === undefined) {
+        errors.push(`inheritSystemAgentsMd must be a boolean, found ${JSON.stringify(inheritValue)}`);
+    }
+    const memoryValue = record.memory;
+    const memory = memoryValue === "assistant" || memoryValue === "code" ? memoryValue : undefined;
+    if (memory === undefined) {
+        errors.push(`memory must be "assistant" or "code", found ${JSON.stringify(memoryValue)}`);
+    }
+    const orientationValue = record.orientation;
+    const orientation = orientationValue === "assistant" || orientationValue === "coding" ? orientationValue : undefined;
+    if (orientationValue !== undefined && orientation === undefined) {
+        errors.push(`orientation must be "assistant" or "coding", found ${JSON.stringify(orientationValue)}`);
+    }
+    const model = readOptionalString(record, "model", errors);
+    const thinking = readOptionalString(record, "thinking", errors);
+    const clonedFrom = readClonedFrom(record.clonedFrom, errors);
+    const factoryRevision = readFactoryRevision(record.factoryRevision, options.expectedBuiltin === true, errors);
+    if (errors.length > 0)
+        return { valid: false, errors };
+    return {
+        valid: true,
+        errors: [],
+        suite: {
+            schemaVersion: SUITE_SCHEMA_VERSION,
+            id: id,
+            name: name,
+            builtin: builtin,
+            tools,
+            capabilities,
+            associations,
+            inheritSystemAgentsMd: inheritSystemAgentsMd,
+            memory: memory,
+            orientation: orientation ?? "assistant",
+            model,
+            thinking,
+            clonedFrom,
+            ...(factoryRevision === undefined ? {} : { factoryRevision }),
+        },
+    };
+}
+function readStringArray(record, key, errors) {
+    const value = record[key];
+    if (!Array.isArray(value)) {
+        errors.push(`${key} must be an array of strings, found ${JSON.stringify(value)}`);
+        return [];
+    }
+    const entries = [];
+    const seen = new Set();
+    for (const item of value) {
+        if (typeof item !== "string" || item.trim().length === 0) {
+            errors.push(`${key} entries must be non-empty strings, found ${JSON.stringify(item)}`);
+            continue;
+        }
+        if (seen.has(item)) {
+            errors.push(`${key} contains duplicate entry "${item}"`);
+            continue;
+        }
+        seen.add(item);
+        entries.push(item);
+    }
+    return entries;
+}
+function readAssociations(value, errors) {
+    if (value === undefined)
+        return { skills: [], mcp: [], plugins: [], roles: [] };
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        errors.push(`associations must be an object with skills/mcp/plugins/roles arrays, found ${JSON.stringify(value)}`);
+        return { skills: [], mcp: [], plugins: [], roles: [] };
+    }
+    const record = value;
+    // A key left out entirely means an empty list, consistent with a fully
+    // absent `associations` object; a key that is present but malformed still
+    // reports its errors. The removed legacy `extensions` kind is ignored on
+    // read (it lost its loader with the old ExtensionAPI surface).
+    return {
+        skills: record.skills === undefined ? [] : readStringArray(record, "skills", errors),
+        mcp: record.mcp === undefined ? [] : readStringArray(record, "mcp", errors),
+        plugins: record.plugins === undefined ? [] : readStringArray(record, "plugins", errors),
+        roles: record.roles === undefined ? [] : readStringArray(record, "roles", errors),
+    };
+}
+function readOptionalString(record, key, errors) {
+    const value = record[key];
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== "string" || value.trim().length === 0) {
+        errors.push(`${key} must be a non-empty string or null, found ${JSON.stringify(value)}`);
+        return null;
+    }
+    return value;
+}
+/**
+ * Reads the optional `factoryRevision` key (M4). A missing key means
+ * FACTORY_CONTENTS_VERSION for builtin workspaces (pre-M4 on-disk files stay
+ * compatible) and stays absent for user suites (outside factory upgrade
+ * governance). A present key must be a positive integer.
+ */
+function readFactoryRevision(value, expectedBuiltin, errors) {
+    if (value === undefined)
+        return expectedBuiltin ? FACTORY_CONTENTS_VERSION : undefined;
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
+        errors.push(`factoryRevision must be a positive integer, found ${JSON.stringify(value)}`);
+        return undefined;
+    }
+    return value;
+}
+function readClonedFrom(value, errors) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== "object" || Array.isArray(value)) {
+        errors.push(`clonedFrom must be an object with id/digest/at, found ${JSON.stringify(value)}`);
+        return null;
+    }
+    const record = value;
+    if (typeof record.id !== "string" ||
+        record.id.trim().length === 0 ||
+        typeof record.digest !== "string" ||
+        record.digest.trim().length === 0 ||
+        typeof record.at !== "number" ||
+        !Number.isSafeInteger(record.at)) {
+        errors.push(`clonedFrom must be an object with non-empty id/digest strings and an integer at, found ${JSON.stringify(value)}`);
+        return null;
+    }
+    return { id: record.id, digest: record.digest, at: record.at };
+}
+//# sourceMappingURL=builtin-suites.js.map

package/dist/profiles/builtin-suites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-suites.js","sourceRoot":"","sources":["../../src/profiles/builtin-suites.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Builtin suite (方案) declarations and suite.json (schemaVersion 1)\n * serialization, parsing, and validation — 方案系统设计.md v2 §5/§6/§9, M1a.\n *\n * Suites are pure data plus default policy: both builtin suites share the same\n * unrestricted tool surface and differ only in orientation and memory strategy\n * (the orientation persona text is injected into the system prompt, M2).\n * Nothing here touches the packages/agent kernel; association resolution is\n * declaration-only until M1b.\n */\n\nexport const SUITE_SCHEMA_VERSION = 1;\n\n/**\n * Factory contents revision (M4): the revision of the factory builtin\n * declarations, independent of SUITE_SCHEMA_VERSION. Bump it (and update both\n * builtin declarations' `factoryRevision`) whenever the factory contents\n * change; the registry upgrade proposal then offers `--suite-reset` for\n * workspaces still on an older revision. Suite schema evolution keeps using\n * SUITE_SCHEMA_VERSION.\n *\n * Revision 2 (统一修复轮集成收口, 2026-09-08): assistant and coding now share\n * the same active 8-tool surface in full-control — the sdk `suiteToolOverride`\n * DEFAULT_SUITE_ID exemption was removed (方案设计 §5 + user decision). Existing\n * workspaces provisioned at revision 1 receive the upgrade-proposal diagnostic\n * and adopt via `--suite-reset`.\n *\n * Revision 3 (2026-09-18): `builtin.session-share` joins both builtin suites\n * (开发计划 §216: session-share productized from the example plugin into a\n * first-party default-distributed capability) once the agent-dir config\n * channel for embedded capabilities landed\n * (`<agentDir>/capabilities/<short-id>.json`, see capabilities/builtin.ts).\n * Existing workspaces provisioned at revision 2 receive the upgrade-proposal\n * diagnostic and adopt via `--suite-reset`.\n *\n * Revision 4 (2026-09-18): `builtin.subagent-delegate` joins both builtin\n * suites — the first-party subagent delegation tool (`subagent_run`) now ships\n * by default in shared mode (zero extra processes; pooled runner processes stay\n * opt-in through the capability config channel). Existing workspaces\n * provisioned at revision 3 receive the upgrade-proposal diagnostic and adopt\n * via `--suite-reset`.\n */\nexport const FACTORY_CONTENTS_VERSION = 5;\n\n/** Factory default suite used when no suite is configured anywhere (设计 §9). */\nexport const DEFAULT_SUITE_ID = \"assistant\";\n\n/** Suite ids become directory names: lowercase letters, digits, hyphens (设计 §9). */\nexport const SUITE_ID_MAX_LENGTH = 64;\n\n/** The single unrestricted tool surface shared by both builtin suites (设计 §5/§6). */\nexport const BUILTIN_SUITE_TOOLS: readonly string[] = [\n\t\"read\",\n\t\"write\",\n\t\"edit\",\n\t\"bash\",\n\t\"ls\",\n\t\"find\",\n\t\"grep\",\n\t\"powershell\",\n];\n\n/**\n * Builtin capability plugins associated with both suites. Declaration-only\n * data in M1a; the actual plugin wiring is delivered in M3. `builtin.memory`\n * joins in the 统一修复轮 A 路 (方案系统设计 §6.1: both suites share the same\n * memory tool surface; the strategy difference lives in the suiteId domain\n * isolation and the assistant preference card). `builtin.session-share` joins\n * in the session-share productization slice (开发计划 §216); its\n * target/gateway/viewerUrl are configured through the agent-dir config\n * channel (`<agentDir>/capabilities/builtin.session-share.json`), and the\n * unconfigured default answers `/share` with the explicit configuration\n * prompt — never an implicit Radius/Gist fallback.\n */\nexport const BUILTIN_SUITE_CAPABILITIES: readonly string[] = [\n\t\"builtin.goal\",\n\t\"builtin.plan\",\n\t\"builtin.todo-set\",\n\t\"builtin.memory\",\n\t\"builtin.session-share\",\n\t\"builtin.subagent-delegate\",\n];\n\nexport type SuiteMemoryStrategy = \"assistant\" | \"code\";\nexport type SuiteOrientation = \"assistant\" | \"coding\";\n\n/**\n * Orientation persona texts injected into the system prompt (设计 §6.2, M2).\n * The strings are verbatim from the design spec: the assistant persona is the\n * companion style, the coding persona is the rigor-first style. Both are\n * session-nature declarations, so they ride every system prompt branch\n * (default and customPrompt).\n */\nexport const ORIENTATION_PROMPTS: Record<SuiteOrientation, string> = {\n\tassistant: `You are the user's thoughtful companion — warm, patient, and helpful.\n- Understand the intent behind the question, including the unspoken parts; when something that matters is ambiguous, ask one short clarifying question instead of assuming.\n- Pay attention to detail: notice what the user might have missed and gently point it out.\n- Be proactive and divergent: after answering, offer next steps, related ideas, or creative alternatives — without being pushy.\n- Adapt tone to the user; stay natural and flexible, never robotic or formulaic.\n- When you can help by doing, act through tools autonomously (minimal interruption).\n- Structure longer answers clearly: short paragraphs, lists where they help, and a concrete \"what you can do next\" at the end.`,\n\tcoding: `You are an autonomous software engineering agent with a rigor-first mindset.\n- Never guess. Ground every claim in code you have read, commands you have run, or documented evidence; cite file paths and line numbers. If the evidence is insufficient, investigate, and report what is unverified — or \"unknown\" — instead of a plausible invention.\n- First principles: trace problems to the earliest reasonable root cause and fix that; do not patch symptoms.\n- No over-engineering: add no abstraction, options, or defensive handling for imagined future needs; generalise only when a second concrete case demands it.\n- Tests first: pin expected behavior with a failing or updated test before or alongside the fix, then run the smallest sufficient relevant checks; the work is not done until they pass.\n- Reproducible: prefer deterministic tests and mocks over ad-hoc verification, and report the exact commands and results so others can re-run them.\n- Docs as code: repository documentation is part of the change — keep design docs, READMEs, and changelogs consistent with the behavior they describe.\n- Self-review before finishing: re-check your changes for correctness, edge cases, regressions, and missing tests; prefer a second review pass over shipping the first draft.\n- Cautious: weigh side effects, compatibility, and failure modes; when in doubt, take the safer path.`,\n};\n\nexport interface SuiteAssociations {\n\treadonly skills: readonly string[];\n\treadonly mcp: readonly string[];\n\treadonly plugins: readonly string[];\n\t/**\n\t * 子代理角色关联（D-044 角色机制）：关联的是 `<agentDir>/roles/<id>.json` 里的角色 id。\n\t * 角色定义只在磁盘上（工厂仅做种子落盘），方案只决定哪些角色对主代理可见——与\n\t * skill/MCP/插件同构，第一方与第三方角色没有区别。\n\t */\n\treadonly roles: readonly string[];\n}\n\nexport interface SuiteClonedFrom {\n\treadonly id: string;\n\treadonly digest: string;\n\treadonly at: number;\n}\n\n/** The serializable suite definition persisted as suite.json (设计 §5). */\nexport interface SuiteDefinition {\n\treadonly schemaVersion: number;\n\treadonly id: string;\n\treadonly name: string;\n\treadonly builtin: boolean;\n\treadonly tools: readonly string[];\n\treadonly capabilities: readonly string[];\n\treadonly associations: SuiteAssociations;\n\treadonly inheritSystemAgentsMd: boolean;\n\treadonly memory: SuiteMemoryStrategy;\n\treadonly orientation: SuiteOrientation;\n\treadonly model: string | null;\n\treadonly thinking: string | null;\n\treadonly clonedFrom: SuiteClonedFrom | null;\n\t/**\n\t * Factory contents revision this declaration was written at (M4). Builtin\n\t * declarations carry it; on-disk builtin suite.json may omit it (pre-M4\n\t * files parse as FACTORY_CONTENTS_VERSION). User suites are outside factory\n\t * upgrade governance: the key stays optional and may be absent.\n\t */\n\treadonly factoryRevision?: number;\n}\n\nconst EMPTY_ASSOCIATIONS: SuiteAssociations = { skills: [], mcp: [], plugins: [], roles: [] };\n\n/**\n * 默认方案关联的子代理角色（开箱即用）：这两个 id 对应工厂种子落盘的两个普通角色文件\n * （`<agentDir>/roles/{explore,reviewer}.json`，用户可改可删）。工厂不在运行期回退到任何\n * 编译内的角色定义；删掉文件只会让该关联成为 dangling 诊断。\n */\nexport const DEFAULT_ROLE_ASSOCIATIONS: readonly string[] = [\"explore\", \"reviewer\"];\n\nconst assistantSuite: SuiteDefinition = {\n\tschemaVersion: SUITE_SCHEMA_VERSION,\n\tid: \"assistant\",\n\tname: \"Assistant\",\n\tbuiltin: true,\n\ttools: BUILTIN_SUITE_TOOLS,\n\tcapabilities: BUILTIN_SUITE_CAPABILITIES,\n\tassociations: { ...EMPTY_ASSOCIATIONS, roles: DEFAULT_ROLE_ASSOCIATIONS },\n\tinheritSystemAgentsMd: false,\n\tmemory: \"assistant\",\n\torientation: \"assistant\",\n\tmodel: null,\n\tthinking: null,\n\tclonedFrom: null,\n\tfactoryRevision: FACTORY_CONTENTS_VERSION,\n};\n\nconst codingSuite: SuiteDefinition = {\n\tschemaVersion: SUITE_SCHEMA_VERSION,\n\tid: \"coding\",\n\tname: \"Coding\",\n\tbuiltin: true,\n\ttools: BUILTIN_SUITE_TOOLS,\n\tcapabilities: BUILTIN_SUITE_CAPABILITIES,\n\tassociations: { ...EMPTY_ASSOCIATIONS, roles: DEFAULT_ROLE_ASSOCIATIONS },\n\tinheritSystemAgentsMd: false,\n\tmemory: \"code\",\n\torientation: \"coding\",\n\tmodel: null,\n\tthinking: null,\n\tclonedFrom: null,\n\tfactoryRevision: FACTORY_CONTENTS_VERSION,\n};\n\n/** The factory builtin pair: assistant (fallback default) and coding (尖刀). */\nexport const BUILTIN_SUITES: readonly SuiteDefinition[] = [assistantSuite, codingSuite];\n\nexport function getBuiltinSuite(id: string): SuiteDefinition | undefined {\n\treturn BUILTIN_SUITES.find((suite) => suite.id === id);\n}\n\nexport function isBuiltinSuiteId(id: string): boolean {\n\treturn BUILTIN_SUITES.some((suite) => suite.id === id);\n}\n\nconst WINDOWS_RESERVED_IDS = new Set([\n\t\"con\",\n\t\"prn\",\n\t\"aux\",\n\t\"nul\",\n\t\"com1\",\n\t\"com2\",\n\t\"com3\",\n\t\"com4\",\n\t\"com5\",\n\t\"com6\",\n\t\"com7\",\n\t\"com8\",\n\t\"com9\",\n\t\"lpt1\",\n\t\"lpt2\",\n\t\"lpt3\",\n\t\"lpt4\",\n\t\"lpt5\",\n\t\"lpt6\",\n\t\"lpt7\",\n\t\"lpt8\",\n\t\"lpt9\",\n\t\"conin$\",\n\t\"conout$\",\n]);\n\n/** Suite id rule (设计 §9): `a-z0-9-`, no leading/trailing hyphen, no Windows reserved names. */\nexport function isValidSuiteId(id: string): boolean {\n\tif (id.length === 0 || id.length > SUITE_ID_MAX_LENGTH) return false;\n\tif (!/^[a-z0-9-]+$/.test(id)) return false;\n\tif (id.startsWith(\"-\") || id.endsWith(\"-\")) return false;\n\tif (WINDOWS_RESERVED_IDS.has(id)) return false;\n\treturn true;\n}\n\n/** Serializes a suite to the canonical suite.json text (stable field order, trailing newline). */\nexport function serializeSuiteJson(suite: SuiteDefinition): string {\n\tconst ordered = {\n\t\tschemaVersion: suite.schemaVersion,\n\t\tid: suite.id,\n\t\tname: suite.name,\n\t\tbuiltin: suite.builtin,\n\t\ttools: [...suite.tools],\n\t\tcapabilities: [...suite.capabilities],\n\t\tassociations: {\n\t\t\tskills: [...suite.associations.skills],\n\t\t\tmcp: [...suite.associations.mcp],\n\t\t\tplugins: [...suite.associations.plugins],\n\t\t\troles: [...suite.associations.roles],\n\t\t},\n\t\tinheritSystemAgentsMd: suite.inheritSystemAgentsMd,\n\t\tmemory: suite.memory,\n\t\torientation: suite.orientation,\n\t\tmodel: suite.model,\n\t\tthinking: suite.thinking,\n\t\tclonedFrom: suite.clonedFrom\n\t\t\t? { id: suite.clonedFrom.id, digest: suite.clonedFrom.digest, at: suite.clonedFrom.at }\n\t\t\t: null,\n\t\tfactoryRevision: suite.factoryRevision,\n\t};\n\treturn `${JSON.stringify(ordered, null, 2)}\\n`;\n}\n\nexport interface SuiteJsonParseResult {\n\treadonly valid: boolean;\n\treadonly suite?: SuiteDefinition;\n\treadonly errors: readonly string[];\n}\n\n/**\n * Parses suite.json text. Never throws: an invalid result carries every\n * validation error so callers can apply the corruption policy (设计 §9) —\n * builtin suites fall back to factory content, user suites fail fast.\n */\nexport function parseSuiteJson(\n\traw: string,\n\toptions: { expectedBuiltin?: boolean; expectedId?: string },\n): SuiteJsonParseResult {\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(raw);\n\t} catch (error) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terrors: [`invalid JSON: ${error instanceof Error ? error.message : String(error)}`],\n\t\t};\n\t}\n\treturn validateSuiteJson(value, options);\n}\n\nexport function validateSuiteJson(\n\tvalue: unknown,\n\toptions: { expectedBuiltin?: boolean; expectedId?: string } = {},\n): SuiteJsonParseResult {\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n\t\treturn { valid: false, errors: [\"suite.json must be a JSON object\"] };\n\t}\n\tconst record = value as Record<string, unknown>;\n\tconst errors: string[] = [];\n\n\tif (record.schemaVersion !== SUITE_SCHEMA_VERSION) {\n\t\terrors.push(`schemaVersion must be ${SUITE_SCHEMA_VERSION}, found ${JSON.stringify(record.schemaVersion)}`);\n\t}\n\n\t// Each field keeps a typed local: valid values land here, invalid ones only\n\t// contribute errors. The suite below is constructed exclusively when\n\t// `errors` is empty, so the fallbacks/coercions at that point are dead.\n\tconst idValue = record.id;\n\tconst id = typeof idValue === \"string\" && isValidSuiteId(idValue) ? idValue : undefined;\n\tif (id === undefined) {\n\t\terrors.push(\n\t\t\t`id must be a suite id (^[a-z0-9-]+$, no leading/trailing hyphen, Windows reserved names rejected), found ${JSON.stringify(idValue)}`,\n\t\t);\n\t} else if (options.expectedId !== undefined && id !== options.expectedId) {\n\t\terrors.push(`id \"${id}\" does not match the suite workspace directory id \"${options.expectedId}\"`);\n\t}\n\n\tconst nameValue = record.name;\n\tconst name = typeof nameValue === \"string\" && nameValue.trim().length > 0 ? nameValue : undefined;\n\tif (name === undefined) {\n\t\terrors.push(`name must be a non-empty string, found ${JSON.stringify(nameValue)}`);\n\t}\n\n\tconst builtinValue = record.builtin;\n\tconst builtin = typeof builtinValue === \"boolean\" ? builtinValue : undefined;\n\tif (builtin === undefined) {\n\t\terrors.push(`builtin must be a boolean, found ${JSON.stringify(builtinValue)}`);\n\t} else if (options.expectedBuiltin === true && builtin !== true) {\n\t\terrors.push(`builtin must be true for a builtin suite workspace, found ${builtin}`);\n\t}\n\n\tconst tools = readStringArray(record, \"tools\", errors);\n\tconst capabilities = readStringArray(record, \"capabilities\", errors);\n\tconst associations = readAssociations(record.associations, errors);\n\n\tconst inheritValue = record.inheritSystemAgentsMd;\n\tconst inheritSystemAgentsMd = typeof inheritValue === \"boolean\" ? inheritValue : undefined;\n\tif (inheritSystemAgentsMd === undefined) {\n\t\terrors.push(`inheritSystemAgentsMd must be a boolean, found ${JSON.stringify(inheritValue)}`);\n\t}\n\n\tconst memoryValue = record.memory;\n\tconst memory = memoryValue === \"assistant\" || memoryValue === \"code\" ? memoryValue : undefined;\n\tif (memory === undefined) {\n\t\terrors.push(`memory must be \"assistant\" or \"code\", found ${JSON.stringify(memoryValue)}`);\n\t}\n\n\tconst orientationValue = record.orientation;\n\tconst orientation = orientationValue === \"assistant\" || orientationValue === \"coding\" ? orientationValue : undefined;\n\tif (orientationValue !== undefined && orientation === undefined) {\n\t\terrors.push(`orientation must be \"assistant\" or \"coding\", found ${JSON.stringify(orientationValue)}`);\n\t}\n\n\tconst model = readOptionalString(record, \"model\", errors);\n\tconst thinking = readOptionalString(record, \"thinking\", errors);\n\tconst clonedFrom = readClonedFrom(record.clonedFrom, errors);\n\tconst factoryRevision = readFactoryRevision(record.factoryRevision, options.expectedBuiltin === true, errors);\n\n\tif (errors.length > 0) return { valid: false, errors };\n\n\treturn {\n\t\tvalid: true,\n\t\terrors: [],\n\t\tsuite: {\n\t\t\tschemaVersion: SUITE_SCHEMA_VERSION,\n\t\t\tid: id!,\n\t\t\tname: name!,\n\t\t\tbuiltin: builtin!,\n\t\t\ttools,\n\t\t\tcapabilities,\n\t\t\tassociations,\n\t\t\tinheritSystemAgentsMd: inheritSystemAgentsMd!,\n\t\t\tmemory: memory!,\n\t\t\torientation: orientation ?? \"assistant\",\n\t\t\tmodel,\n\t\t\tthinking,\n\t\t\tclonedFrom,\n\t\t\t...(factoryRevision === undefined ? {} : { factoryRevision }),\n\t\t},\n\t};\n}\n\nfunction readStringArray(record: Record<string, unknown>, key: string, errors: string[]): readonly string[] {\n\tconst value = record[key];\n\tif (!Array.isArray(value)) {\n\t\terrors.push(`${key} must be an array of strings, found ${JSON.stringify(value)}`);\n\t\treturn [];\n\t}\n\tconst entries: string[] = [];\n\tconst seen = new Set<string>();\n\tfor (const item of value) {\n\t\tif (typeof item !== \"string\" || item.trim().length === 0) {\n\t\t\terrors.push(`${key} entries must be non-empty strings, found ${JSON.stringify(item)}`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (seen.has(item)) {\n\t\t\terrors.push(`${key} contains duplicate entry \"${item}\"`);\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(item);\n\t\tentries.push(item);\n\t}\n\treturn entries;\n}\n\nfunction readAssociations(value: unknown, errors: string[]): SuiteAssociations {\n\tif (value === undefined) return { skills: [], mcp: [], plugins: [], roles: [] };\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n\t\terrors.push(\n\t\t\t`associations must be an object with skills/mcp/plugins/roles arrays, found ${JSON.stringify(value)}`,\n\t\t);\n\t\treturn { skills: [], mcp: [], plugins: [], roles: [] };\n\t}\n\tconst record = value as Record<string, unknown>;\n\t// A key left out entirely means an empty list, consistent with a fully\n\t// absent `associations` object; a key that is present but malformed still\n\t// reports its errors. The removed legacy `extensions` kind is ignored on\n\t// read (it lost its loader with the old ExtensionAPI surface).\n\treturn {\n\t\tskills: record.skills === undefined ? [] : readStringArray(record, \"skills\", errors),\n\t\tmcp: record.mcp === undefined ? [] : readStringArray(record, \"mcp\", errors),\n\t\tplugins: record.plugins === undefined ? [] : readStringArray(record, \"plugins\", errors),\n\t\troles: record.roles === undefined ? [] : readStringArray(record, \"roles\", errors),\n\t};\n}\n\nfunction readOptionalString(record: Record<string, unknown>, key: string, errors: string[]): string | null {\n\tconst value = record[key];\n\tif (value === undefined || value === null) return null;\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\terrors.push(`${key} must be a non-empty string or null, found ${JSON.stringify(value)}`);\n\t\treturn null;\n\t}\n\treturn value;\n}\n\n/**\n * Reads the optional `factoryRevision` key (M4). A missing key means\n * FACTORY_CONTENTS_VERSION for builtin workspaces (pre-M4 on-disk files stay\n * compatible) and stays absent for user suites (outside factory upgrade\n * governance). A present key must be a positive integer.\n */\nfunction readFactoryRevision(value: unknown, expectedBuiltin: boolean, errors: string[]): number | undefined {\n\tif (value === undefined) return expectedBuiltin ? FACTORY_CONTENTS_VERSION : undefined;\n\tif (typeof value !== \"number\" || !Number.isSafeInteger(value) || value <= 0) {\n\t\terrors.push(`factoryRevision must be a positive integer, found ${JSON.stringify(value)}`);\n\t\treturn undefined;\n\t}\n\treturn value;\n}\n\nfunction readClonedFrom(value: unknown, errors: string[]): SuiteClonedFrom | null {\n\tif (value === undefined || value === null) return null;\n\tif (typeof value !== \"object\" || Array.isArray(value)) {\n\t\terrors.push(`clonedFrom must be an object with id/digest/at, found ${JSON.stringify(value)}`);\n\t\treturn null;\n\t}\n\tconst record = value as Record<string, unknown>;\n\tif (\n\t\ttypeof record.id !== \"string\" ||\n\t\trecord.id.trim().length === 0 ||\n\t\ttypeof record.digest !== \"string\" ||\n\t\trecord.digest.trim().length === 0 ||\n\t\ttypeof record.at !== \"number\" ||\n\t\t!Number.isSafeInteger(record.at)\n\t) {\n\t\terrors.push(\n\t\t\t`clonedFrom must be an object with non-empty id/digest strings and an integer at, found ${JSON.stringify(value)}`,\n\t\t);\n\t\treturn null;\n\t}\n\treturn { id: record.id, digest: record.digest, at: record.at };\n}\n"]}

package/dist/profiles/resolved-agent-profile.d.ts

@@ -0,0 +1,83 @@
+import type { PluginDiagnosticCodeV1 } from "../plugins/ecosystem/types.ts";
+import type { ProfileIdentityV1 } from "../profile/identity.ts";
+import type { ProfileLockVerificationV1 } from "../profile/lock.ts";
+import type { BuiltinPluginProfileResolutionV1 } from "../profile/plugin-profiles.ts";
+import type { SuiteWorkspace } from "./suite-loader.ts";
+/**
+ * Bounded summary of the builtin plugin profile resolution: the `resolved`
+ * variant carries id/version/digest/pluginIds; every other variant records the
+ * variant name with its structured reason fields; an absent resolution is the
+ * `none` variant. The full resolution objects stay with their existing
+ * channels; the aggregate carries only this bounded projection.
+ */
+export type PluginProfileResolutionSummaryV1 = {
+    readonly variant: "resolved";
+    readonly profileId: string;
+    readonly profileVersion: string;
+    /** Ecosystem resolved-manifests digest (suite-domain digest lives on `identity`). */
+    readonly manifestDigest: string;
+    readonly pluginIds: readonly string[];
+} | {
+    readonly variant: "not_found";
+    readonly profileId: string;
+} | {
+    readonly variant: "host_facts_required";
+    readonly profileId: string;
+} | {
+    readonly variant: "invalid_selection";
+    readonly profileId: string;
+    readonly unknownPluginIds: readonly string[];
+    readonly duplicatePluginIds: readonly string[];
+} | {
+    readonly variant: "none";
+};
+/**
+ * Unified diagnostic entry (D-047 S4d): each source keeps its own fidelity
+ * behind a `source` tag — suite diagnostics are plain strings, plugin-profile
+ * diagnostics keep their structured code/details. No lossy normalization.
+ */
+export type ResolvedProfileDiagnosticV1 = {
+    readonly source: "suite";
+    readonly message: string;
+} | {
+    readonly source: "plugin-profile";
+    readonly code: PluginDiagnosticCodeV1;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, string>>;
+};
+/** The immutable, deep-frozen aggregate view of one session's resolved suite profile. */
+export interface ResolvedAgentProfileV1 {
+    readonly suiteId: string;
+    /** Authoritative: workspace.identity (buildSuiteProfileIdentity product, already frozen). */
+    readonly identity: ProfileIdentityV1;
+    /** Authoritative: the verifyProfileLock three-state result; undefined when the workspace had no persisted lock. */
+    readonly lockVerification?: ProfileLockVerificationV1;
+    /** Bounded summary of the plugin profile resolution; never the live resolution objects. */
+    readonly pluginProfile: PluginProfileResolutionSummaryV1;
+    /** Bounded path projection of the suite workspace (no live objects). */
+    readonly workspace: {
+        readonly suiteDir: string;
+        readonly suiteJsonPath: string;
+        readonly agentsMdPath: string;
+        readonly lockPath: string;
+    };
+    /**
+     * Build-time diagnostic snapshot (D-047 S4d first increment): workspace
+     * diagnostics (suite source, in order) followed by the resolved plugin
+     * profile's diagnostics (plugin-profile source, in order). Empty when
+     * neither source contributed — the common no-diagnostics case.
+     */
+    readonly diagnostics: readonly ResolvedProfileDiagnosticV1[];
+}
+/**
+ * Builds the deep-frozen ResolvedAgentProfileV1 from the existing
+ * authoritative sources. Pure function: it assembles from `input` and returns
+ * a detached (deep-cloned, recursively frozen) snapshot, so later mutation of
+ * the sources can never flow into the aggregate.
+ */
+export declare function buildResolvedAgentProfileV1(input: {
+    suiteId: string;
+    workspace: SuiteWorkspace;
+    pluginProfile?: BuiltinPluginProfileResolutionV1;
+}): ResolvedAgentProfileV1;
+//# sourceMappingURL=resolved-agent-profile.d.ts.map

package/dist/profiles/resolved-agent-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-agent-profile.d.ts","sourceRoot":"","sources":["../../src/profiles/resolved-agent-profile.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,gCAAgC,GACzC;IACA,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,qFAAqF;IACrF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACvE;IACA,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C,GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhC;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GACpC;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IACA,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD,CAAC;AAEL,yFAAyF;AACzF,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,mHAAmH;IACnH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IACtD,2FAA2F;IAC3F,QAAQ,CAAC,aAAa,EAAE,gCAAgC,CAAC;IACzD,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE;QACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC7D;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,CAAC;IAC1B,aAAa,CAAC,EAAE,gCAAgC,CAAC;CACjD,GAAG,sBAAsB,CAkDzB","sourcesContent":["/**\n * ResolvedAgentProfile (D-047 S4a, docs/plans/G4-resolved-agent-profile设计注记.md):\n * the immutable per-session aggregate view over the resolved suite profile.\n *\n * S4d first increment: the aggregate additionally carries a build-time\n * `diagnostics` snapshot projected from SuiteWorkspace.diagnostics and the\n * resolved plugin profile's ProfileResolutionV1.diagnostics; the existing five\n * diagnostic channels are untouched and remain the live sources.\n *\n * This is an aggregate VIEW, not a new generation mechanism: every field\n * references an existing authoritative source (字段-权威映射 in the design\n * note), resolution still happens at the existing single point\n * (createAgentSession's suite+pluginProfile assembly, once per session), and\n * the builder only re-projects those sources and deep-freezes the result. The\n * aggregate lives at the resolution layer (session creation result and host\n * references); `AgentSession` stays suite-unaware — it never enters\n * AgentSessionConfig, and the session's persisted identity authority remains\n * the suite custom entry.\n */\nimport { detachedSnapshot } from \"../core/extensions/capability-runtime-snapshot.ts\";\nimport type { PluginDiagnosticCodeV1 } from \"../plugins/ecosystem/types.ts\";\nimport type { ProfileIdentityV1 } from \"../profile/identity.ts\";\nimport type { ProfileLockVerificationV1 } from \"../profile/lock.ts\";\nimport type { BuiltinPluginProfileResolutionV1 } from \"../profile/plugin-profiles.ts\";\nimport type { SuiteWorkspace } from \"./suite-loader.ts\";\n\n/**\n * Bounded summary of the builtin plugin profile resolution: the `resolved`\n * variant carries id/version/digest/pluginIds; every other variant records the\n * variant name with its structured reason fields; an absent resolution is the\n * `none` variant. The full resolution objects stay with their existing\n * channels; the aggregate carries only this bounded projection.\n */\nexport type PluginProfileResolutionSummaryV1 =\n\t| {\n\t\t\treadonly variant: \"resolved\";\n\t\t\treadonly profileId: string;\n\t\t\treadonly profileVersion: string;\n\t\t\t/** Ecosystem resolved-manifests digest (suite-domain digest lives on `identity`). */\n\t\t\treadonly manifestDigest: string;\n\t\t\treadonly pluginIds: readonly string[];\n\t  }\n\t| { readonly variant: \"not_found\"; readonly profileId: string }\n\t| { readonly variant: \"host_facts_required\"; readonly profileId: string }\n\t| {\n\t\t\treadonly variant: \"invalid_selection\";\n\t\t\treadonly profileId: string;\n\t\t\treadonly unknownPluginIds: readonly string[];\n\t\t\treadonly duplicatePluginIds: readonly string[];\n\t  }\n\t| { readonly variant: \"none\" };\n\n/**\n * Unified diagnostic entry (D-047 S4d): each source keeps its own fidelity\n * behind a `source` tag — suite diagnostics are plain strings, plugin-profile\n * diagnostics keep their structured code/details. No lossy normalization.\n */\nexport type ResolvedProfileDiagnosticV1 =\n\t| { readonly source: \"suite\"; readonly message: string }\n\t| {\n\t\t\treadonly source: \"plugin-profile\";\n\t\t\treadonly code: PluginDiagnosticCodeV1;\n\t\t\treadonly message: string;\n\t\t\treadonly details?: Readonly<Record<string, string>>;\n\t  };\n\n/** The immutable, deep-frozen aggregate view of one session's resolved suite profile. */\nexport interface ResolvedAgentProfileV1 {\n\treadonly suiteId: string;\n\t/** Authoritative: workspace.identity (buildSuiteProfileIdentity product, already frozen). */\n\treadonly identity: ProfileIdentityV1;\n\t/** Authoritative: the verifyProfileLock three-state result; undefined when the workspace had no persisted lock. */\n\treadonly lockVerification?: ProfileLockVerificationV1;\n\t/** Bounded summary of the plugin profile resolution; never the live resolution objects. */\n\treadonly pluginProfile: PluginProfileResolutionSummaryV1;\n\t/** Bounded path projection of the suite workspace (no live objects). */\n\treadonly workspace: {\n\t\treadonly suiteDir: string;\n\t\treadonly suiteJsonPath: string;\n\t\treadonly agentsMdPath: string;\n\t\treadonly lockPath: string;\n\t};\n\t/**\n\t * Build-time diagnostic snapshot (D-047 S4d first increment): workspace\n\t * diagnostics (suite source, in order) followed by the resolved plugin\n\t * profile's diagnostics (plugin-profile source, in order). Empty when\n\t * neither source contributed — the common no-diagnostics case.\n\t */\n\treadonly diagnostics: readonly ResolvedProfileDiagnosticV1[];\n}\n\n/**\n * Builds the deep-frozen ResolvedAgentProfileV1 from the existing\n * authoritative sources. Pure function: it assembles from `input` and returns\n * a detached (deep-cloned, recursively frozen) snapshot, so later mutation of\n * the sources can never flow into the aggregate.\n */\nexport function buildResolvedAgentProfileV1(input: {\n\tsuiteId: string;\n\tworkspace: SuiteWorkspace;\n\tpluginProfile?: BuiltinPluginProfileResolutionV1;\n}): ResolvedAgentProfileV1 {\n\tconst { workspace } = input;\n\tconst pluginProfile = input.pluginProfile;\n\tconst summary: PluginProfileResolutionSummaryV1 =\n\t\tpluginProfile === undefined\n\t\t\t? { variant: \"none\" }\n\t\t\t: pluginProfile.status === \"resolved\"\n\t\t\t\t? {\n\t\t\t\t\t\tvariant: \"resolved\",\n\t\t\t\t\t\tprofileId: pluginProfile.profile.id,\n\t\t\t\t\t\tprofileVersion: pluginProfile.profile.version,\n\t\t\t\t\t\tmanifestDigest: pluginProfile.resolution.resolvedManifest.manifestDigest,\n\t\t\t\t\t\tpluginIds: pluginProfile.resolution.resolvedManifest.plugins.map((plugin) => plugin.pluginId),\n\t\t\t\t\t}\n\t\t\t\t: pluginProfile.status === \"invalid_selection\"\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tvariant: \"invalid_selection\",\n\t\t\t\t\t\t\tprofileId: pluginProfile.profileId,\n\t\t\t\t\t\t\tunknownPluginIds: [...pluginProfile.unknownPluginIds],\n\t\t\t\t\t\t\tduplicatePluginIds: [...pluginProfile.duplicatePluginIds],\n\t\t\t\t\t\t}\n\t\t\t\t\t: pluginProfile.status === \"not_found\"\n\t\t\t\t\t\t? { variant: \"not_found\", profileId: pluginProfile.profileId }\n\t\t\t\t\t\t: { variant: \"host_facts_required\", profileId: pluginProfile.profileId };\n\tconst diagnostics: ResolvedProfileDiagnosticV1[] = [\n\t\t...workspace.diagnostics.map((message): ResolvedProfileDiagnosticV1 => ({ source: \"suite\", message })),\n\t\t...(pluginProfile?.status === \"resolved\"\n\t\t\t? pluginProfile.resolution.diagnostics.map(\n\t\t\t\t\t(diagnostic): ResolvedProfileDiagnosticV1 => ({\n\t\t\t\t\t\tsource: \"plugin-profile\",\n\t\t\t\t\t\tcode: diagnostic.code,\n\t\t\t\t\t\tmessage: diagnostic.message,\n\t\t\t\t\t\t...(diagnostic.details === undefined ? {} : { details: diagnostic.details }),\n\t\t\t\t\t}),\n\t\t\t\t)\n\t\t\t: []),\n\t];\n\treturn detachedSnapshot({\n\t\tsuiteId: input.suiteId,\n\t\tidentity: workspace.identity,\n\t\t...(workspace.lockVerification === undefined ? {} : { lockVerification: workspace.lockVerification }),\n\t\tpluginProfile: summary,\n\t\tworkspace: {\n\t\t\tsuiteDir: workspace.suiteDir,\n\t\t\tsuiteJsonPath: workspace.suiteJsonPath,\n\t\t\tagentsMdPath: workspace.agentsMdPath,\n\t\t\tlockPath: workspace.lockPath,\n\t\t},\n\t\tdiagnostics,\n\t});\n}\n"]}

package/dist/profiles/resolved-agent-profile.js

@@ -0,0 +1,75 @@
+/**
+ * ResolvedAgentProfile (D-047 S4a, docs/plans/G4-resolved-agent-profile设计注记.md):
+ * the immutable per-session aggregate view over the resolved suite profile.
+ *
+ * S4d first increment: the aggregate additionally carries a build-time
+ * `diagnostics` snapshot projected from SuiteWorkspace.diagnostics and the
+ * resolved plugin profile's ProfileResolutionV1.diagnostics; the existing five
+ * diagnostic channels are untouched and remain the live sources.
+ *
+ * This is an aggregate VIEW, not a new generation mechanism: every field
+ * references an existing authoritative source (字段-权威映射 in the design
+ * note), resolution still happens at the existing single point
+ * (createAgentSession's suite+pluginProfile assembly, once per session), and
+ * the builder only re-projects those sources and deep-freezes the result. The
+ * aggregate lives at the resolution layer (session creation result and host
+ * references); `AgentSession` stays suite-unaware — it never enters
+ * AgentSessionConfig, and the session's persisted identity authority remains
+ * the suite custom entry.
+ */
+import { detachedSnapshot } from "../core/extensions/capability-runtime-snapshot.js";
+/**
+ * Builds the deep-frozen ResolvedAgentProfileV1 from the existing
+ * authoritative sources. Pure function: it assembles from `input` and returns
+ * a detached (deep-cloned, recursively frozen) snapshot, so later mutation of
+ * the sources can never flow into the aggregate.
+ */
+export function buildResolvedAgentProfileV1(input) {
+    const { workspace } = input;
+    const pluginProfile = input.pluginProfile;
+    const summary = pluginProfile === undefined
+        ? { variant: "none" }
+        : pluginProfile.status === "resolved"
+            ? {
+                variant: "resolved",
+                profileId: pluginProfile.profile.id,
+                profileVersion: pluginProfile.profile.version,
+                manifestDigest: pluginProfile.resolution.resolvedManifest.manifestDigest,
+                pluginIds: pluginProfile.resolution.resolvedManifest.plugins.map((plugin) => plugin.pluginId),
+            }
+            : pluginProfile.status === "invalid_selection"
+                ? {
+                    variant: "invalid_selection",
+                    profileId: pluginProfile.profileId,
+                    unknownPluginIds: [...pluginProfile.unknownPluginIds],
+                    duplicatePluginIds: [...pluginProfile.duplicatePluginIds],
+                }
+                : pluginProfile.status === "not_found"
+                    ? { variant: "not_found", profileId: pluginProfile.profileId }
+                    : { variant: "host_facts_required", profileId: pluginProfile.profileId };
+    const diagnostics = [
+        ...workspace.diagnostics.map((message) => ({ source: "suite", message })),
+        ...(pluginProfile?.status === "resolved"
+            ? pluginProfile.resolution.diagnostics.map((diagnostic) => ({
+                source: "plugin-profile",
+                code: diagnostic.code,
+                message: diagnostic.message,
+                ...(diagnostic.details === undefined ? {} : { details: diagnostic.details }),
+            }))
+            : []),
+    ];
+    return detachedSnapshot({
+        suiteId: input.suiteId,
+        identity: workspace.identity,
+        ...(workspace.lockVerification === undefined ? {} : { lockVerification: workspace.lockVerification }),
+        pluginProfile: summary,
+        workspace: {
+            suiteDir: workspace.suiteDir,
+            suiteJsonPath: workspace.suiteJsonPath,
+            agentsMdPath: workspace.agentsMdPath,
+            lockPath: workspace.lockPath,
+        },
+        diagnostics,
+    });
+}
+//# sourceMappingURL=resolved-agent-profile.js.map