@unson/brainbase-mcp 0.1.0 → 0.2.2

package/dist/server.d.ts

@@ -26,7 +26,7 @@ export declare const toolDefinitions: readonly [{
     };
 }, {
     readonly name: "search";
-    readonly description: "Search canonical local Graph, Personal KG, relationships, and decisions.";
+    readonly description: "Search all canonical local stores: Graph entities, Personal KG, relationships, and decisions. Use this for people and projects.";
     readonly inputSchema: {
         readonly type: "object";
         readonly required: readonly ["query"];
@@ -44,7 +44,7 @@ export declare const toolDefinitions: readonly [{
     };
 }, {
     readonly name: "search_personal_kg";
-    readonly description: "Search owner-local Personal KG only.";
+    readonly description: "Search owner-local Personal KG only. People and projects are Graph entities, so use search for them.";
     readonly inputSchema: {
         readonly type: "object";
         readonly required: readonly ["query"];
@@ -71,9 +71,301 @@ export declare const toolDefinitions: readonly [{
             };
         };
     };
+}, {
+    readonly name: "brainbase_onboarding_start";
+    readonly description: "Start a local first-value onboarding run from actually callable sources. The result exposes runId (also id); pass runId to every later onboarding tool.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["valueTarget", "sources"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+                readonly description: "Optional Personal OS directory.";
+            };
+            readonly valueTarget: {
+                readonly type: "string";
+                readonly description: "One concrete question the first useful answer should resolve.";
+            };
+            readonly sources: {
+                readonly type: "array";
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly type: "object";
+                    readonly required: readonly ["id", "mode", "status"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                        };
+                        readonly mode: {
+                            readonly enum: readonly ["mcp", "drive", "gmail", "local_folder", "single_document"];
+                        };
+                        readonly status: {
+                            readonly enum: readonly ["ready", "waiting_for_authorization", "unavailable", "error", "unconfirmed"];
+                        };
+                        readonly evidencePointer: {
+                            readonly type: "string";
+                        };
+                        readonly permissionScope: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly detail: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    readonly name: "brainbase_onboarding_get";
+    readonly description: "Read a connected-world onboarding run without exposing source or answer bodies.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["runId"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+            };
+            readonly runId: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "brainbase_onboarding_ingest";
+    readonly description: "Ingest one selected source receipt under source plus review candidates. Do not flatten sourceId or receipt fields at the top level.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["runId", "source", "candidates"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+            };
+            readonly runId: {
+                readonly type: "string";
+                readonly description: "runId returned by brainbase_onboarding_start.";
+            };
+            readonly source: {
+                readonly type: "object";
+                readonly required: readonly ["sourceId", "evidencePointer", "contentHash", "permissionSnapshot", "collectionStatus"];
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly sourceId: {
+                        readonly type: "string";
+                    };
+                    readonly evidencePointer: {
+                        readonly type: "string";
+                    };
+                    readonly contentHash: {
+                        readonly type: "string";
+                    };
+                    readonly permissionSnapshot: {
+                        readonly type: "object";
+                    };
+                    readonly collectionStatus: {
+                        readonly const: "collected";
+                    };
+                };
+            };
+            readonly candidates: {
+                readonly type: "array";
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly type: "object";
+                    readonly required: readonly ["kind", "payload", "observationClass", "evidenceId"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly kind: {
+                            readonly type: "string";
+                        };
+                        readonly payload: {
+                            readonly type: "object";
+                        };
+                        readonly observationClass: {
+                            readonly enum: readonly ["observed", "inferred"];
+                        };
+                        readonly evidenceId: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    readonly name: "brainbase_onboarding_review";
+    readonly description: "Submit review decisions in actions. Inferred candidates cannot be approved or merged; use edit with a human-confirmed payload, or reject.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["runId", "actions"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+            };
+            readonly runId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 200;
+            };
+            readonly actions: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly oneOf: readonly [{
+                        readonly type: "object";
+                        readonly required: readonly ["candidateId", "decision", "reason"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly candidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                            readonly decision: {
+                                readonly const: "approve";
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 500;
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["candidateId", "decision", "reason", "payload"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly candidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                            readonly decision: {
+                                readonly const: "edit";
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 500;
+                            };
+                            readonly payload: {
+                                readonly type: "object";
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["candidateId", "decision", "reason"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly candidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                            readonly decision: {
+                                readonly const: "reject";
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 500;
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["candidateId", "decision", "reason", "mergeIntoCandidateId"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly candidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                            readonly decision: {
+                                readonly const: "merge";
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 500;
+                            };
+                            readonly mergeIntoCandidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                        };
+                    }];
+                };
+            };
+        };
+    };
+}, {
+    readonly name: "brainbase_onboarding_first_value";
+    readonly description: "Finish onboarding in two calls. First choose action=record with an answer hash and promoted canonical IDs. Then choose action=review with useful or not_useful.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["runId", "action"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+                readonly description: "Optional Personal OS directory.";
+            };
+            readonly runId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 200;
+                readonly description: "runId returned by the previous onboarding step.";
+            };
+            readonly action: {
+                readonly enum: readonly ["record", "review"];
+                readonly description: "Use record first. Use review only after the answer receipt has been recorded.";
+            };
+            readonly answerHash: {
+                readonly type: "string";
+                readonly pattern: "^sha256:[a-f0-9]{64}$";
+                readonly description: "Required for action=record. SHA-256 of the answer body; the body itself is not stored.";
+            };
+            readonly usedCanonicalIds: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 200;
+                };
+                readonly description: "Required for action=record. Use only promotedCanonicalIds returned by review.";
+            };
+            readonly verdict: {
+                readonly enum: readonly ["useful", "not_useful"];
+                readonly description: "Required for action=review.";
+            };
+            readonly missingContext: {
+                readonly type: "array";
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 200;
+                };
+                readonly description: "Optional short labels for context the answer still lacked.";
+            };
+        };
+    };
 }, {
     readonly name: "get_ontology";
-    readonly description: "Return the bundled immutable Brainbase Portable Ontology Kernel release.";
+    readonly description: "Return a beginner guide followed by the bundled immutable Brainbase Portable Ontology Kernel release.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {};