@onesi/genesis 0.0.1-stage → 0.2.0

package/dist/genesis.js

@@ -0,0 +1,271 @@
+import { selectGenesisContext } from './context.js';
+import { mindsModule } from './minds.js';
+import { mindsEngineModule } from './minds-engine.js';
+import { foundryBilling } from './foundry-billing.js';
+import { foundryModule, foundryRegistry } from './foundry.js';
+import { relaysEnrollment } from './relays-enrollment.js';
+import { blindsModule } from './blinds-owner-enrollment.js';
+import { beaconsModule } from './beacons.js';
+import { dialsModule } from './dials.js';
+import { GenesisClient } from './client.js';
+import { henryModule } from './henry.js';
+import { fleetsModule } from './fleets.js';
+import { flocksModule } from './flocks.js';
+import { rigsModule, panesModule, shellsModule } from './instances.js';
+import { gearsModule } from './gears.js';
+import { autoModule } from './auto.js';
+import { scopesModule } from './scopes.js';
+import { gardenModule } from './garden.js';
+import { tapsModule } from './taps.js';
+import { lanesModule } from './lanes.js';
+import { flaresModule } from './flares.js';
+import { tracesModule } from './traces.js';
+import { billingModule, gatewayModule, orgsModule } from './gateway.js';
+import { orgsEntitiesModule } from './orgs.js';
+import { iamModule } from './iam.js';
+import { hivesUploadBody } from './hives-upload.js';
+import { runnerModule } from './runner.js';
+import { hivesOperations } from './hives-operations.js';
+import { hivesMarketplace } from './hives-marketplace.js';
+import { hivesVolumes } from './hives-volumes.js';
+import { hivesInvokeHeaders, hivesOperationStatus } from './hives-functions.js';
+/**
+ * The Genesis SDK: one client, every service.
+ *   const genesis = new Genesis();                // GENESIS_API_KEY or `genesis login`
+ *   await genesis.hives.projects.list();
+ *   await genesis.foundry.chat({ model: 'x', messages: [{ role: 'user', content: 'hi' }] });
+ */
+export class Genesis extends GenesisClient {
+    constructor(opts = {}) { super(opts); }
+    /** Generic escape hatch: genesis.call('hives_list_projects', {...}) */
+    // Typed as request's own signature: `.bind` over a generic with ~1260 operation ids exceeds tsc's union limit (TS2590).
+    call = (operationId, input, init) => this.request(operationId, input, init);
+    context = { select: (selection, options = {}) => selectGenesisContext(selection, { credential: () => this.credential(), fetch: this.contextFetch, signal: options.signal }) };
+    /** minds.engine: every tenant Minds engine (Akasha daemon) route, one capability per call. */
+    minds = { ...mindsModule(this), engine: mindsEngineModule(this) };
+    blinds = blindsModule(this);
+    dials = dialsModule(this);
+    henry = henryModule(this);
+    fleets = fleetsModule(this);
+    runner = runnerModule(this);
+    beacons = beaconsModule(this);
+    flocks = flocksModule(this);
+    rigs = rigsModule(this);
+    panes = panesModule(this);
+    shells = shellsModule(this);
+    gears = gearsModule(this);
+    auto = autoModule(this);
+    scopes = scopesModule(this);
+    garden = gardenModule(this);
+    lanes = lanesModule(this);
+    flares = flaresModule(this);
+    gateway = gatewayModule(this);
+    /** Your organization's usage and billing reads, and Orgs: legal entities, seats, resolutions, documents, filings, formation and the record. */
+    orgs = { ...orgsModule(this), ...orgsEntitiesModule(this) };
+    billing = billingModule(this);
+    /** IAM v4: organizations, fleets, agents, roles, grants, capabilities and checks (login or org API key with iam:read / iam:write). */
+    iam = iamModule(this);
+    taps = tapsModule(this);
+    foundry = {
+        ...foundryModule(this),
+        billing: foundryBilling(this),
+        models: {
+            list: () => this.request('foundry_listModels'),
+        },
+        /** OpenAI-compatible chat completion (non-streaming). */
+        chat: (body) => this.request('foundry_createChatCompletion', { body: { ...body, stream: false } }),
+        /** Streaming chat: yields content deltas parsed from the SSE stream. */
+        chatStream: (body) => this.streamChat(body),
+        embeddings: (body) => this.request('foundry_createEmbedding', { body }),
+        registry: foundryRegistry(this),
+    };
+    hives = {
+        ...hivesOperations(this),
+        volumes: hivesVolumes(this),
+        marketplace: hivesMarketplace(this),
+        /** The gateway resolves the current authorized selection from an interactive One account session. */
+        context: {
+            get: () => this.request('hives_get_context_project'),
+            set: (body) => this.request('hives_set_context_project', { body }),
+            /** Detach this selection; the service project and customer resources are retained. */
+            detach: () => this.request('hives_detach_context_project'),
+        },
+        environment: {
+            list: (project_id, q = {}) => this.request('hives_list_project_environment', { ...q, project_id }),
+            upsert: (project_id, body) => this.request('hives_update_project_environment', { project_id, body }),
+            /** Explicit KMS reveal with a persisted names-only audit. Do not log the plaintext. */
+            reveal: (project_id, key) => this.request('hives_reveal_project_environment', { project_id, key }),
+        },
+        projects: {
+            list: (q = {}) => this.request('hives_list_projects', q),
+            get: (project_id) => this.request('hives_get_project', { project_id }),
+            create: (body) => this.request('hives_create_project', { body }),
+            update: (project_id, body) => this.request('hives_update_project', { project_id, body }),
+            activity: (project_id, q = {}) => this.request('hives_get_project_activity', { ...q, project_id }),
+            delete: (project_id) => this.request('hives_delete_project', { project_id }),
+        },
+        secrets: {
+            list: (project_id, q = {}) => this.request('hives_list_secrets', { ...q, project_id }),
+            get: (project_id, secret_id) => this.request('hives_get_secret', { project_id, secret_id }),
+            create: (project_id, body) => this.request('hives_create_secret', { project_id, body }),
+            update: (project_id, secret_id, body) => this.request('hives_update_secret', { project_id, secret_id, body }),
+            delete: (project_id, secret_id) => this.request('hives_delete_secret', { project_id, secret_id }),
+            /** Explicit sensitive operation. Do not log or retain the returned plaintext. */
+            reveal: (project_id, secret_id) => this.request('hives_reveal_secret', { project_id, secret_id }),
+            bulkUpsert: (project_id, body) => this.request('hives_bulk_upsert_secrets', { project_id, body }),
+        },
+        deployments: {
+            list: (project_id, q = {}) => this.request('hives_list_deployments', { ...q, project_id }),
+            get: (project_id, deployment_id) => this.request('hives_get_deployment', { project_id, deployment_id }),
+            upload: async (project_id, file, options = {}) => this.request('hives_upload_deployment', { project_id, body: await hivesUploadBody(file, options) }),
+            create: (project_id, body) => this.request('hives_create_deployment', { project_id, body }),
+            promote: (project_id, deployment_id) => this.request('hives_promote_deployment', { project_id, deployment_id }),
+            rollback: (project_id, deployment_id, body = {}) => this.request('hives_rollback_deployment', { project_id, deployment_id, body }),
+            cancel: (project_id, deployment_id) => this.request('hives_cancel_deployment', { project_id, deployment_id }),
+            stop: (project_id, deployment_id, init = {}) => this.request('hives_stop_deployment', { project_id, deployment_id }, init),
+            delete: (project_id, deployment_id) => this.request('hives_delete_deployment', { project_id, deployment_id }),
+            logs: (project_id, deployment_id, q = {}) => this.request('hives_query_deployment_logs', { ...q, project_id, deployment_id }),
+            invoke: (project_id, deployment_id, body = {}, init = {}) => this.raw('hives_invoke_deployment', { project_id, deployment_id, body }, init),
+        },
+        functions: {
+            list: (project_id, q = {}) => this.request('hives_list_functions', { ...q, project_id }),
+            get: (project_id, function_id) => this.request('hives_get_function', { project_id, function_id }),
+            create: (project_id, body) => this.request('hives_create_function', { project_id, body }),
+            update: (project_id, function_id, body) => this.request('hives_update_function', { project_id, function_id, body }),
+            delete: (project_id, function_id) => this.request('hives_delete_function', { project_id, function_id }),
+            /** Completed raw guest response; parse text/JSON/bytes explicitly. Never follows redirects. */
+            invoke: (project_id, function_id, body = {}, init = {}) => this.raw('hives_invoke_function', { project_id, function_id, body }, { signal: init.signal, headers: hivesInvokeHeaders(init) }),
+            /** Compatibility alias of invoke: the same completed raw guest response, no durable queue. */
+            invokeAsync: (project_id, function_id, body = {}, init = {}) => this.raw('hives_invoke_function_async', { project_id, function_id, body }, { signal: init.signal, headers: hivesInvokeHeaders(init) }),
+            operations: {
+                get: async (project_id, function_id, operation_id, init = {}) => hivesOperationStatus(await this.request('hives_get_function_operation', { project_id, function_id, operation_id }, init), operation_id),
+                release: async (project_id, function_id, operation_id, init = {}) => hivesOperationStatus(await this.request('hives_release_function_operation', { project_id, function_id, operation_id }, init), operation_id),
+            },
+        },
+        regions: { list: () => this.request('hives_list_regions') },
+    };
+    silos = {
+        /** Silos queries, compute time and storage of the selected Genesis project, last 30 days. */
+        usage: () => this.request('silos_getUsage'),
+        /** Regions Silos instances are created in. */
+        regions: { list: () => this.request('silos_listRegions') },
+        /** Database instances in the selected Genesis project; Silos verifies the signed selection. */
+        instances: {
+            list: () => this.request('silos_listInstances'),
+            create: (body) => this.request('silos_createInstance', { body }),
+            get: (instance_id) => this.request('silos_getInstance', { instance_id }),
+            /** Rename within the selected project; 409 when the name is taken. */
+            update: (instance_id, body) => this.request('silos_updateInstance', { instance_id, body }),
+            /** Removes the instance from the project and stops it; resolves with no body (204). */
+            delete: (instance_id) => this.request('silos_deleteInstance', { instance_id }),
+            /** Checkpoint, then stop. A later statement or resume starts it again. */
+            suspend: (instance_id) => this.request('silos_suspendInstance', { instance_id }),
+            resume: (instance_id) => this.request('silos_resumeInstance', { instance_id }),
+            /** One SQL statement, run once (never replayed) and metered on success. */
+            query: (instance_id, body) => this.request('silos_queryInstance', { instance_id, body }),
+            /** Up to 50 statements in one transaction: all commit or none do. */
+            batch: (instance_id, body) => this.request('silos_queryInstanceBatch', { instance_id, body }),
+            metrics: (instance_id) => this.request('silos_getInstanceMetrics', { instance_id }),
+            /** Waits up to waitMs (≤ 15000) for NOTIFY on the channels; call again to keep listening. */
+            listen: (instance_id, body) => this.request('silos_listenInstance', { instance_id, body }),
+            branches: {
+                list: (instance_id) => this.request('silos_listInstanceBranches', { instance_id }),
+                /** Copies the parent's latest checkpoint (the default branch when no parent is given). */
+                create: (instance_id, body) => this.request('silos_createInstanceBranch', { instance_id, body }),
+                get: (instance_id, branch_id) => this.request('silos_getInstanceBranch', { instance_id, branch_id }),
+                update: (instance_id, branch_id, body) => this.request('silos_updateInstanceBranch', { instance_id, branch_id, body }),
+                delete: (instance_id, branch_id) => this.request('silos_deleteInstanceBranch', { instance_id, branch_id }),
+                /** Replaces the branch's data with a stored snapshot. */
+                restore: (instance_id, branch_id, body) => this.request('silos_restoreInstanceBranch', { instance_id, branch_id, body }),
+            },
+            snapshots: {
+                list: (instance_id) => this.request('silos_listInstanceSnapshots', { instance_id }),
+                create: (instance_id, body = {}) => this.request('silos_createInstanceSnapshot', { instance_id, body }),
+            },
+        },
+    };
+    traces = tracesModule(this);
+    relays = {
+        enrollment: relaysEnrollment(this),
+        zones: {
+            list: (q = {}) => this.request('relays_listZones', q),
+            get: (zone) => this.request('relays_getZone', { zone }),
+            dnssec: (zone) => this.request('relays_getDnssec', { zone }),
+            create: (body) => this.request('relays_createZone', { body }),
+            update: (zone, body) => this.request('relays_updateZone', { zone, body }),
+            delete: (zone) => this.request('relays_deleteZone', { zone }),
+        },
+        records: {
+            list: (zone, q = {}) => this.request('relays_listRecords', { zone, ...q }),
+            get: (zone, recordId) => this.request('relays_getRecord', { zone, recordId }),
+            /** One record, or up to 100 with { records: [...] }. */
+            create: (zone, body) => this.request('relays_createRecord', { zone, body }),
+            update: (zone, recordId, body) => this.request('relays_updateRecord', { zone, recordId, body }),
+            delete: (zone, recordId) => this.request('relays_deleteRecord', { zone, recordId }),
+        },
+    };
+    /** One account org API keys (WorkOS). custody 'blinds' = key goes straight to Blinds, never shown. */
+    keys = {
+        list: (org_id) => this.request('iam_listOrgApiKeys', { org_id }),
+        create: (org_id, body) => this.request('iam_createOrgApiKey', { org_id, body }),
+        revoke: (key_id) => this.request('iam_revokeApiKey', { key_id }),
+    };
+    /** IAM organization directory: projects. One account login (human session) only; writes need iam:write and owner/admin. */
+    projects = {
+        list: (org_id) => this.request('iam_listProjects', { org_id }),
+        get: (org_id, project_id) => this.request('iam_getProject', { org_id, project_id }),
+        /** Reuse the same idempotencyKey to replay an uncertain create instead of making a second project. */
+        create: (org_id, body, idempotencyKey) => this.request('iam_createProject', { org_id, body }, { headers: { 'idempotency-key': idempotencyKey } }),
+        update: (org_id, project_id, body) => this.request('iam_updateProject', { org_id, project_id, body }),
+        rename: (org_id, project_id, name) => this.request('iam_updateProject', { org_id, project_id, body: { name } }),
+        /** Permanent; IAM refuses while workspaces, fleets or grants reference the project. */
+        delete: (org_id, project_id) => this.request('iam_deleteProject', { org_id, project_id }),
+    };
+    /** IAM organization directory: workspaces. One account login (human session) only; writes need iam:write and owner/admin. */
+    workspaces = {
+        list: (org_id) => this.request('iam_listWorkspaces', { org_id }),
+        get: (org_id, workspace_id) => this.request('iam_getWorkspace', { org_id, workspace_id }),
+        create: (org_id, body, idempotencyKey) => this.request('iam_createWorkspace', { org_id, body }, { headers: { 'idempotency-key': idempotencyKey } }),
+        update: (org_id, workspace_id, body) => this.request('iam_updateWorkspace', { org_id, workspace_id, body }),
+        rename: (org_id, workspace_id, name) => this.request('iam_updateWorkspace', { org_id, workspace_id, body: { name } }),
+        /** Permanent; IAM refuses while fleets or grants reference the workspace. */
+        delete: (org_id, workspace_id) => this.request('iam_deleteWorkspace', { org_id, workspace_id }),
+    };
+    /** Who is this credential? (One account verify: org, principal, scopes, kind) */
+    async whoami() {
+        const credential_value = await this.credential();
+        if (!credential_value)
+            throw new Error('No Genesis credential. Run `genesis login`, or set GENESIS_API_KEY.');
+        return this.request('iam_verifyCredential', { body: { credential_value } });
+    }
+    async *streamChat(body) {
+        const res = await this.raw('foundry_createChatCompletion', { body: { ...body, stream: true } }, { headers: { accept: 'text/event-stream' } });
+        if (!res.body)
+            return;
+        const reader = res.body.getReader();
+        const dec = new TextDecoder();
+        let buf = '';
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += dec.decode(value, { stream: true });
+            let i;
+            while ((i = buf.indexOf('\n')) >= 0) {
+                const line = buf.slice(0, i).trim();
+                buf = buf.slice(i + 1);
+                if (!line.startsWith('data:'))
+                    continue;
+                const data = line.slice(5).trim();
+                if (data === '[DONE]')
+                    return;
+                try {
+                    const d = JSON.parse(data).choices?.[0]?.delta?.content;
+                    if (d)
+                        yield d;
+                }
+                catch { /* ignore keepalives */ }
+            }
+        }
+    }
+}