@jimhoyd/urlcode 0.5.8 → 0.5.9

package/README.md

@@ -110,7 +110,7 @@ it. Cross-repository acceptance is tracked in
 ## Status
 
 <!-- urlcode-current-version:start -->
-This checkout prepares the coordinated `0.5.8` core, UI, auth, admin and store
+This checkout prepares the coordinated `0.5.9` core, UI, auth, admin and store
 release. Package availability remains a live registry fact: use `npm run
 release:status` or the release's signed `train.json` before selecting an
 install combination. Independent package versioning remains enabled, and a

package/dist/BUILD-MANIFEST.json

@@ -2,7 +2,7 @@
   "node": "v26.9.0",
   "files": {
     "dist/adapters.js": "a7153ec52f2ed7e0cdd8ed7d433504815f402ec53b2b1c3d38d0cf0e2fcf6509",
-    "dist/agent-context.js": "1e4e9c7b85d155c06d99d8b70f625bd7ab31330a0207aef6ed1803243b759611",
+    "dist/agent-context.js": "cdad0c535ea2771d993f5d9b10bc35aee563d3a6db9618cf97ed072f610164df",
     "dist/agent-lists.js": "35ab484198897501d011cb6cc00b5a6787192e19df29c97646e8c118fcc19eef",
     "dist/agents-guide.js": "307d92879034ef019213ab5c15ff5806de3333da4bb263d46fa87049d1a85d5c",
     "dist/assets.js": "85d8e379dab466bc406b2ea1a9385f1fcecb35d05d825eb83089c55a62f6d1a4",
@@ -16,7 +16,7 @@
     "dist/capabilities.js": "f14c17de63764f6f4686fc1404bf21aa5cf56125ad81e6d6157a429438fc0cbf",
     "dist/capability-query.js": "00fbd8b592dea05de7487f3de21e6aa8808a6d2a90e8808811abeb843375dab3",
     "dist/catalog.js": "629ed1d3580d5c5e238a4293e5b8491ba99d6948accda316bbd2ee3d7902cc0f",
-    "dist/cli.js": "5a99ca3f3d7c374f809a214e453b9b634c4057702b5ac92090b45e12c126fa34",
+    "dist/cli.js": "98f0209fab9204401ad6950a3b9fea9f6029546ca905977ee5492d33b390b6f1",
     "dist/client-address.js": "9d0d01466aab23124330605c5a0e0f981f87c897858acfad909f546a63df165b",
     "dist/cloudflare.js": "b236918e499215ee42c2865181b3ed92decba0bf9d604f17f8b08736c86751d9",
     "dist/compliance-rules/baseline.js": "6296dea6bcb9f9bb80ed6ed5ab2f456e7f74e6de2be5d2d98ca8c983fb4df3ab",
@@ -54,7 +54,7 @@
     "dist/manifest.js": "83eed0d59621039ef364cf6e7b54c5bd47e0d8cf0a5abe7b07344bfc1db56ed8",
     "dist/match.js": "9069dfc59d485c7ed3b618d4ab4cfabcd67299ea4c45c646565e44a57b4bd51d",
     "dist/mcp-authoring.js": "0753fb4f330ab710c7ee115315d7beb33b11faa80ca1b4fc114f5561c8abf7a7",
-    "dist/mcp.js": "f5cc0992b4e595fa36e33f84cb83e5917409ae7875c2f7a4686208cecaf5e671",
+    "dist/mcp.js": "fe94c09e0e57d18fa23ecb79b872c267f3644fc4ab3e00f9167f9ad9035b418c",
     "dist/object-guards.js": "5af6012c803e9d587cb4270f52011bd2ba3e4655f73198dddc4ca327cdf89675",
     "dist/observability.js": "f4b1ab496f051fe3ef2ed36b2b2e469c63a8940700e2df852e6ff2d9cccdd5ae",
     "dist/operator-host.js": "e3dac9d43a83beb775202b4ab9eeeba7ac63cebfc5dcc669be38d825be587bd0",

package/dist/agent-context.js

@@ -7,6 +7,15 @@ import {listExamples} from './examples.js';
  * Fixed, package-owned agent material. This is intentionally a manifest rather
  * than an arbitrary file reader: MCP clients cannot use it to enumerate or
  * exfiltrate a local project.
+ *
+ * Every export here is public API, published as `@jimhoyd/urlcode/agent-context`
+ * (see docs/TOOLING.md and docs/TYPESCRIPT.md) so a host building its own MCP
+ * server or agent-tooling surface can reuse the same deterministic docs
+ * search, YAML validation and error-remediation guidance this package's own
+ * `serveMcp` (mcp.ts) uses, rather than re-implementing it or reaching into
+ * `dist/` directly. Signatures take only plain strings and return plain data;
+ * keep them that way so the subpath stays stable independent of internal
+ * types like `validateDocument`'s return shape.
  */
 const packageRoot=fileURLToPath(new URL('../',import.meta.url));
 const docs=[

package/dist/cli.js

@@ -30,7 +30,7 @@ import { readFile } from 'node:fs/promises';
 import { installArtifact, inspectArtifacts } from './extension-artifacts.js';
 import { installBundle, readBundleLock } from './extension-bundles.js';
 
-const usage = `URLCode 0.5.8 — local/self-hosted runtime
+const usage = `URLCode 0.5.9 — local/self-hosted runtime
   urlcode init <directory> [--with ui,auth,admin] [--bundle-release extension-bundles@vX.Y.Z] [--ack extension:id] [--manifest|--no-manifest] [--pin @scope/pkg=specifier]
     # Writes one bare project scaffold (urlcode.yaml, empty fixtures, AGENTS.md, .mcp.json and project CI). Add routes deliberately after asking the local MCP for task-scoped context.
     # init works in place in a directory holding only package.json, package-lock.json, node_modules or .git; an existing package.json is preserved, any other existing file is refused

package/dist/mcp.js

@@ -7,7 +7,10 @@ import {loadOperatorHost} from './operator-host.js';
 import {buildManifest} from './manifest.js';
                                                         
 import {authoringDefinitions,callAuthoringTool} from './mcp-authoring.js';
-import {listSkills,getSkill,searchDocs,getExample,validateYaml,explainError} from './agent-context.js';
+// Imported through the public subpath, not a relative path into this module's own
+// package, to prove @jimhoyd/urlcode/agent-context is sufficient for the framework's
+// own MCP server rather than a documentation-only promise (see docs/TOOLING.md).
+import {listSkills,getSkill,searchDocs,getExample,validateYaml,explainError} from '@jimhoyd/urlcode/agent-context';
 import {isRecord as object} from './object-guards.js';
 import {describeArtifactCache,readArtifactMember} from './extension-artifacts.js';
 const protocolVersion='2025-11-25';
@@ -102,7 +105,7 @@ export async function serveMcp(options           )               {
   if(message.method==='initialize') {
    if(initialized){await error(id,-32600,'Already initialized');return;}
    if(typeof params.protocolVersion!=='string'||!object(params.capabilities)||!object(params.clientInfo)||typeof params.clientInfo.name!=='string'||typeof params.clientInfo.version!=='string'){await error(id,-32602,'Invalid initialize params');return;}
-   initialized=true;await send({jsonrpc:'2.0',id,result:{protocolVersion,capabilities:{tools:{}},serverInfo:{name:'urlcode',version:'0.5.8'}}});return;
+   initialized=true;await send({jsonrpc:'2.0',id,result:{protocolVersion,capabilities:{tools:{}},serverInfo:{name:'urlcode',version:'0.5.9'}}});return;
   }
   if(message.method==='ping'){await send({jsonrpc:'2.0',id,result:{}});return;}
   if(!ready){await error(id,-32002,'Initialize first');return;}

package/docs/TOOLING.md

@@ -281,6 +281,14 @@ documentation and example tools read only a fixed package-owned manifest; no
 tool argument names an arbitrary local path or remote URL. The CLI equivalent of `search_docs` is
 `urlcode docs search TEXT [--json]`, which returns the same at most three bounded excerpts. `validate_yaml` checks supplied
 YAML syntax and schema only, while `validate` compiles the selected local project.
+The `list_skills`, `get_skill`, `search_docs`, `get_example`, `validate_yaml` and
+`explain_error` tools are thin wrappers over `@jimhoyd/urlcode/agent-context`
+(`listSkills`, `getSkill`, `searchDocs`, `getExample`, `validateYaml`,
+`explainError`), a public package export — not an internal detail of this
+server. A host building its own MCP server, or any other agent-tooling
+integration, can import that module directly instead of reimplementing this
+behavior or reaching into `dist/agent-context.js`; see
+[TypeScript](TYPESCRIPT.md).
 `get_extension_artifacts` validates the project-selected
 `urlcode.extensions.lock.json` and cache, then returns artifact metadata,
 status and allowlisted member paths. `get_extension_artifact` accepts only a

package/llms-full.txt

@@ -7,7 +7,7 @@
 > A portable runtime for programmable URL behavior, and the framework that grows
 > from it: routes in YAML, functions and middleware, then accounts, administration and
 > stored links as operator-installed extensions. Stable project format
-> `version: "1"`. Core is Apache-2.0; this revision is `0.5.8`. `function`/`middleware`
+> `version: "1"`. Core is Apache-2.0; this revision is `0.5.9`. `function`/`middleware`
 > routes are trusted by default with `sandbox: true` as the per-route opt-in. The
 > auth, admin, ui and store workspace packages are bundle sources. New sites install
 > core from npm and verified executable extensions from an immutable GitHub Release;
@@ -784,7 +784,7 @@ programmatic compatibility analysis and provider verification limits.
 Source: https://github.com/jimhoyd-com/urlcode/blob/main/docs/YAML-GUIDE.md
 
 <!-- urlcode-current-version:start -->
-This guide targets URLCode 0.5.8. Start with the function example below,
+This guide targets URLCode 0.5.9. Start with the function example below,
 then add only the fields your route needs. The authoritative machine-readable
 shape is [JSON Schema](https://github.com/jimhoyd-com/urlcode/blob/main/schemas/urlcode.schema.json); semantic rules are in the
 [specification](https://github.com/jimhoyd-com/urlcode/blob/main/docs/SPECIFICATION.md). Unsupported fields fail validation.

package/llms.txt

@@ -4,7 +4,7 @@
 > A portable runtime for programmable URL behavior, and the framework that grows
 > from it: routes in YAML, functions and middleware, then accounts, administration and
 > stored links as operator-installed extensions. Stable project format
-> `version: "1"`. Core is Apache-2.0; this revision is `0.5.8`. `function`/`middleware`
+> `version: "1"`. Core is Apache-2.0; this revision is `0.5.9`. `function`/`middleware`
 > routes are trusted by default with `sandbox: true` as the per-route opt-in. The
 > auth, admin, ui and store workspace packages are bundle sources. New sites install
 > core from npm and verified executable extensions from an immutable GitHub Release;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jimhoyd/urlcode",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "Portable runtime for programmable URL behavior",
   "type": "module",
   "workspaces": [
@@ -25,6 +25,10 @@
       "types": "./dist/types/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./agent-context": {
+      "types": "./dist/types/agent-context.d.ts",
+      "default": "./dist/agent-context.js"
+    },
     "./aws": {
       "types": "./dist/types/aws.d.ts",
       "default": "./dist/aws.js"