@onesi/genesis 0.1.13 → 0.2.1

package/dist/minds.d.ts

@@ -1,9 +1,14 @@
 import type { GenesisClient } from './client.js';
 import type { OperationInput, OperationOutput } from './types.js';
-export declare const mindsOperations: readonly ["minds_listMinds", "minds_getMind", "minds_getUsage", "minds_createMind", "minds_resumeMind", "minds_stopMind", "minds_insertEpisodicMemory", "minds_getEpisodicMemory", "minds_updateEpisodicMemory", "minds_searchMemory"];
+export declare const mindsOperations: readonly ["minds_listMinds", "minds_getMind", "minds_getUsage", "minds_createMind", "minds_resumeMind", "minds_stopMind", "minds_deleteMind", "minds_resizeMind", "minds_insertEpisodicMemory", "minds_getEpisodicMemory", "minds_updateEpisodicMemory", "minds_searchMemory", "minds_createWebhookDelivery", "minds_getWebhookDelivery"];
+/** Engine service groups a create may choose (the controller's CREATE_SERVICES); kv and memory always run. */
+export declare const mindsServices: readonly ["kv", "memory", "graph", "analytics", "ml", "inference", "vector", "snn", "continual", "associative-memory", "cognitive", "cognitive-cycle", "mcp"];
+export type MindsService = typeof mindsServices[number];
 export declare const isMindsOperation: (id: string) => boolean;
 export type MindsEventInput = OperationInput<'minds_insertEpisodicMemory'>['body']['event'];
 export type MindsUsage = OperationOutput<'minds_getUsage'>;
+export type MindsWebhookDelivery = OperationInput<'minds_createWebhookDelivery'>['body'];
+export type MindsWebhookDeliveryReceipt = OperationOutput<'minds_getWebhookDelivery'>;
 export interface MindsRequestOptions {
     signal?: AbortSignal;
 }
@@ -15,11 +20,14 @@ export interface MindsResumeOptions extends MindsRequestOptions {
 export interface MindsStopOptions extends MindsRequestOptions {
     idempotencyKey: string;
 }
+export type MindsDeleteOptions = MindsStopOptions;
+export type MindsResizeOptions = MindsStopOptions;
 export interface MindsCreateOptions extends MindsRequestOptions {
     idempotencyKey: string;
     contextSha256: string;
     plan?: 'free' | 'pro';
     profileId?: 'F1' | 'D1' | 'D2';
+    services?: MindsService[];
 }
 /** One dispatch only. Creation retains its operation key; episodic insertion returns a storage UUID distinct from event.id. */
 export declare function mindsTransport(options: {
@@ -34,6 +42,18 @@ export declare function mindsTransport(options: {
 }): Promise<Response>;
 export declare function mindsModule(client: GenesisClient): {
     agent: {
+        create: (input: import("./minds-agent.js").MindsAgentCreateInput, options: import("./minds-agent.js").MindsAgentCreateOptions) => Promise<{
+            mind_id: string;
+            status: string;
+        } & {
+            [key: string]: unknown;
+        }>;
+        createStatus: (operation_id: string, options: import("./minds-agent.js").MindsAgentCreateOptions) => Promise<{
+            mind_id: string;
+            status: string;
+        } & {
+            [key: string]: unknown;
+        }>;
         memory: {
             insert: (mind: string, event: import("./minds-agent.js").MindsAgentEventInput, options?: import("./minds-agent.js").MindsAgentOptions) => Promise<{
                 id: string;
@@ -173,6 +193,94 @@ export declare function mindsModule(client: GenesisClient): {
     } & {
         [key: string]: unknown;
     }>;
+    /** Deletes the Mind (controller lifecycle delete): human delete permission, or an org API key with minds:write. */
+    delete: (mind_id: string, expected_generation: number, options: MindsDeleteOptions) => Promise<{
+        schema_version: "minds.controller.v1";
+        mind_id: string;
+        organization_id: string;
+        project_id: string;
+        name: string;
+        region: string;
+        plan: "free" | "pro";
+        capacity: import("./index.js").components["schemas"]["Minds.Capacity"];
+        observed_capacity: import("./index.js").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;
+    }>;
+    /** Resizes to an existing Pro profile (F1/D1/D2): human manage permission, or an org API key with minds:manage. */
+    resize: (mind_id: string, expected_generation: number, profile_id: "F1" | "D1" | "D2", options: MindsResizeOptions) => Promise<{
+        schema_version: "minds.controller.v1";
+        mind_id: string;
+        organization_id: string;
+        project_id: string;
+        name: string;
+        region: string;
+        plan: "free" | "pro";
+        capacity: import("./index.js").components["schemas"]["Minds.Capacity"];
+        observed_capacity: import("./index.js").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;
+    }>;
+    webhookDeliveries: {
+        create: (mind_id: string, delivery: MindsWebhookDelivery, options?: MindsRequestOptions) => Promise<{
+            schema_version: "minds.webhook-delivery.v1";
+            delivery_id: string;
+            mind_id: string;
+            organization_id: string;
+            project_id: string;
+            issuer_principal_id: string;
+            event_reference: string;
+            event_sha256: string;
+            received_at: string;
+            outcome: "wake_queued" | "activity_recorded" | "ignored";
+            reason: "deleted" | "user_stopped" | "operation_in_flight" | "not_ready" | null;
+            operation_id: string | null;
+            generation: number;
+            wake_reason: "webhook";
+        }>;
+        get: (mind_id: string, delivery_id: string, options?: MindsRequestOptions) => Promise<{
+            schema_version: "minds.webhook-delivery.v1";
+            delivery_id: string;
+            mind_id: string;
+            organization_id: string;
+            project_id: string;
+            issuer_principal_id: string;
+            event_reference: string;
+            event_sha256: string;
+            received_at: string;
+            outcome: "wake_queued" | "activity_recorded" | "ignored";
+            reason: "deleted" | "user_stopped" | "operation_in_flight" | "not_ready" | null;
+            operation_id: string | null;
+            generation: number;
+            wake_reason: "webhook";
+        }>;
+    };
     memory: {
         insert: (mind: string, event: MindsEventInput, options?: MindsRequestOptions) => Promise<{
             id: string;

package/dist/minds.js

@@ -1,11 +1,15 @@
 import { GenesisError } from './errors.js';
 import { mindsAgentModule } from './minds-agent.js';
 import { mindsOwnerModule } from './minds-owner.js';
-export const mindsOperations = ['minds_listMinds', 'minds_getMind', 'minds_getUsage', 'minds_createMind', 'minds_resumeMind', 'minds_stopMind', 'minds_insertEpisodicMemory', 'minds_getEpisodicMemory', 'minds_updateEpisodicMemory', 'minds_searchMemory'];
+export const mindsOperations = ['minds_listMinds', 'minds_getMind', 'minds_getUsage', 'minds_createMind', 'minds_resumeMind', 'minds_stopMind', 'minds_deleteMind', 'minds_resizeMind', 'minds_insertEpisodicMemory', 'minds_getEpisodicMemory', 'minds_updateEpisodicMemory', 'minds_searchMemory', 'minds_createWebhookDelivery', 'minds_getWebhookDelivery'];
+/** Engine service groups a create may choose (the controller's CREATE_SERVICES); kv and memory always run. */
+export const mindsServices = ['kv', 'memory', 'graph', 'analytics', 'ml', 'inference', 'vector', 'snn', 'continual', 'associative-memory', 'cognitive', 'cognitive-cycle', 'mcp'];
 export const isMindsOperation = (id) => mindsOperations.includes(id);
 const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
 const uuid4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
-const writes = new Set(['minds_createMind', 'minds_resumeMind', 'minds_stopMind', 'minds_insertEpisodicMemory', 'minds_updateEpisodicMemory']);
+const lifecycle = ['minds_resumeMind', 'minds_stopMind', 'minds_deleteMind', 'minds_resizeMind'];
+const writes = new Set(['minds_createMind', 'minds_resumeMind', 'minds_stopMind', 'minds_deleteMind', 'minds_resizeMind', 'minds_insertEpisodicMemory', 'minds_updateEpisodicMemory', 'minds_createWebhookDelivery']);
+const nilUuid = '00000000-0000-0000-0000-000000000000';
 // Match the native gateway's RFC3339/calendar and nanosecond window bounds.
 function usageInstant(value) {
     if (typeof value !== 'string' || value.length > 40)
@@ -31,11 +35,16 @@ export async function mindsTransport(options) {
     const id = options.operationId, input = options.input, write = writes.has(id);
     let dispatchAttempted = false;
     const error = (status, type, code, unknownOutcome = false) => new GenesisError({ status, type, code, operationId: id,
-        message: status === 403 ? 'Minds requires an admitted original human One account session with a Console Sandbox selection.'
-            : write ? 'Minds write was not confirmed. Preserve the lifecycle/create key or reconcile memory before an explicit retry.' : 'Minds request was not confirmed.',
+        message: status === 403 ? code === 'HUMAN_SANDBOX_SELECTION_REQUIRED'
+            ? 'HUMAN_SANDBOX_SELECTION_REQUIRED: Minds accepts an original human One account session with a Console Sandbox selection, or organization API keys with a selected (bound) context; M2M tokens are refused.'
+            : code === 'SCOPE_MISSING' ? 'SCOPE_MISSING: this organization API key lacks the Minds scope the operation needs (minds:read, minds:write or minds:manage; minds:manage does not imply read).'
+                : 'Minds requires an admitted original human One account session with a Console Sandbox selection, or an organization API key with the operation\'s Minds scope.'
+            : write ? 'Minds write was not confirmed. Preserve the lifecycle/create key or delivery_id, or reconcile memory, before an explicit retry.' : 'Minds request was not confirmed.',
         ...(write && (unknownOutcome || dispatchAttempted && (status === 0 || status >= 500 || type === 'invalid_response')) ? { body: { outcome: 'unknown' } } : {}) });
-    const fields = id === 'minds_getUsage' ? ['from', 'to'] : id === 'minds_listMinds' ? ['after', 'limit'] : id === 'minds_getMind' ? ['mind_id'] : id === 'minds_updateEpisodicMemory' ? ['mind', 'storage_id', 'body'] : ['minds_resumeMind', 'minds_stopMind'].includes(id) ? ['mind_id', 'body']
-        : id === 'minds_createMind' ? ['body'] : id === 'minds_getEpisodicMemory' ? ['mind', 'storage_id'] : ['mind', 'body'];
+    const fields = id === 'minds_getUsage' ? ['from', 'to'] : id === 'minds_listMinds' ? ['after', 'limit'] : id === 'minds_getMind' ? ['mind_id'] : id === 'minds_updateEpisodicMemory' ? ['mind', 'storage_id', 'body'] : ['minds_resumeMind', 'minds_stopMind', 'minds_resizeMind'].includes(id) ? ['mind_id', 'body']
+        : id === 'minds_deleteMind' ? ['mind_id', 'expected_generation']
+            : id === 'minds_createMind' ? ['body'] : id === 'minds_getEpisodicMemory' ? ['mind', 'storage_id'] : id === 'minds_createWebhookDelivery' ? ['mind_id', 'body']
+                : id === 'minds_getWebhookDelivery' ? ['mind_id', 'delivery_id'] : ['mind', 'body'];
     if (options.routing !== 'gateway' || !isMindsOperation(id) || Object.keys(input).some(key => !fields.includes(key)))
         throw error(0, 'invalid_request');
     if (id === 'minds_getUsage') {
@@ -43,7 +52,7 @@ export async function mindsTransport(options) {
         if (from === undefined || to === undefined || to <= from || to - from > 93n * 86400n * 1000000000n)
             throw error(0, 'invalid_request');
     }
-    for (const key of ['mind', 'mind_id', 'storage_id', 'after'])
+    for (const key of ['mind', 'mind_id', 'storage_id', 'after', 'delivery_id'])
         if (input[key] !== undefined && (typeof input[key] !== 'string' || !uuid.test(input[key])))
             throw error(0, 'invalid_request');
     if (id === 'minds_updateEpisodicMemory') {
@@ -54,11 +63,22 @@ export async function mindsTransport(options) {
             || typeof body.content !== 'string' || !body.content.trim() || body.content.length > 16_000)
             throw error(0, 'invalid_request');
     }
+    if (id === 'minds_createWebhookDelivery' || id === 'minds_getWebhookDelivery') {
+        const body = input.body;
+        if (input.mind_id === nilUuid || input.delivery_id === nilUuid || (id === 'minds_getWebhookDelivery' ? typeof input.delivery_id !== 'string'
+            : !body || typeof body !== 'object' || Array.isArray(body) || Object.keys(body).sort().join() !== 'delivery_id,event_reference,event_sha256'
+                || typeof body.delivery_id !== 'string' || !uuid.test(body.delivery_id) || body.delivery_id === nilUuid
+                || typeof body.event_reference !== 'string' || body.event_reference.length > 200 || !/^[A-Za-z0-9_.:/-]+$/.test(body.event_reference)
+                || typeof body.event_sha256 !== 'string' || !/^[0-9a-f]{64}$/.test(body.event_sha256)))
+            throw error(0, 'invalid_request');
+    }
     if (id === 'minds_createMind') {
         const body = input.body;
         if (!uuid4.test(options.headers?.['idempotency-key'] ?? '') || !/^[a-f0-9]{64}$/.test(options.headers?.['x-genesis-minds-creation-context'] ?? '')
             || !body || typeof body !== 'object' || Array.isArray(body) || typeof body.name !== 'string'
-            || Object.keys(body).some(key => !['name', 'plan', 'profile_id'].includes(key))
+            || Object.keys(body).some(key => !['name', 'plan', 'profile_id', 'services'].includes(key))
+            || (body.services !== undefined && (!Array.isArray(body.services) || new Set(body.services).size !== body.services.length
+                || body.services.some(service => !mindsServices.includes(service))))
             || (body.plan !== undefined && body.plan !== 'free' && body.plan !== 'pro')
             || (body.profile_id !== undefined && (typeof body.profile_id !== 'string' || !['F1', 'D1', 'D2'].includes(body.profile_id) || (body.plan !== 'pro' && body.profile_id !== 'F1'))))
             throw error(0, 'invalid_request');
@@ -72,6 +92,13 @@ export async function mindsTransport(options) {
             || body.expected_generation >= Number.MAX_SAFE_INTEGER)
             throw error(0, 'invalid_request');
     }
+    if (id === 'minds_deleteMind' || id === 'minds_resizeMind') {
+        const body = input.body, generation = id === 'minds_deleteMind' ? input.expected_generation : body?.expected_generation;
+        if (!uuid4.test(options.headers?.['idempotency-key'] ?? '') || !Number.isSafeInteger(generation) || generation < 1 || generation >= Number.MAX_SAFE_INTEGER
+            || (id === 'minds_resizeMind' && (!body || typeof body !== 'object' || Array.isArray(body) || Object.keys(body).sort().join() !== 'expected_generation,profile_id'
+                || !['F1', 'D1', 'D2'].includes(body.profile_id))))
+            throw error(0, 'invalid_request');
+    }
     const controller = new AbortController(), cancel = () => controller.abort(options.signal?.reason);
     options.signal?.addEventListener('abort', cancel, { once: true });
     if (options.signal?.aborted)
@@ -97,9 +124,9 @@ export async function mindsTransport(options) {
             throw error(0, 'invalid_request');
         const response = await bounded(() => {
             dispatchAttempted = true;
-            return options.fetch(options.url, { method: id === 'minds_updateEpisodicMemory' ? 'PUT' : ['minds_listMinds', 'minds_getMind', 'minds_getUsage', 'minds_getEpisodicMemory'].includes(id) ? 'GET' : 'POST',
+            return options.fetch(options.url, { method: id === 'minds_updateEpisodicMemory' ? 'PUT' : id === 'minds_deleteMind' ? 'DELETE' : ['minds_listMinds', 'minds_getMind', 'minds_getUsage', 'minds_getEpisodicMemory', 'minds_getWebhookDelivery'].includes(id) ? 'GET' : 'POST',
                 headers: { authorization: `Bearer ${credential}`, accept: 'application/json', ...(body === undefined ? {} : { 'content-type': 'application/json' }),
-                    ...(['minds_resumeMind', 'minds_stopMind'].includes(id) ? { 'idempotency-key': options.headers['idempotency-key'] } : {}),
+                    ...(lifecycle.includes(id) ? { 'idempotency-key': options.headers['idempotency-key'] } : {}),
                     ...(id === 'minds_createMind' ? { 'idempotency-key': options.headers['idempotency-key'], 'x-genesis-minds-creation-context': options.headers['x-genesis-minds-creation-context'] } : {}) },
                 ...(body === undefined ? {} : { body }), signal: controller.signal, redirect: 'error', cache: 'no-store' }).then(result => {
                 if (controller.signal.aborted) {
@@ -153,11 +180,11 @@ export async function mindsTransport(options) {
             const detail = row && Object.hasOwn(row, 'error') && row.error && typeof row.error === 'object' && !Array.isArray(row.error)
                 ? row.error : undefined;
             const code = detail && Object.hasOwn(detail, 'code') && typeof detail.code === 'string' ? detail.code : undefined;
-            const unknownOutcome = ['minds_resumeMind', 'minds_stopMind'].includes(id) && response.status === 401 && code === 'SELECTION_EXPIRED'
+            const unknownOutcome = lifecycle.includes(id) && response.status === 401 && code === 'SELECTION_EXPIRED'
                 && detail !== undefined && Object.hasOwn(detail, 'outcome') && detail.outcome === 'unknown';
-            throw error(response.status, 'minds_error', code, unknownOutcome);
+            throw error(response.status, 'minds_error', code, unknownOutcome || id === 'minds_createWebhookDelivery' && detail?.outcome === 'unknown');
         }
-        if (['minds_createMind', 'minds_resumeMind', 'minds_stopMind'].includes(id) && response.status !== 202)
+        if (['minds_createMind', ...lifecycle, 'minds_createWebhookDelivery'].includes(id) && response.status !== 202)
             throw error(response.status, 'invalid_response');
         return Response.json(value, { status: response.status, headers: { 'cache-control': 'no-store' } });
     }
@@ -179,10 +206,18 @@ export function mindsModule(client) {
         list: (query = {}, options = {}) => client.request('minds_listMinds', query, options),
         get: (mind_id, options = {}) => client.request('minds_getMind', { mind_id }, options),
         usage: (window, options = {}) => client.request('minds_getUsage', window, options),
-        create: (name, options) => client.request('minds_createMind', { body: { name, ...(options.plan === undefined ? {} : { plan: options.plan }), ...(options.profileId === undefined ? {} : { profile_id: options.profileId }) } }, { signal: options.signal,
+        create: (name, options) => client.request('minds_createMind', { body: { name, ...(options.plan === undefined ? {} : { plan: options.plan }), ...(options.profileId === undefined ? {} : { profile_id: options.profileId }), ...(options.services === undefined ? {} : { services: options.services }) } }, { signal: options.signal,
             headers: { 'idempotency-key': options.idempotencyKey, 'x-genesis-minds-creation-context': options.contextSha256 } }),
         resume: (mind_id, expected_generation, options) => client.request('minds_resumeMind', { mind_id, body: { expected_generation, ...(options.wakeReason === undefined ? {} : { wake_reason: options.wakeReason }) } }, { signal: options.signal, headers: { 'idempotency-key': options.idempotencyKey } }),
         stop: (mind_id, expected_generation, options) => client.request('minds_stopMind', { mind_id, body: { expected_generation } }, { signal: options.signal, headers: { 'idempotency-key': options.idempotencyKey } }),
+        /** Deletes the Mind (controller lifecycle delete): human delete permission, or an org API key with minds:write. */
+        delete: (mind_id, expected_generation, options) => client.request('minds_deleteMind', { mind_id, expected_generation }, { signal: options.signal, headers: { 'idempotency-key': options.idempotencyKey } }),
+        /** Resizes to an existing Pro profile (F1/D1/D2): human manage permission, or an org API key with minds:manage. */
+        resize: (mind_id, expected_generation, profile_id, options) => client.request('minds_resizeMind', { mind_id, body: { expected_generation, profile_id } }, { signal: options.signal, headers: { 'idempotency-key': options.idempotencyKey } }),
+        webhookDeliveries: {
+            create: (mind_id, delivery, options = {}) => client.request('minds_createWebhookDelivery', { mind_id, body: delivery }, options),
+            get: (mind_id, delivery_id, options = {}) => client.request('minds_getWebhookDelivery', { mind_id, delivery_id }, options),
+        },
         memory: {
             insert: (mind, event, options = {}) => client.request('minds_insertEpisodicMemory', { mind, body: { event } }, options),
             get: (mind, storage_id, options = {}) => client.request('minds_getEpisodicMemory', { mind, storage_id }, options),