@threadplane/langgraph 0.0.51 → 0.0.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threadplane/langgraph",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "description": "LangGraph adapter for @threadplane/chat — Angular bindings for LangGraph Platform.",
   "keywords": [
     "angular",

package/types/threadplane-langgraph.d.ts

@@ -351,8 +351,13 @@ interface AgentConfig<T = Record<string, unknown>, _Bag extends BagTemplate = Ba
  * config is known up front. Pass a `() => AgentConfig` factory when the config
  * depends on runtime/DI state — the factory runs inside an Angular injection
  * context, so it may call `inject()` to read services, route params, or
- * component-scoped signals:
+ * component-scoped signals.
  *
+ * **Typed state via AgentRef.** Pass a typed ref as the first argument to flow
+ * the state shape from `provideAgent` to `injectAgent` without repeating the
+ * generic at every call site.
+ *
+ * @example Factory config reading route params
  * ```ts
  * providers: [
  *   provideAgent(() => {
@@ -361,11 +366,7 @@ interface AgentConfig<T = Record<string, unknown>, _Bag extends BagTemplate = Ba
  *   }),
  * ];
  * ```
- *
- * **Typed state via AgentRef.** Pass a typed ref as the first argument to flow
- * the state shape from `provideAgent` to `injectAgent` without repeating the
- * generic at every call site:
- *
+ * @example Typed state via AgentRef
  * ```ts
  * export const TRIP = createAgentRef<TripState>('trip');
  * // app.config.ts:
@@ -388,13 +389,13 @@ declare function provideAgent<T = Record<string, unknown>>(configOrFactory: Agen
  *
  * **Typed state via AgentRef.** Pass the same ref that was supplied to
  * `provideAgent(ref, …)` to carry the state type through DI without repeating
- * the generic at every call site:
+ * the generic at every call site. The no-arg form defaults to
+ * `LangGraphAgent<Record<string, unknown>>`.
  *
+ * @example Typed state via AgentRef
  * ```ts
  * const agent = injectAgent(TRIP); // LangGraphAgent<TripState>
  * ```
- *
- * The no-arg form defaults to `LangGraphAgent<Record<string, unknown>>`.
  */
 declare function injectAgent(): LangGraphAgent<Record<string, unknown>>;
 declare function injectAgent<T, ResolvedBag extends BagTemplate = BagTemplate>(ref: AgentRef<T>): LangGraphAgent<T, ResolvedBag>;
@@ -556,6 +557,12 @@ interface MockLangGraphAgent extends LangGraphAgent<any, any> {
  *
  * 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' }]);
+ * ```
  */
 declare function mockLangGraphAgent(initial?: MockAgentOptions & {
     langGraphMessages?: BaseMessage[];
@@ -571,6 +578,13 @@ declare function mockLangGraphAgent(initial?: MockAgentOptions & {
  * 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'] })],
+ * });
+ * ```
  */
 declare function provideFakeAgent(config?: FakeAgentConfig): Provider[];
 
@@ -598,6 +612,19 @@ declare class FakeStreamTransport implements AgentTransport {
 interface KwargsLike {
     additional_kwargs?: Record<string, unknown> | undefined;
 }
+/**
+ * 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);
+ * ```
+ */
 declare function extractCitations(msg: KwargsLike): Citation[] | undefined;
 
 /**