@cat-factory/agents 0.33.0 → 0.34.0

package/dist/agents/kinds/registry.d.ts

@@ -25,6 +25,15 @@ export interface AgentKindDefinition {
      * end-to-end with no harness changes.
      */
     requiresContainer?: boolean;
+    /**
+     * When true this container kind fans out across the block's connected involved-service
+     * repos: the executor resolves the peer checkouts and threads them (+ the multi-repo
+     * prompt section) into the dispatch, so the harness clones the primary repo PLUS every
+     * peer as sibling checkouts. Used by cross-service kinds (e.g. the read-only
+     * `bug-investigator`). Defaults to false (single-repo). Only meaningful for a container
+     * kind — see {@link AgentKindRegistry.fansOutMultiRepo}.
+     */
+    fanOutMultiRepo?: boolean;
     /**
      * Optional one-clause reason this kind should reach for web search, phrased to
      * complete "Use it mainly to …" (e.g. "verify the vendor's current API contract
@@ -96,44 +105,68 @@ export interface AgentKindDefinition {
      */
     presentation?: AgentPresentation;
 }
-/** Register a custom agent kind. A later registration of the same id replaces the earlier one. */
-export declare function registerAgentKind(definition: AgentKindDefinition): void;
-/** Register several custom agent kinds at once. */
-export declare function registerAgentKinds(definitions: Iterable<AgentKindDefinition>): void;
-/** The registered definition for a kind, or undefined for built-in / unregistered kinds. */
-export declare function registeredAgentKind(kind: AgentKind): AgentKindDefinition | undefined;
-/** All registered custom agent kinds (registration order). */
-export declare function registeredAgentKinds(): AgentKindDefinition[];
 /**
- * Whether a registered kind runs in a container — either it set `requiresContainer`
- * explicitly, or its `agent` step declares a container surface. False for built-in /
- * unregistered kinds.
+ * App-owned registry of agent kinds, mirroring the backend-registries pilot
+ * (`RunnerBackendRegistry` / `EnvironmentBackendRegistry`). The composition root news ONE
+ * instance per app (`defaultAgentKindRegistry()`), threads it through `CoreDependencies`, and
+ * every prompt build / routing decision reads it from there — so there is no module-global
+ * `Map`, no `clear*()` test cruft, and no external-adapter module-identity gotcha: a
+ * deployment registers extra kinds by reference (`registry.register(def)`) on the instance the
+ * facade injects. The built-in kinds (`bug-investigator` / the document + initiative kinds) are
+ * pre-loaded by the factory, not by an import side effect.
  */
-export declare function registeredKindRequiresContainer(kind: AgentKind): boolean;
-/** Drop all registered kinds. Intended for tests that exercise registration. */
-export declare function clearRegisteredAgentKinds(): void;
-/** A registered kind's system prompt, or undefined when the kind is not registered. */
-export declare function registeredSystemPrompt(kind: AgentKind): string | undefined;
-/** A registered kind's user prompt, or undefined when the kind is not registered / has no builder. */
-export declare function registeredUserPrompt(context: AgentRunContext): string | undefined;
-/** A registered kind's web-research hint, or undefined when unregistered / not supplied. */
-export declare function registeredWebResearchHint(kind: AgentKind): string | undefined;
-/** A registered kind's execution tuning, or undefined when unregistered / not supplied. */
-export declare function registeredAgentTuning(kind: AgentKind): AgentTuning | undefined;
-/** A registered kind's contributed config descriptors, or an empty array when none. */
-export declare function registeredConfigContributions(kind: AgentKind): AgentConfigDescriptor[];
-/** A registered kind's agent-step spec (surface/output/clone), or undefined when none. */
-export declare function registeredAgentStep(kind: AgentKind): AgentStepSpec | undefined;
-/** A registered kind's pre-op hooks (run before the agent step), or an empty array. */
-export declare function registeredPreOps(kind: AgentKind): RepoOp[];
-/** A registered kind's post-op hooks (run after the agent step), or an empty array. */
-export declare function registeredPostOps(kind: AgentKind): RepoOp[];
-/** A registered kind's frontend presentation metadata, or undefined when not supplied. */
-export declare function registeredAgentPresentation(kind: AgentKind): AgentPresentation | undefined;
+export declare class AgentKindRegistry {
+    private readonly registry;
+    /** Register a custom agent kind. A later registration of the same id replaces the earlier one. */
+    register(definition: AgentKindDefinition): void;
+    /** Register several custom agent kinds at once. */
+    registerAll(definitions: Iterable<AgentKindDefinition>): void;
+    /** The registered definition for a kind, or undefined for built-in / unregistered kinds. */
+    get(kind: AgentKind): AgentKindDefinition | undefined;
+    /** All registered agent kinds (registration order). */
+    all(): AgentKindDefinition[];
+    /**
+     * Whether a registered kind runs in a container — either it set `requiresContainer`
+     * explicitly, or its `agent` step declares a container surface. False for built-in /
+     * unregistered kinds.
+     */
+    requiresContainer(kind: AgentKind): boolean;
+    /**
+     * Whether a registered kind fans out across the block's connected involved-service repos
+     * (see {@link AgentKindDefinition.fanOutMultiRepo}). False for built-in / unregistered kinds —
+     * the executor keeps a small allow-list for the pre-registry built-ins (`coder` / `ci-fixer`).
+     */
+    fansOutMultiRepo(kind: AgentKind): boolean;
+    /** A registered kind's system prompt, or undefined when the kind is not registered. */
+    systemPrompt(kind: AgentKind): string | undefined;
+    /** A registered kind's user prompt, or undefined when the kind is not registered / has no builder. */
+    userPrompt(context: AgentRunContext): string | undefined;
+    /** A registered kind's web-research hint, or undefined when unregistered / not supplied. */
+    webResearchHint(kind: AgentKind): string | undefined;
+    /** A registered kind's execution tuning, or undefined when unregistered / not supplied. */
+    tuning(kind: AgentKind): AgentTuning | undefined;
+    /** A registered kind's contributed config descriptors, or an empty array when none. */
+    configContributions(kind: AgentKind): AgentConfigDescriptor[];
+    /** A registered kind's agent-step spec (surface/output/clone), or undefined when none. */
+    agentStep(kind: AgentKind): AgentStepSpec | undefined;
+    /** A registered kind's pre-op hooks (run before the agent step), or an empty array. */
+    preOps(kind: AgentKind): RepoOp[];
+    /** A registered kind's post-op hooks (run after the agent step), or an empty array. */
+    postOps(kind: AgentKind): RepoOp[];
+    /** A registered kind's frontend presentation metadata, or undefined when not supplied. */
+    presentation(kind: AgentKind): AgentPresentation | undefined;
+    /**
+     * A registered kind's schema-driven structured output (its typed `parse`/`safeParse` + the
+     * derived spec), or undefined when the kind isn't registered / declared no schema. A post-op
+     * or step-resolver uses this to parse `result.custom` without hand-writing a coercer.
+     */
+    structuredOutput(kind: AgentKind): StructuredOutput<unknown> | undefined;
+}
 /**
- * A registered kind's schema-driven structured output (its typed `parse`/`safeParse` + the
- * derived spec), or undefined when the kind isn't registered / declared no schema. A post-op
- * or step-resolver uses this to parse `result.custom` without hand-writing a coercer.
+ * A fresh registry pre-loaded with the built-in agent kinds. This is the single place the
+ * built-ins are installed — there is no module-load side effect — so every app (and every
+ * test) gets its own instance with the built-ins present. A deployment then registers its
+ * own kinds by reference on the instance the composition root injects.
  */
-export declare function registeredStructuredOutput(kind: AgentKind): StructuredOutput<unknown> | undefined;
+export declare function defaultAgentKindRegistry(): AgentKindRegistry;
 //# sourceMappingURL=registry.d.ts.map

package/dist/agents/kinds/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/registry.ts"],"names":[],"mappings":"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"}

package/dist/agents/kinds/registry.js

@@ -1,11 +1,6 @@
-// Process-wide registry, mirroring the Worker's model-provider registry. Registration
-// is a startup side effect read by every prompt build / routing decision, so the extra
-// kinds reach all paths — HTTP requests, the durable driver and the cron sweeper.
-const registry = new Map();
-/** Register a custom agent kind. A later registration of the same id replaces the earlier one. */
-export function registerAgentKind(definition) {
-    registry.set(definition.kind, withDerivedOutput(definition));
-}
+import { registerBugInvestigatorAgent } from './bug-investigator.js';
+import { registerDocumentAgents } from './document.js';
+import { registerInitiativeAgents } from './initiative.js';
 /**
  * Derive `agent.output` from a `structuredOutput` schema when the author didn't set it by
  * hand — so a structured kind declares ONE valibot schema and the engine spec falls out of
@@ -17,84 +12,118 @@ function withDerivedOutput(definition) {
         return definition;
     return { ...definition, agent: { ...agent, output: structuredOutput.spec } };
 }
-/** Register several custom agent kinds at once. */
-export function registerAgentKinds(definitions) {
-    for (const definition of definitions)
-        registerAgentKind(definition);
-}
-/** The registered definition for a kind, or undefined for built-in / unregistered kinds. */
-export function registeredAgentKind(kind) {
-    return registry.get(kind);
-}
-/** All registered custom agent kinds (registration order). */
-export function registeredAgentKinds() {
-    return [...registry.values()];
-}
 /**
- * Whether a registered kind runs in a container — either it set `requiresContainer`
- * explicitly, or its `agent` step declares a container surface. False for built-in /
- * unregistered kinds.
+ * App-owned registry of agent kinds, mirroring the backend-registries pilot
+ * (`RunnerBackendRegistry` / `EnvironmentBackendRegistry`). The composition root news ONE
+ * instance per app (`defaultAgentKindRegistry()`), threads it through `CoreDependencies`, and
+ * every prompt build / routing decision reads it from there — so there is no module-global
+ * `Map`, no `clear*()` test cruft, and no external-adapter module-identity gotcha: a
+ * deployment registers extra kinds by reference (`registry.register(def)`) on the instance the
+ * facade injects. The built-in kinds (`bug-investigator` / the document + initiative kinds) are
+ * pre-loaded by the factory, not by an import side effect.
  */
-export function registeredKindRequiresContainer(kind) {
-    const definition = registry.get(kind);
-    if (!definition)
-        return false;
-    if (definition.requiresContainer === true)
-        return true;
-    const surface = definition.agent?.surface;
-    return surface === 'container-explore' || surface === 'container-coding';
-}
-/** Drop all registered kinds. Intended for tests that exercise registration. */
-export function clearRegisteredAgentKinds() {
-    registry.clear();
-}
-/** A registered kind's system prompt, or undefined when the kind is not registered. */
-export function registeredSystemPrompt(kind) {
-    const definition = registry.get(kind);
-    if (!definition)
-        return undefined;
-    return typeof definition.systemPrompt === 'function'
-        ? definition.systemPrompt(kind)
-        : definition.systemPrompt;
-}
-/** A registered kind's user prompt, or undefined when the kind is not registered / has no builder. */
-export function registeredUserPrompt(context) {
-    return registry.get(context.agentKind)?.userPrompt?.(context);
-}
-/** A registered kind's web-research hint, or undefined when unregistered / not supplied. */
-export function registeredWebResearchHint(kind) {
-    return registry.get(kind)?.webResearchHint;
-}
-/** A registered kind's execution tuning, or undefined when unregistered / not supplied. */
-export function registeredAgentTuning(kind) {
-    return registry.get(kind)?.tuning;
-}
-/** A registered kind's contributed config descriptors, or an empty array when none. */
-export function registeredConfigContributions(kind) {
-    return registry.get(kind)?.configContributions ?? [];
-}
-/** A registered kind's agent-step spec (surface/output/clone), or undefined when none. */
-export function registeredAgentStep(kind) {
-    return registry.get(kind)?.agent;
-}
-/** A registered kind's pre-op hooks (run before the agent step), or an empty array. */
-export function registeredPreOps(kind) {
-    return registry.get(kind)?.preOps ?? [];
-}
-/** A registered kind's post-op hooks (run after the agent step), or an empty array. */
-export function registeredPostOps(kind) {
-    return registry.get(kind)?.postOps ?? [];
-}
-/** A registered kind's frontend presentation metadata, or undefined when not supplied. */
-export function registeredAgentPresentation(kind) {
-    return registry.get(kind)?.presentation;
+export class AgentKindRegistry {
+    registry = new Map();
+    /** Register a custom agent kind. A later registration of the same id replaces the earlier one. */
+    register(definition) {
+        this.registry.set(definition.kind, withDerivedOutput(definition));
+    }
+    /** Register several custom agent kinds at once. */
+    registerAll(definitions) {
+        for (const definition of definitions)
+            this.register(definition);
+    }
+    /** The registered definition for a kind, or undefined for built-in / unregistered kinds. */
+    get(kind) {
+        return this.registry.get(kind);
+    }
+    /** All registered agent kinds (registration order). */
+    all() {
+        return [...this.registry.values()];
+    }
+    /**
+     * Whether a registered kind runs in a container — either it set `requiresContainer`
+     * explicitly, or its `agent` step declares a container surface. False for built-in /
+     * unregistered kinds.
+     */
+    requiresContainer(kind) {
+        const definition = this.registry.get(kind);
+        if (!definition)
+            return false;
+        if (definition.requiresContainer === true)
+            return true;
+        const surface = definition.agent?.surface;
+        return surface === 'container-explore' || surface === 'container-coding';
+    }
+    /**
+     * Whether a registered kind fans out across the block's connected involved-service repos
+     * (see {@link AgentKindDefinition.fanOutMultiRepo}). False for built-in / unregistered kinds —
+     * the executor keeps a small allow-list for the pre-registry built-ins (`coder` / `ci-fixer`).
+     */
+    fansOutMultiRepo(kind) {
+        return this.registry.get(kind)?.fanOutMultiRepo === true;
+    }
+    /** A registered kind's system prompt, or undefined when the kind is not registered. */
+    systemPrompt(kind) {
+        const definition = this.registry.get(kind);
+        if (!definition)
+            return undefined;
+        return typeof definition.systemPrompt === 'function'
+            ? definition.systemPrompt(kind)
+            : definition.systemPrompt;
+    }
+    /** A registered kind's user prompt, or undefined when the kind is not registered / has no builder. */
+    userPrompt(context) {
+        return this.registry.get(context.agentKind)?.userPrompt?.(context);
+    }
+    /** A registered kind's web-research hint, or undefined when unregistered / not supplied. */
+    webResearchHint(kind) {
+        return this.registry.get(kind)?.webResearchHint;
+    }
+    /** A registered kind's execution tuning, or undefined when unregistered / not supplied. */
+    tuning(kind) {
+        return this.registry.get(kind)?.tuning;
+    }
+    /** A registered kind's contributed config descriptors, or an empty array when none. */
+    configContributions(kind) {
+        return this.registry.get(kind)?.configContributions ?? [];
+    }
+    /** A registered kind's agent-step spec (surface/output/clone), or undefined when none. */
+    agentStep(kind) {
+        return this.registry.get(kind)?.agent;
+    }
+    /** A registered kind's pre-op hooks (run before the agent step), or an empty array. */
+    preOps(kind) {
+        return this.registry.get(kind)?.preOps ?? [];
+    }
+    /** A registered kind's post-op hooks (run after the agent step), or an empty array. */
+    postOps(kind) {
+        return this.registry.get(kind)?.postOps ?? [];
+    }
+    /** A registered kind's frontend presentation metadata, or undefined when not supplied. */
+    presentation(kind) {
+        return this.registry.get(kind)?.presentation;
+    }
+    /**
+     * A registered kind's schema-driven structured output (its typed `parse`/`safeParse` + the
+     * derived spec), or undefined when the kind isn't registered / declared no schema. A post-op
+     * or step-resolver uses this to parse `result.custom` without hand-writing a coercer.
+     */
+    structuredOutput(kind) {
+        return this.registry.get(kind)?.structuredOutput;
+    }
 }
 /**
- * A registered kind's schema-driven structured output (its typed `parse`/`safeParse` + the
- * derived spec), or undefined when the kind isn't registered / declared no schema. A post-op
- * or step-resolver uses this to parse `result.custom` without hand-writing a coercer.
+ * A fresh registry pre-loaded with the built-in agent kinds. This is the single place the
+ * built-ins are installed — there is no module-load side effect — so every app (and every
+ * test) gets its own instance with the built-ins present. A deployment then registers its
+ * own kinds by reference on the instance the composition root injects.
  */
-export function registeredStructuredOutput(kind) {
-    return registry.get(kind)?.structuredOutput;
+export function defaultAgentKindRegistry() {
+    const registry = new AgentKindRegistry();
+    registerBugInvestigatorAgent(registry);
+    registerDocumentAgents(registry);
+    registerInitiativeAgents(registry);
+    return registry;
 }
 //# sourceMappingURL=registry.js.map

package/dist/agents/kinds/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/agents/kinds/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/agents/kinds/registry.ts"],"names":[],"mappings":"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"}

package/dist/agents/kinds/step-surface.d.ts

@@ -1,4 +1,5 @@
 import type { AgentKind } from '@cat-factory/kernel';
+import type { AgentKindRegistry } from './registry.js';
 export declare const REQUIREMENTS_REVIEW_AGENT_KIND = "requirements-review";
 export declare const CLARITY_REVIEW_AGENT_KIND = "clarity-review";
 export declare const REQUIREMENTS_BRAINSTORM_AGENT_KIND = "requirements-brainstorm";
@@ -9,5 +10,5 @@ export declare const ARCHITECTURE_BRAINSTORM_AGENT_KIND = "architecture-brainsto
  * and for any custom kind registered with an `inline` agent surface. Used by the start guard
  * to apply the stricter inline-model-usability check to exactly these steps.
  */
-export declare function isInlineModelStep(kind: AgentKind): boolean;
+export declare function isInlineModelStep(kind: AgentKind, registry: AgentKindRegistry): boolean;
 //# sourceMappingURL=step-surface.d.ts.map

package/dist/agents/kinds/step-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-surface.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/step-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAuBpD,eAAO,MAAM,8BAA8B,wBAAwB,CAAA;AACnE,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AACzD,eAAO,MAAM,kCAAkC,4BAA4B,CAAA;AAC3E,eAAO,MAAM,kCAAkC,4BAA4B,CAAA;AAU3E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAG1D"}
+{"version":3,"file":"step-surface.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/step-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAqBtD,eAAO,MAAM,8BAA8B,wBAAwB,CAAA;AACnE,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AACzD,eAAO,MAAM,kCAAkC,4BAA4B,CAAA;AAC3E,eAAO,MAAM,kCAAkC,4BAA4B,CAAA;AAU3E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAGvF"}

package/dist/agents/kinds/step-surface.js

@@ -1,5 +1,4 @@
 import { TASK_ESTIMATOR_AGENT_KIND } from '../prompts/roles.js';
-import { registeredAgentKind } from './registry.js';
 // Which execution surface a pipeline step's model runs on — the taxonomy the preset
 // satisfiability guard keys off. Only INLINE model steps need a special check: an inline
 // `generateText` call cannot use a container-only subscription token, so a step that runs a
@@ -35,9 +34,9 @@ const INLINE_ENGINE_KINDS = new Set([
  * and for any custom kind registered with an `inline` agent surface. Used by the start guard
  * to apply the stricter inline-model-usability check to exactly these steps.
  */
-export function isInlineModelStep(kind) {
+export function isInlineModelStep(kind, registry) {
     if (INLINE_ENGINE_KINDS.has(kind))
         return true;
-    return registeredAgentKind(kind)?.agent?.surface === 'inline';
+    return registry.get(kind)?.agent?.surface === 'inline';
 }
 //# sourceMappingURL=step-surface.js.map

package/dist/agents/kinds/step-surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-surface.js","sourceRoot":"","sources":["../../../src/agents/kinds/step-surface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnD,oFAAoF;AACpF,yFAAyF;AACzF,4FAA4F;AAC5F,6FAA6F;AAC7F,wFAAwF;AACxF,2CAA2C;AAC3C,EAAE;AACF,wFAAwF;AACxF,4FAA4F;AAC5F,yFAAyF;AAEzF,+EAA+E;AAC/E,0FAA0F;AAC1F,2FAA2F;AAC3F,uFAAuF;AACvF,qFAAqF;AACrF,sFAAsF;AACtF,0FAA0F;AAC1F,kCAAkC;AAClC,MAAM,CAAC,MAAM,8BAA8B,GAAG,qBAAqB,CAAA;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAA;AACzD,MAAM,CAAC,MAAM,kCAAkC,GAAG,yBAAyB,CAAA;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAAG,yBAAyB,CAAA;AAE3E,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS;IAC1C,8BAA8B;IAC9B,yBAAyB;IACzB,kCAAkC;IAClC,kCAAkC;IAClC,yBAAyB;CAC1B,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAe;IAC/C,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9C,OAAO,mBAAmB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,QAAQ,CAAA;AAC/D,CAAC"}
+{"version":3,"file":"step-surface.js","sourceRoot":"","sources":["../../../src/agents/kinds/step-surface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAG/D,oFAAoF;AACpF,yFAAyF;AACzF,4FAA4F;AAC5F,6FAA6F;AAC7F,wFAAwF;AACxF,2CAA2C;AAC3C,EAAE;AACF,wFAAwF;AACxF,4FAA4F;AAC5F,yFAAyF;AAEzF,+EAA+E;AAC/E,0FAA0F;AAC1F,2FAA2F;AAC3F,uFAAuF;AACvF,qFAAqF;AACrF,sFAAsF;AACtF,0FAA0F;AAC1F,kCAAkC;AAClC,MAAM,CAAC,MAAM,8BAA8B,GAAG,qBAAqB,CAAA;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAA;AACzD,MAAM,CAAC,MAAM,kCAAkC,GAAG,yBAAyB,CAAA;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAAG,yBAAyB,CAAA;AAE3E,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS;IAC1C,8BAA8B;IAC9B,yBAAyB;IACzB,kCAAkC;IAClC,kCAAkC;IAClC,yBAAyB;CAC1B,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,QAA2B;IAC5E,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,QAAQ,CAAA;AACxD,CAAC"}

package/dist/agents/kinds/traits.d.ts

@@ -1,4 +1,5 @@
 import type { AgentKind } from '@cat-factory/kernel';
+import type { AgentKindRegistry } from './registry.js';
 /** A trait id. Free-form so deployments can define their own beyond the standard two. */
 export type AgentTrait = string;
 /**
@@ -70,14 +71,19 @@ export declare function registerAgentTraits(definitions: Iterable<AgentTraitDefi
 export declare function registeredAgentTrait(id: AgentTrait): AgentTraitDefinition | undefined;
 /** Drop all registered (custom) traits. Intended for tests; standard traits re-register below. */
 export declare function clearRegisteredAgentTraits(): void;
-/** The traits a kind carries: its built-in set unioned with a registered custom kind's. */
-export declare function traitsFor(kind: AgentKind): Set<AgentTrait>;
+/**
+ * The traits a kind carries: its built-in set unioned with a registered kind's own `traits`
+ * (read off the app-owned {@link AgentKindRegistry}) and any extra assignments. The trait
+ * definition + assignment registries remain module-global (the separate "Agent traits" slice);
+ * only the agent-kind lookup rides the injected registry.
+ */
+export declare function traitsFor(kind: AgentKind, registry: AgentKindRegistry): Set<AgentTrait>;
 /** Whether `kind` carries `trait`. */
-export declare function hasTrait(kind: AgentKind, trait: AgentTrait): boolean;
+export declare function hasTrait(kind: AgentKind, trait: AgentTrait, registry: AgentKindRegistry): boolean;
 /**
  * The guidance lines contributed by the traits a kind carries, in trait order. Folded
  * into the kind's system prompt by `systemPromptFor`. Marker traits (no guidance, e.g.
  * `code-aware`) contribute nothing here.
  */
-export declare function traitGuidanceFor(kind: AgentKind): string[];
+export declare function traitGuidanceFor(kind: AgentKind, registry: AgentKindRegistry): string[];
 //# sourceMappingURL=traits.d.ts.map

package/dist/agents/kinds/traits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/traits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAapD,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,UAAwB,CAAA;AAEtD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAA6B,CAAA;AAEhE,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,QAOpB,CAAA;AAEZ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAyB1E,CAAA;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,EAAE,EAAE,UAAU,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC,CAAA;CAClD;AAaD,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAIrF;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAEzE;AAED,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAErF;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,GAAG,oBAAoB,GAAG,SAAS,CAErF;AAED,kGAAkG;AAClG,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,CAK1D;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAQ1D"}
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/traits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAYtD,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,UAAwB,CAAA;AAEtD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAA6B,CAAA;AAEhE,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,QAOpB,CAAA;AAEZ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAyB1E,CAAA;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,EAAE,EAAE,UAAU,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC,CAAA;CAClD;AAaD,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAIrF;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAEzE;AAED,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAErF;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,GAAG,oBAAoB,GAAG,SAAS,CAErF;AAED,kGAAkG;AAClG,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,GAAG,CAAC,UAAU,CAAC,CAKvF;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAEjG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAQvF"}

package/dist/agents/kinds/traits.js

@@ -1,5 +1,4 @@
 import { SPEC_FEATURES_DIR, SPEC_MODULES_DIR, SPEC_OVERVIEW_PATH } from '@cat-factory/contracts';
-import { registeredAgentKind } from './registry.js';
 /**
  * Code-aware kinds read and/or change the service's code. The service's selected
  * best-practice / guideline fragments (Node, Fastify, performance, …) are folded into
@@ -116,27 +115,32 @@ export function clearRegisteredAgentTraits() {
     traitRegistry.clear();
     registerStandardTraits();
 }
-/** The traits a kind carries: its built-in set unioned with a registered custom kind's. */
-export function traitsFor(kind) {
+/**
+ * The traits a kind carries: its built-in set unioned with a registered kind's own `traits`
+ * (read off the app-owned {@link AgentKindRegistry}) and any extra assignments. The trait
+ * definition + assignment registries remain module-global (the separate "Agent traits" slice);
+ * only the agent-kind lookup rides the injected registry.
+ */
+export function traitsFor(kind, registry) {
     const traits = new Set(STANDARD_AGENT_TRAITS[kind] ?? []);
-    for (const trait of registeredAgentKind(kind)?.traits ?? [])
+    for (const trait of registry.get(kind)?.traits ?? [])
         traits.add(trait);
     for (const trait of assignedTraits.get(kind) ?? [])
         traits.add(trait);
     return traits;
 }
 /** Whether `kind` carries `trait`. */
-export function hasTrait(kind, trait) {
-    return traitsFor(kind).has(trait);
+export function hasTrait(kind, trait, registry) {
+    return traitsFor(kind, registry).has(trait);
 }
 /**
  * The guidance lines contributed by the traits a kind carries, in trait order. Folded
  * into the kind's system prompt by `systemPromptFor`. Marker traits (no guidance, e.g.
  * `code-aware`) contribute nothing here.
  */
-export function traitGuidanceFor(kind) {
+export function traitGuidanceFor(kind, registry) {
     const lines = [];
-    for (const trait of traitsFor(kind)) {
+    for (const trait of traitsFor(kind, registry)) {
         const guidance = traitRegistry.get(trait)?.guidance;
         if (!guidance)
             continue;

package/dist/agents/kinds/traits.js.map

@@ -1 +1 @@
-{"version":3,"file":"traits.js","sourceRoot":"","sources":["../../../src/agents/kinds/traits.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"traits.js","sourceRoot":"","sources":["../../../src/agents/kinds/traits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAiBhG;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAe,YAAY,CAAA;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAe,WAAW,CAAA;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAe,YAAY,CAAA;AAExD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAe,gBAAgB,CAAA;AAEhE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,8QAA8Q;IAC9Q,OAAO,kBAAkB,0GAA0G;IACnI,OAAO,gBAAgB,mHAAmH;IAC1I,OAAO,gBAAgB,0IAA0I;IACjK,OAAO,iBAAiB,uFAAuF;IAC/G,+RAA+R;CAChS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6C;IAC7E,SAAS,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC/C,KAAK,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC3C,QAAQ,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC9C,UAAU,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAChD,KAAK,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC3C,mBAAmB,EAAE,CAAC,gBAAgB,CAAC;IACvC,YAAY,EAAE,CAAC,gBAAgB,CAAC;IAChC,mFAAmF;IACnF,kFAAkF;IAClF,WAAW,EAAE,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IACrD,UAAU,EAAE,CAAC,gBAAgB,CAAC;IAC9B,UAAU,EAAE,CAAC,gBAAgB,CAAC;IAC9B,qBAAqB,EAAE,CAAC,gBAAgB,CAAC;IACzC,mBAAmB,EAAE,CAAC,gBAAgB,CAAC;IACvC,QAAQ,EAAE,CAAC,gBAAgB,CAAC;IAC5B,MAAM,EAAE,CAAC,gBAAgB,CAAC;IAC1B,MAAM,EAAE,CAAC,gBAAgB,CAAC;IAC1B,wFAAwF;IACxF,uFAAuF;IACvF,SAAS,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC/C,oFAAoF;IACpF,wFAAwF;IACxF,mFAAmF;IACnF,cAAc,EAAE,CAAC,eAAe,CAAC;CAClC,CAAA;AAcD,qFAAqF;AACrF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoC,CAAA;AAEjE,kFAAkF;AAClF,sFAAsF;AACtF,mFAAmF;AACnF,mFAAmF;AACnF,sFAAsF;AACtF,uDAAuD;AACvD,MAAM,cAAc,GAAG,IAAI,GAAG,EAA8B,CAAA;AAE5D,kGAAkG;AAClG,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,MAA4B;IAC7E,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAc,CAAA;IAC7D,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC1C,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAC/B,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,wBAAwB;IACtC,cAAc,CAAC,KAAK,EAAE,CAAA;AACxB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,UAAgC;IACjE,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAA;AAC9C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,WAA2C;IAC7E,KAAK,MAAM,UAAU,IAAI,WAAW;QAAE,kBAAkB,CAAC,UAAU,CAAC,CAAA;AACtE,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,oBAAoB,CAAC,EAAc;IACjD,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AAC9B,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,0BAA0B;IACxC,aAAa,CAAC,KAAK,EAAE,CAAA;IACrB,sBAAsB,EAAE,CAAA;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAe,EAAE,QAA2B;IACpE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAa,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACrE,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACvE,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACrE,OAAO,MAAM,CAAA;AACf,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,QAAQ,CAAC,IAAe,EAAE,KAAiB,EAAE,QAA2B;IACtF,OAAO,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,QAA2B;IAC3E,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;QACnD,IAAI,CAAC,QAAQ;YAAE,SAAQ;QACvB,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACxE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,oFAAoF;AACpF,SAAS,sBAAsB;IAC7B,kBAAkB,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAA;IAC5C,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,CAAA;IAC3C,kBAAkB,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAA;AAC7E,CAAC;AAED,sBAAsB,EAAE,CAAA"}

package/dist/agents/kinds/tuning.d.ts

@@ -1,3 +1,4 @@
+import type { AgentKindRegistry } from './registry.js';
 /** Per-knob progress-guard overrides for a kind (each optional; absent ⇒ harness default). */
 export interface AgentGuardTuning {
     /** Non-exploration tool calls allowed before the first edit (the no-edit bound). */
@@ -17,5 +18,5 @@ export interface AgentTuning {
  * every knob). Returns the override object as-is — the dispatcher spreads it into the
  * job body and the harness clamps each value.
  */
-export declare function agentTuningFor(kind: string): AgentTuning | undefined;
+export declare function agentTuningFor(kind: string, registry: AgentKindRegistry): AgentTuning | undefined;
 //# sourceMappingURL=tuning.d.ts.map

package/dist/agents/kinds/tuning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tuning.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/tuning.ts"],"names":[],"mappings":"AAgBA,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,wFAAwF;IACxF,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,gBAAgB,CAAA;CAC/B;AAkBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE"}
+{"version":3,"file":"tuning.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/tuning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAgBtD,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,wFAAwF;IACxF,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,gBAAgB,CAAA;CAC/B;AAkBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,WAAW,GAAG,SAAS,CAEjG"}

package/dist/agents/kinds/tuning.js

@@ -1,4 +1,3 @@
-import { registeredAgentTuning } from './registry.js';
 // Built-in per-kind tuning. Deliberately sparse: only kinds with a documented reason
 // their normal pattern trips a default guard get an entry — everything else inherits
 // the harness defaults unchanged. Every override here LOOSENS a limit.
@@ -20,7 +19,7 @@ const BUILTIN_AGENT_TUNING = {
  * every knob). Returns the override object as-is — the dispatcher spreads it into the
  * job body and the harness clamps each value.
  */
-export function agentTuningFor(kind) {
-    return registeredAgentTuning(kind) ?? BUILTIN_AGENT_TUNING[kind];
+export function agentTuningFor(kind, registry) {
+    return registry.tuning(kind) ?? BUILTIN_AGENT_TUNING[kind];
 }
 //# sourceMappingURL=tuning.js.map

package/dist/agents/kinds/tuning.js.map

@@ -1 +1 @@
-{"version":3,"file":"tuning.js","sourceRoot":"","sources":["../../../src/agents/kinds/tuning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AA+BrD,qFAAqF;AACrF,qFAAqF;AACrF,uEAAuE;AACvE,MAAM,oBAAoB,GAAgC;IACxD,mFAAmF;IACnF,sFAAsF;IACtF,yCAAyC;IACzC,mBAAmB,EAAE,EAAE,WAAW,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE,EAAE;IAClE,oFAAoF;IACpF,mFAAmF;IACnF,UAAU,EAAE,EAAE,WAAW,EAAE,EAAE,sBAAsB,EAAE,EAAE,EAAE,EAAE;IAC3D,sFAAsF;IACtF,2EAA2E;IAC3E,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,sBAAsB,EAAE,EAAE,EAAE,EAAE;CAC1D,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAA;AAClE,CAAC"}
+{"version":3,"file":"tuning.js","sourceRoot":"","sources":["../../../src/agents/kinds/tuning.ts"],"names":[],"mappings":"AA+BA,qFAAqF;AACrF,qFAAqF;AACrF,uEAAuE;AACvE,MAAM,oBAAoB,GAAgC;IACxD,mFAAmF;IACnF,sFAAsF;IACtF,yCAAyC;IACzC,mBAAmB,EAAE,EAAE,WAAW,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE,EAAE;IAClE,oFAAoF;IACpF,mFAAmF;IACnF,UAAU,EAAE,EAAE,WAAW,EAAE,EAAE,sBAAsB,EAAE,EAAE,EAAE,EAAE;IAC3D,sFAAsF;IACtF,2EAA2E;IAC3E,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,sBAAsB,EAAE,EAAE,EAAE,EAAE;CAC1D,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAA2B;IACtE,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAA;AAC5D,CAAC"}

package/dist/agents/prompts/roles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/roles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AA0EzD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAOxD"}
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/roles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AAuEzD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAOxD"}

package/dist/agents/prompts/roles.js

@@ -19,12 +19,10 @@ const ROLES = {
     // produce a single, prioritized, actionable markdown report that a downstream
     // `tracker` step files as an issue and a `coder` step then implements.
     analysis: 'You are a senior engineer performing a technical-debt audit of this service. Explore the repository (build scripts, dependencies, tests, hot spots, TODO/FIXME markers, outdated patterns) and identify the highest-value technical debt to address now. Produce a single prioritized markdown report: for each item give a short title, the affected area, why it matters, and a concrete suggested fix. Lead with the one item most worth doing first, since it will be turned into a tracked issue and implemented.',
-    // Opens a bug-fix pipeline. Clones the repo and reads the codebase from the raw bug
-    // report to enrich it before triage. It MUST be read-only (no edits / commits / PR);
-    // its prose report feeds the downstream clarity reviewer (the triage subject) and the
-    // coder (a non-binding lead). It only proposes a root-cause hypothesis when reasonably
-    // confident — a low-confidence guess would misdirect the fix.
-    'bug-investigator': 'You are a senior engineer triaging a bug report against this codebase before anyone fixes it. Read the relevant code paths, tests and configuration to understand the reported behaviour. Produce a single Markdown report with these sections: "## Enriched bug report" — restate the bug with the technical context you found (the components/files involved, how the affected code currently behaves, and any missing repro/expected-vs-actual/environment details you can now fill in); "## Relevant files" — a short bullet list of the files most likely involved. ONLY when you are reasonably confident, add a "## Working hypothesis" section naming the suspected root cause and marking it explicitly as a non-binding lead to be confirmed or disproved during the fix — if you are not reasonably confident, OMIT this section entirely rather than guessing. Do not propose or write a fix.',
+    // NOTE: `bug-investigator` is no longer a prose ROLE — it is a STRUCTURED
+    // `container-explore` kind registered via `registerAgentKind` in
+    // `agents/kinds/bug-investigator.ts` (its structured `clarity`/`questions` drive the
+    // downstream clarity gate). It intentionally has no entry here.
     documenter: 'You are a technical writer. Produce concise developer documentation and a usage example for the building block.',
     integrator: 'You are an integration engineer. Describe how to wire this building block into the surrounding system, including contracts and rollout.',
     // Runs before the architect: reviews the collected CONTEXT (the linked-prose brief)