@awesomate/platform-sdk 0.1.0

package/dist/esm/client.js

@@ -0,0 +1,251 @@
+import { deadline, defaultFetch, enc, failureOf, queryString, resultOf, trimSlash, UNAVAILABLE, untilEnd } from "./http.js";
+import { answerEvents, collectAnswer } from "./sse.js";
+const KEY_RE = /^amk_([qpiasu])_[0-9A-Za-z]{40}$/;
+/** Class of a platform key, or null when the string is not a well-formed key. */
+export function keyClass(key) {
+    const m = KEY_RE.exec(key);
+    return m ? m[1] : null;
+}
+/**
+ * Client for the tenant API (`/v1/*`). One instance = one key = one tenant; the platform
+ * scopes every call server-side. Never throws on the request path — see PlatformResult.
+ */
+export class PlatformClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    answerTimeoutMs;
+    uploadTimeoutMs;
+    fetchImpl;
+    constructor(config) {
+        this.baseUrl = trimSlash(config.baseUrl ?? "");
+        this.apiKey = config.apiKey ?? "";
+        this.timeoutMs = config.timeoutMs ?? 10_000;
+        this.answerTimeoutMs = config.answerTimeoutMs ?? 5 * 60_000;
+        this.uploadTimeoutMs = config.uploadTimeoutMs ?? 10 * 60_000;
+        this.fetchImpl = config.fetchImpl ?? defaultFetch();
+    }
+    isConfigured() {
+        return Boolean(this.baseUrl && this.apiKey);
+    }
+    headers(extra = {}) {
+        return { Authorization: `Bearer ${this.apiKey}`, ...extra };
+    }
+    async request(method, path, opts = {}) {
+        if (!this.isConfigured())
+            return UNAVAILABLE;
+        const headers = this.headers(opts.headers);
+        const rawBody = opts.body === undefined ? undefined : JSON.stringify(opts.body);
+        if (rawBody !== undefined)
+            headers["Content-Type"] = "application/json";
+        const d = deadline(opts.timeoutMs ?? this.timeoutMs, opts.signal);
+        try {
+            const res = await this.fetchImpl(`${this.baseUrl}${path}`, { method, headers, body: rawBody, signal: d.signal });
+            return await resultOf(res);
+        }
+        catch {
+            return UNAVAILABLE;
+        }
+        finally {
+            d.done();
+        }
+    }
+    // --- answers ---------------------------------------------------------------------------
+    /** `POST /v1/answer`, JSON: the validated answer with numbered sources. */
+    answer(body, opts = {}) {
+        return this.request("POST", "/v1/answer", {
+            body,
+            headers: { Accept: "application/json" },
+            signal: opts.signal,
+            timeoutMs: this.answerTimeoutMs,
+        });
+    }
+    /** `POST /v1/answer` with `Accept: text/event-stream`: sources first, then gated sentences, then meta. */
+    async answerStream(body, opts = {}) {
+        return this.stream("/v1/answer", body, opts.signal);
+    }
+    /** v2 `POST /v1/agents/:agent_id/chat` streamed (Phase 1; `404 not_found` until it lands). */
+    async agentChatStream(agentId, body, opts = {}) {
+        return this.stream(`/v1/agents/${enc(agentId)}/chat`, body, opts.signal);
+    }
+    async stream(path, body, signal) {
+        if (!this.isConfigured())
+            return UNAVAILABLE;
+        // The budget covers the headers (time to first byte). Once the stream is open the caller's
+        // own signal governs it, so the timer stops at headers while the abort link stays wired
+        // until the body ends or is cancelled.
+        const d = deadline(this.answerTimeoutMs, signal);
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                method: "POST",
+                headers: this.headers({ "Content-Type": "application/json", Accept: "text/event-stream" }),
+                body: JSON.stringify(body),
+                signal: d.signal,
+            });
+        }
+        catch {
+            d.done();
+            return UNAVAILABLE;
+        }
+        if (!res.ok) {
+            d.done();
+            return failureOf(res);
+        }
+        d.clearTimer();
+        const stream = res.body ? untilEnd(res.body, d.done) : emptyBody(d.done);
+        return {
+            ok: true,
+            status: res.status,
+            contentType: res.headers?.get?.("content-type") ?? "text/event-stream",
+            body: stream,
+            events: () => answerEvents(stream),
+            collect: () => collectAnswer(stream),
+        };
+    }
+    // --- search / identity -----------------------------------------------------------------
+    /** `GET /v1/query` — raw hybrid-search passages (bypass the citation gate). */
+    query(params, opts = {}) {
+        return this.request("GET", `/v1/query${queryString(params)}`, { signal: opts.signal });
+    }
+    whoami() {
+        return this.request("GET", "/v1/whoami");
+    }
+    status() {
+        return this.request("GET", "/v1/status");
+    }
+    feedback(body) {
+        return this.request("POST", "/v1/feedback", { body });
+    }
+    // --- media -----------------------------------------------------------------------------
+    /**
+     * `GET /v1/media/<key>`: the platform 302s to a 10-minute presigned URL. `fetch` follows
+     * it, so the Response carries the bytes. Prefer presigned URLs from answer sources where
+     * the platform supplies them; use this when you hold only a media key.
+     */
+    async media(key, init = {}) {
+        if (!this.isConfigured())
+            return UNAVAILABLE;
+        const path = key
+            .replace(/^\/+/, "")
+            .split("/")
+            .map(enc)
+            .join("/");
+        const d = deadline(this.uploadTimeoutMs, init.signal);
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.baseUrl}/v1/media/${path}`, {
+                method: "GET",
+                headers: this.headers(init.range ? { Range: init.range } : {}),
+                redirect: "follow",
+                signal: d.signal,
+            });
+        }
+        catch {
+            d.done();
+            return UNAVAILABLE;
+        }
+        if (!res.ok) {
+            d.done();
+            return failureOf(res);
+        }
+        if (!res.body) {
+            d.done();
+            return { ok: true, status: res.status, data: res };
+        }
+        // Same shape as the platform's Response, with the body wrapped so the caller's abort
+        // stays wired while bytes flow and the link is dropped when they stop.
+        d.clearTimer();
+        return { ok: true, status: res.status, data: new Response(untilEnd(res.body, d.done), res) };
+    }
+    // --- ingestion (amk_i_ keys) -----------------------------------------------------------
+    createUpload(body) {
+        return this.request("POST", "/v1/ingest/uploads", { body });
+    }
+    completeUpload(uploadId, body = {}) {
+        return this.request("POST", `/v1/ingest/uploads/${enc(uploadId)}/complete`, { body });
+    }
+    /**
+     * PUT the staged bytes to `put_url` EXACTLY as the platform returned it. A presigned S3 URL
+     * is its own credential and gets no headers of ours. On FsStore deployments the platform
+     * hands back its own `/v1/ingest/uploads/:id/content` route instead, which sits behind the
+     * same ingest-key auth as every `/v1/ingest/*` call, so that one carries the Bearer key.
+     * A relative `put_url` resolves against `baseUrl`.
+     */
+    async uploadBytes(putUrl, body, sizeBytes) {
+        const url = putUrl.startsWith("/") ? `${this.baseUrl}${putUrl}` : putUrl;
+        const platformRoute = url.startsWith(`${this.baseUrl}/v1/ingest/`);
+        return uploadTo(this.fetchImpl, url, body, sizeBytes, this.uploadTimeoutMs, platformRoute ? this.headers() : {});
+    }
+    /** `POST /v1/ingest/jobs`; pass `idempotencyKey` so a retry returns the same job. */
+    createJob(body, opts = {}) {
+        return this.request("POST", "/v1/ingest/jobs", {
+            body,
+            headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : {},
+        });
+    }
+    getJob(jobId) {
+        return this.request("GET", `/v1/ingest/jobs/${enc(jobId)}`);
+    }
+    listJobs(params = {}) {
+        return this.request("GET", `/v1/ingest/jobs${queryString(params)}`);
+    }
+    cancelJob(jobId) {
+        return this.request("POST", `/v1/ingest/jobs/${enc(jobId)}/cancel`, { body: {} });
+    }
+    retryJob(jobId) {
+        return this.request("POST", `/v1/ingest/jobs/${enc(jobId)}/retry`, { body: {} });
+    }
+    // --- business data ---------------------------------------------------------------------
+    listDatasets() {
+        return this.request("GET", "/v1/data/datasets");
+    }
+    getDataset(datasetId) {
+        return this.request("GET", `/v1/data/datasets/${enc(datasetId)}`);
+    }
+    queryData(dsl, opts = {}) {
+        return this.request("POST", "/v1/data/query", { body: dsl, signal: opts.signal });
+    }
+    createImport(body, opts = {}) {
+        return this.request("POST", "/v1/data/imports", {
+            body,
+            headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : {},
+        });
+    }
+    getImport(id) {
+        return this.request("GET", `/v1/data/imports/${enc(id)}`);
+    }
+}
+const emptyBody = (onEnd) => new ReadableStream({
+    start(c) {
+        onEnd();
+        c.close();
+    },
+});
+/**
+ * Shared by the tenant and service clients: a PUT of raw bytes to the platform's `put_url`.
+ * `headers` is empty for presigned URLs (the URL is the credential) and carries the Bearer
+ * key only for the platform's own auth-gated upload route.
+ */
+export async function uploadTo(fetchImpl, url, body, sizeBytes, timeoutMs, headers = {}) {
+    const init = {
+        method: "PUT",
+        headers: sizeBytes === undefined ? headers : { ...headers, "Content-Length": String(sizeBytes) },
+        body: body,
+        signal: AbortSignal.timeout(timeoutMs),
+    };
+    // Streaming request bodies need half-duplex in undici (Node) and are rejected otherwise.
+    if (typeof ReadableStream !== "undefined" && body instanceof ReadableStream)
+        init.duplex = "half";
+    let res;
+    try {
+        res = await fetchImpl(url, init);
+    }
+    catch {
+        return UNAVAILABLE;
+    }
+    if (!res.ok)
+        return failureOf(res);
+    return { ok: true, status: res.status, data: undefined };
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/http.d.ts

@@ -0,0 +1,27 @@
+import type { PlatformFailure, PlatformResult } from "./types.js";
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export declare const UNAVAILABLE: PlatformFailure;
+export declare const trimSlash: (url: string) => string;
+export declare function defaultFetch(): FetchLike;
+export interface Deadline {
+    signal: AbortSignal;
+    /** Headers arrived within budget: stop the timer but keep the caller's abort wired to the body. */
+    clearTimer: () => void;
+    /** The request is over (settled, or its body ended/cancelled): timer off, caller listener detached. */
+    done: () => void;
+}
+/**
+ * One AbortSignal from an optional caller signal plus a timeout budget. `AbortSignal.any`
+ * is not on Node 20.0, so this composes by hand. `done()` must run when the request is over,
+ * or the timer and the listener on the caller's (often long-lived) signal outlive it; for a
+ * streamed body call `clearTimer()` at headers and `done()` when the body finishes.
+ */
+export declare function deadline(timeoutMs: number, signal?: AbortSignal): Deadline;
+/** Passes a body through untouched and runs `onEnd` once, when it closes, errors or is cancelled. */
+export declare function untilEnd(body: ReadableStream<Uint8Array>, onEnd: () => void): ReadableStream<Uint8Array>;
+/** Reads the platform error envelope `{error, message, request_id}`; non-JSON bodies keep the http_<status> code. */
+export declare function failureOf(res: Response): Promise<PlatformFailure>;
+/** Resolves a fetch Response into the result envelope; 204 carries `undefined` data. */
+export declare function resultOf<T>(res: Response): Promise<PlatformResult<T>>;
+export declare function queryString(params: object): string;
+export declare const enc: (v: string) => string;

package/dist/esm/http.js

@@ -0,0 +1,116 @@
+export const UNAVAILABLE = { ok: false, reason: "unavailable" };
+export const trimSlash = (url) => url.replace(/\/+$/, "");
+export function defaultFetch() {
+    const f = globalThis.fetch;
+    if (typeof f !== "function")
+        throw new Error("@awesomate/platform-sdk: no global fetch; pass fetchImpl");
+    return (input, init) => f(input, init);
+}
+/**
+ * One AbortSignal from an optional caller signal plus a timeout budget. `AbortSignal.any`
+ * is not on Node 20.0, so this composes by hand. `done()` must run when the request is over,
+ * or the timer and the listener on the caller's (often long-lived) signal outlive it; for a
+ * streamed body call `clearTimer()` at headers and `done()` when the body finishes.
+ */
+export function deadline(timeoutMs, signal) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(new DOMException("timeout", "TimeoutError")), timeoutMs);
+    const onAbort = () => ctrl.abort(signal?.reason);
+    if (signal?.aborted)
+        onAbort();
+    else
+        signal?.addEventListener("abort", onAbort, { once: true });
+    const clearTimer = () => clearTimeout(timer);
+    return {
+        signal: ctrl.signal,
+        clearTimer,
+        done: () => {
+            clearTimer();
+            signal?.removeEventListener("abort", onAbort);
+        },
+    };
+}
+/** Passes a body through untouched and runs `onEnd` once, when it closes, errors or is cancelled. */
+export function untilEnd(body, onEnd) {
+    const reader = body.getReader();
+    let ended = false;
+    const end = () => {
+        if (ended)
+            return;
+        ended = true;
+        onEnd();
+    };
+    return new ReadableStream({
+        async pull(ctrl) {
+            try {
+                const { value, done } = await reader.read();
+                if (done) {
+                    end();
+                    ctrl.close();
+                    return;
+                }
+                ctrl.enqueue(value);
+            }
+            catch (err) {
+                end();
+                ctrl.error(err);
+            }
+        },
+        cancel(reason) {
+            end();
+            return reader.cancel(reason);
+        },
+    });
+}
+const header = (res, name) => {
+    const v = res.headers?.get?.(name);
+    return v === null || v === undefined ? undefined : v;
+};
+/** Reads the platform error envelope `{error, message, request_id}`; non-JSON bodies keep the http_<status> code. */
+export async function failureOf(res) {
+    if (res.status >= 500)
+        return UNAVAILABLE;
+    let envelope = {};
+    try {
+        envelope = (await res.json());
+    }
+    catch {
+        // keep the fallback code
+    }
+    const out = { ok: false, status: res.status, error: envelope.error ?? `http_${res.status}` };
+    if (envelope.message !== undefined)
+        out.message = envelope.message;
+    if (envelope.request_id !== undefined)
+        out.requestId = envelope.request_id;
+    const retryAfter = header(res, "retry-after");
+    if (retryAfter !== undefined)
+        out.retryAfter = retryAfter;
+    return out;
+}
+/** Resolves a fetch Response into the result envelope; 204 carries `undefined` data. */
+export async function resultOf(res) {
+    if (!res.ok)
+        return failureOf(res);
+    if (res.status === 204)
+        return { ok: true, status: 204, data: undefined };
+    try {
+        return { ok: true, status: res.status, data: (await res.json()) };
+    }
+    catch {
+        return UNAVAILABLE;
+    }
+}
+export function queryString(params) {
+    const q = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v === undefined || v === null || v === "")
+            continue;
+        if (typeof v !== "string" && typeof v !== "number" && typeof v !== "boolean")
+            continue;
+        q.set(k, String(v));
+    }
+    const s = q.toString();
+    return s ? `?${s}` : "";
+}
+export const enc = (v) => encodeURIComponent(v);
+//# sourceMappingURL=http.js.map

package/dist/esm/http.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,9 @@
+export { PlatformClient, keyClass, uploadTo } from "./client.js";
+export type { PlatformClientConfig, AnswerStreamResult } from "./client.js";
+export { ServiceClient, countTenantSources, liveSourceTotals } from "./service.js";
+export type { ServiceClientConfig } from "./service.js";
+export { parseSSE, answerEvents, collectAnswer } from "./sse.js";
+export type { SSEMessage, CollectedAnswer } from "./sse.js";
+export { signServiceRequest, serviceHeaders, hmacSha256Hex } from "./sign.js";
+export type { FetchLike } from "./http.js";
+export * from "./types.js";

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+export { PlatformClient, keyClass, uploadTo } from "./client.js";
+export { ServiceClient, countTenantSources, liveSourceTotals } from "./service.js";
+export { parseSSE, answerEvents, collectAnswer } from "./sse.js";
+export { signServiceRequest, serviceHeaders, hmacSha256Hex } from "./sign.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEnF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE9E,cAAc,YAAY,CAAC"}

package/dist/esm/service.d.ts

@@ -0,0 +1,140 @@
+import type { FetchLike } from "./http.js";
+import type { AdminJobsPage, AliasDecisionBody, AliasesPage, CompleteUploadBody, CreateSourceBody, CreateUploadBody, Enqueued, EntityKind, LiveSourceTotals, MergeResult, MintKeyBody, MintedKey, PeoplePage, PersonDetail, PersonMeta, PersonPatchBody, PersonStatus, PlatformResult, PurgeJob, SourceSummary, SourcesPage, Tenant, TenantDetail, UploadTicket, UpsertTenantBody, UsageRow } from "./types.js";
+export interface ServiceClientConfig {
+    /** Service-channel base, e.g. `https://knowledge-admin.awesomate.ai`. */
+    adminUrl: string;
+    /** `amk_s_…` — held by the hub's api and worker only, never handed to a client. */
+    serviceKey: string;
+    hmacSecret: string;
+    timeoutMs?: number;
+    uploadTimeoutMs?: number;
+    fetchImpl?: FetchLike;
+    /** Clock for the signed timestamp (tests). */
+    now?: () => number;
+}
+/**
+ * Client for the hub-only service channel (`/v1/admin/*`). Every request carries
+ * `Authorization: Bearer amk_s_…`, `X-Awm-Timestamp`, `X-Awm-Signature` (HMAC over
+ * `<ts>.<rawBody>`) and, on mutations, `X-Awm-Idempotency-Key` (replays return the stored
+ * response). Same error contract as PlatformClient: never throws on the request path.
+ */
+export declare class ServiceClient {
+    private readonly adminUrl;
+    private readonly serviceKey;
+    private readonly hmacSecret;
+    private readonly timeoutMs;
+    private readonly uploadTimeoutMs;
+    private readonly fetchImpl;
+    private readonly now;
+    constructor(config: ServiceClientConfig);
+    isConfigured(): boolean;
+    private request;
+    private tenantPath;
+    /** `PUT /v1/admin/tenants/:id` — idempotent upsert. */
+    upsertTenant(tenantId: string, body: UpsertTenantBody, idempotencyKey: string): Promise<PlatformResult<{
+        tenant: Tenant;
+    }>>;
+    getTenant(tenantId: string): Promise<PlatformResult<TenantDetail>>;
+    mintKey(tenantId: string, body: MintKeyBody, idempotencyKey: string): Promise<PlatformResult<MintedKey>>;
+    revokeKey(tenantId: string, keyId: string, idempotencyKey: string): Promise<PlatformResult<void>>;
+    suspend(tenantId: string, idempotencyKey: string): Promise<PlatformResult<{
+        status: string;
+    }>>;
+    resume(tenantId: string, idempotencyKey: string): Promise<PlatformResult<{
+        status: string;
+    }>>;
+    patchConfig(tenantId: string, config: Record<string, unknown>, idempotencyKey: string): Promise<PlatformResult<{
+        tenant: Tenant;
+    }>>;
+    /** Short-lived `q` key for a test-chat pane — never persisted. Default TTL 15 min. */
+    mintTestChatKey(tenantId: string, opts?: {
+        name?: string;
+        ttlSeconds?: number;
+    }): Promise<PlatformResult<MintedKey>>;
+    purge(tenantId: string, idempotencyKey: string): Promise<PlatformResult<{
+        purge_job_id: string;
+    }>>;
+    getPurgeJob(purgeJobId: string): Promise<PlatformResult<PurgeJob>>;
+    /** Absolute daily counters; the range is capped at 62 days. */
+    listUsage(params: {
+        sinceDay: string;
+        untilDay?: string;
+    }): Promise<PlatformResult<UsageRow[]>>;
+    listJobs(tenantId: string, params?: {
+        status?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<PlatformResult<AdminJobsPage>>;
+    retryJob(tenantId: string, jobId: string, idempotencyKey: string): Promise<PlatformResult<Enqueued>>;
+    listSources(tenantId: string, params?: {
+        limit?: number;
+        cursor?: string;
+        kind?: string;
+        tag?: string;
+    }): Promise<PlatformResult<SourcesPage>>;
+    /** Whole-library counts in one call — for "how much is in here", not for browsing.
+     *  404 on a platform that predates the route; `liveSourceTotals()` falls back to paging. */
+    sourceSummary(tenantId: string): Promise<PlatformResult<SourceSummary>>;
+    createSource(tenantId: string, body: CreateSourceBody, idempotencyKey: string): Promise<PlatformResult<Enqueued>>;
+    deleteSource(tenantId: string, sourceId: string, idempotencyKey: string): Promise<PlatformResult<{
+        job_id: string;
+    }>>;
+    createUpload(tenantId: string, body: CreateUploadBody, idempotencyKey: string): Promise<PlatformResult<UploadTicket>>;
+    completeUpload(tenantId: string, uploadId: string, body: CompleteUploadBody, idempotencyKey: string): Promise<PlatformResult<{
+        upload_id: string;
+        status: string;
+    }>>;
+    /**
+     * PUT the staged bytes to `put_url` EXACTLY as the platform returned it — presigned S3 or
+     * the platform's query-signed dev route. No service headers: the URL is the credential.
+     * A relative `put_url` (FsStore deployments) resolves against `adminUrl`.
+     */
+    uploadBytes(putUrl: string, body: BodyInit | ReadableStream<Uint8Array>, sizeBytes?: number): Promise<PlatformResult<void>>;
+    listPeople(tenantId: string, params?: {
+        status?: PersonStatus | "all";
+        limit?: number;
+        cursor?: string;
+    }): Promise<PlatformResult<PeoplePage>>;
+    getPerson(tenantId: string, personId: string): Promise<PlatformResult<PersonDetail>>;
+    /** Rename (`display_name`, 1–80 chars) or hide/unhide (`status`). The platform propagates a
+     *  rename into its facets and enqueues a resolve. */
+    patchPerson(tenantId: string, personId: string, body: PersonPatchBody, idempotencyKey: string): Promise<PlatformResult<{
+        person: PersonMeta;
+        relabelled: number;
+        job_id: string | null;
+    }>>;
+    mergePeople(tenantId: string, personId: string, body: {
+        into_person_id: string;
+    }, idempotencyKey: string): Promise<PlatformResult<MergeResult>>;
+    listAliasSuggestions(tenantId: string, params?: {
+        status?: "pending" | "accepted" | "rejected";
+        kind?: EntityKind;
+        limit?: number;
+        cursor?: string;
+    }): Promise<PlatformResult<AliasesPage>>;
+    decideAlias(tenantId: string, body: AliasDecisionBody, idempotencyKey: string): Promise<PlatformResult<{
+        alias: string;
+        entity_id: string | null;
+        job_id: string | null;
+    }>>;
+    /** 202 `{job_id, status:'queued', position}` when a resolve is enqueued; 200 `{job_id, status}`
+     *  when one is already queued|running for the tenant. */
+    resolveEntities(tenantId: string, idempotencyKey: string, body?: {
+        full?: boolean;
+        stub?: boolean;
+    }): Promise<PlatformResult<Enqueued>>;
+}
+/**
+ * The truthful "what is in this tenant" figure: the platform's summary route (one GROUP BY,
+ * exact at any size); on a platform that predates it, the paged count — capped, and flagged.
+ */
+export declare function liveSourceTotals(client: Pick<ServiceClient, "listSources" | "sourceSummary">, tenantId: string): Promise<PlatformResult<LiveSourceTotals>>;
+/**
+ * Live source count by paging the metadata list. Prefer `liveSourceTotals`, which uses the
+ * summary route when the platform serves it and falls back to this.
+ */
+export declare function countTenantSources(client: Pick<ServiceClient, "listSources">, tenantId: string): Promise<PlatformResult<{
+    total: number;
+    failed: number;
+    truncated: boolean;
+}>>;