@onesi/genesis 0.2.6 → 0.2.8

package/README.md

@@ -3,7 +3,7 @@
 The TypeScript SDK for OneOS. One typed client for every Genesis service, through the Genesis API at `https://os.one.ml/api`.
 
 ```sh
-npm install @onesi/genesis@0.2.6
+npm install @onesi/genesis@0.2.8
 ```
 
 ```ts

package/dist/auto.d.ts

@@ -13,6 +13,19 @@ export declare function autoModule(client: GenesisClient): {
         kind: "api_key" | "m2m_token" | "bridge_session";
         scopes: string[];
     }>;
+    /** Send one MCP JSON-RPC message to Auto's own MCP endpoint (`initialize`, `tools/list`, `tools/call`, ...).
+     * Each tool checks its own scope; a notification (no `id`) resolves with an empty body. */
+    mcp: (message: In<"auto_callMcp">["body"]) => Promise<{
+        jsonrpc: "2.0";
+        id?: string | number | null;
+        result?: {
+            [key: string]: unknown;
+        };
+        error?: {
+            code: number;
+            message: string;
+        };
+    }>;
     orgs: {
         list: (includeArchived?: boolean) => Promise<{
             data: import("./index.js").components["schemas"]["Auto.Org"][];

package/dist/auto.js

@@ -8,6 +8,9 @@ import { idempotencyHeaders, ifMatchHeaders } from './idempotency.js';
 export function autoModule(client) {
     return {
         whoami: () => client.request('auto_whoami'),
+        /** Send one MCP JSON-RPC message to Auto's own MCP endpoint (`initialize`, `tools/list`, `tools/call`, ...).
+         * Each tool checks its own scope; a notification (no `id`) resolves with an empty body. */
+        mcp: (message) => client.request('auto_callMcp', { body: message }),
         orgs: {
             list: (includeArchived) => client.request('auto_listOrgs', includeArchived === undefined ? {} : { include_archived: includeArchived }),
             get: (org) => client.request('auto_getOrg', { org }),

package/dist/boxes.d.ts

@@ -44,6 +44,53 @@ export declare function boxesModule(client: GenesisClient): {
                 meta?: import("./index.js").components["schemas"]["Boxes.MailListMeta"];
             }>;
         };
+        /** Agent mailboxes in the key's project: One ("one") by default, and OpenAgentID agents (a_<ULID>). */
+        agents: {
+            list: () => Promise<{
+                success: boolean;
+                data: import("./index.js").components["schemas"]["Boxes.MailAgentMailbox"][];
+            }>;
+            create: (body: In<"boxes_mail_agents_create">["body"]) => Promise<{
+                success: boolean;
+                data: import("./index.js").components["schemas"]["Boxes.MailAgentMailbox"];
+            }>;
+            get: (agentId: In<"boxes_mail_agents_get">["agentId"]) => Promise<{
+                success: boolean;
+                data: import("./index.js").components["schemas"]["Boxes.MailAgentMailbox"];
+            }>;
+            delete: (agentId: In<"boxes_mail_agents_delete">["agentId"]) => Promise<{
+                success: boolean;
+                data: import("./index.js").components["schemas"]["Boxes.MailAgentMailbox"];
+            }>;
+            inbox: {
+                list: (agentId: In<"boxes_mail_agents_inbox_list">["agentId"], q?: Omit<In<"boxes_mail_agents_inbox_list">, "body" | "agentId">) => Promise<{
+                    success: boolean;
+                    data: import("./index.js").components["schemas"]["Boxes.MailMessage"][];
+                    meta?: import("./index.js").components["schemas"]["Boxes.MailListMeta"];
+                }>;
+            };
+            send: (agentId: In<"boxes_mail_agents_send">["agentId"], body: In<"boxes_mail_agents_send">["body"], idempotencyKey?: string) => Promise<{
+                success: boolean;
+                data: import("./index.js").components["schemas"]["Boxes.MailMessage"];
+            }>;
+            threads: {
+                list: (agentId: In<"boxes_mail_agents_threads_list">["agentId"], q?: Omit<In<"boxes_mail_agents_threads_list">, "body" | "agentId">) => Promise<{
+                    success: boolean;
+                    data: import("./index.js").components["schemas"]["Boxes.MailThread"][];
+                    meta?: import("./index.js").components["schemas"]["Boxes.MailListMeta"];
+                }>;
+                get: (agentId: In<"boxes_mail_agents_threads_get">["agentId"], id: In<"boxes_mail_agents_threads_get">["id"]) => Promise<{
+                    success: boolean;
+                    data: import("./index.js").components["schemas"]["Boxes.MailThreadDetail"];
+                }>;
+            };
+            messages: {
+                get: (agentId: In<"boxes_mail_agents_messages_get">["agentId"], id: In<"boxes_mail_agents_messages_get">["id"]) => Promise<{
+                    success: boolean;
+                    data: import("./index.js").components["schemas"]["Boxes.MailMessageWithLabels"];
+                }>;
+            };
+        };
         mailboxes: {
             list: () => Promise<{
                 success: boolean;

package/dist/boxes.js

@@ -21,6 +21,24 @@ export function boxesModule(client) {
             inbox: {
                 list: (q = {}) => client.request('boxes_mail_inbox_list', { ...q }),
             },
+            /** Agent mailboxes in the key's project: One ("one") by default, and OpenAgentID agents (a_<ULID>). */
+            agents: {
+                list: () => client.request('boxes_mail_agents_list'),
+                create: (body) => client.request('boxes_mail_agents_create', { body }),
+                get: (agentId) => client.request('boxes_mail_agents_get', { "agentId": agentId }),
+                delete: (agentId) => client.request('boxes_mail_agents_delete', { "agentId": agentId }),
+                inbox: {
+                    list: (agentId, q = {}) => client.request('boxes_mail_agents_inbox_list', { "agentId": agentId, ...q }),
+                },
+                send: (agentId, body, idempotencyKey) => client.request('boxes_mail_agents_send', { "agentId": agentId, body }, { headers: idempotencyHeaders('boxes_mail_agents_send', idempotencyKey) }),
+                threads: {
+                    list: (agentId, q = {}) => client.request('boxes_mail_agents_threads_list', { "agentId": agentId, ...q }),
+                    get: (agentId, id) => client.request('boxes_mail_agents_threads_get', { "agentId": agentId, "id": id }),
+                },
+                messages: {
+                    get: (agentId, id) => client.request('boxes_mail_agents_messages_get', { "agentId": agentId, "id": id }),
+                },
+            },
             mailboxes: {
                 list: () => client.request('boxes_mail_mailboxes_list'),
                 delegations: {

package/dist/client.js

@@ -266,7 +266,7 @@ export class GenesisClient {
         const url = this.url(operationId, input);
         const headers = {
             accept: 'application/json',
-            'user-agent': this.opts.userAgent ?? '@onesi/genesis/0.2.6',
+            'user-agent': this.opts.userAgent ?? '@onesi/genesis/0.2.8',
             ...this.opts.headers, ...init.headers,
         };
         if (op.service === 'blinds' && !['GET', 'HEAD', 'OPTIONS'].includes(op.method))

package/dist/context.d.ts

@@ -6,7 +6,7 @@ export type GenesisContextSelection = {
     platformId: 'pf_console';
     workspaceId: string;
     fleetId: null;
-    environmentId: 'sandbox';
+    environmentId: 'sandbox' | 'live';
 };
 export interface GenesisContextSession {
     principal: {

package/dist/context.js

@@ -78,7 +78,7 @@ export async function selectGenesisContext(selection, options) {
     const requested = { ...selection };
     const keys = Object.keys(requested), full = 'projectId' in requested;
     if (!id(requested.organizationId, 'o') || keys.some(k => !(full ? ['organizationId', 'projectId', 'platformId', 'workspaceId', 'fleetId', 'environmentId'] : ['organizationId']).includes(k))
-        || (full && (!id(requested.projectId, 'pr') || !id(requested.workspaceId, 'w') || requested.platformId !== 'pf_console' || requested.fleetId !== null || requested.environmentId !== 'sandbox')))
+        || (full && (!id(requested.projectId, 'pr') || !id(requested.workspaceId, 'w') || requested.platformId !== 'pf_console' || requested.fleetId !== null || (requested.environmentId !== 'sandbox' && requested.environmentId !== 'live'))))
         return fail(400);
     const controller = new AbortController(), cancel = () => controller.abort();
     options.signal?.addEventListener('abort', cancel, { once: true });

package/dist/fleets.d.ts

@@ -10,6 +10,11 @@ export interface FleetsInstanceOptions {
     idempotencyKey?: string;
     signal?: AbortSignal;
 }
+type SeatHireInput = NonNullable<OperationInput<'fleets_hireSeat'>['body']>;
+type SeatUpdateInput = NonNullable<OperationInput<'fleets_updateSeat'>['body']>;
+type SeatTaskInput = NonNullable<OperationInput<'fleets_submitSeatTask'>['body']>;
+type PoolCreateInput = NonNullable<OperationInput<'fleets_createPool'>['body']>;
+type PoolTopUpInput = NonNullable<OperationInput<'fleets_topUpPool'>['body']>;
 /** Managed Henry instances and tasks scoped to the credential's verified org. */
 export declare function fleetsModule(client: GenesisClient): {
     agents: {
@@ -155,6 +160,309 @@ export declare function fleetsModule(client: GenesisClient): {
             updated_at?: number;
         }>;
     };
+    /** Agent seats: a persistent Henry agent with a credit purse and a computer entitlement. Plan prices are display data. */
+    seats: {
+        plans: () => Promise<{
+            plans: import("./index.js").components["schemas"]["Fleets.SeatPlan"][];
+            credit?: {
+                unit?: string;
+                value_usd?: number;
+                meaning?: string;
+            };
+        }>;
+        list: () => Promise<{
+            seats: import("./index.js").components["schemas"]["Fleets.Seat"][];
+        }>;
+        /** Hire a seat. idempotency_key is required; reuse it on retry. fund: false opens an empty purse for top-up. */
+        hire: (body: SeatHireInput) => Promise<{
+            id: string;
+            object: "fleets.seat";
+            type: import("./index.js").components["schemas"]["Fleets.SeatType"];
+            name?: string;
+            state: "active" | "paused" | "held" | "killed" | "releasing" | "released";
+            pause_reason?: string;
+            agent_id?: string | null;
+            pool_id?: string | null;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            release?: import("./index.js").components["schemas"]["Fleets.SeatRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        get: (seat_id: string) => Promise<{
+            id: string;
+            object: "fleets.seat";
+            type: import("./index.js").components["schemas"]["Fleets.SeatType"];
+            name?: string;
+            state: "active" | "paused" | "held" | "killed" | "releasing" | "released";
+            pause_reason?: string;
+            agent_id?: string | null;
+            pool_id?: string | null;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            release?: import("./index.js").components["schemas"]["Fleets.SeatRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        update: (seat_id: string, body: SeatUpdateInput) => Promise<{
+            id: string;
+            object: "fleets.seat";
+            type: import("./index.js").components["schemas"]["Fleets.SeatType"];
+            name?: string;
+            state: "active" | "paused" | "held" | "killed" | "releasing" | "released";
+            pause_reason?: string;
+            agent_id?: string | null;
+            pool_id?: string | null;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            release?: import("./index.js").components["schemas"]["Fleets.SeatRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        /** Add credits; overdraft is repaid first. Computer minutes come from the plan (upgrade, or use a pool). A pooled seat answers 409 pooled_seat: top up the pool. */
+        topUp: (seat_id: string, credits: number, idempotency_key: string) => Promise<{
+            id: string;
+            object: "fleets.seat";
+            type: import("./index.js").components["schemas"]["Fleets.SeatType"];
+            name?: string;
+            state: "active" | "paused" | "held" | "killed" | "releasing" | "released";
+            pause_reason?: string;
+            agent_id?: string | null;
+            pool_id?: string | null;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            release?: import("./index.js").components["schemas"]["Fleets.SeatRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        /** Move to a larger plan; there is no downgrade. */
+        upgrade: (seat_id: string, type: "helper" | "operator" | "always_on") => Promise<{
+            id: string;
+            object: "fleets.seat";
+            type: import("./index.js").components["schemas"]["Fleets.SeatType"];
+            name?: string;
+            state: "active" | "paused" | "held" | "killed" | "releasing" | "released";
+            pause_reason?: string;
+            agent_id?: string | null;
+            pool_id?: string | null;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            release?: import("./index.js").components["schemas"]["Fleets.SeatRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        hold: (seat_id: string) => Promise<{
+            id: string;
+            object: "fleets.seat";
+            type: import("./index.js").components["schemas"]["Fleets.SeatType"];
+            name?: string;
+            state: "active" | "paused" | "held" | "killed" | "releasing" | "released";
+            pause_reason?: string;
+            agent_id?: string | null;
+            pool_id?: string | null;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            release?: import("./index.js").components["schemas"]["Fleets.SeatRelease"];
+            created_at?: string;
+            updated_at?: string;
+        } & {
+            cancelled_tasks: string[];
+            agent_state?: string;
+        }>;
+        resume: (seat_id: string) => Promise<{
+            id: string;
+            object: "fleets.seat";
+            type: import("./index.js").components["schemas"]["Fleets.SeatType"];
+            name?: string;
+            state: "active" | "paused" | "held" | "killed" | "releasing" | "released";
+            pause_reason?: string;
+            agent_id?: string | null;
+            pool_id?: string | null;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            release?: import("./index.js").components["schemas"]["Fleets.SeatRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        kill: (seat_id: string) => Promise<{
+            id: string;
+            object: "fleets.seat";
+            type: import("./index.js").components["schemas"]["Fleets.SeatType"];
+            name?: string;
+            state: "active" | "paused" | "held" | "killed" | "releasing" | "released";
+            pause_reason?: string;
+            agent_id?: string | null;
+            pool_id?: string | null;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            release?: import("./index.js").components["schemas"]["Fleets.SeatRelease"];
+            created_at?: string;
+            updated_at?: string;
+        } & {
+            cancelled_tasks: string[];
+            agent_state?: string;
+        }>;
+        /** Settle the purse and delete the agent (terminal); answers returned_credits, returned_computer_minutes, unpaid_overdraft_credits, spent_credits. */
+        release: (seat_id: string) => Promise<{
+            id: string;
+            object: "fleets.seat.release";
+            seat_id?: string;
+            state: "released";
+            returned_credits: number;
+            returned_computer_minutes: number;
+            unpaid_overdraft_credits?: number;
+            spent_credits?: number;
+            pool_id?: string | null;
+            agent_deleted?: boolean;
+            released_at?: string;
+        }>;
+        ledger: (seat_id: string) => Promise<{
+            id?: string;
+            entries: import("./index.js").components["schemas"]["Fleets.SeatLedgerEntry"][];
+        }>;
+        tasks: {
+            list: (seat_id: string) => Promise<{
+                tasks: import("./index.js").components["schemas"]["Fleets.SeatTask"][];
+            }>;
+            /** 402 purse_empty when parked, 403 computer_not_entitled for a helper's computer task, 409 when held, killed or released. */
+            submit: (seat_id: string, body: SeatTaskInput) => Promise<{
+                task_id: string;
+                object?: "fleets.seat.task";
+                seat_id: string;
+                kind: "research" | "computer";
+                state: "pending" | "running" | "awaiting_approval" | "completed" | "failed" | "cancelled" | "timed_out";
+                output?: string | null;
+                error?: string | null;
+                approvals?: import("./index.js").components["schemas"]["Fleets.SeatApproval"][];
+                credits?: {
+                    reserved?: number;
+                    charged?: number | null;
+                    borrowed?: number;
+                };
+                computer_minutes?: number;
+                computer_minutes_allowed?: number;
+                settled?: boolean;
+                receipt_url?: string;
+                submitted_at?: string;
+                completed_at?: string | null;
+            }>;
+            get: (seat_id: string, task_id: string) => Promise<{
+                task_id: string;
+                object?: "fleets.seat.task";
+                seat_id: string;
+                kind: "research" | "computer";
+                state: "pending" | "running" | "awaiting_approval" | "completed" | "failed" | "cancelled" | "timed_out";
+                output?: string | null;
+                error?: string | null;
+                approvals?: import("./index.js").components["schemas"]["Fleets.SeatApproval"][];
+                credits?: {
+                    reserved?: number;
+                    charged?: number | null;
+                    borrowed?: number;
+                };
+                computer_minutes?: number;
+                computer_minutes_allowed?: number;
+                settled?: boolean;
+                receipt_url?: string;
+                submitted_at?: string;
+                completed_at?: string | null;
+            }>;
+            decide: (seat_id: string, task_id: string, approval_id: string, decision: "approve" | "deny") => Promise<{
+                task_id: string;
+                object?: "fleets.seat.task";
+                seat_id: string;
+                kind: "research" | "computer";
+                state: "pending" | "running" | "awaiting_approval" | "completed" | "failed" | "cancelled" | "timed_out";
+                output?: string | null;
+                error?: string | null;
+                approvals?: import("./index.js").components["schemas"]["Fleets.SeatApproval"][];
+                credits?: {
+                    reserved?: number;
+                    charged?: number | null;
+                    borrowed?: number;
+                };
+                computer_minutes?: number;
+                computer_minutes_allowed?: number;
+                settled?: boolean;
+                receipt_url?: string;
+                submitted_at?: string;
+                completed_at?: string | null;
+            }>;
+        };
+    };
+    /** Seat pools: a shared purse and computer minutes that seats hired with pool_id draw on. */
+    pools: {
+        list: () => Promise<{
+            pools: import("./index.js").components["schemas"]["Fleets.Pool"][];
+        }>;
+        create: (body: PoolCreateInput) => Promise<{
+            id: string;
+            object: "fleets.pool";
+            name?: string;
+            state?: string;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            seats?: string[];
+            release?: import("./index.js").components["schemas"]["Fleets.PoolRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        get: (pool_id: string) => Promise<{
+            id: string;
+            object: "fleets.pool";
+            name?: string;
+            state?: string;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            seats?: string[];
+            release?: import("./index.js").components["schemas"]["Fleets.PoolRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        topUp: (pool_id: string, body: PoolTopUpInput) => Promise<{
+            id: string;
+            object: "fleets.pool";
+            name?: string;
+            state?: string;
+            purse: import("./index.js").components["schemas"]["Fleets.Purse"];
+            computer: import("./index.js").components["schemas"]["Fleets.Computer"];
+            seats?: string[];
+            release?: import("./index.js").components["schemas"]["Fleets.PoolRelease"];
+            created_at?: string;
+            updated_at?: string;
+        }>;
+        ledger: (pool_id: string) => Promise<{
+            id?: string;
+            entries: import("./index.js").components["schemas"]["Fleets.SeatLedgerEntry"][];
+        }>;
+        /** Settle the pool (terminal); answers returned_credits and returned_computer_minutes. 409 pool_has_seats while seats remain. */
+        release: (pool_id: string) => Promise<{
+            id: string;
+            object: "fleets.pool.release";
+            pool_id?: string;
+            state: "released";
+            returned_credits: number;
+            returned_computer_minutes: number;
+            unpaid_overdraft_credits?: number;
+            spent_credits?: number;
+            released_at?: string;
+        }>;
+    };
+    /** The organization key seat computer tasks use for Panes and Shells; KMS-encrypted, never returned. */
+    computerConnection: {
+        get: () => Promise<{
+            connected: boolean;
+            updated_at?: number;
+        }>;
+        set: (api_key: string) => Promise<{
+            connected: boolean;
+            updated_at?: number;
+        }>;
+        delete: () => Promise<{
+            connected: boolean;
+            updated_at?: number;
+        }>;
+    };
     usage: {
         /** Task lifecycle and execution-time usage events, paged by task like tasks.list. */
         events: (query?: OperationInput<"fleets_listUsageEvents">) => Promise<{