@langchain/core 1.0.0-alpha.2 → 1.0.0-alpha.3

package/dist/messages/human.cjs

@@ -8,39 +8,48 @@ var HumanMessage = class extends require_base.BaseMessage {
 	static lc_name() {
 		return "HumanMessage";
 	}
-	_getType() {
-		return "human";
+	type = "human";
+	constructor(fields) {
+		super(fields);
 	}
-	constructor(fields, kwargs) {
-		super(fields, kwargs);
+	static isInstance(obj) {
+		return super.isInstance(obj) && obj.type === "human";
 	}
 };
 /**
 * Represents a chunk of a human message, which can be concatenated with
 * other human message chunks.
 */
-var HumanMessageChunk = class HumanMessageChunk extends require_base.BaseMessageChunk {
+var HumanMessageChunk = class extends require_base.BaseMessageChunk {
 	static lc_name() {
 		return "HumanMessageChunk";
 	}
-	_getType() {
-		return "human";
-	}
-	constructor(fields, kwargs) {
-		super(fields, kwargs);
+	type = "human";
+	constructor(fields) {
+		super(fields);
 	}
 	concat(chunk) {
-		return new HumanMessageChunk({
+		const Cls = this.constructor;
+		return new Cls({
 			content: require_base.mergeContent(this.content, chunk.content),
 			additional_kwargs: require_base._mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
 			response_metadata: require_base._mergeDicts(this.response_metadata, chunk.response_metadata),
 			id: this.id ?? chunk.id
 		});
 	}
+	static isInstance(obj) {
+		return super.isInstance(obj) && obj.type === "human";
+	}
 };
+/**
+* @deprecated Use {@link HumanMessage.isInstance} instead
+*/
 function isHumanMessage(x) {
 	return x.getType() === "human";
 }
+/**
+* @deprecated Use {@link HumanMessageChunk.isInstance} instead
+*/
 function isHumanMessageChunk(x) {
 	return x.getType() === "human";
 }

package/dist/messages/human.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"human.cjs","names":["BaseMessage","fields: string | HumanMessageFields","kwargs?: Record<string, unknown>","BaseMessageChunk","chunk: HumanMessageChunk","mergeContent","_mergeDicts","x: BaseMessage","x: BaseMessageChunk"],"sources":["../../src/messages/human.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageChunk,\n  mergeContent,\n  _mergeDicts,\n  type MessageType,\n  type BaseMessageFields,\n  type MessageContent,\n} from \"./base.js\";\n\nexport type HumanMessageFields = BaseMessageFields;\n\n/**\n * Represents a human message in a conversation.\n */\nexport class HumanMessage extends BaseMessage {\n  declare content: MessageContent;\n\n  static lc_name() {\n    return \"HumanMessage\";\n  }\n\n  _getType(): MessageType {\n    return \"human\";\n  }\n\n  constructor(\n    fields: string | HumanMessageFields,\n    /** @deprecated */\n    kwargs?: Record<string, unknown>\n  ) {\n    super(fields, kwargs);\n  }\n}\n\n/**\n * Represents a chunk of a human message, which can be concatenated with\n * other human message chunks.\n */\nexport class HumanMessageChunk extends BaseMessageChunk {\n  declare content: MessageContent;\n\n  static lc_name() {\n    return \"HumanMessageChunk\";\n  }\n\n  _getType(): MessageType {\n    return \"human\";\n  }\n\n  constructor(\n    fields: string | HumanMessageFields,\n    /** @deprecated */\n    kwargs?: Record<string, unknown>\n  ) {\n    super(fields, kwargs);\n  }\n\n  concat(chunk: HumanMessageChunk) {\n    return new HumanMessageChunk({\n      content: mergeContent(this.content, chunk.content),\n      additional_kwargs: _mergeDicts(\n        this.additional_kwargs,\n        chunk.additional_kwargs\n      ),\n      response_metadata: _mergeDicts(\n        this.response_metadata,\n        chunk.response_metadata\n      ),\n      id: this.id ?? chunk.id,\n    });\n  }\n}\n\nexport function isHumanMessage(x: BaseMessage): x is HumanMessage {\n  return x.getType() === \"human\";\n}\n\nexport function isHumanMessageChunk(\n  x: BaseMessageChunk\n): x is HumanMessageChunk {\n  return x.getType() === \"human\";\n}\n"],"mappings":";;;;;;AAeA,IAAa,eAAb,cAAkCA,yBAAY;CAG5C,OAAO,UAAU;AACf,SAAO;CACR;CAED,WAAwB;AACtB,SAAO;CACR;CAED,YACEC,QAEAC,QACA;EACA,MAAM,QAAQ,OAAO;CACtB;AACF;;;;;AAMD,IAAa,oBAAb,MAAa,0BAA0BC,8BAAiB;CAGtD,OAAO,UAAU;AACf,SAAO;CACR;CAED,WAAwB;AACtB,SAAO;CACR;CAED,YACEF,QAEAC,QACA;EACA,MAAM,QAAQ,OAAO;CACtB;CAED,OAAOE,OAA0B;AAC/B,SAAO,IAAI,kBAAkB;GAC3B,SAASC,0BAAa,KAAK,SAAS,MAAM,QAAQ;GAClD,mBAAmBC,yBACjB,KAAK,mBACL,MAAM,kBACP;GACD,mBAAmBA,yBACjB,KAAK,mBACL,MAAM,kBACP;GACD,IAAI,KAAK,MAAM,MAAM;EACtB;CACF;AACF;AAED,SAAgB,eAAeC,GAAmC;AAChE,QAAO,EAAE,SAAS,KAAK;AACxB;AAED,SAAgB,oBACdC,GACwB;AACxB,QAAO,EAAE,SAAS,KAAK;AACxB"}
+{"version":3,"file":"human.cjs","names":["BaseMessage","fields:\n      | $InferMessageContent<TStructure, \"human\">\n      | HumanMessageFields<TStructure>","obj: unknown","BaseMessageChunk","chunk: HumanMessageChunk<TStructure>","mergeContent","_mergeDicts","x: BaseMessage","x: BaseMessageChunk"],"sources":["../../src/messages/human.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageChunk,\n  mergeContent,\n  _mergeDicts,\n  type BaseMessageFields,\n} from \"./base.js\";\nimport type { $InferMessageContent, MessageStructure } from \"./message.js\";\nimport { Constructor } from \"./utils.js\";\n\nexport interface HumanMessageFields<\n  TStructure extends MessageStructure = MessageStructure\n> extends BaseMessageFields<TStructure, \"human\"> {}\n\n/**\n * Represents a human message in a conversation.\n */\nexport class HumanMessage<\n  TStructure extends MessageStructure = MessageStructure\n> extends BaseMessage<TStructure, \"human\"> {\n  static lc_name() {\n    return \"HumanMessage\";\n  }\n\n  readonly type = \"human\" as const;\n\n  constructor(\n    fields:\n      | $InferMessageContent<TStructure, \"human\">\n      | HumanMessageFields<TStructure>\n  ) {\n    super(fields);\n  }\n\n  static isInstance(obj: unknown): obj is HumanMessage {\n    return super.isInstance(obj) && obj.type === \"human\";\n  }\n}\n\n/**\n * Represents a chunk of a human message, which can be concatenated with\n * other human message chunks.\n */\nexport class HumanMessageChunk<\n  TStructure extends MessageStructure = MessageStructure\n> extends BaseMessageChunk<TStructure, \"human\"> {\n  static lc_name() {\n    return \"HumanMessageChunk\";\n  }\n\n  readonly type = \"human\" as const;\n\n  constructor(\n    fields:\n      | $InferMessageContent<TStructure, \"human\">\n      | HumanMessageFields<TStructure>\n  ) {\n    super(fields);\n  }\n\n  concat(chunk: HumanMessageChunk<TStructure>) {\n    const Cls = this.constructor as Constructor<this>;\n    return new Cls({\n      content: mergeContent(this.content, chunk.content),\n      additional_kwargs: _mergeDicts(\n        this.additional_kwargs,\n        chunk.additional_kwargs\n      ),\n      response_metadata: _mergeDicts(\n        this.response_metadata,\n        chunk.response_metadata\n      ),\n      id: this.id ?? chunk.id,\n    });\n  }\n\n  static isInstance(obj: unknown): obj is HumanMessageChunk {\n    return super.isInstance(obj) && obj.type === \"human\";\n  }\n}\n\n/**\n * @deprecated Use {@link HumanMessage.isInstance} instead\n */\nexport function isHumanMessage<TStructure extends MessageStructure>(\n  x: BaseMessage\n): x is HumanMessage<TStructure> {\n  return x.getType() === \"human\";\n}\n\n/**\n * @deprecated Use {@link HumanMessageChunk.isInstance} instead\n */\nexport function isHumanMessageChunk<TStructure extends MessageStructure>(\n  x: BaseMessageChunk\n): x is HumanMessageChunk<TStructure> {\n  return x.getType() === \"human\";\n}\n"],"mappings":";;;;;;AAiBA,IAAa,eAAb,cAEUA,yBAAiC;CACzC,OAAO,UAAU;AACf,SAAO;CACR;CAED,AAAS,OAAO;CAEhB,YACEC,QAGA;EACA,MAAM,OAAO;CACd;CAED,OAAO,WAAWC,KAAmC;AACnD,SAAO,MAAM,WAAW,IAAI,IAAI,IAAI,SAAS;CAC9C;AACF;;;;;AAMD,IAAa,oBAAb,cAEUC,8BAAsC;CAC9C,OAAO,UAAU;AACf,SAAO;CACR;CAED,AAAS,OAAO;CAEhB,YACEF,QAGA;EACA,MAAM,OAAO;CACd;CAED,OAAOG,OAAsC;EAC3C,MAAM,MAAM,KAAK;AACjB,SAAO,IAAI,IAAI;GACb,SAASC,0BAAa,KAAK,SAAS,MAAM,QAAQ;GAClD,mBAAmBC,yBACjB,KAAK,mBACL,MAAM,kBACP;GACD,mBAAmBA,yBACjB,KAAK,mBACL,MAAM,kBACP;GACD,IAAI,KAAK,MAAM,MAAM;EACtB;CACF;CAED,OAAO,WAAWJ,KAAwC;AACxD,SAAO,MAAM,WAAW,IAAI,IAAI,IAAI,SAAS;CAC9C;AACF;;;;AAKD,SAAgB,eACdK,GAC+B;AAC/B,QAAO,EAAE,SAAS,KAAK;AACxB;;;;AAKD,SAAgB,oBACdC,GACoC;AACpC,QAAO,EAAE,SAAS,KAAK;AACxB"}

package/dist/messages/human.d.cts

@@ -1,31 +1,36 @@
-import { BaseMessage, BaseMessageChunk, BaseMessageFields, MessageContent, MessageType } from "./base.cjs";
+import { BaseMessage, BaseMessageChunk, BaseMessageFields } from "./base.cjs";
+import { $InferMessageContent, MessageStructure } from "./message.cjs";
 
 //#region src/messages/human.d.ts
-type HumanMessageFields = BaseMessageFields;
+interface HumanMessageFields<TStructure extends MessageStructure = MessageStructure> extends BaseMessageFields<TStructure, "human"> {}
 /**
  * Represents a human message in a conversation.
  */
-declare class HumanMessage extends BaseMessage {
-  content: MessageContent;
+declare class HumanMessage<TStructure extends MessageStructure = MessageStructure> extends BaseMessage<TStructure, "human"> {
   static lc_name(): string;
-  _getType(): MessageType;
-  constructor(fields: string | HumanMessageFields, /** @deprecated */
-  kwargs?: Record<string, unknown>);
+  readonly type: "human";
+  constructor(fields: $InferMessageContent<TStructure, "human"> | HumanMessageFields<TStructure>);
+  static isInstance(obj: unknown): obj is HumanMessage;
 }
 /**
  * Represents a chunk of a human message, which can be concatenated with
  * other human message chunks.
  */
-declare class HumanMessageChunk extends BaseMessageChunk {
-  content: MessageContent;
+declare class HumanMessageChunk<TStructure extends MessageStructure = MessageStructure> extends BaseMessageChunk<TStructure, "human"> {
   static lc_name(): string;
-  _getType(): MessageType;
-  constructor(fields: string | HumanMessageFields, /** @deprecated */
-  kwargs?: Record<string, unknown>);
-  concat(chunk: HumanMessageChunk): HumanMessageChunk;
+  readonly type: "human";
+  constructor(fields: $InferMessageContent<TStructure, "human"> | HumanMessageFields<TStructure>);
+  concat(chunk: HumanMessageChunk<TStructure>): this;
+  static isInstance(obj: unknown): obj is HumanMessageChunk;
 }
-declare function isHumanMessage(x: BaseMessage): x is HumanMessage;
-declare function isHumanMessageChunk(x: BaseMessageChunk): x is HumanMessageChunk;
+/**
+ * @deprecated Use {@link HumanMessage.isInstance} instead
+ */
+declare function isHumanMessage<TStructure extends MessageStructure>(x: BaseMessage): x is HumanMessage<TStructure>;
+/**
+ * @deprecated Use {@link HumanMessageChunk.isInstance} instead
+ */
+declare function isHumanMessageChunk<TStructure extends MessageStructure>(x: BaseMessageChunk): x is HumanMessageChunk<TStructure>;
 //#endregion
 export { HumanMessage, HumanMessageChunk, HumanMessageFields, isHumanMessage, isHumanMessageChunk };
 //# sourceMappingURL=human.d.cts.map

package/dist/messages/human.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"human.d.cts","names":["BaseMessage","BaseMessageChunk","MessageType","BaseMessageFields","MessageContent","HumanMessageFields","HumanMessage","Record","HumanMessageChunk","isHumanMessage","isHumanMessageChunk"],"sources":["../../src/messages/human.d.ts"],"sourcesContent":["import { BaseMessage, BaseMessageChunk, type MessageType, type BaseMessageFields, type MessageContent } from \"./base.js\";\nexport type HumanMessageFields = BaseMessageFields;\n/**\n * Represents a human message in a conversation.\n */\nexport declare class HumanMessage extends BaseMessage {\n    content: MessageContent;\n    static lc_name(): string;\n    _getType(): MessageType;\n    constructor(fields: string | HumanMessageFields, \n    /** @deprecated */\n    kwargs?: Record<string, unknown>);\n}\n/**\n * Represents a chunk of a human message, which can be concatenated with\n * other human message chunks.\n */\nexport declare class HumanMessageChunk extends BaseMessageChunk {\n    content: MessageContent;\n    static lc_name(): string;\n    _getType(): MessageType;\n    constructor(fields: string | HumanMessageFields, \n    /** @deprecated */\n    kwargs?: Record<string, unknown>);\n    concat(chunk: HumanMessageChunk): HumanMessageChunk;\n}\nexport declare function isHumanMessage(x: BaseMessage): x is HumanMessage;\nexport declare function isHumanMessageChunk(x: BaseMessageChunk): x is HumanMessageChunk;\n"],"mappings":";;;KACYK,kBAAAA,GAAqBF;;AAAjC;AAIA;AAAiC,cAAZG,YAAAA,SAAqBN,WAAAA,CAAT;EAAA,OACpBI,EAAAA,cAAAA;EAAc,OAEXF,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAW,QACMG,CAAAA,CAAAA,EADjBH,WACiBG;EAAkB,WAEtCE,CAAAA,MAAAA,EAAAA,MAAAA,GAFoBF,kBAEpBE,EAAM;EANkC,MAAA,CAAA,EAMxCA,MANwC,CAAA,MAAA,EAAA,OAAA,CAAA;AAYrD;;;;;AAMaA,cANQC,iBAAAA,SAA0BP,gBAAAA,CAMlCM;EAAM,OACDC,EANLJ,cAMKI;EAAiB,OAAGA,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAiB,QAPRP,CAAAA,CAAAA,EAG/BC,WAH+BD;EAAgB,WAAA,CAAA,MAAA,EAAA,MAAA,GAI9BI,kBAJ8B,EASvCI;EAAc,MAAA,CAAA,EAHzBF,MAGyB,CAAA,MAAA,EAAA,OAAA,CAAA;EAAA,MAAIP,CAAAA,KAAAA,EAFxBQ,iBAEwBR,CAAAA,EAFJQ,iBAEIR;;AAA+B,iBAAjDS,cAAAA,CAAiD,CAAA,EAA/BT,WAA+B,CAAA,EAAA,CAAA,IAAZM,YAAY;AACjDI,iBAAAA,mBAAAA,CAAmB,CAAA,EAAIT,gBAAJ,CAAA,EAAA,CAAA,IAA4BO,iBAA5B"}
+{"version":3,"file":"human.d.cts","names":["BaseMessage","BaseMessageChunk","BaseMessageFields","$InferMessageContent","MessageStructure","HumanMessageFields","TStructure","HumanMessage","HumanMessageChunk","isHumanMessage","isHumanMessageChunk"],"sources":["../../src/messages/human.d.ts"],"sourcesContent":["import { BaseMessage, BaseMessageChunk, type BaseMessageFields } from \"./base.js\";\nimport type { $InferMessageContent, MessageStructure } from \"./message.js\";\nexport interface HumanMessageFields<TStructure extends MessageStructure = MessageStructure> extends BaseMessageFields<TStructure, \"human\"> {\n}\n/**\n * Represents a human message in a conversation.\n */\nexport declare class HumanMessage<TStructure extends MessageStructure = MessageStructure> extends BaseMessage<TStructure, \"human\"> {\n    static lc_name(): string;\n    readonly type: \"human\";\n    constructor(fields: $InferMessageContent<TStructure, \"human\"> | HumanMessageFields<TStructure>);\n    static isInstance(obj: unknown): obj is HumanMessage;\n}\n/**\n * Represents a chunk of a human message, which can be concatenated with\n * other human message chunks.\n */\nexport declare class HumanMessageChunk<TStructure extends MessageStructure = MessageStructure> extends BaseMessageChunk<TStructure, \"human\"> {\n    static lc_name(): string;\n    readonly type: \"human\";\n    constructor(fields: $InferMessageContent<TStructure, \"human\"> | HumanMessageFields<TStructure>);\n    concat(chunk: HumanMessageChunk<TStructure>): this;\n    static isInstance(obj: unknown): obj is HumanMessageChunk;\n}\n/**\n * @deprecated Use {@link HumanMessage.isInstance} instead\n */\nexport declare function isHumanMessage<TStructure extends MessageStructure>(x: BaseMessage): x is HumanMessage<TStructure>;\n/**\n * @deprecated Use {@link HumanMessageChunk.isInstance} instead\n */\nexport declare function isHumanMessageChunk<TStructure extends MessageStructure>(x: BaseMessageChunk): x is HumanMessageChunk<TStructure>;\n"],"mappings":";;;;UAEiBK,sCAAsCD,mBAAmBA,0BAA0BF,kBAAkBI;AAAtH;;;AAA0EF,cAKrDG,YALqDH,CAAAA,mBAKrBA,gBALqBA,GAKFA,gBALEA,CAAAA,SAKwBJ,WALxBI,CAKoCE,UALpCF,EAAAA,OAAAA,CAAAA,CAAAA;EAAgB,OAA4BE,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAU,SAA5BJ,IAAAA,EAAAA,OAAAA;EAAiB,WAAA,CAAA,MAAA,EAQ7FC,oBAR6F,CAQxEG,UARwE,EAAA,OAAA,CAAA,GAQjDD,kBARiD,CAQ9BC,UAR8B,CAAA;EAKhGC,OAAAA,UAAY,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAIWA,YAJX;;;;;;AAGTJ,cAOHK,iBAPGL,CAAAA,mBAOkCC,gBAPlCD,GAOqDC,gBAPrDD,CAAAA,SAO+EF,gBAP/EE,CAOgGG,UAPhGH,EAAAA,OAAAA,CAAAA,CAAAA;EAAoB,OAA2CG,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAU,SAA7BD,IAAAA,EAAAA,OAAAA;EAAkB,WAC1CE,CAAAA,MAAAA,EASpBJ,oBAToBI,CASCD,UATDC,EAAAA,OAAAA,CAAAA,GASwBF,kBATxBE,CAS2CD,UAT3CC,CAAAA;EAAY,MAJ0CP,CAAAA,KAAAA,EAchFQ,iBAdgFR,CAc9DM,UAd8DN,CAAAA,CAAAA,EAAAA,IAAAA;EAAW,OAAA,UAAA,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAejEQ,iBAfiE;AAU7G;;;;AAAwHF,iBAUhGG,cAVgGH,CAAAA,mBAU9DF,gBAV8DE,CAAAA,CAAAA,CAAAA,EAUzCN,WAVyCM,CAAAA,EAAAA,CAAAA,IAUtBC,YAVsBD,CAUTA,UAVSA,CAAAA;;;;AAGpDD,iBAW5CK,mBAX4CL,CAAAA,mBAWLD,gBAXKC,CAAAA,CAAAA,CAAAA,EAWgBJ,gBAXhBI,CAAAA,EAAAA,CAAAA,IAWwCG,iBAXxCH,CAW0DC,UAX1DD,CAAAA"}

package/dist/messages/human.d.ts

@@ -1,31 +1,36 @@
-import { BaseMessage, BaseMessageChunk, BaseMessageFields, MessageContent, MessageType } from "./base.js";
+import { BaseMessage, BaseMessageChunk, BaseMessageFields } from "./base.js";
+import { $InferMessageContent, MessageStructure } from "./message.js";
 
 //#region src/messages/human.d.ts
-type HumanMessageFields = BaseMessageFields;
+interface HumanMessageFields<TStructure extends MessageStructure = MessageStructure> extends BaseMessageFields<TStructure, "human"> {}
 /**
  * Represents a human message in a conversation.
  */
-declare class HumanMessage extends BaseMessage {
-  content: MessageContent;
+declare class HumanMessage<TStructure extends MessageStructure = MessageStructure> extends BaseMessage<TStructure, "human"> {
   static lc_name(): string;
-  _getType(): MessageType;
-  constructor(fields: string | HumanMessageFields, /** @deprecated */
-  kwargs?: Record<string, unknown>);
+  readonly type: "human";
+  constructor(fields: $InferMessageContent<TStructure, "human"> | HumanMessageFields<TStructure>);
+  static isInstance(obj: unknown): obj is HumanMessage;
 }
 /**
  * Represents a chunk of a human message, which can be concatenated with
  * other human message chunks.
  */
-declare class HumanMessageChunk extends BaseMessageChunk {
-  content: MessageContent;
+declare class HumanMessageChunk<TStructure extends MessageStructure = MessageStructure> extends BaseMessageChunk<TStructure, "human"> {
   static lc_name(): string;
-  _getType(): MessageType;
-  constructor(fields: string | HumanMessageFields, /** @deprecated */
-  kwargs?: Record<string, unknown>);
-  concat(chunk: HumanMessageChunk): HumanMessageChunk;
+  readonly type: "human";
+  constructor(fields: $InferMessageContent<TStructure, "human"> | HumanMessageFields<TStructure>);
+  concat(chunk: HumanMessageChunk<TStructure>): this;
+  static isInstance(obj: unknown): obj is HumanMessageChunk;
 }
-declare function isHumanMessage(x: BaseMessage): x is HumanMessage;
-declare function isHumanMessageChunk(x: BaseMessageChunk): x is HumanMessageChunk;
+/**
+ * @deprecated Use {@link HumanMessage.isInstance} instead
+ */
+declare function isHumanMessage<TStructure extends MessageStructure>(x: BaseMessage): x is HumanMessage<TStructure>;
+/**
+ * @deprecated Use {@link HumanMessageChunk.isInstance} instead
+ */
+declare function isHumanMessageChunk<TStructure extends MessageStructure>(x: BaseMessageChunk): x is HumanMessageChunk<TStructure>;
 //#endregion
 export { HumanMessage, HumanMessageChunk, HumanMessageFields, isHumanMessage, isHumanMessageChunk };
 //# sourceMappingURL=human.d.ts.map

package/dist/messages/human.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"human.d.ts","names":["BaseMessage","BaseMessageChunk","MessageType","BaseMessageFields","MessageContent","HumanMessageFields","HumanMessage","Record","HumanMessageChunk","isHumanMessage","isHumanMessageChunk"],"sources":["../../src/messages/human.d.ts"],"sourcesContent":["import { BaseMessage, BaseMessageChunk, type MessageType, type BaseMessageFields, type MessageContent } from \"./base.js\";\nexport type HumanMessageFields = BaseMessageFields;\n/**\n * Represents a human message in a conversation.\n */\nexport declare class HumanMessage extends BaseMessage {\n    content: MessageContent;\n    static lc_name(): string;\n    _getType(): MessageType;\n    constructor(fields: string | HumanMessageFields, \n    /** @deprecated */\n    kwargs?: Record<string, unknown>);\n}\n/**\n * Represents a chunk of a human message, which can be concatenated with\n * other human message chunks.\n */\nexport declare class HumanMessageChunk extends BaseMessageChunk {\n    content: MessageContent;\n    static lc_name(): string;\n    _getType(): MessageType;\n    constructor(fields: string | HumanMessageFields, \n    /** @deprecated */\n    kwargs?: Record<string, unknown>);\n    concat(chunk: HumanMessageChunk): HumanMessageChunk;\n}\nexport declare function isHumanMessage(x: BaseMessage): x is HumanMessage;\nexport declare function isHumanMessageChunk(x: BaseMessageChunk): x is HumanMessageChunk;\n"],"mappings":";;;KACYK,kBAAAA,GAAqBF;;AAAjC;AAIA;AAAiC,cAAZG,YAAAA,SAAqBN,WAAAA,CAAT;EAAA,OACpBI,EAAAA,cAAAA;EAAc,OAEXF,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAW,QACMG,CAAAA,CAAAA,EADjBH,WACiBG;EAAkB,WAEtCE,CAAAA,MAAAA,EAAAA,MAAAA,GAFoBF,kBAEpBE,EAAM;EANkC,MAAA,CAAA,EAMxCA,MANwC,CAAA,MAAA,EAAA,OAAA,CAAA;AAYrD;;;;;AAMaA,cANQC,iBAAAA,SAA0BP,gBAAAA,CAMlCM;EAAM,OACDC,EANLJ,cAMKI;EAAiB,OAAGA,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAiB,QAPRP,CAAAA,CAAAA,EAG/BC,WAH+BD;EAAgB,WAAA,CAAA,MAAA,EAAA,MAAA,GAI9BI,kBAJ8B,EASvCI;EAAc,MAAA,CAAA,EAHzBF,MAGyB,CAAA,MAAA,EAAA,OAAA,CAAA;EAAA,MAAIP,CAAAA,KAAAA,EAFxBQ,iBAEwBR,CAAAA,EAFJQ,iBAEIR;;AAA+B,iBAAjDS,cAAAA,CAAiD,CAAA,EAA/BT,WAA+B,CAAA,EAAA,CAAA,IAAZM,YAAY;AACjDI,iBAAAA,mBAAAA,CAAmB,CAAA,EAAIT,gBAAJ,CAAA,EAAA,CAAA,IAA4BO,iBAA5B"}
+{"version":3,"file":"human.d.ts","names":["BaseMessage","BaseMessageChunk","BaseMessageFields","$InferMessageContent","MessageStructure","HumanMessageFields","TStructure","HumanMessage","HumanMessageChunk","isHumanMessage","isHumanMessageChunk"],"sources":["../../src/messages/human.d.ts"],"sourcesContent":["import { BaseMessage, BaseMessageChunk, type BaseMessageFields } from \"./base.js\";\nimport type { $InferMessageContent, MessageStructure } from \"./message.js\";\nexport interface HumanMessageFields<TStructure extends MessageStructure = MessageStructure> extends BaseMessageFields<TStructure, \"human\"> {\n}\n/**\n * Represents a human message in a conversation.\n */\nexport declare class HumanMessage<TStructure extends MessageStructure = MessageStructure> extends BaseMessage<TStructure, \"human\"> {\n    static lc_name(): string;\n    readonly type: \"human\";\n    constructor(fields: $InferMessageContent<TStructure, \"human\"> | HumanMessageFields<TStructure>);\n    static isInstance(obj: unknown): obj is HumanMessage;\n}\n/**\n * Represents a chunk of a human message, which can be concatenated with\n * other human message chunks.\n */\nexport declare class HumanMessageChunk<TStructure extends MessageStructure = MessageStructure> extends BaseMessageChunk<TStructure, \"human\"> {\n    static lc_name(): string;\n    readonly type: \"human\";\n    constructor(fields: $InferMessageContent<TStructure, \"human\"> | HumanMessageFields<TStructure>);\n    concat(chunk: HumanMessageChunk<TStructure>): this;\n    static isInstance(obj: unknown): obj is HumanMessageChunk;\n}\n/**\n * @deprecated Use {@link HumanMessage.isInstance} instead\n */\nexport declare function isHumanMessage<TStructure extends MessageStructure>(x: BaseMessage): x is HumanMessage<TStructure>;\n/**\n * @deprecated Use {@link HumanMessageChunk.isInstance} instead\n */\nexport declare function isHumanMessageChunk<TStructure extends MessageStructure>(x: BaseMessageChunk): x is HumanMessageChunk<TStructure>;\n"],"mappings":";;;;UAEiBK,sCAAsCD,mBAAmBA,0BAA0BF,kBAAkBI;AAAtH;;;AAA0EF,cAKrDG,YALqDH,CAAAA,mBAKrBA,gBALqBA,GAKFA,gBALEA,CAAAA,SAKwBJ,WALxBI,CAKoCE,UALpCF,EAAAA,OAAAA,CAAAA,CAAAA;EAAgB,OAA4BE,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAU,SAA5BJ,IAAAA,EAAAA,OAAAA;EAAiB,WAAA,CAAA,MAAA,EAQ7FC,oBAR6F,CAQxEG,UARwE,EAAA,OAAA,CAAA,GAQjDD,kBARiD,CAQ9BC,UAR8B,CAAA;EAKhGC,OAAAA,UAAY,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAIWA,YAJX;;;;;;AAGTJ,cAOHK,iBAPGL,CAAAA,mBAOkCC,gBAPlCD,GAOqDC,gBAPrDD,CAAAA,SAO+EF,gBAP/EE,CAOgGG,UAPhGH,EAAAA,OAAAA,CAAAA,CAAAA;EAAoB,OAA2CG,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAU,SAA7BD,IAAAA,EAAAA,OAAAA;EAAkB,WAC1CE,CAAAA,MAAAA,EASpBJ,oBAToBI,CASCD,UATDC,EAAAA,OAAAA,CAAAA,GASwBF,kBATxBE,CAS2CD,UAT3CC,CAAAA;EAAY,MAJ0CP,CAAAA,KAAAA,EAchFQ,iBAdgFR,CAc9DM,UAd8DN,CAAAA,CAAAA,EAAAA,IAAAA;EAAW,OAAA,UAAA,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAejEQ,iBAfiE;AAU7G;;;;AAAwHF,iBAUhGG,cAVgGH,CAAAA,mBAU9DF,gBAV8DE,CAAAA,CAAAA,CAAAA,EAUzCN,WAVyCM,CAAAA,EAAAA,CAAAA,IAUtBC,YAVsBD,CAUTA,UAVSA,CAAAA;;;;AAGpDD,iBAW5CK,mBAX4CL,CAAAA,mBAWLD,gBAXKC,CAAAA,CAAAA,CAAAA,EAWgBJ,gBAXhBI,CAAAA,EAAAA,CAAAA,IAWwCG,iBAXxCH,CAW0DC,UAX1DD,CAAAA"}

package/dist/messages/human.js

@@ -8,39 +8,48 @@ var HumanMessage = class extends BaseMessage {
 	static lc_name() {
 		return "HumanMessage";
 	}
-	_getType() {
-		return "human";
+	type = "human";
+	constructor(fields) {
+		super(fields);
 	}
-	constructor(fields, kwargs) {
-		super(fields, kwargs);
+	static isInstance(obj) {
+		return super.isInstance(obj) && obj.type === "human";
 	}
 };
 /**
 * Represents a chunk of a human message, which can be concatenated with
 * other human message chunks.
 */
-var HumanMessageChunk = class HumanMessageChunk extends BaseMessageChunk {
+var HumanMessageChunk = class extends BaseMessageChunk {
 	static lc_name() {
 		return "HumanMessageChunk";
 	}
-	_getType() {
-		return "human";
-	}
-	constructor(fields, kwargs) {
-		super(fields, kwargs);
+	type = "human";
+	constructor(fields) {
+		super(fields);
 	}
 	concat(chunk) {
-		return new HumanMessageChunk({
+		const Cls = this.constructor;
+		return new Cls({
 			content: mergeContent(this.content, chunk.content),
 			additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
 			response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
 			id: this.id ?? chunk.id
 		});
 	}
+	static isInstance(obj) {
+		return super.isInstance(obj) && obj.type === "human";
+	}
 };
+/**
+* @deprecated Use {@link HumanMessage.isInstance} instead
+*/
 function isHumanMessage(x) {
 	return x.getType() === "human";
 }
+/**
+* @deprecated Use {@link HumanMessageChunk.isInstance} instead
+*/
 function isHumanMessageChunk(x) {
 	return x.getType() === "human";
 }

package/dist/messages/human.js.map

@@ -1 +1 @@
-{"version":3,"file":"human.js","names":["fields: string | HumanMessageFields","kwargs?: Record<string, unknown>","chunk: HumanMessageChunk","x: BaseMessage","x: BaseMessageChunk"],"sources":["../../src/messages/human.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageChunk,\n  mergeContent,\n  _mergeDicts,\n  type MessageType,\n  type BaseMessageFields,\n  type MessageContent,\n} from \"./base.js\";\n\nexport type HumanMessageFields = BaseMessageFields;\n\n/**\n * Represents a human message in a conversation.\n */\nexport class HumanMessage extends BaseMessage {\n  declare content: MessageContent;\n\n  static lc_name() {\n    return \"HumanMessage\";\n  }\n\n  _getType(): MessageType {\n    return \"human\";\n  }\n\n  constructor(\n    fields: string | HumanMessageFields,\n    /** @deprecated */\n    kwargs?: Record<string, unknown>\n  ) {\n    super(fields, kwargs);\n  }\n}\n\n/**\n * Represents a chunk of a human message, which can be concatenated with\n * other human message chunks.\n */\nexport class HumanMessageChunk extends BaseMessageChunk {\n  declare content: MessageContent;\n\n  static lc_name() {\n    return \"HumanMessageChunk\";\n  }\n\n  _getType(): MessageType {\n    return \"human\";\n  }\n\n  constructor(\n    fields: string | HumanMessageFields,\n    /** @deprecated */\n    kwargs?: Record<string, unknown>\n  ) {\n    super(fields, kwargs);\n  }\n\n  concat(chunk: HumanMessageChunk) {\n    return new HumanMessageChunk({\n      content: mergeContent(this.content, chunk.content),\n      additional_kwargs: _mergeDicts(\n        this.additional_kwargs,\n        chunk.additional_kwargs\n      ),\n      response_metadata: _mergeDicts(\n        this.response_metadata,\n        chunk.response_metadata\n      ),\n      id: this.id ?? chunk.id,\n    });\n  }\n}\n\nexport function isHumanMessage(x: BaseMessage): x is HumanMessage {\n  return x.getType() === \"human\";\n}\n\nexport function isHumanMessageChunk(\n  x: BaseMessageChunk\n): x is HumanMessageChunk {\n  return x.getType() === \"human\";\n}\n"],"mappings":";;;;;;AAeA,IAAa,eAAb,cAAkC,YAAY;CAG5C,OAAO,UAAU;AACf,SAAO;CACR;CAED,WAAwB;AACtB,SAAO;CACR;CAED,YACEA,QAEAC,QACA;EACA,MAAM,QAAQ,OAAO;CACtB;AACF;;;;;AAMD,IAAa,oBAAb,MAAa,0BAA0B,iBAAiB;CAGtD,OAAO,UAAU;AACf,SAAO;CACR;CAED,WAAwB;AACtB,SAAO;CACR;CAED,YACED,QAEAC,QACA;EACA,MAAM,QAAQ,OAAO;CACtB;CAED,OAAOC,OAA0B;AAC/B,SAAO,IAAI,kBAAkB;GAC3B,SAAS,aAAa,KAAK,SAAS,MAAM,QAAQ;GAClD,mBAAmB,YACjB,KAAK,mBACL,MAAM,kBACP;GACD,mBAAmB,YACjB,KAAK,mBACL,MAAM,kBACP;GACD,IAAI,KAAK,MAAM,MAAM;EACtB;CACF;AACF;AAED,SAAgB,eAAeC,GAAmC;AAChE,QAAO,EAAE,SAAS,KAAK;AACxB;AAED,SAAgB,oBACdC,GACwB;AACxB,QAAO,EAAE,SAAS,KAAK;AACxB"}
+{"version":3,"file":"human.js","names":["fields:\n      | $InferMessageContent<TStructure, \"human\">\n      | HumanMessageFields<TStructure>","obj: unknown","chunk: HumanMessageChunk<TStructure>","x: BaseMessage","x: BaseMessageChunk"],"sources":["../../src/messages/human.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageChunk,\n  mergeContent,\n  _mergeDicts,\n  type BaseMessageFields,\n} from \"./base.js\";\nimport type { $InferMessageContent, MessageStructure } from \"./message.js\";\nimport { Constructor } from \"./utils.js\";\n\nexport interface HumanMessageFields<\n  TStructure extends MessageStructure = MessageStructure\n> extends BaseMessageFields<TStructure, \"human\"> {}\n\n/**\n * Represents a human message in a conversation.\n */\nexport class HumanMessage<\n  TStructure extends MessageStructure = MessageStructure\n> extends BaseMessage<TStructure, \"human\"> {\n  static lc_name() {\n    return \"HumanMessage\";\n  }\n\n  readonly type = \"human\" as const;\n\n  constructor(\n    fields:\n      | $InferMessageContent<TStructure, \"human\">\n      | HumanMessageFields<TStructure>\n  ) {\n    super(fields);\n  }\n\n  static isInstance(obj: unknown): obj is HumanMessage {\n    return super.isInstance(obj) && obj.type === \"human\";\n  }\n}\n\n/**\n * Represents a chunk of a human message, which can be concatenated with\n * other human message chunks.\n */\nexport class HumanMessageChunk<\n  TStructure extends MessageStructure = MessageStructure\n> extends BaseMessageChunk<TStructure, \"human\"> {\n  static lc_name() {\n    return \"HumanMessageChunk\";\n  }\n\n  readonly type = \"human\" as const;\n\n  constructor(\n    fields:\n      | $InferMessageContent<TStructure, \"human\">\n      | HumanMessageFields<TStructure>\n  ) {\n    super(fields);\n  }\n\n  concat(chunk: HumanMessageChunk<TStructure>) {\n    const Cls = this.constructor as Constructor<this>;\n    return new Cls({\n      content: mergeContent(this.content, chunk.content),\n      additional_kwargs: _mergeDicts(\n        this.additional_kwargs,\n        chunk.additional_kwargs\n      ),\n      response_metadata: _mergeDicts(\n        this.response_metadata,\n        chunk.response_metadata\n      ),\n      id: this.id ?? chunk.id,\n    });\n  }\n\n  static isInstance(obj: unknown): obj is HumanMessageChunk {\n    return super.isInstance(obj) && obj.type === \"human\";\n  }\n}\n\n/**\n * @deprecated Use {@link HumanMessage.isInstance} instead\n */\nexport function isHumanMessage<TStructure extends MessageStructure>(\n  x: BaseMessage\n): x is HumanMessage<TStructure> {\n  return x.getType() === \"human\";\n}\n\n/**\n * @deprecated Use {@link HumanMessageChunk.isInstance} instead\n */\nexport function isHumanMessageChunk<TStructure extends MessageStructure>(\n  x: BaseMessageChunk\n): x is HumanMessageChunk<TStructure> {\n  return x.getType() === \"human\";\n}\n"],"mappings":";;;;;;AAiBA,IAAa,eAAb,cAEU,YAAiC;CACzC,OAAO,UAAU;AACf,SAAO;CACR;CAED,AAAS,OAAO;CAEhB,YACEA,QAGA;EACA,MAAM,OAAO;CACd;CAED,OAAO,WAAWC,KAAmC;AACnD,SAAO,MAAM,WAAW,IAAI,IAAI,IAAI,SAAS;CAC9C;AACF;;;;;AAMD,IAAa,oBAAb,cAEU,iBAAsC;CAC9C,OAAO,UAAU;AACf,SAAO;CACR;CAED,AAAS,OAAO;CAEhB,YACED,QAGA;EACA,MAAM,OAAO;CACd;CAED,OAAOE,OAAsC;EAC3C,MAAM,MAAM,KAAK;AACjB,SAAO,IAAI,IAAI;GACb,SAAS,aAAa,KAAK,SAAS,MAAM,QAAQ;GAClD,mBAAmB,YACjB,KAAK,mBACL,MAAM,kBACP;GACD,mBAAmB,YACjB,KAAK,mBACL,MAAM,kBACP;GACD,IAAI,KAAK,MAAM,MAAM;EACtB;CACF;CAED,OAAO,WAAWD,KAAwC;AACxD,SAAO,MAAM,WAAW,IAAI,IAAI,IAAI,SAAS;CAC9C;AACF;;;;AAKD,SAAgB,eACdE,GAC+B;AAC/B,QAAO,EAAE,SAAS,KAAK;AACxB;;;;AAKD,SAAgB,oBACdC,GACoC;AACpC,QAAO,EAAE,SAAS,KAAK;AACxB"}

package/dist/messages/index.cjs

@@ -1,6 +1,8 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_data = require('./content/data.cjs');
+const require_message = require('./message.cjs');
 const require_base = require('./base.cjs');
+const require_metadata = require('./metadata.cjs');
 const require_messages_tool = require('./tool.cjs');
 const require_ai = require('./ai.cjs');
 const require_chat = require('./chat.cjs');
@@ -43,6 +45,7 @@ require_rolldown_runtime.__export(messages_exports, {
 	defaultTextSplitter: () => require_transformers.defaultTextSplitter,
 	filterMessages: () => require_transformers.filterMessages,
 	getBufferString: () => require_utils.getBufferString,
+	iife: () => require_utils.iife,
 	isAIMessage: () => require_ai.isAIMessage,
 	isAIMessageChunk: () => require_ai.isAIMessageChunk,
 	isBase64ContentBlock: () => require_data.isBase64ContentBlock,
@@ -56,6 +59,7 @@ require_rolldown_runtime.__export(messages_exports, {
 	isHumanMessage: () => require_human.isHumanMessage,
 	isHumanMessageChunk: () => require_human.isHumanMessageChunk,
 	isIDContentBlock: () => require_data.isIDContentBlock,
+	isMessage: () => require_message.isMessage,
 	isOpenAIToolCallArray: () => require_base.isOpenAIToolCallArray,
 	isPlainTextContentBlock: () => require_data.isPlainTextContentBlock,
 	isSystemMessage: () => require_system.isSystemMessage,
@@ -68,6 +72,8 @@ require_rolldown_runtime.__export(messages_exports, {
 	mapStoredMessagesToChatMessages: () => require_utils.mapStoredMessagesToChatMessages,
 	mergeContent: () => require_base.mergeContent,
 	mergeMessageRuns: () => require_transformers.mergeMessageRuns,
+	mergeResponseMetadata: () => require_metadata.mergeResponseMetadata,
+	mergeUsageMetadata: () => require_metadata.mergeUsageMetadata,
 	parseBase64DataUrl: () => require_data.parseBase64DataUrl,
 	parseMimeType: () => require_data.parseMimeType,
 	trimMessages: () => require_transformers.trimMessages
@@ -102,6 +108,7 @@ exports.convertToProviderContentBlock = require_data.convertToProviderContentBlo
 exports.defaultTextSplitter = require_transformers.defaultTextSplitter;
 exports.filterMessages = require_transformers.filterMessages;
 exports.getBufferString = require_utils.getBufferString;
+exports.iife = require_utils.iife;
 exports.isAIMessage = require_ai.isAIMessage;
 exports.isAIMessageChunk = require_ai.isAIMessageChunk;
 exports.isBase64ContentBlock = require_data.isBase64ContentBlock;
@@ -115,6 +122,7 @@ exports.isFunctionMessageChunk = require_function.isFunctionMessageChunk;
 exports.isHumanMessage = require_human.isHumanMessage;
 exports.isHumanMessageChunk = require_human.isHumanMessageChunk;
 exports.isIDContentBlock = require_data.isIDContentBlock;
+exports.isMessage = require_message.isMessage;
 exports.isOpenAIToolCallArray = require_base.isOpenAIToolCallArray;
 exports.isPlainTextContentBlock = require_data.isPlainTextContentBlock;
 exports.isSystemMessage = require_system.isSystemMessage;
@@ -127,6 +135,8 @@ exports.mapStoredMessageToChatMessage = require_utils.mapStoredMessageToChatMess
 exports.mapStoredMessagesToChatMessages = require_utils.mapStoredMessagesToChatMessages;
 exports.mergeContent = require_base.mergeContent;
 exports.mergeMessageRuns = require_transformers.mergeMessageRuns;
+exports.mergeResponseMetadata = require_metadata.mergeResponseMetadata;
+exports.mergeUsageMetadata = require_metadata.mergeUsageMetadata;
 Object.defineProperty(exports, 'messages_exports', {
   enumerable: true,
   get: function () {

package/dist/messages/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/messages/index.ts"],"sourcesContent":["export * from \"./ai.js\";\nexport * from \"./base.js\";\nexport * from \"./chat.js\";\nexport * from \"./function.js\";\nexport * from \"./human.js\";\nexport * from \"./system.js\";\nexport * from \"./utils.js\";\nexport * from \"./transformers.js\";\nexport * from \"./modifier.js\";\n// TODO: Use a star export when we deprecate the\n// existing \"ToolCall\" type in \"base.js\".\nexport {\n  type ToolMessageFieldsWithToolCallId,\n  ToolMessage,\n  ToolMessageChunk,\n  type InvalidToolCall,\n  isToolMessage,\n  isToolMessageChunk,\n} from \"./tool.js\";\n\n// This is an old export for backwards compatibility with existing multimodal content blocks\n// TODO: remove this in v2\nexport * from \"./content/data.js\";\nexport * from \"./content/index.js\";\n"],"mappings":""}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/messages/index.ts"],"sourcesContent":["export * from \"./ai.js\";\nexport * from \"./base.js\";\nexport * from \"./chat.js\";\nexport * from \"./function.js\";\nexport * from \"./human.js\";\nexport * from \"./system.js\";\nexport * from \"./utils.js\";\nexport * from \"./transformers.js\";\nexport * from \"./metadata.js\";\nexport * from \"./message.js\";\nexport * from \"./modifier.js\";\n// TODO: Use a star export when we deprecate the\n// existing \"ToolCall\" type in \"base.js\".\nexport {\n  type ToolMessageFields,\n  ToolMessage,\n  ToolMessageChunk,\n  type InvalidToolCall,\n  isToolMessage,\n  isToolMessageChunk,\n} from \"./tool.js\";\n\n// This is an old export for backwards compatibility with existing multimodal content blocks\n// TODO: remove this in v2\nexport * from \"./content/data.js\";\nexport * from \"./content/index.js\";\n"],"mappings":""}

package/dist/messages/index.d.cts

@@ -1,13 +1,15 @@
 import { Data, ImageDetail, MessageContentComplex, MessageContentImageUrl, MessageContentText, ProviderFormatTypes, StandardContentBlockConverter, convertToOpenAIImageBlock, convertToProviderContentBlock, isBase64ContentBlock, isDataContentBlock, isIDContentBlock, isPlainTextContentBlock, isURLContentBlock, parseBase64DataUrl, parseMimeType } from "./content/data.cjs";
 import { ContentBlock, KNOWN_BLOCK_TYPES } from "./content/index.cjs";
-import { BaseMessage, BaseMessageChunk, BaseMessageFields, BaseMessageLike, FunctionCall, MessageContent, MessageFieldWithRole, MessageType, OpenAIToolCall, StoredGeneration, StoredMessage, StoredMessageData, StoredMessageV1, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, isBaseMessage, isBaseMessageChunk, isOpenAIToolCallArray, mergeContent } from "./base.cjs";
-import { InvalidToolCall, ToolMessage, ToolMessageChunk, ToolMessageFieldsWithToolCallId, isToolMessage, isToolMessageChunk } from "./tool.cjs";
-import { AIMessage, AIMessageChunk, AIMessageChunkFields, AIMessageFields, InputTokenDetails, ModalitiesTokenDetails, OutputTokenDetails, UsageMetadata, isAIMessage, isAIMessageChunk } from "./ai.cjs";
-import { ChatMessage, ChatMessageChunk, ChatMessageFieldsWithRole, isChatMessage, isChatMessageChunk } from "./chat.cjs";
-import { FunctionMessage, FunctionMessageChunk, FunctionMessageFieldsWithName, isFunctionMessage, isFunctionMessageChunk } from "./function.cjs";
+import { InputTokenDetails, ModalitiesTokenDetails, OutputTokenDetails, ResponseMetadata, UsageMetadata, mergeResponseMetadata, mergeUsageMetadata } from "./metadata.cjs";
+import { BaseMessage, BaseMessageChunk, BaseMessageFields, BaseMessageLike, FunctionCall, MessageContent, MessageFieldWithRole, OpenAIToolCall, StoredGeneration, StoredMessage, StoredMessageData, StoredMessageV1, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, isBaseMessage, isBaseMessageChunk, isOpenAIToolCallArray, mergeContent } from "./base.cjs";
+import { InvalidToolCall, ToolMessage, ToolMessageChunk, ToolMessageFields, isToolMessage, isToolMessageChunk } from "./tool.cjs";
+import { AIMessage, AIMessageChunk, AIMessageChunkFields, AIMessageFields, isAIMessage, isAIMessageChunk } from "./ai.cjs";
+import { ChatMessage, ChatMessageChunk, ChatMessageFields, isChatMessage, isChatMessageChunk } from "./chat.cjs";
+import { FunctionMessage, FunctionMessageChunk, FunctionMessageFields, isFunctionMessage, isFunctionMessageChunk } from "./function.cjs";
 import { HumanMessage, HumanMessageChunk, HumanMessageFields, isHumanMessage, isHumanMessageChunk } from "./human.cjs";
 import { SystemMessage, SystemMessageChunk, SystemMessageFields, isSystemMessage, isSystemMessageChunk } from "./system.cjs";
-import { coerceMessageLikeToMessage, convertToChunk, getBufferString, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages } from "./utils.cjs";
+import { $Expand, $MergeDiscriminatedUnion, $MergeObjects, Constructor, coerceMessageLikeToMessage, convertToChunk, getBufferString, iife, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages } from "./utils.cjs";
+import { $InferMessageContent, $InferMessageContentBlocks, $InferMessageProperties, $InferMessageProperty, $InferResponseMetadata, $MergeContentDefinition, $MergeMessageStructure, $MergeOutputVersion, $MessageToolCallBlock, $NormalizedMessageStructure, Message, MessageOutputVersion, MessageStructure, MessageToolDefinition, MessageToolSet, MessageType, StandardMessageStructure, isMessage } from "./message.cjs";
 import { RemoveMessage, RemoveMessageFields } from "./modifier.cjs";
 import { FilterMessagesFields, MessageChunkUnion, MessageTypeOrClass, MessageUnion, TrimMessagesFields, defaultTextSplitter, filterMessages, mergeMessageRuns, trimMessages } from "./transformers.cjs";
-export { AIMessage, AIMessageChunk, AIMessageChunkFields, AIMessageFields, BaseMessage, BaseMessageChunk, BaseMessageFields, BaseMessageLike, ChatMessage, ChatMessageChunk, ChatMessageFieldsWithRole, ContentBlock, Data, FilterMessagesFields, FunctionCall, FunctionMessage, FunctionMessageChunk, FunctionMessageFieldsWithName, HumanMessage, HumanMessageChunk, HumanMessageFields, ImageDetail, InputTokenDetails, type InvalidToolCall, KNOWN_BLOCK_TYPES, MessageChunkUnion, MessageContent, MessageContentComplex, MessageContentImageUrl, MessageContentText, MessageFieldWithRole, MessageType, MessageTypeOrClass, MessageUnion, ModalitiesTokenDetails, OpenAIToolCall, OutputTokenDetails, ProviderFormatTypes, RemoveMessage, RemoveMessageFields, StandardContentBlockConverter, StoredGeneration, StoredMessage, StoredMessageData, StoredMessageV1, SystemMessage, SystemMessageChunk, SystemMessageFields, ToolMessage, ToolMessageChunk, type ToolMessageFieldsWithToolCallId, TrimMessagesFields, UsageMetadata, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, coerceMessageLikeToMessage, convertToChunk, convertToOpenAIImageBlock, convertToProviderContentBlock, defaultTextSplitter, filterMessages, getBufferString, isAIMessage, isAIMessageChunk, isBase64ContentBlock, isBaseMessage, isBaseMessageChunk, isChatMessage, isChatMessageChunk, isDataContentBlock, isFunctionMessage, isFunctionMessageChunk, isHumanMessage, isHumanMessageChunk, isIDContentBlock, isOpenAIToolCallArray, isPlainTextContentBlock, isSystemMessage, isSystemMessageChunk, isToolMessage, isToolMessageChunk, isURLContentBlock, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages, mergeContent, mergeMessageRuns, parseBase64DataUrl, parseMimeType, trimMessages };
+export { $Expand, $InferMessageContent, $InferMessageContentBlocks, $InferMessageProperties, $InferMessageProperty, $InferResponseMetadata, $MergeContentDefinition, $MergeDiscriminatedUnion, $MergeMessageStructure, $MergeObjects, $MergeOutputVersion, $MessageToolCallBlock, $NormalizedMessageStructure, AIMessage, AIMessageChunk, AIMessageChunkFields, AIMessageFields, BaseMessage, BaseMessageChunk, BaseMessageFields, BaseMessageLike, ChatMessage, ChatMessageChunk, ChatMessageFields, Constructor, ContentBlock, Data, FilterMessagesFields, FunctionCall, FunctionMessage, FunctionMessageChunk, FunctionMessageFields, HumanMessage, HumanMessageChunk, HumanMessageFields, ImageDetail, InputTokenDetails, type InvalidToolCall, KNOWN_BLOCK_TYPES, Message, MessageChunkUnion, MessageContent, MessageContentComplex, MessageContentImageUrl, MessageContentText, MessageFieldWithRole, MessageOutputVersion, MessageStructure, MessageToolDefinition, MessageToolSet, MessageType, MessageTypeOrClass, MessageUnion, ModalitiesTokenDetails, OpenAIToolCall, OutputTokenDetails, ProviderFormatTypes, RemoveMessage, RemoveMessageFields, ResponseMetadata, StandardContentBlockConverter, StandardMessageStructure, StoredGeneration, StoredMessage, StoredMessageData, StoredMessageV1, SystemMessage, SystemMessageChunk, SystemMessageFields, ToolMessage, ToolMessageChunk, type ToolMessageFields, TrimMessagesFields, UsageMetadata, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, coerceMessageLikeToMessage, convertToChunk, convertToOpenAIImageBlock, convertToProviderContentBlock, defaultTextSplitter, filterMessages, getBufferString, iife, isAIMessage, isAIMessageChunk, isBase64ContentBlock, isBaseMessage, isBaseMessageChunk, isChatMessage, isChatMessageChunk, isDataContentBlock, isFunctionMessage, isFunctionMessageChunk, isHumanMessage, isHumanMessageChunk, isIDContentBlock, isMessage, isOpenAIToolCallArray, isPlainTextContentBlock, isSystemMessage, isSystemMessageChunk, isToolMessage, isToolMessageChunk, isURLContentBlock, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages, mergeContent, mergeMessageRuns, mergeResponseMetadata, mergeUsageMetadata, parseBase64DataUrl, parseMimeType, trimMessages };

package/dist/messages/index.d.ts

@@ -1,13 +1,15 @@
 import { Data, ImageDetail, MessageContentComplex, MessageContentImageUrl, MessageContentText, ProviderFormatTypes, StandardContentBlockConverter, convertToOpenAIImageBlock, convertToProviderContentBlock, isBase64ContentBlock, isDataContentBlock, isIDContentBlock, isPlainTextContentBlock, isURLContentBlock, parseBase64DataUrl, parseMimeType } from "./content/data.js";
 import { ContentBlock, KNOWN_BLOCK_TYPES } from "./content/index.js";
-import { BaseMessage, BaseMessageChunk, BaseMessageFields, BaseMessageLike, FunctionCall, MessageContent, MessageFieldWithRole, MessageType, OpenAIToolCall, StoredGeneration, StoredMessage, StoredMessageData, StoredMessageV1, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, isBaseMessage, isBaseMessageChunk, isOpenAIToolCallArray, mergeContent } from "./base.js";
-import { InvalidToolCall, ToolMessage, ToolMessageChunk, ToolMessageFieldsWithToolCallId, isToolMessage, isToolMessageChunk } from "./tool.js";
-import { AIMessage, AIMessageChunk, AIMessageChunkFields, AIMessageFields, InputTokenDetails, ModalitiesTokenDetails, OutputTokenDetails, UsageMetadata, isAIMessage, isAIMessageChunk } from "./ai.js";
-import { ChatMessage, ChatMessageChunk, ChatMessageFieldsWithRole, isChatMessage, isChatMessageChunk } from "./chat.js";
-import { FunctionMessage, FunctionMessageChunk, FunctionMessageFieldsWithName, isFunctionMessage, isFunctionMessageChunk } from "./function.js";
+import { InputTokenDetails, ModalitiesTokenDetails, OutputTokenDetails, ResponseMetadata, UsageMetadata, mergeResponseMetadata, mergeUsageMetadata } from "./metadata.js";
+import { BaseMessage, BaseMessageChunk, BaseMessageFields, BaseMessageLike, FunctionCall, MessageContent, MessageFieldWithRole, OpenAIToolCall, StoredGeneration, StoredMessage, StoredMessageData, StoredMessageV1, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, isBaseMessage, isBaseMessageChunk, isOpenAIToolCallArray, mergeContent } from "./base.js";
+import { InvalidToolCall, ToolMessage, ToolMessageChunk, ToolMessageFields, isToolMessage, isToolMessageChunk } from "./tool.js";
+import { AIMessage, AIMessageChunk, AIMessageChunkFields, AIMessageFields, isAIMessage, isAIMessageChunk } from "./ai.js";
+import { ChatMessage, ChatMessageChunk, ChatMessageFields, isChatMessage, isChatMessageChunk } from "./chat.js";
+import { FunctionMessage, FunctionMessageChunk, FunctionMessageFields, isFunctionMessage, isFunctionMessageChunk } from "./function.js";
 import { HumanMessage, HumanMessageChunk, HumanMessageFields, isHumanMessage, isHumanMessageChunk } from "./human.js";
 import { SystemMessage, SystemMessageChunk, SystemMessageFields, isSystemMessage, isSystemMessageChunk } from "./system.js";
-import { coerceMessageLikeToMessage, convertToChunk, getBufferString, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages } from "./utils.js";
+import { $Expand, $MergeDiscriminatedUnion, $MergeObjects, Constructor, coerceMessageLikeToMessage, convertToChunk, getBufferString, iife, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages } from "./utils.js";
+import { $InferMessageContent, $InferMessageContentBlocks, $InferMessageProperties, $InferMessageProperty, $InferResponseMetadata, $MergeContentDefinition, $MergeMessageStructure, $MergeOutputVersion, $MessageToolCallBlock, $NormalizedMessageStructure, Message, MessageOutputVersion, MessageStructure, MessageToolDefinition, MessageToolSet, MessageType, StandardMessageStructure, isMessage } from "./message.js";
 import { RemoveMessage, RemoveMessageFields } from "./modifier.js";
 import { FilterMessagesFields, MessageChunkUnion, MessageTypeOrClass, MessageUnion, TrimMessagesFields, defaultTextSplitter, filterMessages, mergeMessageRuns, trimMessages } from "./transformers.js";
-export { AIMessage, AIMessageChunk, AIMessageChunkFields, AIMessageFields, BaseMessage, BaseMessageChunk, BaseMessageFields, BaseMessageLike, ChatMessage, ChatMessageChunk, ChatMessageFieldsWithRole, ContentBlock, Data, FilterMessagesFields, FunctionCall, FunctionMessage, FunctionMessageChunk, FunctionMessageFieldsWithName, HumanMessage, HumanMessageChunk, HumanMessageFields, ImageDetail, InputTokenDetails, type InvalidToolCall, KNOWN_BLOCK_TYPES, MessageChunkUnion, MessageContent, MessageContentComplex, MessageContentImageUrl, MessageContentText, MessageFieldWithRole, MessageType, MessageTypeOrClass, MessageUnion, ModalitiesTokenDetails, OpenAIToolCall, OutputTokenDetails, ProviderFormatTypes, RemoveMessage, RemoveMessageFields, StandardContentBlockConverter, StoredGeneration, StoredMessage, StoredMessageData, StoredMessageV1, SystemMessage, SystemMessageChunk, SystemMessageFields, ToolMessage, ToolMessageChunk, type ToolMessageFieldsWithToolCallId, TrimMessagesFields, UsageMetadata, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, coerceMessageLikeToMessage, convertToChunk, convertToOpenAIImageBlock, convertToProviderContentBlock, defaultTextSplitter, filterMessages, getBufferString, isAIMessage, isAIMessageChunk, isBase64ContentBlock, isBaseMessage, isBaseMessageChunk, isChatMessage, isChatMessageChunk, isDataContentBlock, isFunctionMessage, isFunctionMessageChunk, isHumanMessage, isHumanMessageChunk, isIDContentBlock, isOpenAIToolCallArray, isPlainTextContentBlock, isSystemMessage, isSystemMessageChunk, isToolMessage, isToolMessageChunk, isURLContentBlock, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages, mergeContent, mergeMessageRuns, parseBase64DataUrl, parseMimeType, trimMessages };
+export { $Expand, $InferMessageContent, $InferMessageContentBlocks, $InferMessageProperties, $InferMessageProperty, $InferResponseMetadata, $MergeContentDefinition, $MergeDiscriminatedUnion, $MergeMessageStructure, $MergeObjects, $MergeOutputVersion, $MessageToolCallBlock, $NormalizedMessageStructure, AIMessage, AIMessageChunk, AIMessageChunkFields, AIMessageFields, BaseMessage, BaseMessageChunk, BaseMessageFields, BaseMessageLike, ChatMessage, ChatMessageChunk, ChatMessageFields, Constructor, ContentBlock, Data, FilterMessagesFields, FunctionCall, FunctionMessage, FunctionMessageChunk, FunctionMessageFields, HumanMessage, HumanMessageChunk, HumanMessageFields, ImageDetail, InputTokenDetails, type InvalidToolCall, KNOWN_BLOCK_TYPES, Message, MessageChunkUnion, MessageContent, MessageContentComplex, MessageContentImageUrl, MessageContentText, MessageFieldWithRole, MessageOutputVersion, MessageStructure, MessageToolDefinition, MessageToolSet, MessageType, MessageTypeOrClass, MessageUnion, ModalitiesTokenDetails, OpenAIToolCall, OutputTokenDetails, ProviderFormatTypes, RemoveMessage, RemoveMessageFields, ResponseMetadata, StandardContentBlockConverter, StandardMessageStructure, StoredGeneration, StoredMessage, StoredMessageData, StoredMessageV1, SystemMessage, SystemMessageChunk, SystemMessageFields, ToolMessage, ToolMessageChunk, type ToolMessageFields, TrimMessagesFields, UsageMetadata, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, coerceMessageLikeToMessage, convertToChunk, convertToOpenAIImageBlock, convertToProviderContentBlock, defaultTextSplitter, filterMessages, getBufferString, iife, isAIMessage, isAIMessageChunk, isBase64ContentBlock, isBaseMessage, isBaseMessageChunk, isChatMessage, isChatMessageChunk, isDataContentBlock, isFunctionMessage, isFunctionMessageChunk, isHumanMessage, isHumanMessageChunk, isIDContentBlock, isMessage, isOpenAIToolCallArray, isPlainTextContentBlock, isSystemMessage, isSystemMessageChunk, isToolMessage, isToolMessageChunk, isURLContentBlock, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages, mergeContent, mergeMessageRuns, mergeResponseMetadata, mergeUsageMetadata, parseBase64DataUrl, parseMimeType, trimMessages };

package/dist/messages/index.js

@@ -1,13 +1,15 @@
 import { __export } from "../_virtual/rolldown_runtime.js";
 import { convertToOpenAIImageBlock, convertToProviderContentBlock, isBase64ContentBlock, isDataContentBlock, isIDContentBlock, isPlainTextContentBlock, isURLContentBlock, parseBase64DataUrl, parseMimeType } from "./content/data.js";
+import { isMessage } from "./message.js";
 import { BaseMessage, BaseMessageChunk, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, isBaseMessage, isBaseMessageChunk, isOpenAIToolCallArray, mergeContent } from "./base.js";
+import { mergeResponseMetadata, mergeUsageMetadata } from "./metadata.js";
 import { ToolMessage, ToolMessageChunk, isToolMessage, isToolMessageChunk } from "./tool.js";
 import { AIMessage, AIMessageChunk, isAIMessage, isAIMessageChunk } from "./ai.js";
 import { ChatMessage, ChatMessageChunk, isChatMessage, isChatMessageChunk } from "./chat.js";
 import { FunctionMessage, FunctionMessageChunk, isFunctionMessage, isFunctionMessageChunk } from "./function.js";
 import { HumanMessage, HumanMessageChunk, isHumanMessage, isHumanMessageChunk } from "./human.js";
 import { SystemMessage, SystemMessageChunk, isSystemMessage, isSystemMessageChunk } from "./system.js";
-import { coerceMessageLikeToMessage, convertToChunk, getBufferString, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages } from "./utils.js";
+import { coerceMessageLikeToMessage, convertToChunk, getBufferString, iife, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages } from "./utils.js";
 import { RemoveMessage } from "./modifier.js";
 import { defaultTextSplitter, filterMessages, mergeMessageRuns, trimMessages } from "./transformers.js";
 import { KNOWN_BLOCK_TYPES } from "./content/index.js";
@@ -43,6 +45,7 @@ __export(messages_exports, {
 	defaultTextSplitter: () => defaultTextSplitter,
 	filterMessages: () => filterMessages,
 	getBufferString: () => getBufferString,
+	iife: () => iife,
 	isAIMessage: () => isAIMessage,
 	isAIMessageChunk: () => isAIMessageChunk,
 	isBase64ContentBlock: () => isBase64ContentBlock,
@@ -56,6 +59,7 @@ __export(messages_exports, {
 	isHumanMessage: () => isHumanMessage,
 	isHumanMessageChunk: () => isHumanMessageChunk,
 	isIDContentBlock: () => isIDContentBlock,
+	isMessage: () => isMessage,
 	isOpenAIToolCallArray: () => isOpenAIToolCallArray,
 	isPlainTextContentBlock: () => isPlainTextContentBlock,
 	isSystemMessage: () => isSystemMessage,
@@ -68,11 +72,13 @@ __export(messages_exports, {
 	mapStoredMessagesToChatMessages: () => mapStoredMessagesToChatMessages,
 	mergeContent: () => mergeContent,
 	mergeMessageRuns: () => mergeMessageRuns,
+	mergeResponseMetadata: () => mergeResponseMetadata,
+	mergeUsageMetadata: () => mergeUsageMetadata,
 	parseBase64DataUrl: () => parseBase64DataUrl,
 	parseMimeType: () => parseMimeType,
 	trimMessages: () => trimMessages
 });
 
 //#endregion
-export { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, ChatMessage, ChatMessageChunk, FunctionMessage, FunctionMessageChunk, HumanMessage, HumanMessageChunk, KNOWN_BLOCK_TYPES, RemoveMessage, SystemMessage, SystemMessageChunk, ToolMessage, ToolMessageChunk, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, coerceMessageLikeToMessage, convertToChunk, convertToOpenAIImageBlock, convertToProviderContentBlock, defaultTextSplitter, filterMessages, getBufferString, isAIMessage, isAIMessageChunk, isBase64ContentBlock, isBaseMessage, isBaseMessageChunk, isChatMessage, isChatMessageChunk, isDataContentBlock, isFunctionMessage, isFunctionMessageChunk, isHumanMessage, isHumanMessageChunk, isIDContentBlock, isOpenAIToolCallArray, isPlainTextContentBlock, isSystemMessage, isSystemMessageChunk, isToolMessage, isToolMessageChunk, isURLContentBlock, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages, mergeContent, mergeMessageRuns, messages_exports, parseBase64DataUrl, parseMimeType, trimMessages };
+export { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, ChatMessage, ChatMessageChunk, FunctionMessage, FunctionMessageChunk, HumanMessage, HumanMessageChunk, KNOWN_BLOCK_TYPES, RemoveMessage, SystemMessage, SystemMessageChunk, ToolMessage, ToolMessageChunk, _isMessageFieldWithRole, _mergeDicts, _mergeLists, _mergeObj, _mergeStatus, coerceMessageLikeToMessage, convertToChunk, convertToOpenAIImageBlock, convertToProviderContentBlock, defaultTextSplitter, filterMessages, getBufferString, iife, isAIMessage, isAIMessageChunk, isBase64ContentBlock, isBaseMessage, isBaseMessageChunk, isChatMessage, isChatMessageChunk, isDataContentBlock, isFunctionMessage, isFunctionMessageChunk, isHumanMessage, isHumanMessageChunk, isIDContentBlock, isMessage, isOpenAIToolCallArray, isPlainTextContentBlock, isSystemMessage, isSystemMessageChunk, isToolMessage, isToolMessageChunk, isURLContentBlock, mapChatMessagesToStoredMessages, mapStoredMessageToChatMessage, mapStoredMessagesToChatMessages, mergeContent, mergeMessageRuns, mergeResponseMetadata, mergeUsageMetadata, messages_exports, parseBase64DataUrl, parseMimeType, trimMessages };
 //# sourceMappingURL=index.js.map

package/dist/messages/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/messages/index.ts"],"sourcesContent":["export * from \"./ai.js\";\nexport * from \"./base.js\";\nexport * from \"./chat.js\";\nexport * from \"./function.js\";\nexport * from \"./human.js\";\nexport * from \"./system.js\";\nexport * from \"./utils.js\";\nexport * from \"./transformers.js\";\nexport * from \"./modifier.js\";\n// TODO: Use a star export when we deprecate the\n// existing \"ToolCall\" type in \"base.js\".\nexport {\n  type ToolMessageFieldsWithToolCallId,\n  ToolMessage,\n  ToolMessageChunk,\n  type InvalidToolCall,\n  isToolMessage,\n  isToolMessageChunk,\n} from \"./tool.js\";\n\n// This is an old export for backwards compatibility with existing multimodal content blocks\n// TODO: remove this in v2\nexport * from \"./content/data.js\";\nexport * from \"./content/index.js\";\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/messages/index.ts"],"sourcesContent":["export * from \"./ai.js\";\nexport * from \"./base.js\";\nexport * from \"./chat.js\";\nexport * from \"./function.js\";\nexport * from \"./human.js\";\nexport * from \"./system.js\";\nexport * from \"./utils.js\";\nexport * from \"./transformers.js\";\nexport * from \"./metadata.js\";\nexport * from \"./message.js\";\nexport * from \"./modifier.js\";\n// TODO: Use a star export when we deprecate the\n// existing \"ToolCall\" type in \"base.js\".\nexport {\n  type ToolMessageFields,\n  ToolMessage,\n  ToolMessageChunk,\n  type InvalidToolCall,\n  isToolMessage,\n  isToolMessageChunk,\n} from \"./tool.js\";\n\n// This is an old export for backwards compatibility with existing multimodal content blocks\n// TODO: remove this in v2\nexport * from \"./content/data.js\";\nexport * from \"./content/index.js\";\n"],"mappings":""}

package/dist/messages/message.cjs

@@ -0,0 +1,15 @@
+
+//#region src/messages/message.ts
+/**
+* Type guard to check if a value is a valid Message object.
+*
+* @param message - The value to check
+* @returns true if the value is a valid Message object, false otherwise
+*/
+function isMessage(message) {
+	return typeof message === "object" && message !== null && "type" in message && "content" in message && (typeof message.content === "string" || Array.isArray(message.content));
+}
+
+//#endregion
+exports.isMessage = isMessage;
+//# sourceMappingURL=message.cjs.map

package/dist/messages/message.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.cjs","names":["message: unknown"],"sources":["../../src/messages/message.ts"],"sourcesContent":["import type { ContentBlock } from \"./content/index.js\";\nimport type { ResponseMetadata, UsageMetadata } from \"./metadata.js\";\nimport type { $MergeDiscriminatedUnion, $MergeObjects } from \"./utils.js\";\n\n/**\n * Represents the possible types of messages in the system.\n * Includes standard message types (\"ai\", \"human\", \"tool\", \"system\")\n * and allows for custom string types that are non-null.\n *\n * @example\n * ```ts\n * // Standard message types\n * const messageType1: MessageType = \"ai\";\n * const messageType2: MessageType = \"human\";\n *\n * // Custom message type\n * const messageType3: MessageType = \"custom_type\";\n * ```\n */\nexport type MessageType =\n  | \"ai\"\n  | \"human\"\n  | \"tool\"\n  | \"system\"\n  | (string & NonNullable<unknown>);\n\n/**\n * Represents the output version format for message content.\n *\n * This type determines how the content field is structured in a message:\n * - \"v0\": Content is represented as a simple string or array of content blocks\n *   - provides backward compatibility with simpler content representations\n * - \"v1\": Content follows the structured ContentBlock format with typed discriminated unions\n *   - enables full type safety and structured content block handling\n *\n * @example\n * ```ts\n * // v0 format - simple content representation\n * const v0Message: Message<{ outputVersion: \"v0\", content: ... }> = {\n *   type: \"human\",\n *   content: \"Hello world\" // string | Array<ContentBlock | ContentBlock.Text>\n * };\n *\n * // v1 format - structured content blocks\n * const v1Message: Message<{ outputVersion: \"v1\", content: ... }> = {\n *   type: \"human\",\n *   content: [\n *     { type: \"text\", text: \"Hello world\" },\n *     { type: \"image\", image_url: \"...\" }\n *   ] // Array<ContentBlock | ...> (determined by the structure)\n * };\n * ```\n */\nexport type MessageOutputVersion = \"v0\" | \"v1\";\n\n/**\n * Represents the input and output types of a tool that can be used in messages.\n *\n * @template TInput - The type of input the tool accepts.\n * @template TOutput - The type of output the tool produces.\n *\n * @example\n * ```ts\n * // Tool that takes a string input and returns a number\n * interface StringToNumberTool extends MessageToolDefinition<string, number> {\n *   input: string;\n *   output: number;\n * }\n * ```\n */\nexport interface MessageToolDefinition<TInput = unknown, TOutput = unknown> {\n  input: TInput;\n  output: TOutput;\n}\n\n/**\n * Represents a structured set of tools by mapping tool names to definitions\n * that can be used in messages.\n *\n * @example\n * ```ts\n * interface MyToolSet extends MessageToolSet {\n *   calculator: MessageToolDefinition<\n *     { operation: string; numbers: number[] },\n *     number\n *   >;\n *   translator: MessageToolDefinition<\n *     { text: string; targetLanguage: string },\n *     string\n *   >;\n * }\n * ```\n */\nexport interface MessageToolSet {\n  [key: string]: MessageToolDefinition;\n}\n\n/**\n * Represents a tool call block within a message structure by mapping tool names to their\n * corresponding tool call formats, including the input arguments and an optional identifier.\n *\n * @template TStructure - A message structure type that may contain tool definitions\n *\n * @example\n * ```ts\n * // Given a message structure with a calculator tool:\n * interface MyStructure extends MessageStructure {\n *   tools: {\n *     calculator: MessageToolDefinition<{ operation: string, numbers: number[] }, number>\n *   }\n * }\n *\n * // The tool call block would be:\n * type CalcToolCall = $MessageToolCallBlock<MyStructure>;\n * // Resolves to:\n * // {\n * //   type: \"tool_call\";\n * //   name: \"calculator\";\n * //   args: { operation: string, numbers: number[] };\n * //   id?: string;\n * // }\n * ```\n */\nexport type $MessageToolCallBlock<TStructure extends MessageStructure> =\n  TStructure[\"tools\"] extends MessageToolSet\n    ? {\n        [K in keyof TStructure[\"tools\"]]: K extends string\n          ? TStructure[\"tools\"][K] extends MessageToolDefinition\n            ? ContentBlock.Tools.ToolCall<K, TStructure[\"tools\"][K][\"input\"]>\n            : never\n          : never;\n      }[keyof TStructure[\"tools\"]]\n    : never;\n\n/**\n * Core interface that defines the structure of messages.\n *\n * @example\n * ```ts\n * // Basic message structure with just content blocks\n * interface SimpleMessageStructure extends MessageStructure {\n *   content: {\n *     human: ContentBlock.Text;\n *     // allows for text + reasoning blocks in ai messages\n *     ai: ContentBlock.Text | ContentBlock.Reasoning;\n *   }\n * }\n *\n * // Message structure with tools and properties\n * interface AdvancedMessageStructure extends MessageStructure {\n *   tools: {\n *     calculator: MessageToolDefinition<\n *       { operation: string; numbers: number[] },\n *       number\n *     >;\n *   };\n *   content: {\n *     // allows for text + image blocks in human messages\n *     human: ContentBlock.Text | ContentBlock.Multimodal.Image;\n *     // only allows for text blocks in ai messages\n *     ai: ContentBlock.Text;\n *   };\n *   properties: {\n *     // pins properties to ai messages\n *     ai: {\n *       response_metadata: {\n *         confidence: number;\n *         model: string;\n *       };\n *     };\n *   }\n * }\n *\n * // Using with $MergeMessageStructure to combine structures\n * // The resulting type when passed into BaseMessage will have a calculator tool,\n * // allow for text + image blocks in human messages,\n * // and text + reasoning blocks + additional arbitrary properties in ai messages.\n * type CombinedStructure = $MergeMessageStructure<\n *   SimpleMessageStructure,\n *   AdvancedMessageStructure\n * >;\n *\n * // Using in a Message object\n * const message: Message<CombinedStructure> = {\n *   id: \"msg-123\",\n *   type: \"human\",\n *   content: [\n *     { type: \"text\", text: \"Hello!\" }\n *     { type: \"image\", mimeType: \"image/jpeg\", url: \"https://example.com/image.jpg\" }\n *     // this block will throw an error because it's not defined in the structure\n *     { type: \"reasoning\", reasoning: \"The answer is 42\" }\n *   ]\n * };\n * ```\n */\nexport interface MessageStructure {\n  /**\n   * Optional output version for the message structure.\n   * If not provided, defaults to \"v0\".\n   */\n  readonly outputVersion?: MessageOutputVersion;\n  /**\n   * Optional set of tool definitions that can be used in messages.\n   * Each tool is defined with input/output types and can be referenced in tool messages.\n   */\n  readonly tools?: MessageToolSet;\n  /**\n   * Optional mapping of message types to their allowed content blocks.\n   * Each message type can specify what content block types it supports (text, images, etc).\n   */\n  readonly content?: Partial<{\n    [key in MessageType]: ContentBlock;\n  }>;\n  /**\n   * Optional mapping of message types to arbitrary property objects.\n   * Allows attaching custom metadata or other information to specific message types.\n   */\n  readonly properties?: Partial<{\n    [key in MessageType]: Record<string, unknown>;\n  }>;\n}\n\n/**\n * Normalizes an arbitrary type to a message output version or undefined.\n * Accepts unknown and narrows to a valid MessageOutputVersion if present.\n */\ntype $NormalizeMessageOutputVersion<T> =\n  | Extract<T, MessageOutputVersion>\n  | undefined;\n\n/**\n * Merges two output version types from message structures.\n *\n * This utility type determines the resulting output version when combining two message structures.\n * The merge logic follows these rules:\n *\n * - If both T and U are undefined, defaults to \"v0\" for backwards compatibility\n * - If T is undefined but U is defined, uses U's version\n * - If U is undefined but T is defined, uses T's version\n * - If both T and U are defined, U takes precedence (later structure wins)\n *\n * @template T - The output version from the first message structure\n * @template U - The output version from the second message structure\n *\n * @example\n * ```ts\n * // Both undefined - defaults to \"v0\"\n * type Result1 = $MergeOutputVersion<undefined, undefined>; // \"v0\"\n *\n * // One defined - uses the defined version\n * type Result2 = $MergeOutputVersion<undefined, \"v1\">; // \"v1\"\n * type Result3 = $MergeOutputVersion<\"v0\", undefined>; // \"v0\"\n *\n * // Both defined - second takes precedence\n * type Result4 = $MergeOutputVersion<\"v0\", \"v1\">; // \"v1\"\n * ```\n */\nexport type $MergeOutputVersion<T, U> =\n  $NormalizeMessageOutputVersion<T> extends infer TV\n    ? $NormalizeMessageOutputVersion<U> extends infer UV\n      ? [TV, UV] extends [undefined, undefined]\n        ? \"v0\"\n        : [TV] extends [undefined]\n        ? Exclude<UV, undefined>\n        : [UV] extends [undefined]\n        ? Exclude<TV, undefined>\n        : UV\n      : never\n    : never;\n\n/**\n * Merges two content definition objects from message structures.\n *\n * This utility type combines content definitions from two message structures, handling\n * the merging of content block types for each message type. The merge logic follows\n * these rules:\n *\n * - For keys that exist in both T and U: Merges the content blocks using discriminated\n *   union merging based on the \"type\" property. This allows combining different content\n *   block types (e.g., text + image) for the same message type.\n * - For keys that exist only in T: Uses T's content definition as-is\n * - For keys that exist only in U: Uses U's content definition as-is\n *\n * @template T - The content definition from the first message structure\n * @template U - The content definition from the second message structure\n *\n * @example\n * ```ts\n * // T allows text content for human messages\n * type ContentA = {\n *   human: ContentBlock.Text;\n * };\n *\n * // U allows image content for human messages and text for AI messages\n * type ContentB = {\n *   human: ContentBlock.Multimodal.Image;\n *   ai: ContentBlock.Text;\n * };\n *\n * // Merged result allows both text and images for human messages, text for AI\n * type Merged = $MergeContentDefinition<ContentA, ContentB>;\n * // Result: {\n * //   human: ContentBlock.Text | ContentBlock.Multimodal.Image;\n * //   ai: ContentBlock.Text;\n * // }\n * ```\n */\nexport type $MergeContentDefinition<T, U> = {\n  [K in keyof T | keyof U as Extract<\n    (K extends keyof T ? T[K] : never) | (K extends keyof U ? U[K] : never),\n    ContentBlock\n  > extends never\n    ? never\n    : K]: K extends keyof T\n    ? K extends keyof U\n      ? $MergeDiscriminatedUnion<\n          Extract<T[K], ContentBlock>,\n          Extract<U[K], ContentBlock>,\n          \"type\"\n        >\n      : Extract<T[K], ContentBlock>\n    : K extends keyof U\n    ? Extract<U[K], ContentBlock>\n    : never;\n};\n\n/**\n * Merges two message structures A and B into a combined structure.\n * This is a type utility that handles merging of tools, content blocks, and properties\n * from two message structures. The resulting type is usable as its own message structure.\n *\n * @example\n * ```ts\n * // Structure A allows text in human messages and has a confidence property on AI messages\n * interface StructureA extends MessageStructure {\n *   content: {\n *     human: ContentBlock.Text;\n *   };\n *   properties: {\n *     ai: { confidence: number };\n *   }\n * }\n *\n * // Structure B allows images in human messages and has a model property on AI messages\n * interface StructureB extends MessageStructure {\n *   content: {\n *     human: ContentBlock.Multimodal.Image;\n *   };\n *   properties: {\n *     ai: { model: string };\n *   }\n * }\n *\n * // Merged structure allows both text and images in human messages\n * // AI messages have both confidence and model properties\n * type Merged = $MergeMessageStructure<StructureA, StructureB>;\n * ```\n *\n * @template A - First message structure to merge\n * @template B - Second message structure to merge (takes precedence over A)\n */\nexport type $MergeMessageStructure<\n  T extends MessageStructure,\n  U extends MessageStructure\n> = {\n  outputVersion: $MergeOutputVersion<T[\"outputVersion\"], U[\"outputVersion\"]>;\n  tools: $MergeObjects<T[\"tools\"], U[\"tools\"]>;\n  content: $MergeContentDefinition<T[\"content\"], U[\"content\"]>;\n  properties: $MergeObjects<T[\"properties\"], U[\"properties\"]>;\n};\n\n/**\n * Standard message structured used to define the most basic message structure that's\n * used throughout the library.\n *\n * This is also the message structure that's used when a message structure is not provided.\n */\nexport interface StandardMessageStructure extends MessageStructure {\n  content: {\n    /** Text content for AI messages */\n    ai: ContentBlock.Text;\n    /** Text content for human messages */\n    human: ContentBlock.Text;\n    /** Text content for system messages */\n    system: ContentBlock.Text;\n    /** Text content for tool messages */\n    tool: ContentBlock.Text;\n  };\n  properties: {\n    /** Properties specific to AI messages */\n    ai: {\n      /** Metadata about the AI model response */\n      response_metadata?: ResponseMetadata;\n      /** Usage statistics for the AI response */\n      usage_metadata?: UsageMetadata;\n    };\n    human: {\n      /** Metadata about the human message */\n      response_metadata?: Record<string, unknown>;\n    };\n    system: {\n      /** Metadata about the system message */\n      response_metadata?: Record<string, unknown>;\n    };\n    tool: {\n      /** Metadata about the tool message */\n      response_metadata?: Record<string, unknown>;\n    };\n  };\n}\n\n/**\n * Takes a message structure type T and normalizes it by merging it with the standard message structure.\n * If T is already a standard message structure, returns T unchanged.\n *\n * This ensures that any custom message structure includes all the standard message structure fields\n * by default while allowing overrides and extensions.\n *\n * @template T - The message structure type to normalize, must extend MessageStructure\n * @returns Either T if it's already a standard structure, or the merged result of T with standard structure\n */\nexport type $NormalizedMessageStructure<T extends MessageStructure> =\n  T extends StandardMessageStructure\n    ? T\n    : $MergeMessageStructure<StandardMessageStructure, T>;\n\n/**\n * Infers the content blocks for a specific message type in a message structure.\n *\n * This utility type extracts the content block type that corresponds to a given message type\n * from the message structure's content definition.\n *\n * @template TStructure - The message structure to infer content from\n * @template TRole - The message role/type to get content for (e.g., \"ai\", \"human\", \"system\", \"tool\")\n * @returns The content block type for the specified type, or never if its not defined in the structure\n *\n * @example\n * ```ts\n * interface MyStructure extends MessageStructure {\n *   content: {\n *     human: ContentBlock.Text;\n *     ai: ContentBlock.Text | ContentBlock.ToolCall;\n *   };\n * }\n *\n * type HumanContent = $InferMessageContentBlocks<MyStructure, \"human\">;\n * // HumanContent = ContentBlock.Text\n *\n * type AIContent = $InferMessageContentBlocks<MyStructure, \"ai\">;\n * // AIContent = ContentBlock.Text | ContentBlock.ToolCall\n * ```\n */\nexport type $InferMessageContentBlocks<\n  TStructure extends MessageStructure,\n  TRole extends MessageType\n> = $NormalizedMessageStructure<TStructure> extends infer S\n  ? S extends MessageStructure\n    ? S[\"content\"] extends infer C\n      ? C extends Record<PropertyKey, ContentBlock>\n        ? TRole extends keyof C\n          ? [$MessageToolCallBlock<TStructure>] extends [never]\n            ? C[TRole]\n            : $MergeDiscriminatedUnion<\n                NonNullable<C[TRole]>,\n                $MessageToolCallBlock<TStructure>,\n                \"type\"\n              >\n          : never\n        : never\n      : never\n    : never\n  : never;\n\n/**\n * Infers the content type for a specific message type from a message structure.\n *\n * This utility type determines the appropriate content type based on the message structure's\n * output version and the specified message type. The content type varies depending on the\n * output version (see {@link MessageOutputVersion})\n *\n * @template TStructure - The message structure to infer content from\n * @template TRole - The message role/type to get content for (e.g., \"ai\", \"human\", \"system\", \"tool\")\n * @returns The content type for the specified role based on the output version\n *\n * @example\n * ```ts\n * interface MyStructure extends MessageStructure {\n *   outputVersion: \"v0\";\n *   content: {\n *     human: ContentBlock.Text;\n *     ai: ContentBlock.Text | ContentBlock.ToolCall;\n *   };\n * }\n *\n * type HumanContentV0 = $InferMessageContent<MyStructure, \"human\">;\n * // HumanContentV0 = string | Array<ContentBlock | ContentBlock.Text>\n *\n * interface MyStructureV1 extends MessageStructure {\n *   outputVersion: \"v1\";\n *   content: {\n *     human: ContentBlock.Text;\n *     ai: ContentBlock.Text | ContentBlock.Reasoning;\n *   };\n * }\n *\n * type HumanContentV1 = $InferMessageContent<MyStructureV1, \"human\">;\n * // HumanContentV1 = ContentBlock.Text\n *\n * type AIContentV1 = $InferMessageContent<MyStructureV1, \"ai\">;\n * // AIContentV1 = ContentBlock.Text | ContentBlock.Reasoning\n * ```\n */\nexport type $InferMessageContent<\n  TStructure extends MessageStructure,\n  TRole extends MessageType\n> = TStructure[\"outputVersion\"] extends \"v1\"\n  ? Array<$InferMessageContentBlocks<TStructure, TRole>>\n  : string | Array<ContentBlock | ContentBlock.Text>;\n\n/**\n * Infers the properties for a specific message type from a message structure.\n *\n * This utility type extracts the properties object that corresponds to a given message type\n * from the message structure's properties definition, and excludes the reserved\n * \"content\" and \"type\" properties to avoid conflicts with the core message structure.\n *\n * If the specified type is not defined in the message structure's properties, it returns\n * a generic Record<string, unknown> type to allow for arbitrary properties.\n *\n * @template TStructure - The message structure to infer properties from\n * @template TRole - The message type/role to get properties for (e.g., \"ai\", \"human\", \"system\", \"tool\")\n * @returns The properties object type for the specified type, excluding \"content\" and \"type\"\n *\n * @example\n * ```ts\n * interface MyStructure extends MessageStructure {\n *   properties: {\n *     ai: {\n *       response_metadata: { model: string };\n *       usage_metadata: { tokens: number };\n *       content: string; // This will be omitted\n *       type: string;    // This will be omitted\n *     };\n *     human: { metadata: Record<string, unknown> };\n *   };\n * }\n *\n * type AIProperties = $InferMessageProperties<MyStructure, \"ai\">;\n * // AIProperties = { response_metadata: { model: string }; usage_metadata: { tokens: number } }\n *\n * type HumanProperties = $InferMessageProperties<MyStructure, \"human\">;\n * // HumanProperties = { metadata: Record<string, unknown> }\n *\n * type SystemProperties = $InferMessageProperties<MyStructure, \"system\">;\n * // SystemProperties = Record<string, unknown> (fallback for undefined role)\n * ```\n */\nexport type $InferMessageProperties<\n  TStructure extends MessageStructure,\n  TRole extends MessageType\n> = $NormalizedMessageStructure<TStructure> extends infer S\n  ? S extends MessageStructure\n    ? S[\"properties\"] extends infer P | undefined\n      ? P extends Record<PropertyKey, unknown>\n        ? TRole extends keyof P\n          ? Omit<P[TRole], \"content\" | \"type\">\n          : Record<string, unknown>\n        : Record<string, unknown>\n      : Record<string, unknown>\n    : never\n  : never;\n\n/**\n * Infers the type of a specific property for a message type from a message structure.\n *\n * This utility type extracts the type of a single property by name from the properties\n * object that corresponds to a given message type. If the specified property key does\n * not exist in the type's properties, it returns `never`.\n *\n * @template TStructure - The message structure to infer the property from\n * @template TRole - The message type/role to get the property for (e.g., \"ai\", \"human\", \"system\", \"tool\")\n * @template K - The property key to extract the type for\n * @returns The type of the specified property, or `never` if the property doesn't exist\n *\n * @example\n * ```ts\n * interface MyStructure extends MessageStructure {\n *   properties: {\n *     ai: {\n *       response_metadata: { model: string; temperature: number };\n *       usage_metadata: { input_tokens: number; output_tokens: number };\n *     };\n *     human: { metadata: Record<string, unknown> };\n *   };\n * }\n *\n * type ResponseMetadata = $InferMessageProperty<MyStructure, \"ai\", \"response_metadata\">;\n * // ResponseMetadata = { model: string; temperature: number }\n *\n * type UsageMetadata = $InferMessageProperty<MyStructure, \"ai\", \"usage_metadata\">;\n * // UsageMetadata = { input_tokens: number; output_tokens: number }\n *\n * type NonExistentProperty = $InferMessageProperty<MyStructure, \"ai\", \"nonExistent\">;\n * // NonExistentProperty = Record<string, unknown>\n *\n * type HumanMetadata = $InferMessageProperty<MyStructure, \"human\", \"metadata\">;\n * // HumanMetadata = Record<string, unknown>\n * ```\n */\nexport type $InferMessageProperty<\n  TStructure extends MessageStructure,\n  TRole extends MessageType,\n  K extends string\n> = K extends keyof $InferMessageProperties<TStructure, TRole>\n  ? $InferMessageProperties<TStructure, TRole>[K]\n  : never;\n\n/**\n * Infers the response metadata type for a specific message type from a message structure.\n *\n * This utility type extracts the `response_metadata` property type for a given message type.\n *\n * @template TStructure - The message structure to infer the response metadata from\n * @template TRole - The message type/role to get the response metadata for (e.g., \"ai\", \"human\", \"system\", \"tool\")\n * @returns The type of the response_metadata property, or `Record<string, unknown>` as fallback\n *\n * @example\n * ```ts\n * interface MyStructure extends MessageStructure {\n *   properties: {\n *     ai: {\n *       response_metadata: { model: string; temperature: number; tokens: number };\n *     };\n *     human: { metadata: Record<string, unknown> };\n *   };\n * }\n *\n * type AIResponseMetadata = $InferResponseMetadata<MyStructure, \"ai\">;\n * // AIResponseMetadata = { model: string; temperature: number; tokens: number }\n *\n * type HumanResponseMetadata = $InferResponseMetadata<MyStructure, \"human\">;\n * // HumanResponseMetadata = Record<string, unknown> (fallback since not defined)\n * ```\n */\nexport type $InferResponseMetadata<\n  TStructure extends MessageStructure,\n  TRole extends MessageType\n> = $InferMessageProperty<\n  TStructure,\n  TRole,\n  \"response_metadata\"\n> extends infer P\n  ? [P] extends [unknown]\n    ? Record<string, unknown>\n    : P\n  : never;\n\n/**\n * Represents a message object that organizes context for an LLM.\n *\n * @example\n * ```ts\n * // Basic message with text content\n * const message: Message = {\n *   id: \"msg-123\",\n *   name: \"user\",\n *   type: \"human\",\n *   content: [{ type: \"text\", text: \"Hello!\" }]\n * };\n *\n * // Basic ai message interface extension\n * interface MyMessage extends Message<StandardMessageStructure, \"ai\"> {\n *   // Additional AI-specific properties can be added here\n * }\n *`\n * // Custom message structure\n * interface CustomStructure extends MessageStructure {\n *   content: {\n *     ai: ContentBlock.Text | ContentBlock.ToolCall<\"search\", { query: string }>;\n *     human: ContentBlock.Text | ContentBlock.Multimodal.Image;\n *   };\n * }\n *\n * // Create a message with custom structure\n * const message: Message<CustomStructure> = {\n *   id: \"msg-123\",\n *   name: \"user\",\n *   type: \"ai\",\n *   content: [\n *     { type: \"text\", text: \"Hello!\" },\n *     {\n *       type: \"tool_call\",\n *       name: \"search\",\n *       args: { query: \"What is the capital of France?\" }\n *     }\n *   ]\n * };\n * ```\n */\nexport interface Message<\n  TStructure extends MessageStructure = StandardMessageStructure,\n  TRole extends MessageType = MessageType\n> {\n  /** The message type/role */\n  readonly type: TRole;\n  /** Unique identifier for this message */\n  id?: string;\n  /** Optional name/identifier for the entity that created this message */\n  name?: string;\n  /** Array of content blocks that make up the message content */\n  content: $InferMessageContent<TStructure, TRole>;\n  /** Metadata about the message */\n  response_metadata?: Partial<$InferResponseMetadata<TStructure, TRole>>;\n}\n\n/**\n * Type guard to check if a value is a valid Message object.\n *\n * @param message - The value to check\n * @returns true if the value is a valid Message object, false otherwise\n */\nexport function isMessage(message: unknown): message is Message {\n  return (\n    typeof message === \"object\" &&\n    message !== null &&\n    \"type\" in message &&\n    \"content\" in message &&\n    (typeof message.content === \"string\" || Array.isArray(message.content))\n  );\n}\n"],"mappings":";;;;;;;;AAitBA,SAAgB,UAAUA,SAAsC;AAC9D,QACE,OAAO,YAAY,YACnB,YAAY,QACZ,UAAU,WACV,aAAa,YACZ,OAAO,QAAQ,YAAY,YAAY,MAAM,QAAQ,QAAQ,QAAQ;AAEzE"}