agentix-cli 0.25.0 → 0.27.0

package/dist/chunk-WPMX3VGI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agents/references/loader.ts","../src/agents/references/types.ts"],"sourcesContent":["import { existsSync, promises as fs } from \"fs\"\nimport path from \"path\"\nimport yaml from \"js-yaml\"\nimport fg from \"fast-glob\"\nimport { logger } from \"@/utils/logger\"\nimport {\n  referenceFileSchema,\n  type ReferenceCard,\n  type ReferenceIndex,\n} from \"./types\"\n\nconst REFERENCE_DIRS = [\"references\", \".references\", \".agentx/references\"]\nconst REFERENCE_GLOB = \"**/*.{yaml,yml}\"\n\n/**\n * Walk every references directory under `cwd` and build the merged index.\n * Files: YAML matching ReferenceFile schema. Each card's id can be optionally\n * prefixed by a per-file `namespace`.\n *\n * Collisions throw — references must be globally unique to keep the resolver\n * deterministic. Caller can catch and surface them via the audit lint.\n */\nexport async function loadReferences(cwd: string): Promise<ReferenceIndex> {\n  const index: ReferenceIndex = {\n    byId: new Map(),\n    byTag: new Map(),\n    sourceById: new Map(),\n  }\n\n  for (const dir of REFERENCE_DIRS) {\n    const absDir = path.resolve(cwd, dir)\n    if (!existsSync(absDir)) continue\n\n    const files = await fg.glob(REFERENCE_GLOB, { cwd: absDir, deep: 5 })\n    for (const rel of files) {\n      const abs = path.resolve(absDir, rel)\n      // Recipes live alongside references but are loaded separately.\n      if (rel.startsWith(\"recipes/\")) continue\n      try {\n        await ingestFile(abs, index)\n      } catch (e: any) {\n        logger.warn({ file: abs, error: e?.message }, \"references: failed to load file\")\n      }\n    }\n  }\n\n  return index\n}\n\nasync function ingestFile(absPath: string, index: ReferenceIndex): Promise<void> {\n  const raw = await fs.readFile(absPath, \"utf8\")\n  const parsed = yaml.load(raw)\n  const validated = referenceFileSchema.parse(parsed)\n\n  const ns = validated.namespace ? `${validated.namespace}.` : \"\"\n  for (const card of validated.cards) {\n    const id = `${ns}${card.id}`\n    if (index.byId.has(id)) {\n      const prior = index.sourceById.get(id)\n      throw new Error(\n        `references: duplicate id \"${id}\" in ${absPath}` +\n          (prior ? ` (also defined in ${prior})` : \"\")\n      )\n    }\n    const stamped: ReferenceCard = { ...card, id }\n    index.byId.set(id, stamped)\n    index.sourceById.set(id, absPath)\n    for (const tag of stamped.tags) {\n      const bucket = index.byTag.get(tag) ?? []\n      bucket.push(stamped)\n      index.byTag.set(tag, bucket)\n    }\n  }\n}\n\n/**\n * Render a deterministic, compact block of cards. Token-trimmed by alphabetical\n * id once `maxChars` is exceeded (stable order = stable cache).\n */\nexport function renderReferences(\n  cards: ReferenceCard[],\n  maxChars: number = 2000,\n): string {\n  if (cards.length === 0) return \"\"\n  const sorted = [...cards].sort((a, b) => a.id.localeCompare(b.id))\n  const header = \"[Verified References — deterministic, do not re-query]\"\n  const lines: string[] = [header]\n  let total = header.length\n  for (const card of sorted) {\n    const fact = renderCard(card)\n    if (total + fact.length + 1 > maxChars) break\n    lines.push(fact)\n    total += fact.length + 1\n  }\n  return lines.join(\"\\n\")\n}\n\nfunction renderCard(card: ReferenceCard): string {\n  const fields = Object.entries(card.fields)\n    .map(([k, v]) => `${k}=${v}`)\n    .join(\" \")\n  return `- ${card.id} (${card.kind}): ${card.summary}${fields ? ` { ${fields} }` : \"\"}`\n}\n","import { z } from \"zod\"\n\n// --- Deterministic Reference Registry ---\n//\n// References are typed, structured fact cards (SSH hosts, GitLab project IDs,\n// filesystem paths, contacts). Skills cite them by dotted ID; the resolver\n// renders them as a small deterministic block at the top of agent context.\n// No LLM in the lookup path — same (agent, intent, message) → same facts.\n\nexport const referenceKindSchema = z.enum([\n  \"ssh\",\n  \"gitlab\",\n  \"path\",\n  \"contact\",\n  \"http\",\n  \"secret-pointer\",\n])\nexport type ReferenceKind = z.infer<typeof referenceKindSchema>\n\nexport const referenceCardSchema = z.object({\n  /** Dotted ID, e.g. \"initech.gitlab.project.initech-v2\". Globally unique. */\n  id: z.string().regex(/^[a-z0-9][a-z0-9._-]*[a-z0-9]$/, \"id must be a dotted slug\"),\n  kind: referenceKindSchema,\n  /** Human-readable summary rendered in the verified-references block. */\n  summary: z.string(),\n  /** Typed fact body. Shape varies by kind — validated permissively here,\n   *  shape is enforced at render time. */\n  fields: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])),\n  /** Free-form tags used by recipes for matching (e.g. \"deploy\", \"initech-v2\"). */\n  tags: z.array(z.string()).default([]),\n  /** Agent that owns / verifies this card. */\n  ownerAgent: z.string().optional(),\n  /** ISO date the values were last verified. Stale cards surface in audit. */\n  lastVerified: z.string().optional(),\n  /** Inline notes — never rendered to the agent, just for human readers. */\n  notes: z.string().optional(),\n})\nexport type ReferenceCard = z.infer<typeof referenceCardSchema>\n\nexport const referenceFileSchema = z.object({\n  /** Optional namespace prefix applied to every card id in the file. */\n  namespace: z.string().optional(),\n  cards: z.array(referenceCardSchema),\n})\nexport type ReferenceFile = z.infer<typeof referenceFileSchema>\n\nexport interface ReferenceIndex {\n  /** id → card */\n  byId: Map<string, ReferenceCard>\n  /** tag → card[] */\n  byTag: Map<string, ReferenceCard[]>\n  /** Source file path for each card id (for audit / debug). */\n  sourceById: Map<string, string>\n}\n"],"mappings":"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","names":["init_logger","existsSync","fs","path","yaml","fg","z","referenceKindSchema","referenceCardSchema","referenceFileSchema","REFERENCE_DIRS","REFERENCE_GLOB","loadReferences","cwd","index","dir","absDir","path","existsSync","files","fg","rel","abs","ingestFile","e","logger","absPath","raw","fs","parsed","yaml","validated","referenceFileSchema","ns","card","id","prior","stamped","tag","bucket","renderReferences","cards","maxChars","sorted","a","b","header","lines","total","fact","renderCard","fields","k","v"]}