@langchain/langgraph-api 1.1.2 → 1.1.8

package/dist/auth/index.mjs

@@ -1,163 +0,0 @@
-import { HTTPException } from "hono/http-exception";
-import * as url from "node:url";
-import * as path from "node:path";
-let CUSTOM_AUTH;
-let DISABLE_STUDIO_AUTH = false;
-export const isAuthRegistered = () => CUSTOM_AUTH != null;
-export const isStudioAuthDisabled = () => DISABLE_STUDIO_AUTH;
-function convertError(error) {
-    const isHTTPAuthException = (error) => {
-        return (typeof error === "object" &&
-            error != null &&
-            "status" in error &&
-            "headers" in error);
-    };
-    if (isHTTPAuthException(error)) {
-        throw new HTTPException(error.status, {
-            message: error.message,
-            res: new Response(error.message || "Unauthorized", {
-                status: error.status,
-                headers: error.headers,
-            }),
-        });
-    }
-    throw error;
-}
-export async function authorize(payload) {
-    // find filters and execute them
-    const handlers = CUSTOM_AUTH?.["~handlerCache"];
-    if (!handlers)
-        return { filters: undefined, value: payload.value };
-    const cbKey = [
-        `${payload.resource}:${payload.action}`,
-        `${payload.resource}`,
-        `*:${payload.action}`,
-        `*`,
-    ].find((priority) => handlers.callbacks?.[priority]);
-    const handler = cbKey ? handlers.callbacks?.[cbKey] : undefined;
-    if (!handler || !payload.context) {
-        return { filters: undefined, value: payload.value };
-    }
-    try {
-        const result = await handler({
-            event: `${payload.resource}:${payload.action}`,
-            resource: payload.resource,
-            action: payload.action,
-            value: payload.value,
-            permissions: payload.context?.scopes,
-            user: payload.context?.user,
-        });
-        if (result == null || result == true) {
-            return { filters: undefined, value: payload.value };
-        }
-        if (result === false)
-            throw new HTTPException(403);
-        if (typeof result !== "object") {
-            throw new HTTPException(500, {
-                message: `Auth handler returned invalid result. Expected filter object, null, undefined or boolean. Got "${typeof result}" instead.`,
-            });
-        }
-        return { filters: result, value: payload.value };
-    }
-    catch (error) {
-        throw convertError(error);
-    }
-}
-export async function authenticate(request) {
-    const handlers = CUSTOM_AUTH?.["~handlerCache"];
-    if (!handlers?.authenticate)
-        return undefined;
-    try {
-        const response = await handlers.authenticate(request);
-        // normalize auth response
-        const { scopes, user } = (() => {
-            if (typeof response === "string") {
-                return {
-                    scopes: [],
-                    user: {
-                        permissions: [],
-                        identity: response,
-                        display_name: response,
-                        is_authenticated: true,
-                    },
-                };
-            }
-            if ("identity" in response && typeof response.identity === "string") {
-                const scopes = "permissions" in response && Array.isArray(response.permissions)
-                    ? response.permissions
-                    : [];
-                return {
-                    scopes,
-                    user: {
-                        ...response,
-                        permissions: scopes,
-                        is_authenticated: response.is_authenticated ?? true,
-                        display_name: response.display_name ?? response.identity,
-                    },
-                };
-            }
-            throw new Error("Invalid auth response received. Make sure to either return a `string` or an object with `identity` property.");
-        })();
-        return { scopes, user };
-    }
-    catch (error) {
-        throw convertError(error);
-    }
-}
-export async function registerAuth(auth, options) {
-    if (!auth.path)
-        return;
-    // TODO: handle options.auth.disable_studio_auth
-    const [userFile, exportSymbol] = auth.path.split(":", 2);
-    const sourceFile = path.resolve(options.cwd, userFile);
-    const module = (await import(url.pathToFileURL(sourceFile).toString()).then((module) => module[exportSymbol || "default"]));
-    if (!module)
-        throw new Error(`Failed to load auth: ${auth.path}`);
-    if (!("~handlerCache" in module))
-        throw new Error(`Auth must be an instance of Auth: ${auth.path}`);
-    CUSTOM_AUTH = module;
-    DISABLE_STUDIO_AUTH = auth.disable_studio_auth ?? false;
-}
-export const handleAuthEvent = async (context, event, value) => {
-    const [resource, action] = event.split(":");
-    const result = await authorize({
-        resource,
-        action,
-        context,
-        value,
-    });
-    return [result.filters, result.value];
-};
-export function isAuthMatching(metadata, filters) {
-    if (filters == null)
-        return true;
-    for (const [key, value] of Object.entries(filters)) {
-        if (typeof value === "object" && value != null) {
-            if (value.$eq) {
-                if (metadata?.[key] !== value.$eq)
-                    return false;
-            }
-            else if (value.$contains) {
-                if (!Array.isArray(metadata?.[key])) {
-                    return false;
-                }
-                if (Array.isArray(value.$contains)) {
-                    // Match Postgres list containment semantics (at the top level).
-                    if (!value.$contains.every((v) => (metadata?.[key]).includes(v))) {
-                        return false;
-                    }
-                }
-                else {
-                    if (!metadata?.[key].includes(value.$contains)) {
-                        return false;
-                    }
-                }
-            }
-        }
-        else {
-            if (metadata?.[key] !== value)
-                return false;
-        }
-    }
-    return true;
-}

package/dist/cli/entrypoint.d.mts

@@ -1 +0,0 @@
-export {};

package/dist/cli/entrypoint.mjs

@@ -1,41 +0,0 @@
-import { asyncExitHook } from "exit-hook";
-import * as process from "node:process";
-import { startServer, StartServerSchema } from "../server.mjs";
-import { connectToServer } from "./utils/ipc/client.mjs";
-import { Client as LangSmithClient } from "langsmith";
-import { logger } from "../logging.mjs";
-logger.info(`Starting server...`);
-const [ppid, payload] = process.argv.slice(-2);
-const sendToParent = await connectToServer(+ppid);
-// TODO: re-export langsmith/isTracingEnabled
-const isTracingEnabled = () => {
-    const value = process.env?.LANGSMITH_TRACING_V2 ||
-        process.env?.LANGCHAIN_TRACING_V2 ||
-        process.env?.LANGSMITH_TRACING ||
-        process.env?.LANGCHAIN_TRACING;
-    return value === "true";
-};
-const options = StartServerSchema.parse(JSON.parse(payload));
-// Export PORT to the environment
-process.env.PORT = options.port.toString();
-const [{ host, cleanup }, organizationId] = await Promise.all([
-    startServer(options),
-    (async () => {
-        if (isTracingEnabled()) {
-            try {
-                // @ts-expect-error Private method
-                return await new LangSmithClient()._getTenantId();
-            }
-            catch (error) {
-                logger.warn("Failed to get organization ID. Tracing to LangSmith will not work.", { error });
-            }
-        }
-        return null;
-    })(),
-]);
-logger.info(`Server running at ${host}`);
-let queryParams = `?baseUrl=http://${options.host}:${options.port}`;
-if (organizationId)
-    queryParams += `&organizationId=${organizationId}`;
-asyncExitHook(cleanup, { wait: 3_000 });
-sendToParent?.({ queryParams });

package/dist/cli/spawn.d.mts

@@ -1,42 +0,0 @@
-export declare function spawnServer(args: {
-    host: string;
-    port: string;
-    nJobsPerWorker: string;
-}, context: {
-    config: {
-        graphs: Record<string, string | {
-            path: string;
-            description?: string;
-        }>;
-        ui?: Record<string, string>;
-        ui_config?: {
-            shared?: string[];
-        };
-        auth?: {
-            path?: string;
-            disable_studio_auth?: boolean;
-        };
-        http?: {
-            app?: string;
-            disable_assistants?: boolean;
-            disable_threads?: boolean;
-            disable_runs?: boolean;
-            disable_store?: boolean;
-            disable_meta?: boolean;
-            cors?: {
-                allow_origins?: string[];
-                allow_methods?: string[];
-                allow_headers?: string[];
-                allow_credentials?: boolean;
-                allow_origin_regex?: string;
-                expose_headers?: string[];
-                max_age?: number;
-            };
-        };
-    };
-    env: NodeJS.ProcessEnv;
-    hostUrl: string;
-}, options: {
-    pid: number;
-    projectCwd: string;
-}): Promise<import("child_process").ChildProcess>;

package/dist/cli/spawn.mjs

@@ -1,47 +0,0 @@
-import { fileURLToPath } from "node:url";
-import { spawn } from "node:child_process";
-export async function spawnServer(args, context, options) {
-    const localUrl = `http://${args.host}:${args.port}`;
-    const studioUrl = `${context.hostUrl}/studio?baseUrl=${localUrl}`;
-    console.log(`
-          Welcome to
-
-╦  ┌─┐┌┐┌┌─┐╔═╗┬─┐┌─┐┌─┐┬ ┬
-║  ├─┤││││ ┬║ ╦├┬┘├─┤├─┘├─┤
-╩═╝┴ ┴┘└┘└─┘╚═╝┴└─┴ ┴┴  ┴ ┴.js
-
-- 🚀 API: \x1b[36m${localUrl}\x1b[0m
-- 🎨 Studio UI: \x1b[36m${studioUrl}\x1b[0m
-
-This in-memory server is designed for development and testing.
-For production use, please use LangSmith Deployment.
-
-`);
-    return spawn(process.execPath, [
-        fileURLToPath(new URL("../../cli.mjs", import.meta.resolve("tsx/esm/api"))),
-        "watch",
-        "--clear-screen=false",
-        "--import",
-        new URL(import.meta.resolve("../preload.mjs")).toString(),
-        fileURLToPath(new URL(import.meta.resolve("./entrypoint.mjs"))),
-        options.pid.toString(),
-        JSON.stringify({
-            port: Number.parseInt(args.port, 10),
-            nWorkers: Number.parseInt(args.nJobsPerWorker, 10),
-            host: args.host,
-            graphs: context.config.graphs,
-            auth: context.config.auth,
-            ui: context.config.ui,
-            ui_config: context.config.ui_config,
-            cwd: options.projectCwd,
-            http: context.config.http,
-        }),
-    ], {
-        stdio: ["inherit", "inherit", "inherit", "ipc"],
-        env: {
-            ...context.env,
-            NODE_ENV: "development",
-            LANGGRAPH_API_URL: localUrl,
-        },
-    });
-}

package/dist/cli/utils/ipc/client.d.mts

@@ -1,5 +0,0 @@
-export type SendToParent = (data: Record<string, unknown>) => void;
-export type Parent = {
-    send: SendToParent | undefined;
-};
-export declare const connectToServer: (processId?: number) => Promise<SendToParent | undefined>;

package/dist/cli/utils/ipc/client.mjs

@@ -1,47 +0,0 @@
-// MIT License
-//
-// Copyright (c) Hiroki Osame <hiroki.osame@gmail.com>
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in all
-// copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-// SOFTWARE.
-//
-// https://github.com/privatenumber/tsx/tree/28a3e7d2b8fd72b683aab8a98dd1fcee4624e4cb
-import net from "node:net";
-import { getPipePath } from "./utils/get-pipe-path.mjs";
-export const connectToServer = (processId = process.ppid) => new Promise((resolve) => {
-    const pipePath = getPipePath(processId);
-    const socket = net.createConnection(pipePath, () => {
-        const sendToParent = (data) => {
-            const messageBuffer = Buffer.from(JSON.stringify(data));
-            const lengthBuffer = Buffer.alloc(4);
-            lengthBuffer.writeInt32BE(messageBuffer.length, 0);
-            socket.write(Buffer.concat([lengthBuffer, messageBuffer]));
-        };
-        resolve(sendToParent);
-    });
-    /**
-     * Ignore error when:
-     * - Called as a loader and there is no server
-     * - Nested process when using --test and the ppid is incorrect
-     */
-    socket.on("error", () => {
-        resolve(undefined);
-    });
-    // Prevent Node from waiting for this socket to close before exiting
-    socket.unref();
-});

package/dist/cli/utils/ipc/utils/get-pipe-path.d.mts

@@ -1 +0,0 @@
-export declare const getPipePath: (processId: number) => string;

package/dist/cli/utils/ipc/utils/get-pipe-path.mjs

@@ -1,29 +0,0 @@
-// MIT License
-//
-// Copyright (c) Hiroki Osame <hiroki.osame@gmail.com>
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in all
-// copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-// SOFTWARE.
-//
-// https://github.com/privatenumber/tsx/tree/28a3e7d2b8fd72b683aab8a98dd1fcee4624e4cb
-import path from "node:path";
-import { tmpdir } from "./temporary-directory.mjs";
-export const getPipePath = (processId) => {
-    const pipePath = path.join(tmpdir, `${processId}.pipe`);
-    return process.platform === "win32" ? `\\\\?\\pipe\\${pipePath}` : pipePath;
-};

package/dist/cli/utils/ipc/utils/temporary-directory.d.mts

@@ -1,5 +0,0 @@
-/**
- * This ensures that the cache directory is unique per user
- * and has the appropriate permissions
- */
-export declare const tmpdir: string;

package/dist/cli/utils/ipc/utils/temporary-directory.mjs

@@ -1,40 +0,0 @@
-// MIT License
-//
-// Copyright (c) Hiroki Osame <hiroki.osame@gmail.com>
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in all
-// copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-// SOFTWARE.
-//
-// https://github.com/privatenumber/tsx/tree/28a3e7d2b8fd72b683aab8a98dd1fcee4624e4cb
-import path from "node:path";
-import os from "node:os";
-/**
- * Cache directory is based on the user's identifier
- * to avoid permission issues when accessed by a different user
- */
-const { geteuid } = process;
-const userId = geteuid
-    ? // For Linux users with virtual users on CI (e.g. Docker)
-        geteuid()
-    : // Use username on Windows because it doesn't have id
-        os.userInfo().username;
-/**
- * This ensures that the cache directory is unique per user
- * and has the appropriate permissions
- */
-export const tmpdir = path.join(os.tmpdir(), `tsx-${userId}`);

package/dist/command.d.mts

@@ -1,11 +0,0 @@
-import { Command } from "@langchain/langgraph";
-export interface RunSend {
-    node: string;
-    input?: unknown;
-}
-export interface RunCommand {
-    goto?: string | RunSend | Array<RunSend | string>;
-    update?: Record<string, unknown> | [string, unknown][];
-    resume?: unknown;
-}
-export declare const getLangGraphCommand: (command: RunCommand) => Command<unknown, Record<string, unknown>, string>;

package/dist/command.mjs

@@ -1,15 +0,0 @@
-import { Command, Send } from "@langchain/langgraph";
-export const getLangGraphCommand = (command) => {
-    let goto = command.goto != null && !Array.isArray(command.goto)
-        ? [command.goto]
-        : command.goto;
-    return new Command({
-        goto: goto?.map((item) => {
-            if (typeof item !== "string")
-                return new Send(item.node, item.input);
-            return item;
-        }),
-        update: command.update,
-        resume: command.resume,
-    });
-};

package/dist/experimental/embed.d.mts

@@ -1,42 +0,0 @@
-import type { BaseCheckpointSaver, BaseStore, Pregel } from "@langchain/langgraph";
-import { Hono } from "hono";
-import type { Metadata } from "../storage/types.mjs";
-type AnyPregel = Pregel<any, any, any, any, any>;
-interface Thread {
-    thread_id: string;
-    metadata: Metadata;
-}
-/**
- * Interface for storing and retrieving threads used by `createEmbedServer`.
- * @experimental Does not follow semver.
- */
-export interface ThreadSaver {
-    get: (id: string) => Promise<Thread>;
-    set: (id: string, options: {
-        kind: "put" | "patch";
-        metadata?: Metadata;
-    }) => Promise<Thread>;
-    delete: (id: string) => Promise<void>;
-    search?: (options: {
-        metadata?: Metadata;
-        limit: number;
-        offset: number;
-        sortBy: "created_at" | "updated_at";
-        sortOrder: "asc" | "desc";
-    }) => AsyncGenerator<{
-        thread: Thread;
-        total: number;
-    }>;
-}
-/**
- * Create a Hono server with a subset of LangGraph Platform routes.
- *
- * @experimental Does not follow semver.
- */
-export declare function createEmbedServer(options: {
-    graph: Record<string, AnyPregel>;
-    threads: ThreadSaver;
-    checkpointer: BaseCheckpointSaver;
-    store?: BaseStore;
-}): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
-export {};