@threadplane/langgraph 0.0.52 → 0.0.54

package/fesm2022/threadplane-langgraph.mjs

@@ -496,7 +496,7 @@ function isLgTraceEnabled() {
 function lgTrace(...args) {
     if (isLgTraceEnabled()) {
         // eslint-disable-next-line no-console
-        console.debug('[ngaf-chat-stream]', ...args);
+        console.debug('[tplane-chat-stream]', ...args);
     }
 }
 function captureAgentRuntimeTelemetry(sink, event, properties) {
@@ -547,9 +547,9 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
         onSubagentChange: publishSubagents,
     });
     const telemetryProperties = { transport: 'langgraph', surface: 'agent' };
-    captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:runtime_instance_created', telemetryProperties);
+    captureAgentRuntimeTelemetry(options.telemetry, 'tplane:runtime_instance_created', telemetryProperties);
     function captureRuntimeRequestTelemetry(requestType) {
-        captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:runtime_request_created', {
+        captureAgentRuntimeTelemetry(options.telemetry, 'tplane:runtime_request_created', {
             ...telemetryProperties,
             requestType,
         });
@@ -734,7 +734,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
         abortController = new AbortController();
         const startedAt = Date.now();
         captureRuntimeRequestTelemetry('join_queued');
-        captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_started', telemetryProperties);
+        captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_started', telemetryProperties);
         subjects.custom$.next([]);
         subjects.toolProgress$.next([]);
         toolProgressMap.clear();
@@ -754,7 +754,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
                 // post-process node mutations (RemoveMessage, id-match content
                 // replacement) reflected on the server are picked up client-side.
                 await refreshHistory(true);
-                captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_ended', {
+                captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_ended', {
                     ...telemetryProperties,
                     durationMs: Date.now() - startedAt,
                 });
@@ -763,7 +763,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
         catch (err) {
             subjects.error$.next(toAgentError(err));
             subjects.status$.next(ResourceStatus.Error);
-            captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_errored', {
+            captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_errored', {
                 ...telemetryProperties,
                 durationMs: Date.now() - startedAt,
                 errorClass: agentRuntimeTelemetryErrorClass(err),
@@ -776,7 +776,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
         userAbortRequested = false;
         const startedAt = Date.now();
         captureRuntimeRequestTelemetry(requestType);
-        captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_started', telemetryProperties);
+        captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_started', telemetryProperties);
         subjects.status$.next(ResourceStatus.Loading);
         subjects.error$.next(undefined);
         subjects.custom$.next([]);
@@ -820,7 +820,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
                 // authoritative after run completion.
                 await refreshHistory(true);
                 await drainQueue();
-                captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_ended', {
+                captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_ended', {
                     ...telemetryProperties,
                     durationMs: Date.now() - startedAt,
                 });
@@ -839,7 +839,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
                     : new AgentError({ kind: 'connection', message: AGENT_ERROR_MESSAGES.connection, retryable: true, cause: err });
                 subjects.error$.next(e);
                 subjects.status$.next(ResourceStatus.Error);
-                captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_errored', {
+                captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_errored', {
                     ...telemetryProperties,
                     durationMs: Date.now() - startedAt,
                     errorClass: agentRuntimeTelemetryErrorClass(err),
@@ -848,7 +848,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
             else {
                 subjects.error$.next(toAgentError(err));
                 subjects.status$.next(ResourceStatus.Error);
-                captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_errored', {
+                captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_errored', {
                     ...telemetryProperties,
                     durationMs: Date.now() - startedAt,
                     errorClass: agentRuntimeTelemetryErrorClass(err),
@@ -1146,7 +1146,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
             abortController = new AbortController();
             const startedAt = Date.now();
             captureRuntimeRequestTelemetry('join');
-            captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_started', telemetryProperties);
+            captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_started', telemetryProperties);
             subjects.custom$.next([]);
             subjects.toolProgress$.next([]);
             toolProgressMap.clear();
@@ -1160,7 +1160,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
                 }
                 subjects.status$.next(ResourceStatus.Resolved);
                 await refreshHistory();
-                captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_ended', {
+                captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_ended', {
                     ...telemetryProperties,
                     durationMs: Date.now() - startedAt,
                 });
@@ -1168,7 +1168,7 @@ function createStreamManagerBridge({ options, subjects, threadId$, destroy$ }) {
             catch (err) {
                 subjects.error$.next(toAgentError(err));
                 subjects.status$.next(ResourceStatus.Error);
-                captureAgentRuntimeTelemetry(options.telemetry, 'ngaf:stream_errored', {
+                captureAgentRuntimeTelemetry(options.telemetry, 'tplane:stream_errored', {
                     ...telemetryProperties,
                     durationMs: Date.now() - startedAt,
                     errorClass: agentRuntimeTelemetryErrorClass(err),
@@ -2894,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({
@@ -3067,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({