@hypercli.com/sdk 0.9.1

package/dist/memory.d.ts

@@ -0,0 +1,87 @@
+/** Durable session memory, relative to the agents API base.
+ * Wire contract: agents/backend/agents/memory_routes.py. Public fields use camelCase.
+ */
+import type { HTTPClient, RequestOverrides } from './http.js';
+export interface MemorySummary {
+    sessionId: string;
+    title: string | null;
+    summaryText: string | null;
+    /** Last sequence covered by indexed chunks; zero is a valid cursor. */
+    summaryCursor: number | null;
+    summarizedAt: string | null;
+    importedAt: string | null;
+    summaryState: string | null;
+    summaryFailureReason: string | null;
+    pending: boolean;
+}
+export interface MemoryChunk {
+    id: string;
+    sessionId: string;
+    seqStart: number;
+    seqEnd: number;
+    text: string;
+}
+export interface MemorySearchResult extends MemoryChunk {
+    agentId: string | null;
+    score: number;
+    /** Joined from the owning session; null when unset or on pre-envelope deployments. */
+    title: string | null;
+    summaryText: string | null;
+    /** Owning session's summary keywords; empty on pre-envelope deployments. */
+    summaryKeywords: string[];
+}
+export interface MemorySearchResponse {
+    items: MemorySearchResult[];
+    /** Opaque keyset cursor over {distance, id} pairs; null when the page is exhausted. */
+    nextCursor: string | null;
+    /** LIMIT N+1 sentinel; false on pre-envelope deployments (single terminal page). */
+    hasMore: boolean;
+}
+export interface MemoryChunkPage {
+    items: MemoryChunk[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+export interface MemoryTailMessage {
+    seqStart: number;
+    seqEnd: number;
+    role: string;
+    text: string;
+    participantId: string | null;
+}
+export interface MemoryTail {
+    sessionId: string;
+    items: MemoryTailMessage[];
+}
+export interface MemoryRebuildResponse {
+    sessionId: string;
+    /** The server currently returns "pending" (HTTP 202), not a completed summary. */
+    status: string;
+}
+export interface MemorySearchOptions {
+    sessionId?: string;
+    /** Restrict to sessions of one agent (UUID). */
+    agentId?: string;
+    /** Opaque cursor from a previous page's nextCursor; omitted starts at the best matches. */
+    cursor?: string | null;
+    limit?: number;
+}
+export interface MemoryChunksOptions {
+    /** Opaque cursor from a previous chunk page. */
+    cursor?: string | null;
+    limit?: number;
+}
+export declare class MemoryAPI {
+    private readonly http;
+    constructor(http: Pick<HTTPClient, 'get' | 'post'>);
+    /** Best-first page over indexed chunks; feed nextCursor back via options.cursor. */
+    search(query: string, options?: MemorySearchOptions, request?: RequestOverrides): Promise<MemorySearchResponse>;
+    getSummary(sessionId: string): Promise<MemorySummary>;
+    /** Indexed chunks in ascending sequence order. */
+    getChunks(sessionId: string, options?: MemoryChunksOptions): Promise<MemoryChunkPage>;
+    /** Latest logical text messages in chronological order, not raw event frames. */
+    getTail(sessionId: string, n?: number): Promise<MemoryTail>;
+    /** User rebuild; the server enforces the once-per-24-hours limit. Never retry an uncertain write. */
+    rebuild(sessionId: string): Promise<MemoryRebuildResponse>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

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

package/dist/memory.js

@@ -0,0 +1,79 @@
+function summaryFromWire(row) {
+    return {
+        sessionId: row.session_id,
+        title: row.title,
+        summaryText: row.summary_text,
+        summaryCursor: row.summary_cursor,
+        summarizedAt: row.summarized_at,
+        importedAt: row.imported_at,
+        summaryState: row.summary_state ?? null,
+        summaryFailureReason: row.summary_failure_reason ?? null,
+        pending: row.pending,
+    };
+}
+function chunkFromWire(row) {
+    return {
+        id: row.id, sessionId: row.session_id, seqStart: row.seq_start,
+        seqEnd: row.seq_end, text: row.text,
+    };
+}
+function searchHitFromWire(row) {
+    return {
+        ...chunkFromWire(row), score: row.score,
+        agentId: row.agent_id ?? null,
+        title: row.title ?? null,
+        summaryText: row.summary_text ?? null,
+        summaryKeywords: Array.isArray(row.summary_keywords) ? row.summary_keywords.map(String) : [],
+    };
+}
+function searchPageFromWire(payload) {
+    // Rollout tolerance: pre-envelope deployments answer a bare array or { items }
+    // without pagination keys; both decode to a single terminal page.
+    const envelope = (Array.isArray(payload) ? { items: payload } : payload ?? {});
+    return {
+        items: (Array.isArray(envelope.items) ? envelope.items : []).map(searchHitFromWire),
+        nextCursor: envelope.next_cursor ?? null,
+        hasMore: envelope.has_more === true,
+    };
+}
+export class MemoryAPI {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Best-first page over indexed chunks; feed nextCursor back via options.cursor. */
+    async search(query, options = {}, request = {}) {
+        const payload = await this.http.get('/memory/search', {
+            q: query,
+            ...(options.sessionId !== undefined ? { session_id: options.sessionId } : {}),
+            ...(options.agentId !== undefined ? { agent_id: options.agentId } : {}),
+            ...(options.cursor ? { cursor: options.cursor } : {}),
+            ...(options.limit !== undefined ? { limit: options.limit } : {}),
+        }, request);
+        return searchPageFromWire(payload);
+    }
+    async getSummary(sessionId) {
+        return summaryFromWire(await this.http.get(`/sessions/${encodeURIComponent(sessionId)}/summary`));
+    }
+    /** Indexed chunks in ascending sequence order. */
+    async getChunks(sessionId, options = {}) {
+        const payload = await this.http.get(`/sessions/${encodeURIComponent(sessionId)}/chunks`, {
+            ...(options.cursor != null ? { cursor: options.cursor } : {}),
+            ...(options.limit !== undefined ? { limit: options.limit } : {}),
+        });
+        return { items: payload.items.map(chunkFromWire), nextCursor: payload.next_cursor, hasMore: payload.has_more };
+    }
+    /** Latest logical text messages in chronological order, not raw event frames. */
+    async getTail(sessionId, n = 20) {
+        const payload = await this.http.get(`/sessions/${encodeURIComponent(sessionId)}/tail`, { n });
+        return { sessionId: payload.session_id, items: payload.items.map((row) => ({
+                seqStart: row.seq_start, seqEnd: row.seq_end, role: row.role, text: row.text, participantId: row.participant_id,
+            })) };
+    }
+    /** User rebuild; the server enforces the once-per-24-hours limit. Never retry an uncertain write. */
+    async rebuild(sessionId) {
+        const payload = await this.http.post(`/sessions/${encodeURIComponent(sessionId)}/summary/rebuild`, undefined, { retries: 1 });
+        return { sessionId: payload.session_id, status: payload.status };
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,15 @@
+/**
+ * OpenAI-compatible models API
+ */
+import type { HTTPClient } from './http.js';
+export interface Model {
+    id: string;
+    object: string;
+    ownedBy: string | null;
+}
+export declare class ModelsAPI {
+    private http;
+    constructor(http: HTTPClient);
+    list(): Promise<Model[]>;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAUD,qBAAa,SAAS;IACR,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE9B,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CAK/B"}

package/dist/models.js

@@ -0,0 +1,19 @@
+function modelFromDict(data) {
+    return {
+        id: data?.id || '',
+        object: data?.object || 'model',
+        ownedBy: data?.owned_by || null,
+    };
+}
+export class ModelsAPI {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async list() {
+        const payload = await this.http.get('/v1/models');
+        const data = Array.isArray(payload?.data) ? payload.data : Array.isArray(payload) ? payload : [];
+        return data.map(modelFromDict);
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAWA,SAAS,aAAa,CAAC,IAAS;IAC9B,OAAO;QACL,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE;QAClB,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,OAAO;QAC/B,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,SAAS;IACA;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC,KAAK,CAAC,IAAI;QACR,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/openclaw-control-ui-origin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * OpenClaw control-UI allowed-origin helpers.
+ *
+ * An OpenClaw agent records the browser origins allowed to drive its control
+ * UI in the `OPENCLAW_CONTROL_UI_ALLOWED_ORIGIN` launch env. With current
+ * OpenClaw that env is a full replace for `gateway.controlUi.allowedOrigins`,
+ * parsed comma-separated, and `'*'` is a wildcard covering every origin. The
+ * SDK unconditionally writes `'*'` at create; these helpers exist only for
+ * read-side consumers (desktop, console) that parse and display a stored
+ * allow-list.
+ *
+ * Stored values predate a single canonical writer, so values also exist
+ * space-separated or as JSON arrays; all shapes parse.
+ */
+/** The allow-anything value written when no explicit list was supplied. */
+/**
+ * Parse every stored shape of the allow-list into a trimmed, deduplicated
+ * list. Accepts space- or comma-separated strings, JSON arrays, and raw
+ * string arrays. Entries are passed through as-is; only empties drop. A
+ * `'*'` anywhere collapses the list to `['*']`.
+ */
+export declare function parseControlUiAllowedOrigins(value: unknown): string[];
+//# sourceMappingURL=openclaw-control-ui-origin.d.ts.map

package/dist/openclaw-control-ui-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-control-ui-origin.d.ts","sourceRoot":"","sources":["../src/openclaw-control-ui-origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,2EAA2E;AAC3E;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAyBrE"}

package/dist/openclaw-control-ui-origin.js

@@ -0,0 +1,53 @@
+/**
+ * OpenClaw control-UI allowed-origin helpers.
+ *
+ * An OpenClaw agent records the browser origins allowed to drive its control
+ * UI in the `OPENCLAW_CONTROL_UI_ALLOWED_ORIGIN` launch env. With current
+ * OpenClaw that env is a full replace for `gateway.controlUi.allowedOrigins`,
+ * parsed comma-separated, and `'*'` is a wildcard covering every origin. The
+ * SDK unconditionally writes `'*'` at create; these helpers exist only for
+ * read-side consumers (desktop, console) that parse and display a stored
+ * allow-list.
+ *
+ * Stored values predate a single canonical writer, so values also exist
+ * space-separated or as JSON arrays; all shapes parse.
+ */
+/** The allow-anything value written when no explicit list was supplied. */
+/**
+ * Parse every stored shape of the allow-list into a trimmed, deduplicated
+ * list. Accepts space- or comma-separated strings, JSON arrays, and raw
+ * string arrays. Entries are passed through as-is; only empties drop. A
+ * `'*'` anywhere collapses the list to `['*']`.
+ */
+export function parseControlUiAllowedOrigins(value) {
+    let values;
+    if (Array.isArray(value)) {
+        values = value;
+    }
+    else if (typeof value === 'string') {
+        const candidate = value.trim();
+        if (!candidate)
+            return [];
+        if (candidate.startsWith('[')) {
+            try {
+                const parsed = JSON.parse(candidate);
+                return Array.isArray(parsed) ? parseControlUiAllowedOrigins(parsed) : [];
+            }
+            catch {
+                return [];
+            }
+        }
+        values = candidate.split(/[,\s]+/);
+    }
+    else {
+        return [];
+    }
+    const origins = values
+        .filter((entry) => typeof entry === 'string')
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    if (origins.includes('*'))
+        return ['*'];
+    return Array.from(new Set(origins));
+}
+//# sourceMappingURL=openclaw-control-ui-origin.js.map

package/dist/openclaw-control-ui-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-control-ui-origin.js","sourceRoot":"","sources":["../src/openclaw-control-ui-origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,2EAA2E;AAC3E;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,IAAI,MAAiB,CAAC;IACtB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM;SACnB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;SAC7D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/renders.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Renders API - managed AI rendering workflows
+ */
+import type { HTTPClient } from './http.js';
+export interface Render {
+    renderId: string;
+    state: string;
+    template: string | null;
+    renderType: string | null;
+    tags: string[] | null;
+    resultUrl: string | null;
+    error: string | null;
+    createdAt: number | null;
+    startedAt: number | null;
+    completedAt: number | null;
+}
+export interface RenderStatus {
+    renderId: string;
+    state: string;
+    progress: number | null;
+}
+export declare class Renders {
+    private http;
+    private authHttp;
+    static readonly DEFAULT_WAIT_TIMEOUT = 3600000;
+    static readonly DEFAULT_QUEUE_GRACE = 1800000;
+    static readonly DEFAULT_ACTIVE_GRACE = 300000;
+    private authMeCache;
+    constructor(http: HTTPClient, authHttp?: HTTPClient);
+    private authMe;
+    private supportsSubscriptionFamily;
+    private postFlow;
+    private getRender;
+    private deleteRender;
+    /**
+     * List all renders
+     */
+    list(options?: {
+        state?: string;
+        template?: string;
+        type?: string;
+        tags?: string[];
+    }): Promise<Render[]>;
+    /**
+     * Get render details
+     */
+    get(renderId: string): Promise<Render>;
+    /**
+     * Create a new render
+     */
+    create(params: Record<string, any>, renderType?: string, notifyUrl?: string, tags?: string[]): Promise<Render>;
+    /**
+     * Cancel a render
+     */
+    cancel(renderId: string): Promise<any>;
+    /**
+     * Get render status (lightweight polling endpoint)
+     */
+    status(renderId: string): Promise<RenderStatus>;
+    wait(renderId: string, options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        queueGraceMs?: number;
+        activeGraceMs?: number;
+    }): Promise<Render>;
+    private parseRenderTimestamp;
+    flow(flowType: string, params: Record<string, any>): Promise<Render>;
+    /**
+     * Generate an image using Qwen-Image
+     */
+    textToImage(options: {
+        prompt: string;
+        negative?: string;
+        width?: number;
+        height?: number;
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Generate an image using HiDream I1 Full
+     */
+    textToImageHidream(options: {
+        prompt: string;
+        negative?: string;
+        width?: number;
+        height?: number;
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Generate a video using Wan 2.2 14B
+     */
+    textToVideo(options: {
+        prompt: string;
+        negative?: string;
+        width?: number;
+        height?: number;
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Animate an image using Wan 2.2 Animate
+     */
+    imageToVideo(options: {
+        prompt: string;
+        imageUrl?: string;
+        fileIds?: string[];
+        negative?: string;
+        width?: number;
+        height?: number;
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Generate a lip-sync video using HuMo
+     */
+    speakingVideo(options: {
+        prompt: string;
+        imageUrl?: string;
+        audioUrl?: string;
+        fileIds?: string[];
+        negative?: string;
+        length?: number;
+        width?: number;
+        height?: number;
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Generate an audio-driven video using Wan 2.2 S2V
+     */
+    speakingVideoWan(options: {
+        prompt: string;
+        imageUrl: string;
+        audioUrl: string;
+        negative?: string;
+        width?: number;
+        height?: number;
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Transform images using Qwen Image Edit
+     */
+    imageToImage(options: {
+        prompt: string;
+        imageUrls?: string[];
+        fileIds?: string[];
+        negative?: string;
+        width?: number;
+        height?: number;
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Generate video morphing between two images using Wan 2.2
+     */
+    firstLastFrameVideo(options: {
+        prompt: string;
+        startImageUrl?: string;
+        endImageUrl?: string;
+        fileIds?: string[];
+        negative?: string;
+        width?: number;
+        height?: number;
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Transcribe audio/video to text using WhisperX
+     */
+    audioToText(options: {
+        audioUrl?: string;
+        fileIds?: string[];
+        notifyUrl?: string;
+    }): Promise<Render>;
+    /**
+     * Generate speech from text using Qwen3-TTS
+     */
+    textToSpeech(options: {
+        text: string;
+        mode?: string;
+        language?: string;
+        speaker?: string;
+        style?: string;
+        modelSize?: string;
+        voiceDescription?: string;
+        refAudioUrl?: string;
+        fileIds?: string[];
+        refText?: string;
+        useXvectorOnly?: boolean;
+        notifyUrl?: string;
+    }): Promise<Render>;
+}
+//# sourceMappingURL=renders.d.ts.map

package/dist/renders.d.ts.map

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