@lifesi/genesis-mcp 0.1.5 → 0.1.8

package/dist/hives-resources.js

@@ -8,7 +8,7 @@ export function hivesResourceInputSchema(id, fallback) {
     const upload = id.startsWith('hives_upload_object');
     return { type: 'object', properties: { ...keyProperties, ...(upload ? { body_base64: { type: 'string', maxLength: Math.ceil(OBJECT_BYTES / 3) * 4 }, content_type: { type: 'string', maxLength: 512 } } : {}) }, required: ['project_id', 'bucket_id', 'key', ...(upload ? ['body_base64'] : [])], additionalProperties: false };
 }
-export const isHivesResourceTool = (id) => /^(?:hives_marketplace_(?:categories|featured|installed|get_installation|uninstall|reconcile|list_packages|publish|get_package|install|update|list_versions)|hives_.*_native_queue|hives_(?:(?:list_volumes|create_volume|get_volume|delete_volume|mount_volume|unmount_volume)|list_buckets|create_bucket|get_bucket|delete_bucket|list_objects|upload_object(?:_by_key)?|delete_object(?:_by_key)?|download_object_by_key|get_cors_config|set_cors_config|generate_presigned_url|reconcile|list_runtimes|get_runtime|select_runtime|list_project_runtimes))$/.test(id);
+export const isHivesResourceTool = (id) => /^(?:hives_marketplace_(?:categories|featured|installed|get_installation|uninstall|reconcile|list_packages|publish|get_package|install|update|list_versions)|hives_(?:get|configure|remove)_native_queue_consumer|hives_.*_native_queue|hives_.*_native_topic|hives_(?:(?:list_volumes|create_volume|get_volume|delete_volume|mount_volume|unmount_volume)|list_buckets|create_bucket|get_bucket|delete_bucket|list_objects|upload_object(?:_by_key)?|delete_object(?:_by_key)?|download_object_by_key|get_cors_config|set_cors_config|generate_presigned_url|reconcile|list_runtimes|get_runtime|select_runtime|list_project_runtimes))$/.test(id);
 function text(value) { if (typeof value !== 'string')
     throw new Error('Invalid Hives resource input.'); return value; }
 function decode(value) { const s = text(value); if (s.length > Math.ceil(OBJECT_BYTES / 3) * 4 || s.length % 4 || !/^[A-Za-z0-9+/]*={0,2}$/.test(s))
@@ -26,6 +26,14 @@ export async function callHivesResourceTool(g, id, a, signal) {
     const cells = g.hives.cells;
     const buzz = g.hives.queues;
     switch (id) {
+        case 'hives_list_native_topic': return g.hives.topics.list(project(), options);
+        case 'hives_inspect_native_topic': return g.hives.topics.get(project(), text(a.topic_id), options);
+        case 'hives_create_native_topic': return g.hives.topics.create(project(), body(), options);
+        case 'hives_delete_native_topic': return g.hives.topics.remove(project(), text(a.topic_id), options);
+        case 'hives_subscriptions_native_topic': return g.hives.topics.subscriptions.list(project(), text(a.topic_id), options);
+        case 'hives_subscribe_native_topic': return g.hives.topics.subscriptions.add(project(), text(a.topic_id), text(body()?.queueId), options);
+        case 'hives_unsubscribe_native_topic': return g.hives.topics.subscriptions.remove(project(), text(a.topic_id), text(a.subscription_id), options);
+        case 'hives_publish_native_topic': return g.hives.topics.publish(project(), text(a.topic_id), body(), options);
         case 'hives_list_volumes': return g.hives.volumes.list(project(), { page: a.page, per_page: a.per_page }, options);
         case 'hives_get_volume': return g.hives.volumes.get(project(), text(a.volume_id), options);
         case 'hives_create_volume': return g.hives.volumes.create(project(), body(), options);
@@ -57,6 +65,9 @@ export async function callHivesResourceTool(g, id, a, signal) {
         case 'hives_list_project_runtimes': return g.hives.runtimes.project(project(), options);
         case 'hives_get_runtime': return g.hives.runtimes.get(text(a.name), options);
         case 'hives_select_runtime': return g.hives.runtimes.select({ wasi: text(a.wasi), runner: text(a.runner), artifact: text(a.artifact) }, options);
+        case 'hives_get_native_queue_consumer': return buzz.consumer.get(project(), queue(), options);
+        case 'hives_configure_native_queue_consumer': return buzz.consumer.configure(project(), queue(), body(), options);
+        case 'hives_remove_native_queue_consumer': return buzz.consumer.remove(project(), queue(), options);
         case 'hives_list_native_queue': return buzz.list(project(), options);
         case 'hives_inspect_native_queue': return buzz.get(project(), queue(), options);
         case 'hives_create_native_queue': return buzz.create(project(), body(), options);

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { createServer, createHttpServer, serveStdio } from './server.js';
 export { tools, specTools, metaTools, searchTools, callTool } from './tools.js';
 export declare function cli(args: string[]): Promise<void>;
+export { nativeLoginCredentials } from './native-credentials.js';

package/dist/index.js

@@ -9,3 +9,4 @@ export async function cli(args) {
     }
     await serveStdio();
 }
+export { nativeLoginCredentials } from './native-credentials.js';

package/dist/minds.d.ts

@@ -0,0 +1,46 @@
+import { type Genesis } from '@lifesi/genesis';
+export declare function mindsInputSchema(id: string, schema: Record<string, unknown>): Record<string, unknown>;
+export declare function callMindsTool(genesis: Genesis, id: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+    schema_version: "minds.controller.v1";
+    items: import("@lifesi/genesis").components["schemas"]["Minds.Mind"][];
+    next_cursor: string | null;
+    context_sha256: string;
+} | ({
+    schema_version: "minds.controller.v1";
+    mind_id: string;
+    organization_id: string;
+    project_id: string;
+    name: string;
+    region: string;
+    plan: "free" | "pro";
+    capacity: import("@lifesi/genesis").components["schemas"]["Minds.Capacity"];
+    observed_capacity: import("@lifesi/genesis").components["schemas"]["Minds.Capacity"] | null;
+    services: string[];
+    volume_id: string;
+    base_url: string;
+    desired_state: "running" | "stopped" | "deleted";
+    observed_state: "pending" | "running" | "stopped" | "deleted" | "failed" | "uncertain";
+    desired_generation: number;
+    observed_generation: number;
+    status: "ready" | "provisioning" | "stopped" | "deleted" | "failed" | "uncertain";
+    capacity_applied: boolean;
+    operation_id: string | null;
+    error_code: string | null;
+    created_at: string;
+    updated_at: string;
+} & {
+    [key: string]: unknown;
+}) | {
+    item: import("@lifesi/genesis").components["schemas"]["Minds.EpisodicEvent"] | null;
+} | {
+    id: string;
+} | ({
+    id: string;
+    content: string;
+    timestamp: string;
+    event_type: "Conversation" | "Command" | "Query" | "Document" | "Error" | "Success" | "Learning" | "Decision" | "Action" | "Context" | "Knowledge";
+    summary?: string | null;
+    tags: string[];
+} & {
+    [key: string]: unknown;
+})[]>;

package/dist/minds.js

@@ -0,0 +1,27 @@
+import { GenesisError } from '@lifesi/genesis';
+export function mindsInputSchema(id, schema) {
+    if (id !== 'minds_createMind')
+        return schema;
+    return { ...schema, properties: { ...schema.properties,
+            idempotency_key: { type: 'string', format: 'uuid', description: 'Persisted UUID4 for this creation intent. Keep it after an uncertain outcome.' },
+            context_sha256: { type: 'string', pattern: '^[a-f0-9]{64}$', description: 'context_sha256 from the current Minds list; an assertion, not authority.' }, }, required: [...schema.required, 'idempotency_key', 'context_sha256'], additionalProperties: false };
+}
+export async function callMindsTool(genesis, id, args, signal) {
+    if (id === 'minds_listMinds')
+        return genesis.minds.list(args, { signal });
+    if (id === 'minds_getMind')
+        return genesis.request('minds_getMind', args, { signal });
+    if (id === 'minds_getEpisodicMemory')
+        return genesis.request('minds_getEpisodicMemory', args, { signal });
+    if (id === 'minds_insertEpisodicMemory')
+        return genesis.request('minds_insertEpisodicMemory', args, { signal });
+    if (id === 'minds_searchMemory')
+        return genesis.request('minds_searchMemory', args, { signal });
+    if (id === 'minds_createMind' && Object.keys(args).every(key => ['body', 'idempotency_key', 'context_sha256'].includes(key))
+        && typeof args.idempotency_key === 'string' && typeof args.context_sha256 === 'string'
+        && args.body && typeof args.body === 'object' && !Array.isArray(args.body)
+        && Object.keys(args.body).length === 1 && typeof args.body.name === 'string') {
+        return genesis.minds.create(args.body.name, { idempotencyKey: args.idempotency_key, contextSha256: args.context_sha256, signal });
+    }
+    throw new GenesisError({ status: 0, type: 'invalid_request', operationId: id, message: 'Minds requires its exact input schema and retained creation context/key.' });
+}

package/dist/native-credentials.d.ts

@@ -0,0 +1,9 @@
+import { type CredentialStore } from '@lifesi/genesis-cli/store';
+import type { CredentialProvider } from '@lifesi/genesis';
+/** Reuse the CLI's exact OS-keychain entry and rotation; never print or export it.
+ * GenesisClient gives explicit options/environment credentials precedence. */
+export declare function nativeLoginCredentials(options?: {
+    store?: () => Promise<CredentialStore>;
+    fetch?: typeof fetch;
+    env?: Record<string, string | undefined>;
+}): CredentialProvider;

package/dist/native-credentials.js

@@ -0,0 +1,11 @@
+import { authConfig, savedLoginProvider } from '@lifesi/genesis-cli/auth';
+import { keychainStore } from '@lifesi/genesis-cli/store';
+/** Reuse the CLI's exact OS-keychain entry and rotation; never print or export it.
+ * GenesisClient gives explicit options/environment credentials precedence. */
+export function nativeLoginCredentials(options = {}) {
+    let provider;
+    return async () => {
+        provider ??= (async () => savedLoginProvider(authConfig(options.env ?? process.env, options.fetch ?? fetch), await (options.store ?? keychainStore)()))();
+        return await (await provider)();
+    };
+}

package/dist/server.js

@@ -1,3 +1,4 @@
+import { nativeLoginCredentials } from './native-credentials.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
@@ -5,12 +6,13 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 import http from 'node:http';
 import { callTool, tools } from './tools.js';
 export function createServer(opts = {}) {
-    const server = new Server({ name: 'genesis', version: '0.1.5' }, {
+    const configured = { ...opts, credentials: opts.credentials ?? nativeLoginCredentials({ fetch: opts.fetch }) };
+    const server = new Server({ name: 'genesis', version: '0.1.8' }, {
         capabilities: { tools: {} },
         instructions: 'Genesis: one API for Foundry (inference), Hives (compute), Relays (DNS) and LifeID keys. Use the named tools for common tasks; use genesis_search_tools + genesis_call for anything else.',
     });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: tools() }));
-    server.setRequestHandler(CallToolRequestSchema, async (req, extra) => callTool(opts, req.params.name, (req.params.arguments ?? {}), extra.signal));
+    server.setRequestHandler(CallToolRequestSchema, async (req, extra) => callTool(configured, req.params.name, (req.params.arguments ?? {}), extra.signal));
     return server;
 }
 /** stdio: credential from GENESIS_API_KEY / GENESIS_TOKEN (or `credentials` provider). */

package/dist/tools.js

@@ -1,15 +1,16 @@
+import { mindsInputSchema, callMindsTool } from './minds.js';
 import { callHivesResourceTool, hivesResourceInputSchema, isHivesResourceTool } from './hives-resources.js';
 import { createHivesNodeTransport } from './hives-node-transport.js';
 import { BEACONS_PROVISION_OPERATION, beaconsInputSchema, callBeaconsProvision } from './beacons.js';
 import { fleetsInputSchema, isFleetsLifecycleTool, callFleetsLifecycleTool } from './fleets.js';
-import { Genesis, GenesisError, MAX_WASM_BYTES, hivesResponseBytes, operationTable } from '@lifesi/genesis';
+import { isFoundryBillingOperation, Genesis, GenesisError, MAX_WASM_BYTES, hivesResponseBytes, operationTable } from '@lifesi/genesis';
 const uploadSchema = { type: 'object', properties: {
         project_id: { type: 'string', description: 'Project owned by the caller’s verified org' },
         wasm_base64: { type: 'string', maxLength: Math.ceil(MAX_WASM_BYTES / 3) * 4, description: 'Explicit standard-base64 content of a real WASM binary (decoded maximum 10 MiB)' },
         filename: { type: 'string', maxLength: 255 },
         git_sha: { type: 'string', minLength: 7, maxLength: 40 }, git_branch: { type: 'string', maxLength: 255 }, git_message: { type: 'string', maxLength: 1000 },
     }, required: ['project_id', 'wasm_base64'], additionalProperties: false };
-const inputSchema = (id, op) => id === 'hives_upload_deployment' ? uploadSchema : fleetsInputSchema(id, beaconsInputSchema(id, hivesResourceInputSchema(id, op.inputSchema)));
+const inputSchema = (id, op) => id.startsWith('minds_') ? mindsInputSchema(id, op.inputSchema) : isFoundryBillingOperation(id) ? { type: 'object', properties: ['foundry_ensureBillingProfile', 'foundry_createNativeCreditCheckout'].includes(id) ? { operation_key: { type: 'string', minLength: 1, maxLength: 255, description: 'Persisted original operation key; reconcile unknown outcomes before retrying.' } } : {}, required: ['foundry_ensureBillingProfile', 'foundry_createNativeCreditCheckout'].includes(id) ? ['operation_key'] : [], additionalProperties: false } : id === 'hives_upload_deployment' ? uploadSchema : fleetsInputSchema(id, beaconsInputSchema(id, hivesResourceInputSchema(id, op.inputSchema)));
 const all = Object.entries(operationTable);
 /** Operations callable by agents (everything except gateway-internal ones like credential verify). */
 export const callable = all.filter(([, op]) => !op.internal);
@@ -18,7 +19,7 @@ function describe(id, op) {
     return `${op.summary} (${op.method} ${op.path})${status}`;
 }
 const annotate = (op, id) => ({
-    readOnlyHint: op.method === 'GET', destructiveHint: id === 'hives_stop_deployment' || op.method === 'DELETE' || isHivesResourceTool(id) && /^hives_purge/.test(id),
+    readOnlyHint: op.method === 'GET' || id === 'minds_searchMemory', destructiveHint: id === 'hives_stop_deployment' || op.method === 'DELETE' || isHivesResourceTool(id) && /^hives_purge/.test(id),
     idempotentHint: isHivesResourceTool(id) && op.method !== 'GET' ? false : ['GET', 'PUT', 'DELETE'].includes(op.method) || id === BEACONS_PROVISION_OPERATION || op.path === '/v1/iam/runner/self-execution-grant', openWorldHint: true,
 });
 /** Curated tools: one per operation tagged x-mcp in the merged spec. */
@@ -68,7 +69,16 @@ async function invoke(genesis, id, args, signal) {
         return text(`Unknown operation "${id}". Use genesis_search_tools to find one.`, true);
     try {
         let r;
-        if (isFleetsLifecycleTool(id)) {
+        if (op.service === 'minds') {
+            r = await callMindsTool(genesis, id, args, signal);
+        }
+        else if (isFoundryBillingOperation(id)) {
+            const mutation = ['foundry_ensureBillingProfile', 'foundry_createNativeCreditCheckout'].includes(id);
+            if (Object.keys(args).some(k => k !== 'operation_key') || (mutation ? typeof args.operation_key !== 'string' : Object.keys(args).length !== 0))
+                throw new Error('Native billing accepts only a persisted operation key for mutations.');
+            r = id === 'foundry_readBillingProfile' ? await genesis.foundry.billing.profile({ signal }) : id === 'foundry_readNativeCreditBalance' ? await genesis.foundry.billing.creditBalance({ signal }) : id === 'foundry_ensureBillingProfile' ? await genesis.foundry.billing.ensureProfile(args.operation_key, { signal }) : await genesis.foundry.billing.checkoutCredits(args.operation_key, { signal });
+        }
+        else if (isFleetsLifecycleTool(id)) {
             r = await callFleetsLifecycleTool(genesis, id, args, signal);
         }
         else if (id === BEACONS_PROVISION_OPERATION) {
@@ -109,7 +119,7 @@ async function invoke(genesis, id, args, signal) {
     }
     catch (e) {
         if (e instanceof GenesisError)
-            return text({ error: { type: e.type, status: e.status, message: e.message, request_id: e.requestId } }, true);
+            return text({ error: { type: e.type, status: e.status, message: e.message, request_id: e.requestId, ...((isFoundryBillingOperation(id) || op.service === 'minds') && e.body && typeof e.body === 'object' && 'outcome' in e.body ? { outcome: e.body.outcome } : {}) } }, true);
         return text({ error: { type: 'network', message: e.message, hint: `The ${op.service} service may be unreachable (status: ${op.upstream.status}).` } }, true);
     }
 }
@@ -125,5 +135,5 @@ export async function callTool(opts, name, args = {}, signal) {
         return text(`Unknown operation "${id}". Use genesis_search_tools to find one.`, true);
     const hives = op.service === 'hives';
     const genesis = new Genesis(hives ? { ...opts, fetch: createHivesNodeTransport(opts, signal) } : opts);
-    return invoke(genesis, id, input, hives || op.service === 'blinds' || id === 'relays_getEnrollment' || id === 'relays_enroll' || isFleetsLifecycleTool(id) ? signal : undefined);
+    return invoke(genesis, id, input, hives || op.service === 'minds' || isFoundryBillingOperation(id) || op.service === 'blinds' || id === 'relays_getEnrollment' || id === 'relays_enroll' || isFleetsLifecycleTool(id) ? signal : undefined);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifesi/genesis-mcp",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/l1felabs/genesis-api.git",
@@ -8,6 +8,14 @@
   },
   "description": "Genesis MCP server (stdio + streamable HTTP): tools generated from the Genesis OpenAPI",
   "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
   "bin": {
     "genesis-mcp": "bin/genesis-mcp.js"
   },
@@ -18,7 +26,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.1",
     "undici": "6.29.0",
-    "@lifesi/genesis": "0.1.5"
+    "@lifesi/genesis": "0.1.8",
+    "@lifesi/genesis-cli": "0.1.8"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json"