@onesi/genesis 0.0.1-stage → 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+import type { operations } from './generated/schema.js';
+export interface ServiceMeta {
+    name: string;
+    title: string;
+    upstream: string;
+    operations: number;
+    /** @deprecated No longer shipped; always undefined. Read live state from `GET /v1/status` (`genesis status`). */
+    status?: string;
+    /** @deprecated No longer shipped; always undefined. */
+    statusNote?: string;
+    /** `dedicated`: the gateway admits this service only through its own composition, never a default registry route. */
+    gatewayRoute?: 'dedicated';
+}
+export interface OperationMeta {
+    method: string;
+    path: string;
+    service: string;
+    summary: string;
+    upstream: {
+        base: string;
+        method: string;
+        path: string;
+        /** @deprecated No longer shipped; always undefined. Read live state from `GET /v1/status`. */
+        status?: string;
+    };
+    mcp: boolean;
+    internal: boolean;
+    public: boolean;
+    pathParams: readonly string[];
+    queryParams: readonly string[];
+    hasBody: boolean;
+    /** Path parameters that are a multi-segment tail (`vendor/model`): each segment is encoded and `/` kept. */
+    tailParams?: readonly string[];
+    requestContentType?: string;
+    rawResponse?: boolean;
+    /** The operation answers an endless Server-Sent Events stream: `request()` refuses it; read it with `raw()` and a bounded window. */
+    stream?: boolean;
+    /** The operation reads an Idempotency-Key header: `required` refuses without one. */
+    idempotencyKey?: 'required' | 'optional';
+    /** The operation requires an If-Match header carrying the resource version (Auto): refused locally without one. */
+    ifMatch?: 'required';
+    inputSchema: Record<string, unknown>;
+}
+type Ops = operations;
+type Clean<T> = [T] extends [never] ? {} : [NonNullable<T>] extends [never] ? {} : NonNullable<T>;
+type Part<K extends keyof Ops, L extends 'path' | 'query'> = Ops[K] extends {
+    parameters: infer P;
+} ? (P extends {
+    [X in L]?: infer T;
+} ? Clean<T> : {}) : {};
+type Body<K extends keyof Ops> = Ops[K] extends {
+    requestBody?: infer B;
+} ? [NonNullable<B>] extends [never] ? {} : NonNullable<B> extends {
+    content: {
+        'application/json': infer J;
+    };
+} ? (undefined extends B ? {
+    body?: J;
+} : {
+    body: J;
+}) : NonNullable<B> extends {
+    content: {
+        'multipart/form-data': unknown;
+    };
+} ? (undefined extends B ? {
+    body?: FormData;
+} : {
+    body: FormData;
+}) : {} : {};
+/** Flat input for an operation: path params + query params + `body`. */
+export type OperationInput<K extends keyof Ops> = Part<K, 'path'> & Part<K, 'query'> & Body<K>;
+type Ok<R> = R extends {
+    200: infer X;
+} ? X : R extends {
+    201: infer X;
+} ? X : R extends {
+    202: infer X;
+} ? X : R extends {
+    204: unknown;
+} ? {
+    content: {
+        'application/json': void;
+    };
+} : unknown;
+/** Parsed JSON success body for an operation. */
+export type OperationOutput<K extends keyof Ops> = K extends 'hives_invoke_function' | 'hives_invoke_function_async' | 'hives_invoke_deployment' ? Response : K extends 'hives_set_project_env' ? {
+    project_id: string;
+    updated: {
+        name: string;
+    }[];
+} : Ops[K] extends {
+    responses: infer R;
+} ? (Ok<R> extends {
+    content: {
+        'application/json': infer J;
+    };
+} ? J : unknown) : unknown;
+export {};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/urls.d.ts

@@ -0,0 +1,6 @@
+/** Transport-safety checks for configured endpoints (mirrors sdk/python/src/lifesi_genesis/_urls.py). */
+/**
+ * Return `value` if it is https, or http on a loopback host; throw otherwise.
+ * Credentials ride on every request, so a plain-http endpoint off the local machine is refused.
+ */
+export declare function requireSecureUrl(value: string, what: string): string;

package/dist/urls.js

@@ -0,0 +1,31 @@
+/** Transport-safety checks for configured endpoints (mirrors sdk/python/src/lifesi_genesis/_urls.py). */
+function isLoopback(hostname) {
+    const host = hostname.replace(/^\[|\]$/g, '').toLowerCase();
+    // Exact names only: *.localhost is not guaranteed to resolve to loopback.
+    if (host === 'localhost')
+        return true;
+    if (host === '::1')
+        return true;
+    const v4 = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
+    return !!v4 && v4.slice(1).every((o) => Number(o) <= 255) && v4[1] === '127';
+}
+/**
+ * Return `value` if it is https, or http on a loopback host; throw otherwise.
+ * Credentials ride on every request, so a plain-http endpoint off the local machine is refused.
+ */
+export function requireSecureUrl(value, what) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`${what} must be an absolute https URL`);
+    }
+    if (!url.hostname)
+        throw new Error(`${what} must be an absolute https URL`);
+    if (url.protocol === 'https:')
+        return value;
+    if (url.protocol === 'http:' && isLoopback(url.hostname))
+        return value;
+    throw new Error(`${what} must use https (http is allowed only on loopback hosts)`);
+}

package/package.json

@@ -1 +1,49 @@
-{"name":"@onesi/genesis","version":"0.0.1-stage","description":"Reserved for the OneOS Genesis SDK"}
+{
+  "name": "@onesi/genesis",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/l1felabs/genesis-api.git",
+    "directory": "packages/sdk"
+  },
+  "description": "One typed SDK for every Genesis service (Foundry, Hives, Relays, IAM...) via the Genesis API gateway",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./spec.json": "./dist/genesis.openapi.json",
+    "./hives-node": {
+      "types": "./dist/hives-node.d.ts",
+      "default": "./dist/hives-node.js"
+    }
+  },
+  "keywords": [
+    "genesis",
+    "oneos",
+    "sdk",
+    "cli",
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "api"
+  ],
+  "author": "One Superintelligence, Inc.",
+  "homepage": "https://os.one.ml/docs",
+  "engines": {
+    "node": ">=20.19"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "undici": "6.29.0"
+  },
+  "scripts": {
+    "gen": "node scripts/gen.mjs",
+    "build": "tsc -p tsconfig.json && cp ../../openapi/genesis.openapi.json dist/"
+  }
+}