@langchain/langgraph 0.4.8 → 1.0.0-alpha.0

package/dist/graph/zod/meta.d.cts

@@ -0,0 +1,116 @@
+import { BaseChannel } from "../../channels/base.cjs";
+import { InteropZodObject, InteropZodObjectShape, InteropZodType } from "@langchain/core/utils/types";
+
+//#region src/graph/zod/meta.d.ts
+declare const META_EXTRAS_DESCRIPTION_PREFIX = "lg:";
+/** @internal */
+type ReducedZodChannel<T extends InteropZodType, TReducerSchema extends InteropZodType> = T & {
+  lg_reducer_schema: TReducerSchema;
+};
+/** @internal */
+type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never };
+type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<unknown> ? ReducerSchema extends InteropZodType<infer U> ? U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never };
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+interface SchemaMeta<TValue = any, TUpdate = TValue> {
+  jsonSchemaExtra?: {
+    langgraph_nodes?: string[];
+    langgraph_type?: "prompt" | "messages";
+    [key: string]: unknown;
+  };
+  reducer?: {
+    schema?: InteropZodType<TUpdate>;
+    fn: (a: TValue, b: TUpdate) => TValue;
+  };
+  default?: () => TValue;
+}
+/**
+ * A registry for storing and managing metadata associated with schemas.
+ * This class provides methods to get, extend, remove, and check metadata for a given schema.
+ */
+declare class SchemaMetaRegistry {
+  /**
+   * Internal map storing schema metadata.
+   * @internal
+   */
+  _map: WeakMap<InteropZodType, SchemaMeta<any, any>>;
+  /**
+   * Cache for extended schfemas.
+   * @internal
+   */
+  _extensionCache: Map<string, WeakMap<InteropZodType, InteropZodType>>;
+  /**
+   * Retrieves the metadata associated with a given schema.
+   * @template TValue The value type of the schema.
+   * @template TUpdate The update type of the schema (defaults to TValue).
+   * @param schema The schema to retrieve metadata for.
+   * @returns The associated SchemaMeta, or undefined if not present.
+   */
+  get<TValue, TUpdate = TValue>(schema: InteropZodType<TValue>): SchemaMeta<TValue, TUpdate> | undefined;
+  /**
+   * Extends or sets the metadata for a given schema.
+   * @template TValue The value type of the schema.
+   * @template TUpdate The update type of the schema (defaults to TValue).
+   * @param schema The schema to extend metadata for.
+   * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.
+   */
+  extend<TValue, TUpdate>(schema: InteropZodType<TValue>, predicate: (meta: SchemaMeta<TValue, TUpdate> | undefined) => SchemaMeta<TValue, TUpdate>): void;
+  /**
+   * Removes the metadata associated with a given schema.
+   * @param schema The schema to remove metadata for.
+   * @returns The SchemaMetaRegistry instance (for chaining).
+   */
+  remove(schema: InteropZodType): this;
+  /**
+   * Checks if metadata exists for a given schema.
+   * @param schema The schema to check.
+   * @returns True if metadata exists, false otherwise.
+   */
+  has(schema: InteropZodType): boolean;
+  /**
+   * Returns a mapping of channel instances for each property in the schema
+   * using the associated metadata in the registry.
+   *
+   * This is used to create the `channels` object that's passed to the `Graph` constructor.
+   *
+   * @template T The shape of the schema.
+   * @param schema The schema to extract channels from.
+   * @returns A mapping from property names to channel instances.
+   */
+  getChannelsForSchema<T extends InteropZodObject>(schema: T): InteropZodToStateDefinition<T>;
+  /**
+   * Returns a modified schema that introspectively looks at all keys of the provided
+   * object schema, and applies the augmentations based on meta provided with those keys
+   * in the registry and the selectors provided in the `effects` parameter.
+   *
+   * This assumes that the passed in schema is the "root" schema object for a graph where
+   * the keys of the schema are the channels of the graph. Because we need to represent
+   * the input of a graph in a couple of different ways, the `effects` parameter allows
+   * us to apply those augmentations based on pre determined conditions.
+   *
+   * @param schema The root schema object to extend.
+   * @param effects The effects that are being applied.
+   * @returns The extended schema.
+   */
+  getExtendedChannelSchemas<T extends InteropZodObject>(schema: T, effects: {
+    /**
+     * Augments the shape by using the reducer's schema if it exists
+     */
+    withReducerSchema?: boolean;
+    /**
+     * Applies the stringified jsonSchemaExtra as a description to the schema.
+     */
+    withJsonSchemaExtrasAsDescription?: boolean;
+    /**
+     * Applies the `.partial()` modifier to the schema.
+     */
+    asPartial?: boolean;
+  }): InteropZodObject;
+}
+declare const schemaMetaRegistry: SchemaMetaRegistry;
+declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate> & {
+  reducer?: undefined;
+}): TSchema;
+declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate>): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;
+//#endregion
+export { InteropZodToStateDefinition, META_EXTRAS_DESCRIPTION_PREFIX, ReducedZodChannel, SchemaMeta, SchemaMetaRegistry, UpdateType, schemaMetaRegistry, withLangGraph };
+//# sourceMappingURL=meta.d.cts.map

package/dist/graph/zod/meta.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.cts","names":["InteropZodObject","InteropZodType","InteropZodObjectShape","BaseChannel","META_EXTRAS_DESCRIPTION_PREFIX","ReducedZodChannel","T","TReducerSchema","InteropZodToStateDefinition","TShape","key","Schema","ReducerSchema","V","U","UpdateType","SchemaMeta","TValue","TUpdate","SchemaMetaRegistry","WeakMap","Map","schemaMetaRegistry","withLangGraph","TSchema"],"sources":["../../../src/graph/zod/meta.d.ts"],"sourcesContent":["import { InteropZodObject, InteropZodType, InteropZodObjectShape } from \"@langchain/core/utils/types\";\nimport { BaseChannel } from \"../../channels/base.js\";\nexport declare const META_EXTRAS_DESCRIPTION_PREFIX = \"lg:\";\n/** @internal */\nexport type ReducedZodChannel<T extends InteropZodType, TReducerSchema extends InteropZodType> = T & {\n    lg_reducer_schema: TReducerSchema;\n};\n/** @internal */\nexport type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = {\n    [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never;\n};\nexport type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = {\n    [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<unknown> ? ReducerSchema extends InteropZodType<infer U> ? U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never;\n};\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SchemaMeta<TValue = any, TUpdate = TValue> {\n    jsonSchemaExtra?: {\n        langgraph_nodes?: string[];\n        langgraph_type?: \"prompt\" | \"messages\";\n        [key: string]: unknown;\n    };\n    reducer?: {\n        schema?: InteropZodType<TUpdate>;\n        fn: (a: TValue, b: TUpdate) => TValue;\n    };\n    default?: () => TValue;\n}\n/**\n * A registry for storing and managing metadata associated with schemas.\n * This class provides methods to get, extend, remove, and check metadata for a given schema.\n */\nexport declare class SchemaMetaRegistry {\n    /**\n     * Internal map storing schema metadata.\n     * @internal\n     */\n    _map: WeakMap<InteropZodType, SchemaMeta<any, any>>;\n    /**\n     * Cache for extended schfemas.\n     * @internal\n     */\n    _extensionCache: Map<string, WeakMap<InteropZodType, InteropZodType>>;\n    /**\n     * Retrieves the metadata associated with a given schema.\n     * @template TValue The value type of the schema.\n     * @template TUpdate The update type of the schema (defaults to TValue).\n     * @param schema The schema to retrieve metadata for.\n     * @returns The associated SchemaMeta, or undefined if not present.\n     */\n    get<TValue, TUpdate = TValue>(schema: InteropZodType<TValue>): SchemaMeta<TValue, TUpdate> | undefined;\n    /**\n     * Extends or sets the metadata for a given schema.\n     * @template TValue The value type of the schema.\n     * @template TUpdate The update type of the schema (defaults to TValue).\n     * @param schema The schema to extend metadata for.\n     * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.\n     */\n    extend<TValue, TUpdate>(schema: InteropZodType<TValue>, predicate: (meta: SchemaMeta<TValue, TUpdate> | undefined) => SchemaMeta<TValue, TUpdate>): void;\n    /**\n     * Removes the metadata associated with a given schema.\n     * @param schema The schema to remove metadata for.\n     * @returns The SchemaMetaRegistry instance (for chaining).\n     */\n    remove(schema: InteropZodType): this;\n    /**\n     * Checks if metadata exists for a given schema.\n     * @param schema The schema to check.\n     * @returns True if metadata exists, false otherwise.\n     */\n    has(schema: InteropZodType): boolean;\n    /**\n     * Returns a mapping of channel instances for each property in the schema\n     * using the associated metadata in the registry.\n     *\n     * This is used to create the `channels` object that's passed to the `Graph` constructor.\n     *\n     * @template T The shape of the schema.\n     * @param schema The schema to extract channels from.\n     * @returns A mapping from property names to channel instances.\n     */\n    getChannelsForSchema<T extends InteropZodObject>(schema: T): InteropZodToStateDefinition<T>;\n    /**\n     * Returns a modified schema that introspectively looks at all keys of the provided\n     * object schema, and applies the augmentations based on meta provided with those keys\n     * in the registry and the selectors provided in the `effects` parameter.\n     *\n     * This assumes that the passed in schema is the \"root\" schema object for a graph where\n     * the keys of the schema are the channels of the graph. Because we need to represent\n     * the input of a graph in a couple of different ways, the `effects` parameter allows\n     * us to apply those augmentations based on pre determined conditions.\n     *\n     * @param schema The root schema object to extend.\n     * @param effects The effects that are being applied.\n     * @returns The extended schema.\n     */\n    getExtendedChannelSchemas<T extends InteropZodObject>(schema: T, effects: {\n        /**\n         * Augments the shape by using the reducer's schema if it exists\n         */\n        withReducerSchema?: boolean;\n        /**\n         * Applies the stringified jsonSchemaExtra as a description to the schema.\n         */\n        withJsonSchemaExtrasAsDescription?: boolean;\n        /**\n         * Applies the `.partial()` modifier to the schema.\n         */\n        asPartial?: boolean;\n    }): InteropZodObject;\n}\nexport declare const schemaMetaRegistry: SchemaMetaRegistry;\nexport declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate> & {\n    reducer?: undefined;\n}): TSchema;\nexport declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate>): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;\n"],"mappings":"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"}

package/dist/graph/zod/meta.d.ts

@@ -1,114 +1,116 @@
-import { InteropZodObject, InteropZodType, InteropZodObjectShape } from "@langchain/core/utils/types";
 import { BaseChannel } from "../../channels/base.js";
-export declare const META_EXTRAS_DESCRIPTION_PREFIX = "lg:";
+import { InteropZodObject, InteropZodObjectShape, InteropZodType } from "@langchain/core/utils/types";
+
+//#region src/graph/zod/meta.d.ts
+declare const META_EXTRAS_DESCRIPTION_PREFIX = "lg:";
 /** @internal */
-export type ReducedZodChannel<T extends InteropZodType, TReducerSchema extends InteropZodType> = T & {
-    lg_reducer_schema: TReducerSchema;
+type ReducedZodChannel<T extends InteropZodType, TReducerSchema extends InteropZodType> = T & {
+  lg_reducer_schema: TReducerSchema;
 };
 /** @internal */
-export type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = {
-    [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never;
-};
-export type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = {
-    [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<unknown> ? ReducerSchema extends InteropZodType<infer U> ? U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never;
-};
-export interface SchemaMeta<TValue = any, TUpdate = TValue> {
-    jsonSchemaExtra?: {
-        langgraph_nodes?: string[];
-        langgraph_type?: "prompt" | "messages";
-        [key: string]: unknown;
-    };
-    reducer?: {
-        schema?: InteropZodType<TUpdate>;
-        fn: (a: TValue, b: TUpdate) => TValue;
-    };
-    default?: () => TValue;
+type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never };
+type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<unknown> ? ReducerSchema extends InteropZodType<infer U> ? U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never };
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+interface SchemaMeta<TValue = any, TUpdate = TValue> {
+  jsonSchemaExtra?: {
+    langgraph_nodes?: string[];
+    langgraph_type?: "prompt" | "messages";
+    [key: string]: unknown;
+  };
+  reducer?: {
+    schema?: InteropZodType<TUpdate>;
+    fn: (a: TValue, b: TUpdate) => TValue;
+  };
+  default?: () => TValue;
 }
 /**
  * A registry for storing and managing metadata associated with schemas.
  * This class provides methods to get, extend, remove, and check metadata for a given schema.
  */
-export declare class SchemaMetaRegistry {
-    /**
-     * Internal map storing schema metadata.
-     * @internal
-     */
-    _map: WeakMap<InteropZodType, SchemaMeta<any, any>>;
-    /**
-     * Cache for extended schfemas.
-     * @internal
-     */
-    _extensionCache: Map<string, WeakMap<InteropZodType, InteropZodType>>;
-    /**
-     * Retrieves the metadata associated with a given schema.
-     * @template TValue The value type of the schema.
-     * @template TUpdate The update type of the schema (defaults to TValue).
-     * @param schema The schema to retrieve metadata for.
-     * @returns The associated SchemaMeta, or undefined if not present.
-     */
-    get<TValue, TUpdate = TValue>(schema: InteropZodType<TValue>): SchemaMeta<TValue, TUpdate> | undefined;
-    /**
-     * Extends or sets the metadata for a given schema.
-     * @template TValue The value type of the schema.
-     * @template TUpdate The update type of the schema (defaults to TValue).
-     * @param schema The schema to extend metadata for.
-     * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.
-     */
-    extend<TValue, TUpdate>(schema: InteropZodType<TValue>, predicate: (meta: SchemaMeta<TValue, TUpdate> | undefined) => SchemaMeta<TValue, TUpdate>): void;
-    /**
-     * Removes the metadata associated with a given schema.
-     * @param schema The schema to remove metadata for.
-     * @returns The SchemaMetaRegistry instance (for chaining).
-     */
-    remove(schema: InteropZodType): this;
+declare class SchemaMetaRegistry {
+  /**
+   * Internal map storing schema metadata.
+   * @internal
+   */
+  _map: WeakMap<InteropZodType, SchemaMeta<any, any>>;
+  /**
+   * Cache for extended schfemas.
+   * @internal
+   */
+  _extensionCache: Map<string, WeakMap<InteropZodType, InteropZodType>>;
+  /**
+   * Retrieves the metadata associated with a given schema.
+   * @template TValue The value type of the schema.
+   * @template TUpdate The update type of the schema (defaults to TValue).
+   * @param schema The schema to retrieve metadata for.
+   * @returns The associated SchemaMeta, or undefined if not present.
+   */
+  get<TValue, TUpdate = TValue>(schema: InteropZodType<TValue>): SchemaMeta<TValue, TUpdate> | undefined;
+  /**
+   * Extends or sets the metadata for a given schema.
+   * @template TValue The value type of the schema.
+   * @template TUpdate The update type of the schema (defaults to TValue).
+   * @param schema The schema to extend metadata for.
+   * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.
+   */
+  extend<TValue, TUpdate>(schema: InteropZodType<TValue>, predicate: (meta: SchemaMeta<TValue, TUpdate> | undefined) => SchemaMeta<TValue, TUpdate>): void;
+  /**
+   * Removes the metadata associated with a given schema.
+   * @param schema The schema to remove metadata for.
+   * @returns The SchemaMetaRegistry instance (for chaining).
+   */
+  remove(schema: InteropZodType): this;
+  /**
+   * Checks if metadata exists for a given schema.
+   * @param schema The schema to check.
+   * @returns True if metadata exists, false otherwise.
+   */
+  has(schema: InteropZodType): boolean;
+  /**
+   * Returns a mapping of channel instances for each property in the schema
+   * using the associated metadata in the registry.
+   *
+   * This is used to create the `channels` object that's passed to the `Graph` constructor.
+   *
+   * @template T The shape of the schema.
+   * @param schema The schema to extract channels from.
+   * @returns A mapping from property names to channel instances.
+   */
+  getChannelsForSchema<T extends InteropZodObject>(schema: T): InteropZodToStateDefinition<T>;
+  /**
+   * Returns a modified schema that introspectively looks at all keys of the provided
+   * object schema, and applies the augmentations based on meta provided with those keys
+   * in the registry and the selectors provided in the `effects` parameter.
+   *
+   * This assumes that the passed in schema is the "root" schema object for a graph where
+   * the keys of the schema are the channels of the graph. Because we need to represent
+   * the input of a graph in a couple of different ways, the `effects` parameter allows
+   * us to apply those augmentations based on pre determined conditions.
+   *
+   * @param schema The root schema object to extend.
+   * @param effects The effects that are being applied.
+   * @returns The extended schema.
+   */
+  getExtendedChannelSchemas<T extends InteropZodObject>(schema: T, effects: {
     /**
-     * Checks if metadata exists for a given schema.
-     * @param schema The schema to check.
-     * @returns True if metadata exists, false otherwise.
+     * Augments the shape by using the reducer's schema if it exists
      */
-    has(schema: InteropZodType): boolean;
+    withReducerSchema?: boolean;
     /**
-     * Returns a mapping of channel instances for each property in the schema
-     * using the associated metadata in the registry.
-     *
-     * This is used to create the `channels` object that's passed to the `Graph` constructor.
-     *
-     * @template T The shape of the schema.
-     * @param schema The schema to extract channels from.
-     * @returns A mapping from property names to channel instances.
+     * Applies the stringified jsonSchemaExtra as a description to the schema.
      */
-    getChannelsForSchema<T extends InteropZodObject>(schema: T): InteropZodToStateDefinition<T>;
+    withJsonSchemaExtrasAsDescription?: boolean;
     /**
-     * Returns a modified schema that introspectively looks at all keys of the provided
-     * object schema, and applies the augmentations based on meta provided with those keys
-     * in the registry and the selectors provided in the `effects` parameter.
-     *
-     * This assumes that the passed in schema is the "root" schema object for a graph where
-     * the keys of the schema are the channels of the graph. Because we need to represent
-     * the input of a graph in a couple of different ways, the `effects` parameter allows
-     * us to apply those augmentations based on pre determined conditions.
-     *
-     * @param schema The root schema object to extend.
-     * @param effects The effects that are being applied.
-     * @returns The extended schema.
+     * Applies the `.partial()` modifier to the schema.
      */
-    getExtendedChannelSchemas<T extends InteropZodObject>(schema: T, effects: {
-        /**
-         * Augments the shape by using the reducer's schema if it exists
-         */
-        withReducerSchema?: boolean;
-        /**
-         * Applies the stringified jsonSchemaExtra as a description to the schema.
-         */
-        withJsonSchemaExtrasAsDescription?: boolean;
-        /**
-         * Applies the `.partial()` modifier to the schema.
-         */
-        asPartial?: boolean;
-    }): InteropZodObject;
+    asPartial?: boolean;
+  }): InteropZodObject;
 }
-export declare const schemaMetaRegistry: SchemaMetaRegistry;
-export declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate> & {
-    reducer?: undefined;
+declare const schemaMetaRegistry: SchemaMetaRegistry;
+declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate> & {
+  reducer?: undefined;
 }): TSchema;
-export declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate>): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;
+declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate>): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;
+//#endregion
+export { InteropZodToStateDefinition, META_EXTRAS_DESCRIPTION_PREFIX, ReducedZodChannel, SchemaMeta, SchemaMetaRegistry, UpdateType, schemaMetaRegistry, withLangGraph };
+//# sourceMappingURL=meta.d.ts.map

package/dist/graph/zod/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","names":["InteropZodObject","InteropZodType","InteropZodObjectShape","BaseChannel","META_EXTRAS_DESCRIPTION_PREFIX","ReducedZodChannel","T","TReducerSchema","InteropZodToStateDefinition","TShape","key","Schema","ReducerSchema","V","U","UpdateType","SchemaMeta","TValue","TUpdate","SchemaMetaRegistry","WeakMap","Map","schemaMetaRegistry","withLangGraph","TSchema"],"sources":["../../../src/graph/zod/meta.d.ts"],"sourcesContent":["import { InteropZodObject, InteropZodType, InteropZodObjectShape } from \"@langchain/core/utils/types\";\nimport { BaseChannel } from \"../../channels/base.js\";\nexport declare const META_EXTRAS_DESCRIPTION_PREFIX = \"lg:\";\n/** @internal */\nexport type ReducedZodChannel<T extends InteropZodType, TReducerSchema extends InteropZodType> = T & {\n    lg_reducer_schema: TReducerSchema;\n};\n/** @internal */\nexport type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = {\n    [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never;\n};\nexport type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = {\n    [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<unknown> ? ReducerSchema extends InteropZodType<infer U> ? U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never;\n};\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SchemaMeta<TValue = any, TUpdate = TValue> {\n    jsonSchemaExtra?: {\n        langgraph_nodes?: string[];\n        langgraph_type?: \"prompt\" | \"messages\";\n        [key: string]: unknown;\n    };\n    reducer?: {\n        schema?: InteropZodType<TUpdate>;\n        fn: (a: TValue, b: TUpdate) => TValue;\n    };\n    default?: () => TValue;\n}\n/**\n * A registry for storing and managing metadata associated with schemas.\n * This class provides methods to get, extend, remove, and check metadata for a given schema.\n */\nexport declare class SchemaMetaRegistry {\n    /**\n     * Internal map storing schema metadata.\n     * @internal\n     */\n    _map: WeakMap<InteropZodType, SchemaMeta<any, any>>;\n    /**\n     * Cache for extended schfemas.\n     * @internal\n     */\n    _extensionCache: Map<string, WeakMap<InteropZodType, InteropZodType>>;\n    /**\n     * Retrieves the metadata associated with a given schema.\n     * @template TValue The value type of the schema.\n     * @template TUpdate The update type of the schema (defaults to TValue).\n     * @param schema The schema to retrieve metadata for.\n     * @returns The associated SchemaMeta, or undefined if not present.\n     */\n    get<TValue, TUpdate = TValue>(schema: InteropZodType<TValue>): SchemaMeta<TValue, TUpdate> | undefined;\n    /**\n     * Extends or sets the metadata for a given schema.\n     * @template TValue The value type of the schema.\n     * @template TUpdate The update type of the schema (defaults to TValue).\n     * @param schema The schema to extend metadata for.\n     * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.\n     */\n    extend<TValue, TUpdate>(schema: InteropZodType<TValue>, predicate: (meta: SchemaMeta<TValue, TUpdate> | undefined) => SchemaMeta<TValue, TUpdate>): void;\n    /**\n     * Removes the metadata associated with a given schema.\n     * @param schema The schema to remove metadata for.\n     * @returns The SchemaMetaRegistry instance (for chaining).\n     */\n    remove(schema: InteropZodType): this;\n    /**\n     * Checks if metadata exists for a given schema.\n     * @param schema The schema to check.\n     * @returns True if metadata exists, false otherwise.\n     */\n    has(schema: InteropZodType): boolean;\n    /**\n     * Returns a mapping of channel instances for each property in the schema\n     * using the associated metadata in the registry.\n     *\n     * This is used to create the `channels` object that's passed to the `Graph` constructor.\n     *\n     * @template T The shape of the schema.\n     * @param schema The schema to extract channels from.\n     * @returns A mapping from property names to channel instances.\n     */\n    getChannelsForSchema<T extends InteropZodObject>(schema: T): InteropZodToStateDefinition<T>;\n    /**\n     * Returns a modified schema that introspectively looks at all keys of the provided\n     * object schema, and applies the augmentations based on meta provided with those keys\n     * in the registry and the selectors provided in the `effects` parameter.\n     *\n     * This assumes that the passed in schema is the \"root\" schema object for a graph where\n     * the keys of the schema are the channels of the graph. Because we need to represent\n     * the input of a graph in a couple of different ways, the `effects` parameter allows\n     * us to apply those augmentations based on pre determined conditions.\n     *\n     * @param schema The root schema object to extend.\n     * @param effects The effects that are being applied.\n     * @returns The extended schema.\n     */\n    getExtendedChannelSchemas<T extends InteropZodObject>(schema: T, effects: {\n        /**\n         * Augments the shape by using the reducer's schema if it exists\n         */\n        withReducerSchema?: boolean;\n        /**\n         * Applies the stringified jsonSchemaExtra as a description to the schema.\n         */\n        withJsonSchemaExtrasAsDescription?: boolean;\n        /**\n         * Applies the `.partial()` modifier to the schema.\n         */\n        asPartial?: boolean;\n    }): InteropZodObject;\n}\nexport declare const schemaMetaRegistry: SchemaMetaRegistry;\nexport declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate> & {\n    reducer?: undefined;\n}): TSchema;\nexport declare function withLangGraph<TValue, TUpdate, TSchema extends InteropZodType<TValue>>(schema: TSchema, meta: SchemaMeta<TValue, TUpdate>): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;\n"],"mappings":"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"}