@agentproto/corpus 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/chunk-3P23OX5X.mjs

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/corpus v0.1.0-alpha
+ * Composition of AIP-10/12/18/9/15/41 — autonomous knowledge-improvement kit.
+ */
+
+var REFINED_KIND_SCHEMA = z.enum([
+  "principle",
+  "pattern",
+  "critique",
+  "summary",
+  "example"
+]);
+function isRefinedKind(value) {
+  return REFINED_KIND_SCHEMA.safeParse(value).success;
+}
+var ENTRY_FRONTMATTER = z.object({
+  schema: z.string().optional().catch(void 0),
+  slug: z.string().optional().catch(void 0),
+  kind: z.string().optional().catch(void 0),
+  title: z.string().optional().catch(void 0),
+  sources: z.array(z.string()).optional().catch(void 0),
+  confidence: z.number().optional().catch(void 0),
+  tags: z.array(z.string()).optional().catch(void 0),
+  metadata: z.object({
+    corpus: z.object({
+      access: z.string().optional().catch(void 0),
+      status: z.string().optional().catch(void 0),
+      // Resolved provenance written at promote time — the origins this
+      // entry was distilled from, so a recall can cite the real source.
+      source_refs: z.array(
+        z.object({
+          id: z.string(),
+          url: z.string().optional().catch(void 0),
+          title: z.string().optional().catch(void 0),
+          authority: z.string().optional().catch(void 0),
+          language: z.string().optional().catch(void 0)
+        }).loose()
+      ).optional().catch(void 0)
+    }).loose().optional().catch(void 0)
+  }).loose().optional().catch(void 0)
+}).loose();
+async function resolveKnowledge(opts) {
+  const { fs, query, allowedAccess } = opts;
+  const wantTags = new Set((query.tags ?? []).map((t) => t.toLowerCase()));
+  const wantKinds = query.kinds ? new Set(query.kinds) : null;
+  let rels;
+  try {
+    rels = await fs.walk("entries");
+  } catch {
+    return [];
+  }
+  const hits = [];
+  for (const rel of rels) {
+    if (!rel.endsWith(".md")) continue;
+    const path = `entries/${rel}`;
+    let parsed;
+    try {
+      parsed = matter(await fs.readFile(path));
+    } catch {
+      continue;
+    }
+    const fm = ENTRY_FRONTMATTER.parse(parsed.data);
+    if (fm.schema !== "knowledge.entry/v1") continue;
+    if (fm.metadata?.corpus?.status === "archived") continue;
+    const kind = fm.kind ?? "";
+    if (wantKinds && !(isRefinedKind(kind) && wantKinds.has(kind))) continue;
+    const tags = fm.tags ?? [];
+    if (wantTags.size > 0 && !tags.some((t) => wantTags.has(t.toLowerCase()))) continue;
+    const access = fm.metadata?.corpus?.access;
+    if (allowedAccess && access && !allowedAccess.has(access)) continue;
+    hits.push({
+      slug: fm.slug ?? path,
+      kind,
+      title: fm.title ?? "",
+      body: parsed.content.trim(),
+      sources: fm.sources ?? [],
+      ...fm.metadata?.corpus?.source_refs ? { sourceRefs: fm.metadata.corpus.source_refs } : {},
+      confidence: fm.confidence ?? 0,
+      tags,
+      ...access ? { access } : {},
+      path
+    });
+  }
+  hits.sort((a, b) => b.confidence - a.confidence);
+  return query.maxResults !== void 0 ? hits.slice(0, query.maxResults) : hits;
+}
+
+export { REFINED_KIND_SCHEMA, isRefinedKind, resolveKnowledge };
+//# sourceMappingURL=chunk-3P23OX5X.mjs.map
+//# sourceMappingURL=chunk-3P23OX5X.mjs.map

package/dist/chunk-3P23OX5X.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/distill/types.ts","../src/knowledge/resolve.ts"],"names":["z"],"mappings":"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","file":"chunk-3P23OX5X.mjs","sourcesContent":["/**\n * Distill — raw source → refined knowledge entries (the KNOWLEDGE layer).\n *\n * The \"simple mode\": no graph engine. A refined entry is just an AIP-10\n * `knowledge.entry/v1` markdown file whose `sources: [<id>]` frontmatter\n * IS the `derivedFrom` provenance edge. The filesystem refs ARE the graph;\n * a graph engine (mind-graph / gbrain) is an optional index added later.\n *\n * The kit owns the contract + the runner (what to write, where, with what\n * provenance). The LLM that actually extracts insights is an injected\n * `DistillPort` — host-supplied (Claude/OpenAI), so the kit stays pure.\n */\n\nimport { z } from \"zod\"\n\n/** Generic AIP-10 refined kinds — NOT domain-specific. */\nexport const REFINED_KIND_SCHEMA = z.enum([\n  \"principle\",\n  \"pattern\",\n  \"critique\",\n  \"summary\",\n  \"example\",\n])\n\nexport type RefinedKind = z.infer<typeof REFINED_KIND_SCHEMA>\n\n/** Runtime guard — narrows an untyped value to RefinedKind without a cast. */\nexport function isRefinedKind(value: unknown): value is RefinedKind {\n  return REFINED_KIND_SCHEMA.safeParse(value).success\n}\n\nexport interface DistilledItem {\n  readonly kind: RefinedKind\n  readonly title: string\n  /** The refined insight, markdown. Self-contained, not a quote dump. */\n  readonly body: string\n  /** 0–1 model confidence. */\n  readonly confidence?: number\n  readonly tags?: readonly string[]\n}\n\nexport interface DistillInput {\n  readonly title: string\n  readonly body: string\n  readonly tags?: readonly string[]\n  /** Hint for the kinds worth extracting (e.g. only principles). */\n  readonly kinds?: readonly RefinedKind[]\n}\n\n/**\n * The LLM boundary. Given a raw source, return refined items. Injected by\n * the host (corpus-cli `AnthropicDistiller`, a Guilde operator, …) so the\n * kit takes no model dependency.\n */\nexport interface DistillPort {\n  distill(input: DistillInput): Promise<readonly DistilledItem[]>\n}\n","/**\n * resolveKnowledge — the `knowledge:` binding resolver (KNOWLEDGE→SKILL link).\n *\n * Filesystem-first: a skill's binding (`{ tags, kinds }`) is resolved against\n * the refined `entries/**​/*.md` on disk — no graph engine. Returns the\n * matching refined entries (with their `sources:` provenance), filtered by the\n * caller's access scope so an operator never sees knowledge above its clearance.\n *\n * A graph engine (mind-graph / gbrain) can later replace this scan with\n * traversal/activation behind the SAME signature — the binding contract is stable.\n */\n\nimport matter from \"gray-matter\"\nimport { z } from \"zod\"\nimport type { FsPort } from \"../ports/fs.port.js\"\nimport { isRefinedKind, type RefinedKind } from \"../distill/types.js\"\n\n/**\n * Lenient zod view of an AIP-10 entry's frontmatter. Every field `.catch`es to\n * undefined so a malformed value degrades gracefully (the entry is still\n * parsed, the bad field is simply absent) — matching the previous defensive\n * hand-narrowing, but typed and cast-free.\n */\nconst ENTRY_FRONTMATTER = z\n  .object({\n    schema: z.string().optional().catch(undefined),\n    slug: z.string().optional().catch(undefined),\n    kind: z.string().optional().catch(undefined),\n    title: z.string().optional().catch(undefined),\n    sources: z.array(z.string()).optional().catch(undefined),\n    confidence: z.number().optional().catch(undefined),\n    tags: z.array(z.string()).optional().catch(undefined),\n    metadata: z\n      .object({\n        corpus: z\n          .object({\n            access: z.string().optional().catch(undefined),\n            status: z.string().optional().catch(undefined),\n            // Resolved provenance written at promote time — the origins this\n            // entry was distilled from, so a recall can cite the real source.\n            source_refs: z\n              .array(\n                z\n                  .object({\n                    id: z.string(),\n                    url: z.string().optional().catch(undefined),\n                    title: z.string().optional().catch(undefined),\n                    authority: z.string().optional().catch(undefined),\n                    language: z.string().optional().catch(undefined),\n                  })\n                  .loose()\n              )\n              .optional()\n              .catch(undefined),\n          })\n          .loose()\n          .optional()\n          .catch(undefined),\n      })\n      .loose()\n      .optional()\n      .catch(undefined),\n  })\n  .loose()\n\nexport interface CorpusEntryQuery {\n  /** Match entries sharing ANY of these tags. Empty/absent = no tag filter. */\n  readonly tags?: readonly string[]\n  /** Restrict to these refined kinds. Empty/absent = all kinds. */\n  readonly kinds?: readonly RefinedKind[]\n  /** Cap results (highest-confidence first). */\n  readonly maxResults?: number\n}\n\n/** A resolved origin an entry was distilled from (id + where to find it). */\nexport interface SourceRef {\n  readonly id: string\n  readonly url?: string\n  readonly title?: string\n  readonly authority?: string\n  readonly language?: string\n}\n\nexport interface ResolvedEntry {\n  readonly slug: string\n  readonly kind: string\n  readonly title: string\n  readonly body: string\n  /** Provenance — the raw source ids this entry was derived from. */\n  readonly sources: readonly string[]\n  /** Resolved provenance — id + url + title for each source, when available. */\n  readonly sourceRefs?: readonly SourceRef[]\n  readonly confidence: number\n  readonly tags: readonly string[]\n  readonly access?: string\n  readonly path: string\n}\n\nexport interface ResolveKnowledgeOptions {\n  readonly fs: FsPort\n  readonly query: CorpusEntryQuery\n  /**\n   * Access scopes the caller (operator) is cleared for. An entry passes if it\n   * has no access (public) or its access ∈ this set. Omit = no access filter.\n   */\n  readonly allowedAccess?: ReadonlySet<string>\n}\n\nexport async function resolveKnowledge(\n  opts: ResolveKnowledgeOptions\n): Promise<readonly ResolvedEntry[]> {\n  const { fs, query, allowedAccess } = opts\n  const wantTags = new Set((query.tags ?? []).map(t => t.toLowerCase()))\n  const wantKinds = query.kinds ? new Set(query.kinds) : null\n\n  let rels: readonly string[]\n  try {\n    rels = await fs.walk(\"entries\")\n  } catch {\n    return []\n  }\n\n  const hits: ResolvedEntry[] = []\n  for (const rel of rels) {\n    if (!rel.endsWith(\".md\")) continue\n    // `walk(\"entries\")` yields paths relative to the entries/ dir; readFile\n    // resolves against the workspace root, so re-prefix.\n    const path = `entries/${rel}`\n    let parsed\n    try {\n      parsed = matter(await fs.readFile(path))\n    } catch {\n      continue\n    }\n    const fm = ENTRY_FRONTMATTER.parse(parsed.data)\n    if (fm.schema !== \"knowledge.entry/v1\") continue\n\n    // Tombstone: a guild disables a pack entry by shadowing it (same path) with\n    // status \"archived\". Filtered here so the overlaid archived entry hides the\n    // pack's. Absent/active = shown — only an explicit archive subtracts.\n    if (fm.metadata?.corpus?.status === \"archived\") continue\n\n    const kind = fm.kind ?? \"\"\n    if (wantKinds && !(isRefinedKind(kind) && wantKinds.has(kind))) continue\n\n    const tags = fm.tags ?? []\n    if (wantTags.size > 0 && !tags.some(t => wantTags.has(t.toLowerCase()))) continue\n\n    const access = fm.metadata?.corpus?.access\n    if (allowedAccess && access && !allowedAccess.has(access)) continue\n\n    hits.push({\n      slug: fm.slug ?? path,\n      kind,\n      title: fm.title ?? \"\",\n      body: parsed.content.trim(),\n      sources: fm.sources ?? [],\n      ...(fm.metadata?.corpus?.source_refs\n        ? { sourceRefs: fm.metadata.corpus.source_refs }\n        : {}),\n      confidence: fm.confidence ?? 0,\n      tags,\n      ...(access ? { access } : {}),\n      path,\n    })\n  }\n\n  hits.sort((a, b) => b.confidence - a.confidence)\n  return query.maxResults !== undefined ? hits.slice(0, query.maxResults) : hits\n}\n"]}

package/dist/fs.port-BHzctsoT.d.ts

@@ -0,0 +1,60 @@
+/**
+ * FsPort — filesystem boundary the corpus kit consumes.
+ *
+ * Structural interface, NOT a nominal one — any object exposing this
+ * shape satisfies it. Matches the existing Guilde `WorkspaceFsLike`
+ * convention (projects/guilde/packages/core/src/services/role-source/
+ * workspace.ts:38-47) so cloud and local topologies share the same
+ * minimal contract.
+ *
+ * Paths are relative to the workspace root (no leading slash). The
+ * concrete implementation (MastraFilesystem in cloud, local-fs in CLI,
+ * mcp-filesystem for hybrid topologies) does the resolution.
+ */
+interface FsStat {
+    readonly kind: "file" | "directory";
+    readonly bytes?: number;
+    readonly modifiedAt?: Date;
+}
+interface FsPort {
+    /** True if a file or directory exists at `path`. */
+    exists(path: string): Promise<boolean>;
+    /** Read a file as UTF-8 text. Throws on missing path. */
+    readFile(path: string): Promise<string>;
+    /**
+     * Write a file atomically — caller assumes content is persisted on
+     * resolve. Implementations are expected to write to a temp file +
+     * rename so partial writes never become visible.
+     */
+    writeFile(path: string, content: string): Promise<void>;
+    /**
+     * Append to a file. MUST be atomic against concurrent appends to the
+     * same path — used by the event emitter for _log.md. If the file
+     * does not exist, create it.
+     */
+    appendFile(path: string, content: string): Promise<void>;
+    /**
+     * List immediate children of a directory. Returns names only (NOT
+     * full paths). Throws if `path` is not a directory.
+     */
+    readdir(path: string): Promise<readonly string[]>;
+    /**
+     * Recursive directory listing — returns workspace-relative paths of
+     * every file under `path`. Skips directories starting with `.`.
+     */
+    walk(path: string): Promise<readonly string[]>;
+    /** File metadata. Returns null if the path doesn't exist. */
+    stat(path: string): Promise<FsStat | null>;
+    /**
+     * Acquire a cross-process advisory lock on `path`. Used by the
+     * writer for atomic multi-file transactions (entry write + _index
+     * regen + _log append). Implementations MAY no-op for single-process
+     * topologies (local CLI), but cloud hosts MUST enforce real locking.
+     */
+    lock(path: string): Promise<FsLockHandle>;
+}
+interface FsLockHandle {
+    release(): Promise<void>;
+}
+
+export type { FsPort as F, FsStat as a, FsLockHandle as b };

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-import { FsPort, ClockPort, IdentityPort, FetcherPort, FsStat, FsLockHandle, EvalRubricPort, EvalContextPort, EvaluatorPort } from './ports/index.js';
+import { ClockPort, IdentityPort, FetcherPort, EvalRubricPort, EvalContextPort, EvaluatorPort } from './ports/index.js';
 export { CallerIdentity, EvalInputPort, EvalResultPort, FetchedSource, FetchedSourceKind, systemClock } from './ports/index.js';
+import { F as FsPort, a as FsStat, b as FsLockHandle } from './fs.port-BHzctsoT.js';
 import { z } from 'zod';
+import { R as ReportModelPort } from './model-CtAaBJn4.js';
 import { Registry } from '@agentproto/registry';
 
 /**
@@ -971,6 +973,26 @@ declare function parseItems(text: string): DistilledItem[];
 
 declare function scanDistilledSourceIds(fs: FsPort): Promise<Set<string>>;
 
+/**
+ * modelDistiller — a {@link DistillPort} backed by any structural model port
+ * (`complete({prompt}) → {result}`). This is the seam that unifies distill with
+ * the report writer: both are `buildPrompt → model.complete → parse`, so the
+ * SAME executor (an API ModelPort, or `makeAgentCliModel(runtime)` over ANY
+ * AIP-45 agent CLI — Hermes, claude-code, opencode, codex …) drives both.
+ *
+ * Owns only the distill-specific glue (the shared prompt + tolerant parse); the
+ * model supplies the transport. Pure — no HTTP, no child process. The CLI's
+ * `--engine <id>` selection and the HTTP `AnthropicDistiller` are now two
+ * instances of the same shape.
+ */
+
+interface ModelDistillerOptions {
+    /** Max distilled items requested per source. Default 8. */
+    maxItems?: number;
+}
+/** Wrap a structural model port as a DistillPort (prompt → complete → parse). */
+declare function modelDistiller(model: ReportModelPort, opts?: ModelDistillerOptions): DistillPort;
+
 /**
  * Distill registry — the catalog of distill kinds.
  *
@@ -2890,4 +2912,4 @@ declare class PlaybookEvaluator {
 declare const SPEC_NAME: "agentcorpus/v1";
 declare const SPEC_VERSION: "0.1.0-alpha";
 
-export { ANY_REF, type AccessCaller, type AccessClassification, type AccessContext, type AccessDecision, type AccessModesMap, type ActivateResult, type AggregateOptions, type AggregateResult, type AipSchemaBundle, type AipSchemaKey, type ArchiveResult, type AttachmentAsset, type AttachmentDeclaration, type Attestation, type AttestationKind, type AutoPromoteConfig, type AutoPromoteRequirements, type AxisDefinition, type AxisRegistry, type BatchReport, type BuildOverlayOptions, type CalibrationOptions, type CandidateForGate, type CandidateRow, type CandidateStatus, CandidatesSidecar, type CandidatesSidecarOptions, type Capability, type CapabilityCaller, type CapabilityDecision, type CapabilityRule, type ChunkerOptions, ClaudeDistiller, type ClaudeDistillerOptions, ClockPort, type ConversationDoc, ConversationImporter, type ConversationImporterOptions, type ConversationSourcePort, type ConversationThreadRef, type ConversationTurn, type ConversationWindowSource, type CorpusAccessSpec, type CorpusEntryQuery, type CorpusEvent, CorpusEventEmitter, type CorpusEventEmitterOptions, type CorpusEventKind, type CorpusImporter, CorpusIndexer, type CorpusIndexerOptions, CorpusLinter, type CorpusLinterOptions, type CorpusPreset, type CorpusPresetBootstrapContext, CorpusPromoter, CorpusValidator, type CorpusValidatorOptions, CorpusVersionConflictError, CorpusWorkspaceReader, type CorpusWorkspaceReaderOptions, type CorpusWorkspaceSnapshot, CorpusWorkspaceWriter, type CorpusWorkspaceWriterOptions, type CustomLintRunner, DEFAULT_TRANSITIONS, type Dimensions, type DistillBinding, type DistillDescriptor, type DistillInput, type DistillPort, type DistillRegistry, type DistillReport, type DistillRunReport, DistillRunner, type DistillRunnerOptions, type DistillScope, type DistillSource, type DistillTarget, type DistilledItem, EMPTY_SELECTOR, type EntryLayout, type EvalCase, EvalContextPort, EvalRubricPort, EvaluatorPort, FetcherPort, type FileKind, FsLockHandle, FsPort, FsStat, type GateFailure, type GateResult, IdentityPort, IllegalPlaybookTransitionError, IllegalTransitionError, type ImportedSource, ImporterRunner, type ImporterRunnerOptions, type ImporterTarget, type IndexReport, type KbListLike, type KbMigrationConfig, KbMigrationImporter, type KbSourceLike, type LanguageFilter, type LayerMode, type LayerProvider, type LayerRef, type LayerShadow, type LintIssue, type LintReport, LocalFilesImporter, type LocalFilesImporterOptions, type MarkdownDoc, type MatchAttachmentsOptions, type MatchOptions, MemFs, OperatorOverlayResolver, OverlayFs, type OverlayFsOptions, type ParsedFile, type Playbook, type PlaybookBatchOptions, type PlaybookBatchResult, type PlaybookCorpusMeta, PlaybookEvaluator, type PlaybookEvaluatorOptions, type PlaybookKind, PlaybookLifecycle, type PlaybookLifecycleOptions, PlaybookNotFoundError, type PlaybookQuery, PlaybookRegistry, type PlaybookRegistryOptions, type PlaybookStatus, type PlaybookTarget, type PlaybookTargetKind, type PromoteContext, type PromoteOptions, PromoteRejectedError, type PromoteResult, type PushChunksInput, REFINED_KIND_SCHEMA, ReadOnlyFs, type RefinedKind, type RenderedOverlays, type ResolutionContext, type ResolveContext, type ResolveKnowledgeOptions, type ResolveLanguageFilterInput, type ResolveResult, type ResolvedEntry, type ResolvedOverlay, type ReviewerCalibration, type ReviewerScore, ReviewerTrackRecord, type ReviewerTrackRecordOptions, SPEC_NAME, SPEC_VERSION, type Selector, type SelectorTerm, SidecarDuplicateError, SidecarNotFoundError, type SinkItem, type SinkPort, type SinkPushResult, type SlugifyOptions, type SourceRef, type StackEntry, type StackRefPartition, type StackResolution, StackResolver, type StackSkip, type SyncReport, SyncRunner, type SyncRunnerOptions, type TrackRecordEntry, type TransitionCheck, type ValidationIssue, type ValidationResult, WELL_KNOWN_AXES, WHITEOUT_SUFFIX, WebImporter, type WebImporterOptions, type WriterChunk, type WriterPort, aggregateReviewerScores, appendAttestation, assertTransition, buildDistillPrompt, buildOverlayFromStack, canTransition, capabilityAxis, chunkText, compileLegacyPlaybookBinding, computeReviewerCalibration, createAxisRegistry, createDistillRegistry, enumerateWindowRefs, evaluateAccess, evaluateCapability, evaluateGate, extractAutoPromoteConfig, flattenPackRefs, identityAxis, isEmptySelector, isEntrySlug, isRefinedKind, isSourceSlug, makeAttestation, matchAttachmentRefs, matchAttachments, matchesLanguageFilter, matchesSelector, normalizeLanguageTag, parseItems, parseSelectorFrontmatter, parseWindowRef, partitionStackRefs, pearsonCorrelation, positionAxis, prefixedRefNormalizer, readAccessModes, readAccessSpec, readAttestations, readEntryLanguage, readOperatorLocale, readWorkspaceDefaultLanguage, renderOverlays, resolveKnowledge, resolveLanguageFilter, roleAxis, runDistill, scanDistilledSourceIds, slugify, transitionGraphFromCollection, uniqueSlug, windowRef, windowSlug };
+export { ANY_REF, type AccessCaller, type AccessClassification, type AccessContext, type AccessDecision, type AccessModesMap, type ActivateResult, type AggregateOptions, type AggregateResult, type AipSchemaBundle, type AipSchemaKey, type ArchiveResult, type AttachmentAsset, type AttachmentDeclaration, type Attestation, type AttestationKind, type AutoPromoteConfig, type AutoPromoteRequirements, type AxisDefinition, type AxisRegistry, type BatchReport, type BuildOverlayOptions, type CalibrationOptions, type CandidateForGate, type CandidateRow, type CandidateStatus, CandidatesSidecar, type CandidatesSidecarOptions, type Capability, type CapabilityCaller, type CapabilityDecision, type CapabilityRule, type ChunkerOptions, ClaudeDistiller, type ClaudeDistillerOptions, ClockPort, type ConversationDoc, ConversationImporter, type ConversationImporterOptions, type ConversationSourcePort, type ConversationThreadRef, type ConversationTurn, type ConversationWindowSource, type CorpusAccessSpec, type CorpusEntryQuery, type CorpusEvent, CorpusEventEmitter, type CorpusEventEmitterOptions, type CorpusEventKind, type CorpusImporter, CorpusIndexer, type CorpusIndexerOptions, CorpusLinter, type CorpusLinterOptions, type CorpusPreset, type CorpusPresetBootstrapContext, CorpusPromoter, CorpusValidator, type CorpusValidatorOptions, CorpusVersionConflictError, CorpusWorkspaceReader, type CorpusWorkspaceReaderOptions, type CorpusWorkspaceSnapshot, CorpusWorkspaceWriter, type CorpusWorkspaceWriterOptions, type CustomLintRunner, DEFAULT_TRANSITIONS, type Dimensions, type DistillBinding, type DistillDescriptor, type DistillInput, type DistillPort, type DistillRegistry, type DistillReport, type DistillRunReport, DistillRunner, type DistillRunnerOptions, type DistillScope, type DistillSource, type DistillTarget, type DistilledItem, EMPTY_SELECTOR, type EntryLayout, type EvalCase, EvalContextPort, EvalRubricPort, EvaluatorPort, FetcherPort, type FileKind, FsLockHandle, FsPort, FsStat, type GateFailure, type GateResult, IdentityPort, IllegalPlaybookTransitionError, IllegalTransitionError, type ImportedSource, ImporterRunner, type ImporterRunnerOptions, type ImporterTarget, type IndexReport, type KbListLike, type KbMigrationConfig, KbMigrationImporter, type KbSourceLike, type LanguageFilter, type LayerMode, type LayerProvider, type LayerRef, type LayerShadow, type LintIssue, type LintReport, LocalFilesImporter, type LocalFilesImporterOptions, type MarkdownDoc, type MatchAttachmentsOptions, type MatchOptions, MemFs, type ModelDistillerOptions, OperatorOverlayResolver, OverlayFs, type OverlayFsOptions, type ParsedFile, type Playbook, type PlaybookBatchOptions, type PlaybookBatchResult, type PlaybookCorpusMeta, PlaybookEvaluator, type PlaybookEvaluatorOptions, type PlaybookKind, PlaybookLifecycle, type PlaybookLifecycleOptions, PlaybookNotFoundError, type PlaybookQuery, PlaybookRegistry, type PlaybookRegistryOptions, type PlaybookStatus, type PlaybookTarget, type PlaybookTargetKind, type PromoteContext, type PromoteOptions, PromoteRejectedError, type PromoteResult, type PushChunksInput, REFINED_KIND_SCHEMA, ReadOnlyFs, type RefinedKind, type RenderedOverlays, type ResolutionContext, type ResolveContext, type ResolveKnowledgeOptions, type ResolveLanguageFilterInput, type ResolveResult, type ResolvedEntry, type ResolvedOverlay, type ReviewerCalibration, type ReviewerScore, ReviewerTrackRecord, type ReviewerTrackRecordOptions, SPEC_NAME, SPEC_VERSION, type Selector, type SelectorTerm, SidecarDuplicateError, SidecarNotFoundError, type SinkItem, type SinkPort, type SinkPushResult, type SlugifyOptions, type SourceRef, type StackEntry, type StackRefPartition, type StackResolution, StackResolver, type StackSkip, type SyncReport, SyncRunner, type SyncRunnerOptions, type TrackRecordEntry, type TransitionCheck, type ValidationIssue, type ValidationResult, WELL_KNOWN_AXES, WHITEOUT_SUFFIX, WebImporter, type WebImporterOptions, type WriterChunk, type WriterPort, aggregateReviewerScores, appendAttestation, assertTransition, buildDistillPrompt, buildOverlayFromStack, canTransition, capabilityAxis, chunkText, compileLegacyPlaybookBinding, computeReviewerCalibration, createAxisRegistry, createDistillRegistry, enumerateWindowRefs, evaluateAccess, evaluateCapability, evaluateGate, extractAutoPromoteConfig, flattenPackRefs, identityAxis, isEmptySelector, isEntrySlug, isRefinedKind, isSourceSlug, makeAttestation, matchAttachmentRefs, matchAttachments, matchesLanguageFilter, matchesSelector, modelDistiller, normalizeLanguageTag, parseItems, parseSelectorFrontmatter, parseWindowRef, partitionStackRefs, pearsonCorrelation, positionAxis, prefixedRefNormalizer, readAccessModes, readAccessSpec, readAttestations, readEntryLanguage, readOperatorLocale, readWorkspaceDefaultLanguage, renderOverlays, resolveKnowledge, resolveLanguageFilter, roleAxis, runDistill, scanDistilledSourceIds, slugify, transitionGraphFromCollection, uniqueSlug, windowRef, windowSlug };

package/dist/index.mjs

@@ -1,4 +1,6 @@
 export { systemClock } from './chunk-KYX2DTEH.mjs';
+import { REFINED_KIND_SCHEMA, resolveKnowledge } from './chunk-3P23OX5X.mjs';
+export { REFINED_KIND_SCHEMA, isRefinedKind, resolveKnowledge } from './chunk-3P23OX5X.mjs';
 import { CandidatesSidecar } from './chunk-UPX26MYH.mjs';
 export { CandidatesSidecar, SidecarDuplicateError, SidecarNotFoundError } from './chunk-UPX26MYH.mjs';
 import matter from 'gray-matter';
@@ -1054,16 +1056,6 @@ function sanitizeTag(raw) {
   const t = raw.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
   return /^[a-z][a-z0-9-]*$/.test(t) ? t : null;
 }
-var REFINED_KIND_SCHEMA = z.enum([
-  "principle",
-  "pattern",
-  "critique",
-  "summary",
-  "example"
-]);
-function isRefinedKind(value) {
-  return REFINED_KIND_SCHEMA.safeParse(value).success;
-}
 var DISTILLED_ITEM = z.object({
   kind: REFINED_KIND_SCHEMA,
   title: z.string(),
@@ -1141,6 +1133,19 @@ async function scanDistilledSourceIds(fs) {
   return ids;
 }
 
+// src/distill/model-distiller.ts
+function modelDistiller(model, opts = {}) {
+  const maxItems = opts.maxItems ?? 8;
+  return {
+    async distill(input) {
+      const prompt = buildDistillPrompt(input, maxItems);
+      const { result } = await model.complete({ prompt });
+      const text = typeof result === "string" ? result : JSON.stringify(result);
+      return parseItems(text);
+    }
+  };
+}
+
 // src/distill/registry.ts
 function createDistillRegistry() {
   const descriptors = /* @__PURE__ */ new Map();
@@ -1282,77 +1287,6 @@ async function enumerateWindowRefs(source, distilled) {
   }
   return refs;
 }
-var ENTRY_FRONTMATTER = z.object({
-  schema: z.string().optional().catch(void 0),
-  slug: z.string().optional().catch(void 0),
-  kind: z.string().optional().catch(void 0),
-  title: z.string().optional().catch(void 0),
-  sources: z.array(z.string()).optional().catch(void 0),
-  confidence: z.number().optional().catch(void 0),
-  tags: z.array(z.string()).optional().catch(void 0),
-  metadata: z.object({
-    corpus: z.object({
-      access: z.string().optional().catch(void 0),
-      status: z.string().optional().catch(void 0),
-      // Resolved provenance written at promote time — the origins this
-      // entry was distilled from, so a recall can cite the real source.
-      source_refs: z.array(
-        z.object({
-          id: z.string(),
-          url: z.string().optional().catch(void 0),
-          title: z.string().optional().catch(void 0),
-          authority: z.string().optional().catch(void 0),
-          language: z.string().optional().catch(void 0)
-        }).loose()
-      ).optional().catch(void 0)
-    }).loose().optional().catch(void 0)
-  }).loose().optional().catch(void 0)
-}).loose();
-async function resolveKnowledge(opts) {
-  const { fs, query, allowedAccess } = opts;
-  const wantTags = new Set((query.tags ?? []).map((t) => t.toLowerCase()));
-  const wantKinds = query.kinds ? new Set(query.kinds) : null;
-  let rels;
-  try {
-    rels = await fs.walk("entries");
-  } catch {
-    return [];
-  }
-  const hits = [];
-  for (const rel of rels) {
-    if (!rel.endsWith(".md")) continue;
-    const path = `entries/${rel}`;
-    let parsed;
-    try {
-      parsed = matter(await fs.readFile(path));
-    } catch {
-      continue;
-    }
-    const fm = ENTRY_FRONTMATTER.parse(parsed.data);
-    if (fm.schema !== "knowledge.entry/v1") continue;
-    if (fm.metadata?.corpus?.status === "archived") continue;
-    const kind = fm.kind ?? "";
-    if (wantKinds && !(isRefinedKind(kind) && wantKinds.has(kind))) continue;
-    const tags = fm.tags ?? [];
-    if (wantTags.size > 0 && !tags.some((t) => wantTags.has(t.toLowerCase()))) continue;
-    const access = fm.metadata?.corpus?.access;
-    if (allowedAccess && access && !allowedAccess.has(access)) continue;
-    hits.push({
-      slug: fm.slug ?? path,
-      kind,
-      title: fm.title ?? "",
-      body: parsed.content.trim(),
-      sources: fm.sources ?? [],
-      ...fm.metadata?.corpus?.source_refs ? { sourceRefs: fm.metadata.corpus.source_refs } : {},
-      confidence: fm.confidence ?? 0,
-      tags,
-      ...access ? { access } : {},
-      path
-    });
-  }
-  hits.sort((a, b) => b.confidence - a.confidence);
-  return query.maxResults !== void 0 ? hits.slice(0, query.maxResults) : hits;
-}
 
 // src/knowledge/overlay-fs.ts
 var WHITEOUT_SUFFIX = ".whiteout";
@@ -3375,6 +3309,6 @@ function joinPath5(a, b) {
 var SPEC_NAME = "agentcorpus/v1";
 var SPEC_VERSION = "0.1.0-alpha";
 
-export { ANY_REF, ClaudeDistiller, ConversationImporter, CorpusEventEmitter, CorpusIndexer, CorpusLinter, CorpusPromoter, CorpusValidator, CorpusVersionConflictError, CorpusWorkspaceReader, CorpusWorkspaceWriter, DEFAULT_TRANSITIONS, DistillRunner, EMPTY_SELECTOR, IllegalPlaybookTransitionError, IllegalTransitionError, ImporterRunner, KbMigrationImporter, LocalFilesImporter, MemFs, OperatorOverlayResolver, OverlayFs, PlaybookEvaluator, PlaybookLifecycle, PlaybookNotFoundError, PlaybookRegistry, PromoteRejectedError, REFINED_KIND_SCHEMA, ReadOnlyFs, ReviewerTrackRecord, SPEC_NAME, SPEC_VERSION, StackResolver, SyncRunner, WELL_KNOWN_AXES, WHITEOUT_SUFFIX, WebImporter, aggregateReviewerScores, appendAttestation, assertTransition, buildDistillPrompt, buildOverlayFromStack, canTransition, capabilityAxis, chunkText, compileLegacyPlaybookBinding, computeReviewerCalibration, createAxisRegistry, createDistillRegistry, enumerateWindowRefs, evaluateAccess, evaluateCapability, evaluateGate, extractAutoPromoteConfig, flattenPackRefs, identityAxis, isEmptySelector, isEntrySlug, isRefinedKind, isSourceSlug, makeAttestation, matchAttachmentRefs, matchAttachments, matchesLanguageFilter, matchesSelector, normalizeLanguageTag, parseItems, parseSelectorFrontmatter, parseWindowRef, partitionStackRefs, pearsonCorrelation, positionAxis, prefixedRefNormalizer, readAccessModes, readAccessSpec, readAttestations, readEntryLanguage, readOperatorLocale, readWorkspaceDefaultLanguage, renderOverlays, resolveKnowledge, resolveLanguageFilter, roleAxis, runDistill, scanDistilledSourceIds, slugify, transitionGraphFromCollection, uniqueSlug, windowRef, windowSlug };
+export { ANY_REF, ClaudeDistiller, ConversationImporter, CorpusEventEmitter, CorpusIndexer, CorpusLinter, CorpusPromoter, CorpusValidator, CorpusVersionConflictError, CorpusWorkspaceReader, CorpusWorkspaceWriter, DEFAULT_TRANSITIONS, DistillRunner, EMPTY_SELECTOR, IllegalPlaybookTransitionError, IllegalTransitionError, ImporterRunner, KbMigrationImporter, LocalFilesImporter, MemFs, OperatorOverlayResolver, OverlayFs, PlaybookEvaluator, PlaybookLifecycle, PlaybookNotFoundError, PlaybookRegistry, PromoteRejectedError, ReadOnlyFs, ReviewerTrackRecord, SPEC_NAME, SPEC_VERSION, StackResolver, SyncRunner, WELL_KNOWN_AXES, WHITEOUT_SUFFIX, WebImporter, aggregateReviewerScores, appendAttestation, assertTransition, buildDistillPrompt, buildOverlayFromStack, canTransition, capabilityAxis, chunkText, compileLegacyPlaybookBinding, computeReviewerCalibration, createAxisRegistry, createDistillRegistry, enumerateWindowRefs, evaluateAccess, evaluateCapability, evaluateGate, extractAutoPromoteConfig, flattenPackRefs, identityAxis, isEmptySelector, isEntrySlug, isSourceSlug, makeAttestation, matchAttachmentRefs, matchAttachments, matchesLanguageFilter, matchesSelector, modelDistiller, normalizeLanguageTag, parseItems, parseSelectorFrontmatter, parseWindowRef, partitionStackRefs, pearsonCorrelation, positionAxis, prefixedRefNormalizer, readAccessModes, readAccessSpec, readAttestations, readEntryLanguage, readOperatorLocale, readWorkspaceDefaultLanguage, renderOverlays, resolveLanguageFilter, roleAxis, runDistill, scanDistilledSourceIds, slugify, transitionGraphFromCollection, uniqueSlug, windowRef, windowSlug };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map