@ai-agent-forge/agent-forge 0.87.0 → 0.88.1

package/dist/profile/role-runner.d.ts

@@ -1,99 +0,0 @@
-/**
- * Role runner binding (2.2d) — maps registered `RoleMetadataV1` roles to child
- * `AgentDefinition`s executable through the experimental `AgentCompositionAPI`.
- *
- * The default run implementation is the deterministic first-batch role
- * callbacks (architecture-analyst / implementer / test-designer, 2.2c); a
- * caller may inject a real implementation via `run`. This slice never calls a
- * model.
- *
- * Library-level use works without any guard. When used through the
- * capability-runtime guards (`src/core/extensions/capability-runtime-guards.ts`),
- * the produced definitions must be defined/created by a manifest that declares
- * the `child-agent-controller` role and the `owner` must equal that manifest
- * id — the guards enforce this at the plugin boundary; this contract does not
- * duplicate guard logic.
- *
- * Required capability dependencies are checked explicitly (2.5a structured
- * `missing` shape) before activation (create/lease); they are never silently
- * skipped. Domain role runtimes live INSIDE the composition's child role: the
- * root/child two-value role enum is unchanged by design.
- */
-import type { AgentDefinition, AgentExecutionContext } from "../core/extensions/public-api.ts";
-import type { AvailableCapabilityV1 } from "./dependency-wiring.ts";
-import type { RoleCatalogV1 } from "./role-catalog.ts";
-/** Deterministic role input: a single spec string (first-batch contract). */
-export interface RoleRunnerInputV1 {
-    readonly spec: string;
-}
-/** Deterministic role output: a single result string (first-batch contract). */
-export interface RoleRunnerResultV1 {
-    readonly result: string;
-}
-/**
- * Per-role run implementation. `context` is present when executed through
- * `AgentCompositionAPI`; direct deterministic execution may omit it.
- */
-export type RoleRunCallbackV1 = (input: RoleRunnerInputV1, context?: AgentExecutionContext) => RoleRunnerResultV1 | Promise<RoleRunnerResultV1>;
-/** Runner-level run resolver; receives the roleId in addition to the callback arguments. */
-export type RoleRunResolverV1 = (roleId: string, input: RoleRunnerInputV1, context?: AgentExecutionContext) => RoleRunnerResultV1 | Promise<RoleRunnerResultV1>;
-/**
- * Role capability-dependency diagnostic: the 2.5a structured `missing` shape
- * (`capabilityId`/`requestedVersion`/`availableVersion?`/`reason`) with
- * `roleId` as the requester.
- */
-export interface RoleMissingCapabilityV1 {
-    readonly roleId: string;
-    readonly capabilityId: string;
-    readonly requestedVersion: number;
-    /** Undefined when the capability is entirely absent from the registry. */
-    readonly availableVersion?: number;
-    readonly reason: "missing" | "version_mismatch";
-}
-/** Activation check result for one role's REQUIRED capability dependencies. */
-export interface RoleCapabilityCheckV1 {
-    readonly roleId: string;
-    readonly status: "satisfied" | "missing";
-    /** Required dependencies that are absent or version-mismatched; empty when satisfied. */
-    readonly missing: readonly RoleMissingCapabilityV1[];
-}
-export interface RoleRunnerOptionsV1 {
-    readonly catalog: RoleCatalogV1;
-    /**
-     * Owner stamped onto produced child definitions. Required to equal the
-     * declaring plugin manifest id when used behind the capability-runtime
-     * guards; plain library use may omit it.
-     */
-    readonly owner?: string;
-    /**
-     * Injected run implementation replacing the deterministic first-batch
-     * defaults entirely. Roles without any binding still fail explicitly on
-     * execution.
-     */
-    readonly run?: RoleRunResolverV1;
-}
-export interface RoleRunnerV1 {
-    readonly catalog: RoleCatalogV1;
-    /** Sorted registered roleIds. */
-    listRoleIds(): readonly string[];
-    /**
-     * Maps a registered role to a child agent definition (composition role
-     * `child-agent-controller`, id `role:<roleId>`, version 1). Run the
-     * capability check before creating/leasing an instance.
-     */
-    createDefinition(roleId: string): AgentDefinition<RoleRunnerInputV1, RoleRunnerResultV1>;
-    /**
-     * Pre-activation capability-dependency check against an exact-version
-     * registry: a required dependency is satisfied only when the registry
-     * offers the same capability id at exactly the requested version. Optional
-     * dependencies never block activation and are not reported as missing.
-     */
-    checkCapabilities(roleId: string, availableCapabilities: readonly AvailableCapabilityV1[]): RoleCapabilityCheckV1;
-    /** Direct deterministic execution (the same run a produced definition binds). */
-    run(roleId: string, input: RoleRunnerInputV1, context?: AgentExecutionContext): Promise<RoleRunnerResultV1>;
-}
-/** Default deterministic run dispatch: first-batch callbacks; explicit failure otherwise. */
-export declare function runFirstBatchRole(roleId: string, input: RoleRunnerInputV1, context?: AgentExecutionContext): RoleRunnerResultV1 | Promise<RoleRunnerResultV1>;
-/** Binds the catalog's registered roles to child agent definitions. */
-export declare function createRoleRunner(options: RoleRunnerOptionsV1): RoleRunnerV1;
-//# sourceMappingURL=role-runner.d.ts.map

package/dist/profile/role-runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"role-runner.d.ts","sourceRoot":"","sources":["../../src/profile/role-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE/F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,mBAAmB,CAAC;AAEvE,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC/B,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,qBAAqB,KAC3B,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEtD,4FAA4F;AAC5F,MAAM,MAAM,iBAAiB,GAAG,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,qBAAqB,KAC3B,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,CAAC;CAChD;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,iCAAiC;IACjC,WAAW,IAAI,SAAS,MAAM,EAAE,CAAC;IACjC;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IACzF;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,qBAAqB,EAAE,GAAG,qBAAqB,CAAC;IAClH,iFAAiF;IACjF,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5G;AAQD,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,qBAAqB,GAC7B,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIlD;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAoE3E","sourcesContent":["/**\n * Role runner binding (2.2d) — maps registered `RoleMetadataV1` roles to child\n * `AgentDefinition`s executable through the experimental `AgentCompositionAPI`.\n *\n * The default run implementation is the deterministic first-batch role\n * callbacks (architecture-analyst / implementer / test-designer, 2.2c); a\n * caller may inject a real implementation via `run`. This slice never calls a\n * model.\n *\n * Library-level use works without any guard. When used through the\n * capability-runtime guards (`src/core/extensions/capability-runtime-guards.ts`),\n * the produced definitions must be defined/created by a manifest that declares\n * the `child-agent-controller` role and the `owner` must equal that manifest\n * id — the guards enforce this at the plugin boundary; this contract does not\n * duplicate guard logic.\n *\n * Required capability dependencies are checked explicitly (2.5a structured\n * `missing` shape) before activation (create/lease); they are never silently\n * skipped. Domain role runtimes live INSIDE the composition's child role: the\n * root/child two-value role enum is unchanged by design.\n */\nimport type { AgentDefinition, AgentExecutionContext } from \"../core/extensions/public-api.ts\";\nimport { t } from \"../core/i18n/index.ts\";\nimport type { AvailableCapabilityV1 } from \"./dependency-wiring.ts\";\nimport { FIRST_BATCH_ROLES } from \"./first-roles.ts\";\nimport type { RoleCatalogV1, RoleMetadataV1 } from \"./role-catalog.ts\";\n\n/** Deterministic role input: a single spec string (first-batch contract). */\nexport interface RoleRunnerInputV1 {\n\treadonly spec: string;\n}\n\n/** Deterministic role output: a single result string (first-batch contract). */\nexport interface RoleRunnerResultV1 {\n\treadonly result: string;\n}\n\n/**\n * Per-role run implementation. `context` is present when executed through\n * `AgentCompositionAPI`; direct deterministic execution may omit it.\n */\nexport type RoleRunCallbackV1 = (\n\tinput: RoleRunnerInputV1,\n\tcontext?: AgentExecutionContext,\n) => RoleRunnerResultV1 | Promise<RoleRunnerResultV1>;\n\n/** Runner-level run resolver; receives the roleId in addition to the callback arguments. */\nexport type RoleRunResolverV1 = (\n\troleId: string,\n\tinput: RoleRunnerInputV1,\n\tcontext?: AgentExecutionContext,\n) => RoleRunnerResultV1 | Promise<RoleRunnerResultV1>;\n\n/**\n * Role capability-dependency diagnostic: the 2.5a structured `missing` shape\n * (`capabilityId`/`requestedVersion`/`availableVersion?`/`reason`) with\n * `roleId` as the requester.\n */\nexport interface RoleMissingCapabilityV1 {\n\treadonly roleId: string;\n\treadonly capabilityId: string;\n\treadonly requestedVersion: number;\n\t/** Undefined when the capability is entirely absent from the registry. */\n\treadonly availableVersion?: number;\n\treadonly reason: \"missing\" | \"version_mismatch\";\n}\n\n/** Activation check result for one role's REQUIRED capability dependencies. */\nexport interface RoleCapabilityCheckV1 {\n\treadonly roleId: string;\n\treadonly status: \"satisfied\" | \"missing\";\n\t/** Required dependencies that are absent or version-mismatched; empty when satisfied. */\n\treadonly missing: readonly RoleMissingCapabilityV1[];\n}\n\nexport interface RoleRunnerOptionsV1 {\n\treadonly catalog: RoleCatalogV1;\n\t/**\n\t * Owner stamped onto produced child definitions. Required to equal the\n\t * declaring plugin manifest id when used behind the capability-runtime\n\t * guards; plain library use may omit it.\n\t */\n\treadonly owner?: string;\n\t/**\n\t * Injected run implementation replacing the deterministic first-batch\n\t * defaults entirely. Roles without any binding still fail explicitly on\n\t * execution.\n\t */\n\treadonly run?: RoleRunResolverV1;\n}\n\nexport interface RoleRunnerV1 {\n\treadonly catalog: RoleCatalogV1;\n\t/** Sorted registered roleIds. */\n\tlistRoleIds(): readonly string[];\n\t/**\n\t * Maps a registered role to a child agent definition (composition role\n\t * `child-agent-controller`, id `role:<roleId>`, version 1). Run the\n\t * capability check before creating/leasing an instance.\n\t */\n\tcreateDefinition(roleId: string): AgentDefinition<RoleRunnerInputV1, RoleRunnerResultV1>;\n\t/**\n\t * Pre-activation capability-dependency check against an exact-version\n\t * registry: a required dependency is satisfied only when the registry\n\t * offers the same capability id at exactly the requested version. Optional\n\t * dependencies never block activation and are not reported as missing.\n\t */\n\tcheckCapabilities(roleId: string, availableCapabilities: readonly AvailableCapabilityV1[]): RoleCapabilityCheckV1;\n\t/** Direct deterministic execution (the same run a produced definition binds). */\n\trun(roleId: string, input: RoleRunnerInputV1, context?: AgentExecutionContext): Promise<RoleRunnerResultV1>;\n}\n\nconst DEFINITION_VERSION = 1;\n\nconst FIRST_BATCH_RUNS = new Map<string, RoleRunCallbackV1>(\n\tFIRST_BATCH_ROLES.map((role) => [role.metadata.roleId, role.run]),\n);\n\n/** Default deterministic run dispatch: first-batch callbacks; explicit failure otherwise. */\nexport function runFirstBatchRole(\n\troleId: string,\n\tinput: RoleRunnerInputV1,\n\tcontext?: AgentExecutionContext,\n): RoleRunnerResultV1 | Promise<RoleRunnerResultV1> {\n\tconst callback = FIRST_BATCH_RUNS.get(roleId);\n\tif (!callback) throw new Error(t(\"No run binding for role: {roleId}\", { roleId }));\n\treturn callback(input, context);\n}\n\n/** Binds the catalog's registered roles to child agent definitions. */\nexport function createRoleRunner(options: RoleRunnerOptionsV1): RoleRunnerV1 {\n\tconst catalog = options.catalog;\n\n\tfunction requireRole(roleId: string): RoleMetadataV1 {\n\t\tconst metadata = catalog.get(roleId);\n\t\tif (!metadata) throw new Error(t(\"Unknown role: {roleId}\", { roleId }));\n\t\treturn metadata;\n\t}\n\n\tasync function execute(\n\t\troleId: string,\n\t\tinput: RoleRunnerInputV1,\n\t\tcontext?: AgentExecutionContext,\n\t): Promise<RoleRunnerResultV1> {\n\t\trequireRole(roleId);\n\t\tif (options.run) return options.run(roleId, input, context);\n\t\treturn runFirstBatchRole(roleId, input, context);\n\t}\n\n\treturn {\n\t\tcatalog,\n\t\tlistRoleIds() {\n\t\t\treturn catalog.list().map((role) => role.roleId);\n\t\t},\n\t\tcreateDefinition(roleId) {\n\t\t\tconst metadata = requireRole(roleId);\n\t\t\treturn {\n\t\t\t\tid: `role:${metadata.roleId}`,\n\t\t\t\tversion: DEFINITION_VERSION,\n\t\t\t\trole: \"child-agent-controller\",\n\t\t\t\t...(options.owner === undefined ? {} : { owner: options.owner }),\n\t\t\t\trun: (input, context) => execute(metadata.roleId, input, context),\n\t\t\t};\n\t\t},\n\t\tcheckCapabilities(roleId, availableCapabilities) {\n\t\t\tconst metadata = requireRole(roleId);\n\t\t\tconst registry = new Map(availableCapabilities.map((capability) => [capability.id, capability.version]));\n\t\t\tconst missing: RoleMissingCapabilityV1[] = [];\n\t\t\tfor (const dependency of metadata.capabilityDependencies) {\n\t\t\t\tif (!dependency.required) continue;\n\t\t\t\tconst availableVersion = registry.get(dependency.capabilityId);\n\t\t\t\tif (availableVersion === undefined) {\n\t\t\t\t\tmissing.push({\n\t\t\t\t\t\troleId,\n\t\t\t\t\t\tcapabilityId: dependency.capabilityId,\n\t\t\t\t\t\trequestedVersion: dependency.capabilityVersion,\n\t\t\t\t\t\treason: \"missing\",\n\t\t\t\t\t});\n\t\t\t\t} else if (availableVersion !== dependency.capabilityVersion) {\n\t\t\t\t\tmissing.push({\n\t\t\t\t\t\troleId,\n\t\t\t\t\t\tcapabilityId: dependency.capabilityId,\n\t\t\t\t\t\trequestedVersion: dependency.capabilityVersion,\n\t\t\t\t\t\tavailableVersion,\n\t\t\t\t\t\treason: \"version_mismatch\",\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn {\n\t\t\t\troleId,\n\t\t\t\tstatus: missing.length > 0 ? \"missing\" : \"satisfied\",\n\t\t\t\tmissing,\n\t\t\t};\n\t\t},\n\t\trun(roleId, input, context) {\n\t\t\treturn execute(roleId, input, context);\n\t\t},\n\t};\n}\n"]}

package/dist/profile/role-runner.js

@@ -1,79 +0,0 @@
-import { t } from "../core/i18n/index.js";
-import { FIRST_BATCH_ROLES } from "./first-roles.js";
-const DEFINITION_VERSION = 1;
-const FIRST_BATCH_RUNS = new Map(FIRST_BATCH_ROLES.map((role) => [role.metadata.roleId, role.run]));
-/** Default deterministic run dispatch: first-batch callbacks; explicit failure otherwise. */
-export function runFirstBatchRole(roleId, input, context) {
-    const callback = FIRST_BATCH_RUNS.get(roleId);
-    if (!callback)
-        throw new Error(t("No run binding for role: {roleId}", { roleId }));
-    return callback(input, context);
-}
-/** Binds the catalog's registered roles to child agent definitions. */
-export function createRoleRunner(options) {
-    const catalog = options.catalog;
-    function requireRole(roleId) {
-        const metadata = catalog.get(roleId);
-        if (!metadata)
-            throw new Error(t("Unknown role: {roleId}", { roleId }));
-        return metadata;
-    }
-    async function execute(roleId, input, context) {
-        requireRole(roleId);
-        if (options.run)
-            return options.run(roleId, input, context);
-        return runFirstBatchRole(roleId, input, context);
-    }
-    return {
-        catalog,
-        listRoleIds() {
-            return catalog.list().map((role) => role.roleId);
-        },
-        createDefinition(roleId) {
-            const metadata = requireRole(roleId);
-            return {
-                id: `role:${metadata.roleId}`,
-                version: DEFINITION_VERSION,
-                role: "child-agent-controller",
-                ...(options.owner === undefined ? {} : { owner: options.owner }),
-                run: (input, context) => execute(metadata.roleId, input, context),
-            };
-        },
-        checkCapabilities(roleId, availableCapabilities) {
-            const metadata = requireRole(roleId);
-            const registry = new Map(availableCapabilities.map((capability) => [capability.id, capability.version]));
-            const missing = [];
-            for (const dependency of metadata.capabilityDependencies) {
-                if (!dependency.required)
-                    continue;
-                const availableVersion = registry.get(dependency.capabilityId);
-                if (availableVersion === undefined) {
-                    missing.push({
-                        roleId,
-                        capabilityId: dependency.capabilityId,
-                        requestedVersion: dependency.capabilityVersion,
-                        reason: "missing",
-                    });
-                }
-                else if (availableVersion !== dependency.capabilityVersion) {
-                    missing.push({
-                        roleId,
-                        capabilityId: dependency.capabilityId,
-                        requestedVersion: dependency.capabilityVersion,
-                        availableVersion,
-                        reason: "version_mismatch",
-                    });
-                }
-            }
-            return {
-                roleId,
-                status: missing.length > 0 ? "missing" : "satisfied",
-                missing,
-            };
-        },
-        run(roleId, input, context) {
-            return execute(roleId, input, context);
-        },
-    };
-}
-//# sourceMappingURL=role-runner.js.map

package/dist/profile/role-runner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"role-runner.js","sourceRoot":"","sources":["../../src/profile/role-runner.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Role runner binding (2.2d) — maps registered `RoleMetadataV1` roles to child\n * `AgentDefinition`s executable through the experimental `AgentCompositionAPI`.\n *\n * The default run implementation is the deterministic first-batch role\n * callbacks (architecture-analyst / implementer / test-designer, 2.2c); a\n * caller may inject a real implementation via `run`. This slice never calls a\n * model.\n *\n * Library-level use works without any guard. When used through the\n * capability-runtime guards (`src/core/extensions/capability-runtime-guards.ts`),\n * the produced definitions must be defined/created by a manifest that declares\n * the `child-agent-controller` role and the `owner` must equal that manifest\n * id — the guards enforce this at the plugin boundary; this contract does not\n * duplicate guard logic.\n *\n * Required capability dependencies are checked explicitly (2.5a structured\n * `missing` shape) before activation (create/lease); they are never silently\n * skipped. Domain role runtimes live INSIDE the composition's child role: the\n * root/child two-value role enum is unchanged by design.\n */\nimport type { AgentDefinition, AgentExecutionContext } from \"../core/extensions/public-api.ts\";\nimport { t } from \"../core/i18n/index.ts\";\nimport type { AvailableCapabilityV1 } from \"./dependency-wiring.ts\";\nimport { FIRST_BATCH_ROLES } from \"./first-roles.ts\";\nimport type { RoleCatalogV1, RoleMetadataV1 } from \"./role-catalog.ts\";\n\n/** Deterministic role input: a single spec string (first-batch contract). */\nexport interface RoleRunnerInputV1 {\n\treadonly spec: string;\n}\n\n/** Deterministic role output: a single result string (first-batch contract). */\nexport interface RoleRunnerResultV1 {\n\treadonly result: string;\n}\n\n/**\n * Per-role run implementation. `context` is present when executed through\n * `AgentCompositionAPI`; direct deterministic execution may omit it.\n */\nexport type RoleRunCallbackV1 = (\n\tinput: RoleRunnerInputV1,\n\tcontext?: AgentExecutionContext,\n) => RoleRunnerResultV1 | Promise<RoleRunnerResultV1>;\n\n/** Runner-level run resolver; receives the roleId in addition to the callback arguments. */\nexport type RoleRunResolverV1 = (\n\troleId: string,\n\tinput: RoleRunnerInputV1,\n\tcontext?: AgentExecutionContext,\n) => RoleRunnerResultV1 | Promise<RoleRunnerResultV1>;\n\n/**\n * Role capability-dependency diagnostic: the 2.5a structured `missing` shape\n * (`capabilityId`/`requestedVersion`/`availableVersion?`/`reason`) with\n * `roleId` as the requester.\n */\nexport interface RoleMissingCapabilityV1 {\n\treadonly roleId: string;\n\treadonly capabilityId: string;\n\treadonly requestedVersion: number;\n\t/** Undefined when the capability is entirely absent from the registry. */\n\treadonly availableVersion?: number;\n\treadonly reason: \"missing\" | \"version_mismatch\";\n}\n\n/** Activation check result for one role's REQUIRED capability dependencies. */\nexport interface RoleCapabilityCheckV1 {\n\treadonly roleId: string;\n\treadonly status: \"satisfied\" | \"missing\";\n\t/** Required dependencies that are absent or version-mismatched; empty when satisfied. */\n\treadonly missing: readonly RoleMissingCapabilityV1[];\n}\n\nexport interface RoleRunnerOptionsV1 {\n\treadonly catalog: RoleCatalogV1;\n\t/**\n\t * Owner stamped onto produced child definitions. Required to equal the\n\t * declaring plugin manifest id when used behind the capability-runtime\n\t * guards; plain library use may omit it.\n\t */\n\treadonly owner?: string;\n\t/**\n\t * Injected run implementation replacing the deterministic first-batch\n\t * defaults entirely. Roles without any binding still fail explicitly on\n\t * execution.\n\t */\n\treadonly run?: RoleRunResolverV1;\n}\n\nexport interface RoleRunnerV1 {\n\treadonly catalog: RoleCatalogV1;\n\t/** Sorted registered roleIds. */\n\tlistRoleIds(): readonly string[];\n\t/**\n\t * Maps a registered role to a child agent definition (composition role\n\t * `child-agent-controller`, id `role:<roleId>`, version 1). Run the\n\t * capability check before creating/leasing an instance.\n\t */\n\tcreateDefinition(roleId: string): AgentDefinition<RoleRunnerInputV1, RoleRunnerResultV1>;\n\t/**\n\t * Pre-activation capability-dependency check against an exact-version\n\t * registry: a required dependency is satisfied only when the registry\n\t * offers the same capability id at exactly the requested version. Optional\n\t * dependencies never block activation and are not reported as missing.\n\t */\n\tcheckCapabilities(roleId: string, availableCapabilities: readonly AvailableCapabilityV1[]): RoleCapabilityCheckV1;\n\t/** Direct deterministic execution (the same run a produced definition binds). */\n\trun(roleId: string, input: RoleRunnerInputV1, context?: AgentExecutionContext): Promise<RoleRunnerResultV1>;\n}\n\nconst DEFINITION_VERSION = 1;\n\nconst FIRST_BATCH_RUNS = new Map<string, RoleRunCallbackV1>(\n\tFIRST_BATCH_ROLES.map((role) => [role.metadata.roleId, role.run]),\n);\n\n/** Default deterministic run dispatch: first-batch callbacks; explicit failure otherwise. */\nexport function runFirstBatchRole(\n\troleId: string,\n\tinput: RoleRunnerInputV1,\n\tcontext?: AgentExecutionContext,\n): RoleRunnerResultV1 | Promise<RoleRunnerResultV1> {\n\tconst callback = FIRST_BATCH_RUNS.get(roleId);\n\tif (!callback) throw new Error(t(\"No run binding for role: {roleId}\", { roleId }));\n\treturn callback(input, context);\n}\n\n/** Binds the catalog's registered roles to child agent definitions. */\nexport function createRoleRunner(options: RoleRunnerOptionsV1): RoleRunnerV1 {\n\tconst catalog = options.catalog;\n\n\tfunction requireRole(roleId: string): RoleMetadataV1 {\n\t\tconst metadata = catalog.get(roleId);\n\t\tif (!metadata) throw new Error(t(\"Unknown role: {roleId}\", { roleId }));\n\t\treturn metadata;\n\t}\n\n\tasync function execute(\n\t\troleId: string,\n\t\tinput: RoleRunnerInputV1,\n\t\tcontext?: AgentExecutionContext,\n\t): Promise<RoleRunnerResultV1> {\n\t\trequireRole(roleId);\n\t\tif (options.run) return options.run(roleId, input, context);\n\t\treturn runFirstBatchRole(roleId, input, context);\n\t}\n\n\treturn {\n\t\tcatalog,\n\t\tlistRoleIds() {\n\t\t\treturn catalog.list().map((role) => role.roleId);\n\t\t},\n\t\tcreateDefinition(roleId) {\n\t\t\tconst metadata = requireRole(roleId);\n\t\t\treturn {\n\t\t\t\tid: `role:${metadata.roleId}`,\n\t\t\t\tversion: DEFINITION_VERSION,\n\t\t\t\trole: \"child-agent-controller\",\n\t\t\t\t...(options.owner === undefined ? {} : { owner: options.owner }),\n\t\t\t\trun: (input, context) => execute(metadata.roleId, input, context),\n\t\t\t};\n\t\t},\n\t\tcheckCapabilities(roleId, availableCapabilities) {\n\t\t\tconst metadata = requireRole(roleId);\n\t\t\tconst registry = new Map(availableCapabilities.map((capability) => [capability.id, capability.version]));\n\t\t\tconst missing: RoleMissingCapabilityV1[] = [];\n\t\t\tfor (const dependency of metadata.capabilityDependencies) {\n\t\t\t\tif (!dependency.required) continue;\n\t\t\t\tconst availableVersion = registry.get(dependency.capabilityId);\n\t\t\t\tif (availableVersion === undefined) {\n\t\t\t\t\tmissing.push({\n\t\t\t\t\t\troleId,\n\t\t\t\t\t\tcapabilityId: dependency.capabilityId,\n\t\t\t\t\t\trequestedVersion: dependency.capabilityVersion,\n\t\t\t\t\t\treason: \"missing\",\n\t\t\t\t\t});\n\t\t\t\t} else if (availableVersion !== dependency.capabilityVersion) {\n\t\t\t\t\tmissing.push({\n\t\t\t\t\t\troleId,\n\t\t\t\t\t\tcapabilityId: dependency.capabilityId,\n\t\t\t\t\t\trequestedVersion: dependency.capabilityVersion,\n\t\t\t\t\t\tavailableVersion,\n\t\t\t\t\t\treason: \"version_mismatch\",\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn {\n\t\t\t\troleId,\n\t\t\t\tstatus: missing.length > 0 ? \"missing\" : \"satisfied\",\n\t\t\t\tmissing,\n\t\t\t};\n\t\t},\n\t\trun(roleId, input, context) {\n\t\t\treturn execute(roleId, input, context);\n\t\t},\n\t};\n}\n"]}

package/dist/profile/root-facade.d.ts

@@ -1,36 +0,0 @@
-/**
- * Root-agent-controller facade adapter (2.1a).
- *
- * Proves the default root can be created and run through the public facade:
- * the adapter defines (or reuses) a `root-agent-controller` definition on the
- * composition and runs each turn on a fresh instance with the controller
- * lease acquired and released through the public API — no private main-loop
- * access. The TUI keeps its transitional path until 2.1c.
- */
-import type { AgentCompositionAPI } from "../core/extensions/public-api.ts";
-export interface RootAgentFacadeTurnResultV1<TResult> {
-    readonly status: "succeeded" | "failed" | "cancelled" | "disposed";
-    readonly output?: TResult;
-    readonly revision: number;
-    readonly error?: Error;
-    readonly instanceId: string;
-    readonly leaseId: string;
-}
-export interface RootAgentFacadeV1<TInput = unknown, TResult = unknown> {
-    readonly definitionId: string;
-    /** Runs one minimal turn: create instance → acquire controller lease → run → release. */
-    runTurn(input: TInput, options?: {
-        readonly signal?: AbortSignal;
-    }): Promise<RootAgentFacadeTurnResultV1<TResult>>;
-}
-export declare function createRootAgentFacade<TInput, TResult = unknown>(options: {
-    readonly composition: AgentCompositionAPI;
-    readonly rootDefinitionId?: string;
-    readonly rootVersion?: number;
-    readonly owner?: string;
-    /** The root turn implementation (deterministic in tests). */
-    readonly run: (input: TInput, context: {
-        readonly signal?: AbortSignal;
-    }) => Promise<TResult> | TResult;
-}): RootAgentFacadeV1<TInput, TResult>;
-//# sourceMappingURL=root-facade.d.ts.map

package/dist/profile/root-facade.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"root-facade.d.ts","sourceRoot":"","sources":["../../src/profile/root-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,MAAM,WAAW,2BAA2B,CAAC,OAAO;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACrE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+FAAyF;IACzF,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC;CACnH;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE;IACzE,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACxG,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CA4CrC","sourcesContent":["/**\n * Root-agent-controller facade adapter (2.1a).\n *\n * Proves the default root can be created and run through the public facade:\n * the adapter defines (or reuses) a `root-agent-controller` definition on the\n * composition and runs each turn on a fresh instance with the controller\n * lease acquired and released through the public API — no private main-loop\n * access. The TUI keeps its transitional path until 2.1c.\n */\nimport type { AgentCompositionAPI } from \"../core/extensions/public-api.ts\";\nimport { t } from \"../core/i18n/index.ts\";\n\nexport interface RootAgentFacadeTurnResultV1<TResult> {\n\treadonly status: \"succeeded\" | \"failed\" | \"cancelled\" | \"disposed\";\n\treadonly output?: TResult;\n\treadonly revision: number;\n\treadonly error?: Error;\n\treadonly instanceId: string;\n\treadonly leaseId: string;\n}\n\nexport interface RootAgentFacadeV1<TInput = unknown, TResult = unknown> {\n\treadonly definitionId: string;\n\t/** Runs one minimal turn: create instance → acquire controller lease → run → release. */\n\trunTurn(input: TInput, options?: { readonly signal?: AbortSignal }): Promise<RootAgentFacadeTurnResultV1<TResult>>;\n}\n\nexport function createRootAgentFacade<TInput, TResult = unknown>(options: {\n\treadonly composition: AgentCompositionAPI;\n\treadonly rootDefinitionId?: string;\n\treadonly rootVersion?: number;\n\treadonly owner?: string;\n\t/** The root turn implementation (deterministic in tests). */\n\treadonly run: (input: TInput, context: { readonly signal?: AbortSignal }) => Promise<TResult> | TResult;\n}): RootAgentFacadeV1<TInput, TResult> {\n\tconst definitionId = options.rootDefinitionId ?? \"root-agent-controller\";\n\tconst owner = options.owner ?? \"root-facade\";\n\tconst definition = options.composition.define({\n\t\tid: definitionId,\n\t\tversion: options.rootVersion ?? 1,\n\t\trole: \"root-agent-controller\",\n\t\trun: (input: TInput, context: { readonly signal?: AbortSignal }) => options.run(input, context),\n\t});\n\tlet turnInFlight = false;\n\n\treturn {\n\t\tdefinitionId,\n\t\tasync runTurn(input, runOptions) {\n\t\t\t// Single-controller rule: one turn at a time per root facade.\n\t\t\tif (turnInFlight) {\n\t\t\t\tthrow new Error(t(\"Root facade is already running a turn\"));\n\t\t\t}\n\t\t\tturnInFlight = true;\n\t\t\ttry {\n\t\t\t\t// A composition instance is single-run; every turn gets a fresh one.\n\t\t\t\tconst instance = options.composition.create<TInput, TResult>(definition);\n\t\t\t\tconst lease = await instance.acquireControllerLease(owner);\n\t\t\t\tconst leaseId = lease.id;\n\t\t\t\ttry {\n\t\t\t\t\tconst operation = instance.run(input, { lease, signal: runOptions?.signal });\n\t\t\t\t\tawait operation.result;\n\t\t\t\t\tconst instanceResult = await instance.wait();\n\t\t\t\t\treturn {\n\t\t\t\t\t\tstatus: instanceResult.status,\n\t\t\t\t\t\t...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),\n\t\t\t\t\t\t...(instanceResult.error instanceof Error ? { error: instanceResult.error } : {}),\n\t\t\t\t\t\trevision: instanceResult.revision,\n\t\t\t\t\t\tinstanceId: instance.id,\n\t\t\t\t\t\tleaseId,\n\t\t\t\t\t};\n\t\t\t\t} finally {\n\t\t\t\t\tif (lease.isActive()) await lease.release();\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\tturnInFlight = false;\n\t\t\t}\n\t\t},\n\t};\n}\n"]}

package/dist/profile/root-facade.js

@@ -1,49 +0,0 @@
-import { t } from "../core/i18n/index.js";
-export function createRootAgentFacade(options) {
-    const definitionId = options.rootDefinitionId ?? "root-agent-controller";
-    const owner = options.owner ?? "root-facade";
-    const definition = options.composition.define({
-        id: definitionId,
-        version: options.rootVersion ?? 1,
-        role: "root-agent-controller",
-        run: (input, context) => options.run(input, context),
-    });
-    let turnInFlight = false;
-    return {
-        definitionId,
-        async runTurn(input, runOptions) {
-            // Single-controller rule: one turn at a time per root facade.
-            if (turnInFlight) {
-                throw new Error(t("Root facade is already running a turn"));
-            }
-            turnInFlight = true;
-            try {
-                // A composition instance is single-run; every turn gets a fresh one.
-                const instance = options.composition.create(definition);
-                const lease = await instance.acquireControllerLease(owner);
-                const leaseId = lease.id;
-                try {
-                    const operation = instance.run(input, { lease, signal: runOptions?.signal });
-                    await operation.result;
-                    const instanceResult = await instance.wait();
-                    return {
-                        status: instanceResult.status,
-                        ...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),
-                        ...(instanceResult.error instanceof Error ? { error: instanceResult.error } : {}),
-                        revision: instanceResult.revision,
-                        instanceId: instance.id,
-                        leaseId,
-                    };
-                }
-                finally {
-                    if (lease.isActive())
-                        await lease.release();
-                }
-            }
-            finally {
-                turnInFlight = false;
-            }
-        },
-    };
-}
-//# sourceMappingURL=root-facade.js.map

package/dist/profile/root-facade.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"root-facade.js","sourceRoot":"","sources":["../../src/profile/root-facade.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAC;AAiB1C,MAAM,UAAU,qBAAqB,CAA4B,OAOhE,EAAsC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;IACzE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;QAC7C,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC;QACjC,IAAI,EAAE,uBAAuB;QAC7B,GAAG,EAAE,CAAC,KAAa,EAAE,OAA0C,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC;KAC/F,CAAC,CAAC;IACH,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,OAAO;QACN,YAAY;QACZ,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE;YAChC,8DAA8D;YAC9D,IAAI,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,YAAY,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC;gBACJ,qEAAqE;gBACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAkB,UAAU,CAAC,CAAC;gBACzE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;gBAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACJ,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC7E,MAAM,SAAS,CAAC,MAAM,CAAC;oBACvB,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAC7C,OAAO;wBACN,MAAM,EAAE,cAAc,CAAC,MAAM;wBAC7B,GAAG,CAAC,cAAc,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjF,GAAG,CAAC,cAAc,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjF,QAAQ,EAAE,cAAc,CAAC,QAAQ;wBACjC,UAAU,EAAE,QAAQ,CAAC,EAAE;wBACvB,OAAO;qBACP,CAAC;gBACH,CAAC;wBAAS,CAAC;oBACV,IAAI,KAAK,CAAC,QAAQ,EAAE;wBAAE,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC7C,CAAC;YACF,CAAC;oBAAS,CAAC;gBACV,YAAY,GAAG,KAAK,CAAC;YACtB,CAAC;QAAA,CACD;KACD,CAAC;AAAA,CACF","sourcesContent":["/**\n * Root-agent-controller facade adapter (2.1a).\n *\n * Proves the default root can be created and run through the public facade:\n * the adapter defines (or reuses) a `root-agent-controller` definition on the\n * composition and runs each turn on a fresh instance with the controller\n * lease acquired and released through the public API — no private main-loop\n * access. The TUI keeps its transitional path until 2.1c.\n */\nimport type { AgentCompositionAPI } from \"../core/extensions/public-api.ts\";\nimport { t } from \"../core/i18n/index.ts\";\n\nexport interface RootAgentFacadeTurnResultV1<TResult> {\n\treadonly status: \"succeeded\" | \"failed\" | \"cancelled\" | \"disposed\";\n\treadonly output?: TResult;\n\treadonly revision: number;\n\treadonly error?: Error;\n\treadonly instanceId: string;\n\treadonly leaseId: string;\n}\n\nexport interface RootAgentFacadeV1<TInput = unknown, TResult = unknown> {\n\treadonly definitionId: string;\n\t/** Runs one minimal turn: create instance → acquire controller lease → run → release. */\n\trunTurn(input: TInput, options?: { readonly signal?: AbortSignal }): Promise<RootAgentFacadeTurnResultV1<TResult>>;\n}\n\nexport function createRootAgentFacade<TInput, TResult = unknown>(options: {\n\treadonly composition: AgentCompositionAPI;\n\treadonly rootDefinitionId?: string;\n\treadonly rootVersion?: number;\n\treadonly owner?: string;\n\t/** The root turn implementation (deterministic in tests). */\n\treadonly run: (input: TInput, context: { readonly signal?: AbortSignal }) => Promise<TResult> | TResult;\n}): RootAgentFacadeV1<TInput, TResult> {\n\tconst definitionId = options.rootDefinitionId ?? \"root-agent-controller\";\n\tconst owner = options.owner ?? \"root-facade\";\n\tconst definition = options.composition.define({\n\t\tid: definitionId,\n\t\tversion: options.rootVersion ?? 1,\n\t\trole: \"root-agent-controller\",\n\t\trun: (input: TInput, context: { readonly signal?: AbortSignal }) => options.run(input, context),\n\t});\n\tlet turnInFlight = false;\n\n\treturn {\n\t\tdefinitionId,\n\t\tasync runTurn(input, runOptions) {\n\t\t\t// Single-controller rule: one turn at a time per root facade.\n\t\t\tif (turnInFlight) {\n\t\t\t\tthrow new Error(t(\"Root facade is already running a turn\"));\n\t\t\t}\n\t\t\tturnInFlight = true;\n\t\t\ttry {\n\t\t\t\t// A composition instance is single-run; every turn gets a fresh one.\n\t\t\t\tconst instance = options.composition.create<TInput, TResult>(definition);\n\t\t\t\tconst lease = await instance.acquireControllerLease(owner);\n\t\t\t\tconst leaseId = lease.id;\n\t\t\t\ttry {\n\t\t\t\t\tconst operation = instance.run(input, { lease, signal: runOptions?.signal });\n\t\t\t\t\tawait operation.result;\n\t\t\t\t\tconst instanceResult = await instance.wait();\n\t\t\t\t\treturn {\n\t\t\t\t\t\tstatus: instanceResult.status,\n\t\t\t\t\t\t...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),\n\t\t\t\t\t\t...(instanceResult.error instanceof Error ? { error: instanceResult.error } : {}),\n\t\t\t\t\t\trevision: instanceResult.revision,\n\t\t\t\t\t\tinstanceId: instance.id,\n\t\t\t\t\t\tleaseId,\n\t\t\t\t\t};\n\t\t\t\t} finally {\n\t\t\t\t\tif (lease.isActive()) await lease.release();\n\t\t\t\t}\n\t\t\t} finally {\n\t\t\t\tturnInFlight = false;\n\t\t\t}\n\t\t},\n\t};\n}\n"]}

package/dist/profile/skill-discovery-wiring.d.ts

@@ -1,58 +0,0 @@
-/**
- * Skill/MCP discovery wiring (4.4) — turns discovered Skill and MCP tool
- * capabilities into profile-assembly inputs, with all four failure modes
- * explicit BEFORE a session exists: missing dependencies, version conflicts
- * between sources, disabled items, and replacements.
- *
- * Each registered item (a Skill or an MCP server) contributes capability
- * declarations; MCP tools derive capability ids `mcp:<serverId>:<toolName>`.
- * Two enabled items declaring the SAME capability id with DIFFERENT
- * versions is a structured version conflict; identical versions dedupe.
- * Disabled items contribute nothing (replacement = disable + register).
- * Resolution reuses the 2.5a exact-version wiring — no kernel special
- * cases. Implementation lives entirely in profile/assembly land.
- */
-import type { ProfileDependencyWiringV1 } from "./dependency-wiring.ts";
-export type DiscoverySourceKindV1 = "skill" | "mcp";
-export interface DiscoveredItemV1 {
-    readonly sourceKind: DiscoverySourceKindV1;
-    readonly itemId: string;
-    readonly version: string;
-    readonly capabilities: readonly {
-        readonly id: string;
-        readonly version: number;
-    }[];
-    readonly enabled: boolean;
-}
-export interface DiscoveryVersionConflictV1 {
-    readonly capabilityId: string;
-    readonly declarations: readonly {
-        readonly sourceKind: DiscoverySourceKindV1;
-        readonly itemId: string;
-        readonly version: number;
-    }[];
-}
-export interface DiscoveryWiringV1 {
-    register(item: DiscoveredItemV1): void;
-    deriveMcpItem(input: {
-        readonly serverId: string;
-        readonly version: string;
-        readonly tools: readonly {
-            readonly name: string;
-            readonly description?: string;
-        }[];
-        readonly enabled?: boolean;
-    }): DiscoveredItemV1;
-    wireDiscoveredDependencies(input: {
-        readonly availableCapabilities: readonly {
-            readonly id: string;
-            readonly version: number;
-        }[];
-        readonly disabledItemIds?: readonly string[];
-    }): {
-        readonly conflicts: readonly DiscoveryVersionConflictV1[];
-        readonly wiring: ProfileDependencyWiringV1;
-    };
-}
-export declare function createSkillDiscoveryWiring(): DiscoveryWiringV1;
-//# sourceMappingURL=skill-discovery-wiring.d.ts.map

package/dist/profile/skill-discovery-wiring.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skill-discovery-wiring.d.ts","sourceRoot":"","sources":["../../src/profile/skill-discovery-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAIxE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,KAAK,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,SAAS;QAC/B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;QAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;CACJ;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,SAAS;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACpF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,gBAAgB,CAAC;IACrB,0BAA0B,CAAC,KAAK,EAAE;QACjC,QAAQ,CAAC,qBAAqB,EAAE,SAAS;YAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC7F,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KAC7C,GAAG;QAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,0BAA0B,EAAE,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAA;KAAE,CAAC;CAC9G;AAED,wBAAgB,0BAA0B,IAAI,iBAAiB,CAoE9D","sourcesContent":["/**\n * Skill/MCP discovery wiring (4.4) — turns discovered Skill and MCP tool\n * capabilities into profile-assembly inputs, with all four failure modes\n * explicit BEFORE a session exists: missing dependencies, version conflicts\n * between sources, disabled items, and replacements.\n *\n * Each registered item (a Skill or an MCP server) contributes capability\n * declarations; MCP tools derive capability ids `mcp:<serverId>:<toolName>`.\n * Two enabled items declaring the SAME capability id with DIFFERENT\n * versions is a structured version conflict; identical versions dedupe.\n * Disabled items contribute nothing (replacement = disable + register).\n * Resolution reuses the 2.5a exact-version wiring — no kernel special\n * cases. Implementation lives entirely in profile/assembly land.\n */\n\nimport { t } from \"../core/i18n/index.ts\";\nimport type { ProfileDependencyWiringV1 } from \"./dependency-wiring.ts\";\nimport { wireProfileDependencies } from \"./dependency-wiring.ts\";\nimport type { ResolvedPluginManifestV1 } from \"./identity.ts\";\n\nexport type DiscoverySourceKindV1 = \"skill\" | \"mcp\";\n\nexport interface DiscoveredItemV1 {\n\treadonly sourceKind: DiscoverySourceKindV1;\n\treadonly itemId: string;\n\treadonly version: string;\n\treadonly capabilities: readonly { readonly id: string; readonly version: number }[];\n\treadonly enabled: boolean;\n}\n\nexport interface DiscoveryVersionConflictV1 {\n\treadonly capabilityId: string;\n\treadonly declarations: readonly {\n\t\treadonly sourceKind: DiscoverySourceKindV1;\n\t\treadonly itemId: string;\n\t\treadonly version: number;\n\t}[];\n}\n\nexport interface DiscoveryWiringV1 {\n\tregister(item: DiscoveredItemV1): void;\n\tderiveMcpItem(input: {\n\t\treadonly serverId: string;\n\t\treadonly version: string;\n\t\treadonly tools: readonly { readonly name: string; readonly description?: string }[];\n\t\treadonly enabled?: boolean;\n\t}): DiscoveredItemV1;\n\twireDiscoveredDependencies(input: {\n\t\treadonly availableCapabilities: readonly { readonly id: string; readonly version: number }[];\n\t\treadonly disabledItemIds?: readonly string[];\n\t}): { readonly conflicts: readonly DiscoveryVersionConflictV1[]; readonly wiring: ProfileDependencyWiringV1 };\n}\n\nexport function createSkillDiscoveryWiring(): DiscoveryWiringV1 {\n\tconst items = new Map<string, DiscoveredItemV1>();\n\tconst keyOf = (item: DiscoveredItemV1): string => `${item.sourceKind}:${item.itemId}`;\n\n\treturn {\n\t\tregister(item) {\n\t\t\tif (item.itemId.trim().length === 0) throw new Error(t(\"Discovered item id must be a non-empty string\"));\n\t\t\tconst existing = items.get(keyOf(item));\n\t\t\tif (existing && existing.version !== item.version) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tt(\"Item {key} re-registered with a different version ({from} -> {to})\", {\n\t\t\t\t\t\tkey: keyOf(item),\n\t\t\t\t\t\tfrom: existing.version,\n\t\t\t\t\t\tto: item.version,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\titems.set(keyOf(item), { ...item, capabilities: [...item.capabilities] });\n\t\t},\n\t\tderiveMcpItem({ serverId, version, tools, enabled = true }) {\n\t\t\treturn {\n\t\t\t\tsourceKind: \"mcp\",\n\t\t\t\titemId: serverId,\n\t\t\t\tversion,\n\t\t\t\tcapabilities: tools.map((tool) => ({ id: `mcp:${serverId}:${tool.name}`, version: 1 })),\n\t\t\t\tenabled,\n\t\t\t};\n\t\t},\n\t\twireDiscoveredDependencies({ availableCapabilities, disabledItemIds }) {\n\t\t\tconst disabled = new Set(disabledItemIds ?? []);\n\t\t\tconst enabledItems = [...items.values()].filter((item) => item.enabled && !disabled.has(keyOf(item)));\n\n\t\t\t// Version conflicts: same capability id, different declared versions,\n\t\t\t// across different enabled items.\n\t\t\tconst byCapability = new Map<\n\t\t\t\tstring,\n\t\t\t\tArray<{ sourceKind: DiscoverySourceKindV1; itemId: string; version: number }>\n\t\t\t>();\n\t\t\tfor (const item of enabledItems) {\n\t\t\t\tfor (const capability of item.capabilities) {\n\t\t\t\t\tconst list = byCapability.get(capability.id) ?? [];\n\t\t\t\t\tif (!list.some((entry) => entry.itemId === item.itemId)) {\n\t\t\t\t\t\tlist.push({ sourceKind: item.sourceKind, itemId: item.itemId, version: capability.version });\n\t\t\t\t\t}\n\t\t\t\t\tbyCapability.set(capability.id, list);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst conflicts: DiscoveryVersionConflictV1[] = [];\n\t\t\tfor (const [capabilityId, declarations] of byCapability) {\n\t\t\t\tconst versions = new Set(declarations.map((entry) => entry.version));\n\t\t\t\tif (versions.size > 1) conflicts.push({ capabilityId, declarations });\n\t\t\t}\n\n\t\t\t// Disabled items stay in the manifests so the wiring result shows an\n\t\t\t// explicit skipped_disabled entry (visible audit, not silent removal).\n\t\t\tconst manifests: ResolvedPluginManifestV1[] = [...items.values()].map((item) => ({\n\t\t\t\tpluginId: keyOf(item),\n\t\t\t\tpluginVersion: item.version,\n\t\t\t\tcapabilityRefs: [...item.capabilities],\n\t\t\t}));\n\t\t\tconst wiring = wireProfileDependencies({\n\t\t\t\tresolvedPlugins: manifests,\n\t\t\t\tavailableCapabilities,\n\t\t\t\tdisabledPluginIds: disabledItemIds,\n\t\t\t});\n\t\t\treturn { conflicts: Object.freeze(conflicts), wiring };\n\t\t},\n\t};\n}\n"]}

package/dist/profile/skill-discovery-wiring.js

@@ -1,80 +0,0 @@
-/**
- * Skill/MCP discovery wiring (4.4) — turns discovered Skill and MCP tool
- * capabilities into profile-assembly inputs, with all four failure modes
- * explicit BEFORE a session exists: missing dependencies, version conflicts
- * between sources, disabled items, and replacements.
- *
- * Each registered item (a Skill or an MCP server) contributes capability
- * declarations; MCP tools derive capability ids `mcp:<serverId>:<toolName>`.
- * Two enabled items declaring the SAME capability id with DIFFERENT
- * versions is a structured version conflict; identical versions dedupe.
- * Disabled items contribute nothing (replacement = disable + register).
- * Resolution reuses the 2.5a exact-version wiring — no kernel special
- * cases. Implementation lives entirely in profile/assembly land.
- */
-import { t } from "../core/i18n/index.js";
-import { wireProfileDependencies } from "./dependency-wiring.js";
-export function createSkillDiscoveryWiring() {
-    const items = new Map();
-    const keyOf = (item) => `${item.sourceKind}:${item.itemId}`;
-    return {
-        register(item) {
-            if (item.itemId.trim().length === 0)
-                throw new Error(t("Discovered item id must be a non-empty string"));
-            const existing = items.get(keyOf(item));
-            if (existing && existing.version !== item.version) {
-                throw new Error(t("Item {key} re-registered with a different version ({from} -> {to})", {
-                    key: keyOf(item),
-                    from: existing.version,
-                    to: item.version,
-                }));
-            }
-            items.set(keyOf(item), { ...item, capabilities: [...item.capabilities] });
-        },
-        deriveMcpItem({ serverId, version, tools, enabled = true }) {
-            return {
-                sourceKind: "mcp",
-                itemId: serverId,
-                version,
-                capabilities: tools.map((tool) => ({ id: `mcp:${serverId}:${tool.name}`, version: 1 })),
-                enabled,
-            };
-        },
-        wireDiscoveredDependencies({ availableCapabilities, disabledItemIds }) {
-            const disabled = new Set(disabledItemIds ?? []);
-            const enabledItems = [...items.values()].filter((item) => item.enabled && !disabled.has(keyOf(item)));
-            // Version conflicts: same capability id, different declared versions,
-            // across different enabled items.
-            const byCapability = new Map();
-            for (const item of enabledItems) {
-                for (const capability of item.capabilities) {
-                    const list = byCapability.get(capability.id) ?? [];
-                    if (!list.some((entry) => entry.itemId === item.itemId)) {
-                        list.push({ sourceKind: item.sourceKind, itemId: item.itemId, version: capability.version });
-                    }
-                    byCapability.set(capability.id, list);
-                }
-            }
-            const conflicts = [];
-            for (const [capabilityId, declarations] of byCapability) {
-                const versions = new Set(declarations.map((entry) => entry.version));
-                if (versions.size > 1)
-                    conflicts.push({ capabilityId, declarations });
-            }
-            // Disabled items stay in the manifests so the wiring result shows an
-            // explicit skipped_disabled entry (visible audit, not silent removal).
-            const manifests = [...items.values()].map((item) => ({
-                pluginId: keyOf(item),
-                pluginVersion: item.version,
-                capabilityRefs: [...item.capabilities],
-            }));
-            const wiring = wireProfileDependencies({
-                resolvedPlugins: manifests,
-                availableCapabilities,
-                disabledPluginIds: disabledItemIds,
-            });
-            return { conflicts: Object.freeze(conflicts), wiring };
-        },
-    };
-}
-//# sourceMappingURL=skill-discovery-wiring.js.map

package/dist/profile/skill-discovery-wiring.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"skill-discovery-wiring.js","sourceRoot":"","sources":["../../src/profile/skill-discovery-wiring.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Skill/MCP discovery wiring (4.4) — turns discovered Skill and MCP tool\n * capabilities into profile-assembly inputs, with all four failure modes\n * explicit BEFORE a session exists: missing dependencies, version conflicts\n * between sources, disabled items, and replacements.\n *\n * Each registered item (a Skill or an MCP server) contributes capability\n * declarations; MCP tools derive capability ids `mcp:<serverId>:<toolName>`.\n * Two enabled items declaring the SAME capability id with DIFFERENT\n * versions is a structured version conflict; identical versions dedupe.\n * Disabled items contribute nothing (replacement = disable + register).\n * Resolution reuses the 2.5a exact-version wiring — no kernel special\n * cases. Implementation lives entirely in profile/assembly land.\n */\n\nimport { t } from \"../core/i18n/index.ts\";\nimport type { ProfileDependencyWiringV1 } from \"./dependency-wiring.ts\";\nimport { wireProfileDependencies } from \"./dependency-wiring.ts\";\nimport type { ResolvedPluginManifestV1 } from \"./identity.ts\";\n\nexport type DiscoverySourceKindV1 = \"skill\" | \"mcp\";\n\nexport interface DiscoveredItemV1 {\n\treadonly sourceKind: DiscoverySourceKindV1;\n\treadonly itemId: string;\n\treadonly version: string;\n\treadonly capabilities: readonly { readonly id: string; readonly version: number }[];\n\treadonly enabled: boolean;\n}\n\nexport interface DiscoveryVersionConflictV1 {\n\treadonly capabilityId: string;\n\treadonly declarations: readonly {\n\t\treadonly sourceKind: DiscoverySourceKindV1;\n\t\treadonly itemId: string;\n\t\treadonly version: number;\n\t}[];\n}\n\nexport interface DiscoveryWiringV1 {\n\tregister(item: DiscoveredItemV1): void;\n\tderiveMcpItem(input: {\n\t\treadonly serverId: string;\n\t\treadonly version: string;\n\t\treadonly tools: readonly { readonly name: string; readonly description?: string }[];\n\t\treadonly enabled?: boolean;\n\t}): DiscoveredItemV1;\n\twireDiscoveredDependencies(input: {\n\t\treadonly availableCapabilities: readonly { readonly id: string; readonly version: number }[];\n\t\treadonly disabledItemIds?: readonly string[];\n\t}): { readonly conflicts: readonly DiscoveryVersionConflictV1[]; readonly wiring: ProfileDependencyWiringV1 };\n}\n\nexport function createSkillDiscoveryWiring(): DiscoveryWiringV1 {\n\tconst items = new Map<string, DiscoveredItemV1>();\n\tconst keyOf = (item: DiscoveredItemV1): string => `${item.sourceKind}:${item.itemId}`;\n\n\treturn {\n\t\tregister(item) {\n\t\t\tif (item.itemId.trim().length === 0) throw new Error(t(\"Discovered item id must be a non-empty string\"));\n\t\t\tconst existing = items.get(keyOf(item));\n\t\t\tif (existing && existing.version !== item.version) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tt(\"Item {key} re-registered with a different version ({from} -> {to})\", {\n\t\t\t\t\t\tkey: keyOf(item),\n\t\t\t\t\t\tfrom: existing.version,\n\t\t\t\t\t\tto: item.version,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\titems.set(keyOf(item), { ...item, capabilities: [...item.capabilities] });\n\t\t},\n\t\tderiveMcpItem({ serverId, version, tools, enabled = true }) {\n\t\t\treturn {\n\t\t\t\tsourceKind: \"mcp\",\n\t\t\t\titemId: serverId,\n\t\t\t\tversion,\n\t\t\t\tcapabilities: tools.map((tool) => ({ id: `mcp:${serverId}:${tool.name}`, version: 1 })),\n\t\t\t\tenabled,\n\t\t\t};\n\t\t},\n\t\twireDiscoveredDependencies({ availableCapabilities, disabledItemIds }) {\n\t\t\tconst disabled = new Set(disabledItemIds ?? []);\n\t\t\tconst enabledItems = [...items.values()].filter((item) => item.enabled && !disabled.has(keyOf(item)));\n\n\t\t\t// Version conflicts: same capability id, different declared versions,\n\t\t\t// across different enabled items.\n\t\t\tconst byCapability = new Map<\n\t\t\t\tstring,\n\t\t\t\tArray<{ sourceKind: DiscoverySourceKindV1; itemId: string; version: number }>\n\t\t\t>();\n\t\t\tfor (const item of enabledItems) {\n\t\t\t\tfor (const capability of item.capabilities) {\n\t\t\t\t\tconst list = byCapability.get(capability.id) ?? [];\n\t\t\t\t\tif (!list.some((entry) => entry.itemId === item.itemId)) {\n\t\t\t\t\t\tlist.push({ sourceKind: item.sourceKind, itemId: item.itemId, version: capability.version });\n\t\t\t\t\t}\n\t\t\t\t\tbyCapability.set(capability.id, list);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst conflicts: DiscoveryVersionConflictV1[] = [];\n\t\t\tfor (const [capabilityId, declarations] of byCapability) {\n\t\t\t\tconst versions = new Set(declarations.map((entry) => entry.version));\n\t\t\t\tif (versions.size > 1) conflicts.push({ capabilityId, declarations });\n\t\t\t}\n\n\t\t\t// Disabled items stay in the manifests so the wiring result shows an\n\t\t\t// explicit skipped_disabled entry (visible audit, not silent removal).\n\t\t\tconst manifests: ResolvedPluginManifestV1[] = [...items.values()].map((item) => ({\n\t\t\t\tpluginId: keyOf(item),\n\t\t\t\tpluginVersion: item.version,\n\t\t\t\tcapabilityRefs: [...item.capabilities],\n\t\t\t}));\n\t\t\tconst wiring = wireProfileDependencies({\n\t\t\t\tresolvedPlugins: manifests,\n\t\t\t\tavailableCapabilities,\n\t\t\t\tdisabledPluginIds: disabledItemIds,\n\t\t\t});\n\t\t\treturn { conflicts: Object.freeze(conflicts), wiring };\n\t\t},\n\t};\n}\n"]}

package/dist/profile/state-store.d.ts

@@ -1,62 +0,0 @@
-/**
- * Generic transition/evidence/revision store (2.3a) — the domain-agnostic
- * contract base for Goal/Plan/Todo plugins.
- *
- * The store knows NOTHING about goal/plan/todo semantics. It only enforces:
- * - causality: a transition's `fromStatus` must equal the entity's current
- *   status (null = initial transition), otherwise an explicit conflict;
- * - idempotency: replaying the same (domain, entityId, operationId, toStatus)
- *   returns the existing record and never advances the revision;
- * - evidence: every transition carries structured evidence references;
- * - payload: transitions may carry an optional domain payload (e.g. a goal
- *   title) that is validated JSON and part of the replayable record;
- * - replay: the full history rebuilds the identical current state.
- */
-import type { JsonValue } from "@agent-forge/ai";
-export interface TransitionEvidenceRefV1 {
-    readonly kind: string;
-    readonly ref: string;
-    readonly digest?: string;
-}
-export interface TransitionRecordV1 {
-    readonly domain: string;
-    readonly entityId: string;
-    readonly owner: string;
-    readonly fromStatus: string | null;
-    readonly toStatus: string;
-    readonly operationId: string;
-    readonly evidence: readonly TransitionEvidenceRefV1[];
-    readonly payload?: JsonValue;
-    readonly revision: number;
-    readonly at: number;
-}
-export interface TransitionInputV1 {
-    readonly domain: string;
-    readonly entityId: string;
-    readonly owner: string;
-    readonly fromStatus: string | null;
-    readonly toStatus: string;
-    readonly operationId: string;
-    readonly evidence?: readonly TransitionEvidenceRefV1[];
-    readonly payload?: JsonValue;
-    readonly at?: number;
-}
-export interface TransitionResultV1 {
-    readonly record: TransitionRecordV1;
-    readonly deduped: boolean;
-}
-export interface TransitionStoreV1 {
-    transition(input: TransitionInputV1): TransitionResultV1;
-    currentStatus(domain: string, entityId: string): {
-        readonly status: string;
-        readonly revision: number;
-    } | undefined;
-    history(entityId: string): readonly TransitionRecordV1[];
-    /** Replays a history into a fresh store; the rebuilt state must be identical. */
-    replay(history: readonly TransitionRecordV1[]): void;
-    entities(): readonly string[];
-}
-export declare function createTransitionStore(options?: {
-    readonly now?: () => number;
-}): TransitionStoreV1;
-//# sourceMappingURL=state-store.d.ts.map

package/dist/profile/state-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/profile/state-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AA+DD,MAAM,WAAW,iBAAiB;IACjC,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAAC;IACzD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACpH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE,CAAC;IACzD,iFAAiF;IACjF,MAAM,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,CAAC;IACrD,QAAQ,IAAI,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAAG,iBAAiB,CAoFtG","sourcesContent":["/**\n * Generic transition/evidence/revision store (2.3a) — the domain-agnostic\n * contract base for Goal/Plan/Todo plugins.\n *\n * The store knows NOTHING about goal/plan/todo semantics. It only enforces:\n * - causality: a transition's `fromStatus` must equal the entity's current\n *   status (null = initial transition), otherwise an explicit conflict;\n * - idempotency: replaying the same (domain, entityId, operationId, toStatus)\n *   returns the existing record and never advances the revision;\n * - evidence: every transition carries structured evidence references;\n * - payload: transitions may carry an optional domain payload (e.g. a goal\n *   title) that is validated JSON and part of the replayable record;\n * - replay: the full history rebuilds the identical current state.\n */\nimport type { JsonValue } from \"@agent-forge/ai\";\nimport { t } from \"../core/i18n/index.ts\";\n\nexport interface TransitionEvidenceRefV1 {\n\treadonly kind: string;\n\treadonly ref: string;\n\treadonly digest?: string;\n}\n\nexport interface TransitionRecordV1 {\n\treadonly domain: string;\n\treadonly entityId: string;\n\treadonly owner: string;\n\treadonly fromStatus: string | null;\n\treadonly toStatus: string;\n\treadonly operationId: string;\n\treadonly evidence: readonly TransitionEvidenceRefV1[];\n\treadonly payload?: JsonValue;\n\treadonly revision: number;\n\treadonly at: number;\n}\n\nexport interface TransitionInputV1 {\n\treadonly domain: string;\n\treadonly entityId: string;\n\treadonly owner: string;\n\treadonly fromStatus: string | null;\n\treadonly toStatus: string;\n\treadonly operationId: string;\n\treadonly evidence?: readonly TransitionEvidenceRefV1[];\n\treadonly payload?: JsonValue;\n\treadonly at?: number;\n}\n\nexport interface TransitionResultV1 {\n\treadonly record: TransitionRecordV1;\n\treadonly deduped: boolean;\n}\n\nfunction assertNonEmptyString(value: unknown, label: string): asserts value is string {\n\tif (typeof value !== \"string\" || value.trim().length === 0)\n\t\tthrow new Error(t(\"{label} must be a non-empty string\", { label }));\n}\n\nfunction validateEvidence(value: unknown, label: string): TransitionEvidenceRefV1[] {\n\tif (value === undefined) return [];\n\tif (!Array.isArray(value)) throw new Error(t(\"{label} must be an array\", { label }));\n\treturn value.map((item, index) => {\n\t\tconst depLabel = `${label}[${index}]`;\n\t\tif (item === null || typeof item !== \"object\" || Array.isArray(item)) {\n\t\t\tthrow new Error(t(\"{label} must be a plain object\", { label: depLabel }));\n\t\t}\n\t\tconst record = item as Record<string, unknown>;\n\t\tassertNonEmptyString(record.kind, `${depLabel}.kind`);\n\t\tassertNonEmptyString(record.ref, `${depLabel}.ref`);\n\t\tif (record.digest !== undefined) assertNonEmptyString(record.digest, `${depLabel}.digest`);\n\t\treturn Object.freeze({\n\t\t\tkind: record.kind,\n\t\t\tref: record.ref,\n\t\t\t...(record.digest === undefined ? {} : { digest: record.digest }),\n\t\t});\n\t});\n}\n\nfunction validatePayload(value: unknown, label: string): JsonValue | undefined {\n\tif (value === undefined) return undefined;\n\tconst seen = new Set<object>();\n\tconst check = (node: unknown): void => {\n\t\tif (node === null || typeof node === \"string\" || typeof node === \"boolean\") return;\n\t\tif (typeof node === \"number\") {\n\t\t\tif (!Number.isFinite(node))\n\t\t\t\tthrow new Error(\n\t\t\t\t\tt(\"{label} must be JSON-safe: {node} is not a finite number\", { label, node: String(node) }),\n\t\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tif (typeof node === \"object\") {\n\t\t\tif (seen.has(node)) throw new Error(t(\"{label} must be JSON-safe: circular reference\", { label }));\n\t\t\tseen.add(node);\n\t\t\tif (Array.isArray(node)) {\n\t\t\t\tfor (const item of node) check(item);\n\t\t\t} else {\n\t\t\t\tconst proto = Object.getPrototypeOf(node) as unknown;\n\t\t\t\tif (proto !== Object.prototype && proto !== null)\n\t\t\t\t\tthrow new Error(t(\"{label} must be a plain object\", { label }));\n\t\t\t\tfor (const entry of Object.entries(node)) {\n\t\t\t\t\tif (entry[1] === undefined)\n\t\t\t\t\t\tthrow new Error(t(\"{label} must be JSON-safe: {key} is undefined\", { label, key: entry[0] }));\n\t\t\t\t\tcheck(entry[1]);\n\t\t\t\t}\n\t\t\t}\n\t\t\tseen.delete(node);\n\t\t\treturn;\n\t\t}\n\t\tthrow new Error(t(\"{label} must be JSON-safe: unsupported value of type {type}\", { label, type: typeof node }));\n\t};\n\tcheck(value);\n\treturn JSON.parse(JSON.stringify(value)) as JsonValue;\n}\n\nexport interface TransitionStoreV1 {\n\ttransition(input: TransitionInputV1): TransitionResultV1;\n\tcurrentStatus(domain: string, entityId: string): { readonly status: string; readonly revision: number } | undefined;\n\thistory(entityId: string): readonly TransitionRecordV1[];\n\t/** Replays a history into a fresh store; the rebuilt state must be identical. */\n\treplay(history: readonly TransitionRecordV1[]): void;\n\tentities(): readonly string[];\n}\n\nexport function createTransitionStore(options: { readonly now?: () => number } = {}): TransitionStoreV1 {\n\tconst now = options.now ?? (() => Date.now());\n\tconst recordsByEntity = new Map<string, TransitionRecordV1[]>();\n\tconst idempotency = new Map<string, TransitionRecordV1>();\n\tconst currentStatus = new Map<string, { status: string; revision: number }>();\n\tconst revisions = new Map<string, number>();\n\n\tconst entityKey = (domain: string, entityId: string): string => `${domain}\\u0000${entityId}`;\n\n\treturn {\n\t\ttransition(input) {\n\t\t\tassertNonEmptyString(input.domain, \"Transition domain\");\n\t\t\tassertNonEmptyString(input.entityId, \"Transition entityId\");\n\t\t\tassertNonEmptyString(input.owner, \"Transition owner\");\n\t\t\tassertNonEmptyString(input.operationId, \"Transition operationId\");\n\t\t\tassertNonEmptyString(input.toStatus, \"Transition toStatus\");\n\t\t\tconst evidence = validateEvidence(input.evidence, \"Transition evidence\");\n\t\t\tconst payload = validatePayload(input.payload, \"Transition payload\");\n\t\t\tconst key = `${entityKey(input.domain, input.entityId)}\\u0000${input.operationId}\\u0000${input.toStatus}`;\n\n\t\t\tconst existing = idempotency.get(key);\n\t\t\tif (existing) return { record: existing, deduped: true };\n\n\t\t\tconst entityKeyId = entityKey(input.domain, input.entityId);\n\t\t\tconst current = currentStatus.get(entityKeyId);\n\t\t\tconst fromStatus = input.fromStatus;\n\t\t\tif ((current?.status ?? null) !== fromStatus) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tt(\"Transition conflict: expected fromStatus {from}, got {to}\", {\n\t\t\t\t\t\tfrom: JSON.stringify(current?.status ?? null),\n\t\t\t\t\t\tto: JSON.stringify(fromStatus),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst revision = (revisions.get(entityKeyId) ?? 0) + 1;\n\t\t\trevisions.set(entityKeyId, revision);\n\t\t\tconst record: TransitionRecordV1 = Object.freeze({\n\t\t\t\tdomain: input.domain,\n\t\t\t\tentityId: input.entityId,\n\t\t\t\towner: input.owner,\n\t\t\t\tfromStatus,\n\t\t\t\ttoStatus: input.toStatus,\n\t\t\t\toperationId: input.operationId,\n\t\t\t\tevidence: Object.freeze(evidence),\n\t\t\t\t...(payload === undefined ? {} : { payload }),\n\t\t\t\trevision,\n\t\t\t\tat: input.at ?? now(),\n\t\t\t});\n\t\t\tconst log = recordsByEntity.get(entityKeyId) ?? [];\n\t\t\tlog.push(record);\n\t\t\trecordsByEntity.set(entityKeyId, log);\n\t\t\tcurrentStatus.set(entityKeyId, { status: input.toStatus, revision });\n\t\t\tidempotency.set(key, record);\n\t\t\treturn { record, deduped: false };\n\t\t},\n\t\tcurrentStatus(domain: string, entityId: string) {\n\t\t\treturn currentStatus.get(entityKey(domain, entityId));\n\t\t},\n\t\thistory(entityId: string) {\n\t\t\treturn Object.freeze(\n\t\t\t\t[...recordsByEntity.entries()]\n\t\t\t\t\t.filter(([entityKeyId]) => entityKeyId.endsWith(`\\u0000${entityId}`))\n\t\t\t\t\t.flatMap(([, log]) => log),\n\t\t\t);\n\t\t},\n\t\treplay(history) {\n\t\t\tfor (const record of history) {\n\t\t\t\tthis.transition({\n\t\t\t\t\tdomain: record.domain,\n\t\t\t\t\tentityId: record.entityId,\n\t\t\t\t\towner: record.owner,\n\t\t\t\t\tfromStatus: record.fromStatus,\n\t\t\t\t\ttoStatus: record.toStatus,\n\t\t\t\t\toperationId: record.operationId,\n\t\t\t\t\tevidence: record.evidence,\n\t\t\t\t\tpayload: record.payload,\n\t\t\t\t\tat: record.at,\n\t\t\t\t});\n\t\t\t}\n\t\t},\n\t\tentities() {\n\t\t\treturn Object.freeze([...new Set([...currentStatus.keys()].map((key) => key.split(\"\\u0000\")[1]!))]);\n\t\t},\n\t};\n}\n"]}