@agentskit/doc-bridge 1.2.1 → 1.2.4

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@agentskit/doc-bridge",
-  "version": "1.2.1",
+  "version": "1.2.4",
+  "mcpName": "io.github.AgentsKit-io/doc-bridge",
   "description": "Human↔agent documentation bridge — deterministic handoffs, doc-site links, memory→docs, optional AgentsKit RAG/chat.",
   "type": "module",
   "bin": {
@@ -95,6 +96,7 @@
     "access": "public"
   },
   "dependencies": {
+    "mermaid": "^11.16.0",
     "zod": "^3.24.2"
   },
   "peerDependencies": {
@@ -126,16 +128,17 @@
     }
   },
   "devDependencies": {
-    "@agentskit/chat": "0.3.0",
+    "@agentskit/chat": "0.4.0",
     "@agentskit/core": "1.12.3",
+    "@agentskit/ink": "0.10.4",
     "@agentskit/react": "0.7.4",
     "@changesets/cli": "^2.31.0",
     "@lhci/cli": "^0.15.1",
     "@playwright/test": "1.61.1",
     "@tailwindcss/postcss": "4.3.2",
     "@types/node": "^22.15.3",
-    "@types/react": "19.0.0",
-    "@types/react-dom": "19.0.0",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
     "@vitest/coverage-v8": "4.1.10",
     "fumadocs-core": "15.6.5",
     "fumadocs-mdx": "11.6.4",
@@ -166,5 +169,5 @@
   "bugs": {
     "url": "https://github.com/AgentsKit-io/doc-bridge/issues"
   },
-  "homepage": "https://agentskit-io.github.io/doc-bridge/"
+  "homepage": "https://doc-bridge.agentskit.io/"
 }

package/src/conformance/ecosystem-contract.ts

@@ -50,7 +50,12 @@ const ManifestSchema = z.object({
   schemaVersion: z.literal(2),
   parentBrand: z.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema }).passthrough(),
   products: z.array(ProductSchema).min(1),
-  properties: z.array(LegacyPropertySchema).length(4),
+  // Historical four-product shim or full seven-product projection of products[].
+  properties: z
+    .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: z.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema, url: HttpsUrlSchema }).passthrough().optional(),
 }).passthrough()
 
@@ -88,7 +93,18 @@ const ClaimsSchema = z.object({
   products: z.array(ClaimProductSchema),
 }).passthrough()
 
-const LEGACY_PRODUCT_IDS = ['agentskit', 'akos', 'playbook', 'registry'] as const
+/** Historical four-product shim order. */
+const LEGACY_FOUR_PRODUCT_IDS = ['agentskit', 'akos', 'playbook', 'registry'] as const
+/** Full seven-product projection order (matches products[]). */
+const FULL_SEVEN_PRODUCT_IDS = [
+  'agentskit',
+  'registry',
+  'agentskit-chat',
+  'playbook',
+  'doc-bridge',
+  'code-review',
+  'akos',
+] as const
 
 export const parseCanonicalEcosystemContract = (
   manifestInput: unknown,
@@ -120,7 +136,10 @@ export const parseCanonicalEcosystemContract = (
     }
   }
 
-  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) {

package/src/federation/ecosystem-llms.ts

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ */
+
+export 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
+  }
+}
+
+export 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.
+ */
+export function formatEcosystemLlmsBlock(options: FormatEcosystemLlmsBlockOptions): string[] {
+  const heading = options.heading ?? 'AgentsKit ecosystem'
+  const prefer = options.prefer ?? 'home'
+  const lines: string[] = [`## ${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} — ${promiseSentence}${role}${maturity}${machine}`,
+    )
+  }
+
+  lines.push('')
+  return lines
+}
+
+/** Join the block into a single string ending with a newline. */
+export function formatEcosystemLlmsSection(options: FormatEcosystemLlmsBlockOptions): string {
+  return `${formatEcosystemLlmsBlock(options).join('\n')}\n`
+}

package/src/index.ts

@@ -65,6 +65,12 @@ export {
 } from './validate.js'
 
 export { buildDocBridgeIndex, type BuildIndexOptions, type BuildIndexResult } from './index-builder/build-index.js'
+export {
+  formatEcosystemLlmsBlock,
+  formatEcosystemLlmsSection,
+  type EcosystemLlmsProduct,
+  type FormatEcosystemLlmsBlockOptions,
+} from './federation/ecosystem-llms.js'
 export {
   scanHumanDocRecords,
   scanHumanDocs,

package/src/playbook/doc-bridge-pattern.ts

@@ -111,7 +111,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/
 `
 
 export const docBridgePatternPayload = () => ({

package/src/version.ts

@@ -1 +1 @@
-export const PACKAGE_VERSION = '1.2.1'
+export const PACKAGE_VERSION = '1.2.4'