managed-deepagents 0.6.2-dev.5 → 0.6.2-dev.50

package/README.md

@@ -245,11 +245,12 @@ used only to reconcile the registry and never enters the build or snapshot.
 
 Add `connectors/mcp.ts` to attach MCP servers. The file must export a named
 `connector`. By default, MDA exposes every tool loaded from each declared
-server. Supply your own auth via static `headers` when the server requires
-credentials:
+server. In `mda dev`, an agent-owned connection reads from
+`MDA_DEV_<SLUG>` with the slug uppercased and hyphens changed to underscores.
+Hosted deployments resolve workspace connections from Agent Auth:
 
 ```ts
-import { connectors } from "managed-deepagents";
+import { connectors, connections } from "managed-deepagents";
 
 export const connector = connectors.mcp({
   mcpServers: {
@@ -257,11 +258,26 @@ export const connector = connectors.mcp({
       transport: "http",
       url: "https://docs.langchain.com/mcp",
       includeTools: ["search", "fetch"],
+      connection: connections.get("docs-token", { type: "agent" }),
     },
   },
 });
 ```
 
+For this example, set `MDA_DEV_DOCS_TOKEN`.
+
+A user-owned connection — `connections.get(slug, { type: "user" })` — resolves
+per caller via OAuth. The pre-run credential gate interrupts the run
+when a grant is missing. `mda dev` has no deployment to hold user grants, so
+a user-owned connection fails there with an actionable error; deploy the agent
+to exercise one.
+
+Deploy the project first, then provision its connections with
+`mda connections create`. Agent-owned opaque secrets are scoped to that
+deployment, so the command refuses to create one before `mda deploy`.
+`mda deploy` fails when a slug a project declares is missing from the
+workspace.
+
 Use `includeTools` or `excludeTools` inside a server config to select a subset.
 Tool names are raw MCP tool names before the managed `{server}__` prefix is
 applied, so `includeTools: ["search"]` on server `langchainDocs` exposes

package/dist/agent-auth.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Agent Auth client used by `credentials.get` and the pre-run credential gate.
+ *
+ * Talks to the shipped Agent Auth APIs (credentials + oauth-authorization-sessions),
+ * not the aspirational `credentials/mint` endpoint.
+ */
+export declare const AGENT_AUTH_TIMEOUT_MS = 10000;
+export declare const AGENT_AUTH_PROVIDER_PAGE_SIZE = 100;
+export declare const AGENT_AUTH_MAX_PROVIDER_PAGES = 20;
+export interface AgentAuthHttpConfig {
+    apiKey?: string;
+    workspaceId?: string;
+}
+/** Query string for listing credentials filtered by owner and kind. */
+export declare function agentAuthCredentialQuery(options: {
+    ownerType: string;
+    ownerId: string;
+    kind: string;
+    pageSize?: number;
+    cursor?: string;
+}): string;
+export declare function agentAuthHeaders(config: AgentAuthHttpConfig): Record<string, string>;
+/** One Agent Auth HTTP call: no redirects, bounded timeout, JSON body. */
+export declare function requestAgentAuthJson(options: {
+    url: string;
+    init?: Omit<RequestInit, "headers" | "signal">;
+    config: AgentAuthHttpConfig;
+    timeoutMs: number;
+    fetchImpl: typeof fetch;
+}): Promise<{
+    ok: boolean;
+    status: number;
+    body: Record<string, unknown>;
+}>;
+export interface AgentAuthContext {
+    baseUrl: string;
+    /** Deployment id, passed to oauth-authorization-sessions as `agent_id`. */
+    agentId: string;
+    /** Authenticated caller, used as `owner_id` for user credentials. */
+    principalId: string;
+    apiKey?: string;
+    workspaceId?: string;
+}
+/** One credential slug the caller has not granted, with its connect URL. */
+export interface PendingAuthorization {
+    slug: string;
+    connectUrl: string;
+    authId: string;
+}
+export declare class CredentialAuthorizationRequiredError extends Error {
+    readonly slugs: readonly string[];
+    readonly name = "CredentialAuthorizationRequiredError";
+    constructor(slugs: readonly string[]);
+}
+export declare class AgentAuthUnknownProviderError extends Error {
+    readonly slug: string;
+    readonly name = "AgentAuthUnknownProviderError";
+    constructor(slug: string);
+}
+export declare const AGENT_AUTH_PROBLEM_HINT_MAX_CHARS = 200;
+/**
+ * The problem+json fields Agent Auth reserves for the caller: `detail` names
+ * the failure and `remedy` names the fix. Nothing else from a response body is
+ * read, because the rest can quote secret material.
+ *
+ * Both are collapsed to one line and truncated so a long or multi-line body
+ * cannot reshape an error message.
+ */
+export declare function agentAuthProblemHint(body: Record<string, unknown> | undefined): string | undefined;
+/**
+ * Agent Auth could not answer. Callers pass a fixed message; the only part of
+ * a response body that reaches it is the allow-listed problem+json hint, since
+ * an arbitrary body can quote secret material.
+ */
+export declare class CredentialStoreError extends Error {
+    readonly status?: number | undefined;
+    readonly name: string;
+    constructor(message: string, status?: number | undefined, problem?: Record<string, unknown>);
+}
+/** The error for a declared slug that has no workspace connection row. */
+export declare function missingWorkspaceConnectionError(slug: string): CredentialStoreError;
+/**
+ * Read the slug back out of a missing-connection message.
+ *
+ * A run that fails in the gate reaches a channel as a plain string, so this is
+ * the only way back to the slug. It must move with the message it parses.
+ */
+export declare function missingWorkspaceConnectionSlug(text: string): string | undefined;
+export interface WorkspaceConnection {
+    connectionId: string;
+    kind: string;
+    ownerPolicy: string;
+}
+/**
+ * Bound Agent Auth HTTP client. One instance per caller/run; headers, origin,
+ * and the request timeout stay on the instance rather than each call site.
+ */
+export declare class AgentAuth {
+    #private;
+    readonly context: AgentAuthContext;
+    constructor(context: AgentAuthContext, fetchImpl?: typeof fetch, timeoutMs?: number);
+    /** List workspace connections and return the row for `slug`, if any. */
+    findWorkspaceConnection(slug: string): Promise<WorkspaceConnection | undefined>;
+    /** Workspace credential id for an agent-owned opaque secret grant. */
+    findWorkspaceCredentialId(slug: string): Promise<string | undefined>;
+    /**
+     * Resolve the credential id for a secret connection row.
+     *
+     * Agent-owned connection declarations scope the credential to this
+     * deployment. Workspace-owned credentials are deliberately not visible to
+     * deployments.
+     */
+    findSecretCredentialId(connection: WorkspaceConnection, slug: string): Promise<string | undefined>;
+    /** Read a caller-owned opaque secret grant for a workspace connection slug. */
+    readUserSecret(slug: string): Promise<string | undefined>;
+    /** Read a caller-owned opaque secret when the connection row is already loaded. */
+    readUserSecretForConnection(connection: WorkspaceConnection): Promise<string | undefined>;
+    /** Read an OAuth access token stored on a workspace connection row. */
+    readConnectionAccessToken(connectionId: string): Promise<string | undefined>;
+    /**
+     * Read the caller's OAuth access token for a slug without starting a session.
+     *
+     * Reads never mint, so a caller can be probed repeatedly — on every replay of
+     * an interrupted node, for instance — without leaving authorization sessions
+     * behind.
+     *
+     * @returns The access token, or `undefined` when the caller must connect.
+     */
+    readUserAccessToken(slug: string): Promise<string | undefined>;
+    /** Read a caller OAuth token when the connection row is already loaded. */
+    readUserAccessTokenForConnection(connection: WorkspaceConnection): Promise<string | undefined>;
+    /**
+     * Start an OAuth authorization session for a slug the caller has not granted.
+     *
+     * @returns The pending session, including the user-facing connect URL.
+     */
+    startAuthorizationSession(slug: string): Promise<PendingAuthorization>;
+    /** oauth-providers has no slug filter, so the match is made across pages. */
+    resolveOAuthProviderId(slug: string): Promise<string>;
+    /** The credential key is `credential_id`, never `id`. */
+    findCredentialId(options: {
+        ownerType: string;
+        ownerId: string;
+        kind: string;
+        slug: string;
+    }): Promise<string | undefined>;
+    /** @returns The secret, or `undefined` when Agent Auth has no value (404). */
+    readSecret(credentialId: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=agent-auth.d.ts.map

package/dist/agent-auth.d.ts.map

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

package/dist/agent-auth.js

@@ -0,0 +1,441 @@
+/**
+ * Agent Auth client used by `credentials.get` and the pre-run credential gate.
+ *
+ * Talks to the shipped Agent Auth APIs (credentials + oauth-authorization-sessions),
+ * not the aspirational `credentials/mint` endpoint.
+ */
+import { fetchWithTimeout } from "./runtime/http.js";
+export const AGENT_AUTH_TIMEOUT_MS = 10_000;
+export const AGENT_AUTH_PROVIDER_PAGE_SIZE = 100;
+export const AGENT_AUTH_MAX_PROVIDER_PAGES = 20;
+/** Query string for listing credentials filtered by owner and kind. */
+export function agentAuthCredentialQuery(options) {
+    const params = new URLSearchParams({
+        owner_type: options.ownerType,
+        owner_id: options.ownerId,
+        kind: options.kind,
+    });
+    if (options.pageSize !== undefined) {
+        params.set("page_size", String(options.pageSize));
+    }
+    if (options.cursor) {
+        params.set("cursor", options.cursor);
+    }
+    return params.toString();
+}
+export function agentAuthHeaders(config) {
+    const headers = {
+        accept: "application/json",
+        "content-type": "application/json",
+        "x-langsmith-product": "mda",
+    };
+    const apiKey = config.apiKey?.trim();
+    if (apiKey) {
+        headers["x-api-key"] = apiKey;
+    }
+    const workspaceId = config.workspaceId?.trim();
+    if (workspaceId) {
+        headers["x-tenant-id"] = workspaceId;
+    }
+    return headers;
+}
+/** One Agent Auth HTTP call: no redirects, bounded timeout, JSON body. */
+export async function requestAgentAuthJson(options) {
+    const response = await fetchWithTimeout(options.url, {
+        ...options.init,
+        redirect: "error",
+        headers: agentAuthHeaders(options.config),
+    }, options.timeoutMs, options.fetchImpl);
+    const decoded = await response.json().catch(() => ({}));
+    return {
+        ok: response.ok,
+        status: response.status,
+        body: decoded && typeof decoded === "object"
+            ? decoded
+            : {},
+    };
+}
+export class CredentialAuthorizationRequiredError extends Error {
+    slugs;
+    name = "CredentialAuthorizationRequiredError";
+    constructor(slugs) {
+        super(`the caller has not connected: ${slugs.join(", ")}. ` +
+            "Declare the credential on a connector so the pre-run gate can request it.");
+        this.slugs = slugs;
+    }
+}
+export class AgentAuthUnknownProviderError extends Error {
+    slug;
+    name = "AgentAuthUnknownProviderError";
+    constructor(slug) {
+        super(`Agent Auth has no OAuth provider registered for slug "${slug}". ` +
+            "Register the provider or fix the credential slug.");
+        this.slug = slug;
+    }
+}
+export const AGENT_AUTH_PROBLEM_HINT_MAX_CHARS = 200;
+/**
+ * The problem+json fields Agent Auth reserves for the caller: `detail` names
+ * the failure and `remedy` names the fix. Nothing else from a response body is
+ * read, because the rest can quote secret material.
+ *
+ * Both are collapsed to one line and truncated so a long or multi-line body
+ * cannot reshape an error message.
+ */
+export function agentAuthProblemHint(body) {
+    const seen = new Set();
+    for (const field of ["detail", "remedy"]) {
+        const value = body?.[field];
+        if (typeof value !== "string")
+            continue;
+        const text = value.replace(/\s+/gu, " ").trim();
+        if (text)
+            seen.add(text);
+    }
+    if (seen.size === 0)
+        return undefined;
+    const hint = [...seen].join(" ");
+    const chars = [...hint];
+    return chars.length > AGENT_AUTH_PROBLEM_HINT_MAX_CHARS
+        ? `${chars.slice(0, AGENT_AUTH_PROBLEM_HINT_MAX_CHARS).join("")}...`
+        : hint;
+}
+/**
+ * Agent Auth could not answer. Callers pass a fixed message; the only part of
+ * a response body that reaches it is the allow-listed problem+json hint, since
+ * an arbitrary body can quote secret material.
+ */
+export class CredentialStoreError extends Error {
+    status;
+    name = "CredentialStoreError";
+    constructor(message, status, problem) {
+        const withStatus = status === undefined ? message : `${message} (status ${status})`;
+        const hint = agentAuthProblemHint(problem);
+        super(hint === undefined ? withStatus : `${withStatus}: ${hint}`);
+        this.status = status;
+    }
+}
+/** Each runtime quotes the slug its own way: `JSON.stringify` here, `repr()` in PyPI. */
+const MISSING_WORKSPACE_CONNECTION = /workspace connection ['"]([A-Za-z0-9][A-Za-z0-9._-]*)['"] is not configured/u;
+/** The error for a declared slug that has no workspace connection row. */
+export function missingWorkspaceConnectionError(slug) {
+    return new CredentialStoreError(`workspace connection ${JSON.stringify(slug)} is not configured`);
+}
+/**
+ * Read the slug back out of a missing-connection message.
+ *
+ * A run that fails in the gate reaches a channel as a plain string, so this is
+ * the only way back to the slug. It must move with the message it parses.
+ */
+export function missingWorkspaceConnectionSlug(text) {
+    return MISSING_WORKSPACE_CONNECTION.exec(text)?.[1];
+}
+/**
+ * Bound Agent Auth HTTP client. One instance per caller/run; headers, origin,
+ * and the request timeout stay on the instance rather than each call site.
+ */
+export class AgentAuth {
+    context;
+    #fetchImpl;
+    #timeoutMs;
+    constructor(context, fetchImpl = fetch, timeoutMs = AGENT_AUTH_TIMEOUT_MS) {
+        this.context = context;
+        this.#fetchImpl = fetchImpl;
+        this.#timeoutMs = timeoutMs;
+    }
+    /** List workspace connections and return the row for `slug`, if any. */
+    async findWorkspaceConnection(slug) {
+        if (!this.context.workspaceId?.trim()) {
+            throw new CredentialStoreError("connections are not configured: LANGSMITH_WORKSPACE_ID is not set");
+        }
+        let cursor;
+        for (let page = 0; page < AGENT_AUTH_MAX_PROVIDER_PAGES; page += 1) {
+            const params = new URLSearchParams({
+                page_size: String(AGENT_AUTH_PROVIDER_PAGE_SIZE),
+            });
+            if (cursor) {
+                params.set("cursor", cursor);
+            }
+            const { ok, status, body } = await this.#request(`/v1/agent-auth/connections?${params.toString()}`, { method: "GET" });
+            if (!ok) {
+                throw new CredentialStoreError("Agent Auth list connections failed", status, body);
+            }
+            const items = Array.isArray(body.items) ? body.items : [];
+            const match = items.find((item) => !!item &&
+                typeof item === "object" &&
+                String(item.slug) === slug);
+            if (match) {
+                const connectionId = String(match.id ?? match.connection_id ?? match.credential_id ?? "");
+                const kind = connectionCredentialKind(match);
+                const ownerPolicy = typeof match.owner_policy === "string" ? match.owner_policy : "";
+                if (!connectionId || !kind) {
+                    throw new CredentialStoreError("Agent Auth connection row missing id or kind");
+                }
+                return { connectionId, kind, ownerPolicy };
+            }
+            const next = body.next_cursor;
+            if (typeof next !== "string" || !next || next === cursor) {
+                return undefined;
+            }
+            cursor = next;
+        }
+        throw new CredentialStoreError("Agent Auth connection list returned too many pages");
+    }
+    /** Workspace credential id for an agent-owned opaque secret grant. */
+    async findWorkspaceCredentialId(slug) {
+        const connection = await this.findWorkspaceConnection(slug);
+        if (!connection) {
+            return undefined;
+        }
+        return await this.findSecretCredentialId(connection, slug);
+    }
+    /**
+     * Resolve the credential id for a secret connection row.
+     *
+     * Agent-owned connection declarations scope the credential to this
+     * deployment. Workspace-owned credentials are deliberately not visible to
+     * deployments.
+     */
+    async findSecretCredentialId(connection, slug) {
+        if (connection.kind !== "secret") {
+            return undefined;
+        }
+        const fromAgent = await this.#credentialIdForOwner(connection.connectionId, "agent", this.context.agentId);
+        if (fromAgent) {
+            return fromAgent;
+        }
+        const listedAgent = await this.findCredentialId({
+            ownerType: "agent",
+            ownerId: this.context.agentId,
+            kind: "secret",
+            slug,
+        });
+        return listedAgent;
+    }
+    /**
+     * Read credential_id from GET /connections/{id}?credential_owner_*.
+     *
+     * Deployments authenticate with `LANGSMITH_API_KEY` (the minted
+     * service-account key). User and workspace owners additionally require
+     * workspace management permission.
+     */
+    async #credentialIdForOwner(connectionId, ownerType, ownerId) {
+        const params = new URLSearchParams({
+            credential_owner_type: ownerType,
+            credential_owner_id: ownerId,
+        });
+        const { ok, status, body } = await this.#request(`/v1/agent-auth/connections/${encodeURIComponent(connectionId)}?${params.toString()}`, { method: "GET" });
+        if (status === 404) {
+            return undefined;
+        }
+        if (!ok) {
+            throw new CredentialStoreError(status === 403
+                ? "Agent Auth get connection for owner failed (forbidden)"
+                : "Agent Auth get connection for owner failed", status, body);
+        }
+        return connectionCredentialId(body);
+    }
+    /** Read a caller-owned opaque secret grant for a workspace connection slug. */
+    async readUserSecret(slug) {
+        const connection = await this.findWorkspaceConnection(slug);
+        if (!connection) {
+            return undefined;
+        }
+        return await this.readUserSecretForConnection(connection);
+    }
+    /** Read a caller-owned opaque secret when the connection row is already loaded. */
+    async readUserSecretForConnection(connection) {
+        if (connection.kind !== "secret") {
+            return undefined;
+        }
+        const credentialId = await this.#credentialIdForOwner(connection.connectionId, "user", this.context.principalId);
+        if (!credentialId) {
+            return undefined;
+        }
+        return await this.readSecret(credentialId);
+    }
+    /** Read an OAuth access token stored on a workspace connection row. */
+    async readConnectionAccessToken(connectionId) {
+        return await this.#fetchAccessToken(connectionId);
+    }
+    /**
+     * Read the caller's OAuth access token for a slug without starting a session.
+     *
+     * Reads never mint, so a caller can be probed repeatedly — on every replay of
+     * an interrupted node, for instance — without leaving authorization sessions
+     * behind.
+     *
+     * @returns The access token, or `undefined` when the caller must connect.
+     */
+    async readUserAccessToken(slug) {
+        const connection = await this.findWorkspaceConnection(slug);
+        if (!connection) {
+            return undefined;
+        }
+        return await this.readUserAccessTokenForConnection(connection);
+    }
+    /** Read a caller OAuth token when the connection row is already loaded. */
+    async readUserAccessTokenForConnection(connection) {
+        if (connection.kind !== "oauth2") {
+            return undefined;
+        }
+        const credentialId = await this.#credentialIdForOwner(connection.connectionId, "user", this.context.principalId);
+        if (!credentialId)
+            return undefined;
+        return await this.#fetchAccessToken(credentialId);
+    }
+    /**
+     * Start an OAuth authorization session for a slug the caller has not granted.
+     *
+     * @returns The pending session, including the user-facing connect URL.
+     */
+    async startAuthorizationSession(slug) {
+        const connection = await this.findWorkspaceConnection(slug);
+        if (!connection) {
+            throw missingWorkspaceConnectionError(slug);
+        }
+        if (connection.kind !== "oauth2") {
+            throw new CredentialStoreError(`connection ${JSON.stringify(slug)} is not an OAuth connection`);
+        }
+        const { ok, status, body } = await this.#request("/v1/agent-auth/oauth-authorization-sessions", {
+            method: "POST",
+            body: JSON.stringify({
+                connection_id: connection.connectionId,
+                principal_id: this.context.principalId,
+                agent_id: this.context.agentId,
+            }),
+        });
+        if (!ok) {
+            throw new CredentialStoreError("Agent Auth create oauth-authorization-session failed", status, body);
+        }
+        const authId = String(body.id ?? "");
+        const connectUrl = String(body.verification_url ?? "");
+        if (!authId || !connectUrl) {
+            throw new CredentialStoreError("Agent Auth oauth-authorization-session missing id or verification_url");
+        }
+        return { slug, connectUrl, authId };
+    }
+    /** oauth-providers has no slug filter, so the match is made across pages. */
+    async resolveOAuthProviderId(slug) {
+        let cursor;
+        for (let page = 0; page < AGENT_AUTH_MAX_PROVIDER_PAGES; page += 1) {
+            const params = new URLSearchParams({
+                page_size: String(AGENT_AUTH_PROVIDER_PAGE_SIZE),
+            });
+            if (cursor)
+                params.set("cursor", cursor);
+            const { ok, status, body } = await this.#request(`/v1/agent-auth/oauth-providers?${params.toString()}`, { method: "GET" });
+            if (!ok) {
+                throw new CredentialStoreError("Agent Auth list oauth-providers failed", status, body);
+            }
+            const items = Array.isArray(body.items) ? body.items : [];
+            const match = items.find((item) => !!item &&
+                typeof item === "object" &&
+                String(item.slug) === slug);
+            if (match?.id) {
+                return String(match.id);
+            }
+            const next = body.next_cursor;
+            if (typeof next !== "string" || !next || next === cursor) {
+                throw new AgentAuthUnknownProviderError(slug);
+            }
+            cursor = next;
+        }
+        throw new CredentialStoreError("Agent Auth oauth-provider list returned too many pages");
+    }
+    /** The credential key is `credential_id`, never `id`. */
+    async findCredentialId(options) {
+        let cursor;
+        for (let page = 0; page < AGENT_AUTH_MAX_PROVIDER_PAGES; page += 1) {
+            const { ok, status, body } = await this.#request(`/v1/agent-auth/credentials?${agentAuthCredentialQuery({
+                ownerType: options.ownerType,
+                ownerId: options.ownerId,
+                kind: options.kind,
+                pageSize: AGENT_AUTH_PROVIDER_PAGE_SIZE,
+                cursor,
+            })}`, { method: "GET" });
+            if (!ok) {
+                throw new CredentialStoreError("Agent Auth list credentials failed", status, body);
+            }
+            const items = Array.isArray(body.items) ? body.items : [];
+            const match = items.find((item) => !!item &&
+                typeof item === "object" &&
+                String(item.slug) === options.slug);
+            const id = match?.credential_id;
+            if (typeof id === "string" && id) {
+                return id;
+            }
+            const next = body.next_cursor;
+            if (typeof next !== "string" || !next || next === cursor) {
+                return undefined;
+            }
+            cursor = next;
+        }
+        throw new CredentialStoreError("Agent Auth credential list returned too many pages");
+    }
+    /** @returns The secret, or `undefined` when Agent Auth has no value (404). */
+    async readSecret(credentialId) {
+        const { ok, status, body } = await this.#request(`/v1/agent-auth/credentials/${encodeURIComponent(credentialId)}/secret`, { method: "GET" });
+        if (status === 404) {
+            return undefined;
+        }
+        if (!ok) {
+            throw new CredentialStoreError("Agent Auth get secret failed", status, body);
+        }
+        const secret = body.secret;
+        return typeof secret === "string" && secret.length > 0 ? secret : undefined;
+    }
+    async #fetchAccessToken(credentialId) {
+        const { ok, status, body } = await this.#request(`/v1/agent-auth/credentials/${encodeURIComponent(credentialId)}/oauth2`, { method: "GET" });
+        if (isAuthorizationRequired(status, body)) {
+            return undefined;
+        }
+        if (!ok) {
+            throw new CredentialStoreError("Agent Auth get oauth2 failed", status, body);
+        }
+        const oauth2 = body.oauth2 && typeof body.oauth2 === "object"
+            ? body.oauth2
+            : body;
+        const token = oauth2.access_token;
+        return typeof token === "string" && token ? token : undefined;
+    }
+    async #request(path, init = {}) {
+        return await requestAgentAuthJson({
+            url: `${this.context.baseUrl}${path}`,
+            init,
+            config: this.context,
+            timeoutMs: this.#timeoutMs,
+            fetchImpl: this.#fetchImpl,
+        });
+    }
+}
+/** Agent Auth answers 409 when a stored grant has lapsed and needs re-auth. */
+function isAuthorizationRequired(status, body) {
+    if (status !== 409) {
+        return false;
+    }
+    const detail = String(body.detail ?? body.title ?? body.error ?? "").toLowerCase();
+    return (body.error === "authorization_required" ||
+        detail.includes("authorization is required") ||
+        detail.includes("oauth authorization"));
+}
+/** Prefer nested `credential.kind`; accept legacy top-level `kind`. */
+function connectionCredentialKind(item) {
+    const credential = item.credential;
+    if (credential && typeof credential === "object") {
+        const kind = credential.kind;
+        if (typeof kind === "string" && kind) {
+            return kind;
+        }
+    }
+    return typeof item.kind === "string" ? item.kind : "";
+}
+function connectionCredentialId(body) {
+    const credential = body.credential;
+    if (!credential || typeof credential !== "object") {
+        return undefined;
+    }
+    const id = credential.credential_id;
+    return typeof id === "string" && id ? id : undefined;
+}
+//# sourceMappingURL=agent-auth.js.map

package/dist/agent-auth.js.map

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