agent-inspect 1.5.0 → 1.6.0

package/packages/core/dist/advanced.d.cts

@@ -1,5 +1,8 @@
-import { E as ErrorInfo, e as RedactionProfile, n as StepMetadata, T as TraceEvent, I as InspectRunOptions, g as ExecutionContext, d as TraceCorrelationMetadata, k as RunStatus, c as StepStatus } from './types-CNbheSdk.cjs';
-import { R as RedactionRule } from './log-config-BzGmDYum.cjs';
+import { E as ErrorInfo, e as RedactionProfile, n as StepMetadata, T as TraceEvent, I as InspectRunOptions, g as ExecutionContext, d as TraceCorrelationMetadata, S as StepType, k as RunStatus, c as StepStatus } from './types-DB8jB6Jg.cjs';
+import { R as RedactionRule } from './log-config-BnH8Ykcb.cjs';
+import { P as PersistedInspectEvent } from './persisted-inspect-event-0kaRADsp.cjs';
+import { TraceWriterStats, TraceWriter } from './writers.cjs';
+import './inspect-event-Des4JDHo.cjs';
 
 /** Default folder under the user home for AgentInspect data. */
 declare const DEFAULT_TRACE_DIR_NAME = ".agent-inspect";
@@ -127,6 +130,98 @@ declare function runWithContext<T>(context: ExecutionContext, fn: () => Promise<
  */
 declare function runWithStepContext<T>(stepId: string, fn: () => Promise<T> | T): Promise<T>;
 
+interface InspectorRuntimeOptions {
+    enabled?: boolean;
+    writer?: TraceWriter;
+    traceSafety?: TraceSafetyOptions;
+}
+interface InspectorRuntimeContext extends ExecutionContext {
+    runtimeId: string;
+}
+interface InspectorRuntimeDiagnostics {
+    instrumentationErrors: number;
+    lastInstrumentationError?: string;
+    writerStats?: TraceWriterStats;
+}
+interface InspectorRuntime {
+    readonly runtimeId: string;
+    readonly enabled: boolean;
+    runWithContext<T>(context: ExecutionContext, fn: () => Promise<T> | T): Promise<T>;
+    runWithStepContext<T>(stepId: string, fn: () => Promise<T> | T): Promise<T>;
+    getCurrentContext(): InspectorRuntimeContext | undefined;
+    getCurrentCorrelationMetadata(): TraceCorrelationMetadata | undefined;
+    getCurrentStepId(): string | undefined;
+    getCurrentDepth(): number;
+    getTraceSafety(): TraceSafetyOptions;
+    write(event: PersistedInspectEvent): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    getDiagnostics(): InspectorRuntimeDiagnostics;
+}
+declare function createInspectorRuntime(options?: InspectorRuntimeOptions): InspectorRuntime;
+
+interface InspectorCaptureOptions {
+    onSuccess?: "none" | "metadata-only";
+    onError?: "none" | "metadata-only";
+}
+interface CreateInspectorOptions {
+    enabled?: boolean;
+    writer?: TraceWriter;
+    /**
+     * Context metadata only. Does not configure writer output; use
+     * `fileWriter({ dir })` or another explicit writer for persistence paths.
+     *
+     * @experimental
+     */
+    traceDir?: string;
+    /**
+     * Context metadata only for compatibility with existing terminal helpers.
+     * `createInspector()` does not print lifecycle output.
+     *
+     * @experimental
+     */
+    silent?: boolean;
+    metadata?: Record<string, unknown>;
+    redactionProfile?: RedactionProfile;
+    /**
+     * Metadata-only summaries for persisted run/step completion rows.
+     * This never stores raw return values, prompts, outputs, or thrown objects.
+     *
+     * @experimental
+     */
+    capture?: InspectorCaptureOptions;
+    traceSafety?: TraceSafetyOptions;
+}
+interface InspectorRunOptions {
+    runId?: string;
+    traceDir?: string;
+    silent?: boolean;
+    metadata?: Record<string, unknown>;
+}
+interface InspectorStepOptions {
+    type?: StepType;
+    metadata?: StepMetadata;
+}
+type InspectorObserveOptions = InspectorStepOptions;
+interface Inspector {
+    /**
+     * Low-level runtime access is retained for v1.6 compatibility. Prefer
+     * `getDiagnostics()` unless you need advanced runtime context primitives.
+     *
+     * @experimental
+     */
+    readonly runtime: InspectorRuntime;
+    run<T>(name: string, fn: () => T | Promise<T>, options?: InspectorRunOptions): Promise<T>;
+    step<T>(name: string, fn: () => T | Promise<T>, options?: InspectorStepOptions): Promise<T>;
+    tool<T>(name: string, fn: () => T | Promise<T>, options?: InspectorStepOptions): Promise<T>;
+    llm<T>(name: string, fn: () => T | Promise<T>, options?: InspectorStepOptions): Promise<T>;
+    observe<TFunction extends (...args: any[]) => any>(name: string, fn: TFunction, options?: InspectorObserveOptions): (...args: Parameters<TFunction>) => Promise<Awaited<ReturnType<TFunction>>>;
+    getDiagnostics(): ReturnType<InspectorRuntime["getDiagnostics"]>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+declare function createInspector(options?: CreateInspectorOptions): Inspector;
+
 /** Two spaces per nesting level in terminal output. */
 declare const TERMINAL_INDENT = "  ";
 /** Max display length for names in terminal output. */
@@ -156,4 +251,4 @@ declare function printRunComplete(_name: string, _runId: string, durationMs: num
 /** Prints which step failed. */
 declare function printFailedAt(stepName: string): void;
 
-export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, type ResolvedRedactionProfile, TERMINAL_INDENT, type TraceSafetyOptions, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveRedactionProfile, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn };
+export { type CreateInspectorOptions, DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, type Inspector, type InspectorCaptureOptions, type InspectorObserveOptions, type InspectorRunOptions, type InspectorRuntime, type InspectorRuntimeContext, type InspectorRuntimeDiagnostics, type InspectorRuntimeOptions, type InspectorStepOptions, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, type ResolvedRedactionProfile, TERMINAL_INDENT, type TraceSafetyOptions, createInspector, createInspectorRuntime, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveRedactionProfile, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn };

package/packages/core/dist/advanced.d.ts

@@ -1,5 +1,8 @@
-import { E as ErrorInfo, e as RedactionProfile, n as StepMetadata, T as TraceEvent, I as InspectRunOptions, g as ExecutionContext, d as TraceCorrelationMetadata, k as RunStatus, c as StepStatus } from './types-Bkt7LS01.js';
-import { R as RedactionRule } from './log-config-BzGmDYum.js';
+import { E as ErrorInfo, e as RedactionProfile, n as StepMetadata, T as TraceEvent, I as InspectRunOptions, g as ExecutionContext, d as TraceCorrelationMetadata, S as StepType, k as RunStatus, c as StepStatus } from './types-tSix7tfv.js';
+import { R as RedactionRule } from './log-config-C1GcJPIM.js';
+import { P as PersistedInspectEvent } from './persisted-inspect-event-DiFto0K2.js';
+import { TraceWriterStats, TraceWriter } from './writers.js';
+import './inspect-event-Des4JDHo.js';
 
 /** Default folder under the user home for AgentInspect data. */
 declare const DEFAULT_TRACE_DIR_NAME = ".agent-inspect";
@@ -127,6 +130,98 @@ declare function runWithContext<T>(context: ExecutionContext, fn: () => Promise<
  */
 declare function runWithStepContext<T>(stepId: string, fn: () => Promise<T> | T): Promise<T>;
 
+interface InspectorRuntimeOptions {
+    enabled?: boolean;
+    writer?: TraceWriter;
+    traceSafety?: TraceSafetyOptions;
+}
+interface InspectorRuntimeContext extends ExecutionContext {
+    runtimeId: string;
+}
+interface InspectorRuntimeDiagnostics {
+    instrumentationErrors: number;
+    lastInstrumentationError?: string;
+    writerStats?: TraceWriterStats;
+}
+interface InspectorRuntime {
+    readonly runtimeId: string;
+    readonly enabled: boolean;
+    runWithContext<T>(context: ExecutionContext, fn: () => Promise<T> | T): Promise<T>;
+    runWithStepContext<T>(stepId: string, fn: () => Promise<T> | T): Promise<T>;
+    getCurrentContext(): InspectorRuntimeContext | undefined;
+    getCurrentCorrelationMetadata(): TraceCorrelationMetadata | undefined;
+    getCurrentStepId(): string | undefined;
+    getCurrentDepth(): number;
+    getTraceSafety(): TraceSafetyOptions;
+    write(event: PersistedInspectEvent): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    getDiagnostics(): InspectorRuntimeDiagnostics;
+}
+declare function createInspectorRuntime(options?: InspectorRuntimeOptions): InspectorRuntime;
+
+interface InspectorCaptureOptions {
+    onSuccess?: "none" | "metadata-only";
+    onError?: "none" | "metadata-only";
+}
+interface CreateInspectorOptions {
+    enabled?: boolean;
+    writer?: TraceWriter;
+    /**
+     * Context metadata only. Does not configure writer output; use
+     * `fileWriter({ dir })` or another explicit writer for persistence paths.
+     *
+     * @experimental
+     */
+    traceDir?: string;
+    /**
+     * Context metadata only for compatibility with existing terminal helpers.
+     * `createInspector()` does not print lifecycle output.
+     *
+     * @experimental
+     */
+    silent?: boolean;
+    metadata?: Record<string, unknown>;
+    redactionProfile?: RedactionProfile;
+    /**
+     * Metadata-only summaries for persisted run/step completion rows.
+     * This never stores raw return values, prompts, outputs, or thrown objects.
+     *
+     * @experimental
+     */
+    capture?: InspectorCaptureOptions;
+    traceSafety?: TraceSafetyOptions;
+}
+interface InspectorRunOptions {
+    runId?: string;
+    traceDir?: string;
+    silent?: boolean;
+    metadata?: Record<string, unknown>;
+}
+interface InspectorStepOptions {
+    type?: StepType;
+    metadata?: StepMetadata;
+}
+type InspectorObserveOptions = InspectorStepOptions;
+interface Inspector {
+    /**
+     * Low-level runtime access is retained for v1.6 compatibility. Prefer
+     * `getDiagnostics()` unless you need advanced runtime context primitives.
+     *
+     * @experimental
+     */
+    readonly runtime: InspectorRuntime;
+    run<T>(name: string, fn: () => T | Promise<T>, options?: InspectorRunOptions): Promise<T>;
+    step<T>(name: string, fn: () => T | Promise<T>, options?: InspectorStepOptions): Promise<T>;
+    tool<T>(name: string, fn: () => T | Promise<T>, options?: InspectorStepOptions): Promise<T>;
+    llm<T>(name: string, fn: () => T | Promise<T>, options?: InspectorStepOptions): Promise<T>;
+    observe<TFunction extends (...args: any[]) => any>(name: string, fn: TFunction, options?: InspectorObserveOptions): (...args: Parameters<TFunction>) => Promise<Awaited<ReturnType<TFunction>>>;
+    getDiagnostics(): ReturnType<InspectorRuntime["getDiagnostics"]>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+declare function createInspector(options?: CreateInspectorOptions): Inspector;
+
 /** Two spaces per nesting level in terminal output. */
 declare const TERMINAL_INDENT = "  ";
 /** Max display length for names in terminal output. */
@@ -156,4 +251,4 @@ declare function printRunComplete(_name: string, _runId: string, durationMs: num
 /** Prints which step failed. */
 declare function printFailedAt(stepName: string): void;
 
-export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, type ResolvedRedactionProfile, TERMINAL_INDENT, type TraceSafetyOptions, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveRedactionProfile, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn };
+export { type CreateInspectorOptions, DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, type Inspector, type InspectorCaptureOptions, type InspectorObserveOptions, type InspectorRunOptions, type InspectorRuntime, type InspectorRuntimeContext, type InspectorRuntimeDiagnostics, type InspectorRuntimeOptions, type InspectorStepOptions, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, type ResolvedRedactionProfile, TERMINAL_INDENT, type TraceSafetyOptions, createInspector, createInspectorRuntime, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveRedactionProfile, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn };

package/packages/core/dist/advanced.mjs

@@ -1,8 +1,11 @@
-export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, TERMINAL_INDENT, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn } from './chunk-XDBND27A.mjs';
-import './chunk-QX3ZMPUF.mjs';
-import './chunk-7TGZLWEE.mjs';
+export { MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, TERMINAL_INDENT, createInspector, createInspectorRuntime, formatTerminalName, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getIndent, getParentStepId, getTraceDirFromContext, getTraceSafetyFromContext, hasActiveContext, isSilentContext, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, runWithContext, runWithStepContext } from './chunk-6QSLZCBJ.mjs';
+import './chunk-BT7CATSD.mjs';
+export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, prepareMetadataForDisk, prepareTraceEventForDisk, resolveTraceSafetyOptions } from './chunk-57S5D6HR.mjs';
 export { resolveRedactionProfile } from './chunk-EDTQHZPM.mjs';
 import './chunk-VU6O5QAH.mjs';
-import './chunk-BT7CATSD.mjs';
+import './chunk-S4YWKV4G.mjs';
+export { DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, RUNS_DIR_NAME, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTimestamp, getDefaultTraceDir, getTraceFilePath, truncateName, warn } from './chunk-VTIB5MDK.mjs';
+import './chunk-74XZ6N7Q.mjs';
+import './chunk-7TGZLWEE.mjs';
 //# sourceMappingURL=advanced.mjs.map
 //# sourceMappingURL=advanced.mjs.map