@littlebigbrain/mcp 0.7.1 → 0.8.0

package/README.md

@@ -119,7 +119,7 @@ its original identifiers; inspect it with SPARQL when choosing query predicates.
 | `lbb_embeddings_manage` | Set up or refresh embeddings, or change the embedding model. |
 | `lbb_embeddings_delete` | Delete an embedding and its stored vectors. |
 | `lbb_commit` | Write or retract JSON facts, or record search feedback. |
-| `lbb_configure` | Define record types and relationships, or publish validation rules. |
+| `lbb_configure` | Define record types and relationships, list and apply ontology starters (CRM, documents, work), or publish validation rules. |
 | `lbb_evals` | Label query results and check whether later queries return the expected answers. |
 | `lbb_models` | Compare retrieval settings and read model training datasets. |
 

package/dist/tool-contracts.js

@@ -353,6 +353,17 @@ export const inspectInputSchema = z.discriminatedUnion("action", [
     })
         .strict(),
     z.object({ action: z.literal("metadata"), ...readScope }).strict(),
+    z
+        .object({
+        action: z.literal("ontology_suggestions"),
+        status: z
+            .enum(["open", "accepted", "dismissed", "superseded"])
+            .optional()
+            .describe("Only suggestions in this state; default all"),
+        limit: z.number().int().min(1).max(500).optional(),
+        ...readScope,
+    })
+        .strict(),
     z
         .object({
         action: z.literal("entity"),
@@ -562,6 +573,80 @@ export const configureInputSchema = z.discriminatedUnion("action", [
         ...graphScope,
     })
         .strict(),
+    z
+        .object({
+        action: z.literal("list_starters"),
+        ...graphScope,
+    })
+        .strict(),
+    z
+        .object({
+        action: z.literal("apply_starter"),
+        starter: z
+            .string()
+            .min(1)
+            .describe("Starter id: crm, documents or work (list_starters names them)"),
+        dry_run: z
+            .boolean()
+            .optional()
+            .describe("Answer the operations applying would run, and the resulting version, without writing"),
+        expected_ontology_version: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Refuse when the graph's ontology version differs"),
+        ...graphScope,
+    })
+        .strict(),
+    z
+        .object({
+        action: z.literal("suggest_ontology_change"),
+        title: z
+            .string()
+            .min(1)
+            .max(200)
+            .describe("Short imperative text, e.g. 'Add class Contractor'"),
+        change: z
+            .array(ontologyEvolveOpSchema)
+            .min(1)
+            .max(64)
+            .describe("The ontology operations a person applies by accepting, in order (same shapes as evolve_ontology ops)"),
+        rationale: z
+            .string()
+            .max(4000)
+            .optional()
+            .describe("Why the ontology needs the change; cite what you saw"),
+        anchor: z
+            .object({
+            kind: z.enum(["ontology", "class", "property", "relation"]),
+            name: z.string().max(200).optional(),
+        })
+            .strict()
+            .optional()
+            .describe("The class, property or relation the change is about"),
+        agent: z
+            .string()
+            .max(200)
+            .optional()
+            .describe("Your name as the producer, shown to reviewers"),
+        key: z
+            .string()
+            .max(255)
+            .optional()
+            .describe("Idempotency key ([A-Za-z0-9-_.:/]); filing again with the same key revises the suggestion"),
+        evidence: z
+            .object({
+            records: z.number().int().nonnegative().optional(),
+            source_fields: z.array(z.string()).max(200).optional(),
+            samples: z.array(jsonObjectSchema).max(20).optional(),
+        })
+            .strict()
+            .optional()
+            .describe("What you saw: record count, fields, up to 20 sample records"),
+        ...graphScope,
+    })
+        .strict(),
 ]);
 /**
  * MCP's `registerTool` advertises a JSON Schema for an input only when the

package/dist/tools.js

@@ -7,7 +7,7 @@ import { analyze, assertCursorScope, contentHashKey, decodeQueryCursor, effectiv
 export function registerLbbTools(server, client, options = {}) {
     registerRdfTool(server, client);
     server.registerTool("lbb_inspect", {
-        description: "Read graph context and exact graph facts. Actions: guide, graphs, publication, ontology, ontology_conformance, schema, ontology_search, metadata, entity. graphs works before bootstrap; publication reports whether writes are queryable. ontology and schema return complete entries with page_size, section and cursor; follow next until absent. schema reads active native ontology/SHACL metadata without running validation. Query asserted RDF/OWL axioms separately with lbb_query. ontology_conformance serves the durable report referenced by the pinned published root. entity returns one node's attributes and current relationships from the RDF read. For a node's past values, run SPARQL with as_of_commit_seq through lbb_query. Use lbb_query with SPARQL property paths for precise path selection.",
+        description: "Read graph context and exact graph facts. Actions: guide, graphs, publication, ontology, ontology_conformance, schema, ontology_search, metadata, entity, ontology_suggestions. graphs works before bootstrap; ontology_suggestions lists the ontology change suggestions that wait for review (or were decided). publication reports whether writes are queryable. ontology and schema return complete entries with page_size, section and cursor; follow next until absent. schema reads active native ontology/SHACL metadata without running validation. Query asserted RDF/OWL axioms separately with lbb_query. ontology_conformance serves the durable report referenced by the pinned published root. entity returns one node's attributes and current relationships from the RDF read. For a node's past values, run SPARQL with as_of_commit_seq through lbb_query. Use lbb_query with SPARQL property paths for precise path selection.",
         inputSchema: inspectWireSchema,
         annotations: READ_ONLY,
     }, (rawArgs) => {
@@ -40,6 +40,11 @@ export function registerLbbTools(server, client, options = {}) {
                     });
                 case "metadata":
                     return target.metadata();
+                case "ontology_suggestions":
+                    return target.ontology.suggestions.list({
+                        status: args.status,
+                        limit: args.limit ?? 50,
+                    });
                 case "entity":
                     return target.entityDetail({
                         ...(args.entity_id
@@ -681,7 +686,7 @@ export function registerLbbTools(server, client, options = {}) {
         });
     }));
     server.registerTool("lbb_configure", {
-        description: "Manage native schema metadata. Actions: define_ontology (friendly spec with super_types), evolve_ontology (ordered edits including add_super_types), publish_schema (SHACL activation). All support dry_run previews. Definition/import here extracts native metadata; it does NOT store the complete RDF/OWL document as queryable graph facts. Use lbb_rdf import for full OWL and lbb_rdf update for additive INSERT DATA revisions; RDF deletions are unsupported. Publish_schema accepts unchanged ontology plus shapes; use define/evolve for native ontology changes. Publication enqueues durable conformance; a preview does not validate the whole graph.",
+        description: "Manage native schema metadata. Actions: define_ontology (friendly spec with super_types), evolve_ontology (ordered edits including add_super_types), list_starters (the base ontologies crm, documents and work, each with its status on the graph: absent, partial or applied, what applying adds, and conflicts), apply_starter (add what the graph lacks of a starter in one ontology version; a relation the graph has is widened; refused with starter_conflict when the graph holds a term differently; dry_run previews), publish_schema (SHACL activation), suggest_ontology_change (file a change for a person to review instead of applying it; prefer it when the graph's owner reviews ontology changes, and list the result with lbb_inspect action=ontology_suggestions). define, evolve and publish support dry_run previews. Definition/import here extracts native metadata; it does NOT store the complete RDF/OWL document as queryable graph facts. Use lbb_rdf import for full OWL and lbb_rdf update for additive INSERT DATA revisions; RDF deletions are unsupported. Publish_schema accepts unchanged ontology plus shapes; use define/evolve for native ontology changes. Publication enqueues durable conformance; a preview does not validate the whole graph.",
         inputSchema: configureWireSchema,
         annotations: MUTATING,
     }, (rawArgs) => {
@@ -700,6 +705,27 @@ export function registerLbbTools(server, client, options = {}) {
                     dry_run: args.dry_run,
                 }));
             }
+            if (args.action === "suggest_ontology_change") {
+                const agent = args.agent ?? "mcp agent";
+                return scoped(client, args.graph).ontology.suggestions.create({
+                    title: args.title,
+                    rationale: args.rationale ?? "",
+                    change: args.change,
+                    origin: { kind: "agent", id: agent, label: agent },
+                    ...(args.anchor ? { anchor: args.anchor } : {}),
+                    ...(args.key ? { key: args.key } : {}),
+                    ...(args.evidence ? { evidence: args.evidence } : {}),
+                });
+            }
+            if (args.action === "list_starters") {
+                return scoped(client, args.graph).ontology.starters.list();
+            }
+            if (args.action === "apply_starter") {
+                return scoped(client, args.graph).ontology.starters.apply(args.starter, {
+                    dryRun: args.dry_run,
+                    expectedOntologyVersion: args.expected_ontology_version,
+                });
+            }
             if (args.action === "evolve_ontology") {
                 return scoped(client, args.graph).ontology.evolve({
                     ops: args.ops,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@littlebigbrain/mcp",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "MCP server for little big brain: search, graph queries, and data import",
   "license": "Apache-2.0",
   "repository": {
@@ -52,7 +52,7 @@
     "test:coverage": "npm run clean:test && tsc -p tsconfig.test.json && node --test --experimental-test-coverage --test-coverage-include=test-dist/*.js --test-coverage-exclude=test-dist/*.test.js --test-coverage-exclude=test-dist/stdio.js --test-coverage-exclude=test-dist/test-support.js --test-coverage-lines=90 --test-coverage-branches=70 --test-coverage-functions=85 \"test-dist/**/*.test.js\""
   },
   "dependencies": {
-    "@littlebigbrain/client": "^0.15.0",
+    "@littlebigbrain/client": "^0.17.0",
     "@modelcontextprotocol/sdk": "^1",
     "zod": "^3"
   },