@eir-labs/coltrane 0.5.0 → 0.6.2

package/dist/src/genome_store.js

@@ -0,0 +1,326 @@
+// genome_store.ts — the GenomeStore port. Governor ruling: GENOME IS NOT LOCAL. The hosted
+// Coltrane MCP is the Coltrane MCP — the full tool surface, functioning against the Supabase
+// store — so the engine needs ONE port for "where do definitions live", with two backings:
+//
+//   * fileGenomeStore(root)      — the existing loader/writer, unchanged behavior. Local dev
+//     and the stdio server keep reading/writing genome files on disk.
+//   * postgrestGenomeStore(ctx)  — loads the five genome tables over PostgREST (the caller's
+//     bearer rides the Authorization header, so RLS is the scope) and reconstructs the SAME
+//     in-memory genome shape the file loader produces. Every record is validated through the
+//     genome_schema Zod parsers exactly as the loader does; rows that fail parse are load
+//     errors (LoadedGenome.load_errors — surfaced by system_health), never silent skips.
+//     Writes ride the coltrane_genome_upsert RPC as the caller.
+//
+// No new dependencies: plain fetch, and the Zod schemas the engine already owns.
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveGenome, GenomeLoadError, } from "./loader.js";
+import { writeGenomeFileVersioned } from "./genome_writer.js";
+import { defineAgent, composeStandard } from "./composition.js";
+import { DomainTypeSchema, SkillSchema } from "./genome_schema.js";
+import { domainTypeDefect } from "./registry.js";
+import { CANONICAL_CORE_TYPES } from "./canonical_core_types.js";
+const CLASS_SUBDIR = {
+    agent: "agents",
+    standard: "standards",
+    skill: "skills",
+    domain_type: "domain_types",
+};
+/** Local-dev backing: the existing loader/writer, behavior identical. load() is
+ *  resolveGenome (manifest-aware, canonical-core seeding); upsert() writes the loadable
+ *  file via the versioned writer (prior bytes snapshotted, atomic replace). Ledger sealing
+ *  stays where it lives today — in the MCP tools (sealDefinition / sealAgentDefinition). */
+export function fileGenomeStore(root) {
+    return {
+        async load() {
+            return resolveGenome(root);
+        },
+        async upsert(cls, payload) {
+            const slug = typeof payload["slug"] === "string" ? payload["slug"].trim() : "";
+            if (!slug)
+                throw new Error(`genome upsert: ${cls} payload has no slug`);
+            if (cls === "skill") {
+                // Skills are PACKAGE directories (the loader's only skill format) — mirror
+                // sealSkillPackage's file half: meta.json + code/md halves + fixtures.
+                const pkgDir = join(root, "skills", slug);
+                mkdirSync(pkgDir, { recursive: true });
+                const { fixtures, code, md, ...meta } = payload;
+                writeFileSync(join(pkgDir, "meta.json"), JSON.stringify(meta, null, 2) + "\n");
+                if (typeof code === "string")
+                    writeFileSync(join(pkgDir, "skill.mjs"), code);
+                if (typeof md === "string")
+                    writeFileSync(join(pkgDir, "skill.md"), md);
+                if (Array.isArray(fixtures)) {
+                    const fxDir = join(pkgDir, "fixtures");
+                    mkdirSync(fxDir, { recursive: true });
+                    fixtures.forEach((fx, i) => writeFileSync(join(fxDir, `fixture-${String(i + 1).padStart(3, "0")}.json`), JSON.stringify(fx, null, 2) + "\n"));
+                }
+                return;
+            }
+            writeGenomeFileVersioned(root, CLASS_SUBDIR[cls], slug, JSON.stringify(payload, null, 2) + "\n");
+        },
+    };
+}
+// ── PostgREST backing ─────────────────────────────────────────────────────────────
+// The five genome tables and the columns the engine reads back. Row shapes are the
+// round-tripped Supabase schema (org_id is RLS's concern, not the engine's).
+const Q = {
+    core_types: "coltrane_core_types?select=slug,primitive,base_schema,description",
+    domain_types: "coltrane_domain_types?select=slug,version,extends,domain,status,schema,required_fields",
+    agents: "coltrane_agent_profiles?select=slug,version,status,primitives,input_types,output_types,domain," +
+        "identity,method,constraints,depth_profile,permissions,behavioral_primitives,skill_slots,default_skills",
+    standards: "coltrane_standards?select=slug,version,status,domain,phases,output_types",
+    skills: "coltrane_skills?select=slug,name,description,skill_md,tier,input_type,output_type,status",
+};
+async function restGet(ctx, pathAndQuery) {
+    const res = await fetch(`${ctx.baseUrl}/rest/v1/${pathAndQuery}`, {
+        headers: {
+            apikey: ctx.anonKey,
+            // The bearer authenticates via the header; RLS scopes what this caller may load.
+            Authorization: `Bearer ${ctx.bearer}`,
+            "Content-Type": "application/json",
+        },
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        throw new GenomeLoadError(`genome load: GET ${pathAndQuery.split("?")[0]} → ${res.status}: ${text}`);
+    }
+    const parsed = text ? JSON.parse(text) : [];
+    return Array.isArray(parsed) ? parsed : [];
+}
+const zodWhy = (issues) => issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+/** Build the engine AgentDef from an agent-profile row: the permissions jsonb unpacks to the
+ *  flat schema fields; default_skills is the row's skill-binding column (skill_slugs). */
+function agentDefFromRow(row) {
+    const perms = (row["permissions"] ?? {});
+    const def = {
+        slug: row["slug"],
+        primitives: row["primitives"],
+        input_types: row["input_types"] ?? [],
+        output_types: row["output_types"] ?? [],
+        domain: row["domain"] ?? null,
+        identity: row["identity"],
+        method: row["method"],
+        constraints: row["constraints"] ?? [],
+        behavioral_primitives: row["behavioral_primitives"],
+        allowed_tools: perms["allowed_tools"],
+        disallowed_tools: perms["disallowed_tools"],
+        model_tier: perms["model_tier"],
+        max_tool_calls: perms["max_tool_calls"],
+        code_tool_access: perms["code_tool_access"],
+        depth_profile: row["depth_profile"],
+        skill_slugs: row["default_skills"],
+    };
+    for (const k of Object.keys(def))
+        if (def[k] === undefined || def[k] === null)
+            delete def[k];
+    // domain is honestly nullable on the schema — restore it if the row said null.
+    if (!("domain" in def))
+        def["domain"] = null;
+    return def;
+}
+const REQUIRED_CORE_SLUGS = ["Signal", "Interpretation", "Judgment", "Plan", "Artifact", "Verdict"];
+/** Hosted backing: load the genome from the store's five tables and reconstruct the SAME
+ *  in-memory shape the file loader produces; upsert through the governed RPC. */
+export function postgrestGenomeStore(ctx) {
+    return {
+        async load() {
+            const [coreRows, typeRows, agentRows, standardRows, skillRows] = await Promise.all([
+                restGet(ctx, Q.core_types),
+                restGet(ctx, Q.domain_types),
+                restGet(ctx, Q.agents),
+                restGet(ctx, Q.standards),
+                restGet(ctx, Q.skills),
+            ]);
+            const load_errors = [];
+            // core types — engine-owned, immutable 6. No rows visible → seed the canonical set,
+            // exactly as loadGenome does for a root with no core_types/. A PARTIAL set is a corrupt
+            // store view and hard-fails, mirroring the loader's strict gate.
+            const core_types = new Map();
+            if (coreRows.length === 0) {
+                for (const c of CANONICAL_CORE_TYPES)
+                    core_types.set(c.slug, c);
+            }
+            else {
+                for (const r of coreRows) {
+                    core_types.set(String(r["slug"]), {
+                        slug: String(r["slug"]),
+                        primitive: String(r["primitive"]),
+                        description: String(r["description"] ?? ""),
+                        schema: (r["base_schema"] ?? {}),
+                    });
+                }
+                const missing = REQUIRED_CORE_SLUGS.filter((s) => !core_types.has(s));
+                if (missing.length > 0) {
+                    throw new GenomeLoadError(`coltrane_core_types missing required slugs: ${missing.join(", ")}`);
+                }
+            }
+            // domain types — the loader's three checks, in the loader's order: core-type extends,
+            // representability (domainTypeDefect), then the single Zod source. Soft-fail per row.
+            const domain_types = new Map();
+            for (const r of typeRows) {
+                const slug = typeof r["slug"] === "string" ? r["slug"] : null;
+                const path = `postgrest:coltrane_domain_types/${slug ?? "?"}`;
+                try {
+                    if (!core_types.has(String(r["extends"]))) {
+                        throw new Error(`field "extends" references "${String(r["extends"])}" which is not a core type`);
+                    }
+                    const defect = domainTypeDefect(r);
+                    if (defect)
+                        throw new Error(defect);
+                    const check = DomainTypeSchema.safeParse(r);
+                    if (!check.success)
+                        throw new Error(`type schema validation failed — ${zodWhy(check.error.issues)}`);
+                    const rec = check.data;
+                    domain_types.set(`${rec.slug}@${rec.version}`, rec);
+                }
+                catch (e) {
+                    load_errors.push({ kind: "domain_type", path, slug, error: e instanceof Error ? e.message : String(e) });
+                }
+            }
+            // agents — defineAgent is the loader's own gate (schema parse + composition rules).
+            // Hosted rows soft-fail per row: one broken profile is a reported load error, not a
+            // dead genome for every caller behind this RLS scope.
+            const agents = new Map();
+            for (const r of agentRows) {
+                const slug = typeof r["slug"] === "string" ? r["slug"] : null;
+                const path = `postgrest:coltrane_agent_profiles/${slug ?? "?"}`;
+                try {
+                    if (!slug)
+                        throw new Error(`missing required "slug" field`);
+                    if (agents.has(slug))
+                        throw new Error(`duplicate agent slug "${slug}"`);
+                    agents.set(slug, defineAgent(agentDefFromRow(r)));
+                }
+                catch (e) {
+                    load_errors.push({ kind: "agent", path, slug, error: e instanceof Error ? e.message : String(e) });
+                }
+            }
+            // standards — phases jsonb is already the engine phase shape; the agents a standard
+            // composes are the ones its chairs name. composeStandard is the loader's own gate.
+            const standards = new Map();
+            for (const r of standardRows) {
+                const slug = typeof r["slug"] === "string" ? r["slug"] : null;
+                const path = `postgrest:coltrane_standards/${slug ?? "?"}`;
+                try {
+                    if (!slug)
+                        throw new Error(`missing required "slug" field`);
+                    if (standards.has(slug))
+                        throw new Error(`duplicate standard slug "${slug}"`);
+                    const phases = (r["phases"] ?? []);
+                    const chairAgentSlugs = [
+                        ...new Set(phases.flatMap((p) => (p.chairs ?? []).map((c) => c.agent_slug).filter((s) => !!s))),
+                    ];
+                    const resolved = chairAgentSlugs.map((aslug) => {
+                        const a = agents.get(aslug);
+                        if (!a)
+                            throw new Error(`references unknown agent "${aslug}"`);
+                        return a;
+                    });
+                    standards.set(slug, composeStandard({
+                        slug,
+                        domain: String(r["domain"] ?? ""),
+                        agents: resolved,
+                        phases,
+                        status: r["status"] ?? "active",
+                        ...(Array.isArray(r["output_types"]) ? { output_types: r["output_types"] } : {}),
+                    }));
+                }
+                catch (e) {
+                    load_errors.push({ kind: "standard", path, slug, error: e instanceof Error ? e.message : String(e) });
+                }
+            }
+            // skills — the row's skill_md IS the loaded reasoning half (`md`, the prompt's Skills
+            // layer). Hosted skills carry no local package dir / code half by construction.
+            const skills = new Map();
+            for (const r of skillRows) {
+                const slug = typeof r["slug"] === "string" ? r["slug"] : null;
+                const path = `postgrest:coltrane_skills/${slug ?? "?"}`;
+                try {
+                    if (!slug)
+                        throw new Error(`missing required "slug" field`);
+                    if (skills.has(slug))
+                        throw new Error(`duplicate skill slug "${slug}"`);
+                    const meta = {
+                        slug,
+                        description: r["description"] ?? undefined,
+                        input_type: r["input_type"] ?? undefined,
+                        output_type: r["output_type"] ?? undefined,
+                        ...(typeof r["tier"] === "number" ? { permission: { tier: r["tier"] } } : {}),
+                        ...(typeof r["skill_md"] === "string" ? { md: r["skill_md"] } : {}),
+                    };
+                    for (const k of Object.keys(meta))
+                        if (meta[k] === undefined)
+                            delete meta[k];
+                    const check = SkillSchema.safeParse(meta);
+                    if (!check.success)
+                        throw new Error(`skill schema validation failed — ${zodWhy(check.error.issues)}`);
+                    skills.set(slug, check.data);
+                }
+                catch (e) {
+                    load_errors.push({ kind: "skill", path, slug, error: e instanceof Error ? e.message : String(e) });
+                }
+            }
+            // evals — no hosted table today; present and empty, the same shape as a genome
+            // root with no evals/ directory.
+            const evals = new Map();
+            return { core_types, domain_types, agents, standards, skills, evals, load_errors };
+        },
+        async upsert(cls, payload) {
+            const res = await fetch(`${ctx.baseUrl}/rest/v1/rpc/coltrane_genome_upsert`, {
+                method: "POST",
+                headers: {
+                    apikey: ctx.anonKey,
+                    Authorization: `Bearer ${ctx.bearer}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ p_class: cls, p_payload: payload }),
+            });
+            if (!res.ok) {
+                const text = await res.text();
+                let message = text || `store error ${res.status}`;
+                try {
+                    const parsed = JSON.parse(text);
+                    if (parsed.message)
+                        message = parsed.message;
+                }
+                catch { /* keep the raw text */ }
+                throw new Error(`genome upsert (${cls}) refused: ${message}`);
+            }
+        },
+    };
+}
+/** The hosted gig-queue seam for createToolSurface: queue one run through the governor-gated
+ *  dispatch RPC AS THE CALLER (member JWT — RLS + the governor gate decide). Queuing only;
+ *  a drain worker claims and runs it. Shape mirrors hosted_tools' member dispatch path. */
+export function postgrestQueueGig(ctx) {
+    return async (args) => {
+        const res = await fetch(`${ctx.baseUrl}/rest/v1/rpc/coltrane_gig_dispatch`, {
+            method: "POST",
+            headers: {
+                apikey: ctx.anonKey,
+                Authorization: `Bearer ${ctx.bearer}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                p_standard: args["standard_slug"],
+                p_mode: args["mode"] ?? "live",
+                p_input: args["input"] ?? {},
+                p_org_slug: args["org_slug"] ?? null,
+            }),
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            let message = text || `store error ${res.status}`;
+            try {
+                const parsed = JSON.parse(text);
+                if (parsed.message)
+                    message = parsed.message;
+            }
+            catch { /* keep the raw text */ }
+            throw new Error(message);
+        }
+        return { gig_id: JSON.parse(text), status: "queued" };
+    };
+}
+//# sourceMappingURL=genome_store.js.map

package/dist/src/genome_store.js.map

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

package/dist/src/hosted_tools.d.ts

@@ -0,0 +1,23 @@
+/** Everything a hosted tool needs from its host: where the org store is, and who is calling. */
+export interface HostedToolContext {
+    /** The org store's base URL (a Supabase project or PostgREST-compatible equivalent). */
+    baseUrl: string;
+    /** The store's public (anon) API key — required by PostgREST as `apikey`; not a secret. */
+    anonKey: string;
+    /** The caller's bearer: a member session JWT, or an issued ctk_ agent capability token. */
+    bearer: string;
+}
+export interface HostedToolResult {
+    text: string;
+    isError?: boolean;
+}
+export interface HostedTool {
+    name: string;
+    title: string;
+    description: string;
+    /** Plain JSON Schema for the tool's params — transport-agnostic, no schema-library coupling. */
+    paramsJsonSchema: Record<string, unknown>;
+    handler(args: Record<string, unknown>, ctx: HostedToolContext): Promise<HostedToolResult>;
+}
+export declare const HOSTED_TOOLS: HostedTool[];
+export declare function hostedToolByName(name: string): HostedTool;

package/dist/src/hosted_tools.js

@@ -0,0 +1,170 @@
+// hosted_tools.ts — the INTERIM six-tool hosted surface. DEPRECATED in favor of the full
+// engine surface: `createToolSurface` (subpath "./tool_surface") mounts ALL engine tools
+// per-request, backed by a GenomeStore (subpath "./genome_store" — postgrestGenomeStore
+// rides the same {baseUrl, anonKey, bearer} context this module established). Kept because
+// the current deploy still consumes it; new hosts should mount the full surface instead.
+//
+// The original charter, still true of the pattern this module pioneered:
+// the hosted MCP tool surface, defined ONCE here (OSS, npm-published) and
+// consumed by any host: the Vercel app, a self-hosted wrapper, a test harness. The split of
+// responsibilities is the auth-boundary law applied to tooling:
+//
+//   * THE ENGINE (this module) owns what the tools ARE — names, schemas, store-facing
+//     behavior. It is dependency-free (plain fetch against a PostgREST-shaped org store)
+//     and auth-BLIND: it never decides whether a bearer is valid, it only routes by the
+//     bearer's CLASS, and the store refuses invalid credentials where the hashes live.
+//   * THE HOST owns transport and authentication — it verifies/obtains the bearer (OAuth
+//     browser login for humans, issued ctk_ capability tokens for agents), mounts these
+//     definitions on whatever MCP transport it serves, and passes the context in.
+//
+// Two bearer classes, per the mcp-auth model:
+//   * ctk_ agent capability token → security-definer RPCs (coltrane_mcp_*) resolve the
+//     token's hash inside the store and scope to its org + exact may_dispatch list.
+//   * a member session JWT → rides PostgREST directly; RLS scopes rows to the member, and
+//     dispatch runs the governor-gated RPC as them (auth.uid()).
+const isAgentBearer = (bearer) => bearer.startsWith("ctk_");
+const ok = (data) => ({ text: JSON.stringify(data) });
+const err = (message) => ({ text: message, isError: true });
+async function rpc(ctx, fn, body, asCaller) {
+    const res = await fetch(`${ctx.baseUrl}/rest/v1/rpc/${fn}`, {
+        method: "POST",
+        headers: {
+            apikey: ctx.anonKey,
+            // The JWT authenticates via the header (PostgREST verifies it; RLS/auth.uid() scope it).
+            // A ctk_ bearer is NOT a JWT — it authenticates inside the definer RPC via the body, and
+            // the transport rides the anon key.
+            Authorization: `Bearer ${asCaller ? ctx.bearer : ctx.anonKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        try {
+            const parsed = JSON.parse(text);
+            return err(parsed.message ?? text);
+        }
+        catch {
+            return err(text || `store error ${res.status}`);
+        }
+    }
+    return { text: text || "null" };
+}
+async function restGet(ctx, pathAndQuery) {
+    const res = await fetch(`${ctx.baseUrl}/rest/v1/${pathAndQuery}`, {
+        headers: {
+            apikey: ctx.anonKey,
+            Authorization: `Bearer ${ctx.bearer}`,
+            "Content-Type": "application/json",
+        },
+    });
+    const text = await res.text();
+    if (!res.ok)
+        return err(text || `store error ${res.status}`);
+    return { text };
+}
+export const HOSTED_TOOLS = [
+    {
+        name: "list_standards",
+        title: "List standards",
+        description: "The standards in your organizations' genome layers — what a gig can be.",
+        paramsJsonSchema: { type: "object", properties: {} },
+        async handler(_args, ctx) {
+            if (isAgentBearer(ctx.bearer))
+                return rpc(ctx, "coltrane_mcp_standards", { p_bearer: ctx.bearer }, false);
+            return restGet(ctx, "coltrane_standards?select=slug,version,status,domain,output_types,org_id&order=slug");
+        },
+    },
+    {
+        name: "list_gigs",
+        title: "List gigs",
+        description: "The queue and the history — the gig table IS the queue. Optionally filter by status (queued|running|completed|failed|aborted).",
+        paramsJsonSchema: {
+            type: "object",
+            properties: {
+                status: { type: "string", description: "queued|running|completed|failed|aborted" },
+                limit: { type: "number" },
+            },
+        },
+        async handler(args, ctx) {
+            if (isAgentBearer(ctx.bearer))
+                return err("agent tokens read single gigs via gig_status; listing is a member surface");
+            const limit = Math.min(Number(args["limit"] ?? 25), 100);
+            const status = args["status"] ? `&status=eq.${encodeURIComponent(String(args["status"]))}` : "";
+            return restGet(ctx, `coltrane_gigs?select=id,standard_slug,status,mode,total_cost_usd,dispatched_by,acting_for,created_at,completed_at&order=created_at.desc&limit=${limit}${status}`);
+        },
+    },
+    {
+        name: "gig_status",
+        title: "Gig status",
+        description: "One gig's status, spend, and reproducibility keys (org-scoped).",
+        paramsJsonSchema: {
+            type: "object",
+            properties: { gig_id: { type: "string" } },
+            required: ["gig_id"],
+        },
+        async handler(args, ctx) {
+            const gig = String(args["gig_id"] ?? "");
+            if (isAgentBearer(ctx.bearer))
+                return rpc(ctx, "coltrane_mcp_gig_status", { p_bearer: ctx.bearer, p_gig: gig }, false);
+            return restGet(ctx, `coltrane_gigs?select=id,standard_slug,status,mode,total_cost_usd,genome_hash,run_fingerprint,started_at,completed_at,manifest&id=eq.${encodeURIComponent(gig)}`);
+        },
+    },
+    {
+        name: "gig_outputs",
+        title: "Gig outputs",
+        description: "A gig's sealed outputs with their provenance (content_sha + input_shas).",
+        paramsJsonSchema: {
+            type: "object",
+            properties: { gig_id: { type: "string" } },
+            required: ["gig_id"],
+        },
+        async handler(args, ctx) {
+            const gig = String(args["gig_id"] ?? "");
+            if (isAgentBearer(ctx.bearer))
+                return rpc(ctx, "coltrane_mcp_gig_outputs", { p_bearer: ctx.bearer, p_gig: gig }, false);
+            return restGet(ctx, `coltrane_outputs?select=id,domain_type,agent_slug,phase,content_sha,input_shas,created_at,data&gig_id=eq.${encodeURIComponent(gig)}&order=created_at`);
+        },
+    },
+    {
+        name: "roster",
+        title: "Roster",
+        description: "The named players and humans of your organizations — names, forebears, status (member surface).",
+        paramsJsonSchema: { type: "object", properties: {} },
+        async handler(_args, ctx) {
+            if (isAgentBearer(ctx.bearer))
+                return err("the roster is a member surface; agent tokens read gigs and outputs");
+            return restGet(ctx, "coltrane_agent?select=slug,name,kind,status,named_from_forebear&order=slug");
+        },
+    },
+    {
+        name: "dispatch_gig",
+        title: "Dispatch a gig",
+        description: "Queue one run of a standard. Queuing only — a drain worker claims and runs it. Members dispatch as themselves (governor-gated); agent tokens are limited to their exact may_dispatch list.",
+        paramsJsonSchema: {
+            type: "object",
+            properties: {
+                standard_slug: { type: "string" },
+                mode: { type: "string", enum: ["rehearsal", "studio", "live"] },
+                input: { type: "object" },
+                org_slug: { type: "string", description: "Disambiguates when you belong to several orgs carrying the standard." },
+            },
+            required: ["standard_slug", "mode", "input"],
+        },
+        async handler(args, ctx) {
+            if (isAgentBearer(ctx.bearer)) {
+                const out = await rpc(ctx, "coltrane_mcp_dispatch", { p_bearer: ctx.bearer, p_standard: args["standard_slug"], p_mode: args["mode"], p_input: args["input"] ?? {} }, false);
+                return out.isError ? out : ok({ gig_id: JSON.parse(out.text), status: "queued" });
+            }
+            const out = await rpc(ctx, "coltrane_gig_dispatch", { p_standard: args["standard_slug"], p_mode: args["mode"], p_input: args["input"] ?? {}, p_org_slug: args["org_slug"] ?? null }, true);
+            return out.isError ? out : ok({ gig_id: JSON.parse(out.text), status: "queued" });
+        },
+    },
+];
+export function hostedToolByName(name) {
+    const tool = HOSTED_TOOLS.find((t) => t.name === name);
+    if (!tool)
+        throw new Error(`unknown hosted tool: ${name}`);
+    return tool;
+}
+//# sourceMappingURL=hosted_tools.js.map

package/dist/src/hosted_tools.js.map

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

package/dist/src/index.d.ts

@@ -18,6 +18,9 @@ export * from "./canonical_core_types.js";
 export * from "./canonical_form.js";
 export * from "./ledger.js";
 export * from "./outputs.js";
+export * from "./output_mirror.js";
+export * from "./hosted_tools.js";
+export * from "./genome_store.js";
 export * from "./reuse.js";
 export * from "./charter.js";
 export * from "./server.js";

package/dist/src/index.js

@@ -18,6 +18,9 @@ export * from "./canonical_core_types.js";
 export * from "./canonical_form.js";
 export * from "./ledger.js";
 export * from "./outputs.js";
+export * from "./output_mirror.js";
+export * from "./hosted_tools.js";
+export * from "./genome_store.js";
 export * from "./reuse.js";
 export * from "./charter.js";
 export * from "./server.js";

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/src/mcp.js

@@ -21,7 +21,16 @@ export const MCP_TOOLS = [
     { slug: "type_resolve", category: "understand", input_schema: obj({ core_type: "string", extends: "string", domain: "string", required_fields: "array" }), output_schema: obj({ action: "string", candidates: "array", recommendation: "object" }) },
     { slug: "type_browse", category: "understand", input_schema: obj({ domain: "string", extends: "string", status: "string", min_usage: "number" }), output_schema: obj({ types: "array", stats: "object" }) },
     { slug: "tool_registry_browse", category: "understand", input_schema: obj({ category: "string" }), output_schema: obj({ tools: "array", usage_stats: "array", dependency_map: "object" }) },
-    { slug: "output_query", category: "understand", input_schema: obj({ domain_type: "string", gig_id: "string", agent_slug: "string", data_filter: "object" }), output_schema: obj({ outputs: "array", total_count: "number" }) },
+    // Discoverability parity (tests/genome_browse_parity.test.ts): every genome class that is
+    // authorable over MCP is listable over MCP. Standards and agents lacked these because the
+    // registry grew up in a working tree where `ls standards/` was free — the first hosted mount
+    // (no filesystem) turned that local assumption into an undiscoverable-slug hole.
+    { slug: "standard_browse", category: "understand", input_schema: obj({ domain: "string", status: "string" }), output_schema: obj({ standards: "array", count: "number" }) },
+    { slug: "agent_browse", category: "understand", input_schema: obj({ domain: "string", primitive: "string" }), output_schema: obj({ agents: "array", count: "number" }) },
+    // Tier-1 traversal by default (compact rows: id, gig_id, agent, phase, content_sha, preview,
+    // storage_ref…). `output_id`/`content_sha` + `include_data:true` is the deeper second pass —
+    // it fetches ONE output's full payload from the artifact tier (local mirror, or remote when drained).
+    { slug: "output_query", category: "understand", input_schema: obj({ domain_type: "string", gig_id: "string", agent_slug: "string", data_filter: "object", output_id: "string", content_sha: "string", include_data: "boolean" }), output_schema: obj({ outputs: "array", total_count: "number" }) },
     { slug: "output_trace", category: "understand", input_schema: obj({ output_id: "string", direction: "string", max_depth: "number" }), output_schema: obj({ graph: "object", root_signals: "array", terminal_outputs: "array" }) },
     { slug: "charter_read", category: "understand", input_schema: obj({ path: "string" }), output_schema: obj({ products: "array", goals: "array", pain_points: "array", tech_stack: "array", access_grants: "array" }) },
     // #217 — advertised contract == handler. The five filters src/server.ts actually reads, and