@threadplane/langgraph 0.0.51 → 0.0.53

package/fesm2022/threadplane-langgraph.mjs

@@ -1860,6 +1860,19 @@ function findLatestDescendantId(parentId, childrenMap) {
     return latestId;
 }
 
+/**
+ * Normalize {@link Citation}s out of a message's `additional_kwargs` (reading
+ * `citations` or `sources`). Exposed for advanced consumers building custom
+ * adapters or bridging non-LangGraph message shapes into the neutral
+ * `Citation[]` form.
+ *
+ * @param msg Any object with an `additional_kwargs` bag (e.g. a LangChain message).
+ * @returns The normalized citations, or `undefined` when none are present.
+ * @example
+ * ```ts
+ * const citations = extractCitations(lcMessage);
+ * ```
+ */
 function extractCitations(msg) {
     const raw = msg.additional_kwargs?.['citations'] ?? msg.additional_kwargs?.['sources'];
     if (!Array.isArray(raw) || raw.length === 0)
@@ -2881,6 +2894,12 @@ class MockAgentTransport {
  *
  * Neutral `Agent`-contract signals come from {@link mockAgent}; LangGraph-specific
  * signals are declared here and layered on top.
+ *
+ * @example
+ * ```ts
+ * const agent = mockLangGraphAgent({ isThreadLoading: true });
+ * agent.messages.set([{ id: '1', role: 'assistant', content: 'Hi' }]);
+ * ```
  */
 function mockLangGraphAgent(initial = {}) {
     const base = mockAgent({
@@ -3054,6 +3073,13 @@ function delay(ms) {
  * advanced manual scripting (tool calls, interrupts, multi-batch), provide
  * the agent yourself with
  * `provideAgent({ assistantId, transport: new MockAgentTransport(...) })`.
+ *
+ * @example
+ * ```ts
+ * TestBed.configureTestingModule({
+ *   providers: [provideFakeAgent({ responses: ['Hi from the fake LangGraph agent'] })],
+ * });
+ * ```
  */
 function provideFakeAgent(config = {}) {
     return provideAgent({