@cat-factory/agents 0.6.0

package/dist/fragmentLibrary/fragment-catalog.js

@@ -0,0 +1,129 @@
+/** Built-in catalog fragment → resolved entry at the `builtin` tier. */
+function builtinToEntry(fragment) {
+    return {
+        id: fragment.id,
+        version: fragment.version,
+        title: fragment.title,
+        category: fragment.category ?? null,
+        summary: fragment.summary,
+        body: fragment.body,
+        appliesTo: fragment.appliesTo ?? null,
+        tags: fragment.tags ?? null,
+        source: fragment.source ?? null,
+        tier: 'builtin',
+    };
+}
+/** Managed record → resolved entry at its owner's tier. */
+function recordToEntry(record, tier) {
+    return {
+        id: record.fragmentId,
+        version: record.version,
+        title: record.title,
+        category: record.category,
+        summary: record.summary,
+        body: record.body,
+        appliesTo: record.appliesTo,
+        tags: record.tags,
+        source: record.sourceId && record.sourcePath !== null && record.sourceSha !== null
+            ? { sourceId: record.sourceId, path: record.sourcePath, sha: record.sourceSha }
+            : null,
+        tier,
+    };
+}
+/**
+ * Merge the three tiers into one catalog. Later tiers override earlier ones by
+ * stable id (workspace > account > built-in); a tombstoned record at any tier
+ * *suppresses* the id outright. Returns live entries sorted by id.
+ */
+export function mergeCatalog(builtins, accountRows, workspaceRows) {
+    const byId = new Map();
+    for (const b of builtins)
+        byId.set(b.id, builtinToEntry(b));
+    applyTier(byId, accountRows, 'account');
+    applyTier(byId, workspaceRows, 'workspace');
+    return [...byId.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+function applyTier(byId, rows, tier) {
+    for (const row of rows) {
+        if (row.deletedAt !== null) {
+            byId.delete(row.fragmentId); // tombstone: suppress the inherited/own entry
+        }
+        else {
+            byId.set(row.fragmentId, recordToEntry(row, tier));
+        }
+    }
+}
+/** Reduce a resolved entry to the metadata the selector reasons over (no body). */
+export function toSelectable(entry) {
+    const out = {
+        id: entry.id,
+        title: entry.title,
+        summary: entry.summary,
+    };
+    if (entry.category)
+        out.category = entry.category;
+    if (entry.tags && entry.tags.length)
+        out.tags = entry.tags;
+    if (entry.appliesTo)
+        out.appliesTo = entry.appliesTo;
+    return out;
+}
+/** A resolved entry → the wire {@link PromptFragment} (+ tier handled by caller). */
+export function entryToFragment(entry) {
+    const fragment = {
+        id: entry.id,
+        version: entry.version,
+        title: entry.title,
+        category: entry.category ?? '',
+        summary: entry.summary,
+        body: entry.body,
+    };
+    if (entry.appliesTo)
+        fragment.appliesTo = entry.appliesTo;
+    if (entry.tags && entry.tags.length)
+        fragment.tags = entry.tags;
+    if (entry.source)
+        fragment.source = entry.source;
+    return fragment;
+}
+/** Whether a fragment's `appliesTo` gate admits this run's block type / agent kind. */
+function passesAppliesTo(candidate, context) {
+    const applies = candidate.appliesTo;
+    if (!applies)
+        return true;
+    if (applies.blockTypes && !applies.blockTypes.includes(context.blockType))
+        return false;
+    if (applies.agentKinds && !applies.agentKinds.includes(context.agentKind))
+        return false;
+    return true;
+}
+/**
+ * The deterministic fallback selector (ADR 0006 §5): keep every candidate whose
+ * `appliesTo` gate admits the run, then — when any candidate carries tags —
+ * prefer those whose tags intersect the run's signals (block type, title,
+ * description, prior outputs). With no tags anywhere, the gate alone decides, so
+ * an offline/test run is fully deterministic and never blocks.
+ */
+export function selectDeterministic(candidates, context) {
+    const admitted = candidates.filter((c) => passesAppliesTo(c, context));
+    const haystack = [
+        context.blockType,
+        context.blockTitle,
+        context.blockDescription,
+        ...context.signals,
+    ]
+        .join(' ')
+        .toLowerCase();
+    const anyTagged = admitted.some((c) => c.tags && c.tags.length > 0);
+    if (!anyTagged)
+        return admitted.map((c) => c.id);
+    const tagMatched = admitted.filter((c) => {
+        if (!c.tags || c.tags.length === 0)
+            return true; // untagged fragments stay broadly applicable
+        return c.tags.some((tag) => haystack.includes(tag.toLowerCase()));
+    });
+    // If tag filtering excluded everything, fall back to the gate-admitted set so a
+    // run still gets its applicable standards rather than nothing.
+    return (tagMatched.length > 0 ? tagMatched : admitted).map((c) => c.id);
+}
+//# sourceMappingURL=fragment-catalog.js.map

package/dist/fragmentLibrary/fragment-catalog.js.map

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

package/dist/fragmentLibrary/fragment-source.logic.d.ts

@@ -0,0 +1,34 @@
+import type { FragmentAppliesTo } from '@cat-factory/kernel';
+/** A fragment parsed from a Markdown file's frontmatter + body. */
+export interface ParsedFragmentFile {
+    /** Explicit id from frontmatter (used to *shadow* a built-in); else undefined. */
+    id?: string;
+    title: string;
+    category?: string;
+    summary: string;
+    body: string;
+    tags?: string[];
+    appliesTo?: FragmentAppliesTo;
+}
+/** Slugify a repo file path into a stable, id-safe token (e.g. `backend/err.md` → `backend-err`). */
+export declare function slugFromPath(path: string): string;
+/** Whether a listing entry is a Markdown file we should parse. */
+export declare function isMarkdownFile(name: string): boolean;
+/**
+ * Stable digest of a source's file listing — sorted `path:sha` pairs hashed with
+ * FNV-1a. Stored as the source's `lastSyncedSha`; comparing it against a fresh
+ * listing is the cheap change check the resync badge uses, no per-file reads.
+ */
+export declare function digestListing(entries: {
+    path: string;
+    sha: string;
+}[]): string;
+/**
+ * Parse a Markdown guideline file. Frontmatter is the leading `--- … ---` block
+ * (a small YAML subset: `key: value`, inline `[a, b]` arrays, and nested
+ * `appliesTo`). Tolerant: a missing title defaults to a humanised filename, a
+ * missing summary to the first body line, so a sparse file still imports.
+ * Returns null only when there is no usable body at all.
+ */
+export declare function parseFragmentMarkdown(path: string, content: string): ParsedFragmentFile | null;
+//# sourceMappingURL=fragment-source.logic.d.ts.map

package/dist/fragmentLibrary/fragment-source.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-source.logic.d.ts","sourceRoot":"","sources":["../../src/fragmentLibrary/fragment-source.logic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAkB5D,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAA;CAC9B;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAY9E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAwB9F"}

package/dist/fragmentLibrary/fragment-source.logic.js

@@ -0,0 +1,172 @@
+// Pure logic for repo-sourced fragments (ADR 0006 §4): parse one Markdown file
+// with YAML frontmatter into a fragment, plus the small helpers the sync flow
+// needs (slugging an id from a path, digesting a directory listing for the
+// cheap "changed?" check). No I/O lives here so it is unit-testable.
+const BLOCK_TYPES = [
+    'frontend',
+    'service',
+    'api',
+    'database',
+    'queue',
+    'integration',
+    'external',
+    'environment',
+];
+/** Slugify a repo file path into a stable, id-safe token (e.g. `backend/err.md` → `backend-err`). */
+export function slugFromPath(path) {
+    return (path
+        .replace(/\.md$/i, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'fragment');
+}
+/** Whether a listing entry is a Markdown file we should parse. */
+export function isMarkdownFile(name) {
+    return /\.md$/i.test(name);
+}
+/**
+ * Stable digest of a source's file listing — sorted `path:sha` pairs hashed with
+ * FNV-1a. Stored as the source's `lastSyncedSha`; comparing it against a fresh
+ * listing is the cheap change check the resync badge uses, no per-file reads.
+ */
+export function digestListing(entries) {
+    const joined = entries
+        .map((e) => `${e.path}:${e.sha}`)
+        .sort()
+        .join('\n');
+    // FNV-1a (32-bit), hex. Sufficient for change detection (not cryptographic).
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < joined.length; i++) {
+        hash ^= joined.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+/**
+ * Parse a Markdown guideline file. Frontmatter is the leading `--- … ---` block
+ * (a small YAML subset: `key: value`, inline `[a, b]` arrays, and nested
+ * `appliesTo`). Tolerant: a missing title defaults to a humanised filename, a
+ * missing summary to the first body line, so a sparse file still imports.
+ * Returns null only when there is no usable body at all.
+ */
+export function parseFragmentMarkdown(path, content) {
+    const { frontmatter, body } = splitFrontmatter(content);
+    const fm = parseSimpleYaml(frontmatter);
+    const trimmedBody = body.trim();
+    const fallbackTitle = humanise(path);
+    const title = str(fm.title) ?? fallbackTitle;
+    const summary = str(fm.summary) ?? firstLine(trimmedBody) ?? title;
+    if (!trimmedBody && !summary)
+        return null;
+    const appliesTo = parseAppliesTo(fm.appliesTo);
+    const parsed = {
+        title,
+        summary,
+        body: trimmedBody || summary,
+    };
+    const id = str(fm.id);
+    if (id)
+        parsed.id = id;
+    const category = str(fm.category);
+    if (category)
+        parsed.category = category;
+    const tags = strArray(fm.tags);
+    if (tags.length)
+        parsed.tags = tags;
+    if (appliesTo)
+        parsed.appliesTo = appliesTo;
+    return parsed;
+}
+// --- internals ------------------------------------------------------------
+function splitFrontmatter(content) {
+    // Tolerate a leading BOM/whitespace before the opening fence.
+    const match = content.match(/^?\s*---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { frontmatter: '', body: content };
+    return { frontmatter: match[1] ?? '', body: match[2] ?? '' };
+}
+/** A deliberately small YAML subset: top-level `key: value` and one nested map. */
+function parseSimpleYaml(text) {
+    const out = {};
+    const lines = text.split(/\r?\n/);
+    let nestedKey = null;
+    let nested = null;
+    for (const raw of lines) {
+        if (!raw.trim() || raw.trim().startsWith('#'))
+            continue;
+        const indented = /^\s+/.test(raw);
+        const colon = raw.indexOf(':');
+        if (colon === -1)
+            continue;
+        const key = raw.slice(0, colon).trim();
+        const value = raw.slice(colon + 1).trim();
+        if (indented && nested) {
+            nested[key] = parseScalarOrArray(value);
+            continue;
+        }
+        if (value === '') {
+            // Opens a nested map (e.g. `appliesTo:`).
+            nestedKey = key;
+            nested = {};
+            out[key] = nested;
+        }
+        else {
+            nestedKey = null;
+            nested = null;
+            out[key] = parseScalarOrArray(value);
+        }
+    }
+    void nestedKey;
+    return out;
+}
+function parseScalarOrArray(value) {
+    const inline = value.match(/^\[(.*)\]$/);
+    if (inline) {
+        return inline[1]
+            .split(',')
+            .map((s) => unquote(s.trim()))
+            .filter((s) => s.length > 0);
+    }
+    return unquote(value);
+}
+function unquote(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+function str(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
+}
+function strArray(value) {
+    if (Array.isArray(value))
+        return value.map((v) => String(v).trim()).filter(Boolean);
+    const single = str(value);
+    return single ? [single] : [];
+}
+function parseAppliesTo(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const obj = value;
+    const blockTypes = strArray(obj.blockTypes).filter((t) => BLOCK_TYPES.includes(t));
+    const agentKinds = strArray(obj.agentKinds);
+    const out = {};
+    if (blockTypes.length)
+        out.blockTypes = blockTypes;
+    if (agentKinds.length)
+        out.agentKinds = agentKinds;
+    return out.blockTypes || out.agentKinds ? out : undefined;
+}
+function firstLine(body) {
+    const line = body
+        .split(/\r?\n/)
+        .map((l) => l.replace(/^[#>\-*\s]+/, '').trim())
+        .find((l) => l.length > 0);
+    return line ? line.slice(0, 200) : undefined;
+}
+function humanise(path) {
+    const base = path.split('/').pop() ?? path;
+    const stem = base.replace(/\.md$/i, '').replace(/[-_]+/g, ' ').trim();
+    return stem ? stem.charAt(0).toUpperCase() + stem.slice(1) : 'Fragment';
+}
+//# sourceMappingURL=fragment-source.logic.js.map

package/dist/fragmentLibrary/fragment-source.logic.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export { AiAgentExecutor, type AiAgentExecutorDependencies } from './agents/runtime/executor.js';
+export { type InlineWebSearchOptions, DEFAULT_INLINE_WEB_SEARCH_KINDS, DEFAULT_INLINE_WEB_SEARCH_MAX_USES, webResearchGuidanceFor, inlineWebSearchOptionsFromEnv, providerWebSearchTools, } from './agents/runtime/web-search.js';
+export { type AgentModelConfig, type AgentRouting, type StepModelResolvers, type StepModelInputs, resolveAgentConfig, resolveStepModelRef, resolveInlineModelRef, } from './agents/runtime/routing.js';
+export { systemPromptFor, userPromptFor } from './agents/catalog.js';
+export { TASK_ESTIMATOR_AGENT_KIND } from './agents/prompts/roles.js';
+export { type AgentKindDefinition, registerAgentKind, registerAgentKinds, registeredAgentKind, registeredAgentKinds, registeredKindRequiresContainer, registeredConfigContributions, clearRegisteredAgentKinds, } from './agents/kinds/registry.js';
+export { type AgentTrait, type AgentTraitDefinition, CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT, SPEC_AWARE_GUIDANCE, STANDARD_AGENT_TRAITS, registerAgentTrait, registerAgentTraits, registeredAgentTrait, clearRegisteredAgentTraits, assignAgentTraits, clearAssignedAgentTraits, traitsFor, hasTrait, traitGuidanceFor, } from './agents/kinds/traits.js';
+export { TESTER_ENVIRONMENT_CONFIG_ID, PLAYWRIGHT_E2E_TARGET_CONFIG_ID, configContributionsFor, configContributionCatalog, } from './agents/kinds/configs.js';
+export { isTestingKind, testingSystemPrompt, testerEnvironmentSection, } from './agents/prompts/testing.js';
+export { REVIEW_SYSTEM_PROMPT, REWORK_SYSTEM_PROMPT } from './agents/prompts/requirements.js';
+export { CLARITY_REVIEW_SYSTEM_PROMPT, CLARITY_REWORK_SYSTEM_PROMPT, } from './agents/prompts/clarity.js';
+export { type VersionedPrompt, type PromptId, PROMPT_VERSIONS, promptVersion, promptVersionLabel, } from './agents/kinds/versions.js';
+export { composeSystemPrompt, composeBlockSystemPrompt, type ComposableBlock, } from './agents/runtime/fragments.js';
+export { type StandardPhase, STANDARD_PHASES, STANDARD_PHASE_BY_KIND, phaseForKind, standardSystemPrompt, renderStandardUserPrompt, } from './agents/prompts/standard.js';
+export { type AcceptanceAgentKind, ACCEPTANCE_AGENT_KINDS, acceptanceSystemPrompt, isAcceptanceKind, testApproachSection, } from './agents/prompts/acceptance.js';
+export { type CompanionDefinition, COMPANIONS, isCompanionKind, companionFor, companionTargets, } from './agents/kinds/companions.js';
+export { companionSystemPrompt } from './agents/prompts/companion.js';
+export { READ_ONLY_AGENT_KINDS, READ_ONLY_GUARDRAIL, isReadOnlyAgentKind, } from './agents/kinds/read-only.js';
+export { MOCK_AGENT_KIND, isMockKind, mockSystemPrompt } from './agents/prompts/mock.js';
+export { type BusinessLogicAgentKind, BUSINESS_LOGIC_AGENT_KINDS, BUSINESS_DOCUMENTER_KIND, BUSINESS_REVIEWER_KIND, BUSINESS_LOGIC_DOCS_DIR, isBusinessLogicKind, businessLogicSystemPrompt, } from './agents/prompts/business-logic.js';
+export { PLATFORM_DELIVERY_CONTRACT } from './agents/prompts/delivery-contract.js';
+export { FINAL_ANSWER_IN_REPLY, STANDARDS_FOOTER } from './agents/prompts/shared.js';
+export { CompositeModelProvider, InstrumentedModelProvider, catFactoryObservability, type InlineObservabilityContext, type ModelResolver, type ProviderRegistry, anthropicResolver, baseProviderRegistry, cloudflareRestResolver, openAiCompatibleResolver, openAiResolver, DEEPSEEK_BASE_URL, DEFAULT_OPENAI_COMPATIBLE_BASE_URLS, MOONSHOT_BASE_URL, OPENAI_BASE_URL, OPENROUTER_BASE_URL, QWEN_BASE_URL, type CachePolicy, cachedTokensFromUsage, inlineCacheProviderOptions, promptCacheParams, providerCachePolicy, } from './providers/index.js';
+export { FragmentLibraryService, type FragmentLibraryServiceDependencies, } from './fragmentLibrary/FragmentLibraryService.js';
+export { FragmentSourceService, type FragmentSourceServiceDependencies, type ResolveFragmentInstallationId, } from './fragmentLibrary/FragmentSourceService.js';
+export { DeterministicFragmentSelector } from './fragmentLibrary/DeterministicFragmentSelector.js';
+export { LlmFragmentSelector, type LlmFragmentSelectorDependencies, } from './fragmentLibrary/LlmFragmentSelector.js';
+export { type ResolvedCatalogEntry, mergeCatalog, toSelectable, entryToFragment, selectDeterministic, } from './fragmentLibrary/fragment-catalog.js';
+export * as fragmentSourceLogic from './fragmentLibrary/fragment-source.logic.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,43 @@
+export { AiAgentExecutor } from './agents/runtime/executor.js';
+export { DEFAULT_INLINE_WEB_SEARCH_KINDS, DEFAULT_INLINE_WEB_SEARCH_MAX_USES, webResearchGuidanceFor, inlineWebSearchOptionsFromEnv, providerWebSearchTools, } from './agents/runtime/web-search.js';
+export { resolveAgentConfig, resolveStepModelRef, resolveInlineModelRef, } from './agents/runtime/routing.js';
+export { systemPromptFor, userPromptFor } from './agents/catalog.js';
+export { TASK_ESTIMATOR_AGENT_KIND } from './agents/prompts/roles.js';
+// Installation-level extension point for custom agent kinds (mirrors the model-provider
+// registry seam): a deployment registers extra kinds at startup and the prompt catalog +
+// the Worker's executor routing pick them up.
+export { registerAgentKind, registerAgentKinds, registeredAgentKind, registeredAgentKinds, registeredKindRequiresContainer, registeredConfigContributions, clearRegisteredAgentKinds, } from './agents/kinds/registry.js';
+// Agent capability traits (standard + custom). `code-aware` gates the engine's folding
+// of the service's best-practice fragments; `spec-aware` appends the in-repo-spec guidance.
+export { CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT, SPEC_AWARE_GUIDANCE, STANDARD_AGENT_TRAITS, registerAgentTrait, registerAgentTraits, registeredAgentTrait, clearRegisteredAgentTraits, assignAgentTraits, clearAssignedAgentTraits, traitsFor, hasTrait, traitGuidanceFor, } from './agents/kinds/traits.js';
+// Agent configuration-contribution catalog (the descriptors surfaced on task
+// creation / inspector, frozen once the contributing step runs).
+export { TESTER_ENVIRONMENT_CONFIG_ID, PLAYWRIGHT_E2E_TARGET_CONFIG_ID, configContributionsFor, configContributionCatalog, } from './agents/kinds/configs.js';
+// Tester / Fixer track prompts + helpers.
+export { isTestingKind, testingSystemPrompt, testerEnvironmentSection, } from './agents/prompts/testing.js';
+// Requirements-review prompt text + its versioned-prompt registry.
+export { REVIEW_SYSTEM_PROMPT, REWORK_SYSTEM_PROMPT } from './agents/prompts/requirements.js';
+// Clarity-review (bug-report triage) prompt text.
+export { CLARITY_REVIEW_SYSTEM_PROMPT, CLARITY_REWORK_SYSTEM_PROMPT, } from './agents/prompts/clarity.js';
+export { PROMPT_VERSIONS, promptVersion, promptVersionLabel, } from './agents/kinds/versions.js';
+export { composeSystemPrompt, composeBlockSystemPrompt, } from './agents/runtime/fragments.js';
+export { STANDARD_PHASES, STANDARD_PHASE_BY_KIND, phaseForKind, standardSystemPrompt, renderStandardUserPrompt, } from './agents/prompts/standard.js';
+export { ACCEPTANCE_AGENT_KINDS, acceptanceSystemPrompt, isAcceptanceKind, testApproachSection, } from './agents/prompts/acceptance.js';
+export { COMPANIONS, isCompanionKind, companionFor, companionTargets, } from './agents/kinds/companions.js';
+export { companionSystemPrompt } from './agents/prompts/companion.js';
+export { READ_ONLY_AGENT_KINDS, READ_ONLY_GUARDRAIL, isReadOnlyAgentKind, } from './agents/kinds/read-only.js';
+export { MOCK_AGENT_KIND, isMockKind, mockSystemPrompt } from './agents/prompts/mock.js';
+export { BUSINESS_LOGIC_AGENT_KINDS, BUSINESS_DOCUMENTER_KIND, BUSINESS_REVIEWER_KIND, BUSINESS_LOGIC_DOCS_DIR, isBusinessLogicKind, businessLogicSystemPrompt, } from './agents/prompts/business-logic.js';
+export { PLATFORM_DELIVERY_CONTRACT } from './agents/prompts/delivery-contract.js';
+export { FINAL_ANSWER_IN_REPLY, STANDARDS_FOOTER } from './agents/prompts/shared.js';
+// The generic AI provisioning facade: a mixable provider registry + the base,
+// runtime-neutral resolvers. Optional/heavier backends ship as their own packages
+// (e.g. @cat-factory/provider-bedrock) and are mixed into a CompositeModelProvider.
+export { CompositeModelProvider, InstrumentedModelProvider, catFactoryObservability, anthropicResolver, baseProviderRegistry, cloudflareRestResolver, openAiCompatibleResolver, openAiResolver, DEEPSEEK_BASE_URL, DEFAULT_OPENAI_COMPATIBLE_BASE_URLS, MOONSHOT_BASE_URL, OPENAI_BASE_URL, OPENROUTER_BASE_URL, QWEN_BASE_URL, cachedTokensFromUsage, inlineCacheProviderOptions, promptCacheParams, providerCachePolicy, } from './providers/index.js';
+export { FragmentLibraryService, } from './fragmentLibrary/FragmentLibraryService.js';
+export { FragmentSourceService, } from './fragmentLibrary/FragmentSourceService.js';
+export { DeterministicFragmentSelector } from './fragmentLibrary/DeterministicFragmentSelector.js';
+export { LlmFragmentSelector, } from './fragmentLibrary/LlmFragmentSelector.js';
+export { mergeCatalog, toSelectable, entryToFragment, selectDeterministic, } from './fragmentLibrary/fragment-catalog.js';
+export * as fragmentSourceLogic from './fragmentLibrary/fragment-source.logic.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/providers/cache.d.ts

@@ -0,0 +1,22 @@
+export type CachePolicy = 'auto-prefix' | 'explicit-anthropic' | 'none';
+/** How `provider` caches prompt prefixes. The single source of truth for both paths. */
+export declare function providerCachePolicy(provider: string): CachePolicy;
+/**
+ * Extra OpenAI Chat Completions params that route a multi-turn conversation to the
+ * same cached prefix, for the in-container proxy path. Only OpenAI documents a
+ * routing key (`prompt_cache_key`); DeepSeek/Qwen cache automatically on the prefix
+ * with no param (so we send none rather than risk a strict endpoint rejecting an
+ * unknown field), and Anthropic's cache is explicit (handled on the inline path).
+ * `cacheKey` should be stable per conversation (e.g. the execution id).
+ */
+export declare function promptCacheParams(provider: string, cacheKey: string | null | undefined): Record<string, unknown>;
+/**
+ * Vercel-AI `providerOptions` that enable prompt caching for the inline path. Only
+ * Anthropic needs an explicit opt-in (cache the system + tools prefix as ephemeral);
+ * the auto-prefix providers need nothing beyond a stable prompt. Empty when the
+ * provider caches automatically or not at all.
+ */
+export declare function inlineCacheProviderOptions(provider: string): Record<string, unknown>;
+/** The cached-input-token count a provider reports in its usage, across the field names they use. */
+export declare function cachedTokensFromUsage(usage: unknown): number;
+//# sourceMappingURL=cache.d.ts.map

package/dist/providers/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/providers/cache.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,WAAW,GAInB,aAAa,GAEb,oBAAoB,GAEpB,MAAM,CAAA;AAEV,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAWjE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKpF;AAED,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAY5D"}

package/dist/providers/cache.js

@@ -0,0 +1,64 @@
+// Prompt-caching policy, shared by BOTH AI-call paths so they treat a provider the
+// same way: the in-container path (Pi → the LLM proxy, OpenAI Chat Completions over
+// HTTP) and the inline path (the Vercel AI SDK via the ModelProvider port). A
+// container agent re-sends its whole growing prompt every turn, so on the providers
+// that cache it the stable prefix should be a cache hit rather than re-billed input
+// — but only if we (a) keep the prefix byte-stable and (b) give the provider the
+// hint it needs. This module is the single source of truth for "how does provider X
+// cache", so neither path hard-codes provider ids.
+/** How `provider` caches prompt prefixes. The single source of truth for both paths. */
+export function providerCachePolicy(provider) {
+    switch (provider) {
+        case 'openai':
+        case 'deepseek':
+        case 'qwen':
+            return 'auto-prefix';
+        case 'anthropic':
+            return 'explicit-anthropic';
+        default:
+            return 'none';
+    }
+}
+/**
+ * Extra OpenAI Chat Completions params that route a multi-turn conversation to the
+ * same cached prefix, for the in-container proxy path. Only OpenAI documents a
+ * routing key (`prompt_cache_key`); DeepSeek/Qwen cache automatically on the prefix
+ * with no param (so we send none rather than risk a strict endpoint rejecting an
+ * unknown field), and Anthropic's cache is explicit (handled on the inline path).
+ * `cacheKey` should be stable per conversation (e.g. the execution id).
+ */
+export function promptCacheParams(provider, cacheKey) {
+    if (cacheKey && provider === 'openai')
+        return { prompt_cache_key: cacheKey };
+    return {};
+}
+/**
+ * Vercel-AI `providerOptions` that enable prompt caching for the inline path. Only
+ * Anthropic needs an explicit opt-in (cache the system + tools prefix as ephemeral);
+ * the auto-prefix providers need nothing beyond a stable prompt. Empty when the
+ * provider caches automatically or not at all.
+ */
+export function inlineCacheProviderOptions(provider) {
+    if (providerCachePolicy(provider) === 'explicit-anthropic') {
+        return { anthropic: { cacheControl: { type: 'ephemeral' } } };
+    }
+    return {};
+}
+/** The cached-input-token count a provider reports in its usage, across the field names they use. */
+export function cachedTokensFromUsage(usage) {
+    if (typeof usage !== 'object' || usage === null)
+        return 0;
+    const u = usage;
+    // OpenAI: prompt_tokens_details.cached_tokens. DeepSeek: prompt_cache_hit_tokens.
+    const details = u.prompt_tokens_details;
+    if (typeof details === 'object' && details !== null) {
+        const cached = details.cached_tokens;
+        if (typeof cached === 'number' && cached >= 0)
+            return cached;
+    }
+    const hit = u.prompt_cache_hit_tokens;
+    if (typeof hit === 'number' && hit >= 0)
+        return hit;
+    return 0;
+}
+//# sourceMappingURL=cache.js.map

package/dist/providers/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/providers/cache.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,oFAAoF;AACpF,8EAA8E;AAC9E,oFAAoF;AACpF,oFAAoF;AACpF,iFAAiF;AACjF,oFAAoF;AACpF,mDAAmD;AAYnD,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,aAAa,CAAA;QACtB,KAAK,WAAW;YACd,OAAO,oBAAoB,CAAA;QAC7B;YACE,OAAO,MAAM,CAAA;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,QAAmC;IAEnC,IAAI,QAAQ,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAA;IAC5E,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,IAAI,mBAAmB,CAAC,QAAQ,CAAC,KAAK,oBAAoB,EAAE,CAAC;QAC3D,OAAO,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAA;IAC/D,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,CAAC,CAAA;IACzD,MAAM,CAAC,GAAG,KAAgC,CAAA;IAC1C,kFAAkF;IAClF,MAAM,OAAO,GAAG,CAAC,CAAC,qBAAqB,CAAA;IACvC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,MAAM,GAAI,OAAmC,CAAC,aAAa,CAAA;QACjE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC;YAAE,OAAO,MAAM,CAAA;IAC9D,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,uBAAuB,CAAA;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,GAAG,CAAA;IACnD,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/providers/endpoints.d.ts

@@ -0,0 +1,8 @@
+export declare const QWEN_BASE_URL = "https://dashscope-intl.aliyuncs.com/compatible-mode/v1";
+export declare const DEEPSEEK_BASE_URL = "https://api.deepseek.com/v1";
+export declare const MOONSHOT_BASE_URL = "https://api.moonshot.ai/v1";
+export declare const OPENAI_BASE_URL = "https://api.openai.com/v1";
+export declare const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+/** Built-in base URLs for the OpenAI-compatible providers, keyed by provider id. */
+export declare const DEFAULT_OPENAI_COMPATIBLE_BASE_URLS: Readonly<Record<string, string>>;
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/providers/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/providers/endpoints.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,2DAA2D,CAAA;AACrF,eAAO,MAAM,iBAAiB,gCAAgC,CAAA;AAC9D,eAAO,MAAM,iBAAiB,+BAA+B,CAAA;AAC7D,eAAO,MAAM,eAAe,8BAA8B,CAAA;AAI1D,eAAO,MAAM,mBAAmB,iCAAiC,CAAA;AAEjE,oFAAoF;AACpF,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhF,CAAA"}

package/dist/providers/endpoints.js

@@ -0,0 +1,23 @@
+// The OpenAI-compatible chat endpoints behind the direct-provider flavours.
+// DashScope (Alibaba/Qwen), DeepSeek and Moonshot (Kimi) all expose the OpenAI
+// `/chat/completions` shape, so both the Vercel-AI model provider and the container
+// LLM proxy resolve them from the same base URLs and keys — one source of truth for
+// "where does provider X live". Each is overridable per deployment (a self-hosted
+// gateway, a regional endpoint, or a local stub in tests).
+export const QWEN_BASE_URL = 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1';
+export const DEEPSEEK_BASE_URL = 'https://api.deepseek.com/v1';
+export const MOONSHOT_BASE_URL = 'https://api.moonshot.ai/v1';
+export const OPENAI_BASE_URL = 'https://api.openai.com/v1';
+// OpenRouter is a single OpenAI-compatible gateway to 300+ models. LiteLLM has NO
+// built-in default: it is an operator-hosted gateway, so its base URL comes from the
+// deployment's LITELLM_BASE_URL override (there is no public endpoint to default to).
+export const OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1';
+/** Built-in base URLs for the OpenAI-compatible providers, keyed by provider id. */
+export const DEFAULT_OPENAI_COMPATIBLE_BASE_URLS = {
+    qwen: QWEN_BASE_URL,
+    deepseek: DEEPSEEK_BASE_URL,
+    moonshot: MOONSHOT_BASE_URL,
+    openai: OPENAI_BASE_URL,
+    openrouter: OPENROUTER_BASE_URL,
+};
+//# sourceMappingURL=endpoints.js.map

package/dist/providers/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../src/providers/endpoints.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,+EAA+E;AAC/E,oFAAoF;AACpF,oFAAoF;AACpF,kFAAkF;AAClF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,wDAAwD,CAAA;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG,6BAA6B,CAAA;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAA4B,CAAA;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,2BAA2B,CAAA;AAC1D,kFAAkF;AAClF,qFAAqF;AACrF,sFAAsF;AACtF,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAA;AAEjE,oFAAoF;AACpF,MAAM,CAAC,MAAM,mCAAmC,GAAqC;IACnF,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,iBAAiB;IAC3B,QAAQ,EAAE,iBAAiB;IAC3B,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,mBAAmB;CAChC,CAAA"}

package/dist/providers/index.d.ts

@@ -0,0 +1,6 @@
+export { CompositeModelProvider, type ModelResolver, type ProviderRegistry } from './registry.js';
+export { InstrumentedModelProvider, catFactoryObservability, type InlineObservabilityContext, } from './instrumented.js';
+export { anthropicResolver, baseProviderRegistry, cloudflareRestResolver, openAiCompatibleResolver, openAiResolver, } from './resolvers.js';
+export { DEEPSEEK_BASE_URL, DEFAULT_OPENAI_COMPATIBLE_BASE_URLS, MOONSHOT_BASE_URL, OPENAI_BASE_URL, OPENROUTER_BASE_URL, QWEN_BASE_URL, } from './endpoints.js';
+export { type CachePolicy, cachedTokensFromUsage, inlineCacheProviderOptions, promptCacheParams, providerCachePolicy, } from './cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACjG,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,GACf,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,iBAAiB,EACjB,mCAAmC,EACnC,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,aAAa,GACd,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,KAAK,WAAW,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAA"}

package/dist/providers/index.js

@@ -0,0 +1,6 @@
+export { CompositeModelProvider } from './registry.js';
+export { InstrumentedModelProvider, catFactoryObservability, } from './instrumented.js';
+export { anthropicResolver, baseProviderRegistry, cloudflareRestResolver, openAiCompatibleResolver, openAiResolver, } from './resolvers.js';
+export { DEEPSEEK_BASE_URL, DEFAULT_OPENAI_COMPATIBLE_BASE_URLS, MOONSHOT_BASE_URL, OPENAI_BASE_URL, OPENROUTER_BASE_URL, QWEN_BASE_URL, } from './endpoints.js';
+export { cachedTokensFromUsage, inlineCacheProviderOptions, promptCacheParams, providerCachePolicy, } from './cache.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAA6C,MAAM,eAAe,CAAA;AACjG,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GAExB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,GACf,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,iBAAiB,EACjB,mCAAmC,EACnC,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,aAAa,GACd,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAEL,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAA"}