@agentskit/doc-bridge 1.2.1 → 1.2.4

package/dist/index.d.ts

@@ -1405,6 +1405,43 @@ type BuildIndexResult = {
 };
 declare const buildDocBridgeIndex: (opts: BuildIndexOptions) => BuildIndexResult;
 
+/**
+ * Canonical AgentsKit ecosystem section for llms.txt (and similar machine indexes).
+ *
+ * All products should render this block with the same heading and line shape so
+ * agents can parse the seven-product mesh without per-repo inventiveness.
+ */
+type EcosystemLlmsProduct = {
+    readonly id: string;
+    readonly name: string;
+    readonly role?: string;
+    readonly promise: string;
+    readonly maturity?: string;
+    readonly surfaces: {
+        readonly home?: string;
+        readonly docs?: string;
+        readonly llms?: string;
+    };
+};
+type FormatEcosystemLlmsBlockOptions = {
+    readonly products: readonly EcosystemLlmsProduct[];
+    /** When set, marks this product with **(current)**. */
+    readonly currentProductId?: string;
+    /** Heading line without leading hashes — default `AgentsKit ecosystem`. */
+    readonly heading?: string;
+    /**
+     * Prefer docs URL when available; otherwise home.
+     * Default: home, falling back to docs.
+     */
+    readonly prefer?: 'home' | 'docs';
+};
+/**
+ * Returns markdown lines for the shared ecosystem block, including a trailing blank line.
+ */
+declare function formatEcosystemLlmsBlock(options: FormatEcosystemLlmsBlockOptions): string[];
+/** Join the block into a single string ending with a newline. */
+declare function formatEcosystemLlmsSection(options: FormatEcosystemLlmsBlockOptions): string;
+
 type HumanDocRecord = {
     readonly id: string;
     readonly url: string;
@@ -1776,7 +1813,7 @@ declare const chunksFromMarkdown: (property: string, raw: string, sourceUrl: str
 declare const loadFederatedChunks: (root: string, config: DocBridgeConfigV1, options?: FederatedRetrieverOptions) => Promise<DocBridgeRetrievedChunk[]>;
 declare const retrieveHybridChunks: (root: string, config: DocBridgeConfigV1, index: DocBridgeIndexV1, query: string, options?: FederatedRetrieverOptions) => Promise<DocBridgeRetrievedChunk[]>;
 
-declare const PACKAGE_VERSION = "1.2.1";
+declare const PACKAGE_VERSION = "1.2.4";
 
 type FrontmatterValue = string | boolean | readonly string[];
 type FrontmatterData = Record<string, FrontmatterValue>;
@@ -1890,4 +1927,4 @@ declare const docBridgePatternPayload: () => {
     cli: "ak-docs";
 };
 
-export { AgentHandoffLegacySchema, type AgentHandoffV1, AgentHandoffV1JsonSchema, AgentHandoffV1Schema, type AgentSearchV1, AgentSearchV1Schema, type BuildIndexOptions, type BuildIndexResult, DOCUMENTATION_STANDARD_V1_ID, DOCUMENTATION_STANDARD_V1_STATUS, DOC_BRIDGE_PATTERN_ID, DOC_BRIDGE_PATTERN_META, DocBridgeConfigV1, type DocBridgeIndexV1, DocBridgeIndexV1JsonSchema, DocBridgeIndexV1Schema, DocBridgeJsonSchemas, type DocBridgeRetrievedChunk, type DocBridgeRetriever, type DocBridgeRetrieverOptions, type DoctorBadgeMetrics, type DoctorCoverage, type DoctorIssue, type DoctorReport, type DocumentationConformanceReportV1, type DocumentationStandardEvidence, type DocumentationStandardRemediation, DocumentationStandardRuleId, type DocumentationStandardRuleLevel, type DocumentationStandardRuleResult, type DocumentationStandardRuleStatus, type FederatedRetrieverOptions, type FetchText, type GateId, type GateResult, type GateRunResult, type GithubPrOptions, type GithubPrResult, HANDOFF_SCHEMA_VERSION, type HandoffBridge, HandoffBridgeSchema, type HandoffTarget, type HandoffTargetType, HandoffTargetTypeSchema, type HumanDocMap, type HumanDocRecord, INDEX_SCHEMA_VERSION, IndexNotFoundError, type KnowledgeEntry, KnowledgeEntrySchema, MCP_TOOLS, MEMORY_CANDIDATE_SCHEMA_VERSION, type McpInstallResult, type McpInstallTarget, type MemoryCandidateV1, MemoryCandidateV1JsonSchema, MemoryCandidateV1Schema, type MemoryClassification, type MemoryPromotionDraft, type MemoryRoute, PACKAGE_VERSION, type ParseIssue, type ParseResult, PeerMissingError, type QueryKind, type QueryRequest, type QueryResult, type SafetyFinding, type SearchMatch, type WatchIndexOptions, buildDocBridgeIndex, buildLookup, chunksFromMarkdown, classifyMemoryCandidates, collectPackages, createDocBridgeRag, createDocBridgeRetriever, defaultPromotionDraftPath, docBridgePatternMarkdown, docBridgePatternPayload, doctorBadgeMetrics, draftMemoryPromotion, formatDoctorBadgeJson, formatDoctorBadgeMarkdown, formatDoctorText, formatDocumentationStandardText, handleMcpRequest, indexFilePath, ingestAgentMemory, ingestCursorRules, ingestMemoryCandidates, installMcpConfig, layer1InstallHint, loadDocBridgeIndex, loadFederatedChunks, mcpSnippet, normalizeAgentHandoff, parseAgentHandoff, parseAgentSearch, parseDocBridgeConfig, parseDocBridgeIndex, parseLlmsTxtLinks, parseMemoryCandidate, promoteMemoryToGithubPr, resolveGateIds, resolveRoot, retrieveDocBridgeChunks, retrieveHybridChunks, runChatOnce, runDoctor, runDocumentationStandardV1, runGate, runGates, runQuery, safeParseAgentHandoff, scanHumanDocRecords, scanHumanDocs, scanMemorySafety, searchIndex, sha256NormalizedV1, startInkChat, startMcpStdioServer, watchDocBridgeIndex, writePromotionDraft };
+export { AgentHandoffLegacySchema, type AgentHandoffV1, AgentHandoffV1JsonSchema, AgentHandoffV1Schema, type AgentSearchV1, AgentSearchV1Schema, type BuildIndexOptions, type BuildIndexResult, DOCUMENTATION_STANDARD_V1_ID, DOCUMENTATION_STANDARD_V1_STATUS, DOC_BRIDGE_PATTERN_ID, DOC_BRIDGE_PATTERN_META, DocBridgeConfigV1, type DocBridgeIndexV1, DocBridgeIndexV1JsonSchema, DocBridgeIndexV1Schema, DocBridgeJsonSchemas, type DocBridgeRetrievedChunk, type DocBridgeRetriever, type DocBridgeRetrieverOptions, type DoctorBadgeMetrics, type DoctorCoverage, type DoctorIssue, type DoctorReport, type DocumentationConformanceReportV1, type DocumentationStandardEvidence, type DocumentationStandardRemediation, DocumentationStandardRuleId, type DocumentationStandardRuleLevel, type DocumentationStandardRuleResult, type DocumentationStandardRuleStatus, type EcosystemLlmsProduct, type FederatedRetrieverOptions, type FetchText, type FormatEcosystemLlmsBlockOptions, type GateId, type GateResult, type GateRunResult, type GithubPrOptions, type GithubPrResult, HANDOFF_SCHEMA_VERSION, type HandoffBridge, HandoffBridgeSchema, type HandoffTarget, type HandoffTargetType, HandoffTargetTypeSchema, type HumanDocMap, type HumanDocRecord, INDEX_SCHEMA_VERSION, IndexNotFoundError, type KnowledgeEntry, KnowledgeEntrySchema, MCP_TOOLS, MEMORY_CANDIDATE_SCHEMA_VERSION, type McpInstallResult, type McpInstallTarget, type MemoryCandidateV1, MemoryCandidateV1JsonSchema, MemoryCandidateV1Schema, type MemoryClassification, type MemoryPromotionDraft, type MemoryRoute, PACKAGE_VERSION, type ParseIssue, type ParseResult, PeerMissingError, type QueryKind, type QueryRequest, type QueryResult, type SafetyFinding, type SearchMatch, type WatchIndexOptions, buildDocBridgeIndex, buildLookup, chunksFromMarkdown, classifyMemoryCandidates, collectPackages, createDocBridgeRag, createDocBridgeRetriever, defaultPromotionDraftPath, docBridgePatternMarkdown, docBridgePatternPayload, doctorBadgeMetrics, draftMemoryPromotion, formatDoctorBadgeJson, formatDoctorBadgeMarkdown, formatDoctorText, formatDocumentationStandardText, formatEcosystemLlmsBlock, formatEcosystemLlmsSection, handleMcpRequest, indexFilePath, ingestAgentMemory, ingestCursorRules, ingestMemoryCandidates, installMcpConfig, layer1InstallHint, loadDocBridgeIndex, loadFederatedChunks, mcpSnippet, normalizeAgentHandoff, parseAgentHandoff, parseAgentSearch, parseDocBridgeConfig, parseDocBridgeIndex, parseLlmsTxtLinks, parseMemoryCandidate, promoteMemoryToGithubPr, resolveGateIds, resolveRoot, retrieveDocBridgeChunks, retrieveHybridChunks, runChatOnce, runDoctor, runDocumentationStandardV1, runGate, runGates, runQuery, safeParseAgentHandoff, scanHumanDocRecords, scanHumanDocs, scanMemorySafety, searchIndex, sha256NormalizedV1, startInkChat, startMcpStdioServer, watchDocBridgeIndex, writePromotionDraft };

package/dist/index.js

@@ -1534,7 +1534,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.2.1";
+var PACKAGE_VERSION = "1.2.4";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -2013,6 +2013,32 @@ var buildDocBridgeIndex = (opts) => {
   };
 };
 
+// src/federation/ecosystem-llms.ts
+function formatEcosystemLlmsBlock(options) {
+  const heading = options.heading ?? "AgentsKit ecosystem";
+  const prefer = options.prefer ?? "home";
+  const lines = [`## ${heading}`, ""];
+  for (const product of options.products) {
+    const primary = prefer === "docs" ? product.surfaces.docs ?? product.surfaces.home : product.surfaces.home ?? product.surfaces.docs;
+    if (!primary) continue;
+    const current = product.id === options.currentProductId ? " **(current)**" : "";
+    const role = product.role ? ` Role: \`${product.role}\`.` : "";
+    const maturity = product.maturity ? ` Maturity: ${product.maturity}.` : "";
+    const machine = product.surfaces.llms ? ` Machine index: ${product.surfaces.llms}` : "";
+    const promise = product.promise.trim();
+    const promiseSentence = /[.!?]$/.test(promise) ? promise : `${promise}.`;
+    lines.push(
+      `- [${product.name}](${primary})${current} \u2014 ${promiseSentence}${role}${maturity}${machine}`
+    );
+  }
+  lines.push("");
+  return lines;
+}
+function formatEcosystemLlmsSection(options) {
+  return `${formatEcosystemLlmsBlock(options).join("\n")}
+`;
+}
+
 // src/gates/run-gates.ts
 import { readFileSync as readFileSync9 } from "fs";
 
@@ -2068,7 +2094,10 @@ var ManifestSchema = z5.object({
   schemaVersion: z5.literal(2),
   parentBrand: z5.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema }).passthrough(),
   products: z5.array(ProductSchema).min(1),
-  properties: z5.array(LegacyPropertySchema).length(4),
+  // Historical four-product shim or full seven-product projection of products[].
+  properties: z5.array(LegacyPropertySchema).refine((value) => value.length === 4 || value.length === 7, {
+    message: "must project either the legacy four products or the full seven-product catalog"
+  }),
   builder: z5.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema, url: HttpsUrlSchema }).passthrough().optional()
 }).passthrough();
 var EvidenceSchema = z5.discriminatedUnion("type", [
@@ -2101,7 +2130,16 @@ var ClaimsSchema = z5.object({
   manifestSchemaVersion: z5.literal(2),
   products: z5.array(ClaimProductSchema)
 }).passthrough();
-var LEGACY_PRODUCT_IDS = ["agentskit", "akos", "playbook", "registry"];
+var LEGACY_FOUR_PRODUCT_IDS = ["agentskit", "akos", "playbook", "registry"];
+var FULL_SEVEN_PRODUCT_IDS = [
+  "agentskit",
+  "registry",
+  "agentskit-chat",
+  "playbook",
+  "doc-bridge",
+  "code-review",
+  "akos"
+];
 var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
   const manifest = ManifestSchema.parse(manifestInput);
   const claims = ClaimsSchema.parse(claimsInput);
@@ -2127,7 +2165,8 @@ var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
       if (!products.has(nextId)) throw new Error(`Product ${product.id} references unknown product ${nextId}.`);
     }
   }
-  for (const [index, id] of LEGACY_PRODUCT_IDS.entries()) {
+  const propertyIds = manifest.properties.length === 7 ? FULL_SEVEN_PRODUCT_IDS : LEGACY_FOUR_PRODUCT_IDS;
+  for (const [index, id] of propertyIds.entries()) {
     const legacy = manifest.properties[index];
     const product = products.get(id);
     if (!legacy || !product || legacy.id !== id || !product.surfaces.home) {
@@ -4340,7 +4379,7 @@ Teams track handoff % and human-bridge % daily.
 - npm: https://www.npmjs.com/package/@agentskit/doc-bridge
 - repo: https://github.com/AgentsKit-io/doc-bridge
 - skill: https://github.com/AgentsKit-io/doc-bridge/blob/master/docs/skills/doc-bridge.md
-- landing: https://agentskit-io.github.io/doc-bridge/
+- landing: https://doc-bridge.agentskit.io/
 `;
 var docBridgePatternPayload = () => ({
   ...DOC_BRIDGE_PATTERN_META,
@@ -4394,6 +4433,8 @@ export {
   formatDoctorBadgeMarkdown,
   formatDoctorText,
   formatDocumentationStandardText,
+  formatEcosystemLlmsBlock,
+  formatEcosystemLlmsSection,
   handleMcpRequest,
   indexFilePath,
   ingestAgentMemory,