@agentskit/doc-bridge 1.4.1 → 1.4.3

package/ecosystem-claims.json

@@ -59,9 +59,9 @@
         },
         {
           "id": "catalog-providers",
-          "value": 140,
+          "value": 184,
           "noun": "providers",
-          "conservativeFloor": 140,
+          "conservativeFloor": 180,
           "evidence": {
             "type": "repository-derivation",
             "repo": "AgentsKit-io/agentskit",
@@ -71,9 +71,9 @@
         },
         {
           "id": "catalog-models",
-          "value": 5162,
+          "value": 6297,
           "noun": "models",
-          "conservativeFloor": 5000,
+          "conservativeFloor": 6000,
           "evidence": {
             "type": "repository-derivation",
             "repo": "AgentsKit-io/agentskit",
@@ -106,9 +106,9 @@
         },
         {
           "id": "recipes",
-          "value": 69,
+          "value": 71,
           "noun": "recipes",
-          "conservativeFloor": 69,
+          "conservativeFloor": 71,
           "evidence": {
             "type": "repository-derivation",
             "repo": "AgentsKit-io/agentskit",

package/ecosystem-upstream.json

@@ -3,7 +3,7 @@
   "repository": "AgentsKit-io/agentskit",
   "ref": "main",
   "files": {
-    "ecosystem.json": "8cc227f6838b9927fcaab5fe019e0f869f8a82bcbb1f2488b8b6b94e41779e9e",
-    "ecosystem-claims.json": "ab8f83b3fa56d525986485dfeb4f12cd89ce1e76b3c90b2b1c6df51dfe8919bd"
+    "ecosystem.json": "ecbf86547333012222bd965d17ffb351d35a67925935666f5ddea7e039d411dd",
+    "ecosystem-claims.json": "ac2628c3202cc07b6206a83d0d8b1b90eb4c26704575665205a9f490f9f01436"
   }
 }

package/ecosystem.json

@@ -5,6 +5,22 @@
     "id": "agentskit",
     "name": "AgentsKit"
   },
+  "positioning": {
+    "canonicalDescription": "AgentsKit is the open-source TypeScript ecosystem for building production AI agents without locking application architecture to a model provider, framework, database, or hosted platform.",
+    "metaDescription": "Open-source TypeScript ecosystem for production AI agents. Swap models, providers, tools, memory, RAG, and interfaces without architectural lock-in.",
+    "commercialBoundary": "AgentsKit, Chat, Registry, Playbook, Doc Bridge, and Code Review are free and open source. AKOS is the optional paid managed control plane for teams that need enterprise operations, governance, and infrastructure.",
+    "openSourceProductIds": [
+      "agentskit",
+      "registry",
+      "agentskit-chat",
+      "playbook",
+      "doc-bridge",
+      "code-review"
+    ],
+    "managedProductIds": [
+      "akos"
+    ]
+  },
   "products": [
     {
       "id": "agentskit",
@@ -12,10 +28,39 @@
       "shortName": "AgentsKit",
       "kind": "library",
       "role": "foundation",
+      "accessModel": "open-source",
       "promise": "Build agents without gluing many libraries together.",
       "maturity": "beta",
       "repo": "AgentsKit-io/agentskit",
       "accent": "#2EA043",
+      "metadata": {
+        "alternateName": "AgentsKit.js",
+        "description": "A free, MIT-licensed TypeScript ecosystem for production AI agents with replaceable contracts for models, runtimes, tools, memory, RAG, observability, sandboxing, evaluation, and interfaces.",
+        "dateCreated": "2026-04-02",
+        "applicationCategory": "DeveloperApplication",
+        "runtimePlatform": "JavaScript runtimes supporting ES2022",
+        "license": "MIT",
+        "author": {
+          "givenName": "Emerson",
+          "familyName": "Braun",
+          "url": "https://github.com/EmersonBraun"
+        },
+        "keywords": [
+          "AI agents",
+          "agent framework",
+          "TypeScript",
+          "JavaScript",
+          "LLM",
+          "multi-agent",
+          "tools",
+          "memory",
+          "RAG",
+          "observability",
+          "sandboxing",
+          "evaluation",
+          "MCP"
+        ]
+      },
       "showcase": {
         "claimSource": {
           "url": "https://www.agentskit.io/api/stats.json",
@@ -72,6 +117,7 @@
       "shortName": "Registry",
       "kind": "registry",
       "role": "starting-point",
+      "accessModel": "open-source",
       "promise": "Copy ready-made agents and own the source.",
       "maturity": "beta",
       "repo": "AgentsKit-io/agentskit-registry",
@@ -127,6 +173,7 @@
       "shortName": "Chat",
       "kind": "framework",
       "role": "experience",
+      "accessModel": "open-source",
       "promise": "Define one agent experience and deliver it across interfaces.",
       "maturity": "alpha",
       "repo": "AgentsKit-io/agentskit-chat",
@@ -179,6 +226,7 @@
       "shortName": "Playbook",
       "kind": "methodology",
       "role": "discipline",
+      "accessModel": "open-source",
       "promise": "Train coding agents to ship code your team would merge.",
       "maturity": "stable",
       "repo": "AgentsKit-io/agents-playbook",
@@ -232,6 +280,7 @@
       "shortName": "Doc Bridge",
       "kind": "developer-tool",
       "role": "understanding",
+      "accessModel": "open-source",
       "promise": "Turn repository documentation into executable agent handoffs.",
       "maturity": "stable",
       "repo": "AgentsKit-io/doc-bridge",
@@ -284,6 +333,7 @@
       "shortName": "Code Review",
       "kind": "developer-tool",
       "role": "verification",
+      "accessModel": "open-source",
       "promise": "Run deep, low-noise review with the model already in use.",
       "maturity": "alpha",
       "repo": "AgentsKit-io/code-review-cli",
@@ -314,6 +364,7 @@
       "shortName": "AKOS",
       "kind": "product",
       "role": "operation",
+      "accessModel": "paid-managed-service",
       "promise": "Run and govern agents in production.",
       "maturity": "stable",
       "repo": "AgentsKit-io/agentskit-os",

package/mcpb/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "doc-bridge",
   "display_name": "Doc Bridge",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "Deterministic repository handoffs for coding agents, running locally without an LLM or API key.",
   "long_description": "Doc Bridge turns a repository's own documentation and ownership metadata into deterministic handoffs: where an agent should start, which paths it may edit, which checks it must run, and when a human must take over. The local connector exposes the same read-only contract available through Doc Bridge CLI and CI.",
   "author": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/doc-bridge",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "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",

package/skills/doc-bridge-handoff/scripts/resolve-handoff.mjs

@@ -3,7 +3,7 @@
 import { spawnSync } from 'node:child_process'
 import { isAbsolute } from 'node:path'
 
-const VERSION = '1.4.1'
+const VERSION = '1.4.3'
 const kinds = new Set(['package', 'ownership'])
 const args = process.argv.slice(2)
 const id = args[0]

package/src/config/schema.ts

@@ -44,6 +44,8 @@ export const IndexConfigSchema = z
         enabled: z.boolean().optional(),
         outFile: z.string().min(1).max(512).optional(),
         preamble: z.string().max(4_000).optional(),
+        urlPrefix: z.string().url().optional(),
+        pathPrefix: z.string().min(1).max(512).optional(),
       })
       .strict()
       .optional(),

package/src/conformance/ecosystem-contract.ts

@@ -22,7 +22,7 @@ const ProductSchema = z.object({
   role: NonEmptyStringSchema,
   promise: NonEmptyStringSchema,
   maturity: z.enum(['planning', 'alpha', 'beta', 'stable', 'deprecated']),
-  repo: RepoSchema,
+  repo: RepoSchema.nullable(),
   accent: z.string().regex(/^#[0-9A-Fa-f]{6}$/),
   surfaces: SurfaceSchema,
   navigation: z.object({
@@ -38,7 +38,7 @@ const LegacyPropertySchema = z.object({
   barLabel: NonEmptyStringSchema,
   domain: NonEmptyStringSchema,
   url: HttpsUrlSchema,
-  repo: RepoSchema,
+  repo: RepoSchema.nullable(),
   tagline: NonEmptyStringSchema,
   kind: NonEmptyStringSchema,
   accent: z.string().regex(/^#[0-9A-Fa-f]{6}$/),
@@ -82,6 +82,7 @@ const ClaimProductSchema = z.object({
   source: z.discriminatedUnion('type', [
     z.object({ type: z.literal('endpoint'), url: HttpsUrlSchema }).passthrough(),
     z.object({ type: z.literal('repository'), repo: RepoSchema }).passthrough(),
+    z.object({ type: z.literal('declaration'), summary: NonEmptyStringSchema }).passthrough(),
   ]),
   verification: z.enum(['verified', 'declared']),
   claims: z.array(ClaimSchema),
@@ -171,8 +172,10 @@ export const parseCanonicalEcosystemContract = (
     if (!claimProduct) throw new Error(`Claims are missing product ${productId}.`)
     if (claimProduct.source.type === 'endpoint') {
       if (claimProduct.source.url !== product.surfaces.stats) throw new Error(`Claims source for ${productId} must match stats.`)
-    } else if (claimProduct.source.repo !== product.repo) {
+    } else if (claimProduct.source.type === 'repository' && claimProduct.source.repo !== product.repo) {
       throw new Error(`Claims source for ${productId} must match repo.`)
+    } else if (claimProduct.source.type === 'declaration' && product.repo !== null) {
+      throw new Error(`Declaration source for ${productId} requires a null repo.`)
     }
     if (claimProduct.verification === 'declared' && claimProduct.claims.length > 0) {
       throw new Error(`Declared product ${productId} cannot publish claims.`)

package/src/index-builder/human-adapters/plain-markdown.ts

@@ -1,10 +1,26 @@
+import { minimatch } from 'minimatch'
+
 import { optionString, scanMarkdownDocs, type HumanAdapter } from './core.js'
 
+const stringPatterns = (value: unknown): string[] =>
+  Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string' && item.length > 0) : []
+
+const matchesConfiguredPath = (relPath: string, options: Record<string, unknown> | undefined): boolean => {
+  const normalize = (pattern: string): string => pattern.replaceAll('\\', '/').replace(/^\.\//, '')
+  const include = stringPatterns(options?.include).map(normalize)
+  const exclude = stringPatterns(options?.exclude).map(normalize)
+  if (exclude.some((pattern) => minimatch(relPath, pattern, { dot: true }))) return false
+  return include.length === 0 || include.some((pattern) => minimatch(relPath, pattern, { dot: true }))
+}
+
 export const plainMarkdownAdapter: HumanAdapter = {
   plugin: 'plain-markdown',
   scan: ({ root, config }) => {
     const humanRoot =
       optionString(config.options, ['contentDir', 'root', 'docsDir']) ?? 'docs'
-    return scanMarkdownDocs(root, humanRoot, { urlPrefix: config.options?.urlPrefix })
+    return scanMarkdownDocs(root, humanRoot, {
+      urlPrefix: config.options?.urlPrefix,
+      includeRelPath: (relPath) => matchesConfiguredPath(relPath, config.options),
+    })
   },
 }

package/src/index-builder/llms-txt.ts

@@ -1,6 +1,25 @@
 import type { DocBridgeConfigV1 } from '../config/schema.js'
 import type { KnowledgeEntry } from '../schemas/doc-bridge-index.js'
 
+const routePath = (path: string, pathPrefix: string | undefined): string => {
+  const normalizedPath = path.replaceAll('\\', '/').replace(/\.(?:md|mdx)$/, '')
+  const normalizedPrefix = pathPrefix?.replaceAll('\\', '/').replace(/\/$/, '')
+  const relativePath = normalizedPrefix && normalizedPath.startsWith(`${normalizedPrefix}/`)
+    ? normalizedPath.slice(normalizedPrefix.length + 1)
+    : normalizedPath
+  return relativePath.replace(/^\/+/, '')
+}
+
+export const knowledgeUrl = (
+  path: string,
+  options: { readonly urlPrefix?: string | undefined; readonly pathPrefix?: string | undefined } = {},
+): string => {
+  const relativePath = routePath(path, options.pathPrefix)
+  if (!options.urlPrefix) return path
+  const base = options.urlPrefix.endsWith('/') ? options.urlPrefix : `${options.urlPrefix}/`
+  return new URL(relativePath, base).toString()
+}
+
 export const renderLlmsTxt = (
   config: DocBridgeConfigV1,
   knowledge: readonly KnowledgeEntry[],
@@ -12,8 +31,9 @@ export const renderLlmsTxt = (
 
   const lines = knowledge.slice(0, 500).map((entry) => {
     const desc = entry.description ? `: ${entry.description}` : ''
-    return `- [${entry.title}](${entry.path})${desc}`
+    const url = knowledgeUrl(entry.path, config.index?.llmsTxt)
+    return `- [${entry.title}](${url})${desc}`
   })
 
   return `${preamble.trim()}\n\n## Knowledge\n\n${lines.join('\n')}\n`
-}
+}

package/src/index-builder/scan-corpus.ts

@@ -1,4 +1,5 @@
 import type { DocBridgeConfigV1 } from '../config/schema.js'
+import { minimatch } from 'minimatch'
 import { readBoundedText } from '../lib/bounded-text.js'
 import {
   extractSearchBody,
@@ -31,10 +32,25 @@ export type OwnershipSeed = {
 
 const relFromRoot = (root: string, abs: string): string => toPosix(abs.replace(`${toPosix(root)}/`, ''))
 
+const configuredPathMatches = (
+  relPath: string,
+  include: readonly string[] | undefined,
+  exclude: readonly string[] | undefined,
+): boolean => {
+  const normalize = (pattern: string): string => toPosix(pattern).replace(/^\.\//, '')
+  const included = include?.filter(Boolean).map(normalize) ?? []
+  const excluded = exclude?.filter(Boolean).map(normalize) ?? []
+  if (excluded.some((pattern) => minimatch(relPath, pattern, { dot: true }))) return false
+  return included.length === 0 || included.some((pattern) => minimatch(relPath, pattern, { dot: true }))
+}
+
 export const scanAgentCorpus = (root: string, config: DocBridgeConfigV1): CorpusDoc[] => {
   const agentRoot = containedProjectPath(root, config.corpus.agent.root)
   if (!agentRoot) throw new Error('Agent corpus root escapes the project root.')
-  const files = walkFiles(agentRoot, { extensions: ['.md', '.mdx'] })
+  const files = walkFiles(agentRoot, { extensions: ['.md', '.mdx'] }).filter((abs) => {
+    const relToCorpus = toPosix(abs.replace(`${toPosix(agentRoot)}/`, ''))
+    return configuredPathMatches(relToCorpus, config.corpus.agent.include, config.corpus.agent.exclude)
+  })
   const corpusRelRoot = toPosix(config.corpus.agent.root)
 
   const budget = { used: 0 }

package/src/version.ts

@@ -1 +1 @@
-export const PACKAGE_VERSION = '1.4.1'
+export const PACKAGE_VERSION = '1.4.3'