@langchain/google-common 0.2.17 → 1.0.0

package/dist/experimental/utils/media_core.d.ts

@@ -1,78 +1,81 @@
 import { BaseStore } from "@langchain/core/stores";
 import { Serializable } from "@langchain/core/load/serializable";
-export type MediaBlobData = {
-    value: string;
-    type: string;
+
+//#region src/experimental/utils/media_core.d.ts
+type MediaBlobData = {
+  value: string; // In Base64 encoding
+  type: string; // The mime type and possibly encoding
 };
-export interface MediaBlobParameters {
-    data?: MediaBlobData;
-    metadata?: Record<string, unknown>;
-    path?: string;
+interface MediaBlobParameters {
+  data?: MediaBlobData;
+  metadata?: Record<string, unknown>;
+  path?: string;
 }
 /**
  * Represents a chunk of data that can be identified by the path where the
  * data is (or will be) located, along with optional metadata about the data.
  */
-export declare class MediaBlob extends Serializable implements MediaBlobParameters {
-    lc_serializable: boolean;
-    lc_namespace: string[];
-    data: MediaBlobData;
-    metadata?: Record<string, any>;
-    path?: string;
-    constructor(params: MediaBlobParameters);
-    get size(): number;
-    get dataType(): string;
-    get encoding(): string;
-    get mimetype(): string;
-    get asBytes(): Uint8Array;
-    asString(): Promise<string>;
-    asBase64(): Promise<string>;
-    asDataUrl(): Promise<string>;
-    asUri(): Promise<string>;
-    encode(): Promise<{
-        encoded: string;
-        encoding: string;
-    }>;
-    static fromDataUrl(url: string): MediaBlob;
-    static fromBlob(blob: Blob, other?: Omit<MediaBlobParameters, "data">): Promise<MediaBlob>;
+declare class MediaBlob extends Serializable implements MediaBlobParameters {
+  lc_serializable: boolean;
+  lc_namespace: string[];
+  data: MediaBlobData;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  metadata?: Record<string, any>;
+  path?: string;
+  constructor(params: MediaBlobParameters);
+  get size(): number;
+  get dataType(): string;
+  get encoding(): string;
+  get mimetype(): string;
+  get asBytes(): Uint8Array;
+  asString(): Promise<string>;
+  asBase64(): Promise<string>;
+  asDataUrl(): Promise<string>;
+  asUri(): Promise<string>;
+  encode(): Promise<{
+    encoded: string;
+    encoding: string;
+  }>;
+  static fromDataUrl(url: string): MediaBlob;
+  static fromBlob(blob: Blob, other?: Omit<MediaBlobParameters, "data">): Promise<MediaBlob>;
 }
-export type ActionIfInvalidAction = "ignore" | "prefixPath" | "prefixUuid1" | "prefixUuid4" | "prefixUuid6" | "prefixUuid7" | "removePath";
-export interface BlobStoreStoreOptions {
-    /**
-     * If the path is missing or invalid in the blob, how should we create
-     * a new path?
-     * Subclasses may define their own methods, but the following are supported
-     * by default:
-     * - Undefined or an emtpy string: Reject the blob
-     * - "ignore": Attempt to store it anyway (but this may fail)
-     * - "prefixPath": Use the default prefix for the BlobStore and get the
-     *   unique portion from the URL. The original path is stored in the metadata
-     * - "prefixUuid": Use the default prefix for the BlobStore and get the
-     *   unique portion from a generated UUID. The original path is stored
-     *   in the metadata
-     */
-    actionIfInvalid?: ActionIfInvalidAction;
-    /**
-     * The expected prefix for URIs that are stored.
-     * This may be used to test if a MediaBlob is valid and used to create a new
-     * path if "prefixPath" or "prefixUuid" is set for actionIfInvalid.
-     */
-    pathPrefix?: string;
+type ActionIfInvalidAction = "ignore" | "prefixPath" | "prefixUuid1" | "prefixUuid4" | "prefixUuid6" | "prefixUuid7" | "removePath";
+interface BlobStoreStoreOptions {
+  /**
+   * If the path is missing or invalid in the blob, how should we create
+   * a new path?
+   * Subclasses may define their own methods, but the following are supported
+   * by default:
+   * - Undefined or an emtpy string: Reject the blob
+   * - "ignore": Attempt to store it anyway (but this may fail)
+   * - "prefixPath": Use the default prefix for the BlobStore and get the
+   *   unique portion from the URL. The original path is stored in the metadata
+   * - "prefixUuid": Use the default prefix for the BlobStore and get the
+   *   unique portion from a generated UUID. The original path is stored
+   *   in the metadata
+   */
+  actionIfInvalid?: ActionIfInvalidAction;
+  /**
+   * The expected prefix for URIs that are stored.
+   * This may be used to test if a MediaBlob is valid and used to create a new
+   * path if "prefixPath" or "prefixUuid" is set for actionIfInvalid.
+   */
+  pathPrefix?: string;
 }
-export type ActionIfBlobMissingAction = "emptyBlob";
-export interface BlobStoreFetchOptions {
-    /**
-     * If the blob is not found when fetching, what should we do?
-     * Subclasses may define their own methods, but the following are supported
-     * by default:
-     * - Undefined or an empty string: return undefined
-     * - "emptyBlob": return a new MediaBlob that has the path set, but nothing else.
-     */
-    actionIfBlobMissing?: ActionIfBlobMissingAction;
+type ActionIfBlobMissingAction = "emptyBlob";
+interface BlobStoreFetchOptions {
+  /**
+   * If the blob is not found when fetching, what should we do?
+   * Subclasses may define their own methods, but the following are supported
+   * by default:
+   * - Undefined or an empty string: return undefined
+   * - "emptyBlob": return a new MediaBlob that has the path set, but nothing else.
+   */
+  actionIfBlobMissing?: ActionIfBlobMissingAction;
 }
-export interface BlobStoreOptions {
-    defaultStoreOptions?: BlobStoreStoreOptions;
-    defaultFetchOptions?: BlobStoreFetchOptions;
+interface BlobStoreOptions {
+  defaultStoreOptions?: BlobStoreStoreOptions;
+  defaultFetchOptions?: BlobStoreFetchOptions;
 }
 /**
  * A specialized Store that is designed to handle MediaBlobs and use the
@@ -86,104 +89,104 @@ export interface BlobStoreOptions {
  * BaseStore may be implemented (or even possible). Those that are not
  * implemented should be documented and throw an Error if called.
  */
-export declare abstract class BlobStore extends BaseStore<string, MediaBlob> {
-    lc_namespace: string[];
-    defaultStoreOptions: BlobStoreStoreOptions;
-    defaultFetchOptions: BlobStoreFetchOptions;
-    constructor(opts?: BlobStoreOptions);
-    protected _realKey(key: string | MediaBlob): Promise<string>;
-    /**
-     * Is the path supported by this BlobStore?
-     *
-     * Although this is async, this is expected to be a relatively fast operation
-     * (ie - you shouldn't make network calls).
-     *
-     * @param path The path to check
-     * @param opts Any options (if needed) that may be used to determine if it is valid
-     * @return If the path is supported
-     */
-    hasValidPath(path: string | undefined, opts?: BlobStoreStoreOptions): Promise<boolean>;
-    protected _blobPathSuffix(blob: MediaBlob): string;
-    protected _newBlob(oldBlob: MediaBlob, newPath?: string): Promise<MediaBlob>;
-    protected _validBlobPrefixPath(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob>;
-    protected _validBlobPrefixUuidFunction(name: ActionIfInvalidAction | string): string;
-    protected _validBlobPrefixUuid(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob>;
-    protected _validBlobRemovePath(blob: MediaBlob, _opts?: BlobStoreStoreOptions): Promise<MediaBlob>;
-    /**
-     * Based on the blob and options, return a blob that has a valid path
-     * that can be saved.
-     * @param blob
-     * @param opts
-     */
-    protected _validStoreBlob(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;
-    store(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;
-    protected _missingFetchBlobEmpty(path: string, _opts?: BlobStoreFetchOptions): Promise<MediaBlob>;
-    protected _missingFetchBlob(path: string, opts?: BlobStoreFetchOptions): Promise<MediaBlob | undefined>;
-    fetch(key: string | MediaBlob, opts?: BlobStoreFetchOptions): Promise<MediaBlob | undefined>;
+declare abstract class BlobStore extends BaseStore<string, MediaBlob> {
+  lc_namespace: string[]; // FIXME - What should this be? And why?
+  defaultStoreOptions: BlobStoreStoreOptions;
+  defaultFetchOptions: BlobStoreFetchOptions;
+  constructor(opts?: BlobStoreOptions);
+  protected _realKey(key: string | MediaBlob): Promise<string>;
+  /**
+   * Is the path supported by this BlobStore?
+   *
+   * Although this is async, this is expected to be a relatively fast operation
+   * (ie - you shouldn't make network calls).
+   *
+   * @param path The path to check
+   * @param opts Any options (if needed) that may be used to determine if it is valid
+   * @return If the path is supported
+   */
+  hasValidPath(path: string | undefined, opts?: BlobStoreStoreOptions): Promise<boolean>;
+  protected _blobPathSuffix(blob: MediaBlob): string;
+  protected _newBlob(oldBlob: MediaBlob, newPath?: string): Promise<MediaBlob>;
+  protected _validBlobPrefixPath(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob>;
+  protected _validBlobPrefixUuidFunction(name: ActionIfInvalidAction | string): string;
+  protected _validBlobPrefixUuid(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob>;
+  protected _validBlobRemovePath(blob: MediaBlob, _opts?: BlobStoreStoreOptions): Promise<MediaBlob>;
+  /**
+   * Based on the blob and options, return a blob that has a valid path
+   * that can be saved.
+   * @param blob
+   * @param opts
+   */
+  protected _validStoreBlob(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;
+  store(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;
+  protected _missingFetchBlobEmpty(path: string, _opts?: BlobStoreFetchOptions): Promise<MediaBlob>;
+  protected _missingFetchBlob(path: string, opts?: BlobStoreFetchOptions): Promise<MediaBlob | undefined>;
+  fetch(key: string | MediaBlob, opts?: BlobStoreFetchOptions): Promise<MediaBlob | undefined>;
 }
-export interface BackedBlobStoreOptions extends BlobStoreOptions {
-    backingStore: BaseStore<string, MediaBlob>;
+interface BackedBlobStoreOptions extends BlobStoreOptions {
+  backingStore: BaseStore<string, MediaBlob>;
 }
-export declare class BackedBlobStore extends BlobStore {
-    backingStore: BaseStore<string, MediaBlob>;
-    constructor(opts: BackedBlobStoreOptions);
-    mdelete(keys: string[]): Promise<void>;
-    mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;
-    mset(keyValuePairs: [string, MediaBlob][]): Promise<void>;
-    yieldKeys(prefix: string | undefined): AsyncGenerator<string>;
+declare class BackedBlobStore extends BlobStore {
+  backingStore: BaseStore<string, MediaBlob>;
+  constructor(opts: BackedBlobStoreOptions);
+  mdelete(keys: string[]): Promise<void>;
+  mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;
+  mset(keyValuePairs: [string, MediaBlob][]): Promise<void>;
+  yieldKeys(prefix: string | undefined): AsyncGenerator<string>;
 }
-export interface ReadThroughBlobStoreOptions extends BlobStoreOptions {
-    baseStore: BlobStore;
-    backingStore: BlobStore;
+interface ReadThroughBlobStoreOptions extends BlobStoreOptions {
+  baseStore: BlobStore;
+  backingStore: BlobStore;
 }
-export declare class ReadThroughBlobStore extends BlobStore {
-    baseStore: BlobStore;
-    backingStore: BlobStore;
-    constructor(opts: ReadThroughBlobStoreOptions);
-    store(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;
-    mdelete(keys: string[]): Promise<void>;
-    mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;
-    mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;
-    yieldKeys(prefix: string | undefined): AsyncGenerator<string>;
+declare class ReadThroughBlobStore extends BlobStore {
+  baseStore: BlobStore;
+  backingStore: BlobStore;
+  constructor(opts: ReadThroughBlobStoreOptions);
+  store(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;
+  mdelete(keys: string[]): Promise<void>;
+  mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;
+  mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;
+  yieldKeys(prefix: string | undefined): AsyncGenerator<string>;
 }
-export declare class SimpleWebBlobStore extends BlobStore {
-    _notImplementedException(): void;
-    hasValidPath(path: string | undefined, _opts?: BlobStoreStoreOptions): Promise<boolean>;
-    _fetch(url: string): Promise<MediaBlob | undefined>;
-    mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;
-    mdelete(_keys: string[]): Promise<void>;
-    mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;
-    yieldKeys(_prefix: string | undefined): AsyncGenerator<string>;
+declare class SimpleWebBlobStore extends BlobStore {
+  _notImplementedException(): void;
+  hasValidPath(path: string | undefined, _opts?: BlobStoreStoreOptions): Promise<boolean>;
+  _fetch(url: string): Promise<MediaBlob | undefined>;
+  mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;
+  mdelete(_keys: string[]): Promise<void>;
+  mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;
+  yieldKeys(_prefix: string | undefined): AsyncGenerator<string>;
 }
 /**
  * A blob "store" that works with data: URLs that will turn the URL into
  * a blob.
  */
-export declare class DataBlobStore extends BlobStore {
-    _notImplementedException(): void;
-    hasValidPath(path: string, _opts?: BlobStoreStoreOptions): Promise<boolean>;
-    _fetch(url: string): MediaBlob;
-    mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;
-    mdelete(_keys: string[]): Promise<void>;
-    mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;
-    yieldKeys(_prefix: string | undefined): AsyncGenerator<string>;
+declare class DataBlobStore extends BlobStore {
+  _notImplementedException(): void;
+  hasValidPath(path: string, _opts?: BlobStoreStoreOptions): Promise<boolean>;
+  _fetch(url: string): MediaBlob;
+  mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;
+  mdelete(_keys: string[]): Promise<void>;
+  mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;
+  yieldKeys(_prefix: string | undefined): AsyncGenerator<string>;
 }
-export interface MediaManagerConfiguration {
-    /**
-     * A store that, given a common URI, returns the corresponding MediaBlob.
-     * The returned MediaBlob may have a different URI.
-     * In many cases, this will be a ReadThroughStore or something similar
-     * that has a cached version of the MediaBlob, but also a way to get
-     * a new (or refreshed) version.
-     */
-    store: BlobStore;
-    /**
-     * BlobStores that can resolve a URL into the MediaBlob to save
-     * in the canonical store. This list is evaluated in order.
-     * If not provided, a default list (which involves a DataBlobStore
-     * and a SimpleWebBlobStore) will be used.
-     */
-    resolvers?: BlobStore[];
+interface MediaManagerConfiguration {
+  /**
+   * A store that, given a common URI, returns the corresponding MediaBlob.
+   * The returned MediaBlob may have a different URI.
+   * In many cases, this will be a ReadThroughStore or something similar
+   * that has a cached version of the MediaBlob, but also a way to get
+   * a new (or refreshed) version.
+   */
+  store: BlobStore;
+  /**
+   * BlobStores that can resolve a URL into the MediaBlob to save
+   * in the canonical store. This list is evaluated in order.
+   * If not provided, a default list (which involves a DataBlobStore
+   * and a SimpleWebBlobStore) will be used.
+   */
+  resolvers?: BlobStore[];
 }
 /**
  * Responsible for converting a URI (typically a web URL) into a MediaBlob.
@@ -192,18 +195,21 @@ export interface MediaManagerConfiguration {
  * through the Base64 of the media or through a canonical URI that the LLM
  * supports.
  */
-export declare class MediaManager {
-    store: BlobStore;
-    resolvers: BlobStore[] | undefined;
-    constructor(config: MediaManagerConfiguration);
-    defaultResolvers(): BlobStore[];
-    _isInvalid(blob: MediaBlob | undefined): Promise<boolean>;
-    /**
-     * Given the public URI, load what is at this URI and save it
-     * in the store.
-     * @param uri The URI to resolve using the resolver
-     * @return A canonical MediaBlob for this URI
-     */
-    _resolveAndSave(uri: string): Promise<MediaBlob | undefined>;
-    getMediaBlob(uri: string): Promise<MediaBlob | undefined>;
+declare class MediaManager {
+  store: BlobStore;
+  resolvers: BlobStore[] | undefined;
+  constructor(config: MediaManagerConfiguration);
+  defaultResolvers(): BlobStore[];
+  _isInvalid(blob: MediaBlob | undefined): Promise<boolean>;
+  /**
+   * Given the public URI, load what is at this URI and save it
+   * in the store.
+   * @param uri The URI to resolve using the resolver
+   * @return A canonical MediaBlob for this URI
+   */
+  _resolveAndSave(uri: string): Promise<MediaBlob | undefined>;
+  getMediaBlob(uri: string): Promise<MediaBlob | undefined>;
 }
+//#endregion
+export { ActionIfBlobMissingAction, ActionIfInvalidAction, BackedBlobStore, BackedBlobStoreOptions, BlobStore, BlobStoreFetchOptions, BlobStoreOptions, BlobStoreStoreOptions, DataBlobStore, MediaBlob, MediaBlobData, MediaBlobParameters, MediaManager, MediaManagerConfiguration, ReadThroughBlobStore, ReadThroughBlobStoreOptions, SimpleWebBlobStore };
+//# sourceMappingURL=media_core.d.ts.map

package/dist/experimental/utils/media_core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_core.d.ts","names":["BaseStore","Serializable","MediaBlobData","MediaBlobParameters","Record","MediaBlob","Uint8Array","Promise","Blob","Omit","ActionIfInvalidAction","BlobStoreStoreOptions","ActionIfBlobMissingAction","BlobStoreFetchOptions","BlobStoreOptions","BlobStore","BackedBlobStoreOptions","BackedBlobStore","AsyncGenerator","ReadThroughBlobStoreOptions","ReadThroughBlobStore","SimpleWebBlobStore","DataBlobStore","MediaManagerConfiguration","MediaManager"],"sources":["../../../src/experimental/utils/media_core.d.ts"],"sourcesContent":["import { BaseStore } from \"@langchain/core/stores\";\nimport { Serializable } from \"@langchain/core/load/serializable\";\nexport type MediaBlobData = {\n    value: string; // In Base64 encoding\n    type: string; // The mime type and possibly encoding\n};\nexport interface MediaBlobParameters {\n    data?: MediaBlobData;\n    metadata?: Record<string, unknown>;\n    path?: string;\n}\n/**\n * Represents a chunk of data that can be identified by the path where the\n * data is (or will be) located, along with optional metadata about the data.\n */\nexport declare class MediaBlob extends Serializable implements MediaBlobParameters {\n    lc_serializable: boolean;\n    lc_namespace: string[];\n    data: MediaBlobData;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    metadata?: Record<string, any>;\n    path?: string;\n    constructor(params: MediaBlobParameters);\n    get size(): number;\n    get dataType(): string;\n    get encoding(): string;\n    get mimetype(): string;\n    get asBytes(): Uint8Array;\n    asString(): Promise<string>;\n    asBase64(): Promise<string>;\n    asDataUrl(): Promise<string>;\n    asUri(): Promise<string>;\n    encode(): Promise<{\n        encoded: string;\n        encoding: string;\n    }>;\n    static fromDataUrl(url: string): MediaBlob;\n    static fromBlob(blob: Blob, other?: Omit<MediaBlobParameters, \"data\">): Promise<MediaBlob>;\n}\nexport type ActionIfInvalidAction = \"ignore\" | \"prefixPath\" | \"prefixUuid1\" | \"prefixUuid4\" | \"prefixUuid6\" | \"prefixUuid7\" | \"removePath\";\nexport interface BlobStoreStoreOptions {\n    /**\n     * If the path is missing or invalid in the blob, how should we create\n     * a new path?\n     * Subclasses may define their own methods, but the following are supported\n     * by default:\n     * - Undefined or an emtpy string: Reject the blob\n     * - \"ignore\": Attempt to store it anyway (but this may fail)\n     * - \"prefixPath\": Use the default prefix for the BlobStore and get the\n     *   unique portion from the URL. The original path is stored in the metadata\n     * - \"prefixUuid\": Use the default prefix for the BlobStore and get the\n     *   unique portion from a generated UUID. The original path is stored\n     *   in the metadata\n     */\n    actionIfInvalid?: ActionIfInvalidAction;\n    /**\n     * The expected prefix for URIs that are stored.\n     * This may be used to test if a MediaBlob is valid and used to create a new\n     * path if \"prefixPath\" or \"prefixUuid\" is set for actionIfInvalid.\n     */\n    pathPrefix?: string;\n}\nexport type ActionIfBlobMissingAction = \"emptyBlob\";\nexport interface BlobStoreFetchOptions {\n    /**\n     * If the blob is not found when fetching, what should we do?\n     * Subclasses may define their own methods, but the following are supported\n     * by default:\n     * - Undefined or an empty string: return undefined\n     * - \"emptyBlob\": return a new MediaBlob that has the path set, but nothing else.\n     */\n    actionIfBlobMissing?: ActionIfBlobMissingAction;\n}\nexport interface BlobStoreOptions {\n    defaultStoreOptions?: BlobStoreStoreOptions;\n    defaultFetchOptions?: BlobStoreFetchOptions;\n}\n/**\n * A specialized Store that is designed to handle MediaBlobs and use the\n * key that is included in the blob to determine exactly how it is stored.\n *\n * The full details of a MediaBlob may be changed when it is stored.\n * For example, it may get additional or different Metadata. This should be\n * what is returned when the store() method is called.\n *\n * Although BlobStore extends BaseStore, not all of the methods from\n * BaseStore may be implemented (or even possible). Those that are not\n * implemented should be documented and throw an Error if called.\n */\nexport declare abstract class BlobStore extends BaseStore<string, MediaBlob> {\n    lc_namespace: string[]; // FIXME - What should this be? And why?\n    defaultStoreOptions: BlobStoreStoreOptions;\n    defaultFetchOptions: BlobStoreFetchOptions;\n    constructor(opts?: BlobStoreOptions);\n    protected _realKey(key: string | MediaBlob): Promise<string>;\n    /**\n     * Is the path supported by this BlobStore?\n     *\n     * Although this is async, this is expected to be a relatively fast operation\n     * (ie - you shouldn't make network calls).\n     *\n     * @param path The path to check\n     * @param opts Any options (if needed) that may be used to determine if it is valid\n     * @return If the path is supported\n     */\n    hasValidPath(path: string | undefined, opts?: BlobStoreStoreOptions): Promise<boolean>;\n    protected _blobPathSuffix(blob: MediaBlob): string;\n    protected _newBlob(oldBlob: MediaBlob, newPath?: string): Promise<MediaBlob>;\n    protected _validBlobPrefixPath(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob>;\n    protected _validBlobPrefixUuidFunction(name: ActionIfInvalidAction | string): string;\n    protected _validBlobPrefixUuid(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob>;\n    protected _validBlobRemovePath(blob: MediaBlob, _opts?: BlobStoreStoreOptions): Promise<MediaBlob>;\n    /**\n     * Based on the blob and options, return a blob that has a valid path\n     * that can be saved.\n     * @param blob\n     * @param opts\n     */\n    protected _validStoreBlob(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;\n    store(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;\n    protected _missingFetchBlobEmpty(path: string, _opts?: BlobStoreFetchOptions): Promise<MediaBlob>;\n    protected _missingFetchBlob(path: string, opts?: BlobStoreFetchOptions): Promise<MediaBlob | undefined>;\n    fetch(key: string | MediaBlob, opts?: BlobStoreFetchOptions): Promise<MediaBlob | undefined>;\n}\nexport interface BackedBlobStoreOptions extends BlobStoreOptions {\n    backingStore: BaseStore<string, MediaBlob>;\n}\nexport declare class BackedBlobStore extends BlobStore {\n    backingStore: BaseStore<string, MediaBlob>;\n    constructor(opts: BackedBlobStoreOptions);\n    mdelete(keys: string[]): Promise<void>;\n    mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;\n    mset(keyValuePairs: [string, MediaBlob][]): Promise<void>;\n    yieldKeys(prefix: string | undefined): AsyncGenerator<string>;\n}\nexport interface ReadThroughBlobStoreOptions extends BlobStoreOptions {\n    baseStore: BlobStore;\n    backingStore: BlobStore;\n}\nexport declare class ReadThroughBlobStore extends BlobStore {\n    baseStore: BlobStore;\n    backingStore: BlobStore;\n    constructor(opts: ReadThroughBlobStoreOptions);\n    store(blob: MediaBlob, opts?: BlobStoreStoreOptions): Promise<MediaBlob | undefined>;\n    mdelete(keys: string[]): Promise<void>;\n    mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;\n    mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;\n    yieldKeys(prefix: string | undefined): AsyncGenerator<string>;\n}\nexport declare class SimpleWebBlobStore extends BlobStore {\n    _notImplementedException(): void;\n    hasValidPath(path: string | undefined, _opts?: BlobStoreStoreOptions): Promise<boolean>;\n    _fetch(url: string): Promise<MediaBlob | undefined>;\n    mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;\n    mdelete(_keys: string[]): Promise<void>;\n    mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;\n    yieldKeys(_prefix: string | undefined): AsyncGenerator<string>;\n}\n/**\n * A blob \"store\" that works with data: URLs that will turn the URL into\n * a blob.\n */\nexport declare class DataBlobStore extends BlobStore {\n    _notImplementedException(): void;\n    hasValidPath(path: string, _opts?: BlobStoreStoreOptions): Promise<boolean>;\n    _fetch(url: string): MediaBlob;\n    mget(keys: string[]): Promise<(MediaBlob | undefined)[]>;\n    mdelete(_keys: string[]): Promise<void>;\n    mset(_keyValuePairs: [string, MediaBlob][]): Promise<void>;\n    yieldKeys(_prefix: string | undefined): AsyncGenerator<string>;\n}\nexport interface MediaManagerConfiguration {\n    /**\n     * A store that, given a common URI, returns the corresponding MediaBlob.\n     * The returned MediaBlob may have a different URI.\n     * In many cases, this will be a ReadThroughStore or something similar\n     * that has a cached version of the MediaBlob, but also a way to get\n     * a new (or refreshed) version.\n     */\n    store: BlobStore;\n    /**\n     * BlobStores that can resolve a URL into the MediaBlob to save\n     * in the canonical store. This list is evaluated in order.\n     * If not provided, a default list (which involves a DataBlobStore\n     * and a SimpleWebBlobStore) will be used.\n     */\n    resolvers?: BlobStore[];\n}\n/**\n * Responsible for converting a URI (typically a web URL) into a MediaBlob.\n * Allows for aliasing / caching of the requested URI and what it resolves to.\n * This MediaBlob is expected to be usable to provide to an LLM, either\n * through the Base64 of the media or through a canonical URI that the LLM\n * supports.\n */\nexport declare class MediaManager {\n    store: BlobStore;\n    resolvers: BlobStore[] | undefined;\n    constructor(config: MediaManagerConfiguration);\n    defaultResolvers(): BlobStore[];\n    _isInvalid(blob: MediaBlob | undefined): Promise<boolean>;\n    /**\n     * Given the public URI, load what is at this URI and save it\n     * in the store.\n     * @param uri The URI to resolve using the resolver\n     * @return A canonical MediaBlob for this URI\n     */\n    _resolveAndSave(uri: string): Promise<MediaBlob | undefined>;\n    getMediaBlob(uri: string): Promise<MediaBlob | undefined>;\n}\n"],"mappings":"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"}