@naisys/hub-protocol 3.0.0-beta.3

package/dist/eventMap.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Typed event map for hub protocol events.
+ *
+ * Maps each event name to its payload types so that registerEvent, sendMessage,
+ * and sendRequest can enforce correct signatures at compile time.
+ */
+import type { HubEvents } from "./events.js";
+import type { RotateAccessKeyRequest, RotateAccessKeyResponse } from "./schemas/admin.js";
+import type { AgentPeekRequest, AgentPeekResponse, AgentStartRequest, AgentStartResponse, AgentStopRequest, AgentStopResponse } from "./schemas/agents.js";
+import type { ConfigResponse } from "./schemas/config.js";
+import type { CostControl, CostPush, CostWriteRequest, CostWriteResponse } from "./schemas/costs.js";
+import type { AgentsStatus, Heartbeat } from "./schemas/heartbeat.js";
+import type { HostList } from "./schemas/hosts.js";
+import type { LogPush, LogWriteRequest } from "./schemas/logs.js";
+import type { MailArchiveRequest, MailArchiveResponse, MailListRequest, MailListResponse, MailMarkReadRequest, MailMarkReadResponse, MailPeekRequest, MailPeekResponse, MailPush, MailReadPush, MailReceivedPush, MailSearchRequest, MailSearchResponse, MailSendRequest, MailSendResponse, MailUnreadRequest, MailUnreadResponse } from "./schemas/mail.js";
+import type { ModelsResponse } from "./schemas/models.js";
+import type { SessionCreateRequest, SessionCreateResponse, SessionIncrementRequest, SessionIncrementResponse, SessionPush } from "./schemas/sessions.js";
+import type { UserListResponse } from "./schemas/users.js";
+/** Events that follow a request → response pattern via Socket.IO ack */
+export interface HubRequestEvents {
+    [HubEvents.AGENT_START]: {
+        request: AgentStartRequest;
+        response: AgentStartResponse;
+    };
+    [HubEvents.AGENT_STOP]: {
+        request: AgentStopRequest;
+        response: AgentStopResponse;
+    };
+    [HubEvents.AGENT_PEEK]: {
+        request: AgentPeekRequest;
+        response: AgentPeekResponse;
+    };
+    [HubEvents.SESSION_CREATE]: {
+        request: SessionCreateRequest;
+        response: SessionCreateResponse;
+    };
+    [HubEvents.SESSION_INCREMENT]: {
+        request: SessionIncrementRequest;
+        response: SessionIncrementResponse;
+    };
+    [HubEvents.MAIL_SEND]: {
+        request: MailSendRequest;
+        response: MailSendResponse;
+    };
+    [HubEvents.MAIL_LIST]: {
+        request: MailListRequest;
+        response: MailListResponse;
+    };
+    [HubEvents.MAIL_PEEK]: {
+        request: MailPeekRequest;
+        response: MailPeekResponse;
+    };
+    [HubEvents.MAIL_MARK_READ]: {
+        request: MailMarkReadRequest;
+        response: MailMarkReadResponse;
+    };
+    [HubEvents.MAIL_ARCHIVE]: {
+        request: MailArchiveRequest;
+        response: MailArchiveResponse;
+    };
+    [HubEvents.MAIL_SEARCH]: {
+        request: MailSearchRequest;
+        response: MailSearchResponse;
+    };
+    [HubEvents.MAIL_UNREAD]: {
+        request: MailUnreadRequest;
+        response: MailUnreadResponse;
+    };
+    [HubEvents.ROTATE_ACCESS_KEY]: {
+        request: RotateAccessKeyRequest;
+        response: RotateAccessKeyResponse;
+    };
+    [HubEvents.COST_WRITE]: {
+        request: CostWriteRequest;
+        response: CostWriteResponse;
+    };
+}
+/** Events sent from NAISYS to Hub with no response expected */
+export interface HubFireAndForgetEvents {
+    [HubEvents.HEARTBEAT]: Heartbeat;
+    [HubEvents.LOG_WRITE]: LogWriteRequest;
+}
+/** Events pushed from Hub to NAISYS clients */
+export interface HubPushEvents {
+    [HubEvents.USERS_UPDATED]: UserListResponse;
+    [HubEvents.HOSTS_UPDATED]: HostList;
+    [HubEvents.VARIABLES_UPDATED]: ConfigResponse;
+    [HubEvents.MODELS_UPDATED]: ModelsResponse;
+    [HubEvents.AGENTS_STATUS]: AgentsStatus;
+    [HubEvents.COST_CONTROL]: CostControl;
+    [HubEvents.MAIL_RECEIVED]: MailReceivedPush;
+}
+/** Events pushed from Hub to Supervisor connections only */
+export interface HubSupervisorPushEvents {
+    [HubEvents.LOG_PUSH]: LogPush;
+    [HubEvents.MAIL_PUSH]: MailPush;
+    [HubEvents.MAIL_READ_PUSH]: MailReadPush;
+    [HubEvents.COST_PUSH]: CostPush;
+    [HubEvents.SESSION_PUSH]: SessionPush;
+}
+/** Events from Supervisor that trigger hub-side refresh + broadcast */
+export interface HubTriggerEvents {
+    [HubEvents.USERS_CHANGED]: void;
+    [HubEvents.VARIABLES_CHANGED]: void;
+    [HubEvents.MODELS_CHANGED]: void;
+    [HubEvents.HOSTS_CHANGED]: void;
+}
+export type HubRequestEventName = keyof HubRequestEvents;
+export type HubFireAndForgetEventName = keyof HubFireAndForgetEvents;
+export type HubPushEventName = keyof HubPushEvents;
+export type HubSupervisorPushEventName = keyof HubSupervisorPushEvents;
+export type HubTriggerEventName = keyof HubTriggerEvents;
+/** Events the supervisor listens for (hub → supervisor push events) */
+export type SupervisorListenEvents = {
+    [E in HubPushEventName]: (data: HubPushEvents[E]) => void;
+} & {
+    [E in HubSupervisorPushEventName]: (data: HubSupervisorPushEvents[E]) => void;
+};
+/** Events the supervisor emits (supervisor → hub) */
+export type SupervisorEmitEvents = {
+    [E in HubRequestEventName]: (data: HubRequestEvents[E]["request"], ack: (response: HubRequestEvents[E]["response"]) => void) => void;
+} & {
+    [E in HubTriggerEventName]: () => void;
+};
+//# sourceMappingURL=eventMap.d.ts.map

package/dist/eventMap.js

@@ -0,0 +1,7 @@
+/**
+ * Typed event map for hub protocol events.
+ *
+ * Maps each event name to its payload types so that registerEvent, sendMessage,
+ * and sendRequest can enforce correct signatures at compile time.
+ */
+export {};

package/dist/events.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Hub Protocol Event Names
+ *
+ * Participants:
+ *   NAISYS      – AI agent host instances (Socket.IO clients)
+ *   Hub         – Central coordination server (Socket.IO server)
+ *   Supervisor  – Web admin backend (Socket.IO client, hostType: "supervisor")
+ */
+export declare const HubEvents: {
+    /** Raised inside the hub when a Socket.IO client connects */
+    readonly CLIENT_CONNECTED: "client_connected";
+    /** Raised inside the hub when a Socket.IO client disconnects */
+    readonly CLIENT_DISCONNECTED: "client_disconnected";
+    /** Full user list, pushed on connect and when users change */
+    readonly USERS_UPDATED: "users_updated";
+    /** Connected host topology, pushed on connect and on host changes */
+    readonly HOSTS_UPDATED: "hosts_updated";
+    /** Global config (shell limits, variables, spend limits), pushed on connect and on variable changes */
+    readonly VARIABLES_UPDATED: "variables_updated";
+    /** LLM and image model definitions, pushed on connect and on model changes */
+    readonly MODELS_UPDATED: "models_updated";
+    /** Aggregate active-agent map and notification counters, pushed periodically and on agent changes */
+    readonly AGENTS_STATUS: "agents_status";
+    /** Full-data log push with entries and session deltas */
+    readonly LOG_PUSH: "log_push";
+    /** Full-data mail/chat push with message data */
+    readonly MAIL_PUSH: "mail_push";
+    /** Read-receipt push when messages are marked read */
+    readonly MAIL_READ_PUSH: "mail_read_push";
+    /** Cost delta push per session */
+    readonly COST_PUSH: "cost_push";
+    /** New session push with full RunSession data */
+    readonly SESSION_PUSH: "session_push";
+    /** Spending limit enforcement, pushed to the host running the affected agent */
+    readonly COST_CONTROL: "cost_control";
+    /** New mail notification, pushed to hosts running recipient agents */
+    readonly MAIL_RECEIVED: "mail_received";
+    /** Periodic heartbeat with active agent user IDs */
+    readonly HEARTBEAT: "heartbeat";
+    /** Batched log entries */
+    readonly LOG_WRITE: "log_write";
+    /** Batched cost/token entries */
+    readonly COST_WRITE: "cost_write";
+    /** Create a new run session */
+    readonly SESSION_CREATE: "session_create";
+    /** Increment session within an existing run */
+    readonly SESSION_INCREMENT: "session_increment";
+    /** Start an agent on its assigned host */
+    readonly AGENT_START: "agent_start";
+    /** Stop an agent on its current host */
+    readonly AGENT_STOP: "agent_stop";
+    /** Peek at an agent's output buffer */
+    readonly AGENT_PEEK: "agent_peek";
+    /** Rotate the hub access key */
+    readonly ROTATE_ACCESS_KEY: "rotate_access_key";
+    /** Send a mail message */
+    readonly MAIL_SEND: "mail_send";
+    /** List recent mail messages */
+    readonly MAIL_LIST: "mail_list";
+    /** Fetch a specific mail message (does not mark as read) */
+    readonly MAIL_PEEK: "mail_peek";
+    /** Mark messages as read */
+    readonly MAIL_MARK_READ: "mail_mark_read";
+    /** Archive mail messages */
+    readonly MAIL_ARCHIVE: "mail_archive";
+    /** Full-text search of mail */
+    readonly MAIL_SEARCH: "mail_search";
+    /** Get unread messages with full data */
+    readonly MAIL_UNREAD: "mail_unread";
+    /** Users changed — hub re-queries DB and broadcasts USERS_UPDATED */
+    readonly USERS_CHANGED: "users_changed";
+    /** Variables changed — hub rebuilds config and broadcasts VARIABLES_UPDATED */
+    readonly VARIABLES_CHANGED: "variables_changed";
+    /** Models changed — hub re-reads models and broadcasts MODELS_UPDATED */
+    readonly MODELS_CHANGED: "models_changed";
+    /** Hosts changed — hub refreshes host cache and broadcasts HOSTS_UPDATED */
+    readonly HOSTS_CHANGED: "hosts_changed";
+};
+export type HubEventName = (typeof HubEvents)[keyof typeof HubEvents];
+//# sourceMappingURL=events.d.ts.map

package/dist/events.js

@@ -0,0 +1,108 @@
+/**
+ * Hub Protocol Event Names
+ *
+ * Participants:
+ *   NAISYS      – AI agent host instances (Socket.IO clients)
+ *   Hub         – Central coordination server (Socket.IO server)
+ *   Supervisor  – Web admin backend (Socket.IO client, hostType: "supervisor")
+ */
+export const HubEvents = {
+    // ---------------------------------------------------------------------------
+    // Internal hub events (not sent over the wire)
+    // ---------------------------------------------------------------------------
+    /** Raised inside the hub when a Socket.IO client connects */
+    CLIENT_CONNECTED: "client_connected",
+    /** Raised inside the hub when a Socket.IO client disconnects */
+    CLIENT_DISCONNECTED: "client_disconnected",
+    // ---------------------------------------------------------------------------
+    // Hub -> NAISYS push (broadcast to all connected clients)
+    // ---------------------------------------------------------------------------
+    /** Full user list, pushed on connect and when users change */
+    USERS_UPDATED: "users_updated",
+    /** Connected host topology, pushed on connect and on host changes */
+    HOSTS_UPDATED: "hosts_updated",
+    /** Global config (shell limits, variables, spend limits), pushed on connect and on variable changes */
+    VARIABLES_UPDATED: "variables_updated",
+    /** LLM and image model definitions, pushed on connect and on model changes */
+    MODELS_UPDATED: "models_updated",
+    /** Aggregate active-agent map and notification counters, pushed periodically and on agent changes */
+    AGENTS_STATUS: "agents_status",
+    // ---------------------------------------------------------------------------
+    // Hub -> Supervisor push (targeted to supervisor connections only)
+    // ---------------------------------------------------------------------------
+    /** Full-data log push with entries and session deltas */
+    LOG_PUSH: "log_push",
+    /** Full-data mail/chat push with message data */
+    MAIL_PUSH: "mail_push",
+    /** Read-receipt push when messages are marked read */
+    MAIL_READ_PUSH: "mail_read_push",
+    /** Cost delta push per session */
+    COST_PUSH: "cost_push",
+    /** New session push with full RunSession data */
+    SESSION_PUSH: "session_push",
+    // ---------------------------------------------------------------------------
+    // Hub -> NAISYS push (targeted to specific host)
+    // ---------------------------------------------------------------------------
+    /** Spending limit enforcement, pushed to the host running the affected agent */
+    COST_CONTROL: "cost_control",
+    /** New mail notification, pushed to hosts running recipient agents */
+    MAIL_RECEIVED: "mail_received",
+    // ---------------------------------------------------------------------------
+    // NAISYS -> Hub (fire-and-forget)
+    // ---------------------------------------------------------------------------
+    /** Periodic heartbeat with active agent user IDs */
+    HEARTBEAT: "heartbeat",
+    /** Batched log entries */
+    LOG_WRITE: "log_write",
+    /** Batched cost/token entries */
+    COST_WRITE: "cost_write",
+    // ---------------------------------------------------------------------------
+    // NAISYS -> Hub (request/response)
+    // ---------------------------------------------------------------------------
+    /** Create a new run session */
+    SESSION_CREATE: "session_create",
+    /** Increment session within an existing run */
+    SESSION_INCREMENT: "session_increment",
+    // ---------------------------------------------------------------------------
+    // NAISYS/Supervisor -> Hub -> target NAISYS (request/response, two-hop relay)
+    // ---------------------------------------------------------------------------
+    /** Start an agent on its assigned host */
+    AGENT_START: "agent_start",
+    /** Stop an agent on its current host */
+    AGENT_STOP: "agent_stop",
+    /** Peek at an agent's output buffer */
+    AGENT_PEEK: "agent_peek",
+    // ---------------------------------------------------------------------------
+    // Supervisor -> Hub (request/response) – Admin
+    // ---------------------------------------------------------------------------
+    /** Rotate the hub access key */
+    ROTATE_ACCESS_KEY: "rotate_access_key",
+    // ---------------------------------------------------------------------------
+    // NAISYS/Supervisor -> Hub (request/response) – Mail
+    // ---------------------------------------------------------------------------
+    /** Send a mail message */
+    MAIL_SEND: "mail_send",
+    /** List recent mail messages */
+    MAIL_LIST: "mail_list",
+    /** Fetch a specific mail message (does not mark as read) */
+    MAIL_PEEK: "mail_peek",
+    /** Mark messages as read */
+    MAIL_MARK_READ: "mail_mark_read",
+    /** Archive mail messages */
+    MAIL_ARCHIVE: "mail_archive",
+    /** Full-text search of mail */
+    MAIL_SEARCH: "mail_search",
+    /** Get unread messages with full data */
+    MAIL_UNREAD: "mail_unread",
+    // ---------------------------------------------------------------------------
+    // Supervisor -> Hub (fire-and-forget, triggers broadcast)
+    // ---------------------------------------------------------------------------
+    /** Users changed — hub re-queries DB and broadcasts USERS_UPDATED */
+    USERS_CHANGED: "users_changed",
+    /** Variables changed — hub rebuilds config and broadcasts VARIABLES_UPDATED */
+    VARIABLES_CHANGED: "variables_changed",
+    /** Models changed — hub re-reads models and broadcasts MODELS_UPDATED */
+    MODELS_CHANGED: "models_changed",
+    /** Hosts changed — hub refreshes host cache and broadcasts HOSTS_UPDATED */
+    HOSTS_CHANGED: "hosts_changed",
+};

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Hub Protocol
+ *
+ * Shared message types and event names between NAISYS instances (clients),
+ * the Hub server, and the Supervisor for multi-machine synchronization.
+ */
+export * from "./eventMap.js";
+export * from "./events.js";
+export * from "./schemas/admin.js";
+export * from "./schemas/agents.js";
+export * from "./schemas/config.js";
+export * from "./schemas/costs.js";
+export * from "./schemas/heartbeat.js";
+export * from "./schemas/hosts.js";
+export * from "./schemas/logs.js";
+export * from "./schemas/mail.js";
+export * from "./schemas/models.js";
+export * from "./schemas/sessions.js";
+export * from "./schemas/users.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * Hub Protocol
+ *
+ * Shared message types and event names between NAISYS instances (clients),
+ * the Hub server, and the Supervisor for multi-machine synchronization.
+ */
+export * from "./eventMap.js";
+export * from "./events.js";
+export * from "./schemas/admin.js";
+export * from "./schemas/agents.js";
+export * from "./schemas/config.js";
+export * from "./schemas/costs.js";
+export * from "./schemas/heartbeat.js";
+export * from "./schemas/hosts.js";
+export * from "./schemas/logs.js";
+export * from "./schemas/mail.js";
+export * from "./schemas/models.js";
+export * from "./schemas/sessions.js";
+export * from "./schemas/users.js";

package/dist/schemas/admin.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+/** Request to rotate the hub access key (empty payload) */
+export declare const RotateAccessKeyRequestSchema: z.ZodObject<{}, z.core.$strip>;
+export type RotateAccessKeyRequest = z.infer<typeof RotateAccessKeyRequestSchema>;
+/** Response after rotating the hub access key */
+export declare const RotateAccessKeyResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    newAccessKey: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RotateAccessKeyResponse = z.infer<typeof RotateAccessKeyResponseSchema>;
+//# sourceMappingURL=admin.d.ts.map

package/dist/schemas/admin.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+/** Request to rotate the hub access key (empty payload) */
+export const RotateAccessKeyRequestSchema = z.object({});
+/** Response after rotating the hub access key */
+export const RotateAccessKeyResponseSchema = z.object({
+    success: z.boolean(),
+    newAccessKey: z.string().optional(),
+    error: z.string().optional(),
+});

package/dist/schemas/agents.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+/** Request to start an agent on its assigned host */
+export declare const AgentStartRequestSchema: z.ZodObject<{
+    startUserId: z.ZodNumber;
+    taskDescription: z.ZodOptional<z.ZodString>;
+    requesterUserId: z.ZodOptional<z.ZodNumber>;
+    sourceHostId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AgentStartRequest = z.infer<typeof AgentStartRequestSchema>;
+/** Response to agent start request */
+export declare const AgentStartResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+    hostname: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentStartResponse = z.infer<typeof AgentStartResponseSchema>;
+/** Request to stop an agent on its current host */
+export declare const AgentStopRequestSchema: z.ZodObject<{
+    userId: z.ZodNumber;
+    reason: z.ZodString;
+    sourceHostId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AgentStopRequest = z.infer<typeof AgentStopRequestSchema>;
+/** Response to agent stop request */
+export declare const AgentStopResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentStopResponse = z.infer<typeof AgentStopResponseSchema>;
+/** Request to peek at an agent's output buffer */
+export declare const AgentPeekRequestSchema: z.ZodObject<{
+    userId: z.ZodNumber;
+    skip: z.ZodOptional<z.ZodNumber>;
+    take: z.ZodOptional<z.ZodNumber>;
+    sourceHostId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AgentPeekRequest = z.infer<typeof AgentPeekRequestSchema>;
+/** Response to agent peek request */
+export declare const AgentPeekResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+    lines: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    totalLines: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AgentPeekResponse = z.infer<typeof AgentPeekResponseSchema>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/schemas/agents.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+/** Request to start an agent on its assigned host */
+export const AgentStartRequestSchema = z.object({
+    startUserId: z.number(),
+    taskDescription: z.string().optional(),
+    // Used for permission validation
+    requesterUserId: z.number().optional(),
+    // Used to prevent redundant notification on loop back
+    sourceHostId: z.number().optional(),
+});
+/** Response to agent start request */
+export const AgentStartResponseSchema = z.object({
+    success: z.boolean(),
+    error: z.string().optional(),
+    hostname: z.string().optional(),
+});
+/** Request to stop an agent on its current host */
+export const AgentStopRequestSchema = z.object({
+    userId: z.number(),
+    reason: z.string(),
+    sourceHostId: z.number().optional(),
+});
+/** Response to agent stop request */
+export const AgentStopResponseSchema = z.object({
+    success: z.boolean(),
+    error: z.string().optional(),
+});
+/** Request to peek at an agent's output buffer */
+export const AgentPeekRequestSchema = z.object({
+    userId: z.number(),
+    skip: z.number().optional(),
+    take: z.number().optional(),
+    sourceHostId: z.number().optional(),
+});
+/** Response to agent peek request */
+export const AgentPeekResponseSchema = z.object({
+    success: z.boolean(),
+    error: z.string().optional(),
+    lines: z.array(z.string()).optional(),
+    totalLines: z.number().optional(),
+});

package/dist/schemas/config.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+/** Pushed from hub to NAISYS instances on connect with global config */
+export declare const ConfigResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodObject<{
+        shellCommand: z.ZodObject<{
+            outputTokenMax: z.ZodNumber;
+            timeoutSeconds: z.ZodNumber;
+            maxTimeoutSeconds: z.ZodNumber;
+        }, z.core.$strip>;
+        retrySecondsMax: z.ZodNumber;
+        webTokenMax: z.ZodNumber;
+        compactSessionEnabled: z.ZodBoolean;
+        preemptiveCompactEnabled: z.ZodBoolean;
+        variableMap: z.ZodRecord<z.ZodString, z.ZodString>;
+        shellVariableMap: z.ZodRecord<z.ZodString, z.ZodString>;
+        googleSearchEngineId: z.ZodOptional<z.ZodString>;
+        spendLimitDollars: z.ZodOptional<z.ZodNumber>;
+        spendLimitHours: z.ZodOptional<z.ZodNumber>;
+        useToolsForLlmConsoleResponses: z.ZodBoolean;
+        autoStartAgentsOnMessage: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ConfigResponse = z.infer<typeof ConfigResponseSchema>;
+//# sourceMappingURL=config.d.ts.map

package/dist/schemas/config.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+/** Pushed from hub to NAISYS instances on connect with global config */
+export const ConfigResponseSchema = z.object({
+    success: z.boolean(),
+    error: z.string().optional(),
+    config: z
+        .object({
+        shellCommand: z.object({
+            outputTokenMax: z.number(),
+            timeoutSeconds: z.number(),
+            maxTimeoutSeconds: z.number(),
+        }),
+        retrySecondsMax: z.number(),
+        webTokenMax: z.number(),
+        compactSessionEnabled: z.boolean(),
+        preemptiveCompactEnabled: z.boolean(),
+        variableMap: z.record(z.string(), z.string()),
+        shellVariableMap: z.record(z.string(), z.string()),
+        googleSearchEngineId: z.string().optional(),
+        spendLimitDollars: z.number().optional(),
+        spendLimitHours: z.number().optional(),
+        useToolsForLlmConsoleResponses: z.boolean(),
+        autoStartAgentsOnMessage: z.boolean(),
+    })
+        .optional(),
+});

package/dist/schemas/costs.d.ts

@@ -0,0 +1,97 @@
+import { z } from "zod";
+/** How often NAISYS instances flush buffered cost entries to the hub (ms) */
+export declare const COST_FLUSH_INTERVAL_MS = 100;
+export declare const CostSourceEnum: z.ZodEnum<{
+    console: "console";
+    write_protection: "write_protection";
+    compact: "compact";
+    lynx: "lynx";
+    look: "look";
+    listen: "listen";
+    genimg: "genimg";
+}>;
+export type CostSource = z.infer<typeof CostSourceEnum>;
+/** A single cost entry sent from NAISYS instance to hub */
+export declare const CostWriteEntrySchema: z.ZodObject<{
+    userId: z.ZodNumber;
+    runId: z.ZodNumber;
+    sessionId: z.ZodNumber;
+    source: z.ZodEnum<{
+        console: "console";
+        write_protection: "write_protection";
+        compact: "compact";
+        lynx: "lynx";
+        look: "look";
+        listen: "listen";
+        genimg: "genimg";
+    }>;
+    model: z.ZodString;
+    cost: z.ZodNumber;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    cacheWriteTokens: z.ZodNumber;
+    cacheReadTokens: z.ZodNumber;
+}, z.core.$strip>;
+export type CostWriteEntry = z.infer<typeof CostWriteEntrySchema>;
+/** Batch of cost entries sent from NAISYS instance to hub */
+export declare const CostWriteRequestSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        userId: z.ZodNumber;
+        runId: z.ZodNumber;
+        sessionId: z.ZodNumber;
+        source: z.ZodEnum<{
+            console: "console";
+            write_protection: "write_protection";
+            compact: "compact";
+            lynx: "lynx";
+            look: "look";
+            listen: "listen";
+            genimg: "genimg";
+        }>;
+        model: z.ZodString;
+        cost: z.ZodNumber;
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cacheWriteTokens: z.ZodNumber;
+        cacheReadTokens: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CostWriteRequest = z.infer<typeof CostWriteRequestSchema>;
+/** Per-user budget entry in the COST_WRITE response */
+export declare const CostWriteBudgetEntrySchema: z.ZodObject<{
+    userId: z.ZodNumber;
+    budgetLeft: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+/** Response to COST_WRITE — returns per-agent budget info for each user in the batch */
+export declare const CostWriteResponseSchema: z.ZodObject<{
+    budgets: z.ZodArray<z.ZodObject<{
+        userId: z.ZodNumber;
+        budgetLeft: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CostWriteResponse = z.infer<typeof CostWriteResponseSchema>;
+/** Cost delta pushed from hub to supervisor after DB write */
+export declare const CostPushEntrySchema: z.ZodObject<{
+    userId: z.ZodNumber;
+    runId: z.ZodNumber;
+    sessionId: z.ZodNumber;
+    costDelta: z.ZodNumber;
+}, z.core.$strip>;
+export type CostPushEntry = z.infer<typeof CostPushEntrySchema>;
+export declare const CostPushSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        userId: z.ZodNumber;
+        runId: z.ZodNumber;
+        sessionId: z.ZodNumber;
+        costDelta: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CostPush = z.infer<typeof CostPushSchema>;
+/** Pushed from hub when an agent's spending status changes */
+export declare const CostControlSchema: z.ZodObject<{
+    userId: z.ZodNumber;
+    enabled: z.ZodBoolean;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type CostControl = z.infer<typeof CostControlSchema>;
+//# sourceMappingURL=costs.d.ts.map