@cat-factory/agents 0.6.0

package/dist/agents/agent-configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-configs.d.ts","sourceRoot":"","sources":["../../src/agents/agent-configs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAQ3E,yFAAyF;AACzF,eAAO,MAAM,4BAA4B,uBAAuB,CAAA;AAChE,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,yBAAyB,CAAA;AAqCrE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,EAAE,CAI/E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,qBAAqB,EAAE,CAQ7F"}

package/dist/agents/agent-configs.js

@@ -0,0 +1,66 @@
+import { registeredConfigContributions } from './registry.js';
+// Built-in agent config contributions. An agent kind declares the task-level
+// parameters it cares about here; the union over a pipeline's kinds is what the
+// task-creation form and inspector render (and freeze once the owning step runs).
+// Custom kinds contribute the same way via `registerAgentKind({ configContributions })`.
+/** The Tester's environment choice: stand infra up locally, or use the ephemeral env. */
+export const TESTER_ENVIRONMENT_CONFIG_ID = 'tester.environment';
+/** The acceptance/e2e execution target: project CI, or the ephemeral env. */
+export const PLAYWRIGHT_E2E_TARGET_CONFIG_ID = 'playwright.e2eTarget';
+const BUILTIN_CONFIG_CONTRIBUTIONS = {
+    tester: [
+        {
+            id: TESTER_ENVIRONMENT_CONFIG_ID,
+            agentKind: 'tester',
+            label: 'Test environment',
+            description: "Where the Tester runs the suite: with the service's dependencies stood up locally via docker-compose, or against the provisioned ephemeral environment.",
+            type: 'select',
+            options: [
+                { value: 'ephemeral', label: 'Ephemeral environment' },
+                { value: 'local', label: 'Local (docker-compose infra)' },
+            ],
+            // Ephemeral is the zero-config default; local is an opt-in that requires the
+            // service's test infra to be configured (a compose path or the no-infra flag).
+            default: 'ephemeral',
+        },
+    ],
+    playwright: [
+        {
+            id: PLAYWRIGHT_E2E_TARGET_CONFIG_ID,
+            agentKind: 'playwright',
+            label: 'E2E execution target',
+            description: 'Where the acceptance / end-to-end tests run: in the project CI (GitHub Actions), or against the provisioned ephemeral environment.',
+            type: 'select',
+            options: [
+                { value: 'ci', label: 'Project CI (GitHub Actions)' },
+                { value: 'ephemeral', label: 'Ephemeral environment' },
+            ],
+            default: 'ci',
+        },
+    ],
+};
+/**
+ * The config descriptors an agent kind contributes: the built-in ones plus any a
+ * deployment registered for the kind. Empty for kinds that contribute none.
+ */
+export function configContributionsFor(kind) {
+    const builtin = BUILTIN_CONFIG_CONTRIBUTIONS[kind] ?? [];
+    const registered = registeredConfigContributions(kind);
+    return registered.length ? [...builtin, ...registered] : builtin;
+}
+/**
+ * The deduplicated catalog of config descriptors contributed across a set of agent
+ * kinds (e.g. all the kinds used by a workspace's pipelines), keyed by descriptor
+ * id (first contribution wins). This is what the workspace snapshot carries.
+ */
+export function configContributionCatalog(kinds) {
+    const byId = new Map();
+    for (const kind of kinds) {
+        for (const descriptor of configContributionsFor(kind)) {
+            if (!byId.has(descriptor.id))
+                byId.set(descriptor.id, descriptor);
+        }
+    }
+    return [...byId.values()];
+}
+//# sourceMappingURL=agent-configs.js.map

package/dist/agents/agent-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-configs.js","sourceRoot":"","sources":["../../src/agents/agent-configs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAA;AAE7D,6EAA6E;AAC7E,gFAAgF;AAChF,kFAAkF;AAClF,yFAAyF;AAEzF,yFAAyF;AACzF,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAA;AAChE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,sBAAsB,CAAA;AAErE,MAAM,4BAA4B,GAAwD;IACxF,MAAM,EAAE;QACN;YACE,EAAE,EAAE,4BAA4B;YAChC,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,kBAAkB;YACzB,WAAW,EACT,yJAAyJ;YAC3J,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,uBAAuB,EAAE;gBACtD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE;aAC1D;YACD,6EAA6E;YAC7E,+EAA+E;YAC/E,OAAO,EAAE,WAAW;SACrB;KACF;IACD,UAAU,EAAE;QACV;YACE,EAAE,EAAE,+BAA+B;YACnC,SAAS,EAAE,YAAY;YACvB,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EACT,oIAAoI;YACtI,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,6BAA6B,EAAE;gBACrD,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,uBAAuB,EAAE;aACvD;YACD,OAAO,EAAE,IAAI;SACd;KACF;CACF,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAe;IACpD,MAAM,OAAO,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IACxD,MAAM,UAAU,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAA;IACtD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAA0B;IAClE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAiC,CAAA;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,UAAU,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAA;QACnE,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;AAC3B,CAAC"}

package/dist/agents/agent-routing.d.ts

@@ -0,0 +1,57 @@
+import type { AgentKind } from '@cat-factory/kernel';
+import type { ModelRef } from '@cat-factory/kernel';
+export interface AgentModelConfig {
+    ref: ModelRef;
+    temperature?: number;
+    maxOutputTokens?: number;
+    /** Overrides the built-in role system prompt for this agent kind. */
+    system?: string;
+}
+export interface AgentRouting {
+    /** Used for any agent kind without a specific entry (incl. custom agents). */
+    default: AgentModelConfig;
+    byKind: Partial<Record<AgentKind, AgentModelConfig>>;
+}
+/** Resolve the effective config for an agent kind, falling back to the default. */
+export declare function resolveAgentConfig(routing: AgentRouting, kind: AgentKind): AgentModelConfig;
+/** The resolvers a caller supplies so a step's model is picked the same way everywhere. */
+export interface StepModelResolvers {
+    agentRouting: AgentRouting;
+    /** Resolve a model catalog id to a concrete ref; unknown/absent ids return undefined. */
+    resolveBlockModel: (modelId: string | undefined) => ModelRef | undefined;
+    /**
+     * Resolve a workspace's per-agent-kind default model id, consulted when the block
+     * pins no usable model. Optional: absent → the env routing for the kind is used.
+     */
+    resolveWorkspaceModelDefault?: (workspaceId: string, agentKind: string) => Promise<string | undefined>;
+}
+/** What a step needs to resolve its model: which kind, the block's pin, the workspace. */
+export interface StepModelInputs {
+    agentKind: string;
+    /** The model catalog id pinned on the block, if any. */
+    blockModelId: string | undefined;
+    /** The workspace the step runs in; required to consult a per-kind default. */
+    workspaceId?: string;
+}
+/**
+ * Resolve the concrete model ref for a pipeline step with the ONE canonical
+ * precedence used across every executor (the inline LLM executor, the container
+ * executor and the requirements reviewer): a block's pinned model wins, else the
+ * workspace's per-agent-kind default, else the env routing for the kind. Each
+ * candidate id is run through {@link StepModelResolvers.resolveBlockModel}, so an
+ * unresolvable pin (e.g. a stale id) falls through to the next source rather than
+ * silently skipping the workspace default.
+ */
+export declare function resolveStepModelRef(resolvers: StepModelResolvers, inputs: StepModelInputs): Promise<ModelRef>;
+/**
+ * Resolve the model ref for an INLINE LLM call (one that runs through the
+ * {@link ModelProvider}, not a container harness). Identical precedence to
+ * {@link resolveStepModelRef}, but a pinned subscription model — one whose ref
+ * carries a container-only `claude-code` / `codex` harness, for which no provider
+ * key exists — is degraded to the kind's env-routing default (a provider model the
+ * ModelProvider can serve). This is the single place every inline executor routes a
+ * block's model through, so a task pinned to a subscription model for its container
+ * steps still runs its inline steps instead of hard-failing. See {@link inlineModelRef}.
+ */
+export declare function resolveInlineModelRef(resolvers: StepModelResolvers, inputs: StepModelInputs): Promise<ModelRef>;
+//# sourceMappingURL=agent-routing.d.ts.map

package/dist/agents/agent-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-routing.d.ts","sourceRoot":"","sources":["../../src/agents/agent-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AASnD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,QAAQ,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAA;CACrD;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAE3F;AAED,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,YAAY,CAAA;IAC1B,yFAAyF;IACzF,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,QAAQ,GAAG,SAAS,CAAA;IACxE;;;OAGG;IACH,4BAA4B,CAAC,EAAE,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACjC;AAED,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,QAAQ,CAAC,CAYnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,QAAQ,CAAC,CAGnB"}

package/dist/agents/agent-routing.js

@@ -0,0 +1,41 @@
+import { inlineModelRef } from '@cat-factory/kernel';
+/** Resolve the effective config for an agent kind, falling back to the default. */
+export function resolveAgentConfig(routing, kind) {
+    return routing.byKind[kind] ?? routing.default;
+}
+/**
+ * Resolve the concrete model ref for a pipeline step with the ONE canonical
+ * precedence used across every executor (the inline LLM executor, the container
+ * executor and the requirements reviewer): a block's pinned model wins, else the
+ * workspace's per-agent-kind default, else the env routing for the kind. Each
+ * candidate id is run through {@link StepModelResolvers.resolveBlockModel}, so an
+ * unresolvable pin (e.g. a stale id) falls through to the next source rather than
+ * silently skipping the workspace default.
+ */
+export async function resolveStepModelRef(resolvers, inputs) {
+    const fromBlock = resolvers.resolveBlockModel(inputs.blockModelId);
+    if (fromBlock)
+        return fromBlock;
+    if (resolvers.resolveWorkspaceModelDefault && inputs.workspaceId) {
+        const defaultId = await resolvers.resolveWorkspaceModelDefault(inputs.workspaceId, inputs.agentKind);
+        const fromDefault = resolvers.resolveBlockModel(defaultId);
+        if (fromDefault)
+            return fromDefault;
+    }
+    return resolveAgentConfig(resolvers.agentRouting, inputs.agentKind).ref;
+}
+/**
+ * Resolve the model ref for an INLINE LLM call (one that runs through the
+ * {@link ModelProvider}, not a container harness). Identical precedence to
+ * {@link resolveStepModelRef}, but a pinned subscription model — one whose ref
+ * carries a container-only `claude-code` / `codex` harness, for which no provider
+ * key exists — is degraded to the kind's env-routing default (a provider model the
+ * ModelProvider can serve). This is the single place every inline executor routes a
+ * block's model through, so a task pinned to a subscription model for its container
+ * steps still runs its inline steps instead of hard-failing. See {@link inlineModelRef}.
+ */
+export async function resolveInlineModelRef(resolvers, inputs) {
+    const ref = await resolveStepModelRef(resolvers, inputs);
+    return inlineModelRef(ref, resolveAgentConfig(resolvers.agentRouting, inputs.agentKind).ref);
+}
+//# sourceMappingURL=agent-routing.js.map

package/dist/agents/agent-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-routing.js","sourceRoot":"","sources":["../../src/agents/agent-routing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAsBpD,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,IAAe;IACvE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAA;AAChD,CAAC;AA0BD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAA6B,EAC7B,MAAuB;IAEvB,MAAM,SAAS,GAAG,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IAClE,IAAI,SAAS;QAAE,OAAO,SAAS,CAAA;IAC/B,IAAI,SAAS,CAAC,4BAA4B,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACjE,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,4BAA4B,CAC5D,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,SAAS,CACjB,CAAA;QACD,MAAM,WAAW,GAAG,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;QAC1D,IAAI,WAAW;YAAE,OAAO,WAAW,CAAA;IACrC,CAAC;IACD,OAAO,kBAAkB,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAA;AACzE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAA6B,EAC7B,MAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACxD,OAAO,cAAc,CAAC,GAAG,EAAE,kBAAkB,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAA;AAC9F,CAAC"}

package/dist/agents/business-logic-prompts.d.ts

@@ -0,0 +1,28 @@
+import type { AgentKind } from '@cat-factory/kernel';
+/** The agent kinds that make up the business-logic / domain-rules track. */
+export type BusinessLogicAgentKind = 'business-documenter' | 'business-reviewer';
+export declare const BUSINESS_LOGIC_AGENT_KINDS: readonly BusinessLogicAgentKind[];
+/**
+ * The kind that writes/updates the documentation. Repo-operating: the worker
+ * routes it to the container executor (see `CONTAINER_KINDS`) so it can read the
+ * checkout and commit the docs through a pull request.
+ */
+export declare const BUSINESS_DOCUMENTER_KIND: BusinessLogicAgentKind;
+/** The kind that reviews a change against the documented rules. Inline. */
+export declare const BUSINESS_REVIEWER_KIND: BusinessLogicAgentKind;
+/**
+ * Canonical in-repo home for the documentation this track produces and reviews
+ * against. Both prompts reference it so the documenter writes where the reviewer
+ * later looks. An established location already present in the repo wins over this
+ * default — the prompts tell the agents to respect one if they find it.
+ */
+export declare const BUSINESS_LOGIC_DOCS_DIR = "docs/business-logic";
+/** True when the agent kind is part of the business-logic / domain-rules track. */
+export declare function isBusinessLogicKind(kind: AgentKind): kind is BusinessLogicAgentKind;
+/**
+ * The built-out system (role) prompt for a business-logic agent kind, or
+ * `undefined` when the kind is not part of this track (so callers can fall
+ * through to the standard phases / acceptance track / mock builder / generic role).
+ */
+export declare function businessLogicSystemPrompt(kind: AgentKind): string | undefined;
+//# sourceMappingURL=business-logic-prompts.d.ts.map

package/dist/agents/business-logic-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-logic-prompts.d.ts","sourceRoot":"","sources":["../../src/agents/business-logic-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AA2BpD,4EAA4E;AAC5E,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,GAAG,mBAAmB,CAAA;AAEhF,eAAO,MAAM,0BAA0B,EAAE,SAAS,sBAAsB,EAGvE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,sBAA8C,CAAA;AAErF,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,EAAE,sBAA4C,CAAA;AAEjF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAkE5D,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,IAAI,sBAAsB,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7E"}

package/dist/agents/business-logic-prompts.js

@@ -0,0 +1,96 @@
+import { PLATFORM_DELIVERY_CONTRACT } from './ci-gate.js';
+import { STANDARDS_FOOTER } from './prompt-shared.js';
+export const BUSINESS_LOGIC_AGENT_KINDS = [
+    'business-documenter',
+    'business-reviewer',
+];
+/**
+ * The kind that writes/updates the documentation. Repo-operating: the worker
+ * routes it to the container executor (see `CONTAINER_KINDS`) so it can read the
+ * checkout and commit the docs through a pull request.
+ */
+export const BUSINESS_DOCUMENTER_KIND = 'business-documenter';
+/** The kind that reviews a change against the documented rules. Inline. */
+export const BUSINESS_REVIEWER_KIND = 'business-reviewer';
+/**
+ * Canonical in-repo home for the documentation this track produces and reviews
+ * against. Both prompts reference it so the documenter writes where the reviewer
+ * later looks. An established location already present in the repo wins over this
+ * default — the prompts tell the agents to respect one if they find it.
+ */
+export const BUSINESS_LOGIC_DOCS_DIR = 'docs/business-logic';
+// The documenter commits docs through a pull request, but the push + PR are the
+// platform's job — it has no push credentials. "Done" means the documentation is
+// written, committed and consistent with the code it describes; the platform then
+// pushes, opens the PR and drives CI per the shared PLATFORM_DELIVERY_CONTRACT.
+const DOCS_DELIVERY_GATE = [
+    'Definition of done: the documentation is written, committed, and consistent with the code it describes.',
+    PLATFORM_DELIVERY_CONTRACT,
+].join('\n');
+const SYSTEM_PROMPTS = {
+    'business-documenter': [
+        'You are a domain analyst owning the BUSINESS-LOGIC & DOMAIN-RULES DOCUMENTATION for a building block / service.',
+        'Read the actual implementation and capture the business rules, domain constraints and invariants the code really enforces as durable Markdown documentation committed to the repository.',
+        '',
+        'Ground every rule in the code — never invent rules:',
+        '- Derive rules from the real implementation: domain services and models, input validation, the conditions that raise domain errors (validation / conflict / not-found), default constants and thresholds, state-machine transitions, authorization checks and guards, and the behaviour the tests pin down.',
+        '- Document the WHAT and WHY a rule must hold (the constraint / invariant), not the incidental HOW it happens to be coded. Distinguish a genuine domain rule from an implementation detail.',
+        '- Every documented rule must be traceable to a concrete source location (file + symbol). If you cannot point at the code, do not assert the rule.',
+        '',
+        'Use the linked context documents as authoritative intent:',
+        '- Treat the linked context documents (requirements / RFCs / PRDs and any extra context attached to the block) as the statement of intended behaviour, and cite them as a rule’s rationale where they agree with the code.',
+        '- Where a context document and the code DISAGREE, do not silently pick one: document the rule as actually implemented and add a clearly marked "Doc/code mismatch" note describing the discrepancy so a human can resolve it.',
+        '',
+        'Be incremental and additive:',
+        `- First discover what is already documented: read the existing business-logic docs in the repository (look under \`${BUSINESS_LOGIC_DOCS_DIR}/\`; if a different location is already established, respect and use that one instead of creating a second home).`,
+        '- Update existing rules in place and preserve their stable ids; do not renumber or rewrite wholesale. Add new rules with new ids.',
+        '- When a rule no longer exists in the code, mark it as removed (with the reason / date) rather than silently deleting it, so its disappearance stays auditable.',
+        '',
+        'Structure the docs so they are diff-friendly and reviewable:',
+        `- Organise one document per domain area, mirroring the code’s own module boundaries, with an index that lists every area and the external context sources it draws on. Keep \`${BUSINESS_LOGIC_DOCS_DIR}/\` (or the established docs home) as the single root.`,
+        '- Give every rule a stable, human-readable id (e.g. `AREA-01`) and a declarative, testable statement, plus its source location, rationale, related constraints/invariants and notable edge cases. One rule = one checkable assertion; split compound rules.',
+        '- These docs are the baseline the business-reviewer agent later checks changes against, so precision and stable ids matter more than prose.',
+        '',
+        'Output the documentation files to commit (created or updated), refresh the index and the linked-context-sources list, and give a short summary of which rules were added, updated, removed, and any doc/code mismatches you flagged.',
+        '',
+        DOCS_DELIVERY_GATE,
+        '',
+        STANDARDS_FOOTER,
+    ].join('\n'),
+    'business-reviewer': [
+        'You are a domain-rules reviewer owning the BUSINESS-LOGIC REVIEW of a change.',
+        'Compare the proposed change against the previously written business-logic / domain-rules documentation and report where the change and the documented rules have diverged. Your report is the deliverable — produce it as your output so it is shown in the UI.',
+        '',
+        'What to review against what:',
+        `- The documented rules are the baseline: read them from the linked context documents and the prior steps’ output (the business-logic docs under \`${BUSINESS_LOGIC_DOCS_DIR}/\`, produced by the business-documenter). Map each documented rule to the part of the change it governs.`,
+        '- The change under review is the implementation / work described by the block intent and the earlier agents’ output in this run.',
+        '- If no business-logic documentation is available, say so plainly and recommend running the business-documenter first to establish a baseline; still flag the most likely rule changes, but mark that there is no baseline to check against.',
+        '',
+        'Classify every relevant change into exactly one bucket, and be conservative — do not invent violations:',
+        '- VIOLATION — the change contradicts a documented rule, constraint or invariant (e.g. removes a guard the docs say must hold, weakens a validation, changes a pinned default). Cite the rule id.',
+        '- UNDOCUMENTED CHANGE — new or altered business behaviour with no corresponding documented rule; the docs are now stale or incomplete. Note which rule area it belongs under.',
+        '- UNEXPECTED / SILENT DRIFT — a documented rule’s meaning changed while its surface looks the same (e.g. a comparison flipped from >= to >, an edge case handled differently, an error code changed). These are the dangerous ones: look specifically for semantic changes a casual read would miss. Cite the rule id.',
+        '- CONSISTENT — the change touches a documented rule but preserves it; report briefly as evidence of coverage.',
+        '- When you are unsure, mark it as drift with a confidence note and your reasoning rather than asserting a violation.',
+        '',
+        'Produce a structured Markdown report:',
+        '- Open with a one-line verdict (is the change safe to ship with respect to the documented rules?) and a summary count of findings per bucket.',
+        '- Then list the findings grouped by bucket, ordered violations first. For each: a short title, the documented rule it concerns (id + statement), what the change does, why it diverges, and a concrete suggested action (fix the change, or update the rule if the change is intended).',
+        '- Reference the specific code / rule each finding concerns; keep it actionable and free of invented problems. If the change is fully consistent, say so explicitly.',
+        '',
+        STANDARDS_FOOTER,
+    ].join('\n'),
+};
+/** True when the agent kind is part of the business-logic / domain-rules track. */
+export function isBusinessLogicKind(kind) {
+    return kind === 'business-documenter' || kind === 'business-reviewer';
+}
+/**
+ * The built-out system (role) prompt for a business-logic agent kind, or
+ * `undefined` when the kind is not part of this track (so callers can fall
+ * through to the standard phases / acceptance track / mock builder / generic role).
+ */
+export function businessLogicSystemPrompt(kind) {
+    return isBusinessLogicKind(kind) ? SYSTEM_PROMPTS[kind] : undefined;
+}
+//# sourceMappingURL=business-logic-prompts.js.map

package/dist/agents/business-logic-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-logic-prompts.js","sourceRoot":"","sources":["../../src/agents/business-logic-prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AA4BrD,MAAM,CAAC,MAAM,0BAA0B,GAAsC;IAC3E,qBAAqB;IACrB,mBAAmB;CACpB,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA2B,qBAAqB,CAAA;AAErF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAA2B,mBAAmB,CAAA;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAA;AAE5D,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,gFAAgF;AAChF,MAAM,kBAAkB,GAAG;IACzB,yGAAyG;IACzG,0BAA0B;CAC3B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,MAAM,cAAc,GAA2C;IAC7D,qBAAqB,EAAE;QACrB,iHAAiH;QACjH,0LAA0L;QAC1L,EAAE;QACF,qDAAqD;QACrD,6SAA6S;QAC7S,4LAA4L;QAC5L,mJAAmJ;QACnJ,EAAE;QACF,2DAA2D;QAC3D,2NAA2N;QAC3N,+NAA+N;QAC/N,EAAE;QACF,8BAA8B;QAC9B,sHAAsH,uBAAuB,mHAAmH;QAChQ,mIAAmI;QACnI,iKAAiK;QACjK,EAAE;QACF,8DAA8D;QAC9D,iLAAiL,uBAAuB,wDAAwD;QAChQ,6PAA6P;QAC7P,6IAA6I;QAC7I,EAAE;QACF,sOAAsO;QACtO,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,gBAAgB;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,mBAAmB,EAAE;QACnB,+EAA+E;QAC/E,iQAAiQ;QACjQ,EAAE;QACF,8BAA8B;QAC9B,qJAAqJ,uBAAuB,2GAA2G;QACvR,kIAAkI;QAClI,8OAA8O;QAC9O,EAAE;QACF,yGAAyG;QACzG,kMAAkM;QAClM,+KAA+K;QAC/K,wTAAwT;QACxT,+GAA+G;QAC/G,sHAAsH;QACtH,EAAE;QACF,uCAAuC;QACvC,+IAA+I;QAC/I,yRAAyR;QACzR,qKAAqK;QACrK,EAAE;QACF,gBAAgB;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAA;AAED,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,OAAO,IAAI,KAAK,qBAAqB,IAAI,IAAI,KAAK,mBAAmB,CAAA;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAe;IACvD,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACrE,CAAC"}

package/dist/agents/catalog.d.ts

@@ -0,0 +1,6 @@
+import type { AgentKind } from '@cat-factory/kernel';
+import type { AgentRunContext } from '@cat-factory/kernel';
+export declare function systemPromptFor(kind: AgentKind): string;
+/** Build the user prompt from the block context and the run so far. */
+export declare function userPromptFor(context: AgentRunContext): string;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/agents/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/agents/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAgC1D,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAUvD;AAgED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE9D"}

package/dist/agents/catalog.js

@@ -0,0 +1,168 @@
+import { acceptanceSystemPrompt, testApproachSection, e2eTargetSection, } from './prompts/acceptance.js';
+import { companionSystemPrompt } from './prompts/companion.js';
+import { companionTargets, isCompanionKind } from './kinds/companions.js';
+import { READ_ONLY_GUARDRAIL, isReadOnlyAgentKind } from './kinds/read-only.js';
+import { businessLogicSystemPrompt } from './prompts/business-logic.js';
+import { mockSystemPrompt } from './prompts/mock.js';
+import { testingSystemPrompt, testerEnvironmentSection } from './prompts/testing.js';
+import { registeredSystemPrompt, registeredUserPrompt } from './kinds/registry.js';
+import { traitGuidanceFor } from './kinds/traits.js';
+import { roleSystemPrompt } from './prompts/roles.js';
+import { environmentSection, linkedContextSection, phaseForKind, renderStandardUserPrompt, standardSystemPrompt, } from './prompts/standard.js';
+// Prompt construction for the built-in agent kinds: turns an agent kind + block
+// context into the system/user prompts handed to the LLM. This file is the
+// DISPATCHER — `baseSystemPromptFor` picks which track owns a kind; the prompt TEXT
+// for each track lives under ./prompts (the four standard phases design/build/review/
+// test in ./prompts/standard, the acceptance track in ./prompts/acceptance, the mock
+// builder in ./prompts/mock, the business-logic track in ./prompts/business-logic,
+// the tester/fixer track in ./prompts/testing, the companions in ./prompts/companion,
+// and the thin one-line roles + generic fallback in ./prompts/roles).
+export function systemPromptFor(kind) {
+    const base = baseSystemPromptFor(kind);
+    // Read-only kinds (architect, analysis) explore a real checkout but must never edit
+    // it; append the shared guardrail so the harness `/explore` run stays edit-free.
+    const withGuardrail = isReadOnlyAgentKind(kind) ? `${base}\n\n${READ_ONLY_GUARDRAIL}` : base;
+    // Fold in any guidance contributed by the kind's traits (e.g. the spec-aware kinds get
+    // the in-repo-spec reading guidance). Marker traits like `code-aware` add nothing here —
+    // their effect (folding the service's fragments) is applied by the execution engine.
+    const guidance = traitGuidanceFor(kind);
+    return guidance.length ? `${withGuardrail}\n\n${guidance.join('\n\n')}` : withGuardrail;
+}
+function baseSystemPromptFor(kind) {
+    // Companion kinds (reviewer, architect-companion, spec-companion, …) win over every
+    // built-in track: they grade a prior step's output and return a JSON rating.
+    const companion = companionSystemPrompt(kind);
+    if (companion)
+        return companion;
+    const phase = phaseForKind(kind);
+    if (phase)
+        return standardSystemPrompt(phase);
+    // The Tester/Fixer track runs in a container and returns a structured report /
+    // pushes fixes; it owns its own prompts rather than the generic `test` phase.
+    const testing = testingSystemPrompt(kind);
+    if (testing)
+        return testing;
+    const acceptance = acceptanceSystemPrompt(kind);
+    if (acceptance)
+        return acceptance;
+    const mock = mockSystemPrompt(kind);
+    if (mock)
+        return mock;
+    const businessLogic = businessLogicSystemPrompt(kind);
+    if (businessLogic)
+        return businessLogic;
+    // Custom kinds registered by a deployment (e.g. a proprietary org package) win over
+    // the generic fallback below, but never shadow the built-in tracks above.
+    const registered = registeredSystemPrompt(kind);
+    if (registered !== undefined)
+        return registered;
+    return roleSystemPrompt(kind);
+}
+/**
+ * When a human requested changes on this step's gated proposal, append their
+ * feedback and the previous proposal so the agent revises rather than restarts.
+ * Applied to every inline agent kind (standard-phase and generic alike).
+ */
+function withRevision(prompt, context) {
+    const revision = context.revision;
+    if (!revision)
+        return prompt;
+    const lines = [
+        prompt,
+        '',
+        'A human reviewed your previous proposal and requested changes. Revise that',
+        'proposal to address their feedback — keep what still holds, change what they',
+        'flagged. Do not start from scratch.',
+        '',
+        'Your previous proposal:',
+        revision.previousProposal || '(empty)',
+        '',
+        'Reviewer feedback:',
+        revision.feedback || '(none given)',
+    ];
+    // Per-block comments the reviewer left on specific parts of the proposal. Each
+    // quotes the exact text it targets, so the agent can locate and revise it.
+    if (revision.comments?.length) {
+        lines.push('', 'Comments on specific parts of your proposal:');
+        for (const c of revision.comments) {
+            lines.push('', 'On this part:', c.quotedSource || '(empty)', 'Comment:', c.body || '(none given)');
+        }
+    }
+    return lines.join('\n');
+}
+/** Build the user prompt from the block context and the run so far. */
+export function userPromptFor(context) {
+    return withRevision(buildBaseUserPrompt(context), context);
+}
+function buildBaseUserPrompt(context) {
+    // Standard phases get their built-out, templated user prompt.
+    const phase = phaseForKind(context.agentKind);
+    if (phase)
+        return renderStandardUserPrompt(phase, context);
+    // A registered custom kind may supply its own user prompt; otherwise it falls through
+    // to the generic block-context prompt below, like any other non-standard-phase kind.
+    const registered = registeredUserPrompt(context);
+    if (registered !== undefined)
+        return registered;
+    const { block, pipelineName, priorOutputs, decisions, resolvedDecision } = context;
+    const lines = [
+        `Pipeline: ${pipelineName}`,
+        `Block: ${block.title} (${block.type})`,
+        `Description: ${block.description || '(none provided)'}`,
+    ];
+    // A companion grades a specific preceding producer; name it explicitly so the
+    // model rates the right output rather than guessing among the prior-agent sections.
+    const companionTarget = companionTargetSection(context);
+    if (companionTarget)
+        lines.push(companionTarget);
+    const linked = linkedContextSection(context);
+    if (linked)
+        lines.push(linked);
+    const envSection = environmentSection(context);
+    if (envSection)
+        lines.push(envSection);
+    const approachSection = testApproachSection(context);
+    if (approachSection)
+        lines.push(approachSection);
+    const targetSection = e2eTargetSection(context);
+    if (targetSection)
+        lines.push(targetSection);
+    const testerEnv = testerEnvironmentSection(context);
+    if (testerEnv)
+        lines.push(testerEnv);
+    const allDecisions = resolvedDecision ? [...decisions, resolvedDecision] : decisions;
+    if (allDecisions.length) {
+        lines.push('', 'Resolved decisions:');
+        for (const d of allDecisions)
+            lines.push(`- ${d.question} → ${d.chosen}`);
+    }
+    if (priorOutputs.length) {
+        lines.push('', 'Work from earlier agents in this pipeline:');
+        for (const p of priorOutputs) {
+            lines.push(`### ${p.agentKind}`, p.output);
+        }
+    }
+    lines.push('', 'Produce your contribution. Be concise and concrete.');
+    return lines.join('\n');
+}
+/**
+ * For a companion step, name the specific producer output it must grade: the NEAREST
+ * preceding step whose kind is one of the companion's targets. Without this the model
+ * has to infer which "### <agentKind>" section is the one under review — fine when the
+ * producer is adjacent, ambiguous when other steps sit in between. Undefined for
+ * non-companion kinds or when no target output is present yet.
+ */
+function companionTargetSection(context) {
+    if (!isCompanionKind(context.agentKind))
+        return undefined;
+    const targets = companionTargets(context.agentKind);
+    for (let i = context.priorOutputs.length - 1; i >= 0; i--) {
+        const produced = context.priorOutputs[i];
+        if (targets.includes(produced.agentKind)) {
+            return (`You are grading the output of the \`${produced.agentKind}\` step (shown under ` +
+                `"### ${produced.agentKind}" below). Base your rating on THAT output.`);
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/agents/catalog.js.map

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

package/dist/agents/ci-gate.d.ts

@@ -0,0 +1,2 @@
+export declare const PLATFORM_DELIVERY_CONTRACT: string;
+//# sourceMappingURL=ci-gate.d.ts.map

package/dist/agents/ci-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-gate.d.ts","sourceRoot":"","sources":["../../src/agents/ci-gate.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,0BAA0B,QAW3B,CAAA"}

package/dist/agents/ci-gate.js

@@ -0,0 +1,33 @@
+// The shared delivery contract appended to every container coding-agent role that
+// works on a real checkout and ships its result through a pull request — the build
+// (standard-prompts), the runnable-tests / e2e (acceptance-prompts) and the docs
+// (business-logic-prompts) gates.
+//
+// These agents run inside an ephemeral container with NO push credentials: the
+// platform owns version control (push + PR) and the CI loop. Earlier prompts told
+// the agent to "open or update the pull request, push the fix, and wait for CI" —
+// but the agent cannot push (the GitHub token never enters its shell) and was never
+// meant to. That instruction was actively harmful: a capable model took it
+// literally, tried to `git push`, hit an auth wall, and then burned the ENTIRE run
+// probing env vars, decoding tokens and poking at git remotes instead of doing the
+// work (the run shipped zero changes and failed with "no file changes"); weaker
+// models simply gave up. This contract makes the boundary explicit so the agent
+// spends its whole budget on the change and never chases credentials.
+//
+// Commit ownership stays with the AGENT: only it knows which files are part of the
+// solution versus scratch scripts / build artifacts it created while exploring, so
+// it selects and commits its own work. The harness then pushes those commits and
+// opens the PR — it does not blindly `git add -A` (that would commit garbage).
+export const PLATFORM_DELIVERY_CONTRACT = [
+    'How your work ships — you commit, the platform delivers:',
+    '- Commit your changes yourself, with clear messages. YOU decide what belongs in each commit: stage only the files that are part of the solution, including any new source files you added. Do NOT commit build artifacts, dependencies, caches, logs, or the scratch/throwaway scripts you created while exploring. The platform will not add untracked files for you, so anything you leave uncommitted and untracked is lost.',
+    '- After you finish, the platform pushes your branch, opens or updates the pull request, runs CI, and — if a required check fails — dispatches a dedicated CI-fixer agent against this same branch. None of that is your job.',
+    '- Do NOT run `git push`, do NOT open or update pull requests, and do NOT use the `gh` CLI or call the GitHub API. You have no push credentials; attempting it only wastes the run.',
+    '- Spend your whole budget on the change itself. Do NOT probe the environment for credentials, tokens, git remotes or push access — that is never your task and never a problem you can fix.',
+    'Validate locally before you finish:',
+    '- Run the project build, the linters, and the tests relevant to your change, and get them passing locally for the code you touched.',
+    'Bound your effort — do not spin:',
+    '- This work MUST terminate; do not retry forever. Cap a fix → re-check cycle at a small number of attempts (about 5), and stop early if you have plainly used up the time or token budget for this phase.',
+    '- When you hit that bound still unresolved, STOP iterating — do not keep trying speculative fixes. Summarise what you changed, which problems remain, and the most likely root cause, then hand off for human review. A bounded, clearly-explained hand-off is an acceptable outcome; an endless loop that exhausts the budget is not.',
+].join('\n');
+//# sourceMappingURL=ci-gate.js.map

package/dist/agents/ci-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-gate.js","sourceRoot":"","sources":["../../src/agents/ci-gate.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,mFAAmF;AACnF,iFAAiF;AACjF,kCAAkC;AAClC,EAAE;AACF,+EAA+E;AAC/E,kFAAkF;AAClF,kFAAkF;AAClF,oFAAoF;AACpF,2EAA2E;AAC3E,mFAAmF;AACnF,mFAAmF;AACnF,gFAAgF;AAChF,gFAAgF;AAChF,sEAAsE;AACtE,EAAE;AACF,mFAAmF;AACnF,mFAAmF;AACnF,iFAAiF;AACjF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,0DAA0D;IAC1D,iaAAia;IACja,8NAA8N;IAC9N,oLAAoL;IACpL,6LAA6L;IAC7L,qCAAqC;IACrC,qIAAqI;IACrI,kCAAkC;IAClC,2MAA2M;IAC3M,wUAAwU;CACzU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA"}

package/dist/agents/companion-prompts.d.ts

@@ -0,0 +1,4 @@
+import type { AgentKind } from '@cat-factory/kernel';
+/** The companion system prompt for `kind`, or undefined when `kind` is not a companion. */
+export declare function companionSystemPrompt(kind: AgentKind): string | undefined;
+//# sourceMappingURL=companion-prompts.d.ts.map

package/dist/agents/companion-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-prompts.d.ts","sourceRoot":"","sources":["../../src/agents/companion-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAQpD,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAkBzE"}

package/dist/agents/companion-prompts.js

@@ -0,0 +1,27 @@
+import { companionFor } from './companions.js';
+// System prompt for a companion agent, parameterised by the producer kind it
+// reviews. The companion returns a single overall quality rating (0..1) plus prose
+// feedback and optional per-item challenges, all as JSON the engine validates with
+// `companionAssessmentSchema`.
+/** The companion system prompt for `kind`, or undefined when `kind` is not a companion. */
+export function companionSystemPrompt(kind) {
+    const def = companionFor(kind);
+    if (!def)
+        return undefined;
+    return [
+        `You are a meticulous quality companion reviewing the ${def.reviews} produced by the`,
+        `preceding ${def.targets.join(' / ')} step. Challenge it hard for correctness, quality,`,
+        'completeness and risk: call out gaps, missing cases, weak or untestable points, and',
+        'anything that would block confident downstream work. Then give a SINGLE overall quality',
+        'rating between 0 and 1 (1 = excellent and complete, 0 = unusable). Be a fair but demanding',
+        'critic — do not rubber-stamp.',
+        '',
+        'Respond with ONLY a JSON object of shape',
+        '{"rating":0.0,"summary":"…","comments":[{"anchorId":"…","body":"…"}]}: `rating` is the',
+        'overall score, `summary` is your justification plus the concrete changes the step should',
+        'make, and `comments` (optional) anchors specific challenges to an item id when the',
+        'reviewed output is structured (e.g. a spec requirement / acceptance-criterion id). No',
+        'prose outside the JSON, no code fences.',
+    ].join('\n');
+}
+//# sourceMappingURL=companion-prompts.js.map

package/dist/agents/companion-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-prompts.js","sourceRoot":"","sources":["../../src/agents/companion-prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,6EAA6E;AAC7E,mFAAmF;AACnF,mFAAmF;AACnF,+BAA+B;AAE/B,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACnD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,OAAO;QACL,wDAAwD,GAAG,CAAC,OAAO,kBAAkB;QACrF,aAAa,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,oDAAoD;QACxF,qFAAqF;QACrF,yFAAyF;QACzF,4FAA4F;QAC5F,+BAA+B;QAC/B,EAAE;QACF,0CAA0C;QAC1C,wFAAwF;QACxF,0FAA0F;QAC1F,oFAAoF;QACpF,uFAAuF;QACvF,yCAAyC;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}