@noodleseed/one 0.122.0 → 0.123.0

package/node_modules/@noodle-borg/knowledge-operations/dist/service-wiring.js

@@ -0,0 +1,129 @@
+/**
+ * Composition helpers the service calls from its (size-pinned) bootstrap files, so the thin
+ * dispatch stays thin: store construction, schema setup, and route-deps assembly live here.
+ */
+import { InMemoryKnowledgeRevisionStore, InMemorySearchBudgetStore, PostgresKnowledgeRevisionStore, PostgresSearchBudgetStore, } from '@noodle-borg/knowledge';
+import { secretBoxDocumentCodec } from './codec.js';
+import { createKnowledgeSearchExecutor } from './executor.js';
+import { managedGoogleFromEnv, managedSiteProvisioned, managedSiteSearchFor, } from './managed-google.js';
+import { createKnowledgeDeployHooks } from './publication.js';
+import { knowledgeSearchPortFactory } from './search-port.js';
+import { InMemoryKnowledgeStagingStore, PostgresKnowledgeStagingStore, } from './staging-store.js';
+/** In-memory stores with the identity codec — the no-persistence service default. */
+export function defaultKnowledgeStores() {
+    return {
+        staging: new InMemoryKnowledgeStagingStore(),
+        revisionStore: new InMemoryKnowledgeRevisionStore(),
+        budgetStore: new InMemorySearchBudgetStore(),
+    };
+}
+/** Durable stores sharing the service's Postgres pool and secret-box custody. */
+export async function createPostgresKnowledgeStores(pool, secretBox, env = process.env) {
+    const codec = secretBox === undefined ? undefined : secretBoxDocumentCodec(secretBox);
+    const staging = new PostgresKnowledgeStagingStore(pool);
+    const revisionStore = new PostgresKnowledgeRevisionStore(pool, codec);
+    const budgetStore = new PostgresSearchBudgetStore(pool);
+    await staging.ensureSchema();
+    await revisionStore.ensureSchema();
+    await budgetStore.ensureSchema();
+    const google = managedGoogleFromEnv(env);
+    return {
+        staging,
+        revisionStore,
+        budgetStore,
+        ...(codec === undefined ? {} : { codec }),
+        ...(google === undefined ? {} : { google }),
+    };
+}
+/** Budget ceilings from managed config with the ratified v0 defaults (2000 org / 1000 app). */
+export function budgetCeilingsResolver(resolveVariables) {
+    return async (tenant) => {
+        const variables = await resolveVariables(tenant);
+        const org = Number(variables.NOODLE_KNOWLEDGE_SEARCH_BUDGET_ORG_MONTHLY ?? '2000');
+        const app = Number(variables.NOODLE_KNOWLEDGE_SEARCH_BUDGET_APP_MONTHLY ?? '1000');
+        return {
+            org: Number.isFinite(org) ? Math.max(0, Math.floor(org)) : 2000,
+            app: Number.isFinite(app) ? Math.max(0, Math.floor(app)) : 1000,
+        };
+    };
+}
+/** Assemble route deps over the service's managed-config resolver (`NOODLE_KNOWLEDGE_ENABLED`). */
+export function buildKnowledgeRouteDeps(stores, resolveVariables, maxBodyBytes) {
+    return {
+        staging: stores.staging,
+        knowledgeEnabled: async (tenant) => (await resolveVariables(tenant)).NOODLE_KNOWLEDGE_ENABLED === 'true',
+        findRevisionByContentHash: (scope, componentName, contentHash) => stores.revisionStore.findByContentHash(scope, componentName, contentHash),
+        maxBodyBytes,
+        ...(stores.codec === undefined ? {} : { codec: stores.codec }),
+    };
+}
+/**
+ * One-call composition for the service: resolve stores, build route deps, and register the
+ * deploy-coupled publication hooks on the registry (structurally typed; no service import).
+ */
+export function wireKnowledge(registry, stores, resolveVariables, maxBodyBytes) {
+    const resolved = stores ?? defaultKnowledgeStores();
+    const deps = buildKnowledgeRouteDeps(resolved, resolveVariables, maxBodyBytes);
+    const google = resolved.google;
+    const ceilings = budgetCeilingsResolver(resolveVariables);
+    const hooks = createKnowledgeDeployHooks(resolved, {
+        knowledgeEnabled: deps.knowledgeEnabled,
+        ...(google === undefined
+            ? {}
+            : { siteProvisioned: (tenant) => managedSiteProvisioned(google, tenant) }),
+    });
+    const executor = createKnowledgeSearchExecutor({
+        hooks,
+        knowledgeEnabled: deps.knowledgeEnabled,
+        ...(resolved.budgetStore === undefined
+            ? {}
+            : { budget: { store: resolved.budgetStore, ceilings } }),
+        ...(google === undefined
+            ? {}
+            : { siteSearchFor: (tenant) => managedSiteSearchFor(google, tenant) }),
+    });
+    registry.setKnowledgeDeployHooks(hooks, knowledgeSearchPortFactory(executor));
+    const status = {
+        revisionStore: resolved.revisionStore,
+        knowledgeEnabled: deps.knowledgeEnabled,
+        ...(google === undefined
+            ? {}
+            : {
+                siteProvisioningState: async (tenant) => (await managedSiteProvisioned(google, tenant))
+                    ? 'ready'
+                    : 'missing',
+            }),
+        ...(resolved.budgetStore === undefined
+            ? {}
+            : {
+                budget: async (tenant) => {
+                    const bounds = await ceilings(tenant);
+                    const state = await resolved.budgetStore?.peek({ org: tenant.org, app: tenant.app }, bounds);
+                    if (state === undefined)
+                        return undefined;
+                    return {
+                        year: state.year,
+                        month: state.month,
+                        orgConsumed: state.orgConsumed,
+                        appConsumed: state.appConsumed,
+                        orgCeiling: state.orgCeiling,
+                        appCeiling: state.appCeiling,
+                        blocked: state.orgCeiling <= 0 ||
+                            state.appCeiling <= 0 ||
+                            state.orgConsumed >= state.orgCeiling ||
+                            state.appConsumed >= state.appCeiling,
+                    };
+                },
+            }),
+        activeKnowledge: async (tenant) => {
+            const target = await registry.getActiveByTenant(tenant);
+            const server = target?.served.artifact.server;
+            const components = server?.knowledge;
+            if (components === undefined || components.length === 0)
+                return undefined;
+            return { components, deploymentId: server?.deploymentId ?? '' };
+        },
+    };
+    return { ...deps, status, executor };
+}
+//# sourceMappingURL=service-wiring.js.map

package/node_modules/@noodle-borg/knowledge-operations/dist/service-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-wiring.js","sourceRoot":"","sources":["../src/service-wiring.ts"],"names":[],"mappings":"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"}

package/node_modules/@noodle-borg/knowledge-operations/dist/staging-store.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Encrypted transient document staging (ADR 0202 D5): deploy uploads land here, sealed and
+ * content-addressed by tenant + sha256, until the deploy transaction publishes them into a
+ * revision. Entries are TTL-bounded — an upload that never publishes is swept, so plaintext
+ * never persists outside the sealed revision store.
+ */
+import type { Pool } from 'pg';
+/** How long staged bytes may wait for their deploy transaction before being swept. */
+export declare const STAGING_TTL_MS: number;
+export interface KnowledgeStagingStore {
+    /** Store sealed bytes. Re-uploading the same tenant+hash is idempotent. */
+    put(tenantKey: string, sha256: string, sealed: Buffer, bytes: number): Promise<void>;
+    has(tenantKey: string, sha256: string): Promise<boolean>;
+    /** Sealed bytes for a staged document, if present and unexpired. */
+    get(tenantKey: string, sha256: string): Promise<Buffer | undefined>;
+    /** Remove entries older than the TTL. Returns the removed count. */
+    sweepExpired(): Promise<number>;
+}
+export declare class InMemoryKnowledgeStagingStore implements KnowledgeStagingStore {
+    private readonly entries;
+    private readonly now;
+    constructor(now?: () => Date);
+    put(tenantKey: string, sha256: string, sealed: Buffer): Promise<void>;
+    has(tenantKey: string, sha256: string): Promise<boolean>;
+    get(tenantKey: string, sha256: string): Promise<Buffer | undefined>;
+    sweepExpired(): Promise<number>;
+    private key;
+}
+export declare class PostgresKnowledgeStagingStore implements KnowledgeStagingStore {
+    #private;
+    constructor(pool: Pool, now?: () => Date);
+    ensureSchema(): Promise<void>;
+    put(tenantKey: string, sha256: string, sealed: Buffer, bytes: number): Promise<void>;
+    has(tenantKey: string, sha256: string): Promise<boolean>;
+    get(tenantKey: string, sha256: string): Promise<Buffer | undefined>;
+    sweepExpired(): Promise<number>;
+}
+//# sourceMappingURL=staging-store.d.ts.map

package/node_modules/@noodle-borg/knowledge-operations/dist/staging-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging-store.d.ts","sourceRoot":"","sources":["../src/staging-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,sFAAsF;AACtF,eAAO,MAAM,cAAc,QAAiB,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,oEAAoE;IACpE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACpE,oEAAoE;IACpE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC;AAED,qBAAa,6BAA8B,YAAW,qBAAqB;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;IACnF,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,GAAG,GAAE,MAAM,IAAuB;IAIxC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAOnE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAYrC,OAAO,CAAC,GAAG;CAGZ;AAED,qBAAa,6BAA8B,YAAW,qBAAqB;;gBAI7D,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,MAAM,IAAuB;IAKpD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7B,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASpF,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAUnE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;CAQtC"}

package/node_modules/@noodle-borg/knowledge-operations/dist/staging-store.js

@@ -0,0 +1,77 @@
+/** How long staged bytes may wait for their deploy transaction before being swept. */
+export const STAGING_TTL_MS = 60 * 60 * 1000;
+export class InMemoryKnowledgeStagingStore {
+    entries = new Map();
+    now;
+    constructor(now = () => new Date()) {
+        this.now = now;
+    }
+    async put(tenantKey, sha256, sealed) {
+        this.entries.set(this.key(tenantKey, sha256), { sealed, stagedAt: this.now().getTime() });
+    }
+    async has(tenantKey, sha256) {
+        return (await this.get(tenantKey, sha256)) !== undefined;
+    }
+    async get(tenantKey, sha256) {
+        const entry = this.entries.get(this.key(tenantKey, sha256));
+        if (entry === undefined)
+            return undefined;
+        if (this.now().getTime() - entry.stagedAt > STAGING_TTL_MS)
+            return undefined;
+        return entry.sealed;
+    }
+    async sweepExpired() {
+        const cutoff = this.now().getTime() - STAGING_TTL_MS;
+        let removed = 0;
+        for (const [key, entry] of this.entries) {
+            if (entry.stagedAt < cutoff) {
+                this.entries.delete(key);
+                removed += 1;
+            }
+        }
+        return removed;
+    }
+    key(tenantKey, sha256) {
+        return `${tenantKey}#${sha256}`;
+    }
+}
+export class PostgresKnowledgeStagingStore {
+    #pool;
+    #now;
+    constructor(pool, now = () => new Date()) {
+        this.#pool = pool;
+        this.#now = now;
+    }
+    async ensureSchema() {
+        await this.#pool.query(`
+      CREATE TABLE IF NOT EXISTS knowledge_staging_documents (
+        tenant_key text NOT NULL,
+        sha256 text NOT NULL,
+        ciphertext bytea NOT NULL,
+        bytes integer NOT NULL,
+        staged_at timestamptz NOT NULL,
+        PRIMARY KEY (tenant_key, sha256)
+      )
+    `);
+    }
+    async put(tenantKey, sha256, sealed, bytes) {
+        await this.#pool.query(`INSERT INTO knowledge_staging_documents (tenant_key, sha256, ciphertext, bytes, staged_at)
+       VALUES ($1, $2, $3, $4, $5)
+       ON CONFLICT (tenant_key, sha256) DO UPDATE SET staged_at = $5`, [tenantKey, sha256, sealed, bytes, this.#now()]);
+    }
+    async has(tenantKey, sha256) {
+        return (await this.get(tenantKey, sha256)) !== undefined;
+    }
+    async get(tenantKey, sha256) {
+        const cutoff = new Date(this.#now().getTime() - STAGING_TTL_MS);
+        const result = await this.#pool.query(`SELECT ciphertext FROM knowledge_staging_documents
+       WHERE tenant_key = $1 AND sha256 = $2 AND staged_at >= $3`, [tenantKey, sha256, cutoff]);
+        return result.rows[0]?.ciphertext;
+    }
+    async sweepExpired() {
+        const cutoff = new Date(this.#now().getTime() - STAGING_TTL_MS);
+        const result = await this.#pool.query('DELETE FROM knowledge_staging_documents WHERE staged_at < $1', [cutoff]);
+        return result.rowCount ?? 0;
+    }
+}
+//# sourceMappingURL=staging-store.js.map

package/node_modules/@noodle-borg/knowledge-operations/dist/staging-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging-store.js","sourceRoot":"","sources":["../src/staging-store.ts"],"names":[],"mappings":"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"}

package/node_modules/@noodle-borg/knowledge-operations/dist/status-routes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Operator surface (ADR 0202 as amended): `knowledge list` and `knowledge status <name>` are
+ * the whole v0 CLI-facing read surface. Responses say "versioned documents" versus "live site"
+ * lifecycle truth — active revision, declaring deployment, provisioning state — and never
+ * contents, credentials, or raw provider payloads.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { CompiledKnowledgeComponent, KnowledgeRevisionStore } from '@noodle-borg/knowledge';
+import type { KnowledgeBudgetState } from '@noodle-borg/wire-contracts';
+import { type KnowledgeTenantRef } from './routes.js';
+export interface KnowledgeStatusDeps {
+    readonly revisionStore: KnowledgeRevisionStore;
+    readonly knowledgeEnabled: (tenant: KnowledgeTenantRef) => Promise<boolean>;
+    /** The active deployment's compiled knowledge components, or undefined when none is active. */
+    readonly activeKnowledge: (tenant: KnowledgeTenantRef) => Promise<{
+        readonly components: readonly CompiledKnowledgeComponent[];
+        readonly deploymentId: string;
+    } | undefined>;
+    /** Managed site datastore readiness; absent until the Google slice binds a checker. */
+    readonly siteProvisioningState?: (tenant: KnowledgeTenantRef) => Promise<'ready' | 'missing'>;
+    /** Current month's search-budget state (the amendment's honest operator-visible counters). */
+    readonly budget?: (tenant: KnowledgeTenantRef) => Promise<KnowledgeBudgetState | undefined>;
+}
+/** `GET /v1/orgs/{o}/apps/{a}/envs/{e}/knowledge` */
+export declare function handleKnowledgeList(_req: IncomingMessage, res: ServerResponse, tenant: KnowledgeTenantRef, deps: KnowledgeStatusDeps): Promise<void>;
+/** `GET /v1/orgs/{o}/apps/{a}/envs/{e}/knowledge/{name}/status` */
+export declare function handleKnowledgeStatus(_req: IncomingMessage, res: ServerResponse, tenant: KnowledgeTenantRef, componentName: string, deps: KnowledgeStatusDeps): Promise<void>;
+//# sourceMappingURL=status-routes.d.ts.map

package/node_modules/@noodle-borg/knowledge-operations/dist/status-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-routes.d.ts","sourceRoot":"","sources":["../src/status-routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,aAAa,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,+FAA+F;IAC/F,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAC7D;QACE,QAAQ,CAAC,UAAU,EAAE,SAAS,0BAA0B,EAAE,CAAC;QAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,GACD,SAAS,CACZ,CAAC;IACF,uFAAuF;IACvF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC9F,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;CAC7F;AA8BD,qDAAqD;AACrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,mEAAmE;AACnE,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/node_modules/@noodle-borg/knowledge-operations/dist/status-routes.js

@@ -0,0 +1,66 @@
+import { sendJson } from './http.js';
+import { knowledgeEnableCommand } from './routes.js';
+function gateClosed(res, tenant) {
+    sendJson(res, 403, {
+        code: 'knowledge_not_enabled',
+        error: 'knowledge is not enabled for this org/app/env',
+        fix: knowledgeEnableCommand(tenant),
+    });
+}
+async function componentSummary(tenant, component, deploymentId, revisionStore) {
+    const scope = { org: tenant.org, app: tenant.app, env: tenant.env };
+    const active = component.documents.length > 0 ? await revisionStore.active(scope, component.name) : undefined;
+    const state = component.documents.length > 0 && active === undefined ? 'pending' : 'active';
+    return {
+        name: component.name,
+        sources: { documents: component.documents.length, sites: component.sites.length },
+        declaringScope: 'env',
+        ...(active !== undefined ? { activeRevisionId: active.revisionId } : {}),
+        activeDeploymentId: deploymentId,
+        state,
+    };
+}
+/** `GET /v1/orgs/{o}/apps/{a}/envs/{e}/knowledge` */
+export async function handleKnowledgeList(_req, res, tenant, deps) {
+    if (!(await deps.knowledgeEnabled(tenant)))
+        return gateClosed(res, tenant);
+    const active = await deps.activeKnowledge(tenant);
+    const components = [];
+    for (const component of active?.components ?? []) {
+        components.push(await componentSummary(tenant, component, active?.deploymentId ?? '', deps.revisionStore));
+    }
+    const response = {
+        ok: true,
+        scope: { org: tenant.org, app: tenant.app, env: tenant.env },
+        components,
+    };
+    return sendJson(res, 200, response);
+}
+/** `GET /v1/orgs/{o}/apps/{a}/envs/{e}/knowledge/{name}/status` */
+export async function handleKnowledgeStatus(_req, res, tenant, componentName, deps) {
+    if (!(await deps.knowledgeEnabled(tenant)))
+        return gateClosed(res, tenant);
+    const active = await deps.activeKnowledge(tenant);
+    const component = active?.components.find((candidate) => candidate.name === componentName);
+    if (active === undefined || component === undefined) {
+        return sendJson(res, 404, {
+            code: 'knowledge_component_not_found',
+            error: `no active deployment declares knowledge component "${componentName}"`,
+            fix: 'noodle knowledge list',
+        });
+    }
+    const siteProvisioning = component.sites.length === 0
+        ? 'not-required'
+        : ((await deps.siteProvisioningState?.(tenant)) ?? 'missing');
+    const budget = await deps.budget?.(tenant);
+    const response = {
+        ok: true,
+        scope: { org: tenant.org, app: tenant.app, env: tenant.env },
+        component: await componentSummary(tenant, component, active.deploymentId, deps.revisionStore),
+        siteProvisioning,
+        ...(budget === undefined ? {} : { budget }),
+        errors: [],
+    };
+    return sendJson(res, 200, response);
+}
+//# sourceMappingURL=status-routes.js.map

package/node_modules/@noodle-borg/knowledge-operations/dist/status-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-routes.js","sourceRoot":"","sources":["../src/status-routes.ts"],"names":[],"mappings":"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"}

package/node_modules/@noodle-borg/knowledge-operations/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@noodle-borg/knowledge-operations",
+  "version": "0.0.0",
+  "private": true,
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@noodle-borg/knowledge": "0.0.0",
+    "@noodle-borg/wire-contracts": "0.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.1",
+    "@types/pg": "^8.20.0"
+  }
+}

package/node_modules/@noodle-borg/protocol/dist/handlers/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AASxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,sBAAsB,CAAC;AAuB9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAK/D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAyIN"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AASxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,sBAAsB,CAAC;AA4B9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAK/D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAmKN"}

package/node_modules/@noodle-borg/protocol/dist/handlers/tools.js

@@ -2,6 +2,7 @@ import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } f
 import { artifactDeclaresContext, CONTEXT_TOOL_DESCRIPTOR, CONTEXT_TOOL_NAME, } from '../context-tool.js';
 import { coerceToolArguments } from '../input-validation.js';
 import { extractElicitationResponses, toolUsesPortableInteractionArgument, } from '../interaction-envelope.js';
+import { findKnowledgeComponent, knowledgeToolsEnabled, runKnowledgeSearchTool, } from '../knowledge-tool.js';
 import { mapExecutionError, mapToolOutput, mapToolsList, redactWidgetLinkedOutput, } from '../mapping.js';
 import { estimateTokens, notify, } from '../observation.js';
 import { evaluateToolAuthorization, TOOL_AUTHORIZATION_DENIED } from '../tool-authorization.js';
@@ -10,7 +11,9 @@ import { interactionUnavailableToolResult, stoppedToolResult } from '../tool-res
 export function registerTools(server, artifact, deps, context) {
     // Our mapping helpers return structural subsets of the SDK's result unions; the `as` casts pick the
     // intended union arm (the SDK union also has a Tasks arm that requires a `task` field we never emit).
-    server.setRequestHandler(ListToolsRequestSchema, () => mapToolsList(artifact, context.caller));
+    server.setRequestHandler(ListToolsRequestSchema, async () => mapToolsList(artifact, context.caller, {
+        knowledgeTools: await knowledgeToolsEnabled(artifact, deps),
+    }));
     server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
         const toolName = request.params.name;
         const observe = (outcome, extra = {}) => notify(context, { method: 'tools/call', toolName, outcome, ...extra });
@@ -31,6 +34,24 @@ export function registerTools(server, artifact, deps, context) {
             observe('ok', { outputTokensEst: estimateTokens(deps.context) });
             return mapped;
         }
+        const knowledgeComponent = findKnowledgeComponent(artifact, toolName);
+        if (knowledgeComponent !== undefined && (await knowledgeToolsEnabled(artifact, deps))) {
+            const outcome = await runKnowledgeSearchTool(knowledgeComponent, deps, request.params.arguments ?? {});
+            if (outcome.kind === 'invalid') {
+                observe('mcp_error', { errorKind: 'invalid_params' });
+                throw new McpError(ErrorCode.InvalidParams, `invalid arguments for tool "${toolName}"`, {
+                    reason: 'invalid_tool_arguments',
+                    validation: outcome.issues,
+                });
+            }
+            if (outcome.kind === 'error') {
+                observe('mcp_error', { errorKind: outcome.reason });
+                throw new McpError(ErrorCode.InternalError, outcome.message, { reason: outcome.reason });
+            }
+            const mapped = mapToolOutput(outcome.output);
+            observe('ok', { outputTokensEst: estimateTokens(outcome.output) });
+            return mapped;
+        }
         const tool = artifact.tools.find((item) => item.name === toolName);
         if (tool !== undefined) {
             const authorization = evaluateToolAuthorization(tool.authorization, context.caller);

package/node_modules/@noodle-borg/protocol/dist/handlers/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"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"}

package/node_modules/@noodle-borg/protocol/dist/knowledge-tool.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The generated `search_<name>` tool (ADR 0202 D4), shared by both era handlers. Like
+ * `noodle_context`, it is a reserved non-fulfilment tool: listed from `server.knowledge`,
+ * executed through the injected deployment-bound port, never through the fulfilment engine.
+ * Gate off (or no port) ⇒ the tool is absent from listing and unknown at call time.
+ */
+import type { RuntimeArtifact } from '@noodle-borg/compiler';
+import type { ExecuteDeps, KnowledgeSearchHit } from '@noodle-borg/runtime';
+type KnowledgeComponent = NonNullable<RuntimeArtifact['server']['knowledge']>[number];
+export declare function findKnowledgeComponent(artifact: RuntimeArtifact, toolName: string): KnowledgeComponent | undefined;
+/** Listing predicate: the artifact declares knowledge AND the deployment's port is live. */
+export declare function knowledgeToolsEnabled(artifact: RuntimeArtifact, deps: ExecuteDeps): Promise<boolean>;
+export type KnowledgeCallOutcome = {
+    readonly kind: 'invalid';
+    readonly issues: readonly unknown[];
+} | {
+    readonly kind: 'error';
+    readonly reason: string;
+    readonly message: string;
+} | {
+    readonly kind: 'ok';
+    readonly output: {
+        readonly hits: readonly KnowledgeSearchHit[];
+    };
+};
+export declare function runKnowledgeSearchTool(component: KnowledgeComponent, deps: ExecuteDeps, rawArguments: Record<string, unknown>): Promise<KnowledgeCallOutcome>;
+export {};
+//# sourceMappingURL=knowledge-tool.d.ts.map

package/node_modules/@noodle-borg/protocol/dist/knowledge-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-tool.d.ts","sourceRoot":"","sources":["../src/knowledge-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,KAAK,kBAAkB,GAAG,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,SAAS,CAEhC;AAED,4FAA4F;AAC5F,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,kBAAkB,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAE/F,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,kBAAkB,EAC7B,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAU/B"}

package/node_modules/@noodle-borg/protocol/dist/knowledge-tool.js

@@ -0,0 +1,26 @@
+import { coerceToolArguments } from './input-validation.js';
+export function findKnowledgeComponent(artifact, toolName) {
+    return artifact.server.knowledge?.find((component) => component.generatedTool.name === toolName);
+}
+/** Listing predicate: the artifact declares knowledge AND the deployment's port is live. */
+export async function knowledgeToolsEnabled(artifact, deps) {
+    if ((artifact.server.knowledge?.length ?? 0) === 0)
+        return false;
+    if (deps.knowledgeSearch === undefined)
+        return false;
+    return deps.knowledgeSearch.enabled();
+}
+export async function runKnowledgeSearchTool(component, deps, rawArguments) {
+    const coerced = coerceToolArguments(component.generatedTool.inputSchema, rawArguments);
+    if (coerced.issues.length > 0)
+        return { kind: 'invalid', issues: coerced.issues };
+    if (deps.knowledgeSearch === undefined) {
+        return { kind: 'error', reason: 'not_enabled', message: 'knowledge search is unavailable' };
+    }
+    const request = coerced.value;
+    const outcome = await deps.knowledgeSearch.search(component.name, request);
+    if (!outcome.ok)
+        return { kind: 'error', reason: outcome.reason, message: outcome.message };
+    return { kind: 'ok', output: { hits: outcome.hits } };
+}
+//# sourceMappingURL=knowledge-tool.js.map

package/node_modules/@noodle-borg/protocol/dist/knowledge-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-tool.js","sourceRoot":"","sources":["../src/knowledge-tool.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAI5D,MAAM,UAAU,sBAAsB,CACpC,QAAyB,EACzB,QAAgB;IAEhB,OAAO,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACnG,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAyB,EACzB,IAAiB;IAEjB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;AACxC,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAA6B,EAC7B,IAAiB,EACjB,YAAqC;IAErC,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAClF,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;IAC9F,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,KAA0C,CAAC;IACnE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3E,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5F,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;AACxD,CAAC"}

package/node_modules/@noodle-borg/protocol/dist/mapping.d.ts

@@ -48,7 +48,11 @@ export declare function mapTool(tool: ArtifactTool): ToolDescriptor;
  * `_meta.ui.visibility: ['app']` so MCP Apps hosts can hide them from the model surface while still brokering
  * iframe-originated `callServerTool` requests. Visibility is not authorization; hosted policy gates the call.
  */
-export declare function mapToolsList(artifact: RuntimeArtifact, caller?: ToolAuthorizationCaller): ToolsListResult;
+export declare function mapToolsList(artifact: RuntimeArtifact, caller?: ToolAuthorizationCaller, options?: {
+    readonly knowledgeTools?: boolean;
+}): ToolsListResult;
+/** Generated `search_<name>` descriptors (ADR 0202 D4); listed only when the port is live. */
+export declare function knowledgeToolDescriptors(artifact: RuntimeArtifact): ToolsListResult['tools'];
 /**
  * Map a successful tool output to a `tools/call` result. Structured (object) output is returned as
  * `structuredContent` and also serialized into a text block (the spec asks for both, for clients

package/node_modules/@noodle-borg/protocol/dist/mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,YAAY,EACZ,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAyB,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAGvC;;;;;GAKG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,0GAA0G;IAC1G,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,oGAAoG;AACpG,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACpC;IAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,2GAA2G;AAC3G,wBAAgB,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAU1D;AA8CD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,eAAe,EACzB,MAAM,CAAC,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C,eAAe,CASjB;AAED,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,CAQ5F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAgB9D;AAID,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEjE;AAkDD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACnE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAWD,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB,CAK/E;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,2BAA2B,CAK/F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,OAAO,EACf,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,YAAY,CAAC,EAAE,sBAAsB,GACpC,kBAAkB,CAwCpB;AAID,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,iBAAiB,CAgB3E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAGxF"}

package/node_modules/@noodle-borg/protocol/dist/mapping.js

@@ -60,15 +60,26 @@ function withPortableInteractionInput(tool) {
  * `_meta.ui.visibility: ['app']` so MCP Apps hosts can hide them from the model surface while still brokering
  * iframe-originated `callServerTool` requests. Visibility is not authorization; hosted policy gates the call.
  */
-export function mapToolsList(artifact, caller) {
+export function mapToolsList(artifact, caller, options) {
     assertNoContextToolCollision(artifact);
     return {
         tools: [
             ...filterAuthorizedTools(artifact.tools, caller).map(mapTool),
             ...(artifactDeclaresContext(artifact) ? [CONTEXT_TOOL_DESCRIPTOR] : []),
+            ...(options?.knowledgeTools === true ? knowledgeToolDescriptors(artifact) : []),
         ],
     };
 }
+/** Generated `search_<name>` descriptors (ADR 0202 D4); listed only when the port is live. */
+export function knowledgeToolDescriptors(artifact) {
+    return (artifact.server.knowledge ?? []).map((component) => ({
+        name: component.generatedTool.name,
+        description: component.generatedTool.description,
+        inputSchema: component.generatedTool
+            .inputSchema,
+        outputSchema: component.generatedTool.outputSchema,
+    }));
+}
 /**
  * Map a successful tool output to a `tools/call` result. Structured (object) output is returned as
  * `structuredContent` and also serialized into a text block (the spec asks for both, for clients