managed-deepagents 0.0.3-dev.24 → 0.0.3-dev.26

package/dist/runtime/credentials.d.ts

@@ -1,42 +0,0 @@
-import type { SandboxDefinition } from "../sandbox.js";
-/**
- * Per-provider environment variables MDA expects to hold the credentials each
- * sandbox provider needs. Keyed by the provider's `providerId` (when set) or
- * its class name.
- *
- * The value is a list of alternative credential *sets*: a provider is
- * considered credentialed if **every** variable in **any one** set is present.
- * An empty list means the provider needs no credentials (e.g. it runs locally).
- *
- * Sources: the deepagents sandbox docs and each provider's own SDK docs.
- * - LangSmith: https://docs.langchain.com/langsmith/sandboxes
- * - Daytona / E2B / Modal / Runloop / Vercel / AgentCore / Deno: provider SDK docs.
- */
-export declare const PROVIDER_CREDENTIAL_ENV_VARS: Record<string, string[][]>;
-export interface ProviderCredentialStatus {
-    /**
-     * - `available`: required credentials are present (or none are needed).
-     * - `missing`: a known provider's credentials are absent.
-     * - `unknown`: provider is not in {@link PROVIDER_CREDENTIAL_ENV_VARS}.
-     */
-    status: "available" | "missing" | "unknown";
-    /** The provider id / class name used for the lookup. */
-    provider: string;
-    /** Env vars from the primary credential set, surfaced when `missing`. */
-    missing: string[];
-}
-/**
- * Whether MDA is running under `mda dev`. The CLI sets `MDA_DEV` when it
- * launches the local LangGraph dev server; it is never set for `mda deploy`.
- */
-export declare function isDevMode(): boolean;
-/** Resolve the lookup key for a sandbox provider (its id, else class name). */
-export declare function providerKey(provider: SandboxDefinition["provider"]): string;
-/** Whether every variable in a credential set is set and non-empty. */
-export declare function credentialSetSatisfied(envVars: string[]): boolean;
-/**
- * Determine whether the configured provider's credentials are available so
- * `mda dev` can decide between the real provider and the local fallback.
- */
-export declare function providerCredentialStatus(provider: SandboxDefinition["provider"]): ProviderCredentialStatus;
-//# sourceMappingURL=credentials.d.ts.map

package/dist/runtime/credentials.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/runtime/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAsBnE,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,MAAM,CAG3E;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAEjE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACtC,wBAAwB,CAU1B"}

package/dist/runtime/credentials.js

@@ -1,69 +0,0 @@
-/**
- * Per-provider environment variables MDA expects to hold the credentials each
- * sandbox provider needs. Keyed by the provider's `providerId` (when set) or
- * its class name.
- *
- * The value is a list of alternative credential *sets*: a provider is
- * considered credentialed if **every** variable in **any one** set is present.
- * An empty list means the provider needs no credentials (e.g. it runs locally).
- *
- * Sources: the deepagents sandbox docs and each provider's own SDK docs.
- * - LangSmith: https://docs.langchain.com/langsmith/sandboxes
- * - Daytona / E2B / Modal / Runloop / Vercel / AgentCore / Deno: provider SDK docs.
- */
-export const PROVIDER_CREDENTIAL_ENV_VARS = {
-    // LangSmith managed sandboxes.
-    LangSmithSandbox: [["LANGSMITH_API_KEY"]],
-    // Daytona (`langchain-daytona` / deepagents `DaytonaSandbox`).
-    DaytonaSandbox: [["DAYTONA_API_KEY"]],
-    // E2B (`langchain-e2b` / deepagents `E2BSandbox`).
-    E2BSandbox: [["E2B_API_KEY"]],
-    // Modal requires both a token id and secret.
-    ModalSandbox: [["MODAL_TOKEN_ID", "MODAL_TOKEN_SECRET"]],
-    // Runloop devboxes.
-    RunloopSandbox: [["RUNLOOP_API_KEY"]],
-    // Vercel: either an OIDC token, or an access token + team + project ids.
-    VercelSandbox: [
-        ["VERCEL_OIDC_TOKEN"],
-        ["VERCEL_TOKEN", "VERCEL_TEAM_ID", "VERCEL_PROJECT_ID"],
-    ],
-    // AWS Bedrock AgentCore: standard AWS credential resolution.
-    AgentCoreSandbox: [["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"], ["AWS_PROFILE"]],
-    // Deno Deploy microVMs (`@langchain/deno`) need an organization token.
-    DenoSandbox: [["DENO_DEPLOY_TOKEN"]],
-    // Node VFS runs locally and needs no credentials.
-    NodeVFSSandbox: [],
-};
-/**
- * Whether MDA is running under `mda dev`. The CLI sets `MDA_DEV` when it
- * launches the local LangGraph dev server; it is never set for `mda deploy`.
- */
-export function isDevMode() {
-    const value = process.env.MDA_DEV;
-    return typeof value === "string" && value.length > 0;
-}
-/** Resolve the lookup key for a sandbox provider (its id, else class name). */
-export function providerKey(provider) {
-    const p = provider;
-    return (p.providerId ?? p.name ?? "").trim();
-}
-/** Whether every variable in a credential set is set and non-empty. */
-export function credentialSetSatisfied(envVars) {
-    return envVars.every((name) => (process.env[name] ?? "").trim().length > 0);
-}
-/**
- * Determine whether the configured provider's credentials are available so
- * `mda dev` can decide between the real provider and the local fallback.
- */
-export function providerCredentialStatus(provider) {
-    const key = providerKey(provider);
-    const sets = PROVIDER_CREDENTIAL_ENV_VARS[key];
-    if (sets === undefined) {
-        return { status: "unknown", provider: key || "unknown", missing: [] };
-    }
-    if (sets.length === 0 || sets.some(credentialSetSatisfied)) {
-        return { status: "available", provider: key, missing: [] };
-    }
-    return { status: "missing", provider: key, missing: sets[0] ?? [] };
-}
-//# sourceMappingURL=credentials.js.map

package/dist/runtime/credentials.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/runtime/credentials.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA+B;IACtE,+BAA+B;IAC/B,gBAAgB,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACzC,+DAA+D;IAC/D,cAAc,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACrC,mDAAmD;IACnD,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;IAC7B,6CAA6C;IAC7C,YAAY,EAAE,CAAC,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;IACxD,oBAAoB;IACpB,cAAc,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACrC,yEAAyE;IACzE,aAAa,EAAE;QACb,CAAC,mBAAmB,CAAC;QACrB,CAAC,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;KACxD;IACD,6DAA6D;IAC7D,gBAAgB,EAAE,CAAC,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;IACnF,uEAAuE;IACvE,WAAW,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACpC,kDAAkD;IAClD,cAAc,EAAE,EAAE;CACnB,CAAC;AAeF;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,QAAuC;IACjE,MAAM,CAAC,GAAG,QAAkD,CAAC;IAC7D,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,sBAAsB,CAAC,OAAiB;IACtD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAuC;IAEvC,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,4BAA4B,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACtE,CAAC"}

package/dist/runtime/dev-notice.d.ts

@@ -1,7 +0,0 @@
-export declare function logDevSandboxNoticeOnce(message: string): void;
-/**
- * Reset the one-time notice guard. Test-only: the guard is module-level state
- * that otherwise persists across test cases in the same module instance.
- */
-export declare function resetDevSandboxNoticeForTests(): void;
-//# sourceMappingURL=dev-notice.d.ts.map

package/dist/runtime/dev-notice.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-notice.d.ts","sourceRoot":"","sources":["../../src/runtime/dev-notice.ts"],"names":[],"mappings":"AAaA,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK7D;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/runtime/dev-notice.js

@@ -1,27 +0,0 @@
-/**
- * Emit a one-time notice describing which dev sandbox mode is in effect.
- *
- * Deduped for the lifetime of the process because the managed sandbox is
- * created once per sandbox *scope key* (thread/tenant/actor), not once per
- * process. The `mda dev` LangGraph server is long-lived and serves many
- * threads, so each new thread misses the sandbox cache and provisions a fresh
- * sandbox — without this guard the banner would reprint on the first turn of
- * every new thread (and could interleave when threads start concurrently). The
- * message is session-level context, so once is enough.
- */
-let loggedDevSandboxNotice = false;
-export function logDevSandboxNoticeOnce(message) {
-    if (loggedDevSandboxNotice)
-        return;
-    loggedDevSandboxNotice = true;
-    // eslint-disable-next-line no-console
-    console.log(message);
-}
-/**
- * Reset the one-time notice guard. Test-only: the guard is module-level state
- * that otherwise persists across test cases in the same module instance.
- */
-export function resetDevSandboxNoticeForTests() {
-    loggedDevSandboxNotice = false;
-}
-//# sourceMappingURL=dev-notice.js.map

package/dist/runtime/dev-notice.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-notice.js","sourceRoot":"","sources":["../../src/runtime/dev-notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,IAAI,sBAAsB,GAAG,KAAK,CAAC;AAEnC,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,IAAI,sBAAsB;QAAE,OAAO;IACnC,sBAAsB,GAAG,IAAI,CAAC;IAC9B,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B;IAC3C,sBAAsB,GAAG,KAAK,CAAC;AACjC,CAAC"}

package/dist/runtime/local-dev-sandbox.d.ts

@@ -1,13 +0,0 @@
-import type { ManagedSandboxBackend } from "./types.js";
-/**
- * Provision a local, throwaway sandbox rooted at a fresh OS temp directory.
- *
- * Uses `deepagents`' `LocalShellBackend`, which runs commands and file
- * operations against the host within the temp dir — no remote sandbox, no
- * credentials, no network. Intended only for `mda dev`.
- *
- * `reason` explains *why* the local sandbox is being used (missing credentials,
- * provider creation failure, …) and is logged once alongside the temp dir path.
- */
-export declare function createLocalDevSandbox(reason: string): Promise<ManagedSandboxBackend>;
-//# sourceMappingURL=local-dev-sandbox.d.ts.map

package/dist/runtime/local-dev-sandbox.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-dev-sandbox.d.ts","sourceRoot":"","sources":["../../src/runtime/local-dev-sandbox.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAexD;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+B1F"}

package/dist/runtime/local-dev-sandbox.js

@@ -1,39 +0,0 @@
-import { mkdtemp } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { logDevSandboxNoticeOnce } from "./dev-notice.js";
-/**
- * Provision a local, throwaway sandbox rooted at a fresh OS temp directory.
- *
- * Uses `deepagents`' `LocalShellBackend`, which runs commands and file
- * operations against the host within the temp dir — no remote sandbox, no
- * credentials, no network. Intended only for `mda dev`.
- *
- * `reason` explains *why* the local sandbox is being used (missing credentials,
- * provider creation failure, …) and is logged once alongside the temp dir path.
- */
-export async function createLocalDevSandbox(reason) {
-    const dir = await mkdtemp(join(tmpdir(), "mda-dev-sandbox-"));
-    logDevSandboxNoticeOnce(`[mda dev] ${reason}:\n  ${dir}`);
-    // Loaded dynamically (rather than a static named import) so the build does
-    // not depend on `LocalShellBackend` being present in the resolved
-    // `deepagents` type surface; it is provided by the runtime's `deepagents`.
-    const deepagentsModule = (await import("deepagents"));
-    const LocalShellBackend = deepagentsModule.LocalShellBackend;
-    if (typeof LocalShellBackend !== "function") {
-        throw new Error("the installed `deepagents` does not export `LocalShellBackend`; upgrade " +
-            "`deepagents` to use the local `mda dev` sandbox, or set the provider credentials.");
-    }
-    const backend = new LocalShellBackend({
-        rootDir: dir,
-        virtualMode: true,
-        inheritEnv: true,
-    });
-    // Initialize eagerly when the backend supports it, mirroring how the provider
-    // `create(...)` factory hands back a ready-to-use backend.
-    if (typeof backend.initialize === "function") {
-        await backend.initialize();
-    }
-    return backend;
-}
-//# sourceMappingURL=local-dev-sandbox.js.map

package/dist/runtime/local-dev-sandbox.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-dev-sandbox.js","sourceRoot":"","sources":["../../src/runtime/local-dev-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAgB1D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAc;IACxD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC9D,uBAAuB,CAAC,aAAa,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC;IAE1D,2EAA2E;IAC3E,kEAAkE;IAClE,2EAA2E;IAC3E,MAAM,gBAAgB,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAA4B,CAAC;IACjF,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,iBAE9B,CAAC;IACd,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,0EAA0E;YACxE,mFAAmF,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC;QACpC,OAAO,EAAE,GAAG;QACZ,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,8EAA8E;IAC9E,2DAA2D;IAC3D,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,OAA2C,CAAC;AACrD,CAAC"}