@ai-matrx/api 0.0.0-stage → 0.1.1

package/dist/platform.d.cts

@@ -0,0 +1,572 @@
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent } from './index-wC2vtb70.cjs';
+import { JsonValue } from './schemas.cjs';
+import './credentials.cjs';
+
+/**
+ * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
+ * CONTRACT_SHA256 50a790edb39e682b46e0fa9e674faf5ce2a0ba7de2cd01930a497fca4c47844a
+ */
+
+/** AppConfigResponse */
+type AppConfigResponse = {
+    app: string;
+    schema_version: number;
+    min_supported_app_version: string;
+    config: {
+        [key: string]: JsonValue;
+    };
+    updated_at: string;
+};
+/** DevLoginRequest */
+type DevLoginRequest = {
+    /** UUID of an existing row in auth.users. */
+    user_id: string;
+    /** Requested lifetime, recorded in the audit row. Supabase issues the session and owns its expiry, so the returned `expires_at` is the token's real `exp`, not this value. */
+    ttl_seconds?: number;
+};
+/** DevLoginResponse */
+type DevLoginResponse = {
+    access_token: string;
+    user_id: string;
+    expires_at: number;
+    issued_at: number;
+    jti: string;
+};
+/** What happened to one directive publish. Never raised; always returned */
+type DirectivePublishReport = {
+    published: boolean;
+    topics: string[];
+    delivered_topics: string[];
+    reason?: string | null;
+};
+/** One typed rule about the output. The unit an author writes in the UI. */
+type Expectation = {
+    /** Stable slug — becomes the proof's id. */
+    id: string;
+    rule: "contains_marker" | "excludes_marker" | "routes_exist" | "path_present" | "path_absent" | "path_equals" | "path_not_equals" | "min_items" | "max_items" | "matches" | "judge";
+    title?: string;
+    proves?: string;
+    path?: string;
+    marker?: string;
+    value?: JsonValue;
+    count?: number;
+    rubric?: string;
+    required?: boolean;
+};
+/** One mandate an author can point a scenario at, with what it offers. */
+type MandateOption = {
+    mandate_key: string;
+    label: string;
+    description?: string;
+    output_kind?: string | null;
+    required_output_keys?: string[];
+    accepts_user_input?: boolean;
+    provision?: string | null;
+    offered_values?: {
+        [key: string]: JsonValue;
+    }[];
+};
+/** OAuthIncidentRequest */
+type OAuthIncidentRequest = {
+    params: string[];
+    where: string;
+};
+/** OAuthIncidentResponse */
+type OAuthIncidentResponse = {
+    status: string;
+};
+/** Response from the on-sign-in hook — used for operator observability. */
+type OnSignInResponse = {
+    ok: boolean;
+    user_id: string;
+};
+/** OrganizationReport */
+type OrganizationReport = {
+    authenticated: boolean;
+    user_id?: string | null;
+    organizations: OrganizationSummary[];
+    warnings?: "membership_organization_missing"[];
+    missing_organization_count?: number;
+};
+/** OrganizationSummary */
+type OrganizationSummary = {
+    id: string;
+    name: string;
+    abbreviation?: string | null;
+    archived_at?: string | null;
+};
+/** One check's registry row plus its rolling 30-day KPIs. */
+type ProofCheckStatusKind = {
+    /** The registered kind this payload is an instance of. */
+    __kind?: "proof_check_status";
+    slug?: string;
+    label?: string;
+    description?: string;
+    surface?: string;
+    is_active?: boolean;
+    live_every_seconds?: number;
+    max_cost_usd?: number;
+    last_verdict?: string | null;
+    last_run_at?: string | null;
+    last_live_verdict?: string | null;
+    last_live_run_at?: string | null;
+    next_live_due_at?: string | null;
+    consecutive_failures?: number;
+    runs_30d?: number;
+    live_runs_30d?: number;
+    pass_rate_30d?: number | null;
+    spend_30d_usd?: number;
+    has_recording?: boolean;
+};
+/** ProofChecksResponse */
+type ProofChecksResponse = {
+    checks?: ProofCheckStatusKind[];
+    month_to_date_usd?: number;
+    monthly_ceiling_usd?: number;
+};
+/** One run with the proofs — each a registered ``proof_result`` payload. */
+type ProofRunDetail = {
+    id: string;
+    check_id: string;
+    check_slug?: string;
+    mode: string;
+    trigger_source?: string;
+    status?: string;
+    verdict?: string | null;
+    started_at?: string | null;
+    finished_at?: string | null;
+    duration_ms?: number;
+    cost_usd?: number;
+    total_tokens?: number;
+    provider_calls?: number;
+    summary?: string;
+    failure_reason?: string | null;
+    nonce?: string;
+    conversation_id?: string | null;
+    user_request_id?: string | null;
+    external_run_ref?: string | null;
+    replayed_from_run_id?: string | null;
+    recording_sha256?: string | null;
+    git_sha?: string;
+    environment?: string;
+    proofs?: {
+        [key: string]: JsonValue;
+    }[];
+};
+/** One row of run history — the list view, without the proof bodies. */
+type ProofRunSummary = {
+    id: string;
+    check_id: string;
+    check_slug?: string;
+    mode: string;
+    trigger_source?: string;
+    status?: string;
+    verdict?: string | null;
+    started_at?: string | null;
+    finished_at?: string | null;
+    duration_ms?: number;
+    cost_usd?: number;
+    total_tokens?: number;
+    provider_calls?: number;
+    summary?: string;
+    failure_reason?: string | null;
+};
+/** ProofRunsResponse */
+type ProofRunsResponse = {
+    runs?: ProofRunSummary[];
+};
+/** PublicationStatus */
+type PublicationStatus = {
+    provider: string;
+    level: string;
+    owner_id: string | null;
+    external_id: string | null;
+    version_id: string | null;
+    rules_hash: string | null;
+    rule_count: number;
+    synced_at: string | null;
+    has_error: boolean;
+    error: {
+        [key: string]: unknown;
+    } | null;
+};
+/** RefreshRequiredRequest */
+type RefreshRequiredRequest = {
+    reason?: "deploy" | "breaking_change" | "operator";
+    title?: string | null;
+    body?: string | null;
+    audience?: "platform" | "user";
+    user_id?: string | null;
+};
+/** RunNowRequest */
+type RunNowRequest = {
+    /** auto — the gate decides from cadence and budget (default). live — force real providers, still inside the monthly ceiling. replay — never spend money. */
+    mode?: string;
+    reason?: string;
+};
+/** ScenarioDeleteResponse */
+type ScenarioDeleteResponse = {
+    deleted: boolean;
+};
+/** A saved scenario, as the editor sends it. */
+type ScenarioPayload = {
+    slug: string;
+    label: string;
+    description?: string;
+    mandate_key: string;
+    variables?: {
+        [key: string]: JsonValue;
+    };
+    allowed_routes?: string[];
+    expectations?: Expectation[];
+    user_input?: string | null;
+    is_active?: boolean;
+    live_every_seconds?: number;
+    max_cost_usd?: number;
+};
+/** A stored scenario, plus the identity of the check it becomes. */
+type ScenarioRow = {
+    slug: string;
+    label: string;
+    description?: string;
+    mandate_key: string;
+    variables?: {
+        [key: string]: JsonValue;
+    };
+    allowed_routes?: string[];
+    expectations?: Expectation[];
+    user_input?: string | null;
+    is_active?: boolean;
+    live_every_seconds?: number;
+    max_cost_usd?: number;
+    check_slug?: string;
+};
+/** ScenariosResponse */
+type ScenariosResponse = {
+    scenarios?: ScenarioRow[];
+};
+/** SessionExchangeRequest */
+type SessionExchangeRequest = {
+    handoff: string;
+};
+/** SessionExchangeResponse */
+type SessionExchangeResponse = {
+    access_token: string;
+    token_type: string;
+};
+/** Supabase Auth webhook envelope. */
+type SupabaseAuthWebhookPayload = {
+    type: "INSERT" | "UPDATE";
+    table: string;
+    record: SupabaseAuthWebhookUser;
+    [key: string]: unknown;
+};
+/** Subset of the Supabase ``UserRecord`` payload we actually consume. */
+type SupabaseAuthWebhookUser = {
+    /** auth.users.id — UUID */
+    id: string;
+    email?: string | null;
+    aud?: string | null;
+    role?: string | null;
+    [key: string]: unknown;
+};
+/** WhoamiResponse */
+type WhoamiResponse = {
+    authenticated: boolean;
+    user_id: string | null;
+    is_admin: boolean;
+    email: string | null;
+    organization_id: string | null;
+};
+/** PublishRequest */
+type aidream__api__routers__dictionary__PublishRequest = {
+    /** global | organization | user */
+    level: string;
+    /** Required for non-global tiers */
+    owner_id?: string | null;
+};
+/** MandateCatalogResponse */
+type aidream__api__routers__proof_runs__MandateCatalogResponse = {
+    mandates?: MandateOption[];
+    rules?: {
+        [key: string]: JsonValue;
+    }[];
+};
+type InitiateOauthArgs = {
+    query: {
+        app_redirect: string;
+        admin_required?: boolean;
+    };
+};
+type InitiateOauthResult = unknown;
+/** Initiate Oauth */
+/** `GET /auth/aimatrx` · aidream · auth public · org exempt */
+declare function initiateOauth(api: Api, args: InitiateOauthArgs, options?: CallOptions): Promise<InitiateOauthResult>;
+type OauthCallbackArgs = {
+    query?: {
+        code?: string | null;
+        state?: string | null;
+        error?: string | null;
+        error_description?: string | null;
+    };
+};
+type OauthCallbackResult = unknown;
+/** Oauth Callback */
+/** `GET /auth/callback` · aidream · auth public · org exempt */
+declare function oauthCallback(api: Api, args?: OauthCallbackArgs, options?: CallOptions): Promise<OauthCallbackResult>;
+type ExchangeSessionHandoffArgs = {
+    body: SessionExchangeRequest;
+};
+type ExchangeSessionHandoffResult = SessionExchangeResponse;
+/** Exchange Session Handoff */
+/** `POST /auth/session/exchange` · aidream · auth public · org exempt */
+declare function exchangeSessionHandoff(api: Api, args: ExchangeSessionHandoffArgs, options?: CallOptions): Promise<ExchangeSessionHandoffResult>;
+type ReportOauthIncidentArgs = {
+    body: OAuthIncidentRequest;
+};
+type ReportOauthIncidentResult = OAuthIncidentResponse;
+/** Report Oauth Incident */
+/** `POST /auth/session/oauth-incident` · aidream · auth public · org exempt */
+declare function reportOauthIncident(api: Api, args: ReportOauthIncidentArgs, options?: CallOptions): Promise<ReportOauthIncidentResult>;
+type CurrentFileSessionStatusArgs = {
+    [key: string]: never;
+};
+type CurrentFileSessionStatusResult = unknown;
+/** Current File Session Status */
+/** `GET /auth/file-session/status` · aidream · auth guest · org exempt */
+declare function currentFileSessionStatus(api: Api, args?: CurrentFileSessionStatusArgs, options?: CallOptions): Promise<CurrentFileSessionStatusResult>;
+type CurrentSessionStatusArgs = {
+    [key: string]: never;
+};
+type CurrentSessionStatusResult = unknown;
+/** Current Session Status */
+/** `GET /auth/session/status` · aidream · auth guest · org exempt */
+declare function currentSessionStatus(api: Api, args?: CurrentSessionStatusArgs, options?: CallOptions): Promise<CurrentSessionStatusResult>;
+type WhoamiArgs = {
+    [key: string]: never;
+};
+type WhoamiResult = WhoamiResponse;
+/** Whoami */
+/** `GET /auth/whoami` · aidream · auth guest · org exempt */
+declare function whoami(api: Api, args?: WhoamiArgs, options?: CallOptions): Promise<WhoamiResult>;
+type ListMyOrganizationsArgs = {
+    [key: string]: never;
+};
+type ListMyOrganizationsResult = OrganizationReport;
+/** List My Organizations */
+/** `GET /auth/organizations` · aidream · auth guest · org exempt */
+declare function listMyOrganizations(api: Api, args?: ListMyOrganizationsArgs, options?: CallOptions): Promise<ListMyOrganizationsResult>;
+type GetAppConfigArgs = {
+    path: {
+        app: string;
+    };
+};
+type GetAppConfigResult = AppConfigResponse;
+/** Get App Config */
+/** `GET /app-config/{app}` · aidream · auth guest · org optional */
+declare function getAppConfig(api: Api, args: GetAppConfigArgs, options?: CallOptions): Promise<GetAppConfigResult>;
+type PublishDictionaryArgs = {
+    body: aidream__api__routers__dictionary__PublishRequest;
+};
+type PublishDictionaryResult = unknown;
+/** Publish Dictionary */
+/** `POST /dictionary/publish` · aidream · auth guest · org required · ndjson */
+declare function publishDictionary(api: Api, args: PublishDictionaryArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type ListPublicationsArgs = {
+    [key: string]: never;
+};
+type ListPublicationsResult = PublicationStatus[];
+/** List Publications */
+/** `GET /dictionary/publications` · aidream · auth guest · org exempt */
+declare function listPublications(api: Api, args?: ListPublicationsArgs, options?: CallOptions): Promise<ListPublicationsResult>;
+type OnSignInArgs = {
+    body: SupabaseAuthWebhookPayload;
+};
+type OnSignInResult = OnSignInResponse;
+/** Supabase auth webhook acknowledgement (no scoped writes). */
+/** `POST /auth/on-sign-in` · aidream · auth guest · org exempt */
+declare function onSignIn(api: Api, args: OnSignInArgs, options?: CallOptions): Promise<OnSignInResult>;
+type DevLoginAsArgs = {
+    body: DevLoginRequest;
+};
+type DevLoginAsResult = DevLoginResponse;
+/** Dev Login As */
+/** `POST /dev/login-as` · aidream · auth guest · org required */
+declare function devLoginAs(api: Api, args: DevLoginAsArgs, options?: CallOptions): Promise<DevLoginAsResult>;
+type ListChecksArgs = {
+    [key: string]: never;
+};
+type ListChecksResult = ProofChecksResponse;
+/** List Checks */
+/** `GET /proof-runs/checks` · aidream · auth admin · org optional */
+declare function listChecks(api: Api, args?: ListChecksArgs, options?: CallOptions): Promise<ListChecksResult>;
+type GetCheckArgs = {
+    path: {
+        slug: string;
+    };
+};
+type GetCheckResult = ProofCheckStatusKind;
+/** Get Check */
+/** `GET /proof-runs/checks/{slug}` · aidream · auth admin · org optional */
+declare function getCheck(api: Api, args: GetCheckArgs, options?: CallOptions): Promise<GetCheckResult>;
+type RunCheckArgs = {
+    path: {
+        slug: string;
+    };
+    body: RunNowRequest;
+};
+type RunCheckResult = unknown;
+/** Run Check */
+/** `POST /proof-runs/checks/{slug}/run` · aidream · auth admin · org required · ndjson */
+declare function runCheck(api: Api, args: RunCheckArgs, options?: CallOptions): Promise<ApiStream<NdjsonEvent>>;
+type ListRecentRunsArgs = {
+    query?: {
+        slug?: string | null;
+        mode?: string | null;
+        limit?: number;
+    };
+};
+type ListRecentRunsResult = ProofRunsResponse;
+/** List Recent Runs */
+/** `GET /proof-runs/runs` · aidream · auth admin · org optional */
+declare function listRecentRuns(api: Api, args?: ListRecentRunsArgs, options?: CallOptions): Promise<ListRecentRunsResult>;
+type GetRunDetailArgs = {
+    path: {
+        run_id: string;
+    };
+};
+type GetRunDetailResult = ProofRunDetail;
+/** Get Run Detail */
+/** `GET /proof-runs/runs/{run_id}` · aidream · auth admin · org optional */
+declare function getRunDetail(api: Api, args: GetRunDetailArgs, options?: CallOptions): Promise<GetRunDetailResult>;
+type ListScenariosArgs = {
+    [key: string]: never;
+};
+type ListScenariosResult = ScenariosResponse;
+/** List Scenarios */
+/** `GET /proof-runs/scenarios` · aidream · auth admin · org optional */
+declare function listScenarios(api: Api, args?: ListScenariosArgs, options?: CallOptions): Promise<ListScenariosResult>;
+type SaveScenarioArgs = {
+    path: {
+        slug: string;
+    };
+    body: ScenarioPayload;
+};
+type SaveScenarioResult = ScenarioRow;
+/** Save Scenario */
+/** `PUT /proof-runs/scenarios/{slug}` · aidream · auth admin · org required */
+declare function saveScenario(api: Api, args: SaveScenarioArgs, options?: CallOptions): Promise<SaveScenarioResult>;
+type DeleteScenarioArgs = {
+    path: {
+        slug: string;
+    };
+};
+type DeleteScenarioResult = ScenarioDeleteResponse;
+/** Delete Scenario */
+/** `DELETE /proof-runs/scenarios/{slug}` · aidream · auth admin · org required */
+declare function deleteScenario(api: Api, args: DeleteScenarioArgs, options?: CallOptions): Promise<DeleteScenarioResult>;
+type MandateCatalogArgs = {
+    [key: string]: never;
+};
+type MandateCatalogResult = aidream__api__routers__proof_runs__MandateCatalogResponse;
+/** Mandate Catalog */
+/** `GET /proof-runs/mandate-catalog` · aidream · auth admin · org optional */
+declare function mandateCatalog(api: Api, args?: MandateCatalogArgs, options?: CallOptions): Promise<MandateCatalogResult>;
+type SendRefreshRequiredArgs = {
+    body: RefreshRequiredRequest;
+};
+type SendRefreshRequiredResult = DirectivePublishReport;
+/** Send Refresh Required */
+/** `POST /admin/client-directives/refresh-required` · aidream · auth admin · org exempt */
+declare function sendRefreshRequired(api: Api, args: SendRefreshRequiredArgs, options?: CallOptions): Promise<SendRefreshRequiredResult>;
+/** Every JSON operation of this domain by `METHOD path` — for path-keyed calls. */
+interface Operations {
+    "GET /auth/aimatrx": {
+        args: InitiateOauthArgs;
+        result: InitiateOauthResult;
+    };
+    "GET /auth/callback": {
+        args: OauthCallbackArgs;
+        result: OauthCallbackResult;
+    };
+    "POST /auth/session/exchange": {
+        args: ExchangeSessionHandoffArgs;
+        result: ExchangeSessionHandoffResult;
+    };
+    "POST /auth/session/oauth-incident": {
+        args: ReportOauthIncidentArgs;
+        result: ReportOauthIncidentResult;
+    };
+    "GET /auth/file-session/status": {
+        args: CurrentFileSessionStatusArgs;
+        result: CurrentFileSessionStatusResult;
+    };
+    "GET /auth/session/status": {
+        args: CurrentSessionStatusArgs;
+        result: CurrentSessionStatusResult;
+    };
+    "GET /auth/whoami": {
+        args: WhoamiArgs;
+        result: WhoamiResult;
+    };
+    "GET /auth/organizations": {
+        args: ListMyOrganizationsArgs;
+        result: ListMyOrganizationsResult;
+    };
+    "GET /app-config/{app}": {
+        args: GetAppConfigArgs;
+        result: GetAppConfigResult;
+    };
+    "GET /dictionary/publications": {
+        args: ListPublicationsArgs;
+        result: ListPublicationsResult;
+    };
+    "POST /auth/on-sign-in": {
+        args: OnSignInArgs;
+        result: OnSignInResult;
+    };
+    "POST /dev/login-as": {
+        args: DevLoginAsArgs;
+        result: DevLoginAsResult;
+    };
+    "GET /proof-runs/checks": {
+        args: ListChecksArgs;
+        result: ListChecksResult;
+    };
+    "GET /proof-runs/checks/{slug}": {
+        args: GetCheckArgs;
+        result: GetCheckResult;
+    };
+    "GET /proof-runs/runs": {
+        args: ListRecentRunsArgs;
+        result: ListRecentRunsResult;
+    };
+    "GET /proof-runs/runs/{run_id}": {
+        args: GetRunDetailArgs;
+        result: GetRunDetailResult;
+    };
+    "GET /proof-runs/scenarios": {
+        args: ListScenariosArgs;
+        result: ListScenariosResult;
+    };
+    "PUT /proof-runs/scenarios/{slug}": {
+        args: SaveScenarioArgs;
+        result: SaveScenarioResult;
+    };
+    "DELETE /proof-runs/scenarios/{slug}": {
+        args: DeleteScenarioArgs;
+        result: DeleteScenarioResult;
+    };
+    "GET /proof-runs/mandate-catalog": {
+        args: MandateCatalogArgs;
+        result: MandateCatalogResult;
+    };
+    "POST /admin/client-directives/refresh-required": {
+        args: SendRefreshRequiredArgs;
+        result: SendRefreshRequiredResult;
+    };
+}
+/** Path-keyed call, scoped to this domain only (never a global path map). */
+declare function call<K extends keyof Operations>(api: Api, key: K, args?: Operations[K]["args"], options?: CallOptions): Promise<Operations[K]["result"]>;
+
+export { type AppConfigResponse, type CurrentFileSessionStatusArgs, type CurrentFileSessionStatusResult, type CurrentSessionStatusArgs, type CurrentSessionStatusResult, type DeleteScenarioArgs, type DeleteScenarioResult, type DevLoginAsArgs, type DevLoginAsResult, type DevLoginRequest, type DevLoginResponse, type DirectivePublishReport, type ExchangeSessionHandoffArgs, type ExchangeSessionHandoffResult, type Expectation, type GetAppConfigArgs, type GetAppConfigResult, type GetCheckArgs, type GetCheckResult, type GetRunDetailArgs, type GetRunDetailResult, type InitiateOauthArgs, type InitiateOauthResult, type ListChecksArgs, type ListChecksResult, type ListMyOrganizationsArgs, type ListMyOrganizationsResult, type ListPublicationsArgs, type ListPublicationsResult, type ListRecentRunsArgs, type ListRecentRunsResult, type ListScenariosArgs, type ListScenariosResult, type MandateCatalogArgs, type MandateCatalogResult, type MandateOption, type OAuthIncidentRequest, type OAuthIncidentResponse, type OauthCallbackArgs, type OauthCallbackResult, type OnSignInArgs, type OnSignInResponse, type OnSignInResult, type Operations, type OrganizationReport, type OrganizationSummary, type ProofCheckStatusKind, type ProofChecksResponse, type ProofRunDetail, type ProofRunSummary, type ProofRunsResponse, type PublicationStatus, type PublishDictionaryArgs, type PublishDictionaryResult, type RefreshRequiredRequest, type ReportOauthIncidentArgs, type ReportOauthIncidentResult, type RunCheckArgs, type RunCheckResult, type RunNowRequest, type SaveScenarioArgs, type SaveScenarioResult, type ScenarioDeleteResponse, type ScenarioPayload, type ScenarioRow, type ScenariosResponse, type SendRefreshRequiredArgs, type SendRefreshRequiredResult, type SessionExchangeRequest, type SessionExchangeResponse, type SupabaseAuthWebhookPayload, type SupabaseAuthWebhookUser, type WhoamiArgs, type WhoamiResponse, type WhoamiResult, type aidream__api__routers__dictionary__PublishRequest, type aidream__api__routers__proof_runs__MandateCatalogResponse, call, currentFileSessionStatus, currentSessionStatus, deleteScenario, devLoginAs, exchangeSessionHandoff, getAppConfig, getCheck, getRunDetail, initiateOauth, listChecks, listMyOrganizations, listPublications, listRecentRuns, listScenarios, mandateCatalog, oauthCallback, onSignIn, publishDictionary, reportOauthIncident, runCheck, saveScenario, sendRefreshRequired, whoami };