langchain 0.0.137 → 0.0.139

package/dist/callbacks/handlers/tracer.cjs

@@ -2,6 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseTracer = void 0;
 const base_js_1 = require("../base.cjs");
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _coerceToDict(value, defaultKey) {
+    return value && !Array.isArray(value) && typeof value === "object"
+        ? value
+        : { [defaultKey]: value };
+}
 class BaseTracer extends base_js_1.BaseCallbackHandler {
     constructor(_fields) {
         super(...arguments);
@@ -23,6 +29,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
             const parentRun = this.runMap.get(run.parent_run_id);
             if (parentRun) {
                 this._addChildRun(parentRun, run);
+                parentRun.child_execution_order = Math.max(parentRun.child_execution_order, run.child_execution_order);
             }
         }
         this.runMap.set(run.id, run);
@@ -60,7 +67,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs: { prompts },
@@ -89,7 +96,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs: { messages },
@@ -112,7 +119,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         run.outputs = output;
         run.events.push({
             name: "end",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onLLMEnd?.(run);
         await this._endTrace(run);
@@ -126,7 +133,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         run.error = error.message;
         run.events.push({
             name: "error",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onLLMError?.(run);
         await this._endTrace(run);
@@ -143,7 +150,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs,
@@ -157,21 +164,24 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         this._startTrace(run);
         await this.onChainStart?.(run);
     }
-    async handleChainEnd(outputs, runId) {
+    async handleChainEnd(outputs, runId, _parentRunId, _tags, kwargs) {
         const run = this.runMap.get(runId);
         if (!run) {
             throw new Error("No chain run to end.");
         }
         run.end_time = Date.now();
-        run.outputs = outputs;
+        run.outputs = _coerceToDict(outputs, "output");
         run.events.push({
             name: "end",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
+        if (kwargs?.inputs !== undefined) {
+            run.inputs = _coerceToDict(kwargs.inputs, "input");
+        }
         await this.onChainEnd?.(run);
         await this._endTrace(run);
     }
-    async handleChainError(error, runId) {
+    async handleChainError(error, runId, _parentRunId, _tags, kwargs) {
         const run = this.runMap.get(runId);
         if (!run) {
             throw new Error("No chain run to end.");
@@ -180,8 +190,11 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         run.error = error.message;
         run.events.push({
             name: "error",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
+        if (kwargs?.inputs !== undefined) {
+            run.inputs = _coerceToDict(kwargs.inputs, "input");
+        }
         await this.onChainError?.(run);
         await this._endTrace(run);
     }
@@ -197,7 +210,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs: { input },
@@ -220,7 +233,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         run.outputs = { output };
         run.events.push({
             name: "end",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onToolEnd?.(run);
         await this._endTrace(run);
@@ -234,7 +247,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         run.error = error.message;
         run.events.push({
             name: "error",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onToolError?.(run);
         await this._endTrace(run);
@@ -249,7 +262,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         agentRun.actions.push(action);
         agentRun.events.push({
             name: "agent_action",
-            time: Date.now(),
+            time: new Date().toISOString(),
             kwargs: { action },
         });
         await this.onAgentAction?.(run);
@@ -261,7 +274,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         }
         run.events.push({
             name: "agent_end",
-            time: Date.now(),
+            time: new Date().toISOString(),
             kwargs: { action },
         });
         await this.onAgentEnd?.(run);
@@ -278,7 +291,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs: { query },
@@ -301,7 +314,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         run.outputs = { documents };
         run.events.push({
             name: "end",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onRetrieverEnd?.(run);
         await this._endTrace(run);
@@ -315,7 +328,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         run.error = error.message;
         run.events.push({
             name: "error",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onRetrieverError?.(run);
         await this._endTrace(run);
@@ -327,7 +340,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         }
         run.events.push({
             name: "text",
-            time: Date.now(),
+            time: new Date().toISOString(),
             kwargs: { text },
         });
         await this.onText?.(run);
@@ -339,7 +352,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         }
         run.events.push({
             name: "new_token",
-            time: Date.now(),
+            time: new Date().toISOString(),
             kwargs: { token, idx, chunk: fields?.chunk },
         });
         await this.onLLMNewToken?.(run);

package/dist/callbacks/handlers/tracer.d.ts

@@ -12,7 +12,7 @@ export interface Run extends BaseRun {
     child_execution_order: number;
     events: Array<{
         name: string;
-        time: number;
+        time: string;
         kwargs?: Record<string, unknown>;
     }>;
 }
@@ -33,8 +33,12 @@ export declare abstract class BaseTracer extends BaseCallbackHandler {
     handleLLMEnd(output: LLMResult, runId: string): Promise<void>;
     handleLLMError(error: Error, runId: string): Promise<void>;
     handleChainStart(chain: Serialized, inputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], metadata?: KVMap, runType?: string): Promise<void>;
-    handleChainEnd(outputs: ChainValues, runId: string): Promise<void>;
-    handleChainError(error: Error, runId: string): Promise<void>;
+    handleChainEnd(outputs: ChainValues, runId: string, _parentRunId?: string, _tags?: string[], kwargs?: {
+        inputs?: Record<string, unknown>;
+    }): Promise<void>;
+    handleChainError(error: Error, runId: string, _parentRunId?: string, _tags?: string[], kwargs?: {
+        inputs?: Record<string, unknown>;
+    }): Promise<void>;
     handleToolStart(tool: Serialized, input: string, runId: string, parentRunId?: string, tags?: string[], metadata?: KVMap): Promise<void>;
     handleToolEnd(output: string, runId: string): Promise<void>;
     handleToolError(error: Error, runId: string): Promise<void>;

package/dist/callbacks/handlers/tracer.js

@@ -1,4 +1,10 @@
 import { BaseCallbackHandler, } from "../base.js";
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _coerceToDict(value, defaultKey) {
+    return value && !Array.isArray(value) && typeof value === "object"
+        ? value
+        : { [defaultKey]: value };
+}
 export class BaseTracer extends BaseCallbackHandler {
     constructor(_fields) {
         super(...arguments);
@@ -20,6 +26,7 @@ export class BaseTracer extends BaseCallbackHandler {
             const parentRun = this.runMap.get(run.parent_run_id);
             if (parentRun) {
                 this._addChildRun(parentRun, run);
+                parentRun.child_execution_order = Math.max(parentRun.child_execution_order, run.child_execution_order);
             }
         }
         this.runMap.set(run.id, run);
@@ -57,7 +64,7 @@ export class BaseTracer extends BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs: { prompts },
@@ -86,7 +93,7 @@ export class BaseTracer extends BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs: { messages },
@@ -109,7 +116,7 @@ export class BaseTracer extends BaseCallbackHandler {
         run.outputs = output;
         run.events.push({
             name: "end",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onLLMEnd?.(run);
         await this._endTrace(run);
@@ -123,7 +130,7 @@ export class BaseTracer extends BaseCallbackHandler {
         run.error = error.message;
         run.events.push({
             name: "error",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onLLMError?.(run);
         await this._endTrace(run);
@@ -140,7 +147,7 @@ export class BaseTracer extends BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs,
@@ -154,21 +161,24 @@ export class BaseTracer extends BaseCallbackHandler {
         this._startTrace(run);
         await this.onChainStart?.(run);
     }
-    async handleChainEnd(outputs, runId) {
+    async handleChainEnd(outputs, runId, _parentRunId, _tags, kwargs) {
         const run = this.runMap.get(runId);
         if (!run) {
             throw new Error("No chain run to end.");
         }
         run.end_time = Date.now();
-        run.outputs = outputs;
+        run.outputs = _coerceToDict(outputs, "output");
         run.events.push({
             name: "end",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
+        if (kwargs?.inputs !== undefined) {
+            run.inputs = _coerceToDict(kwargs.inputs, "input");
+        }
         await this.onChainEnd?.(run);
         await this._endTrace(run);
     }
-    async handleChainError(error, runId) {
+    async handleChainError(error, runId, _parentRunId, _tags, kwargs) {
         const run = this.runMap.get(runId);
         if (!run) {
             throw new Error("No chain run to end.");
@@ -177,8 +187,11 @@ export class BaseTracer extends BaseCallbackHandler {
         run.error = error.message;
         run.events.push({
             name: "error",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
+        if (kwargs?.inputs !== undefined) {
+            run.inputs = _coerceToDict(kwargs.inputs, "input");
+        }
         await this.onChainError?.(run);
         await this._endTrace(run);
     }
@@ -194,7 +207,7 @@ export class BaseTracer extends BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs: { input },
@@ -217,7 +230,7 @@ export class BaseTracer extends BaseCallbackHandler {
         run.outputs = { output };
         run.events.push({
             name: "end",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onToolEnd?.(run);
         await this._endTrace(run);
@@ -231,7 +244,7 @@ export class BaseTracer extends BaseCallbackHandler {
         run.error = error.message;
         run.events.push({
             name: "error",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onToolError?.(run);
         await this._endTrace(run);
@@ -246,7 +259,7 @@ export class BaseTracer extends BaseCallbackHandler {
         agentRun.actions.push(action);
         agentRun.events.push({
             name: "agent_action",
-            time: Date.now(),
+            time: new Date().toISOString(),
             kwargs: { action },
         });
         await this.onAgentAction?.(run);
@@ -258,7 +271,7 @@ export class BaseTracer extends BaseCallbackHandler {
         }
         run.events.push({
             name: "agent_end",
-            time: Date.now(),
+            time: new Date().toISOString(),
             kwargs: { action },
         });
         await this.onAgentEnd?.(run);
@@ -275,7 +288,7 @@ export class BaseTracer extends BaseCallbackHandler {
             events: [
                 {
                     name: "start",
-                    time: start_time,
+                    time: new Date(start_time).toISOString(),
                 },
             ],
             inputs: { query },
@@ -298,7 +311,7 @@ export class BaseTracer extends BaseCallbackHandler {
         run.outputs = { documents };
         run.events.push({
             name: "end",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onRetrieverEnd?.(run);
         await this._endTrace(run);
@@ -312,7 +325,7 @@ export class BaseTracer extends BaseCallbackHandler {
         run.error = error.message;
         run.events.push({
             name: "error",
-            time: run.end_time,
+            time: new Date(run.end_time).toISOString(),
         });
         await this.onRetrieverError?.(run);
         await this._endTrace(run);
@@ -324,7 +337,7 @@ export class BaseTracer extends BaseCallbackHandler {
         }
         run.events.push({
             name: "text",
-            time: Date.now(),
+            time: new Date().toISOString(),
             kwargs: { text },
         });
         await this.onText?.(run);
@@ -336,7 +349,7 @@ export class BaseTracer extends BaseCallbackHandler {
         }
         run.events.push({
             name: "new_token",
-            time: Date.now(),
+            time: new Date().toISOString(),
             kwargs: { token, idx, chunk: fields?.chunk },
         });
         await this.onLLMNewToken?.(run);

package/dist/callbacks/handlers/tracer_langchain.cjs

@@ -62,6 +62,7 @@ class LangChainTracer extends tracer_js_1.BaseTracer {
             error: run.error,
             outputs: run.outputs,
             events: run.events,
+            inputs: run.inputs,
         };
         await this.client.updateRun(run.id, runUpdate);
     }

package/dist/callbacks/handlers/tracer_langchain.d.ts

@@ -1,5 +1,5 @@
 import { Client } from "langsmith";
-import { BaseRun, RunUpdate as BaseRunUpdate } from "langsmith/schemas";
+import { BaseRun, RunUpdate as BaseRunUpdate, KVMap } from "langsmith/schemas";
 import { BaseTracer } from "./tracer.js";
 import { BaseCallbackHandlerInput } from "../base.js";
 export interface Run extends BaseRun {
@@ -9,6 +9,7 @@ export interface Run extends BaseRun {
 }
 export interface RunUpdate extends BaseRunUpdate {
     events: BaseRun["events"];
+    inputs: KVMap;
 }
 export interface LangChainTracerFields extends BaseCallbackHandlerInput {
     exampleId?: string;

package/dist/callbacks/handlers/tracer_langchain.js

@@ -59,6 +59,7 @@ export class LangChainTracer extends BaseTracer {
             error: run.error,
             outputs: run.outputs,
             events: run.events,
+            inputs: run.inputs,
         };
         await this.client.updateRun(run.id, runUpdate);
     }

package/dist/callbacks/index.cjs

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.consumeCallback = exports.awaitAllCallbacks = exports.traceAsGroup = exports.TraceGroup = exports.CallbackManagerForToolRun = exports.CallbackManagerForLLMRun = exports.CallbackManagerForChainRun = exports.CallbackManagerForRetrieverRun = exports.CallbackManager = exports.getTracingV2CallbackHandler = exports.getTracingCallbackHandler = exports.LangChainTracerV1 = exports.LangChainTracer = exports.ConsoleCallbackHandler = exports.BaseTracer = exports.BaseCallbackHandler = void 0;
+exports.consumeCallback = exports.awaitAllCallbacks = exports.traceAsGroup = exports.TraceGroup = exports.CallbackManagerForToolRun = exports.CallbackManagerForLLMRun = exports.CallbackManagerForChainRun = exports.CallbackManagerForRetrieverRun = exports.CallbackManager = exports.getTracingV2CallbackHandler = exports.getTracingCallbackHandler = exports.LangChainTracerV1 = exports.LangChainTracer = exports.RunCollectorCallbackHandler = exports.ConsoleCallbackHandler = exports.BaseTracer = exports.BaseCallbackHandler = void 0;
 var base_js_1 = require("./base.cjs");
 Object.defineProperty(exports, "BaseCallbackHandler", { enumerable: true, get: function () { return base_js_1.BaseCallbackHandler; } });
 var tracer_js_1 = require("./handlers/tracer.cjs");
 Object.defineProperty(exports, "BaseTracer", { enumerable: true, get: function () { return tracer_js_1.BaseTracer; } });
 var console_js_1 = require("./handlers/console.cjs");
 Object.defineProperty(exports, "ConsoleCallbackHandler", { enumerable: true, get: function () { return console_js_1.ConsoleCallbackHandler; } });
+var run_collector_js_1 = require("./handlers/run_collector.cjs");
+Object.defineProperty(exports, "RunCollectorCallbackHandler", { enumerable: true, get: function () { return run_collector_js_1.RunCollectorCallbackHandler; } });
 var tracer_langchain_js_1 = require("./handlers/tracer_langchain.cjs");
 Object.defineProperty(exports, "LangChainTracer", { enumerable: true, get: function () { return tracer_langchain_js_1.LangChainTracer; } });
 var tracer_langchain_v1_js_1 = require("./handlers/tracer_langchain_v1.cjs");

package/dist/callbacks/index.d.ts

@@ -1,6 +1,7 @@
 export { BaseCallbackHandler, CallbackHandlerMethods, BaseCallbackHandlerInput, NewTokenIndices, } from "./base.js";
 export { Run, RunType, BaseTracer } from "./handlers/tracer.js";
 export { ConsoleCallbackHandler } from "./handlers/console.js";
+export { RunCollectorCallbackHandler } from "./handlers/run_collector.js";
 export { LangChainTracer } from "./handlers/tracer_langchain.js";
 export { LangChainTracerV1 } from "./handlers/tracer_langchain_v1.js";
 export { getTracingCallbackHandler, getTracingV2CallbackHandler, } from "./handlers/initialize.js";

package/dist/callbacks/index.js

@@ -1,6 +1,7 @@
 export { BaseCallbackHandler, } from "./base.js";
 export { BaseTracer } from "./handlers/tracer.js";
 export { ConsoleCallbackHandler } from "./handlers/console.js";
+export { RunCollectorCallbackHandler } from "./handlers/run_collector.js";
 export { LangChainTracer } from "./handlers/tracer_langchain.js";
 export { LangChainTracerV1 } from "./handlers/tracer_langchain_v1.js";
 export { getTracingCallbackHandler, getTracingV2CallbackHandler, } from "./handlers/initialize.js";

package/dist/callbacks/manager.cjs

@@ -187,11 +187,11 @@ class CallbackManagerForChainRun extends BaseRunManager {
         }
         return manager;
     }
-    async handleChainError(err) {
+    async handleChainError(err, _runId, _parentRunId, _tags, kwargs) {
         await Promise.all(this.handlers.map((handler) => (0, promises_js_1.consumeCallback)(async () => {
             if (!handler.ignoreChain) {
                 try {
-                    await handler.handleChainError?.(err, this.runId, this._parentRunId, this.tags);
+                    await handler.handleChainError?.(err, this.runId, this._parentRunId, this.tags, kwargs);
                 }
                 catch (err) {
                     console.error(`Error in handler ${handler.constructor.name}, handleChainError: ${err}`);
@@ -199,11 +199,11 @@ class CallbackManagerForChainRun extends BaseRunManager {
             }
         }, handler.awaitHandlers)));
     }
-    async handleChainEnd(output) {
+    async handleChainEnd(output, _runId, _parentRunId, _tags, kwargs) {
         await Promise.all(this.handlers.map((handler) => (0, promises_js_1.consumeCallback)(async () => {
             if (!handler.ignoreChain) {
                 try {
-                    await handler.handleChainEnd?.(output, this.runId, this._parentRunId, this.tags);
+                    await handler.handleChainEnd?.(output, this.runId, this._parentRunId, this.tags, kwargs);
                 }
                 catch (err) {
                     console.error(`Error in handler ${handler.constructor.name}, handleChainEnd: ${err}`);
@@ -571,42 +571,57 @@ class TraceGroup {
             value: void 0
         });
     }
-    async getTraceGroupCallbackManager(group_name, options) {
+    async getTraceGroupCallbackManager(group_name, inputs, options) {
         const cb = new tracer_langchain_js_1.LangChainTracer(options);
         const cm = await CallbackManager.configure([cb]);
         const runManager = await cm?.handleChainStart({
             lc: 1,
             type: "not_implemented",
             id: ["langchain", "callbacks", "groups", group_name],
-        }, {});
+        }, inputs ?? {});
         if (!runManager) {
             throw new Error("Failed to create run group callback manager.");
         }
         return runManager;
     }
-    async start() {
+    async start(inputs) {
         if (!this.runManager) {
-            this.runManager = await this.getTraceGroupCallbackManager(this.groupName, this.options);
+            this.runManager = await this.getTraceGroupCallbackManager(this.groupName, inputs, this.options);
         }
         return this.runManager.getChild();
     }
-    async end() {
+    async error(err) {
         if (this.runManager) {
-            await this.runManager.handleChainEnd({});
+            await this.runManager.handleChainError(err);
+            this.runManager = undefined;
+        }
+    }
+    async end(output) {
+        if (this.runManager) {
+            await this.runManager.handleChainEnd(output ?? {});
             this.runManager = undefined;
         }
     }
 }
 exports.TraceGroup = TraceGroup;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _coerceToDict(value, defaultKey) {
+    return value && !Array.isArray(value) && typeof value === "object"
+        ? value
+        : { [defaultKey]: value };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 async function traceAsGroup(groupOptions, enclosedCode, ...args) {
     const traceGroup = new TraceGroup(groupOptions.name, groupOptions);
-    const callbackManager = await traceGroup.start();
+    const callbackManager = await traceGroup.start({ ...args });
     try {
-        return await enclosedCode(callbackManager, ...args);
+        const result = await enclosedCode(callbackManager, ...args);
+        await traceGroup.end(_coerceToDict(result, "output"));
+        return result;
     }
-    finally {
-        await traceGroup.end();
+    catch (err) {
+        await traceGroup.error(err);
+        throw err;
     }
 }
 exports.traceAsGroup = traceAsGroup;

package/dist/callbacks/manager.d.ts

@@ -68,8 +68,12 @@ export declare class CallbackManagerForLLMRun extends BaseRunManager implements
 }
 export declare class CallbackManagerForChainRun extends BaseRunManager implements BaseCallbackManagerMethods {
     getChild(tag?: string): CallbackManager;
-    handleChainError(err: Error | unknown): Promise<void>;
-    handleChainEnd(output: ChainValues): Promise<void>;
+    handleChainError(err: Error | unknown, _runId?: string, _parentRunId?: string, _tags?: string[], kwargs?: {
+        inputs?: Record<string, unknown>;
+    }): Promise<void>;
+    handleChainEnd(output: ChainValues, _runId?: string, _parentRunId?: string, _tags?: string[], kwargs?: {
+        inputs?: Record<string, unknown>;
+    }): Promise<void>;
     handleAgentAction(action: AgentAction): Promise<void>;
     handleAgentEnd(action: AgentFinish): Promise<void>;
 }
@@ -113,8 +117,9 @@ export declare class TraceGroup {
         exampleId?: string | undefined;
     } | undefined);
     private getTraceGroupCallbackManager;
-    start(): Promise<CallbackManager>;
-    end(): Promise<void>;
+    start(inputs?: ChainValues): Promise<CallbackManager>;
+    error(err: Error | unknown): Promise<void>;
+    end(output?: ChainValues): Promise<void>;
 }
 export declare function traceAsGroup<T, A extends any[]>(groupOptions: {
     name: string;