@hypercli.com/sdk 2026.6.26 → 2026.8.11

package/dist/hermes/gateway.d.ts

@@ -0,0 +1,194 @@
+export interface HermesApiClientOptions {
+    apiKey?: string | null;
+    fetch?: typeof globalThis.fetch;
+    headers?: Headers | Record<string, string> | Array<[string, string]>;
+}
+export interface HermesHealth extends Record<string, unknown> {
+    status: string;
+    platform: string;
+    version: string;
+}
+export interface HermesDetailedHealth extends HermesHealth {
+    readiness?: Record<string, unknown>;
+    gateway_state?: string | null;
+    gateway_busy?: boolean;
+    gateway_drainable?: boolean;
+}
+export interface HermesCapabilities extends Record<string, unknown> {
+    object: 'hermes.api_server.capabilities' | string;
+    platform: 'hermes-agent' | string;
+    model: string;
+    auth: {
+        type: string;
+        required: boolean;
+        [key: string]: unknown;
+    };
+    features: Record<string, boolean | string | number | null>;
+    endpoints: Record<string, {
+        method: string;
+        path: string;
+        [key: string]: unknown;
+    }>;
+}
+export interface HermesModel extends Record<string, unknown> {
+    id: string;
+    object: 'model' | string;
+    created?: number;
+    owned_by?: string;
+    root?: string;
+    parent?: string | null;
+}
+export interface HermesModelsResponse extends Record<string, unknown> {
+    object: 'list' | string;
+    data: HermesModel[];
+}
+export interface HermesSession extends Record<string, unknown> {
+    id: string;
+    title?: string | null;
+    source?: string;
+    model?: string | null;
+}
+export interface HermesSessionResponse extends Record<string, unknown> {
+    object: 'hermes.session' | string;
+    session: HermesSession;
+}
+export interface HermesSessionListResponse extends Record<string, unknown> {
+    object: 'list' | string;
+    data: HermesSession[];
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}
+export interface HermesListSessionsOptions {
+    limit?: number;
+    offset?: number;
+    source?: string;
+    includeChildren?: boolean;
+}
+export interface HermesCreateSessionRequest extends Record<string, unknown> {
+    id?: string;
+    session_id?: string;
+    title?: string;
+    source?: string;
+    model?: string;
+    provider?: string;
+    model_options?: Record<string, unknown>;
+    system_prompt?: string;
+    require_model_lock?: boolean;
+}
+export interface HermesUpdateSessionRequest {
+    title?: string | null;
+    end_reason?: string;
+}
+export interface HermesSessionMessagesResponse extends Record<string, unknown> {
+    object?: string;
+    session_id?: string;
+    data?: Array<Record<string, unknown>>;
+    messages?: Array<Record<string, unknown>>;
+}
+export interface HermesForkSessionRequest extends Record<string, unknown> {
+    id?: string;
+    session_id?: string;
+    title?: string;
+}
+export interface HermesSessionChatRequest extends Record<string, unknown> {
+    message: string;
+    system_message?: string;
+    instructions?: string;
+    model?: string;
+    provider?: string;
+    model_options?: Record<string, unknown>;
+    require_model_lock?: boolean;
+}
+export interface HermesSessionChatResponse extends Record<string, unknown> {
+    object?: 'hermes.session.chat.completion' | string;
+    session_id?: string;
+    message?: {
+        role: string;
+        content: string;
+        [key: string]: unknown;
+    };
+    messages?: Array<Record<string, unknown>>;
+    usage?: Record<string, unknown>;
+    runtime?: Record<string, unknown>;
+}
+export interface HermesSessionModelLockRequest extends Record<string, unknown> {
+    model: string;
+    provider?: string;
+    model_options?: Record<string, unknown>;
+}
+export interface HermesSessionModelLockResponse extends Record<string, unknown> {
+    object: 'hermes.session.model_lock' | string;
+    session_id: string;
+    runtime: Record<string, unknown>;
+}
+export interface HermesCreateRunRequest extends Record<string, unknown> {
+    input: string | Array<Record<string, unknown>>;
+    instructions?: string;
+    session_id?: string;
+    previous_response_id?: string;
+    conversation_history?: Array<Record<string, unknown>>;
+    model?: string;
+    provider?: string;
+    model_options?: Record<string, unknown>;
+}
+export interface HermesCreateRunResponse extends Record<string, unknown> {
+    run_id: string;
+    status: string;
+}
+export interface HermesRun extends Record<string, unknown> {
+    object?: 'hermes.run' | string;
+    run_id: string;
+    status: string;
+    session_id?: string;
+}
+export type HermesApprovalChoice = 'once' | 'session' | 'always' | 'deny';
+export interface HermesApproveRunRequest {
+    choice: HermesApprovalChoice;
+    resolveAll?: boolean;
+}
+export interface HermesApproveRunResponse extends Record<string, unknown> {
+    object: 'hermes.run.approval_response' | string;
+    run_id: string;
+    choice: HermesApprovalChoice;
+    resolved: number;
+}
+/** One decoded SSE frame. Unknown event names and payload fields are preserved. */
+export interface HermesSseEvent<T = unknown> {
+    event: string;
+    data: T;
+    id?: string;
+    retry?: number;
+    /** Original, undecoded data lines joined with newlines. */
+    rawData: string;
+}
+export declare class HermesApiClient {
+    readonly baseUrl: string;
+    readonly openaiBaseUrl: string;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    private readonly defaultHeaders;
+    constructor(baseUrl: string, options?: HermesApiClientOptions);
+    private request;
+    private requestRaw;
+    health(): Promise<HermesHealth>;
+    healthDetailed(): Promise<HermesDetailedHealth>;
+    capabilities(): Promise<HermesCapabilities>;
+    models(): Promise<HermesModelsResponse>;
+    listSessions(options?: HermesListSessionsOptions): Promise<HermesSessionListResponse>;
+    createSession(request?: HermesCreateSessionRequest): Promise<HermesSessionResponse>;
+    getSession(sessionId: string): Promise<HermesSessionResponse>;
+    updateSession(sessionId: string, request: HermesUpdateSessionRequest): Promise<HermesSessionResponse>;
+    deleteSession(sessionId: string): Promise<Record<string, unknown>>;
+    sessionMessages(sessionId: string): Promise<HermesSessionMessagesResponse>;
+    forkSession(sessionId: string, request?: HermesForkSessionRequest): Promise<HermesSessionResponse>;
+    chatSession(sessionId: string, request: HermesSessionChatRequest): Promise<HermesSessionChatResponse>;
+    streamSessionChat(sessionId: string, request: HermesSessionChatRequest): AsyncGenerator<HermesSseEvent>;
+    lockSessionModel(sessionId: string, request: HermesSessionModelLockRequest): Promise<HermesSessionModelLockResponse>;
+    createRun(request: HermesCreateRunRequest): Promise<HermesCreateRunResponse>;
+    getRun(runId: string): Promise<HermesRun>;
+    runEvents(runId: string): AsyncGenerator<HermesSseEvent>;
+    approveRun(runId: string, request: HermesApproveRunRequest): Promise<HermesApproveRunResponse>;
+    stopRun(runId: string): Promise<HermesRun>;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/hermes/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/hermes/gateway.ts"],"names":[],"mappings":"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"}

package/dist/hermes/gateway.js

@@ -0,0 +1,209 @@
+/**
+ * Client for the stable Hermes Agent HTTP/SSE gateway surface.
+ *
+ * Payloads intentionally remain extensible: Hermes owns the OpenAI-compatible
+ * schemas and may add session, run, or event fields without an SDK release.
+ */
+import { APIError } from '../errors.js';
+function normalizeBaseUrl(value) {
+    const trimmed = value.trim().replace(/\/+$/, '');
+    if (!trimmed)
+        throw new Error('Hermes API base URL is required');
+    return trimmed;
+}
+function encodePath(value) {
+    return encodeURIComponent(value);
+}
+async function responseError(response, method, url) {
+    const responseText = await response.text();
+    let detail = response.statusText || 'Hermes API request failed';
+    try {
+        const payload = JSON.parse(responseText);
+        const envelope = payload.error;
+        if (envelope && typeof envelope === 'object' && !Array.isArray(envelope)) {
+            const message = envelope.message;
+            if (typeof message === 'string' && message)
+                detail = message;
+        }
+        else if (typeof payload.detail === 'string' && payload.detail) {
+            detail = payload.detail;
+        }
+    }
+    catch {
+        if (responseText)
+            detail = responseText;
+    }
+    return new APIError(response.status, detail, method, url, responseText);
+}
+async function* parseSse(response) {
+    if (!response.body)
+        return;
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    const decodeBlock = (block) => {
+        let event = 'message';
+        let id;
+        let retry;
+        const dataLines = [];
+        for (const line of block.split('\n')) {
+            if (!line || line.startsWith(':'))
+                continue;
+            const separator = line.indexOf(':');
+            const field = separator < 0 ? line : line.slice(0, separator);
+            let value = separator < 0 ? '' : line.slice(separator + 1);
+            if (value.startsWith(' '))
+                value = value.slice(1);
+            if (field === 'event')
+                event = value || 'message';
+            else if (field === 'data')
+                dataLines.push(value);
+            else if (field === 'id')
+                id = value;
+            else if (field === 'retry' && /^\d+$/.test(value))
+                retry = Number(value);
+        }
+        if (dataLines.length === 0)
+            return null;
+        const rawData = dataLines.join('\n');
+        let data = rawData;
+        try {
+            data = JSON.parse(rawData);
+        }
+        catch {
+            // Non-JSON and future event payloads are valid SSE; preserve verbatim.
+        }
+        return { event, data, rawData, ...(id === undefined ? {} : { id }), ...(retry === undefined ? {} : { retry }) };
+    };
+    try {
+        while (true) {
+            const { value, done } = await reader.read();
+            buffer += decoder.decode(value, { stream: !done }).replace(/\r\n?/g, '\n');
+            let boundary;
+            while ((boundary = buffer.indexOf('\n\n')) >= 0) {
+                const block = buffer.slice(0, boundary);
+                buffer = buffer.slice(boundary + 2);
+                const parsed = decodeBlock(block);
+                if (parsed)
+                    yield parsed;
+            }
+            if (done)
+                break;
+        }
+        const parsed = decodeBlock(buffer);
+        if (parsed)
+            yield parsed;
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+export class HermesApiClient {
+    baseUrl;
+    openaiBaseUrl;
+    apiKey;
+    fetchImpl;
+    defaultHeaders;
+    constructor(baseUrl, options = {}) {
+        this.baseUrl = normalizeBaseUrl(baseUrl);
+        this.openaiBaseUrl = `${this.baseUrl}/v1`;
+        this.apiKey = options.apiKey?.trim() || null;
+        this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.defaultHeaders = new Headers(options.headers);
+    }
+    async request(method, path, body) {
+        const response = await this.requestRaw(method, path, body);
+        if (response.status === 204)
+            return undefined;
+        return response.json();
+    }
+    async requestRaw(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = new Headers(this.defaultHeaders);
+        if (this.apiKey)
+            headers.set('Authorization', `Bearer ${this.apiKey}`);
+        if (body !== undefined)
+            headers.set('Content-Type', 'application/json');
+        const response = await this.fetchImpl(url, {
+            method,
+            headers,
+            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+        });
+        if (!response.ok)
+            throw await responseError(response, method, url);
+        return response;
+    }
+    health() {
+        return this.request('GET', '/health');
+    }
+    healthDetailed() {
+        return this.request('GET', '/health/detailed');
+    }
+    capabilities() {
+        return this.request('GET', '/v1/capabilities');
+    }
+    models() {
+        return this.request('GET', '/v1/models');
+    }
+    listSessions(options = {}) {
+        const query = new URLSearchParams();
+        if (options.limit !== undefined)
+            query.set('limit', String(options.limit));
+        if (options.offset !== undefined)
+            query.set('offset', String(options.offset));
+        if (options.source)
+            query.set('source', options.source);
+        if (options.includeChildren !== undefined)
+            query.set('include_children', String(options.includeChildren));
+        const suffix = query.size ? `?${query}` : '';
+        return this.request('GET', `/api/sessions${suffix}`);
+    }
+    createSession(request = {}) {
+        return this.request('POST', '/api/sessions', request);
+    }
+    getSession(sessionId) {
+        return this.request('GET', `/api/sessions/${encodePath(sessionId)}`);
+    }
+    updateSession(sessionId, request) {
+        return this.request('PATCH', `/api/sessions/${encodePath(sessionId)}`, request);
+    }
+    deleteSession(sessionId) {
+        return this.request('DELETE', `/api/sessions/${encodePath(sessionId)}`);
+    }
+    sessionMessages(sessionId) {
+        return this.request('GET', `/api/sessions/${encodePath(sessionId)}/messages`);
+    }
+    forkSession(sessionId, request = {}) {
+        return this.request('POST', `/api/sessions/${encodePath(sessionId)}/fork`, request);
+    }
+    chatSession(sessionId, request) {
+        return this.request('POST', `/api/sessions/${encodePath(sessionId)}/chat`, request);
+    }
+    async *streamSessionChat(sessionId, request) {
+        const response = await this.requestRaw('POST', `/api/sessions/${encodePath(sessionId)}/chat/stream`, request);
+        yield* parseSse(response);
+    }
+    lockSessionModel(sessionId, request) {
+        return this.request('POST', `/api/sessions/${encodePath(sessionId)}/model`, request);
+    }
+    createRun(request) {
+        return this.request('POST', '/v1/runs', request);
+    }
+    getRun(runId) {
+        return this.request('GET', `/v1/runs/${encodePath(runId)}`);
+    }
+    async *runEvents(runId) {
+        const response = await this.requestRaw('GET', `/v1/runs/${encodePath(runId)}/events`);
+        yield* parseSse(response);
+    }
+    approveRun(runId, request) {
+        return this.request('POST', `/v1/runs/${encodePath(runId)}/approval`, {
+            choice: request.choice,
+            ...(request.resolveAll === undefined ? {} : { resolve_all: request.resolveAll }),
+        });
+    }
+    stopRun(runId) {
+        return this.request('POST', `/v1/runs/${encodePath(runId)}/stop`, {});
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/hermes/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/hermes/gateway.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -1,3 +1,7 @@
+/**
+ * HTTP client utilities with retry logic
+ */
+import { APIError } from './errors.js';
 export interface RequestOptions {
     method: string;
     url: string;
@@ -7,11 +11,16 @@ export interface RequestOptions {
     retries?: number;
     backoff?: number;
     timeout?: number;
+    signal?: AbortSignal;
+    retryStatuses?: readonly number[];
+    rawBody?: boolean;
 }
+export type RequestOverrides = Pick<RequestOptions, 'retries' | 'backoff' | 'timeout' | 'signal' | 'retryStatuses'>;
 /**
  * Make an HTTP request with retry logic for transient errors
  */
 export declare function requestWithRetry(options: RequestOptions): Promise<Response>;
+export declare function responseAPIError(response: Response, method?: string, requestUrl?: string): Promise<APIError>;
 /**
  * HTTP Client for making authenticated requests to the API
  */
@@ -20,12 +29,16 @@ export declare class HTTPClient {
     private apiKey;
     private timeout;
     constructor(baseUrl: string, apiKey: string, timeout?: number);
+    get base(): string;
+    get credential(): string;
     private get headers();
-    get<T = any>(path: string, params?: Record<string, string | number | Array<string | number>>): Promise<T>;
+    get<T = any>(path: string, params?: Record<string, string | number | Array<string | number>>, options?: RequestOverrides): Promise<T>;
     getWithHeaders<T = any>(path: string, params?: Record<string, string | number | Array<string | number>>, headers?: Record<string, string>): Promise<T>;
-    post<T = any>(path: string, body?: any): Promise<T>;
-    postBytes(path: string, body?: any): Promise<Uint8Array>;
+    post<T = any>(path: string, body?: any, options?: RequestOverrides): Promise<T>;
+    postBytes(path: string, body?: any, options?: RequestOverrides): Promise<Uint8Array>;
+    postRaw<T = any>(path: string, body: any, contentType: string, options?: RequestOverrides): Promise<T>;
     patch<T = any>(path: string, body?: any): Promise<T>;
+    put<T = any>(path: string, body?: any): Promise<T>;
     delete<T = any>(path: string): Promise<T>;
     /**
      * POST with multipart form data for file uploads

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwEjF;AAuCD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc;IAMpE,OAAO,KAAK,OAAO,GAKlB;IAEK,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAWzG,cAAc,CAAC,CAAC,GAAG,GAAG,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,EACjE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAWP,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAWnD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAWxD,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAWpD,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAU/C;;OAEG;IACG,aAAa,CAAC,CAAC,GAAG,GAAG,EACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,EACjF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC;IAkCb;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC;CA6CpE"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}