@hypercli.com/sdk 0.9.1

package/dist/renders.js

@@ -0,0 +1,360 @@
+import { APIError } from './errors.js';
+function renderFromDict(data) {
+    return {
+        renderId: data.id || data.render_id || '',
+        state: data.state || '',
+        template: data.template || data.meta?.template || null,
+        renderType: data.type || data.render_type || null,
+        tags: Array.isArray(data.tags) ? data.tags : null,
+        resultUrl: data.result_url || null,
+        error: data.error || null,
+        createdAt: data.created_at || null,
+        startedAt: data.started_at || null,
+        completedAt: data.completed_at || null,
+    };
+}
+function renderStatusFromDict(data) {
+    return {
+        renderId: data.id || data.render_id || '',
+        state: data.state || '',
+        progress: data.progress ?? null,
+    };
+}
+export class Renders {
+    http;
+    authHttp;
+    static DEFAULT_WAIT_TIMEOUT = 3600_000;
+    static DEFAULT_QUEUE_GRACE = 1800_000;
+    static DEFAULT_ACTIVE_GRACE = 300_000;
+    authMeCache = null;
+    constructor(http, authHttp = http) {
+        this.http = http;
+        this.authHttp = authHttp;
+    }
+    async authMe() {
+        if (this.authMeCache === null || this.authMeCache === undefined) {
+            this.authMeCache = await this.authHttp.get('/api/auth/me');
+        }
+        return this.authMeCache;
+    }
+    async supportsSubscriptionFamily(family, resource) {
+        try {
+            const authMe = await this.authMe();
+            const capabilities = new Set(Array.isArray(authMe.capabilities) ? authMe.capabilities : []);
+            if (capabilities.has(`${family}:*`)) {
+                return true;
+            }
+            if (resource && capabilities.has(`${family}:${resource}`)) {
+                return true;
+            }
+            if (!authMe?.has_active_subscription) {
+                return false;
+            }
+            return authMe.auth_type === 'user';
+        }
+        catch (error) {
+            if (error instanceof APIError) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async postFlow(flowType, payload) {
+        const primary = (await this.supportsSubscriptionFamily('flows', flowType))
+            ? `/agents/flow/${flowType}`
+            : `/api/flow/${flowType}`;
+        try {
+            return await this.http.post(primary, payload);
+        }
+        catch (error) {
+            if (primary.startsWith('/agents/flow/') && error instanceof APIError && (error.statusCode === 403 || error.statusCode === 404)) {
+                return await this.http.post(`/api/flow/${flowType}`, payload);
+            }
+            throw error;
+        }
+    }
+    async getRender(renderId, status = false) {
+        const suffix = status ? '/status' : '';
+        const primary = (await this.supportsSubscriptionFamily('flows'))
+            ? `/agents/flow/renders/${renderId}${suffix}`
+            : `/api/flow/renders/${renderId}${suffix}`;
+        try {
+            return await this.http.get(primary);
+        }
+        catch (error) {
+            if (primary.startsWith('/agents/flow/') && error instanceof APIError && (error.statusCode === 403 || error.statusCode === 404)) {
+                return await this.http.get(`/api/flow/renders/${renderId}${suffix}`);
+            }
+            throw error;
+        }
+    }
+    async deleteRender(renderId) {
+        const primary = (await this.supportsSubscriptionFamily('flows'))
+            ? `/agents/flow/renders/${renderId}`
+            : `/api/flow/renders/${renderId}`;
+        try {
+            return await this.http.delete(primary);
+        }
+        catch (error) {
+            if (primary.startsWith('/agents/flow/') && error instanceof APIError && (error.statusCode === 403 || error.statusCode === 404)) {
+                return await this.http.delete(`/api/flow/renders/${renderId}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * List all renders
+     */
+    async list(options) {
+        const params = {};
+        if (options?.state)
+            params.state = options.state;
+        if (options?.template)
+            params.template = options.template;
+        if (options?.type)
+            params.type = options.type;
+        if (options?.tags?.length) {
+            params.tag = [...options.tags];
+        }
+        const data = await this.http.get('/api/renders', params);
+        const items = typeof data === 'object' && data.items ? data.items : data;
+        return (items || []).map(renderFromDict);
+    }
+    /**
+     * Get render details
+     */
+    async get(renderId) {
+        const data = await this.getRender(renderId);
+        return renderFromDict(data);
+    }
+    /**
+     * Create a new render
+     */
+    async create(params, renderType = 'comfyui', notifyUrl, tags) {
+        const payload = {
+            type: renderType,
+            params,
+        };
+        if (notifyUrl) {
+            payload.notify_url = notifyUrl;
+        }
+        if (tags?.length) {
+            payload.tags = [...tags];
+        }
+        const data = await this.http.post('/api/renders', payload);
+        return renderFromDict(data);
+    }
+    /**
+     * Cancel a render
+     */
+    async cancel(renderId) {
+        return await this.deleteRender(renderId);
+    }
+    /**
+     * Get render status (lightweight polling endpoint)
+     */
+    async status(renderId) {
+        const data = await this.getRender(renderId, true);
+        return renderStatusFromDict(data);
+    }
+    async wait(renderId, options) {
+        const timeoutMs = options?.timeoutMs ?? Renders.DEFAULT_WAIT_TIMEOUT;
+        const pollIntervalMs = options?.pollIntervalMs ?? 5000;
+        const queueGraceMs = options?.queueGraceMs ?? Renders.DEFAULT_QUEUE_GRACE;
+        const activeGraceMs = options?.activeGraceMs ?? Renders.DEFAULT_ACTIVE_GRACE;
+        let deadline = Date.now() + timeoutMs;
+        let queueGraceUsed = false;
+        let activeGraceUsed = false;
+        let lastRender = null;
+        while (true) {
+            const render = await this.get(renderId);
+            lastRender = render;
+            const state = (render.state || '').toLowerCase();
+            if (state === 'completed' || state === 'failed' || state === 'cancelled') {
+                return render;
+            }
+            const now = Date.now();
+            if (now >= deadline) {
+                const startedAt = this.parseRenderTimestamp(render.startedAt);
+                if (!queueGraceUsed && (startedAt === null || startedAt === undefined)) {
+                    queueGraceUsed = true;
+                    deadline = now + queueGraceMs;
+                }
+                else if (!activeGraceUsed && startedAt !== null && startedAt !== undefined) {
+                    activeGraceUsed = true;
+                    deadline = Math.max(deadline, startedAt + activeGraceMs);
+                }
+                else {
+                    throw new Error(`Render ${renderId} did not complete within ${(timeoutMs / 1000).toFixed(0)}s ` +
+                        `(+${(queueGraceMs / 1000).toFixed(0)}s queue grace, +${(activeGraceMs / 1000).toFixed(0)}s active grace); ` +
+                        `lastRender=${JSON.stringify(lastRender)}`);
+                }
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+    }
+    // =========================================================================
+    // Flow endpoints - simplified interfaces
+    // =========================================================================
+    parseRenderTimestamp(value) {
+        if (value === null || value === undefined)
+            return null;
+        if (typeof value === 'number')
+            return value;
+        if (typeof value === 'string') {
+            const parsed = Date.parse(value);
+            return Number.isNaN(parsed) ? null : parsed;
+        }
+        return null;
+    }
+    async flow(flowType, params) {
+        // Filter out null/undefined values
+        const payload = {};
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== null && value !== undefined) {
+                payload[key] = value;
+            }
+        }
+        const data = await this.postFlow(flowType, payload);
+        return renderFromDict(data);
+    }
+    /**
+     * Generate an image using Qwen-Image
+     */
+    async textToImage(options) {
+        return this.flow('text-to-image', {
+            prompt: options.prompt,
+            negative: options.negative,
+            width: options.width,
+            height: options.height,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Generate an image using HiDream I1 Full
+     */
+    async textToImageHidream(options) {
+        return this.flow('text-to-image-hidream', {
+            prompt: options.prompt,
+            negative: options.negative,
+            width: options.width,
+            height: options.height,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Generate a video using Wan 2.2 14B
+     */
+    async textToVideo(options) {
+        return this.flow('text-to-video', {
+            prompt: options.prompt,
+            negative: options.negative,
+            width: options.width,
+            height: options.height,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Animate an image using Wan 2.2 Animate
+     */
+    async imageToVideo(options) {
+        return this.flow('image-to-video', {
+            prompt: options.prompt,
+            image_url: options.imageUrl,
+            file_ids: options.fileIds,
+            negative: options.negative,
+            width: options.width,
+            height: options.height,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Generate a lip-sync video using HuMo
+     */
+    async speakingVideo(options) {
+        return this.flow('speaking-video', {
+            prompt: options.prompt,
+            image_url: options.imageUrl,
+            audio_url: options.audioUrl,
+            file_ids: options.fileIds,
+            negative: options.negative,
+            length: options.length,
+            width: options.width,
+            height: options.height,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Generate an audio-driven video using Wan 2.2 S2V
+     */
+    async speakingVideoWan(options) {
+        return this.flow('speaking-video-wan', {
+            prompt: options.prompt,
+            image_url: options.imageUrl,
+            audio_url: options.audioUrl,
+            negative: options.negative,
+            width: options.width,
+            height: options.height,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Transform images using Qwen Image Edit
+     */
+    async imageToImage(options) {
+        return this.flow('image-to-image', {
+            prompt: options.prompt,
+            image_urls: options.imageUrls,
+            file_ids: options.fileIds,
+            negative: options.negative,
+            width: options.width,
+            height: options.height,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Generate video morphing between two images using Wan 2.2
+     */
+    async firstLastFrameVideo(options) {
+        return this.flow('first-last-frame-video', {
+            prompt: options.prompt,
+            start_image_url: options.startImageUrl,
+            end_image_url: options.endImageUrl,
+            file_ids: options.fileIds,
+            negative: options.negative,
+            width: options.width,
+            height: options.height,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Transcribe audio/video to text using WhisperX
+     */
+    async audioToText(options) {
+        return this.flow('audio-to-text', {
+            audio_url: options.audioUrl,
+            file_ids: options.fileIds,
+            notify_url: options.notifyUrl,
+        });
+    }
+    /**
+     * Generate speech from text using Qwen3-TTS
+     */
+    async textToSpeech(options) {
+        return this.flow('text-to-speech', {
+            text: options.text,
+            mode: options.mode,
+            language: options.language,
+            speaker: options.speaker,
+            style: options.style,
+            model_size: options.modelSize,
+            voice_description: options.voiceDescription,
+            ref_audio_url: options.refAudioUrl,
+            file_ids: options.fileIds,
+            ref_text: options.refText,
+            use_xvector_only: options.useXvectorOnly,
+            notify_url: options.notifyUrl,
+        });
+    }
+}
+//# sourceMappingURL=renders.js.map

package/dist/renders.js.map

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

package/dist/routines.d.ts

@@ -0,0 +1,59 @@
+export declare function deriveRoutinesApiBase(agentsApiBase?: string): string;
+export interface Routine {
+    id: string;
+    userId: string;
+    agentId: string;
+    cron: string | null;
+    prompt: string;
+    enabled: boolean;
+    name: string | null;
+    runAt: string | null;
+    /** Bound ACP session the routine resumes; null starts a new session per run. */
+    sessionId: string | null;
+    nextRunAt: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface RoutineCreateOptions {
+    agentId: string;
+    prompt: string;
+    cron?: string;
+    runAt?: string;
+    name?: string;
+    /** Bind the routine to an existing ACP session; omitted runs a fresh session. */
+    sessionId?: string;
+    enabled?: boolean;
+}
+export interface RoutineUpdateOptions {
+    agentId?: string;
+    /** Empty string clears the schedule field server-side (sent as JSON null). */
+    cron?: string;
+    /** Empty string clears the schedule field server-side (sent as JSON null). */
+    runAt?: string;
+    prompt?: string;
+    enabled?: boolean;
+    /** Empty string clears the name server-side (sent as JSON null). */
+    name?: string;
+    /** Empty string clears the session binding server-side (sent as JSON null). */
+    sessionId?: string;
+}
+export declare class RoutinesAPI {
+    private apiBase;
+    private apiKey;
+    private timeout;
+    constructor(apiKey: string, options?: {
+        apiBase?: string;
+        agentsApiBase?: string;
+        timeout?: number;
+    });
+    private headers;
+    private request;
+    list(options?: {
+        agentId?: string;
+    }): Promise<Routine[]>;
+    get(routineId: string): Promise<Routine>;
+    create(body: RoutineCreateOptions): Promise<Routine>;
+    update(routineId: string, body: RoutineUpdateOptions): Promise<Routine>;
+    delete(routineId: string): Promise<void>;
+}
+//# sourceMappingURL=routines.d.ts.map

package/dist/routines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routines.d.ts","sourceRoot":"","sources":["../src/routines.ts"],"names":[],"mappings":"AAMA,wBAAgB,qBAAqB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAWpE;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiCD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IASxG,OAAO,CAAC,OAAO;YAOD,OAAO;IAsBf,IAAI,CAAC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAU5D,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAYpD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAcvE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}

package/dist/routines.js

@@ -0,0 +1,135 @@
+/**
+ * Routines API - scheduled prompts for agents.
+ */
+import { requestWithRetry, responseAPIError } from './http.js';
+import { getAgentsApiBaseUrl } from './config.js';
+export function deriveRoutinesApiBase(agentsApiBase) {
+    const raw = (agentsApiBase || getAgentsApiBaseUrl()).replace(/\/$/, '');
+    const url = new URL(raw.includes('://') ? raw : `https://${raw}`);
+    let path = url.pathname.replace(/\/$/, '');
+    if (path.endsWith('/routines')) {
+        return `${url.protocol}//${url.host}${path}`;
+    }
+    if (path.endsWith('/agents')) {
+        path = path.slice(0, -'/agents'.length);
+    }
+    return `${url.protocol}//${url.host}${path}/routines`;
+}
+function routineFromDict(data) {
+    return {
+        id: String(data?.id || ''),
+        userId: String(data?.user_id || data?.userId || ''),
+        agentId: String(data?.agent_id || data?.agentId || ''),
+        cron: data?.cron ?? null,
+        prompt: data?.prompt || '',
+        enabled: Boolean(data?.enabled ?? false),
+        name: data?.name ?? null,
+        runAt: data?.run_at ?? data?.runAt ?? null,
+        sessionId: data?.session_id ?? data?.sessionId ?? null,
+        nextRunAt: data?.next_run_at ?? data?.nextRunAt ?? null,
+        createdAt: data?.created_at ?? data?.createdAt ?? null,
+        updatedAt: data?.updated_at ?? data?.updatedAt ?? null,
+    };
+}
+async function handleResponse(response, method) {
+    if (response.status >= 400) {
+        throw await responseAPIError(response, method);
+    }
+    if (response.status === 204 || response.status === 205)
+        return undefined;
+    const text = await response.text();
+    if (!text)
+        return undefined;
+    return JSON.parse(text);
+}
+function encodeRef(value) {
+    return encodeURIComponent(value);
+}
+export class RoutinesAPI {
+    apiBase;
+    apiKey;
+    timeout;
+    constructor(apiKey, options = {}) {
+        if (!apiKey) {
+            throw new Error('API key required for routines');
+        }
+        this.apiKey = apiKey;
+        this.apiBase = (options.apiBase || deriveRoutinesApiBase(options.agentsApiBase)).replace(/\/$/, '');
+        this.timeout = options.timeout ?? 30000;
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+        };
+    }
+    async request(method, path, body, params) {
+        let url = `${this.apiBase}${path}`;
+        if (params) {
+            const query = new URLSearchParams(params).toString();
+            if (query)
+                url = `${url}?${query}`;
+        }
+        const response = await requestWithRetry({
+            method,
+            url,
+            headers: this.headers(),
+            body,
+            retries: method === 'GET' ? 3 : 1,
+            timeout: this.timeout,
+        });
+        return handleResponse(response, method);
+    }
+    async list(options = {}) {
+        const params = options.agentId !== undefined ? { agent_id: options.agentId } : undefined;
+        const data = await this.request('GET', '', undefined, params);
+        const items = Array.isArray(data) ? data : Array.isArray(data?.routines) ? data.routines : null;
+        if (!items) {
+            throw new Error('Routines response must be an array.');
+        }
+        return items.map(routineFromDict);
+    }
+    async get(routineId) {
+        const data = await this.request('GET', `/${encodeRef(routineId)}`);
+        return routineFromDict(data);
+    }
+    async create(body) {
+        const payload = { agent_id: body.agentId };
+        if (body.cron !== undefined)
+            payload.cron = body.cron;
+        payload.prompt = body.prompt;
+        payload.enabled = body.enabled ?? true;
+        if (body.runAt !== undefined)
+            payload.run_at = body.runAt;
+        if (body.name !== undefined)
+            payload.name = body.name;
+        if (body.sessionId !== undefined)
+            payload.session_id = body.sessionId;
+        const data = await this.request('POST', '', payload);
+        return routineFromDict(data);
+    }
+    async update(routineId, body) {
+        const payload = {};
+        const nullable = (value) => (value.trim() === '' ? null : value);
+        if (body.agentId !== undefined)
+            payload.agent_id = body.agentId;
+        if (body.cron !== undefined)
+            payload.cron = nullable(body.cron);
+        if (body.runAt !== undefined)
+            payload.run_at = nullable(body.runAt);
+        if (body.prompt !== undefined)
+            payload.prompt = body.prompt;
+        if (body.enabled !== undefined)
+            payload.enabled = body.enabled;
+        if (body.name !== undefined)
+            payload.name = nullable(body.name);
+        if (body.sessionId !== undefined)
+            payload.session_id = nullable(body.sessionId);
+        const data = await this.request('PATCH', `/${encodeRef(routineId)}`, payload);
+        return routineFromDict(data);
+    }
+    async delete(routineId) {
+        await this.request('DELETE', `/${encodeRef(routineId)}`);
+    }
+}
+//# sourceMappingURL=routines.js.map

package/dist/routines.js.map

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

package/dist/runners.d.ts

@@ -0,0 +1,61 @@
+export declare function deriveRunnersApiBase(agentsApiBase?: string): string;
+/** User-writable cosmetic runner metadata exposed under meta.ui. */
+export interface RunnerUiMeta {
+    displayName?: string | null;
+}
+export interface RunnerMeta {
+    ui?: RunnerUiMeta | null;
+}
+export interface Runner {
+    runnerId: string;
+    ownerUserId: string;
+    name: string;
+    tags: string[];
+    platform: {
+        os: string;
+        arch: string;
+    };
+    version: string;
+    createdAt: string | null;
+    lastSeenAt: string | null;
+    disconnectedAt: string | null;
+    meta?: RunnerMeta | null;
+    /** Inventory-only fields; presence state is scoped to the responding backend instance. */
+    connected?: boolean;
+    ready?: boolean;
+    connectionScope?: string;
+}
+export interface RunnerUpdateOptions {
+    /** Merges into meta.ui server-side; null clears the field. */
+    ui?: {
+        displayName?: string | null;
+    };
+}
+export interface RunnerRegisterOptions {
+    runnerId?: string;
+    name: string;
+    tags?: string[];
+    version: string;
+    platform: {
+        os: string;
+        arch: string;
+    };
+}
+export declare class RunnersAPI {
+    private apiBase;
+    private apiKey;
+    private timeout;
+    constructor(apiKey: string, options?: {
+        apiBase?: string;
+        agentsApiBase?: string;
+        timeout?: number;
+    });
+    private headers;
+    private request;
+    list(): Promise<Runner[]>;
+    /** Omit runnerId to allocate an identity. Sent once; a lost reply is uncertain. */
+    register(body: RunnerRegisterOptions): Promise<Runner>;
+    get(runnerId: string): Promise<Runner>;
+    update(runnerId: string, body: RunnerUpdateOptions): Promise<Runner>;
+}
+//# sourceMappingURL=runners.d.ts.map

package/dist/runners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../src/runners.ts"],"names":[],"mappings":"AAMA,wBAAgB,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAQnE;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,EAAE,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAqDD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IASxG,OAAO,CAAC,OAAO;YAOD,OAAO;IAYf,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAS/B,mFAAmF;IAC7E,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;CAU3E"}