@agentlogin/mcp 0.0.0-stage → 0.2.0-beta.1

package/dist/runtime.d.ts

@@ -0,0 +1,316 @@
+import { type CookieJar, type SignInAtOptions, type SignInResult } from 'agentlogin';
+import { z } from 'zod';
+import { type Application, type Config, type Identity } from './config.js';
+import { type Catalog } from './catalog.js';
+export declare class ToolError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export interface LoginClient {
+    discover(): Promise<{
+        issuer: string;
+    }>;
+    signInAt(url: string, options: SignInAtOptions): Promise<SignInResult>;
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+}
+declare const SessionBindingSchema: z.ZodObject<{
+    handle: z.ZodString;
+    issuer: z.ZodString;
+    sub: z.ZodString;
+}, z.core.$strict>;
+export type SessionBinding = z.infer<typeof SessionBindingSchema>;
+export interface RuntimeOptions {
+    now?: () => number;
+    /** An embedding host may supply its own protected, durable store; records contain no login authority. */
+    intents?: {
+        get(identity: string, application: string): unknown;
+        set(identity: string, application: string, value: unknown): void;
+    };
+    clientFactory?: (identity: Identity, app: Application, jar: CookieJar) => LoginClient;
+    jarFactory?: (identityId: string, applicationId: string) => CookieJar;
+    catalogs?: Catalog[];
+    sessionBindings?: {
+        get(key: string): Promise<SessionBinding | undefined>;
+        set(key: string, value: SessionBinding | undefined): Promise<void>;
+    };
+}
+export declare function safeError(error: unknown): {
+    code: string;
+    message: string;
+};
+/** Bounded JSON only: callback pages, response headers and Location values are never returned to the model. */
+export declare function readJson(response: Response, maxBytes?: number): Promise<unknown>;
+export declare class LoginRuntime {
+    private readonly options;
+    readonly config: Config;
+    private readonly contexts;
+    private readonly resolvers;
+    private readonly jobs;
+    private readonly busy;
+    private readonly lastStarted;
+    private readonly catalogs;
+    private lastCall;
+    private callTokens;
+    private readonly now;
+    constructor(config: unknown, options?: RuntimeOptions);
+    rateLimit(): void;
+    inventory(): {
+        identities: {
+            id: string;
+            handle: string;
+            enrollmentAvailable: boolean;
+        }[];
+        applications: {
+            id: string;
+            name: string;
+            origin: string;
+            operations: {
+                name: string;
+                description: string;
+                method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+                inputFields: string[];
+                queryFields: string[];
+            }[];
+        }[];
+        sessionLocation: string;
+        browserSession: boolean;
+    };
+    catalog(kind?: 'provider' | 'application'): {
+        entries: ({
+            protocol: "agent-login" | "agentid";
+            effectiveStatus: string;
+            automaticTrust: boolean;
+            kind: "provider";
+            issuer: string;
+            handleDomains: string[];
+            specRevision: string;
+            evidence: {
+                revision: string;
+                kind: "domain_control" | "protocol_test" | "independent_interop" | "operational_review";
+                url: string;
+                observedAt: string;
+                expiresAt: string;
+                reviewer: string;
+                protocol?: "agent-login" | undefined;
+            }[];
+            id: string;
+            name: string;
+            operator: string;
+            homepage: string;
+            status: "candidate" | "reviewed" | "suspended";
+            updatedAt: string;
+        } | {
+            protocol: "agent-login" | "agentid";
+            effectiveStatus: string;
+            automaticTrust: boolean;
+            protocolReference: string;
+            evidence: {
+                protocol: "agentid";
+                reference: string;
+                kind: "domain_control" | "protocol_test" | "independent_interop" | "operational_review";
+                url: string;
+                observedAt: string;
+                expiresAt: string;
+                reviewer: string;
+            }[];
+            kind: "provider";
+            issuer: string;
+            handleDomains: string[];
+            id: string;
+            name: string;
+            operator: string;
+            homepage: string;
+            status: "candidate" | "reviewed" | "suspended";
+            updatedAt: string;
+        } | {
+            protocol: "agent-login" | "agentid";
+            effectiveStatus: string;
+            automaticTrust: boolean;
+            clientType: "open";
+            clientId: string;
+            kind: "application";
+            initiateLoginUri: string;
+            specRevision: string;
+            evidence: {
+                revision: string;
+                kind: "domain_control" | "protocol_test" | "independent_interop" | "operational_review";
+                url: string;
+                observedAt: string;
+                expiresAt: string;
+                reviewer: string;
+                protocol?: "agent-login" | undefined;
+            }[];
+            id: string;
+            name: string;
+            operator: string;
+            homepage: string;
+            status: "candidate" | "reviewed" | "suspended";
+            updatedAt: string;
+        } | {
+            protocol: "agent-login" | "agentid";
+            effectiveStatus: string;
+            automaticTrust: boolean;
+            clientType: "registered";
+            clientId: string;
+            issuer: string;
+            kind: "application";
+            initiateLoginUri: string;
+            specRevision: string;
+            evidence: {
+                revision: string;
+                kind: "domain_control" | "protocol_test" | "independent_interop" | "operational_review";
+                url: string;
+                observedAt: string;
+                expiresAt: string;
+                reviewer: string;
+                protocol?: "agent-login" | undefined;
+            }[];
+            id: string;
+            name: string;
+            operator: string;
+            homepage: string;
+            status: "candidate" | "reviewed" | "suspended";
+            updatedAt: string;
+        })[];
+        automaticTrust: boolean;
+    };
+    private key;
+    private configuredPair;
+    private context;
+    private binding;
+    private bind;
+    private intentFile;
+    private intentBinding;
+    private readIntent;
+    private saveIntent;
+    private restored;
+    private prune;
+    start(identity: string, application: string): {
+        pollAfterSeconds?: number | undefined;
+        sessionLocation: string;
+        browserSession: boolean;
+        ownerApprovalUrl?: string | undefined;
+        transactionId?: string | undefined;
+        ownerPortal?: string | undefined;
+        disclosure?: {
+            scope: string;
+            title: string;
+            description: string;
+        }[] | undefined;
+        client?: {
+            client_id: string;
+            client_type: string;
+            redirect_host: string;
+            client_name?: string;
+            logo_uri?: string;
+            tos_uri?: string;
+            policy_uri?: string;
+        } | undefined;
+        consentReason?: string | undefined;
+        disclosureIsUntrustedText?: boolean | undefined;
+        scopes?: string[] | undefined;
+        error?: string | undefined;
+        operation: string;
+        intent: string;
+        identity: string;
+        application: string;
+        status: "starting" | "awaiting_consent" | "awaiting_owner" | "completing" | "authenticated" | "failed" | "paused" | "expired";
+        expiresAt: number;
+        decisionExpiresAt: number;
+        resumable: boolean;
+    };
+    status(operation: string): {
+        pollAfterSeconds?: number | undefined;
+        sessionLocation: string;
+        browserSession: boolean;
+        ownerApprovalUrl?: string | undefined;
+        transactionId?: string | undefined;
+        ownerPortal?: string | undefined;
+        disclosure?: {
+            scope: string;
+            title: string;
+            description: string;
+        }[] | undefined;
+        client?: {
+            client_id: string;
+            client_type: string;
+            redirect_host: string;
+            client_name?: string;
+            logo_uri?: string;
+            tos_uri?: string;
+            policy_uri?: string;
+        } | undefined;
+        consentReason?: string | undefined;
+        disclosureIsUntrustedText?: boolean | undefined;
+        scopes?: string[] | undefined;
+        error?: string | undefined;
+        operation: string;
+        intent: string;
+        identity: string;
+        application: string;
+        status: "starting" | "awaiting_consent" | "awaiting_owner" | "completing" | "authenticated" | "failed" | "paused" | "expired";
+        expiresAt: number;
+        decisionExpiresAt: number;
+        resumable: boolean;
+    };
+    review(operation: string, decision: 'allow' | 'deny'): {
+        pollAfterSeconds?: number | undefined;
+        sessionLocation: string;
+        browserSession: boolean;
+        ownerApprovalUrl?: string | undefined;
+        transactionId?: string | undefined;
+        ownerPortal?: string | undefined;
+        disclosure?: {
+            scope: string;
+            title: string;
+            description: string;
+        }[] | undefined;
+        client?: {
+            client_id: string;
+            client_type: string;
+            redirect_host: string;
+            client_name?: string;
+            logo_uri?: string;
+            tos_uri?: string;
+            policy_uri?: string;
+        } | undefined;
+        consentReason?: string | undefined;
+        disclosureIsUntrustedText?: boolean | undefined;
+        scopes?: string[] | undefined;
+        error?: string | undefined;
+        operation: string;
+        intent: string;
+        identity: string;
+        application: string;
+        status: "starting" | "awaiting_consent" | "awaiting_owner" | "completing" | "authenticated" | "failed" | "paused" | "expired";
+        expiresAt: number;
+        decisionExpiresAt: number;
+        resumable: boolean;
+    };
+    private complete;
+    private awaitReview;
+    private checkSession;
+    request(identity: string, application: string, operation: string, input?: Record<string, unknown>): Promise<{
+        status: number;
+        succeeded: boolean;
+        retryAutomatically: boolean;
+        data?: undefined;
+        dataIsUntrusted?: undefined;
+    } | {
+        status: number;
+        succeeded: boolean;
+        data: Record<string, unknown>;
+        dataIsUntrusted: boolean;
+        retryAutomatically?: undefined;
+    }>;
+    logout(identity: string, application: string): Promise<{
+        loggedOut: boolean;
+        application: string;
+        identity: string;
+        browserSession: boolean;
+    }>;
+    private exclusive;
+    /** Useful to an embedding host during graceful shutdown and to deterministic integration tests. */
+    settled(operation: string): Promise<ReturnType<LoginRuntime['status']>>;
+}
+export {};