managed-deepagents 0.1.0 → 0.3.0

package/dist/runtime/validated-token.js

@@ -0,0 +1,411 @@
+import { HTTPException } from "@langchain/langgraph-sdk/auth";
+import { createRemoteJWKSet, decodeJwt, jwtVerify, SignJWT, } from "jose";
+/** Issuer stamped on MDA-minted guest tokens, used to route them at selection. */
+const GUEST_ISSUER = "mda:guest";
+/** Deployment env var carrying the HS256 key MDA signs/verifies guest tokens with. */
+const GUEST_KEY_ENV = "MDA_GUEST_SIGNING_KEY";
+/** Remote JWKS key sets, cached per resolved JWKS URI for the process lifetime. */
+const jwksCache = new Map();
+/** OIDC `discover` results (issuer or discovery base → jwks_uri). */
+const discoverCache = new Map();
+/** OIDC discovery base → issuer. */
+const oidcIssuerCache = new Map();
+/**
+ * Resolve the caller identity for the `validated_token` ingress mode: pick
+ * the provider by token issuer, verify the token (JWKS / introspection / guest),
+ * then map its claims into the identity envelope. Fail-closed (401) throughout.
+ *
+ * OIDC discovery runs only for the selected provider, or for issuer matching
+ * when no provider is identifiable from already-known config. A discovery
+ * outage on an unrelated provider does not block authentication.
+ */
+export async function resolveValidatedTokenUser(cfg, ingress, request) {
+    const token = bearerToken(request);
+    const provider = await resolveProvider(ingress.providers, token);
+    const claims = await verifyProviderClaims(provider, token, request.headers);
+    const user = claimsToUser(provider, claims);
+    if (cfg.tenancy === "multi" && !user.mda_tenant_id) {
+        throw new HTTPException(401, {
+            message: "missing tenant for multi-tenant deployment",
+        });
+    }
+    return user;
+}
+/**
+ * Select the provider for `token`, materializing OIDC discovery only when
+ * needed. Prefer providers whose issuer/guest type is already known so a
+ * custom-domain discovery outage cannot block unrelated auth (e.g. guest).
+ *
+ * @param providers - Declared validated-token providers.
+ * @param token - Bearer token from the request.
+ * @returns The selected provider, with discovery applied when required.
+ */
+export async function resolveProvider(providers, token) {
+    const known = trySelectKnownProvider(providers, token);
+    if (known) {
+        return materializeProvider(known);
+    }
+    const prepared = await Promise.all(providers.map(async (provider) => {
+        try {
+            return await materializeProvider(provider);
+        }
+        catch {
+            // Keep the undeclared provider so other entries can still match.
+            return provider;
+        }
+    }));
+    return selectProvider(prepared, token);
+}
+/**
+ * Resolve `discoveryUrl` providers to concrete `issuer` + `jwks`.
+ * Fail-fast: any discovery error rejects the whole list (for explicit
+ * materialization). Prefer {@link resolveProvider} at request time.
+ */
+export async function materializeProviders(providers) {
+    return Promise.all(providers.map((provider) => materializeProvider(provider)));
+}
+async function materializeProvider(provider) {
+    const discoveryUrl = provider.discoveryUrl;
+    if (!discoveryUrl) {
+        return provider;
+    }
+    if (provider.issuer && (provider.jwks || provider.introspect)) {
+        return provider;
+    }
+    const discovered = await discoverOidc(discoveryUrl);
+    return {
+        ...provider,
+        issuer: discovered.issuer,
+        ...(provider.jwks || provider.introspect ? {} : { jwks: discovered.jwks }),
+    };
+}
+async function discoverOidc(authBase) {
+    const base = authBase.replace(/\/$/, "");
+    const cachedIssuer = oidcIssuerCache.get(base);
+    const cachedJwks = discoverCache.get(base);
+    if (cachedIssuer && cachedJwks) {
+        return { issuer: cachedIssuer, jwks: cachedJwks };
+    }
+    const response = await fetch(`${base}/.well-known/openid-configuration`);
+    if (!response.ok) {
+        throw new HTTPException(401, {
+            message: "failed to resolve OIDC configuration",
+        });
+    }
+    const config = (await response.json());
+    if (!config.issuer) {
+        throw new HTTPException(401, {
+            message: "OIDC configuration has no issuer",
+        });
+    }
+    if (!config.jwks_uri) {
+        throw new HTTPException(401, {
+            message: "OIDC configuration has no jwks_uri",
+        });
+    }
+    oidcIssuerCache.set(base, config.issuer);
+    discoverCache.set(base, config.jwks_uri);
+    discoverCache.set(config.issuer, config.jwks_uri);
+    return { issuer: config.issuer, jwks: config.jwks_uri };
+}
+/** Extract the bearer token from the `Authorization` header, or 401. */
+export function bearerToken(request) {
+    const header = request.headers.get("authorization") ?? "";
+    const match = /^Bearer\s+(.+)$/i.exec(header);
+    const token = match?.[1];
+    if (!token) {
+        throw new HTTPException(401, { message: "missing bearer token" });
+    }
+    return token.trim();
+}
+function providerAcceptsIssuer(provider, issuer) {
+    if (provider.issuer === issuer) {
+        return true;
+    }
+    return Boolean(provider.issuers?.includes(issuer));
+}
+function configuredIssuers(providers) {
+    const configured = [];
+    const seen = new Set();
+    for (const provider of providers) {
+        for (const value of [provider.issuer, ...(provider.issuers ?? [])]) {
+            if (value && !seen.has(value)) {
+                seen.add(value);
+                configured.push(value);
+            }
+        }
+    }
+    return configured;
+}
+/**
+ * Select a provider using only already-known issuer/guest/introspect config.
+ * Returns `undefined` when selection needs OIDC discovery (e.g. custom-domain
+ * Supabase whose JWT `iss` is not yet on the provider).
+ *
+ * @param providers - Declared validated-token providers.
+ * @param token - Bearer token from the request.
+ * @returns A matching provider, or `undefined` when discovery is required.
+ */
+function trySelectKnownProvider(providers, token) {
+    const [only] = providers;
+    if (only && providers.length === 1) {
+        return only;
+    }
+    let issuer;
+    try {
+        issuer = decodeJwt(token).iss;
+    }
+    catch {
+        const introspectProviders = providers.filter((p) => p.introspect);
+        return introspectProviders.length === 1
+            ? introspectProviders[0]
+            : undefined;
+    }
+    const match = providers.find((p) => issuer !== undefined && providerAcceptsIssuer(p, issuer));
+    if (match) {
+        return match;
+    }
+    if (issuer === GUEST_ISSUER) {
+        return providers.find((p) => p.guest);
+    }
+    return undefined;
+}
+/**
+ * Select the provider that should verify `token`. A single-provider deployment
+ * always uses its one entry. Otherwise: JWT tokens route by `iss` (guest tokens
+ * carry MDA's own issuer); opaque tokens route to the sole `introspect`
+ * provider. Fail-closed when selection is ambiguous (401).
+ *
+ * Callers that may need OIDC discovery should use {@link resolveProvider}.
+ */
+export function selectProvider(providers, token) {
+    const known = trySelectKnownProvider(providers, token);
+    if (known) {
+        return known;
+    }
+    let issuer;
+    try {
+        issuer = decodeJwt(token).iss;
+    }
+    catch {
+        const introspectProviders = providers.filter((p) => p.introspect);
+        throw new HTTPException(401, {
+            message: introspectProviders.length === 0
+                ? "malformed token"
+                : "opaque token requires exactly one introspection provider",
+        });
+    }
+    throw new HTTPException(401, {
+        message: `no provider matches token issuer ${JSON.stringify(issuer)}; configured=${JSON.stringify(configuredIssuers(providers))}`,
+    });
+}
+/** Map verified token claims into the managed user envelope, per `provider.claims`. */
+export function claimsToUser(provider, claims) {
+    const actor = claims[provider.claims.actor];
+    if (actor == null || actor === "") {
+        throw new HTTPException(401, {
+            message: `token missing actor claim "${provider.claims.actor}"`,
+        });
+    }
+    const user = {
+        identity: String(actor),
+        permissions: [],
+        mda_actor_id: String(actor),
+        mda_claims: { ...claims },
+    };
+    const tenant = provider.claims.tenant
+        ? claims[provider.claims.tenant]
+        : undefined;
+    if (tenant != null && tenant !== "") {
+        user.mda_tenant_id = String(tenant);
+    }
+    const email = provider.claims.email
+        ? claims[provider.claims.email]
+        : undefined;
+    if (email) {
+        user.mda_actor_email = String(email);
+    }
+    return user;
+}
+async function verifyProviderClaims(provider, token, headers) {
+    if (provider.introspect) {
+        return introspectClaims(provider, token, headers);
+    }
+    if (provider.guest) {
+        return verifyGuestToken(token);
+    }
+    return jwksVerifyClaims(provider, token);
+}
+async function jwksVerifyClaims(provider, token) {
+    const keySet = await providerKeySet(provider);
+    try {
+        const { payload } = await jwtVerify(token, keySet, {
+            issuer: provider.issuer,
+            audience: provider.audience,
+            algorithms: provider.algorithms ?? ["RS256"],
+        });
+        return payload;
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        if (/no applicable key|JWKS|key set|kid/i.test(detail)) {
+            throw new HTTPException(401, {
+                message: "token JWKS verification failed (empty key set or unknown kid); " +
+                    "legacy HS256 Supabase projects need providers.supabase(..., introspect: true)",
+            });
+        }
+        throw new HTTPException(401, {
+            message: "token signature verification failed",
+        });
+    }
+}
+async function providerKeySet(provider) {
+    const uri = await resolveJwksUri(provider);
+    let keySet = jwksCache.get(uri);
+    if (!keySet) {
+        keySet = createRemoteJWKSet(new URL(uri));
+        jwksCache.set(uri, keySet);
+    }
+    return keySet;
+}
+async function resolveJwksUri(provider) {
+    if (provider.jwks) {
+        return provider.jwks;
+    }
+    if (provider.discover && provider.issuer) {
+        const cached = discoverCache.get(provider.issuer);
+        if (cached) {
+            return cached;
+        }
+        const base = provider.issuer.replace(/\/$/, "");
+        const response = await fetch(`${base}/.well-known/openid-configuration`);
+        if (!response.ok) {
+            throw new HTTPException(401, {
+                message: "failed to resolve OIDC configuration",
+            });
+        }
+        const config = (await response.json());
+        if (!config.jwks_uri) {
+            throw new HTTPException(401, {
+                message: "OIDC configuration has no jwks_uri",
+            });
+        }
+        discoverCache.set(provider.issuer, config.jwks_uri);
+        return config.jwks_uri;
+    }
+    throw new HTTPException(500, {
+        message: "validated_token provider declares neither jwks nor discover",
+    });
+}
+async function introspectClaims(provider, token, headers) {
+    const introspect = provider.introspect;
+    const target = resolveIntrospection(provider, headers);
+    const requestHeaders = {};
+    // Base headers first, then the selected region's headers so a region can
+    // override the shared default (e.g. a per-region Supabase `apikey`).
+    for (const [key, value] of Object.entries(introspect.headers ?? {})) {
+        requestHeaders[key] = expandEnv(value);
+    }
+    for (const [key, value] of Object.entries(target.headers ?? {})) {
+        requestHeaders[key] = expandEnv(value);
+    }
+    if ((introspect.tokenIn ?? "authorization") === "authorization") {
+        requestHeaders.authorization = `Bearer ${token}`;
+    }
+    else {
+        requestHeaders[introspect.header ?? "authorization"] = token;
+    }
+    // Expand `${ENV}` in the endpoint so region URLs can stay deployment-driven
+    // (e.g. `${SUPABASE_EU_URL}/auth/v1/user`) rather than baked in at authoring.
+    const response = await fetch(expandEnv(target.url), {
+        headers: requestHeaders,
+    });
+    if (!response.ok) {
+        throw new HTTPException(401, { message: "token introspection failed" });
+    }
+    return (await response.json());
+}
+/**
+ * Resolve the introspection endpoint (and any region-specific headers) for the
+ * request. A single-endpoint provider uses `introspect.url`; a multi-region
+ * provider selects by the `regionHeader` value, where each region maps either to
+ * a bare URL (shared headers) or a `{ url, headers }` object carrying its own
+ * credential (e.g. a per-region Supabase `apikey`). Fail-closed (401/500).
+ */
+function resolveIntrospection(provider, headers) {
+    const introspect = provider.introspect;
+    if (introspect.url) {
+        return { url: introspect.url };
+    }
+    if (introspect.regionHeader && introspect.regions) {
+        const region = headers.get(introspect.regionHeader);
+        const entry = region ? introspect.regions[region] : undefined;
+        if (!entry) {
+            throw new HTTPException(401, {
+                message: "unknown or missing region for introspection",
+            });
+        }
+        return typeof entry === "string" ? { url: entry } : entry;
+    }
+    throw new HTTPException(500, {
+        message: "introspection provider declares neither url nor regions",
+    });
+}
+/** Verify an MDA-minted guest token (HS256, signed with the deployment key). */
+async function verifyGuestToken(token) {
+    try {
+        const { payload } = await jwtVerify(token, guestSigningKey(), {
+            issuer: GUEST_ISSUER,
+            algorithms: ["HS256"],
+        });
+        return payload;
+    }
+    catch {
+        throw new HTTPException(401, { message: "invalid guest token" });
+    }
+}
+/**
+ * Mint a short-lived guest token for an anonymous caller. Exposed for the guest
+ * issue/reissue route; the same deployment key verifies it on later calls.
+ */
+export async function issueGuestToken(provider, subject) {
+    const guest = provider.guest;
+    if (!guest?.issue) {
+        throw new HTTPException(400, {
+            message: "provider does not allow guest issuance",
+        });
+    }
+    const sub = `${guest.actorPrefix ?? ""}${subject ?? crypto.randomUUID()}`;
+    return new SignJWT({})
+        .setProtectedHeader({ alg: "HS256" })
+        .setIssuer(GUEST_ISSUER)
+        .setSubject(sub)
+        .setIssuedAt()
+        .setExpirationTime(guest.ttl ?? "24h")
+        .sign(guestSigningKey());
+}
+function guestSigningKey() {
+    const key = process.env[GUEST_KEY_ENV];
+    if (!key) {
+        throw new HTTPException(500, {
+            message: `guest tokens require ${GUEST_KEY_ENV}`,
+        });
+    }
+    return new TextEncoder().encode(key);
+}
+/**
+ * Expand `${ENV_VAR}` references. Missing variables fail closed (500) so auth
+ * misconfiguration is not mistaken for a bad caller token.
+ */
+export function expandEnv(value) {
+    return value.replace(/\$\{([A-Z0-9_]+)\}/g, (_match, name) => {
+        const resolved = process.env[name];
+        if (resolved == null || resolved === "") {
+            throw new HTTPException(500, {
+                message: `missing required environment variable ${name}`,
+            });
+        }
+        return resolved;
+    });
+}
+//# sourceMappingURL=validated-token.js.map

package/dist/runtime/validated-token.js.map

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

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { CreateDeepAgentParams } from "deepagents";
+import type { RuntimeIdentity } from "./identity/index.js";
 /**
  * Properties the managed runtime owns. Agent authors never set these — MDA
  * wires the backend, store, checkpointer, memory, skills, and system prompt at
@@ -33,6 +34,12 @@ export type DefineDeepAgentConfig = Omit<CreateDeepAgentParams, ManagedDeepAgent
      * instructions, and sandbox files still work.
      */
     disableMemory?: boolean;
+    /**
+     * Optional LangSmith/LangGraph run metadata applied after `createDeepAgent`
+     * via `.withConfig({ metadata })`. Use this for root-trace fields such as
+     * prompt provenance — nested middleware cannot reliably reach the root run.
+     */
+    metadata?: Record<string, unknown>;
 };
 /**
  * The pre-runtime spec returned by {@link defineDeepAgent}.
@@ -107,5 +114,13 @@ export interface RuntimeChannel {
  */
 export interface Runtime {
     channel: RuntimeChannel;
+    /**
+     * The frozen identity envelope for the current run, resolved at ingress.
+     *
+     * Optional because identity is opt-in: a project without an `identity.ts`
+     * runs as a service principal with no end-user scoping. Present once
+     * the deployment declares identity and the runtime seam populates it.
+     */
+    identity?: RuntimeIdentity;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,OAAO,GACP,cAAc,GACd,cAAc,GACd,QAAQ,GACR,QAAQ,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,qBAAqB,EACrB,mBAAmB,CACpB,GAAG;IACF,4EAA4E;IAC5E,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1E,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,CACF,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,cAAc,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "managed-deepagents",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Managed Deep Agents — the `defineDeepAgent` authoring interface plus the CLI that compiles and deploys a code-first Deep Agent repository to a managed LangGraph runtime.",
   "keywords": [
     "langchain",
@@ -50,16 +50,20 @@
     "node": ">=22"
   },
   "dependencies": {
+    "@langchain/langgraph-sdk": "^1.9.25",
     "@langchain/mcp-adapters": "^1.1.3",
-    "deepagents": "^1.10.4"
+    "deepagents": "^1.10.4",
+    "hono": "^4.12.28",
+    "jose": "^6.2.3",
+    "langsmith": "^0.7.16"
   },
   "optionalDependencies": {
-    "@langchain/managed-deepagents-darwin-arm64": "0.1.0",
-    "@langchain/managed-deepagents-darwin-x64": "0.1.0",
-    "@langchain/managed-deepagents-linux-arm64": "0.1.0",
-    "@langchain/managed-deepagents-linux-x64": "0.1.0",
-    "@langchain/managed-deepagents-win32-arm64": "0.1.0",
-    "@langchain/managed-deepagents-win32-x64": "0.1.0"
+    "@langchain/managed-deepagents-darwin-arm64": "0.3.0",
+    "@langchain/managed-deepagents-darwin-x64": "0.3.0",
+    "@langchain/managed-deepagents-linux-arm64": "0.3.0",
+    "@langchain/managed-deepagents-linux-x64": "0.3.0",
+    "@langchain/managed-deepagents-win32-arm64": "0.3.0",
+    "@langchain/managed-deepagents-win32-x64": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.1",