managed-deepagents 0.6.2-dev.12 → 0.6.2-dev.14

package/dist/agent-auth.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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 that addresses one credential by its natural key. */
+export declare function agentAuthCredentialQuery(options: {
+    ownerType: string;
+    ownerId: string;
+    kind: string;
+    slug: 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);
+}
+/**
+ * Agent Auth could not answer. Callers pass a fixed message: a response body
+ * can quote secret material, so it never reaches this error.
+ */
+export declare class CredentialStoreError extends Error {
+    readonly status?: number | undefined;
+    readonly name = "CredentialStoreError";
+    constructor(message: string, status?: number | undefined);
+}
+/**
+ * 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);
+    /**
+     * 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>;
+    /**
+     * 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,224 @@
+/**
+ * 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 that addresses one credential by its natural key. */
+export function agentAuthCredentialQuery(options) {
+    return new URLSearchParams({
+        owner_type: options.ownerType,
+        owner_id: options.ownerId,
+        kind: options.kind,
+        slug: options.slug,
+    }).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;
+    }
+}
+/**
+ * Agent Auth could not answer. Callers pass a fixed message: a response body
+ * can quote secret material, so it never reaches this error.
+ */
+export class CredentialStoreError extends Error {
+    status;
+    name = "CredentialStoreError";
+    constructor(message, status) {
+        super(status === undefined ? message : `${message} (status ${status})`);
+        this.status = status;
+    }
+}
+/**
+ * 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;
+    }
+    /**
+     * 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 credentialId = await this.findCredentialId({
+            ownerType: "user",
+            ownerId: this.context.principalId,
+            kind: "oauth2",
+            slug,
+        });
+        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 providerId = await this.resolveOAuthProviderId(slug);
+        const { ok, status, body } = await this.#request("/v1/agent-auth/oauth-authorization-sessions", {
+            method: "POST",
+            body: JSON.stringify({
+                provider_id: providerId,
+                principal_id: this.context.principalId,
+                agent_id: this.context.agentId,
+            }),
+        });
+        if (!ok) {
+            throw new CredentialStoreError("Agent Auth create oauth-authorization-session failed", status);
+        }
+        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);
+            }
+            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) {
+        const { ok, status, body } = await this.#request(`/v1/agent-auth/credentials?${agentAuthCredentialQuery(options)}`, { method: "GET" });
+        if (!ok) {
+            throw new CredentialStoreError("Agent Auth list credentials failed", status);
+        }
+        const [row] = Array.isArray(body.items) ? body.items : [];
+        const id = row?.credential_id;
+        return typeof id === "string" ? id : undefined;
+    }
+    /** @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);
+        }
+        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);
+        }
+        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"));
+}
+//# 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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"}

package/dist/connectors/mcp/index.d.ts

@@ -18,7 +18,7 @@
  * @example
  * ```ts
  * // connectors/mcp.ts
- * import { connectors } from "managed-deepagents";
+ * import { connectors, credentials } from "managed-deepagents";
  *
  * export const connector = connectors.mcp({
  *   mcpServers: {
@@ -26,102 +26,42 @@
  *       transport: "http",
  *       url: "https://docs.example.com/mcp",
  *     },
+ *     notion: {
+ *       transport: "http",
+ *       url: "https://mcp.notion.com/mcp",
+ *       credential: credentials.get("notion", { type: "user" }),
+ *     },
  *   },
  * });
  * ```
  */
-import type { Connector } from "../../runtime/connector.js";
-/** Per-server MCP tool selection. Names are raw, unprefixed MCP tool names. */
-export interface McpToolSelectionConfig {
-    /**
-     * Raw MCP tool names to expose from this server. Names are matched before any
-     * managed `{server}__` prefix is applied.
-     */
-    includeTools?: string[];
-    /**
-     * Raw MCP tool names to hide from this server. Names are matched before any
-     * managed `{server}__` prefix is applied.
-     */
-    excludeTools?: string[];
-}
-/** Shared options for all remote MCP server connections. */
-export interface RemoteMcpServerBaseConfig extends McpToolSelectionConfig {
-    /** URL of the remote MCP server endpoint. */
-    url: string;
-    /** Optional static headers sent when connecting to the MCP server. */
-    headers?: Record<string, string>;
-    /** Default timeout, in milliseconds, for tools loaded from this server. */
-    defaultToolTimeout?: number;
-}
-/** Streamable HTTP MCP server connection. */
-export interface HttpMcpServerConfig extends RemoteMcpServerBaseConfig {
-    /** Remote transport. `"http"` selects Streamable HTTP. */
-    transport: "http";
-    /**
-     * Whether the client may fall back to SSE if the server does not support
-     * Streamable HTTP. Defaults to the behavior of `@langchain/mcp-adapters`.
-     */
-    automaticSSEFallback?: boolean;
-}
-/** Legacy SSE MCP server connection. */
-export interface SseMcpServerConfig extends RemoteMcpServerBaseConfig {
-    /** Remote transport. `"sse"` selects legacy SSE. */
-    transport: "sse";
-    /** Reconnection behavior for SSE MCP servers. */
-    reconnect?: {
-        enabled: boolean;
-        maxAttempts?: number;
-        delayMs?: number;
-    };
-}
-/** A remote MCP server connection. Stdio servers are intentionally excluded. */
-export type RemoteMcpServerConfig = HttpMcpServerConfig | SseMcpServerConfig;
-/** Configuration accepted by `connectors.mcp`. */
-export interface McpServersConfig {
-    /**
-     * MCP servers to connect to. Each key is the logical server name MDA uses
-     * for validation, tracing metadata, and tool-name prefixing.
-     */
-    mcpServers: Record<string, RemoteMcpServerConfig>;
-    /**
-     * Whether tool names should be prefixed with the MCP server name (e.g.
-     * `docs__search`). Defaults to `true`, which avoids collisions between
-     * authored tools and common MCP tool names like `search` or `read`.
-     */
-    prefixToolNameWithServerName?: boolean;
-    /**
-     * Whether tool loading should fail if a tool cannot be loaded. Defaults to
-     * `true` — a managed deployment should fail rather than start with a
-     * partially loaded tool surface.
-     */
-    throwOnLoadError?: boolean;
-    /**
-     * Whether MCP tool outputs should be converted to LangChain standard content
-     * blocks. Defaults to `true` for new managed agents.
-     */
-    useStandardContentBlocks?: boolean;
-    /**
-     * Behavior when an MCP server cannot be connected. Only `"throw"` is
-     * supported for the POC — a failed connection fails the deployment.
-     */
-    onConnectionError?: "throw";
-}
+import type { CredentialConsumer, LoadedCredentialTools } from "../../credential-gate.js";
+import type { McpServersConfig, McpServersDefinition } from "./types.js";
+export type * from "./types.js";
+/**
+ * Load (and cache) the MCP tools for one connector declaration.
+ *
+ * A failed load is never cached, so a transient connection error on the first
+ * run can be retried on the next, but a misconfigured deployment surfaces the
+ * error rather than silently starting with no tools.
+ */
+export declare function loadManagedMcpTools(connectors: McpServersDefinition): Promise<unknown[]>;
+/** Clear the process-level MCP tool cache. Test-only. */
+export declare function clearManagedMcpToolsCacheForTests(connectors?: McpServersDefinition): void;
 /**
- * The connector exported from a `connectors/` module for MCP. It is a branded
- * managed {@link Connector} whose `tools` hook loads the declared MCP tools at
- * runtime, plus the raw config the loader reads.
+ * The credential gate's view of the declared MCP connectors.
+ *
+ * One consumer per declaration that names a user-owned credential; a
+ * declaration that needs no grant never reaches the gate.
  */
-export interface McpServersDefinition extends McpServersConfig, Connector {
-    /** Internal discriminator used by the MDA loader. */
-    readonly kind: "mcp_servers";
-}
+export declare function mcpCredentialConsumers(connectors: readonly unknown[] | undefined): CredentialConsumer[];
 /**
- * Declare the MCP servers whose tools should be loaded and added to the managed
- * Deep Agent at runtime.
+ * Load tools for user-credential servers, once the gate has confirmed the
+ * caller's grants.
  *
- * The tools hook runs at agent-graph construction time (inside the managed
- * runtime), so the MCP client loader is imported lazily — authoring-only
- * installs never pull in `@langchain/mcp-adapters`.
+ * Not process-cached here: the Authorization header is per caller, so the gate
+ * owns both the cache and closing the returned transport.
  */
+export declare function loadUserCredentialMcpTools(connectors: McpServersDefinition, accessTokens: ReadonlyMap<string, string>): Promise<LoadedCredentialTools>;
 export declare const mcpConnector: (config: McpServersConfig) => McpServersDefinition;
 //# sourceMappingURL=index.d.ts.map

package/dist/connectors/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,4DAA4D;AAC5D,MAAM,WAAW,yBAA0B,SAAQ,sBAAsB;IACvE,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAoB,SAAQ,yBAAyB;IACpE,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB;IACnE,oDAAoD;IACpD,SAAS,EAAE,KAAK,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE7E,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB,EAAE,SAAS;IACvE,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAqDD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,oBASrD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAUH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAEpB,mBAAmB,YAAY,CAAC;AAkBhC;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAWpB;AAED,yDAAyD;AACzD,wBAAgB,iCAAiC,CAC/C,UAAU,CAAC,EAAE,oBAAoB,GAChC,IAAI,CAMN;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GACzC,kBAAkB,EAAE,CAuBtB;AAoCD;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,oBAAoB,EAChC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAyBhC;AAsKD,eAAO,MAAM,YAAY,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,oBAMrD,CAAC"}